CL Command Reference - CHGSSNMAX
CL Command List > CHGSSNMAX Reference
Description:
The Change Session Maximum (CHGSSNMAX) command is used to dynamically change the maximum number of sessions the local location allows to a mode.
When a change to the maximum number of sessions is made, the remote system is informed and allowed to negotiate for a lower session maximum. The remote system cannot negotiate a session maximum higher than the value specified for the local number of sessions specified. The resulting session maximum value is the current session maximum. Neither system may activate more sessions than the current session maximum.
If the requested session maximum is accepted or negotiated by the remote system, the value requested on this command is stored as the local session maximum; the remote system is not allowed to increase the current session maximum above the value stored as the local session maximum. This new value for the local session is only used the next time a new session maximum needs to be negotiated. The current session maximum, which controls how many sessions can be active between the local and remote location, is not changed if the command fails. If the request to change the session maximum is rejected by the remote system, the command ends abnormally and the local session maximum is changed as follows: If it is increasing, it is changed to the value specified; if it is decreasing, it is not changed.
This command is normally used by the system operator to control the number of sessions that can be active at the same time with a remote location. If the current number of active sessions is greater than the maximum number specified on the command, no new sessions are created until the number of active sessions falls below that specified on the command. If the current number of active sessions is less than the maximum number specified, sessions are not created until jobs requiring them are started. The value created by the systems remains in effect until another Change Session Maximum (CHGSSNMAX) command or an End Mode (ENDMOD) command is run for the same mode, or until all the device descriptions associated with the remote location are varied off.
NOTES:
1. When this command is used to reduce the number of sessions with a remote system, the sessions that are ended first are the available locally controlled sessions, followed by any other available sessions. If the new session count is still not reached, other sessions are ended as jobs using them are completed or are canceled.
2. When the CHGSSNMAX command is used to increase the maximum number of sessions that can be created with a remote system, the locally controlled sessions are made available first (depending on the negotiated values), and then other sessions are made available.
3. The CHGSSNMAX command does not change the value specified for the MAXSSN parameter in the mode description; the Change Mode Description (CHGMODD) command must be used to permanently change the value. When the device is next varied on, the MAXSSN value from the mode description is used to limit the number of sessions instead of the MAXSSN value specified on a previous CHGSSNMAX command.
Examples:
CHGSSNMAX RMTLOCNAME(APPCRLOC) DEV(APPCDEV) MODE(APPC2) MAXSSN(3)
This command changes the maximum number of sessions allowed by remote location APPCRLOC for mode APPC2 to a maximum of three.