Appendix C. Links
https://github.com/rbowler/sandhawk (release 4.xx development stream)
https://github.com/hercules-390/hyperion (cutting-edge developer sandbox)
Powered by Tizra® |
fragment_name
[DEFAULT KEYWORD | KE
YWORD 1 | KEYWORD 2 | KEYWORD 4]
KEYWORD={choice 1 |
choice 2
|
choice |
choice 4}
Figure 69: Sample Syntax Description
The next figure shows a sample of a complex syntax diagram. It shows the same example as in the
syntax description in the previous section. Like in the example before it is not based on an existing
system parameter or panel command. It is used mainly to demonstrate the “look and feel” of syntax
descriptions.
Syntax
Êʬ¬¬ CMDNAME ¬¬¬ required argument ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬Ê
optional argument ¬¬¬¯
ʬ¬¬§¬¬¬ required choice 1 ¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬ required choice 2 ¬¬¬«
ª¬¬¬
optional choice 1 ¬¬¬«
required choice optional choice 2 ¬¬¬¯
ʬ¬¬ REQUIRED KEYWORD=variable ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬Ê
KEYWORD=variable ¬¬¬¯
default choice ¬¬¬¬¬¬®
ʬ¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬¬¬¬ KEYWORD 1 ¬¬¬¬¬¬« ¬¬¬§¬¬¬ choice 1 ¬¬¬«
¬¬¬¬¬¬ KEYWORD 2 ¬¬¬¬¬¬choice 2 ¬¬¬¯
repeatable item n repeatable item n ¬¬¬¨¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ʬ¬¬« fra
gment name ª¬¬¬ (
¬¬¬ variable 1 ¬¬¬ ,
¬¬¬ variable 2 ¬¬¬ ) ¬¬¬¬¬¬¬¬Ê
fragment_name
KEYWORD ¬¬¬®
ª¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬ KEYW
ORD= ¬¬¬§¬¬¬ choice 1 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬¬¬¬¬ KEYWORD 1 ¬¬¬¬¬¬«
ª¬¬¬ choice 2 ¬¬¬«
ª¬¬¬¬¬¬ KEY
WORD 2 ¬¬¬¬¬¬«
ª¬¬¬ choice ¬¬¬«
ª¬¬¬¬¬¬ KEYWORD ¬¬¬¬¬¬«
¬¬¬ choice 4 ¬¬¬¯
¬¬¬¬¬¬ KEYWORD 4 ¬¬¬¬¬¬¯
Figure 70: Sample Syntax Diagram
Symbol
Description
ª¬¬¬ SEGMENT= ¬¬¬§¬¬¬ value_1 ¬¬¬§¬¬¬«
value 2 ¬¬¬¯
This symbol indicates a syntax segment
which is referenced from a main syntax
diagram that is shown above the syntax
segment.
KEYWORDS
Keywords are denoted with upper case
letters. Obey the spelling. Lower case
letters are optional and can be omitted
(for example DISable). In the actual
statements or commands the keywords
can be coded in upper case or lower
case letters.
variables
All user defined values are denoted with
lower case italic letters. They represent
user supplied names or values. In the
actual statements or commands they can
be coded in upper case or lower case
letters.
Table 12: Reading Syntax Diagrams
The following figure shows a sample of a complex syntax description. This is not an example of an exis-
ting system parameter or panel command. It is used mainly to demonstrate the “look and feel” of syntax
descriptions.
Syntax
CMDNAME required argument [optional argument]
{required choice 1 |
required choice 2 |
required choice }
[optional choice 1 |
optional choice 2]
REQUIRED KEYWORD=variable
[OPTIONAL KEYWORD=variable]
[DEFAULT KEYW
ORD | KEYW
ORD 1 | KEYWORD 2]
[KEYWORD=default choice | KEY
WORD={choice 1 | choice 2}]
repeatable item n
{repeatable item n ...}
repeatable item n
{,repeatable item n ,...}
fragment name
(variable 1, variable 2)
fragment_name
[DEFAULT KEYWORD | KE
YWORD 1 | KEYWORD 2 | KEYWORD 4]
KEYWORD={choice 1 |
choice 2
|
choice |
choice 4}
Figure 69: Sample Syntax Description
The next figure shows a sample of a complex syntax diagram. It shows the same example as in the
syntax description in the previous section. Like in the example before it is not based on an existing
system parameter or panel command. It is used mainly to demonstrate the “look and feel” of syntax
descriptions.
Syntax
Êʬ¬¬ CMDNAME ¬¬¬ required argument ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬Ê
optional argument ¬¬¬¯
ʬ¬¬§¬¬¬ required choice 1 ¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬ required choice 2 ¬¬¬«
ª¬¬¬
optional choice 1 ¬¬¬«
required choice optional choice 2 ¬¬¬¯
ʬ¬¬ REQUIRED KEYWORD=variable ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬Ê
KEYWORD=variable ¬¬¬¯
default choice ¬¬¬¬¬¬®
ʬ¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬¬¬¬ KEYWORD 1 ¬¬¬¬¬¬« ¬¬¬§¬¬¬ choice 1 ¬¬¬«
¬¬¬¬¬¬ KEYWORD 2 ¬¬¬¬¬¬choice 2 ¬¬¬¯
repeatable item n repeatable item n ¬¬¬¨¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ʬ¬¬« fra
gment name ª¬¬¬ (
¬¬¬ variable 1 ¬¬¬ ,
¬¬¬ variable 2 ¬¬¬ ) ¬¬¬¬¬¬¬¬Ê
fragment_name
KEYWORD ¬¬¬®
ª¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬ KEYW
ORD= ¬¬¬§¬¬¬ choice 1 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬¬¬¬¬ KEYWORD 1 ¬¬¬¬¬¬«
ª¬¬¬ choice 2 ¬¬¬«
ª¬¬¬¬¬¬ KEY
WORD 2 ¬¬¬¬¬¬«
ª¬¬¬ choice ¬¬¬«
ª¬¬¬¬¬¬ KEYWORD ¬¬¬¬¬¬«
¬¬¬ choice 4 ¬¬¬¯
¬¬¬¬¬¬ KEYWORD 4 ¬¬¬¬¬¬¯
Figure 70: Sample Syntax Diagram
Powered by Tizra® |
Symbol
Description
¬¬¬¬ PARM= ¬¬§¬¬¬¬ option_1 ¬¬¬¬§¬¬¬¬¬¬
ª¬¬¬¬ option_2 ¬¬¬¬«
option
A keyword with options. Only one of the
available options may be specified. The
underscored option is the default if the
whole keyword statement is not coded.
¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬
ª¬¬¬¬ optional_choice_1 ¬¬¬¬«
An optional choice (keyword or variable)
with default appears vertically stacked
with the default value above the main
path of the horizontal line and the remai-
ning optional elements below the main
path of the horizontal line. Only one of
the available options may be specified. If
none of these elements is explicitly
specified, the default above the main line
is taken.
¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬
optional choice ¬¬¬¨¬¬¬¯
¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬
,
optional choice ¬¬¬¨¬¬¬¯
An arrow returning to the left of an ele-
ment below the main path of the hor-
izontal line indicates an optional repeat-
able item. A character within the arrow
path means that repeated items have to
be separated by that character. If there is
no character within the arrow path then
the items are separated by a blank.
element ¬¬¬¬¨¬¬¬¬¬
¬¬¬¬ required element ¬¬¬¬¨¬¬¬¬¬
An arrow returning to the left of an ele-
ment on the main path of the horizontal
line indicates an required repeatable
item. A character within the arrow path
means that repeated items have to be
separated by that character. If there is no
character within the arrow path then the
items are separated by a blank.
¬¬¬¬¬¬¬¬¬¬¬¬¬« SEGMENT ª¬¬¬¬¬¬¬¬¬¬¬¬¬¬
This symbol is a reference to a syntax
segment, which is described separately
below the main syntax diagram. Complex
syntax diagrams are occasionally broken
into separated simpler segments.
Symbol
Description
ª¬¬¬ SEGMENT= ¬¬¬§¬¬¬ value_1 ¬¬¬§¬¬¬«
value 2 ¬¬¬¯
This symbol indicates a syntax segment
which is referenced from a main syntax
diagram that is shown above the syntax
segment.
KEYWORDS
Keywords are denoted with upper case
letters. Obey the spelling. Lower case
letters are optional and can be omitted
(for example DISable). In the actual
statements or commands the keywords
can be coded in upper case or lower
case letters.
variables
All user defined values are denoted with
lower case italic letters. They represent
user supplied names or values. In the
actual statements or commands they can
be coded in upper case or lower case
letters.
Table 12: Reading Syntax Diagrams
The following figure shows a sample of a complex syntax description. This is not an example of an exis-
ting system parameter or panel command. It is used mainly to demonstrate the “look and feel” of syntax
descriptions.
Syntax
CMDNAME required argument [optional argument]
{required choice 1 |
required choice 2 |
required choice }
[optional choice 1 |
optional choice 2]
REQUIRED KEYWORD=variable
[OPTIONAL KEYWORD=variable]
[DEFAULT KEYW
ORD | KEYW
ORD 1 | KEYWORD 2]
[KEYWORD=default choice | KEY
WORD={choice 1 | choice 2}]
repeatable item n
{repeatable item n ...}
repeatable item n
{,repeatable item n ,...}
fragment name
(variable 1, variable 2)
Hercules Emulator
Hercules System/370, ESA/390,
z/Architecture Emulator
Operations and Utilities
Guide
Version 4 Release 00
HEOP040000-00
Powered by Tizra® |