How to read syntax conventions
This topic describes how to read syntax conventions. It defines syntax notations and provides syntax examples that contain these items.
Note: When running a command, specify command parameters
in the order in which they are shown in the command syntax diagram.
Notation | Meaning | Syntax example | Sample entry |
---|---|---|---|
Apostrophes | Apostrophes indicate a parameter string and must be entered as shown. |
|
|
Comma | Commas must be entered as shown. |
|
|
Ellipsis ... | Ellipsis indicates that the preceding item or group of items can be repeated one or more times. Do not enter the ellipsis. |
|
|
Parentheses and special characters | Parentheses and special characters must be entered as shown. |
|
|
Underline | Underline indicates a default option. If you select an underlined alternative, you do not have to specify it when you enter the command. |
|
K M |
Lowercase parameter | Lowercase indicates a variable term. Substitute your own value for the item. |
|
or
|
Uppercase parameter | Uppercase indicates the item must be entered using the characters shown. Enter the item in either upper or lowercase. |
|
or
|
Single brackets | Single brackets represent single or group-related items that are optional. Enter one or none of these items. |
|
|
Stacked brackets | Stacked brackets represent group-related items that are optional. Enter one or none of these items. |
|
|
Single braces | Single braces represent group-related items that are alternatives. You must enter one of the items. You cannot enter more than one. |
|
|
Stacked braces | Stacked braces represent group related items that are alternatives. You must enter one of the items. You cannot enter more than one. |
|
|
Or-bar (|) | An or-bar indicates a mutually exclusive choice. When used with brackets, enter one or none of the items. When used with braces, you must enter one of the items. |
|
|
Stacked items with or-bars (|) and brackets | Stacked items with or-bars indicates a mutually-exclusive choice. Enter one or none of these items. |
|
|