Sessions that persist when CICS opens the z/OS Communications Server ACB
These tasks and modules are involved when the z/OS® Communications Server ACB is dynamically opened by a SET VTAM OPEN command from a running CICS® system. With single-node persistent sessions support (SNPS), if z/OS Communications Server fails but CICS continues to run, sessions no longer exist.
Summary
With multinode persistent sessions support (MNPS), sessions do persist if z/OS Communications Server or z/OS fails. CICS does not delete the autoinstalled resources, and resets all the terminal and connection sessions to unopened state.
- CEMT SET VTAM OPEN.
- DFHEIQVT calls DFHZOPA.
- DFHZOPA calls DFHZSLS.
- DFHZSLS call DFHZGSL.
- DFHZGSL issues SETLOGON PERSIST or NPERSIST.
- DFHZOPA calls DFHZGRP.
- DFHZGRP issues INQUIRE PERSESS.
- DFHZGRP terminates the session by means of DFHZGUB issuing CLSDST/TERMSESS. However, if MNPS is in use, the sessions are restored using OPNDST RESTORE instead.
- DFHZGRP issues RECEIVE_ANY commands.
- DFHZGRP deletes CNOS catalog records.
- DFHZOPA issues SETLOGON START.
More detail
Sessions that persist after
the ACB has been opened using a SET VTAM OPEN command
are processed in the following way:
- CICS is running with the z/OS Communications Server ACB closed. CEMT SET VTAM OPEN or EXEC CICS SET VTAM OPEN is issued.
- DFHEIQVT calls DFHZOPA to open the ACB.
- DFHZOPA calls DFHZSLS.
- DFHZSLS calls DFHZGSL.
- DFHZGSL issues z/OS Communications
Server macro calls dependent on the z/OS Communications
Server level and PSDINT value.
- If z/OS Communications Server is V3R4.1 or later, DFHZGSL issues SETLOGON OPTCD=PERSIST if the value of the PSDINT system initialization parameter is a valid nonzero value.
- If the z/OS Communications Server level is V3R4.0, or PSDINT is 0 or defaulted with higher levels of z/OS Communications Server, DFHZGSL issues SETLOGON OPTCD=NPERSIST.
- If the z/OS Communications Server level is earlier than V3R4.0, the SETLOGON OPTCD call is not made because PERSIST and NPERSIST are not supported for these z/OS Communications Server releases.
- DFHZOPA calls DFHZGRP with startup type of DYNOPEN.
- DFHZGRP issues INQUIRE PERSESS with a storage area that will take up to about 400 sessions. INQUIRE PERSESS is reissued until all the NIBs have been obtained from z/OS Communications Server.
- DFHZGRP calls DFHZGUB if there are any sessions to unbind. For MNPS, DFHZGRP instead issues OPNDST RESTORE for each session that persists.
- DFHZGRP issues RECEIVE_ANY commands.
- DFHZGRP calls DFHZGCC to delete CNOS records.
- If ZGRP returns RESPONSE(OK) or RESPONSE(EXCEPTION) with REASON(ACB_CLOSED|INQUIRE_FAILED), DFHZOPA issues SETLOGON OPTCD=START. Otherwise, it causes DFHZSHU to close the z/OS Communications Server ACB and then returns to DFHEIQVT.