This statement is used by HSMS administrators only. It sets the reference in migrated files to a valid save file in the migration archive.
Files are selected whose data is located in the specified save file and migration archive.
The catalog entries of the selected files are updated, i.e. set to the latest version of a different save file which also contains the data. If no such file exists, the system displays a message to this effect.
Format (only for HSMS administrators)
REPLACE-SAVE-FILE-BY-EXCHANGE | Alias: RFE | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ENVIRONMENT =
Defines the HSMS environment where the specified archive is located.
ENVIRONMENT = *SINGLE-FEATURE
The archive entered is defined in the SF environment.
ENVIRONMENT = *SYSTEM-MANAGED(...)
The specified archive is defined in an SM pubset environment.
CATALOG-ID = <cat-id>
Catalog ID of the SM pubset to which the HSMS statement applies.
SAVE-FILE-ID = <composed-name 15...15>
Name of the save file identified by the references in the catalog entries of migrated files that are to be replaced by references to a different save file.
ARCHIVE-NAME = <filename 1..22 without-cat-gen-vers>
Specifies the migration archive which is to be used for the substitution.
OPERATION-CONTROL =
Enables the user to define certain parameters which are relevant to the execution of the archival run.
OPERATION-CONTROL = *STD
The default values of the operands described below apply.
OPERATION-CONTROL = *PARAMETERS(...)
The operands controlling the archival 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 and to determine the scope of this report.
REPORT = *SUMMARY
A summary of the result, including any error messages, is to be output.
REPORT = *FULL
A full report is to be output, including a list of all archived 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 is to be printed.
OUTPUT = *MAIL
The report 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 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 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.