Explanation of the columns

The columns of the S variable tables are:

Output information	Name of the S variable	T	Contents	Condition

Column: Output information

This column provides notes on the contents of the S variable. If the contents and name of the S variable are self-explanatory, the notes are often restricted to one or two key terms. If the relationship between the contents and name of the S variable is not sufficiently obvious, more information is given about the contents of the S variable. If the possible contents of an S variable are *YES or *NO, the explanation may be formulated as a question, which can be answered with Yes or No.

Column: Name of the S variable

This column contains the alphabetically arranged names of the S variables. The order within the S variable table is governed by this column.

The names of the S variables consist of at least two subnames. In this manual the first subname is consistently given as var(*LIST); the actual name can be freely selected by the user within the terms of the SDF-P naming conventions. This S variable must always be declared as a list variable.

The full name of the S variable is composed of var(*LIST) and the command-specific preset S variable name. These names match the corresponding operand names or unique abbreviations as closely as possible. The subnames are separated by a dot. The preset S variable name may in turn comprise several subnames, similarly separated by dots. If the structure elements on this level form a list, the subname is also given the extension (*LIST).

The extension (*LIST) indicates that the S variable is an element in a list. (*LIST) appears when the contents of the S variable are displayed with the SHOW-VARIABLE command. For assignments, the user must replace (*LIST) by a particular list index. On request, the command SHOW-VARIABLE shows the value instead of (*LIST) in its output.

Example:

/SHOW-VARIABLE OPS
OPS(*LIST).F-NAME = :2OSH:$TSOS.X.OUT
OPS(*LIST).CAT-ID = 2OSH
OPS(*LIST).USER-ID = TSOS
OPS(*LIST).SHORT-F-NAME = X.OUT
OPS(*LIST).F-SIZE = 3

/SHOW-VARIABLE OPS, INF = *PAR(NAME = *FULL-NAME(LIST-INDEX-NUMBER = *YES))
OPS#1.F-NAME = :2OSH:$TSOS.X.OUT
OPS#1.CAT-ID = 2OSH
OPS#1.USER-ID = TSOS
OPS#1.SHORT-F-NAME = X.OUT
OPS#1.F-SIZE = 3

Column: T

The possible values are:This column indicates the data type of the S variable. 

S:	String
I:	Integer
B:	Boolean

The data type specifies the character set from which the contents of an S variable come (see the table in section “ Notes on conventions used in the tables”).

Column: Contents

This column lists the contents of the S variable. These contents match the corresponding operand values or unique abbreviations as closely as possible. The notational conventions are partly based on the customary SDF data type notation (e.g. <filename 1..54>, see table “Data types " (SDF syntax representation)) and partly make use of names descriptive of the contents of the S variables (such as <tsn>). For further conventions refer to the table in section “ Notes on conventions used in the tables", “Notes” column.

Column: Condition

With some commands there is an operand (usually INFORMATION) which identifies the S variables which are to be assigned values on output. These operand conditions are either noted directly in this column or are referenced there by means of a code number and/or letter. The association between this code and the corresponding operand value is explained above the S variable table.