A fully qualified file name is the file name defined by the user combined with the catalog ID and the user ID. A fully qualified file name may be split into partial names with the aid of periods.
Format
Fully qualified file name = name1[.name2[. ...]][()]{ absgen / version }
The total length is dependent on the type of file:
for permanent files max. 41 characters
for temporary files max. 31 characters
for file generation groups max. 34 characters
for file generations max. length of the name for a file generation group (see above) +7 characters for the absolute generation number
name1
Partial name 1 (see "Rules for the formation of file names")
name2
Partial name 2 (see "Rules for the formation of file names")
absgen
Absolute generation number;
valid range: 1 <= absgen <= 9999;
the generationnumber identifies a file generation within a file generation group. File generations may also be referenced via relative generation numbers, but these are not included in the catalog entry (see section "Generation numbers").
The absolute generation number must always be specified preceded by an asterisk and enclosed in parentheses ( (*absgen) ).
version
Version ID for tape files; a simple name consisting of one or more characters(letters, digits or special characters).
Generally, cataloged tape files must have unique file names. The freely selectable version ID permits the user to catalog different files which would otherwise have identical file or path names.
The version ID is entered in the file catalog, but not in the file labels. It is thus merely an aid which uniquely identifies the catalog entry and permits implicit association of a file and a volume.
The version must always be enclosed in parentheses ((version)). DMS recognizes the version ID by the opening parenthesis “(“ and the following character, which must not be a plus, minus or asterisk sign (+ or - or * in parenthesis identifies a file generation). DMS ignores all following characters when it writes the file name into the tape labels. When tape labels are read, the file names are compared only up to the opening parenthesis, and all following characters are ignored.
Rules for the formation of file names
The user may use the following characters:
all letters (A ... Z)
all digits (0 ... 9)
the special characters #, @, $, the hyphen (-) and the period (.).
A fully qualified file name must contain at least one letter; this may be anywhere within the character string.
The period divides a fully qualified file name into partial names (see “name1.name2”, above). It cannot, therefore, be the first or last character of a partial name.
The hyphen must not be the first or last character of a partial name.
The $ character is used to identify the user ID and must therefore not be used as the first character of a file name.
The characters “@” and “#” are used as the prefix for identifying temporary files. They should not, therefore, be used as the first character of a file name, even if the TEMPFILE function (i.e. temporary files are permitted) is not active in the system.
When assigning file names and group names, it is advisable to restrict their length to the maximum value of four positions for the catalog ID and eight positions for the user ID. This will ensure that the file set can be transferred to another pubset or another user ID without problems (e.g. when the user switches from pubset “A” to pubset “AB01”).
Example
/show-file-attributes # ——————————————————————————————————————————————— (1)
3 :2OSG:$USERXYZ.S.152.500H.PROTOKOLL
3 :2OSG:$USERXYZ.S.152.500H.VOLL.QUALIF.TEMPFILE.NAME
:2OSG: PUBLIC: 2 FILES RES= 6 FRE= 6 REL= 6 PAGES
/show-file-attributes generations=yes ———————————————————————————————— (2)
0 :G:$USERXYZ.ABCDEFGHIJKLMNOPQRSTUVWXYZ.1234567890 —————————— (3)
3 :G:$USERXYZ.ABDEF.134.$-@#
3 :G:$USERXYZ.DATEINAME
0 :G:$USERXYZ.DAT.GENGROUP (FGG) ————————————————————————————— (4)
0 :G:$USERXYZ.DAT.GENGROUP(*0001)
0 :G:$USERXYZ.DAT.GENGROUP(*0002)
3 :G:$USERXYZ.DO.CMH.ASS ————————————————————————————————————— (5)
12 :G:$USERXYZ.DVS.TAB2-2
30 :G:$USERXYZ.PROTO.DATEINAMEN
3 :G:$USERXYZ.VOLL.QUALIF.DATEI.NAME
3 :G:$USERXYZ.1234567890X0987654321
:2OSG: PUBLIC: 11 FILES RES= 57 FRE= 47 REL= 36 PAGES
(1) | The SHOW-FILE-ATTRIBUTES command lists the temporary user files (prefix: #) created by the current task (TSN=500H) on the default pubset (2OSG) under the calling user ID ($USERXYZ). |
(2) | The SHOW-FILE-ATTRIBUTES command lists the permanent files, file generation groups and file generations cataloged on the default pubset (2OSG) under the calling user ID ($USERXYZ). |
(3) | 3 examples of the permissible character set for the formation of file names. |
(4) | Example of a file generation group with 2 file generations. |
(5) | 5 examples of the permissible character set for the formation of file names. |