Overriding the OPS/MVS Schedule Manager feature
search cancel

Overriding the OPS/MVS Schedule Manager feature

book

Article ID: 28211

calendar_today

Updated On:

Products

OPS/MVS Event Management & Automation

Issue/Introduction

How to override the Schedule Manager feature in OPS/MVS?

Resolution

 

Following is a description of the various ways in which you can override Schedule Manager.

1.- The effective mode of System State Manager monitored resources:

The effective mode of any resource is determined by the most restrictive of the following modes:

 

  • The global mode of System State Manager.
    This mode is set by the OPS/MVS parameter STATEMAN.

 

  • The mode of the resource table that contains the resource.
    This mode is set by the value for the resource table in the TABLE_MODE column in the SSM_MANAGED_TBLS table.

 

  • The mode of the individual resource.
    This mode is set by the value for the resource in the MODE column in the resource table.

 

The OPS/MVS parameter STATESCHEDEXCLUDE can be used to have Schedule Manager bypass updates to the DESIRED_STATE column of resources during its RESET processing based on the effective mode of each resource. For more information about this parameter, see the OPS/MVS Parameter Reference guide.

2.- The @OVERRIDE@ Schedule

You can schedule temporary overrides to all Schedule Manager schedules by creating periods and link items in a schedule called @OVERRIDE@, which is a reserved name. The @OVERRIDE@ schedule is automatically merged into all other schedules when they are edited, and it is automatically merged into the ACTIVE schedule during RESET processing to set the desired states of resources.

The period names in the @OVERRIDE@ schedule are also reserved and are prefixed with the characters @OVER. You can only make changes to the @OVERRIDE@ schedule when editing it directly. If you try to modify @OVERRIDE@ period or link entries when editing a normal schedule, then your changes are rejected.

The following Links Control panel shows an example of an @OVERRIDE@ schedule to turn off all resources except JES2 for one hour every night at midnight. In this example, an L line command has been executed against the @OVER_MNIT period to display its links:

Schedule Manager ---------------- Links Control ----------------- System:OPS44RCommand ===>                                                  Scroll ===> CSR                                                                                 CMDS: A D I L LC LD LX + ++ - --              |                                ---------------------------------------------- --------------------------------___ -@OVERRIDE@                               |     -ACF2_STCTBL               L__  |-@OVER_MNIT  SMTWTFS          0000-0100 |      |-STASK                   ___  |-DEFAULT                                |      | |-ACF2                                                                |     -CICS_STCTBL                                                             |      |-STASK                                                                 |      | |-CICS                                                                |      | |-CICSTEST                                                            |     -DB2_STCTBL                                                              |      |-STASK                                                                 |      | |-DB2                                                                 |     -IMS_STCTBL                                                              |      |-STASK                                                                 |      | |-IMS                                                                 |     -JES2_STCTBL                                                             |      |-STASK                                                                 |      | |-JES2                                                                |     -TSO_STCTBL                                                              |      |-STASK                                                                 |      | |-TCAS                                                                |      | |-TCASTEST                                                            |                                

The following Links Control panel demonstrates the @OVERRIDE@ schedule being merged into the PRODUCTION schedule:

Schedule Manager ---------------- Links Control ----------------- System:OPS44RCommand ===>                                                  Scroll ===> CSR                                                                                 CMDS: A D I L LC LD LX + ++ - --              |                                ---------------------------------------------- --------------------------------___ -PRODUCTION                               |     -ACF2_STCTBL               ___  |-@OVER_MNIT  SMTWTFS          0000-0100 |      |-STASK                   ___  |-WENDLITE    S.....S          0800-2000 |      | |-ACF2                  ___  |-WENDDARK    S.....S          2000-3200 |     -CICS_STCTBL               ___  |-EVERYNOON   SMTWTFS          1200-1300 |      |-STASK                   ___  |-WEEKDAY     .MTWTF.          0800-1600 |      | |-CICS                  ___  |-WEEKEVENING .MTWTF.          1600-2400 |      | |-CICSTEST              ___  |-WEEKNIGHT   .MTWTF.          2400-3200 |     -IMS_STCTBL                ___  |-THNXLITE03  11/27/2003-11/28 0800-2000 |      |-STASK                   ___  |-THNXDARK03  11/27/2003-11/28 2000-3200 |      | |-IMS                   ___  |-XMASLITE03  12/24/2003-12/25 0800-2000 |     -IMS_STCTBL                ___  |-XMASDARK03  12/24/2003-12/25 2000-3200 |      |-STASK                   ___  |-XMASALL03   12/25/2003       0000-2400 |      | |-IMS                   ___  |-XMASEVERY   12/25            0000-2400 |     -JES2_STCTBL               ___  |-DEFAULT                                |      |-STASK                                                                 |      | |-JES2                                                                |     -TSO_STCTBL                                                              |      |-STASK                                                                 |      | |-TCAS                                                                |      | |-TCASTEST                                                            -                                

