Reconnecting to CEA TSO/E address spaces

When a user requests to end a TSO/E session created by CEA, if the caller has not set the abnormal logoff flag (CEATSO_ABLOGOFF) or the no reconnect flag (CEATSO_NORECONN), the CEA TSO/E address space manager can intercept that request and place the session in a dormant state instead of ending it.

A dormant TSO/E session is a session that has been deactivated for communication through its message queue but remains available at a TSO/E READY prompt for a period of time so that the user can reconnect to it. Reconnecting to a dormant session is faster and uses fewer resources than constructing a new session because the session resources are retained and reused when the user reconnects to the session.

To enable the CEA reconnect feature, which is disabled by default, specify non-zero values for the RECONSESSIONS and RECONTIME statements in the TSOASMGR parmlib statement in the CEAPRMxx parmlib member. The RECONSESSIONS statement indicates how many dormant sessions can be created for each user, and the RECONTIME statement indicates the amount of time a dormant session remains a candidate for reconnection.

The CEA TSO/E address space manager can create a maximum of three dormant sessions per user and can keep a dormant session available for reconnection for a maximum of 23 hours, 59 minutes, and 59 seconds. The settings you specify for the TSOASMGR parmlib statement affect all of the TSO/E sessions that are managed by the CEA TSO/E address space manager. For more information about the TSOASMGR parmlib statement, see the topic about the CEAPRMxx parmlib member in &ieae200t;.

When the CEA reconnect feature is enabled, to reconnect to a dormant session, the user must do the following:

Request to start a new TSO/E session before the specified RECONTIME expires. After the RECONTIME expires, the session remains in a dormant state until CEA ends it; however, the session is no longer a candidate for reconnection.
Use the same security credentials and logon parameters that were used for the dormant session.

If no dormant sessions are available that satisfy these requirements, the CEA TSO/E address space manager will create a new address space for the user.

Dormant TSO/E sessions do not interfere with the maximum number of sessions allowed. That is, if a user tries to create a new session and the number of active and dormant sessions equal the maximum allowed, the CEA TSO/E address space manager will end a dormant session and create a new session for the user.