IBM Tivoli NetView for z/OS, Version 6.2

Shutdown Command Lists

The command lists for shutdown are:

AOPSMAIN
Command list to order shutdown of all automated products
AOPSCICS
Initiates CICS® shutdown
AOPSIMS
Initiates IMS™ shutdown by issuing a message to users to log off and by setting a timer to call AOPSIMS2.
  • DFS000IB - Stores IMS region numbers for shutdown
  • AOPSIMS2 - Completes shutdown of IMS
  • DFS996I - Captures and stores the WTOR for later use
AOPSTSO
Initiates TSO shutdown by issuing a message to users to log off and by setting a timer to call AOPSTSO2.
  • AOPSTSO2 - Completes TSO shutdown
AOPSVTAM
Initiates VTAM® shutdown and sets timer to call VTAMTMRZ if required.
  • VTAMTMRZ - Issues the cancel command to shutdown VTAM if necessary
AOPSJES2
Initiates JES2 shutdown by calling AOPSPURG and issuing command to shutdown JES2.
  • AOPSPURG - Drains all units (printers, punches, initiators, etc.) You must customize this command list for your environment.
AOPSJES3
Initiates JES3 shutdown.
  • AOPTJRC3 - Resets the reply count for message IAT3714 to zero (0)
AOPSMAIN shuts down all products that have values set in AOPIVARS. If a product is dependent on another product to shut down before it can shut down, AOPSMAIN periodically checks if the required prior product shutdown is complete before starting the subsequent shutdown procedure. The products are shut down in the reverse of the order in which they are listed in AOPIVARS. AOPSMAIN calls these command lists:
  • AOPSCICS to stop CICS
  • AOPSIMS to stop IMS
  • AOPSTSO to stop TSO
  • AOPSVTAM to stop VTAM
  • AOPSJES2 to stop JES2
  • AOPSJES3 to stop JES3
AOPSCICS checks the status of CICS:
  • If CICS is already down, AOPSCICS sets the desired status to DOWN and exits.
  • If CICS is not down, the command to stop CICS is issued. A message is issued to the system operator if the shutdown does not complete within a set time limit.
AOPSIMS is called and broadcasts a message to users to log off because IMS is shutting down in two minutes and issues a timer command to call command list AOPSIMS2 after two minutes:
  • AOPSIMS updates the desired status of IMS to DOWN. It also checks the current-status variable and exits if it is already set to DOWN or sets the variable to STOPPING.
  • AOPSIMS broadcasts a message warning users to log off within two minutes.
  • AOPSIMS displays active regions, and command list DFS000IB, which is issued from the automation table, stores the IMS region numbers.
  • AOPSIMS then issues a timer command to call AOPSIMS2 after two minutes. AOPSIMS2 issues commands to stop the IMS regions, data communications, and IMS.
    • If a message indicating successful shutdown is received within a set time period, AOPSIMS2 updates the current-status variable to DOWN, and command list DSF996I, which is issued from the automation table, captures the IMS WTOR for later use.
    • If the message is not received within the set time period, AOPSIMS2 issues a message to the system operator to indicate a problem.
AOPSTSO issues a message to users telling them that TSO is to be shut down. AOPSTSO then issues a timer command to call command list AOPSTSO2. AOPIVARS specifies how long AOPSTSI waits before calling AOPSTSO2. AOPSTSO2 starts after the time elapses and checks the status of TSO:
  • If TSO is down, AOPSTSO2 sets the desired status to DOWN and exits.
  • If TSO is not already down, it issues the command to stop TSO. A message is issued to the system operator if the shutdown does not complete within a set time limit.
AOPSVTAM checks the status of VTAM:
  • If VTAM is down, AOPSVTAM sets the desired status to DOWN and exits.
  • If VTAM is not down, AOPSVTAM issues a timer command to call command list VTAMTMRZ after three minutes and issues the command to stop VTAM. If VTAM shuts down correctly, the timer calling VTAMTMRZ is purged.

    VTAMTMRZ checks the status of VTAM and exits if it is down. If VTAM is not down, VTAMTMRZ issues a cancel to VTAM. A message is issued to the system operator if the shutdown does not complete within a set time limit.

AOPSJES2 checks the status of JES2:
  • If JES2 is already down, AOPSJES2 sets the desired status to DOWN, and exits.
  • If JES2 is not down, it issues command list AOPSPURG. AOPSPURG drains all of the devices to JES2.

    After all devices are drained, the command to stop JES2 is entered. A message is issued to the system operator if the shutdown does not complete within a set time limit.

AOPSJES3 checks the status of JES3:
  • If JES3 is already down, AOPSJES3 sets the desired status to DOWN, and exits.
  • If JES3 is not DOWN, AOPSJES3 issues the command to shut JES3 down. A message is issued to the system operator if the shutdown does not complete within a set time limit.
Parent topic: Using the Advanced Automation Sample Set

Feedback