Previous Topic: Examples of SSMDISPNext Topic: Using SSM Global Application


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 in your opsmvshlq.CCLXSAMP 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 multiline 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 values:

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 before the actual shutdown time specified by the AT or IN keyword that a z/OS SEND command is issued to notify users about the impending shutdown. A WTOR is also 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 that are specified as name or table.name. Global variable names can also appear in the list of names. The values of the variables are 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 5 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)