Conventions

This document covers the following topics:


Syntax Conventions

The following table describes the conventions used in syntax diagrams of ADARUN parameters and operator commands.

Convention Description Example
uppercase, bold Syntax elements appearing in uppercase and bold font are Adabas keywords. When specified, these keywords must be entered exactly as shown.

graphics/util_syntax_keyword.png

The syntax elements ADADBS, CHANGE, and FILE are Adabas keywords.

lowercase, italic, normal font Syntax elements appearing in lowercase and normal, italic font identify items that you must supply.

graphics/util_syntax_keyword.png

The syntax element file-number identifies and describes the kind of value you must supply. In this instance, you must supply the number of the file affected by the ADADBS CHANGE operation.

mixed case, normal font Syntax elements appearing in mixed case and normal font (not bold or italic) identify items established by other Adabas control statements. This notation is usually used to identify how default values are determined for some parameters in Adabas syntax.

graphics/util_syntax_extdefault.png

The syntax element "ADARUN-device" indicates that the device type identified by the ADARUN DEVICE parameter will be used if a different device type is not specified. The literal "ADARUN-device" should not be specified for the SORTDEV parameter.

underlining

Underlining is used for two purposes:

  1. To identify default values, wherever appropriate. Otherwise, the defaults are explained in the accompanying parameter descriptions.

  2. To identify the short form of a keyword.

graphics/util_syntax_default.png

In the example above, 4000 is the default that will be used for the LRECL parameter if no other record buffer length is specified.

graphics/util_syntax_minform.png

In the example above, the short version of the DEVICE parameter is DE.

vertical bars (|) Vertical bars are used to separate mutually exclusive choices.

Note:
In more complex syntax involving the use of large brackets or braces, mutually exclusive choices are stacked instead.

graphics/util_syntax_choices.png

In the example above, you must select RESTRUCTUREF or REF for this ADAORD function. There are no defaults.

brackets ([ ]) Brackets are used to identify optional elements. When multiple elements are stacked or separated by vertical bars within brackets, only one of the elements may be supplied.

graphics/util_syntax_optparm.png

In this example, the SORTSEQ parameter and the MU, NU, and STARTISN subparameters are optional.

Note:
Note that the mutually exclusive choices for the SORTSEQ parameter are stacked.

braces ({ }) Braces are used to identify required elements. When multiple elements are stacked or separated by vertical bars within braces, one and only one of the elements must be supplied.

graphics/util_syntax_reqparm.png

In this example, either the SUSPEND or RESUME parameter is required.

indentation Indentation is used to identify subparameters of a parameter.

graphics/util_syntax_reqparm.png

In this example, TTSYN and TRESUME are subparameters of the SUSPEND parameter.

ellipsis (...) Ellipses are used to identify elements that can be repeated. If the term preceding the ellipsis is an expression enclosed in square brackets or braces, the ellipsis applies to the entire bracketed expression.

graphics/util_syntax_ellipsis.png

In this example, the FIELD parameter can be repeated. In addition, more than one option can be associated with a field.

other punctuation and symbols All other punctuation and symbols must be entered exactly as shown.

graphics/util_syntax_ellipsis.png

In this example, the single quotation marks must be specified around the field definitions and their associated options. In addition, options must be separated by commas.

Data Set Names

Data set names starting with DD are referred to in Adabas manuals with a slash separating the DD from the remainder of the data set name to accommodate z/VSE data set names that do not contain the DD prefix. The slash is not part of the data set name.

Notation vrs, vr, or v: When used in this documentation, the notation vrs or vr stands for the relevant version of a product. For further information on product versions, see version in the Glossary.