SDF notational conventions

The following tables describe the notational conventions used to represent SDF commands and statements of the C/C++ compiler and the global listing generator.

Table 1: Special characters

The special characters and notational conventions used in SDF statement formats are explained in the table below:

Format

Meaning

Examples

UPPERCASE

Uppercase letters indicate keywords
(names of commands, statements, and
operands, keyword values).
Some keywords start with *.

START-CPLUS-COMPILER

COMPILE

ELEMENT = *STD-ELEMENT

=

The equals sign connects an operand
name with the corresponding operand
values.

LISTING = *NONE

< >

Angle brackets indicate variables, the
values of which are defined by data
types and their suffixes
(see the following tables).

VERSION = <text 1..24>

Underline

Underlining indicates default values of
operands, i.e. values which are
automatically used when no explicit
specification is made.

SUMMARY = *YES / *NO

/

A slash separates alternative operand
values.

TEST-SUPPORT = *YES / *NO

(...)

Parentheses indicate operand values
which introduce a structure.

LIBRARY = *LINK(...)

[ ]

Square brackets indicate optional
operand values that introduce
structures. The structure that follows may be
specified without the introductory
operand value.

SOURCE = [*YES](...)

Indentation

Indentation indicates dependence on
the higher- ranking operand.

LIBRARY = <filename> / *LINK(...)
	*LINK(...)
		|	LINK-NAME =

|

Vertical lines denote associated
operands in a structure. The top and
bottom of the line indicate the
beginning and end of a structure.
Further structures may occur within a
structure. The number of vertical lines
before an operand corresponds to the
depth within the structure.

	*LIBRARY-ELEMENT(...)
		|	LIBRARY =
		|	,ELEMENT =
		|		|	VERSION =

,

A comma precedes further operands of
the same level within the structure.

,SOURCE = *NO

,SUMMARY = *NO

list-poss(n):
list-poss:

A list can be generated from the
operand values following list-poss. If
(n) is specified, the list may contain at
most n elements.
If the list contains more than one
element, it must be enclosed within
parentheses.
In this manual, (n) is indicated only if a
compiler-specific maximum number is
involved.
list-poss without (n) means that the
maximum SDF default value of 2000
applies.

list-poss (127): *STD / BY-SOURCE /

<c-string>

list-poss: <filenname> / *LINK(...)

 

Table 2: Data types

Variable operand values are indicated in SDF by data types. Each data type represents a specific value range. The number of data types is restricted to those described in the table below.

The following descriptions of data types apply to all statements. Consequently, only the operands which deviate from the definitions given here are explained in the individual operand descriptions.

Data type	Character set	Meaning
alphanum-name	A...Z 0...9 $, #, @
c-string	EBCDIC characters	A sequence of EBCDIC characters enclosed in single quotes. C may precede the characters. Single quotes within the c-string must be duplicated. The data type c-string is provided with the suffix with-low, which means that a distinction is made between uppercase and lowercase letters. Examples of valid representations: 'abc' , C'_abc' , 'ABC' , 'printf("macro-text\ n")'.
composed-name	A...Z 0...9 $,#,@ hyphen period	Name or version of a PLAM library element. composed-name is provided with the suffix with-under (underscore) (see also Table 3).
filename	A...Z 0...9 $,#,@ hyphen period	Link name or fully-qualified name of a cataloged file or a PLAM library. The maximum length for link names is 8 characters; the maximum length for fully-qualified names including the cat-id and user-id is 54 characters (or 41 characters excluding the cat-id and user-id).
		Input Format:
		linkname
		:cat:$user.{ datei / datei(nr) / gruppe / gruppe{ (*abs) / (+rel) / (-rel) } }
		linkname The first and last character must not be a hyphen or period; maximum of 8 characters; must contain at least A...Z.
filename (continuation)		:cat: Optional catalog identifier; character set restricted to A...Z and 0...9; maximum of 4 characters; must be enclosed in colons; the default value is the catalog identifier assigned to the user ID in accordance with the entry in the user catalog (also called the JOIN entry).
		$user. Optional user ID; character set is A...Z, 0...9, $, #, @; maximum of 8 characters; must not begin with a digit; $ and the period must be included; the default value is the own user ID.
		$. (special case) System default identifier.
		file File or job variable name; first and last character must not be a hyphen or period; maximum of 41 characters; must contain at least A...Z.
		#file @file (special case) # or @ as the first character indicates temporary files or job variables, depending on system generation.
		file(no) Tape file name no: version number; character set is A...Z, 0...9, $, #, @. Parentheses must be included.
filename (continuation)		group Name of a file generation group (see "file" for character set )
		group{ (*abs) / (+rel) / (-rel) }
		(*abs): Absolute generation number (1-9999); * and parentheses must be included..
		(+rel) / (-rel): Relative generation number (0-99); sign and parentheses are required.
integer	0...9,+,-	+ or - are possible only as the first character.
name	A...Z 0...9 $,#,@	C/C++ name for DEFINE / UNDEFINE in the MODIFY-SOURCE-PROPERTIES statement. The data type name is provided with the suffix underscore (see also Table 3). Lowercase letters cannot be represented with name; c-string must be used for this purpose. Maximum length: 125 characters
posix-filename	A...Z 0...9 special characters	String with a maximum length of 255 characters; consists of either one or two periods, or alphanumeric characters and special characters; all special characters must be escaped with a preceding \ (backslash); the / character is not allowed. A distinction is made between uppercase and lowercase letters
posix-pathname	A...Z 0...9 special characters structural identifiers: slashes	Input format: [/]part1[/.../partn] where part1 is a posix-filename; up to1023 characters; up to 247 characters for source and header files. The data type posix-pathname is provided with the suffix mandatory-quotes and must therefore always be enclosed within single quotes.
x-string	Hexadecimal: 00...FF	Sequence of hexadecimal values enclosed within single quotes; must be preceded by the letter X.

Table 3: Data type suffixes

Data type suffixes denote further input specifications for data types. These suffixes place restrictions on the value range or extend it. The following suffixes are used in their abbreviated form in the manual:

cat-id	cat
correction-state	corr
generation	gen
lower-case	low
manual-release	man
underscore	under
user-id	user
version	vers

The following descriptions of suffixes apply to all statements. Consequently, only the operands which deviate from the definitions given here are explained in the individual operand descriptions.

Suffix	Meaning
x..y	For data type integer: interval x: Minimum value permitted for integer. x is an integer which may be given a sign. y: Maximum value permitted for integer. y is an integer which may be given a sign. For other data types: length x: Minimum length for the operand value; x is an unsigned integer. y: Maximum length for the operand value; y is an unsigned integer.
with	Extends the options for specifying a data type.
-low	A distinction is made between uppercase and lowercase letters.
-under	The underscore ( _ ) is permitted as an additional character.
without	Restricts the options for specifying a data type.
-cat	Specifying a catalog identifier is not permitted..
-corr	Eingabeformat: [[C]' ][V][m]m.na[' ] No correction status may be included in the product-version data type.
-gen	Specifying a file generation or file generation group is not permitted.
-man	Input format: [[C]' ][V][m]m.n[' ] Neither the release status nor the correction status may be included in the product-version data type.
-user	Specifying a user identifier is not permitted.
-vers	Specifying a version (siehe file(no)) is not permitted for tape-files.
mandatory	Makes certain entries mandatory for a data type
-quotes	Specifications for the data types posix-filename and posix-pathname must be enclosed within single quotes.