This section defines special formats for strings which are used in EDT statements to designate external objects such as files or library elements.
Strings without a defined delimiter (e.g. apostrophe) are first extracted during the syntax analysis without taking account of the associated semantic constraints.
In this case, all the characters from the first character that is not a blank up to an internally defined delimiter or the end of the statement are used (unless otherwise described for the operand type).
EDT normally uses the blank, comma, equals sign and parentheses as a delimiter. Only when the operand has been extracted is it checked for length, characters used and permitted syntax.
Operand | Definition |
entry | chars | .svar |
Name of an entry point (ENTRY) or a CSECT section. This specification is case-sensitive. The name must not be longer than 32 characters and must comply with the BLS constraints for symbol names.
Operand | Definition |
freetype | name |
Free type name of a library element, specified as a string of 2 to 8 characters in length which may not begin with $ or SYS.
Operand | Definition |
eltype | S | M | R | C | P | J | D | X | H | L | U | F | *STD | freetype | .svar |
Type of a library element.
Free type names can also be used to specify an element type. No check of the basic type is performed. In some statements, only text types are permitted.
Operand | Definition |
elname | chars | .svar |
Name of a library element which corresponds to the SDF data type <composed-name 1..64 with-under>.
Operand | Definition |
progname | chars |
Name of a program whose statements are to be subjected to a syntax check by EDT. The name must correspond to the SDF data type <structured-name 1..30>.
Operand | Definition |
file | str |
File name which can be specified by means of a printable, hexadecimal or binary representation.
The file name may consist of a maximum of 54 characters without wildcards or 80 characters with wildcards. The DMS constraints for file names must be taken into account. The specification of wildcards is not permitted in all statements. These are the wildcards accepted in DMS, not the wildcards patterns declared in EDT.
Whether or not partial file name specifications are permitted again depends on the relevant statement and is set out in the corresponding description.
In some statements, it is also possible to specify '/' to indicate the use of a given link name. This is explained in the descriptions of the corresponding statements.
Operand | Definition |
linkname | chars |
Specifies a file or job variable via its link name.
The name must correspond to the SDF data type <filename 1..8 without-gen>.
Operand | Definition |
path | chars | .svar |
Path name of a file or a job variable which can be specified either directly or via a string variable.
The path name may consist of a maximum of 54 characters without wildcards or 80 characters with wildcards. The DMS constraints for file names must be taken into account. The specification of wildcards is not permitted in all statements.
These are the wildcards accepted in DMS, not the wildcards patterns declared in EDT. Whether or not partial file name specifications are permitted again depends on the relevant statement and is set out in the corresponding description.
Operand | Definition |
modlib | path |
Library containing a module that is to be loaded by EDT.
The name must correspond to the SDF data type <filename 1..54 without-vers>.
Operand | Definition |
ver | * | int |
Version number of a cataloged file.
This can be specified either as * or int where int stands for a number between 0 and 255. For information on using version numbers when reading and writing files, see section “Version numbers”.
Operand | Definition |
vers | chars | *STD |
Version designation of a library element.
The designation must correspond to the SDF data type <composed-name 1..24 with-under>.
Operand | Definition |
xpath | chars | .svar |
String which specifies the name of a POSIX file.
The specification of the complete path name is permitted. If no complete path name is specified then the file is located in the current POSIX directory.
Blanks and commas in a name are only permitted if the name is specified in svar.
The path name must correspond to the SDF data type <posix-pathname 1..1023>.