A syntax diagram uses symbols to represent the elements of a command and to specify the rules for using these elements.
This topic shows you how to read the syntax diagrams that represent the command-line interface (CLI) commands. In doing so, it defines the symbols that represent the CLI command elements.
The CLI commands are documented in IBM TotalStorage Multiple Device Manager: Command-Line Interface User's Guide. You can use this guide to view command syntax diagrams. You can also view the command syntax diagrams in the Multiple Device Manager Information Center.
>>-------------------------------------------------------------><
Begins on the left with double arrowheads (>>) and ends on the right with two arrowheads facing each other (><). If a diagram is longer than one line, each line to be continued ends with a single arrowhead (>) and the next line begins with a single arrowhead. Read the diagrams from left-to-right, top-to-bottom, following the main path line.
>>-esscli------------------------------------------------------><
Represents the name of a command, flag, parameter, or argument. A keyword is not in italics. Spell a keyword exactly as it is shown in the syntax diagram.
>>-+--a-- --AccessFile-----------------+----------------------->< '--u-- --Userid-- ---p-- --Password-'
Indicate the parameters or arguments you must specify for the command. Required keywords appear on the main path line. Mutually exclusive required keywords are stacked vertically.
>>-+-------+--------------------------------------------------->< +--h----+ +--help-+ '--?----'
Indicate the parameters or arguments you can choose to specify for the command. Optional keywords appear below the main path line. Mutually exclusive optional keywords are stacked vertically.
.-FCP---. >>-protocol--=--+-FICON-+--------------------------------------><
Appears above the main path line.
.--------------------------------------. V | >>---newports--=--+-ALL-----------------+-+-------------------->< '-PortId1,PortId2,...-'
Represents a parameter or argument that you can specify more than once. A repeatable keyword or value is represented by an arrow returning to the left above the keyword or value.
>>-AccessFile--------------------------------------------------><
Represents the value you need to supply for a parameter or argument, such as a file name, user name, or password. Variables are in italics.
>>--u-- --Userid-- ---p-- --Password---------------------------><
Adds a blank space on the main path line to separate keywords, parameters, arguments, or variables from each other.
>>--d-- --"--ess--=--EssId-- --host--=--'Host Name'-- --profile--=--ProfileName--"-><
Indicates the start and end of a parameter or argument that contains multiple values. Enclose one or more name-value pairs in a set of double quotation marks for a particular parameter or argument. If the value of a parameter or name-value pair contains a blank or white space, enclose the entire value in a set of single quotation marks.
>>-"--ess--=--EssId-- --profile--=--ProfileName--"-------------><
Separates a name from its value in a name-value pair.
>>-| Fragment name |-------------------------------------------><
Fragment name: |--(--fragment details--)---------------------------------------|
Breaks up syntax diagrams that are too long, too complex, or repetitious. The fragment name is inserted in the main diagram, and the actual fragment is shown below the main diagram.