Defining rules online

The selection criteria and instructions defined for each rule are called rule parameters. This section briefly describes the rule parameters and their specific uses. For more information about the specific parameters, see Parameter Descriptions.

The rule parameters are defined in the Rule Definition facility. As an example, the Rule Definition screen for site standards is shown in the following figure. For more information about the Rule Definition facility, see Rule Definition Facility.

Fig.JV.3.1 Site Standard Rule Definition Screen

 - CONTROL-M/JCLVERIFY  RULE:  TESTENV                           TABLE: TABLE1

 COMMAND ===>                                                    SCROLL===> CRSR

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

 | RULE             ENVIRONMENT             PRIORITY       CONTINUE SEARCH     |

 | DESC                                                                        |

 | DESC                                                                        |

 | =========================================================================== |

 | JOBNAME                                                                     |

 | LIBRARY                                              MEMBER                 |

 | SCHDLIB                                              SCHDTAB          O/N   |

 | =========================================================================== |

 | ON                                                                          |

 | =========================================================================== |

 |                      O N  T Y P E S:                                        |

 |                                                                             |

 |  INIT                      END                                              |

 |  JOB                       INCLUDE                    JCLLIB                |

 |  EXEC                      PROC                       STEPEND               |

 |  DD                        DDSYSIN                    DDSYSOUT              |

 | =========================================================================== |

 | DO                                                                          |

 | =========================================================================== |

 |                      D O  T Y P E S:                                        |

 |                                                                             |

 |  IF       ELSE       RETURN       ENDIF       SET         MSG       REXX    |

 |  WHILE    ENDWHILE   ADJMSG                                                 |

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

 FILL IN RULE DEFINITION. CMDS: EDIT    DOOPT    ONOPT    CANCEL        16.38.45

The rule panel is divided into the following sections:

• identification fields

  This section includes the rule name and its description. These fields are used for display purposes only, but have no effect on the rule logic. This section also includes the environment field, which is used in the rule selection criteria, the rule priority, and the continue search indicator.

• common selection fields

  This section includes the selection fields that are common to all the various ON types. Several selection blocks can be specified with Or/Not relationships.

• ON definition

  This section includes the ON statement. The ON defines the reason for the rule invocation. In most of the cases the reason is the processing of a JCL statement. The section can hold more than one ON statement (an empty row is opened once the preceding one is used - similar to other IOA panels). Once the ON statement is specified, the specific ON selection fields (if any) is added to the panel. Refer to the rules selection fields section above. The specific selection fields for each ON statement are discussed in the relevant ON section later in this document. Several selection blocks for the ON specific fields can be specified with Or/Not relationships.

• available ON statements

  This section simply lists the available ON statements from which the user can choose. This section can be hidden using the ONOPT command (or the short ON command), which allows the user to toggle between the hidden and displayed states of the section.

• DO definition

  This section includes the DO statement. The DO defines what action will be performed if the rule is triggered. The rule is triggered when the ON "event" has occurred and all the rule's selection fields match. The different DO statements are described in detail later in this document. The section can hold more than one DO statement (an empty row is opened once the preceding one is used).

• available DO statements

  This section simply lists the available DO statements from which the user can choose. This section can be hidden using the DOOPT command, which allows the user to toggle between the hidden and displayed states of the section.

All parameter definitions are stored as members in the olprefj.RULES, olprefj.ENFRULES, and olprefj.REFRULES libraries. The Control-M JCL Verify term for a member of this type is "rule 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:

• General Parameters - general information.
• Common Selection Parameters - common selection conditions.
• Event Selection Parameters - event selection conditions.
• Action Parameters - actions to be performed.

Following is a brief summary of the parameters in each of these categories. For a detailed description of all the rule definition parameters (in alphabetical order), see Parameter Descriptions.