The following State panel demonstrates the @OVERRIDE@ schedule being merged into the PRODUCTION schedule:

Schedule Manager ----- State at 0030 on 03/31/2003 -------------- System:OPS44RCommand ===>                                                  Scroll ===> CSR                                                                                                                               | CMDS: F N R + ++ - --          ---------------------------------------------- --------------------------------                                              - ___ -ACF2_STCTBL                                                             - ___  |-STASK                       @OVER_2400     SMTWTFS          0000-0100 - ___  | |-ACF2                                                                - ___ -CICS_STCTBL                                                             - ___  |-STASK                       @OVER_2400     SMTWTFS          0000-0100 - ___  | |-CICS                      @OVER_2400     SMTWTFS          0000-0100 - ___  | |-CICSTEST                                                            - ___ -DB2_STCTBL                                                              - ___  |-STASK                                                                 - ___  | |-DB2                                                                 - ___ -IMS_STCTBL                                                              - ___  |-STASK                       @OVER_2400     SMTWTFS          0000-0100 - ___  | |-IMS                                                                 - ___ -JES2_STCTBL                                                             - ___  |-STASK                       WEEKNIGHT      .MTWTF.          2400-3200 - ___  | |-JES2                                                                - ___ -TSO_STCTBL                                                              - ___  |-STASK                       @OVER_2400     SMTWTFS          0000-0100 - ___  | |-TCAS                      @OVER_2400     SMTWTFS          0000-0100 - ___  | |-TCASTEST                                                            -                                

3.- The SSM@OVER Sample Rule

The SSM@OVER sample command rule located in library CCLXRULM allows operators or automated procedures to maintain temporary fixed date periods in the @OVERRIDE@ schedule in the OPS/MVS Schedule Manager facility. This rule allows you to add, modify, display, or delete links in the @OVERRIDE@ schedule. You must enable the SSM@OVER sample rule before you can begin to use it.

Formats of the SSM@OVER Commands

Following is a description of the various formats of the SSM@OVER commands.

SSM@OVER ADD command

The format of the SSM@OVER ADD command is:

Command Required Keywords Optional Keywords
SSM@OVER ADD NAMES(table.resource,...)
STATE(ON|OFF|UP|DOWN|ACTIVE|INACTIVE)
FROM(hhmm)
UNTIL(hhmm)
DATE(mm/dd)
RESET

Add links with the specified STATE to the specified resource NAMES in the @OVERRIDE@ schedule. Add the links in a temporary fixed date period with the specified DATE, the specified FROM start time, and the specified UNTIL end time. If DATE is not specified, then it defaults to the current date. After the links are added, perform a Schedule Manager RESET function if RESET was specified.

Example 1 Command (and response) to add some temporary override links to turn some resources ON:

SSM@OVER ADD NAMES(CICS_STCTBL.CICS,TSO_STCTBL.TCAS) STATE(ON) FROM(2200) UNTIL(2400)
OPR1000I PROD.SSM@OVER: Override for CICS_STCTBL.CICS set ON at 2200-2400 03/31-03/31 added to @OVER000001.
OPR1000I PROD.SSM@OVER: Override for TSO_STCTBL.TCAS set ON at 2200-2400 03/31-03/31 added to @OVER000001.
OPR1000I SSM@OVER: Command completed with RC=0.
Example 2 Command (and response) to add some temporary override links to turn some resources OFF:

SSM@OVER ADD NAMES(CICS_STCTBL.CICSTEST, TSO_STCTBL.TCASTEST) STATE(OFF) FROM(2200) UNTIL(2400)
OPR1000I SSMQAN.SSM@OVER: Override for CICS_STCTBL.CICSTEST set OFF at 2200-2400 03/31-03/31 added to @OVER000001.
OPR1000I SSMQAN.SSM@OVER: Override for TSO_STCTBL.TCASTEST set OFF at 2200-2400 03/31-03/31 added to @OVER000001.
OPR1000I SSM@OVER: Command completed with RC=0.

SSM@OVER CHANGE command

The format of the SSM@OVER CHANGE command is:

Command Required Keywords Optional Keywords
SSM@OVER CHANGE NAMES(table.resource,...)
STATE(ON|OFF|UP|DOWN|ACTIVE|INACTIVE)
FROM(hhmm)
UNTIL(hhmm)
DATE(mm/dd)
RESET

Change existing links to the specified resource NAMES in the @OVERRIDE@ schedule. Change the links to the specified STATE and move them to a temporary fixed date period with the specified DATE, the specified FROM start time, and the specified UNTIL end time. If DATE is not specified, then it defaults to the current date. After the links are changed, perform a Schedule Manager RESET function if RESET was specified.

Example 1 Command (and response) to change a temporary override link from ON to OFF and move it to a different time on a different day:

