The CHECK-FILENAME-LENGTH statement checks the length of all file, file generation group and job variable names in the catalog of the pubset. The names must not exceed a specified maximum length (see below).
This function is useful only when performing renaming where the length of the catalog ID is increased. The statement is not executed unless the specified pubset has been set to “inaccessible” by means of /EXPORT-PUBSET.
If required, the length should always be checked prior to renaming. If the program detects names whose lengths exceed the specified maximum during the check, these are logged and PVSREN moves to the next STEP statement. The file or job variable names affected must be modified to the maximum permissible length using /MODIFY-FILE-ATTRIBUTES or /MODIFY-JV-ATTRIBUTES.
The program also checks whether the system ID in the SVL of the SF Pubres is initialized. If not, an appropriate message is output.
Since SM pubsets and volume sets cannot be used as home pubsets, the system ID has no meaning and is not checked.
Since the volume set ID is not incorporated in the file name, the CHECK-FILENAME-LENGTH statement is rejected for volume sets.
Maximum length of file and job variable names
The maximum length for a path name (with catalog and user ID) is 54 characters for file and job variables and 47 characters for file generation groups.
Structure of the path name:
:catid:$userid.<filename / fgg-name / jv-name>
The maximum length of the actual name (file, file generation group or job variable name) is 41 or 34 characters. This maximum length may be reduced if both the length of the catalogue ID and the length of the user ID are high. If the following calculation results in a value less than 41 or 34, this reduced value applies:
max. path name length (54 or 47)
number of delimiters (always 4 (::$.))
length of the catalog ID (1..4)
length of the user ID (1..8)
Format
CHECK-FILENAME-LENGTH |
CATID = <catid 1..4> ,NEW-CATID = <catid 1...4> |
Operands
CATID = <catid 1..4>
The current catalog ID.
NEW-CATID = <catid 1..4>
The required catalog ID.
Example
(IN) /CHECK-FILENAME-LENGTH CATID=A,NEW-CATID=ABC 1. (OUT) %PVR0134 The following object names exceed the maximum length 2. (NL) :<catid>:<userid>.<jv-name> (JV) 3. (NL) *:<catid>:<userid>.<filename> (FGG) 4. (NL) :<catid>:<userid>.<filename> (FGG) 5. (NL) *:<catid>:<userid>.<filename> 6. (NL) :<catid>:<userid>.<filename> 7.
The new catalog ID has 3 characters; this means that (with an 8-character user ID) the maximum length for file and job variable names is 39 characters, and 32 characters for file generation groups.
This message is output if names whose lengths exceed the maximum length are detected.
The output name represents ... a job variable.
... a private file generation group. (* = private)
... a public file generation group.
... a private file. (* = private)
... a public file.