Suffixes for data types

Suffix

Meaning

x..y unit

With data type “integer”: interval specification

x	minimum value permitted for “integer”. x is an (optionally signed) integer.
y	maximum value permitted for “integer”. y is an (optionally signed) integer.
unit	additional units. The following units may be specified:
	days hours minutes seconds milliseconds	byte 2Kbyte 4Kbyte Mbyte

x..y special

With the other data types: length specification
For data types catid, date, device, product-version, time and vsn the length
specification is not displayed.

x	minimum length for the operand value; x is an integer.
y	maximum length for the operand value; y is an integer.
x=y	the length of the operand value must be precisely x.
special	Specification of a suffix for describing a special data type that is checked by the implementation. “special” can be preceded by other suffixes. The following specifications are used:
	arithm-expr bool-expr string-expr expr cond-expr symbol	arithmetic expression (SDF-P) logical expression (SDF-P) string expression (SDF-P) freely selectable expression (SDF-P) conditional expression (JV) CSECT or entry name (BLS)

with

Extends the specification options for a data type.

-compl

When specifying the data type “date”, SDF expands two-digit year specifications
in the form yy-mm-dd to:

20yy-mm-dd 19yy-mm-dd

if yy < 60 if yy >= 60

-low

Uppercase and lowercase letters are differentiated.

-pathcompl

For specifications for the data type “filename”, SDF adds the catalog and/or user ID if these have not been specified.

-under

Permits underscores (_) for the data types “name” and “composed-name”.

-wild(n)

Parts of names may be replaced by the following wildcards.
n denotes the maximum input length when using wildcards.
Due to the introduction of the data types posix-filename and posixpathname, SDF now accepts wildcards from the UNIX world (referred to below as POSIX wildcards) in addition to the usual BS2000 wildcards.
However, as not all commands support POSIX wildcards, their use for data types other than posix-filename and posix-pathname can lead to semantic errors.
Only POSIX wildcards or only BS2000 wildcards should be used within a search pattern. Only POSIX wildcards are allowed for the data types posixfilename and posix-pathname. If a pattern can be matched more than once in a string, the first match is used.

BS2000 wildcards

Meaning

*

Replaces an arbitrary (even empty) character string. If the
string concerned starts with *, then the * must be entered twice
in succession if it is followed by other characters and if the
character string entered does not contain at least one other
wildcard.

Terminating period

