Overview

The selection criteria and instructions defined in each Control-O rule are called rule parameters. This chapter is comprised of detailed descriptions of all the rule definition parameters and their specific uses. Rule parameters are defined in the Rule Definition screen, which is shown in Figure 94, the main screen of the Rule Definition facility.

Figure 94 Rule Definition Screen

RL: $HASP100   LIB CTO.PROD.RULES                               TABLE: JOB

COMMAND ===>                                                    SCROLL===> CRSR

+-----------------------------------------------------------------------------+

  ON MESSAGE  = $HASP100

     JNAME PROD*    JTYPE J       SMFID        SYSTEM

     ROUTE          DESC          CONSOLEID    CONSOLE

     APPEARED       TIMES IN      MINUTES                        And/Or/Not

  OWNER SYS3     GROUP                         MODE PROD    RUNTSEC

  THRESHOLD

  DESCRIPTION JES2 JOB ON RDR MESSAGE SUPPRESSION

  DESCRIPTION

  ===========================================================================

  /* SUPPRESS THE MESSAGE

  DO DISPLAY  = SUPPRESS Y ROUTE     DESC    CONSOLEID    CONSOLE

  SYSTEM

  =========================================================================== 

                            D O   O P T I O N S                               

   Askoper  - Ask operator             COMmand  - Issue operator command      

   CONd     - Add/delete IOA condition CTD req  - O/F CONTROl-D mission       

   CTOPcmsg - Message to CONTROL-O/PC  DISplay  - Message / Command control   

   DOm      - Delete operator messag   FOrcejob - Force job under CONTROL-M   

   Ksl      - Activate a KOA script    RESource - Change IOA resources        

   RUle     - Call another RULE        SEt      - Set CONTROL-O/IOA variable  

   SHEll    - Run a z/OS shell script  SHout    - Notification facility       

   SMSClass - Set a new SMS class      SMSMsg   - Issue message by SMS ACS    

   SNmp     - Send SNMP Trap message   STopjob  - Stop next job steps         

   SYsreq   - System request           Tso      - Activate TSO command        

   WAit     - Completion of events     >        - Open a new DO line          

   /* -PF16 - Add comment line         />       - Comment/Uncomment "DO"      

   If / ELse / ENDIf / ENDMsg / WHile / ENDWhile - Logical instructions       

   EXit / RETurn / TERminat                      - End Process Instructions   

  =========================================================================== 

  DAYS                                                          DCAL

 AND/OR

  WDAYS   ALL                                                   WCAL

  MONTHS  1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y

  DATES

  CONFCAL          SHIFT

  ENVIRONMENT SMFID      SYSTEM

  ===========================================================================

  IN

  TIME FROM      UNTIL           INTERVAL      PRIORITY     CONTINUE SEARCH Y

======= >>>>>>>>>>>>>>> END OF RULE DEFINITION PARAMETERS <<<<<<<<<<<<<<< =====

FILL IN RULE DEFINITION. CMDS: EDIT, SCHED, OPT, SHPF                  06.44.34

BMC recommends that all Control-O users read the description of the Online Rule Definition facility in Rule Definition Facility before reading this chapter.

All parameter definitions are stored as members in standard user libraries. The Control-O term for a member of this type is "table." Each table is composed of parameters for a number of different rules, all of which usually relate to the same subject. Maintenance of tables in the library and management of rules in each table is performed using the Online Rule Definition facility.

Rule definition parameters fall into the following basic categories:

• Message/Event Selection Parameters – selection conditions (see the ON MESSAGE parameter in Figure 94). Mandatory.
• General Parameters – general information (see the parameters from OWNER through DESCRIPTION in Figure 94). Optional.
• Automated Console Action Parameters – actions to be performed (see DO OPTIONS in Figure 94). Mandatory.
• Basic Scheduling Parameters – dates to activate Control-O environment and rules (see the parameters from DAYS through ENVIRONMENT in Figure 94). Optional.
• Runtime Scheduling Parameters – runtime conditions (see the IN and TIME parameters in Figure 94). Optional.

The following pages contain a quick summary of the parameters in each of these categories. Following this summary is a series of sample rules that demonstrate how basic tasks are accomplished.

The last (and largest) portion of this chapter contains detailed descriptions of all rule definition parameters (in alphabetical order).