Syntax diagram conventions
Use the following conventions to interpret the syntax diagrams that accompany the command references.
To read the syntax diagrams, start at the top leftmost line and read from left to right and from top to bottom. The horizontal line represents the main path of parameters that you use when you enter the commands. Parameters that are off the main path are optional and may have a default, if you omit them.
Symbols and punctuation
Symbol | Description |
---|---|
>> | Marks the beginning of the command syntax. |
> | Indicates that the command syntax is continued. |
| | Marks the beginning and end of a fragment or part of the command syntax. |
>< | Marks the end of the command syntax. |
You must include all punctuation such as colons, semicolons, commas, quotation marks, and minus signs that are shown in the syntax diagram.
Parameters
- Required
- Required parameters are displayed on the main path.
- Optional
- Optional parameters are displayed below the main path.
- Default
- Default parameters are displayed above the main path.
.-Default_variable-. >>-Required_variable--+------------------+--Optional_parameter-><
Parameters are classified as keywords or variables. You must enter keywords exactly as written in the diagram. The diagrams display variables, which are names or values you supply, in italics.
Single-line command
In the following example, the USER command is a keyword. The required variable parameter is user_id, and the optional variable parameter is password. Replace the variable parameters with your own values.
>>-USER-- -user_id-- -+----------+----------------------------->< '-password-'
Multiple line commands
If a diagram is longer than one line, the first line ends with a single arrowhead and the second line begins with a single arrowhead.
>>-The first line of a syntax diagram that is longer than one line--> >--Continues on the next line displaying any subcommands, parameters, or variables.-><
Choices
Syntax diagrams display choices of exclusive required parameters as a vertical stack starting on the main path. You must choose one of the parameters.
>>-+-Choice_1-+------------------------------------------------>< '-Choice_2-'
Non-alphanumeric characters
Blank spaces
Default parameters
Syntax fragments
>>-Command-- -| Operands |------------------------------------->< Operands |--Operand1--,--Operand2--,--Operand3---------------------------|