Use the conventions described here 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.
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.
.-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.
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-'
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.-><
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-'
>>-Command-- --| Operands |------------------------------------>< Operands |--Operand1--,--Operand2--,--Operand3---------------------------|