How to read syntax diagrams

Syntax diagrams help to show syntax in a graphical way.

Throughout this publication, syntax is described in diagrams like the one shown here, which describes the SRSTAT TSO command:


1 SRSTAT
2  ' resource name '
2?  SUBSYS (
3.1! OPCA
3.1 subsystem name
3.1 MSTR
2 )
2?  AVAIL (
3.1! KEEP
3.1 RESET
3.1 NO
3.1 YES
2 )
2?  DEVIATION (
3.1! KEEP
3.1 amount
3.1 RESET
2 )
2?  QUANTITY (
3.1! KEEP
3.1 amount
3.1 RESET
2 )
2?  CREATE (
3.1! YES
3.1 NO
2 )
2?  TRACE (
3.1! 0
3.1 trace level
2 )
The symbols have these meanings:
 ►►───── 
The statement begins here.
 ──────► 
The statement is continued on the next line.
 ►────── 
The statement is continued from a previous line.
 ─────►◄ 
The statement ends here.

Read the syntax diagrams from left to right and from top to bottom, following the path of the line.

These are the conventions used in the diagrams:
  • Required items appear on the horizontal line (main path):
    
    1  STATEMENT  required item
  • Optional items appear below the main path:
    
    1  STATEMENT ? optional item
  • An arrow returning to the left above the item indicates an item that you can repeat. If a separator is required between items, it is shown on the repeat arrow.
    
    1  STATEMENT + , repeatable item
  • If you can choose from two or more items, they appear vertically in a stack.
    • If you must choose one of the items, one item of the stack appears on the main path:
      
      1  STATEMENT
      1 required choice 1
      1 required choice 2
    • If choosing one of the items is optional, the entire stack appears below the main path:
      
      1  STATEMENT
      1 optional choice 1
      1 optional choice 2
    • A repeat arrow above a stack indicates that you can make more than one choice from the stacked items:
      
      1  STATEMENT
      1+ ,
      1 optional choice 1
      1 optional choice 2
      1 optional choice 3
      
      1  STATEMENT
      1+ ,
      1 required choice 1
      1 required choice 2
      1 required choice 3
  • Parameters that are above the main line are default parameters:
    
    1  STATEMENT
    1! default
    1 alternative
  • Keywords appear in uppercase (for example, STATEMENT).
  • Parentheses and commas must be entered as part of the command syntax, as shown.
  • For complex commands, the item attributes might not fit on one horizontal line. If that line cannot be split, the attributes appear at the bottom of the syntax diagram:
    
    1  STATEMENT
    1   required choice 1?  optional choice 1 (
    2.1! default
    2.1 alternative
    1 )?  optional choice 2 (
    2.1! default
    2.1 alternative
    1 )
    1  required choice 2
    1  required choice 3