CA-GSS Statements and Commands › Notation Conventions

Notation Conventions

Note the following general notation conventions that are used in syntax for the CA‑GSS services. Conventions specific to a service are explained in the section discussing that service.

These general conventions are used in syntax:

• When the parameters are optional, they are enclosed in brackets:

  [parameter]
  

• When a parameter is required but can take one of several predefined values, your choices are enclosed in braces:

  {value1|value2}
  

• Multiple choices sometimes appear on one line with a vertical bar separating them. When your choices are more complex, they appear stacked on top of one another.
• When the entire command syntax does not fit on one line, the syntax is continued on a second line that is indented two spaces. If the command syntax carries over onto a third line, the third line of syntax is indented extra two spaces, and so on.

Example

A syntax diagram for a batch maintenance command named GO:

GO BY {CAR|TRAIN} {TO WORK AT time}             [WITH name]
                  {OUT FOR DINNER TO restaurant}
                  {OVER THE BRIDGE}
 [BECAUSE reason] BEFORE DOING action [AND THEN PHONE HOME]
                               [OR JUST STAY WHERE YOU ARE]

This syntax diagram indicates the following things about the GO command:

• Specify the BY parameter, and give it a value of CAR or TRAIN.
• Specify one of the following parameters: TO WORK AT time, OUT FOR DINNER TO restaurant, or OVER THE BRIDGE.
• (Optional) include the WITH parameter and a value for name.
• (Optional) include the BECAUSE parameter and a value for reason.
• Include the BEFORE DOING parameter and a value for action.
• (Optional) include one of the following parameters: AND THEN PHONE HOME or OR JUST STAY WHERE YOU ARE.