The DIRCONV statement UPDATE-VOLUME-CATALOG (see "UPDATE-VOLUME-CATALOG Updating the volume catalog") can be used to eliminate inconsistencies between the MAREN catalog and an ARCHIVE directory file with regard to the directory name: all volumes that belong to a directory file receive the same directory name in their respective catalog entry.
For every volume listed in the directory file which was entered in the NEW-DIRECTORY-NAME operand, the following MAREN statement is issued in MARENADM
//MODIFY-VOLUME-ATTRIBUTES VOL=...,DIR-NAME=...
In addition, for each directory file entered in the DIRECTORY-NAMES operand by the MAREN administrator, the following MAREN statement is issued in MARENADM:
//MODIFY-VOLUME-ATTRIBUTES VOLUME=*ALL,SELECT=FREE(
ARCHIVE-USAGE=old_file_name,NEW-ARCHIVE-USAGE=new_file_name)
This assigns the pool of prereserved free volumes to the new directory name.
This function is useful for eliminating discrepancies which may, for example, have resulted from merging multiple directory files into a new directory file.
Notes
If the MAREN administrator has forgotten one or more old directory names, he/she must change the prereservation by entering the same MARENADM statement for the missing names.
Directory names for volumes that have been entered in the new directory file do not need to be updated if the old directory names have been forgotten.