Syntax Model Command Language › Elements of a Command Model › COMMAND Clause

COMMAND Clause

The COMMAND clause signals both the start and end of a command model. We show the full syntax of the COMMAND clause. Explanations of the verbs for the COMMAND clause follow the syntax.

COMMAND Start Syntax

COMMAND command name,                                      {-}
       [{OPERAND=OPTIONAL}],                               {-}
       [{REPEATS}],                                        {-}
       [{(MDLTYPE=(ccc}],                                  {-}
       [{NOSPOOL=ALLOW|LOG|PREVENT|PREVENT-LOG}],-         {-}
       [{SYNERR=ALLOW|LOG|PREVENT|PREVENT-LOG}]

COMMAND End Syntax

COMMAND END

Verb Descriptions (COMMAND Clause)

command name

Specifies the name of the CP command this command model applies to. This must be the full name of the command.

OPERAND=OPTIONAL

Indicates you can enter this command without an operand and there are no defaults for any optional operands. If you do not specify OPERANDS=OPTIONAL, CA ACF2 for z/ VM assumes that you must specify at least one operand with the command or that there is a default value for an optional operand. For example, the BEGIN command does not require an operand, nor does it have any default. Therefore, the command model for BEGIN includes:

COMMAND BEGIN,OPERAND=OPTIONAL
 
    FORMAT CLASS=G
       OPERAND HEXLOC,6,TRAN=HEX,OPTIONAL
    FORMAT END
 
COMMAND END

Although ECHO does not require you enter an operand with the command, it does provide a default for an optional operand. Therefore, ECHO does not need an OPERAND=OPTIONAL subparameter.

COMMAND ECHO
 
    FORMAT CLASS=G
       OPERAND LIST=(NN,2,TRAN=DECIMAL),  -
                     (1,1,TYPE=DEFAULT,   -
                      TRAN=DECIMAL))
    FORMAT END
 
COMMAND END

REPEATS

Indicates you can repeat all the formats of this command. To illustrate how this works, review the following excerpt from the TERMINAL model and some example commands:

COMMAND TERMINAL,REPEATS

For example, in the TERMINAL CHARDEL OFF LINESIZE 20 MODE VM command, CP and CA ACF2 for z/ VM treat this as three separate commands:

TERMINAL CHARDEL OFF
TERMINAL LINESIZE 20
TERMINAL MODE VM

Use REPEATS on the COMMAND clause when you can repeat all the formats for a command. The only COMMAND clause that currently uses REPEATS is the TERMINAL command. If only some formats repeat, then specify REPEATS in the FORMAT clause as described in the next section of this guide.

MDLTYPE=ccc

Compiles a model with an MDLTYPE that is different from the default MDLTYPE. The default is set in the MDLTYPE operand of the CMDLIM VMO record.

NOSPOOL=ALLOW|LOG|PREVENT|PREVENT-LOG

Specifies how CA ACF2 for z/ VM handles a no spool file found condition.

ALLOW

CA ACF2 for z/ VM passes the command to CP for normal syntax checking. CA ACF2 for z/ VM does not write an SMF record.

LOG

CA ACF2 for z/ VM logs the error to SMF and then passes the command to CP to check for CP syntax. CP returns standard CP error messages to the user if it also detects a no spool error. You can use this option to test command models to determine if they are correct.

PREVENT

CA ACF2 for z/ VM rejects the command and returns a nospool message to the user. PREVENT is the default.

PREVENT-LOG

CA ACF2 for z/ VM rejects the command and logs the action. Does not cause a violation.

SYNERR=ALLOW|LOG|PREVENT|PREVENT-LOG

Specifies how CA ACF2 for z/ VM handles a command syntax error condition.

ALLOW

CA ACF2 for z/ VM passes the command to CP for normal syntax checking. CA ACF2 for z/ VM does not write an SMF record. You can abbreviate this parameter with A.

LOG

CA ACF2 for z/ VM logs the syntax error to SMF and then passes the command to CP, where it goes through normal CP syntax checking. You can abbreviate this parameter with L.

Standard CP error messages are returned to the user if CP also detects a syntax error. You can use this option to test command models to determine if they are correct.

PREVENT

CA ACF2 for z/ VM rejects the command and returns a syntax error message to the user. This is the default. You can abbreviate this parameter with P.

PREVENT-LOG

CA ACF2 for z/ VM rejects the command and logs the action. Does not cause a violation. You can also set a global system default value for this option. For more information, see the chapter “Controlling Syntax Error Processing for Command Limiting.”

END

Signals the end of the command model.

COMMAND command-name
          .
          .
          .
COMMAND END