Using System State Manager › SSMSHUT Command—Set Resource State to Down

SSMSHUT Command—Set Resource State to Down

As part of a general shutdown of resources, usually in preparation for an IPL, the SSMSHUT sample OPS/REXX program located in your opsmvshlq.SAMPLE.REXX library, sets the desired state of all SSM resources to DOWN. To utilize this sample program, copy it into your opsmvshlq.USER.REXX library or a valid user REXX library that is allocated to your OPSMAIN and OPSOSF procedures.

The progress of the shutdown and any bottlenecked resources are periodically displayed by the SSMSHUTM rule through a multi-line WTO. The SSMSHUT program enables the SSMSHUTM rule when the shutdown begins. The AT and IN keywords of the SSMSHUT command allow you to initiate the shutdown at any time in 23 hours of the current time. The SSMSHUT program also provides the operator with an opportunity to cancel the shutdown.

The EXCLUDE keyword of the SSMSHUT command allows you to perform a partial shutdown of resources by providing a list of the resources (explicit resource names, global variable names, or both) you want to exclude. SSMGA inactive copies of movable resources are automatically excluded when SSMGA is active.

This command has the following syntax:

SSMSHUT
  [AT(hh:mm)|IN(hh:mm)]
  [WARNTIME(hh:mm)]
  [CONFIRM(Y|N)]
  [MONITOR(Y|N)]
  [EXCLUDE(resource list|glv names)]

Note: The SSMSHUT command uses dynamic time rules to reschedule itself periodically to avoid exceeding the OSFWAIT and OSFRUN time limits in the server.

The keywords of the SSMSHUT command have these values:

AT(hh:mm)|IN(hh:mm)

(Optional) One of the following:

AT-The time at which the shutdown is to occur

IN-The amount of time from the current time at which the shutdown is to occur

The maximum value is 23:00. The default is IN(00:01) if AT is not specified.

WARNTIME(hh:mm)

(Optional) The amount of time prior to the actual shutdown time specified by the AT or IN keyword that a z/OS SEND command will be issued to notify users about the impending shutdown. A WTOR will also be issued, allowing the operator to cancel the shutdown if desired. The default is 00:10.

CONFIRM(Y|N)

(Optional) Specifies whether a WTOR is issued to the operator for confirmation that a system shutdown is desired at the specified time. A reply of U allows the shutdown to continue. The default is Y.

MONITOR(Y|N)

(Optional) Specifies whether the SSMSHUTM TOD rule should be enabled to monitor resource shutdown progress once the shutdown has been started. The default is Y.

EXCLUDE(resource list|glv names)

(Optional) A string of resource names specified as name or table.name. Global variable names may also appear in the list of names. The values of the variables will be resolved and added to the resource name string.

Example: SSMSHUT

The following example illustrates changing the desired state of all SSM resources except JES2 to the DOWN state in 30 minutes from the current time. It also issues a warning message to all TSO users five minutes before the shutdown and provides the operator with an opportunity to cancel the shutdown.

!OI SSMSHUT IN(00:30) EXCLUDE(STCTBL.JES2) WARNTIME(00:05)