Syntax Model Command Language › Elements of a Command Model › OPERAND Clause › Interpretation Control (Format 8)

Interpretation Control (Format 8)

This format OPERAND clause includes additional verbs that alter the flow of command interpretation as it proceeds through a command model. You can use all of the verbs shown in format eight in formats one through seven.

[{label}]       OPERAND value-clause,                           {-}
                    { [,MATCH=CONTINUE|EXIT,]                 } {-}
                    { [NOMATCH=CONTINUE|EXIT|EXITERR|NEXTFMT] }
                      [OPTIONAL]

The MATCH and NOMATCH verbs alter the flow a command follows during syntax interpretation. The default value for these verbs are globally set and managed by the CA ACF2 for z/ VM command model compiler. In most cases, you do not have to specify a MATCH or NOMATCH verb. However, some of the supplied models use the NOMATCH verb.

The ATTACH model contains a good example of how to use the NOMATCH=NEXTFMT verb. The ATTACH command has three very similar formats as shown in the following figure.

 COMMAND ATTACH
    FORMAT CLASS=B
        OPERAND RCUU,4,TRAN=RCUU
        OPERAND TO,2,TYPE=DEFAULT
        OPERAND SYSTEM,6,NOMATCH=NEXTFMT
        OPERAND AS,2,TYPE=DEFAULT
        OPERAND VOLID,6,TRAN=ANY
        OPERAND 3330V,S,OPTIONAL
        OPERAND VOLID,6,TRAN=ANY,OPTIONAL
    FORMAT END
 
    FORMAT CLASS=B
        OPERAND RCUU,4,TRAN=RCUU,VALUEFOR=ATTAS
        OPERAND TO,2,TYPE=DEFAULT
        OPERAND LIST=(                 -
                      (*,1,TRAN=SELF), -
                      (USERID,8,TRAN=USER,NOMATCH=NEXTFMT) -
                     )
        OPERAND AS,2,TYPE=DEFAULT
ATTAS   OPERAND VCUU,4,TRAN=VCUU,OPTIONAL
        OPERAND R/O,1,OPTIONAL
        OPERAND 3330V,S,OPTIONAL
        OPERAND VOLID,6,TRAN=ANY,OPTIONAL
    FORMAT END
   FORMAT CLASS=B
       OPERAND LIST=((RCUU,7,TRAN=RCUU,TYPE=RANGE),      -
                     (RCUU,4,TRAN=RCUU,OCCURS=48))
       OPERANDTO,2,TYPE=DEFAULT
       OPERAND LIST=(                                    -
                     (*,1,TRAN=SELF),                    -
                     (USERID,8,TRAN=USER)                -
                    )
       OPERAND R/O,1,OPTIONAL
       OPERAND 3330V,S,OPTIONAL
   FORMAT END
COMMAND END

As you can see, all three formats begin with the RCUU operand. The NOMATCH=NEXTFMT properly interprets the ATTACH command. For example, if CA ACF2 for z/ VM determines that the command does not match the first FORMAT clause, it checks the next FORMAT clause for a match, and so on until it finds the proper command format.