How to override the Schedule Manager feature in OPS/MVS?
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 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 | |