This statement enables you to reorganize directory and repository files. Prior to a reorganization, obsolete save versions/files should be removed (ARCHIVE: PURGE resp. HSMS: MODIFY-ARCHIVE SAVE-FILE=*DELETE). A reorganization for example could be necessary after output of the message ARC0176 during a save run.
This statement can be used to convert a repository file in the old format (earlier than HSMS V7.0) to the new format (HSMS V7.0 or higher). The new format offers significantly better performance for backup operation with long path names of node files.
REORGANIZE-DIRECTORY |
DIRECTORY-NAME = <filename 1..54> ,NEW-DIRECTORY-NAME = <filename 1..54> |
DIRECTORY-NAMES = <filename 1..54>
Fully qualified path name of of the directory or repository file which is to be reorganized.
NEW-DIRECTORY-NAME = <filename 1..54>
Fully qualified path name of the new directory or repository file. The name must be different from the one specified in the DIRECTORY-NAME operand.
The directory specified should not already exist or should at least be empty.
After a directory file has been successfully reorganized, the following message is issued:
THE DIRECTORY HAS BEEN REORGANIZED
If it was not possible to perform reorganization, e.g. because the directory file had already been reorganized or no empty data records were available, the following message is issued:
THE DIRECTORY IS ALREADY REORGANIZED
No messages are issued when repository files are reorganized.
Example.
Reorganize directory (e.g. after ARC0176):
/START-DIRCONV <----------------------------------------------<-+
| |
| ^
V |
---------------------------------- |
|REORGANIZE-DIRECTORY | |
|DIRECTORY-NAME = original-filename| |
|NEW-DIRECTORY-NAME = new-filename | |
---------------------------------- |
Successfully executed? ------------- NO ----- > follow instructions |
| of the error message |
| |
| |
Yes |
| |
| ^
V |
Directory reorganized?------------ NO ------> Purge some obsolete -->-+
| save versions
| and try again to
| reorganize the directory
Yes
|
|
V
rename the new directory to the original name:
/DELETE-FILE FILE-NAME = original-filename
/MODIFY-FILE-ATTRIBUTES FILE-NAME = new-filename, NEW-NAME = original-filename