28.11.2012 Views

IBM Tivoli NetView for z/OS Programming: Pipes - IBM notice

IBM Tivoli NetView for z/OS Programming: Pipes - IBM notice

IBM Tivoli NetView for z/OS Programming: Pipes - IBM notice

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

xvi <strong>Programming</strong>: <strong>Pipes</strong><br />

Symbols<br />

The following symbols are used in syntax diagrams:<br />

►► Marks the beginning of the command syntax.<br />

► Indicates that the command syntax is continued.<br />

| Marks the beginning and end of a fragment or part of the command<br />

syntax.<br />

►◄ Marks the end of the command syntax.<br />

Parameters<br />

The following types of parameters are used in syntax diagrams:<br />

Required Required parameters are shown on the main path.<br />

Optional Optional parameters are shown below the main path.<br />

Default Default parameters are shown above the main path. In parameter<br />

descriptions, default parameters are underlined.<br />

Syntax diagrams do not rely on highlighting, brackets, or braces. In syntax<br />

diagrams, the position of the elements relative to the main syntax line indicates<br />

whether an element is required, optional, or the default value.<br />

Parameters are classified as keywords or variables. Keywords are shown in<br />

uppercase letters. Variables, which represent names or values that you supply, are<br />

shown in lowercase letters and are either italicized or, in <strong>NetView</strong> help and<br />

BookManager publications, displayed in a differentiating color.<br />

In the following example, the USER command is a keyword, the user_id parameter<br />

is a required variable, and the password parameter is an optional variable.<br />

►► USER user_id<br />

password<br />

Punctuation and parentheses<br />

You must include all punctuation that is shown in the syntax diagram, such as<br />

colons, semicolons, commas, minus signs, and both single and double quotation<br />

marks.<br />

When an operand can have more than one value, the values are typically enclosed<br />

in parentheses and separated by commas. For a single value, the parentheses<br />

typically can be omitted. For more in<strong>for</strong>mation, see “Multiple operands or values”<br />

on page xviii.<br />

If a command requires positional commas to separate keywords and variables, the<br />

commas are shown be<strong>for</strong>e the keywords or variables.<br />

When examples of commands are shown, commas are also used to indicate the<br />

absence of a positional operand. For example, the second comma indicates that an<br />

optional operand is not being used:<br />

COMMAND_NAME opt_variable_1,,opt_variable_3<br />

►◄

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!