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.

Table 1. SET MODENAME commands
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.


dfht1la.html | Timestamp icon Last updated: Sunday, 4 June 2017