Change the number of sessions in an APPC session group.
SET MODENAME >>-SET MODENAME(data-value)--CONNECTION(data-value)-------------> >--+--------------------------------------------+-------------->< +-AVAILABLE(data-value)--+-----------------+-+ | +-ACQSTATUS(cvda)-+ | | '-ACQUIRED--------' | '-+-ACQSTATUS(cvda)-+------------------------' '-CLOSED----------'
Conditions: INVREQ, NOTAUTH, SYSIDERR
For more information about the use of CVDAs, see CICS-value data areas (CVDAs).
The SET MODENAME command enables you to increase or decrease the number of sessions available (bound) in a session group on a particular APPC connection. You identify the group to be changed by the MODENAME and CONNECTION values in its SESSIONS definition, rather than the name of the SESSIONS definition. You need both values because MODENAMEs are not necessarily unique across connections.
SET MODENAME applies only to parallel session groups on an APPC connection on which CICS is already in session with its partner system, and only to groups created with a SESSIONS resource definition (not to SNASVCMG LU services manager sessions). The changes last only until the connection is released or the number of sessions is changed again.
If you increase the number of sessions, you can specify whether or not CICS should acquire the additional sessions; if you decrease the number, CICS unbinds the excess sessions automatically. If more than the target number of sessions are in use at the time of the command, CICS allows activity to quiesce before unbinding. Tasks using a session on the connection are allowed to complete, but new tasks requiring a session are not started until activity drops below the new limit.