Previous Topic

Next Topic

Book Contents

Book Index

Specifying Comments

Comments are free text descriptions of rule definition parameters that are stored in a rule definition member. BMC recommends that you insert comments within rule definitions for clarification and documentation purposes. Comments are not processed during rule execution.

To insert a comment, position the cursor at the line before which the comment should be inserted, and press CMNT (PF04/PF16). A comment line is opened beginning with the symbol /*. To insert additional lines, fill in the current line and press Enter.

Note: Comments can also be inserted by either typing the CMNT command in the COMMAND field and moving the cursor to the line before which the comment should be inserted and pressing Enter, or by typing /* on an empty DO statement and pressing Enter.

The Rule Definition screen shown in Figure 25 illustrates comment usage.

Figure 25 Illustration of Rule Definition Comment Usage

RL: CANCEL *   LIB CTO.PROD.RULES                               TABLE: JOB

COMMAND ===>                                                    SCROLL===> CRSR

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

  ON COMMAND  = CANCEL *                                                     

     JNAME CONSOLE  JTYPE         SMFID        SYSTEM       USERID

     ROUTE          DESC          CONSOLEID 01 CONSOLE                     

   APPEARED     TIMES IN      MINUTES                          And/Or/Not  

  OWNER IOAADMIN GROUP                         MODE PROD    RUNTSEC      

  THRESHOLD

  DESCRIPTION ASK FOR OPERATOR'S CONFIRMATION OF SENSITIVE COMMANDS         

  DESCRIPTION                                                               

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

  /* SUPPRESS ORIGINAL COMMAND                                               

  DO DISPLAY  = SUPPRESS Y ROUTE     DESC    CONSOLEID    CONSOLE   

     SYSTEM                                                         

  /* ASK OPERATOR FOR CONFIRMATION                                          

  WHILE    %%$RPLYTXT NE YES AND %%$RPLYTXT NE NOT                             

  DO ASKOPER  = ENTER "YES" OR "NOT" FOR CONFIRMATION                        

  ROUTE       CONSOLEID    CONSOLE                          TIMEOUT   

  ENDWHILE                                                                  

  /* UPON CONFIRMATION, RE-ISSUE THE ORIGINAL COMMAND                        

  IF       %%$RPLYTXT EQ YES                                                  

  DO COMMAND  = %%$CMD   

     WAIT        CONSOLEID    CONSOLE          SYSTEM                  

     WAITMODE   N                                                            

  ENDIF                                                                     

  DO                                                                        

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

An unlimited number of comment lines can be specified in a rule definition.

Control-O line editing commands, similar to ISPF line commands, can be performed on comment lines. For more information, see Editing Rule Definitions in the IOA Edit Environment.

Parent Topic

Rule Definition Facility