Controlling sessions with the SET MODENAME commands
The SET MODENAME commands can be used to control the sessions within the modegroups associated with an APPC connection, without releasing or reacquiring the connection.
The processes executed to accomplish this are:
- CNOS negotiation with the partner system to define the changes that are to take place.
- Binding or unbinding of the appropriate sessions.
The algorithms used by CICS® to negotiate with the partner
the numbers of sessions to be made available are complex, and the
numbers of sessions acquired may not match your expectation. The
outcome can depend on the following:
- The history of preceding SET MODENAME commands
- The activity in the partner system
- Errors that have caused CICS to place sessions out of service.
Modegroups can normally be controlled with the few simple commands described in Table 1.
| Command | Effect |
|---|---|
| SET MODENAME ACQUIRED | Acquires all negotiated contention-winner sessions. |
| SET MODENAME CLOSED | Negotiates with the partner to reduce the available
number of sessions to zero, releases the sessions, and prevents any
attempt by the partner to negotiate or activate any sessions in the
modegroup. Only the system issuing the command can subsequently increase
the session count. Queued session requests are honored before sessions are unbound. |
| SET MODENAME AVAIL(maximum) ACQUIRED | If this command is issued when the modegroup is closed, the sessions are negotiated as if the connection had been newly acquired, and the contention-winner sessions are acquired. It can also be used to rebind sessions that have been lost due to errors that have caused CICS to place sessions out of service. |