Command syntax rules

Note: For compatibility this release of Operations Manager also accepts commands using the syntax of previous releases.
The following rules must be applied when entering commands to properly configure Operations Manager V1.6:
  • The COMMAND starts with the first non-blank character.

    Below is an example of a command with no operands:

    STATUS
    
  • The minimum operand value length is one character and the maximum operand value length is determined by the command.
  • Operand KEYWORD/VALUE pairs may be entered in any order.
  • Operand KEYWORD/VALUE pairs may only be entered once.
  • If operands are required, one or more spaces must separate the COMMAND from the first operand.
  • Spaces are required in between operand keywords.
  • One or more blanks separate the operand VALUE and the next operand KEYWORD.
  • The operand value follows the operand and may or may not be enclosed in parentheses, as you prefer. If parentheses are used, no spaces are allowed between:
    • the operand and the left parenthesis.
    • the end of the operand value and the right parenthesis.
    Below is an example of a command with one operand and parentheses:
    STATUS DETAIL(RULE)
    
    Below is an example of a command with one operand and no parentheses for the operand's value :
    STATUS DETAIL RULE
    
  • If multiple operands are required, you can use spaces to separate the keywords. However, if parentheses are used, a comma must follow the right parenthesis.

    Below is an example of a command with multiple operands and using parentheses:

    DEFRULE NAME(RULE01),MATCH(*HCPMID6001I*),ACTION(MIDNITE) 
    

    Below is an example of a command with multiple operands using spaces instead of parentheses:

    DEFRULE NAME RULE01 MATCH *HCPMID6001I* ACTION MIDNITE 
    
  • Operands may be entered in any order. For example, the following commands are equivalent:
    DEFRULE NAME(RULE01), MATCH(*HCPMID6001I*), ACTION(MIDNITE) 
    DEFRULE MATCH(*HCPMID6001I*),NAME(RULE01),ACTION(MIDNITE) 
    DEFRULE NAME(RULE01), ACTION(MIDNITE), MATCH(*HCPMID6001I*)
    DEFRULE NAME RULE01 ACTION MIDNITE MATCH *HCPMID6001I*  
  • If you are using parentheses to delimit the operand value and an operand value contains parentheses, the parentheses must be balanced or single quotes must be used. Below is an example of balanced parentheses in the COMMAND operand:
    DEFACTN NAME(ACTN01),COMMAND(PRINT A FILE ( NOCC )),ENV (GOM) 
    
  • If you are using parentheses to delimit the operand value, any operand value may be entered in single quotes ('). Quoting an operand value allows the operand value to bypass the balanced parentheses rule. The rules to quoting are the following:
    • The beginning quote must follow the left parenthesis with no spaces.
    • The operand value begins in the position after the beginning single quote and the operand value ends in the position before the ending quote.
    • The ending quote must be followed by the right parenthesis with no spaces.
    • If a single quote is required in a quoted operand value, use two single quotes to produce a single quote in the operand value.

    Below is an example of a quoted operand value (with parentheses) in the COMMAND operand:

    DEFACTN NAME(ACTN01),COMMAND('PRINT A FILE( NOCC'),ENV(LVM)
    
  • If you are using spaces to delimit the operand keywords and an operand value contains one or more spaces, the operand value must be delimited using single quotes. For example, if the value is only one word, no single quotes are needed:
    DATA jump
    However, if the value contains two or more words, single quotes are required:
    DATA 'jump ship'
    Below is an example of an operand value (with a space) in the PARM operand:
    DEFRULE NAME RULE1 MATCH '* HENRY *' ACTION ACTN01 PARM 'Found HENRY'
    
  • If you are using spaces to delimit the operand keywords and an operand value is delimited by single quotes, any single quote within the value, such as the apostrophe in "Joe's BBQ", must be entered as two single quotes (' '). The example below shows the MATCH operand with a value containing a space and single quotes.
    DEFRULE NAME RULEHS MATCH '*Joe''s BBQ*' ACTION ACTNHS
    The next example, "Homer's D'OH Nuts", contains two apostrophes in the text.
    DEFRULE NAME RULEHS MATCH '*Homer''s D''OH Nuts*' ACTION ACTNHS