Example Definitions

The actions you take to shut down z/OS systems within GDPS® are defined using the SYSTEM_SHUTDOWN message ID in the MESSAGES/USER DATA policy item for the MVS Component entry type. These actions can include instructing SA z/OS® to shut down resources out of the affected dependency tree of GDPS STOPAPPL, shut down file systems, and so on.

Table 1. Example GDPS_SYSTEM_SHUTDOWN Command Processing Entry
Cmd Ps/Select AutoFn/* Command Text
  PHASE1   INGREQ RACF/APL/&SYSNAME. REQ=STOP PRECHECK=NO REMOVE=SYSGONE VERIFY=NO OUTMODE=LINE
  PHASE1   INGREQ RRS/APL/&SYSNAME. REQ=STOP PRECHECK=NO REMOVE=SYSGONE VERIFY=NO OUTMODE=LINE
  PHASE1   INGREQ GDPS_ALL/APG/&SYSNAME. REQ=STOP PRECHECK=NO REMOVE=SYSGONE VERIFY=NO OUTMODE=LINE
  PHASE1   INGREQ VLF/APL/&SYSNAME. REQ=STOP PRECHECK=NO REMOVE=SYSGONE VERIFY=NO OUTMODE=LINE
  PHASE1   INGRCHCK JES2/APL/&SYSNAME. OBSERVED=(SO H)
  PHASE1   INGRCHCK VLF/APL/&SYSNAME. OBSERVED=(SO H)
  PHASE2   PIPE CC LIST STATUS=CANZLOG | TAKE 1| NLOC / subsystem *none*/ | EDIT /CANZLOG CUE/ | NETV | EXPOSE TOTRAP | CON
  PHASE2 * INGSHRES SMF_REC
  PHASE2 * INGSHRES ICSF

Table 1 shows example definitions for the GDPS_SYSTEM_SHUTDOWN entry that place stop votes against the listed resources in PHASE1 in a sequential order. The desired completion of the resource shutdown is processed in parallel. The specified INGRCHCK command at the end of the PHASE1 sequences waits for the completion of the stop requests for the specified resources.

If synchronization is necessary, the FDBK option for the INGREQ command permits waiting until the appropriate subsystem has been shutdown. The FDBK=WAIT option causes an INGREQ stop command to be processed sequentially. In this way, it slows down the shutdown process.

The primary and all secondary automation managers (PAM and SAMs) on the local system will be shut down by SA z/OS automatically unless they are moved to another system. OMVS will be shutdown by SA z/OS automatically too.

Setting of the Recovery Flag for SMFDUMP, stopping CANZLOG, stopping SMF recording (APL SMF_REC) itself and subsequently stopping data encryption (APL ICSF) will be done synchronously as specified in the PHASE2 command chain.

If return code checking is turned on but a code other than 0 is returned, SA z/OS will immediately stop the execution of the defined command chain.