Reading syntax diagrams

To read syntax diagrams, follow one line at a time from the beginning to the end, and code everything you encounter on that line.

The following conventions apply to all syntax diagrams for control cards:

  • Read the syntax diagrams from left to right and top to bottom.
  • Each syntax diagram begins with a double arrowhead (►►) and ends with opposing arrowheads (►◄).
  • An arrowhead (►) at the end of a line indicates that the syntax continues on the next line. A continuation line begins with an arrowhead (►).
  • Commands and keywords are shown in uppercase and lowercase letters. The uppercase portion is the minimum needed to code the command properly; the lowercase portion is optional. For example, FASTCOPY can be coded in any of the following ways: FAST, FASTC, FASTCO, FASTCOP, or FASTCOPY.
    Note: Commands must be entered in uppercase. Lowercase is not recognized.
  • Some commands and keywords have alternative abbreviations; these appear as part of the stack for that command or keyword. For example, the alternative abbreviation for TARget is TGT.
    Read syntax diagramSkip visual syntax diagram TARget TGT (target_volume)
  • Words in all lowercase letters represent information you supply. For example, target_volume, or seconds.
  • You must provide all items enclosed in parentheses, ( ), and you must include the parentheses.
  • Where you can choose from two or more keywords, the choices are stacked one above the other. If one choice within the stack lies on the main path, you must choose a keyword. In the following example you must choose either target_volume, TARGET, or TGT.
    Read syntax diagramSkip visual syntax diagramtarget_volume duplex_target remote_target remote_targetTARgetTGT( local_targetremote_targetduplex_target)

    If one or more keywords are below the main path, they are optional. You can choose one, the other, or none. In the following example SINGLEgroup is an optional keyword.

    Read syntax diagramSkip visual syntax diagram SINGLEgroup

    If a stack of keywords is below the main path and one keyword is above the main path, the use of the keyword is optional, and the above item is the default. In the following example, if no keywords are specified, the default NOPUrge is taken.

    Read syntax diagramSkip visual syntax diagram NOPUrge PUrge
  • The repeat symbol appearing above keywords and variables indicates that you can specify those keywords and variables more than once. If a comma appears in the repeat symbol, you must separate repeated keywords or variables with a comma or a blank. For example, after the keyword Agents, you can enter multiple system identifiers separated by commas.
    Read syntax diagramSkip visual syntax diagram Agents ( ,sysid )
  • Substitution blocks are used to simplify the diagrams. They indicate that blocks of the syntax diagram are located outside of the main diagram. You insert the keywords for that block where the symbol appears, and return to the main diagram to continue with the command. This technique is used for Options.