Reference

How to Read the Syntax Diagrams

The following rules apply to the syntax diagrams used in this book:

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

  The >>--- symbol indicates the beginning of a statement.

  The ---> symbol indicates that the statement syntax is continued on the next line.

  The >--- symbol indicates that a statement is continued from the previous line.

  The --->< symbol indicates the end of a statement.

  Diagrams of syntactical units other than complete statements start with the >--- symbol and end with the ---> symbol.

• Required items appear on the horizontal line (the main path).

  >>-required_item-----------------------------------------------><
   
  

• Optional items appear below the main path.

  >>-required_item--+---------------+----------------------------><
                    '-optional_item-'
   
  

  If an optional item appears above the main path, that item has no effect on the execution of the statement and is used only for readability.

                    .-optional_item-.
  >>-required_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.

  >>-required_item----+-required_choice1-+-----------------------><
                      '-required_choice2-'
   
  

  If choosing one of the items is optional, the entire stack appears below the main path.

  >>-required_item----+------------------+-----------------------><
                      +-optional_choice1-+
                      '-optional_choice2-'
   
  

  If one of the items is the default, it appears above the main path and the remaining choices are shown below.

                      .-default_choice--.
  >>-required_item----+-----------------+------------------------><
                      +-optional_choice-+
                      '-optional_choice-'
   
  

• An arrow returning to the left, above the main line, indicates an item that can be repeated.

                      .-------------------.
                      V                   |
  >>-required_item-------repeatable_item--+----------------------><
   
  

  If the repeat arrow contains punctuation, you must separate repeated items with the specified punctuation.

                      .-,-----------------.
                      V                   |
  >>-required_item-------repeatable_item--+----------------------><
   
  

  A repeat arrow above a stack indicates that you can repeat the items in the stack.

• Keywords appear in uppercase (for example, FROM). In Net.Data, keywords can be in any case. Terms that are not keywords appear in lowercase letters (for example, column-name). They represent user-supplied names or values.
• If punctuation marks, parentheses, arithmetic operators, or other such symbols are shown, you must enter them as part of the syntax.