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.

  1. CEMT SET VTAM OPEN.
  2. DFHEIQVT calls DFHZOPA.
  3. DFHZOPA calls DFHZSLS.
  4. DFHZSLS call DFHZGSL.
  5. DFHZGSL issues SETLOGON PERSIST or NPERSIST.
  6. DFHZOPA calls DFHZGRP.
  7. DFHZGRP issues INQUIRE PERSESS.
  8. 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.
  9. DFHZGRP issues RECEIVE_ANY commands.
  10. DFHZGRP deletes CNOS catalog records.
  11. 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:
  1. CICS is running with the z/OS Communications Server ACB closed. CEMT SET VTAM OPEN or EXEC CICS SET VTAM OPEN is issued.
  2. DFHEIQVT calls DFHZOPA to open the ACB.
  3. DFHZOPA calls DFHZSLS.
  4. DFHZSLS calls DFHZGSL.
  5. 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.
  6. DFHZOPA calls DFHZGRP with startup type of DYNOPEN.
  7. 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.
  8. DFHZGRP calls DFHZGUB if there are any sessions to unbind. For MNPS, DFHZGRP instead issues OPNDST RESTORE for each session that persists.
  9. DFHZGRP issues RECEIVE_ANY commands.
  10. DFHZGRP calls DFHZGCC to delete CNOS records.
  11. 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.


dfhs3c001142.html | Timestamp icon Last updated: Monday, 5 June 2017