Partially-qualified entry of a name.
Corresponds implicitly to the string “./*”, i.e. at least one other
character follows the period.

/

Replaces any single character.

<s_x:s_y>

Replaces a string that meets the following conditions:

• It is at least as long as the shortest string (s_x or s_y)

• It is not longer than the longest string (s_x or s_y)

• It lies between s_x and s_y in the alphabetic collating
  sequence; numbers are sorted after letters (A...Z, 0...9)

• s_x can also be an empty string (which is in the first position
  in the alphabetic collating sequence)

• s_y can also be an empty string, which in this position stands
  for the string with the highest possible code (contains only
  the characters X’FF’ )

<s₁,...>

Replaces all strings that match any of the character combinations specified by s. s may also be an empty string. Any such string may also be a range specification “s_x:s_y” (see above).

-s

Replaces all strings that do not match the specified string s.
The minus sign may only appear at the beginning of string s.
Within the data types filename or partial-filename the negated string -s can be used exactly once, i.e. -s can replace one of the three name components: cat, user or file.

Wildcards are not permitted in generation and version specifications for file names. Only system administration may use wildcards in user IDs.
Wildcards cannot be used to replace the delimiters in name components cat (colon) and user ($ and period).

POSIX wildcards

Meaning

*

Replaces any single string (including an empty string). An *
appearing at the first position must be duplicated if it is followed
by other characters and if the entered string does not include
at least one further wildcard.

?

Replaces any single character; not permitted as the first character outside single quotes.

[c_x-c_y]

Replaces any single character from the range defined by c_x and c_y, including the limits of the range. c_x and c_y must be normal characters.

[s]

Replaces exactly one character from string s.
The expressions [c_x-c_y] and [s] can be combined into
[s₁c₁c_x-c_ys_ys₂].

[!c_x-c_y]

Replaces exactly one character not in the range defined by c_x
and c_y, including the limits of the range. c_x and c_y must be
normal characters. The expressions [!c_x-c_y] and [!s] can be
combined into [!s₁c_x-c_ys_ys₂].

[!s]

Replaces exactly one character not contained in string s. The
expressions [!s] and [!c_x-c_y] can be combined into [!s₁c₁c_x-c_ys_ys₂].

wildconstr(
n)

Specification of a constructor (string) that defines how new names are to be constructed from a previously specified selector (i.e. a selection string with wildcards). See also with-wild. n denotes the maximum input length when using wildcards.
The constructor may consist of constant strings and patterns. A pattern (character) is replaced by the string that was selected by the corresponding pattern in the selector.
The following wildcards may be used in constructors:

Wildcard

Meaning

*

Corresponds to the string selected by the wildcard * in the selector.

Terminating
period

Corresponds to the partially-qualified specification of a name in the selector;
corresponds to the string selected by the terminating period in the selector.

/ or ?

Corresponds to the character selected by the / or ? wildcard in the selector.

<n>

Corresponds to the string selected by the n-th wildcard in the selector, where n is an integer.

Allocation of wildcards to corresponding wildcards in the selector:
All wildcards in the selector are numbered from left to right in ascending order (global index).
Identical wildcards in the selector are additionally numbered from left to right in ascending order (wildcard-specific index).
Wildcards can be specified in the constructor by one of two mutually exclusive methods:
1. Wildcards can be specified via the global index: <n>
2. The same wildcard may be specified as in the selector; substitution occurs on the basis of the wildcard-specific index. For example: the second “/” corresponds to the string selected by the second “/” in the selector

The following rules must be observed when specifying a constructor:

• The constructor can only contain wildcards of the selector.

• If the string selected by the wildcard <...> or [...] is to be used in the constructor, the index notation must be selected.

• The index notation must be selected if the string identified by a wildcard in the selector is to be used more than once in the constructor. For example: if the selector “A/” is specified, the constructor “A<n><n>” must be specified instead of “A//”.

• The wildcard * can also be an empty string. Note that if multiple asterisks appear in sequence (even with further wildcards), only the last asterisk can be a non-empty string, e.g. for “****” or “*//*”.

• Valid names must be produced by the constructor. This must be taken into account when specifying both the constructor and the selector. Depending on the constructor, identical names may be constructed from different names selected by the selector. For example: “A/*” selects the names “A1” and “A2”; the constructor “B*” generates the same new name “B” in both cases. To prevent this from occurring, all wildcards of the selector should be used at least once in the constructor.

• If the constructor ends with a period, the selector must also end with a period. The string selected by the period at the end of the selector cannot be specified by the global index in the constructor specification.

Examples:

Selector	Selection	Constructor	New name
A//*	AB1 AB2 A.B.C	D<3><2>	D1 D2 D.CB
C.<A:C>/<D,F>	C.AAD C.ABD C.BAF C.BBF	G.<1>.<3>.XY<2>	G.A.D.XYA G.A.D.XYB G.B.F.XYA G.B.F.XYB
C.<A:C>/<D,F>	C.AAD C.ABD C.BAF C.BBF	G.<1>.<2>.XY<2>	G.A.A.XYA G.A.B.XYB G.B.A.XYA G.B.B.XYB
A//B	ACDB ACEB AC.B A.CB	G/XY/	GCXYD GCXYE GCXY. 1 G.XYC

¹The period at the end of the name may violate naming conventions (e.g. for fully-qualified file names).

without

Restricts the specification options for a data type.

-cat

Specification of a catalog ID is not permitted.

-corr

Input format: [[C]’][V][m]m.na[’]
Specifications for the data type product-version must not include the correction status.

-gen

Specification of a file generation or file generation group is not permitted.

-man

Input format: [[C]’][V][m]m.n[’]
Specifications for the data type product-version must not include either release or correction status.

-odd

The data type x-text permits only an even number of characters.

-sep

With the data type “text”, specification of the following separators is not permitted: ; = ( ) < > 'BLANK' (i.e. semicolon, equals sign, left and right parentheses, greater than, less than, and blank).

-tempfile

Specification of a temporary file is not permitted (see #file or @file under filename).

-user

Specification of a user ID is not permitted.

-vers

Specification of the version (see “file(no)”) is not permitted for tape files.

-wild

The file types posix-filename and posix-pathname must not contain a pattern (character).

mandatory

Certain specifications are necessary for a data type.

-corr

Input format: [[C]’][V][m]m.naso[’]
Specifications for the data type product-version must include the correction status and therefore also the release status.

-man

Input format: [[C]’][V][m]m.na[so][’]
Specifications for the data type product-version must include the release status. Specification of the correction status is optional if this is not prohibited by the use of the suffix without-corr.

-quotes

Specifications for the data types posix-filename and posix-pathname must be enclosed in single quotes.