This statement is used by HSMS administrators only. It serves to correct inconsistencies in the catalog entries of migrated files. This HSMS statement checks the validity of the reference to the save file in the catalog entry of each migrated file. If a reference in a catalog entry is found to be invalid, HSMS replaces it with a new reference to a valid save file.
The following files on the specified S0 pubset are selected for processing:
files for which the catalog entry contains no localization information
files whose localization information references a save file which no longer exists
The save file that is referenced is taken either from the SF or the SM pubset environment – depending on the specified pubset catalog to be repaired.
For each selected file, a reference to the last save file is entered in the catalog entry. This save file contains the file with the same name (CFID). If there is no longer a save file of this kind, the system outputs a message for the corresponding file. Optionally these files can be deleted when processing has been completed (ERASE-INVALID-CE operand).
Format (only for HSMS administrators)
REPAIR-CATALOG-BY-EXCHANGE | Alias: RCE | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
S0-PUBSET-ID = <cat-id>
Specifies the S0 pubset to which the statement refers.
OPERATION-CONTROL =
Enables the user to define certain parameters which are relevant to the execution of the repair run.
OPERATION-CONTROL = *STD
The default values of the operands described below apply.
OPERATION-CONTROL = *PARAMETERS(...)
The operands controlling the repair run can be modified as follows:
PERFORMANCE-ANALYSIS =
Specifies whether a statistics file is to be produced for each ARCHIVE subtask.
PERFORMANCE-ANALYSIS = *NO
No statistics file is to be produced.
PERFORMANCE-ANALYSIS = *YES(...)
A statistics file is to be produced for each ARCHIVE subtask.
SEPARATOR = ; / <c-string 1..1>
Character that is inserted between the different fields in the statistics files. This enables programs such as EXCEL or LOTUS to differentiate the different fields.The default value is “ ; ”. This corresponds to the EXCEL default setting.
REPORT =
Serves to define whether a report is to be output for this repair request and to determine the scope of this report.
REPORT = *SUMMARY
A summary of the results of the repair run, including any error messages, is to be output.
REPORT = *FULL
A full report is to be output, including a list of all repaired files.
REPORT = *NONE
No report is to be output.
OUTPUT =
Specifies where the report is to be output.
OUTPUT = *STD
The output destination of the report is determined by the default value that is defined by the global HSMS parameter OUTPUT.
OUTPUT = *PRINTER
The report on this repair request is to be printed.
OUTPUT = *MAIL
The report for this repair request is sent as an email attachment to the address which is entered in the caller’s user entry. If it is not possible to send the report by email, it is printed out.
OUTPUT = *LIBRARY-ELEMENT(...)
The report for this repair request is edited and output to the specified PLAM library element (type P). If this is not possible, the report is printed out.
LIBRARY = <filename 1..54 without-gen-vers>
Name of the PLAM library.
ELEMENT = <composed-name 1..64 with-under>
Name of the element. A type P element is created with a version which contains the user ID plus the date and time.
OUTPUT = <filename 1..54 without-gen-vers>
The report for this repair run is to be edited and written to the specified file.If the file already exists, the following applies:
if it is a non-empty SAM file, it is continued
if not, the report is printed.
ERASE-INVALID-CE =
Specifies whether the files with identifying information which is still invalid should be deleted when they have been processed.
ERASE-INVALID-CE = *NO
No files are deleted.
ERASE-INVALID-CE = *YES
The files with identifying information which is still invalid are deleted.