SSM@OVER CHANGE NAMES(TSO_STCTBL.TCAS) STATE(OFF) FROM(2100) UNTIL(2300) DATE(4/1)
OPR1000I PROD.SSM@OVER: Overrides for TSO_STCTBL.TCAS deleted from @OVER000001.
OPR1000I PROD.SSM@OVER: Override for TSO_STCTBL.TCAS set OFF at 2100-2300 04/01-04/01 added to @OVER000002.
OPR1000I SSM@OVER: Command completed with RC=0.
Example 2 Command (and response) to change a temporary override link from OFF to ON and move it to a different time on a different day:

SSM@OVER CHANGE NAMES(TSO_STCTBL.TCASTEST) STATE(ON) FROM(2100) UNTIL(2300) DATE(4/1)
OPR1000I PROD.SSM@OVER: Overrides for TSO_STCTBL.TCASTEST deleted from @OVER000001.
OPR1000I PROD.SSM@OVER: Override for TSO_STCTBL.TCASTEST set ON at 2100-2300 04/01-04/01 added to @OVER000002.
OPR1000I SSM@OVER: Command completed with RC=0.

SSM@OVER DELETE command

The format of the SSM@OVER DELETE command is:

Command Required Keywords Optional Keywords
SSM@OVER DELETE NAMES(table.resource,...) STATE(ON|OFF|UP|DOWN|ACTIVE|INACTIVE)
FROM(hhmm)
UNTIL(hhmm)
DATE(mm/dd)
RESET

Delete existing links to the specified resource NAMES in the @OVERRIDE@ schedule. Optionally, delete only links with the specified STATE, and only those in the temporary fixed date period with the specified DATE, the specified FROM start time, and the specified UNTIL end time. After the links are deleted, perform a Schedule Manager RESET function if RESET was specified.

Example Command (and response) to delete all temporary override links in an SSM resource table:

SSM@OVER DELETE NAMES(CICS_STCTBL.*)
OPR1000I PROD.SSM@OVER: Overrides for CICS_STCTBL.* deleted from @OVER000001.
OPR1000I SSM@OVER: Command completed with RC=0.

SSM@OVER RESET command

The format of the SSM@OVER RESET command is:

SSM@OVER RESET

This command causes the main Schedule Manager to perform a RESET function, resulting in the following:

The ACTIVE schedule and the @OVERRIDE@ schedule are reevaluated.

The desired states of System State Manager resources are set as scheduled.

The next schedule RESET time (period start or stop) is recomputed.

Example Command (and response) to have Schedule Manager execute a RESET function:

SSM@OVER RESET
OPR1000I SSM@OVER: Command completed with RC=0.

SSM@OVER SHOW Command

The format of the SSM@OVER SHOW command is:

Command Required Keywords Optional Keywords
SSM@OVER SHOW NAMES(table.resource,...) STATE(ON|OFF|UP|DOWN|ACTIVE|INACTIVE)
FROM(hhmm)
UNTIL(hhmm)
DATE(mm/dd)
RESET

Show existing links to the specified resource NAMES in the @OVERRIDE@ schedule. Optionally, show only links with the specified STATE, and only those in the temporary fixed date period with the specified DATE, the specified FROM start time, and the specified UNTIL end time. After the links are shown, perform a Schedule Manager RESET function if RESET was specified.

Example Command (and response) to show all temporary override links:

SSM@OVER SHOW
OPR1000I PROD.SSM@OVER: TSO_STCTBL.TCAS set OFF at 2100-2300 04/01-04/01 in @OVER000002.
OPR1000I PROD.SSM@OVER: TSO_STCTBL.TCASTEST set ON at 2100-2300 04/01-04/01 in @OVER000002.
OPR1000I SSM@OVER: Command completed with RC=0.

The following Links Control panel shows the same example @OVERRIDE@ schedule shown earlier after all of the above example SSM@OVER commands have been executed. In this example, an L line command has been executed against the @OVER000002 period to display its links:

Schedule Manager ---------------- Links Control ----------------- System:OPS44RCommand ===>                                                  Scroll ===> CSR                                                                                 CMDS: A D I L LC LD LX + ++ - --              |                                ---------------------------------------------- --------------------------------___ -@OVERRIDE@                               |     -ACF2_STCTBL               ___  |-@OVER_MNIT  SMTWTFS          0000-0100 |      |-STASK                   L__  |-@OVER000002 04/01            2100-2300 |      | |-ACF2                  ___  |-DEFAULT                                |     -CICS_STCTBL                                                             |      |-STASK                                                                 |      | |-CICS                                                                |      | |-CICSTEST                                                            |     -DB2_STCTBL                                                              |      |-STASK                                                                 |      | |-DB2                                                                 |     -IMS_STCTBL                                                              |      |-STASK                                                                 |      | |-IMS                                                                 |     -JES2_STCTBL                                                             |      |-STASK                                                                 |      | |-JES2                                                                |     -TSO_STCTBL                                                              |      |-STASK                                                                 |      | |-TCAS                                                                |      | |-TCASTEST                                                            |