This statement is used to update save files created by means of the HSMS statement EXPORT-FILES using data from a specified online data set.
The files in question must satisfy the same access rules as apply to the EXPORT-FILES statement. For foreign files read access is sufficient for nonprivileged users.
This statement has different formats for nonprivileged users and HSMS administrators. Privileged operands or operand values are marked with *P).
Format
UPDATE-EXPORT-SAVE-FILE | Alias: UES | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
*P) Privileged operand or operand value
DIRECTORY-NAME = <filename 1..54 without-gen-vers>
The directory specified is used in the export run. The nonprivileged caller must be owner or co-owner of this file.
SAVE-FILE-ID =
Save file which is to be copied.
If the save file is copied into an existing save file (see the "OUTPUT-SAVE-FILE=*CONTINUE(...)" operand), the save file ID may not be the same as the save file ID of the output file (the default value *LATEST may not be used for both save files).
SAVE-FILE-ID = *LATEST
The save file of the most recently created archive is to be copied.
SAVE-FILE-ID = <composed-name 15..15>
The specified save file is to be copied. The save file ID must be specified in the format S.yymmdd.hhmmss
SELECT-FILES =
Serves to specify the files to be copied from the save file.
Note
With a file which can be selected both by SELECT-FILES and ADD-FILES (in other words the file is both in the save file and on disk), the version on disk is copied.
SELECT-FILES = *ALL
All files are to be copied from the save file.
SELECT-FILES = *NONE
No files are copied from the save file.
SELECT-FILES = *SELECTED
The path names of the files to be copied are to be taken from a list that was compiled within the same HSMS run by means of the HSMS statement SELECT-FILE-NAMES.
SELECT-FILES = *FROM-FILE(...)
The path names of the files to be copied are to be taken from a file. The nonprivileged caller must be owner or co-owner of this file. This list file must be a SAM file with variable-length records containing one path name per record. The list file can be created, for instance, by means of the HSMS statement SELECT-FILE-NAMES or the BS2000 command SHOW-FILE-ATTRIBUTES.
LIST-FILE-NAME = <filename 1..54 without-gen-vers>
Path name of the list file.
SELECT-FILES = *FROM-LIBRARY-ELEMENT(...)
The path names of the files to be copied are taken from a PLAM library element (type S). The library element contains one path name per record. Only upper-case letters may be used.
LIBRARY = <filename 1..54 without-gen-vers>
Name of the PLAM library.
ELEMENT = <composed-name 1..64 with-under>
Name of the type-S element. The element with the highest existing version is used.
SELECT-FILES = list-poss(20): <filename 1..80 without-vers with-wild> / <partial-filename 2..79 with-wild>
The path names of the files to be copied are specified directly. A list of up to 20 names may be specified.
The file names may be specified as fully or partially qualified names, with or without a catalog/user ID. If required, the file name is extended by the user ID of the request and the default catalog ID of the user ID.
The files can alternatively be selected using wildcards. Note, however, that only the HSMS administrator may use wildcards for user ID specification.
The wildcards are replaced in accordance with the file names listed in the archive directory.
EXCEPT-FILES =
Serves to specify files that are to be excluded from copying. In migration archives, the selection can be further restricted by means of the MIGRATION-STATE operand.
EXCEPT-FILES = *NONE
All files from the save file specified in the SELECT-FILES operand are to be copied.
EXCEPT-FILES = *FROM-FILE(...)
The path names of the files to be excluded from copying are to be taken from a file. The nonprivileged caller must be owner or co-owner of this file. This list file must be a SAM file with variable-length records containing one path name per record. The list file can be created, for instance, by means of the BS2000 command SHOW-FILE-ATTRIBUTES.
LIST-FILE-NAME = <filename 1..54 without-gen-vers>
Path name of the list file.
EXCEPT-FILES = *FROM-LIBRARY-ELEMENT(...)
The path names of the files not to be copied are taken from a PLAM library element (type S). The library element contains one path name per record. Only upper-case letters may be used.
LIBRARY = <filename 1..54 without-gen-vers>
Name of the PLAM library.
ELEMENT = <composed-name 1..64 with-under>
Name of the type-S element. The element with the highest existing version is used.
EXCEPT-FILES = list-poss(20): <filename 1..80 without-vers-with-wild> / <partial-filename 2..79 with-wild>
The path names of the files to be excluded from copying are specified directly. A list of up to 20 names may be specified.
The first character of the file names must not be a hyphen. The file names may be specified as fully or partially qualified names, with or without a catalog/user ID. If required, the file name is extended by the user ID of the request and the default catalog ID.
The files can alternatively be selected using wildcards. Note, however, that only the HSMS administrator may use wildcards for user ID specification because only the HSMS administrator is allowed to specify other user IDs. Wildcards are replaced using the file names contained in the archive directory.
SELECT-JV =
Serves to specify the job variables to be copied from the save file. The selection made here applies to all save versions of the save file that are to be copied.
SELECT-JV = *NONE
No job variables are to be copied from the save file.
SELECT-JV = *ALL
All job variables are to be copied from the save file
SELECT-JV = *FROM-FILE(...)
The path names of the files to be copied are to be taken from a file. The nonprivileged caller must be owner or co-owner of this file. This list file must be a SAM file with variable-length records containing one path name per record.
LIST-FILE-NAME = <filename 1..54 without-gen-vers>
Path name of the list file.
SELECT-JV = *FROM-LIBRARY-ELEMENT(...)
The path names of the job variables to be copied are taken from a PLAM library element (type S). The library element contains one path name per record. Only upper-case letters may be used.
LIBRARY = <filename 1..54 without-gen-vers>
Name of the PLAM library.
ELEMENT = <composed-name 1..64 with-under>
Name of the type-S element. The element with the highest existing version is used.
SELECT-JV = list-poss(20): <filename 1..80 without-gen-vers-with-wild> / <partial-filename 2..79 with-wild>
The path names of the job variables to be copied are specified directly. A list of up to 20 names may be specified. The job variables can alternatively be selected using wildcards.
EXCEPT-JV =
Serves to specify job variables that are to be excluded from copying. The selection specified here applies to all save versions of the save file that is to be copied.
EXCEPT-JV = *NONE
All job variables specified in the SELECT-JV operand are to be copied.
EXCEPT-JV = *FROM-FILE(...)
The path names of the job variables to be excluded from copying are to be taken from a file. The nonprivileged caller must be owner or co-owner of this file. This list file must be a SAM file with variable-length records containing one path name per record.
LIST-FILE-NAME = <filename 1..54 without-gen-vers>
Path name of the list file.
EXCEPT-JV = *FROM-LIBRARY-ELEMENT(...)
The path names of the job variables not to be copied are taken from a PLAM library element (type S). The library element contains one path name per record. Only upper-case letters may be used.
LIBRARY = <filename 1..54 without-gen-vers>
Name of the PLAM library.
ELEMENT = <composed-name 1..64 with-under>
Name of the type-S element. The element with the highest existing version is used.
EXCEPT-JV = list-poss(20): <filename 1..80 without-gen-vers with-wild> / <partial-filename 2..79 with-wild>
The path names of the job variables to be excluded from copying are specified directly. A list of up to 20 names may be specified. The first character of the job variable names must not be a hyphen.
The job variables can alternatively be selected using wildcards.
ADD-FILES-AND-JV =
You can specify whether, in addition to the files and job variables which are copied from the save file using SELECT-FILES or SELECT-JV, further files and job variables should be exported from disk.
ADD-FILES-AND-JV = *NO
No files or job variables are exported in addition.
ADD-FILES-AND-JV = *YES (...)
Files and/or job variables are exported in addition.
ADD-FILE-NAMES =
The files to be exported are specified. The selection can be restricted via the operands EXCEPT-FILE-NAMES and SUPPORT.
Note
If a file can be selected with either SELECT-FILES or ADD-FILES (which means that the file is already on the input save file and still on the hard disk), the version on the hard disk is copied to the output save file.
ADD-FILE-NAMES = *OWN
All files of the user’s own ID residing on any imported pubset (except for shared SF pubsets for which the home computer is the slave) are exported.
ADD-FILE-NAMES = *ALL
All files residing on any imported pubset (except for shared SF pubsets for which the home computer is the slave) are exported.
ADD-FILE-NAMES = *NONE
No files are exported.
ADD-FILE-NAMES = *SELECTED
The path names of the files to be exported are to be taken from a list that was compiled within the same HSMS run by means of the HSMS statement SELECT-FILE-NAMES.
ADD-FILE-NAMES = *FROM-FILE(...)
The path names of the files to be exported are to be taken from a file. The nonprivileged caller must be owner or co-owner of this file. This list file must be a SAM file with variable-length records containing one path name per record. The list file can be created, for instance, by means of the HSMS statement SELECT-FILE-NAMES or the BS2000 command SHOW-FILE-ATTRIBUTES.
ADD-LIST-FILE-NAME = <filename 1..54 without-gen-vers>
Path name of the list file.
ADD-FILE-NAMES = list-poss(20): <filename 1..80 without-vers-with-wild> /
<partial-filename 2..79 with-wild>
The path names of the files to be exported are specified directly. A list of up to 20 names may be specified.
The file names may be specified as fully or partially qualified names, with or without a catalog/user ID. If required, the file name is extended by the user ID of the request and the default catalog ID of the user ID.
The files can alternatively be selected using wildcards. Note, however, that only the HSMS administrator may use wildcards for user ID specification. In the case of shared pubsets, the replacement of wildcards for catalog IDs does not refer to SF pubsets for which the home computer is the slave.
The following applies to file generations: when specifying fully qualified file names, the specification of a generation number (version) is permissible. Only the specified generations will be exported.
EXCEPT-FILE-NAMES =
Serves to specify files that are to be excluded from export.
EXCEPT-FILE-NAMES = *NONE
All files specified with the FILE-NAMES operand are to be exported.
EXCEPT-FILE-NAMES = *FROM-FILE(...)
The path names of the files to be excluded from export are to be taken from a file. The nonprivileged caller must be owner or co-owner of this file.This list file must be a SAM file with variable-length records containing one path name per record. The list file can be created, for instance, by means of the BS2000 command SHOW-FILE-ATTRIBUTES.
File names must be in uppercase only.
LIST-FILE-NAME = <filename 1..54 without-gen-vers>
Path name of the list file.
EXCEPT-FILE-NAMES = list-poss(20):
<filename 1..80 without-vers-with-wild> /<partial-filename 2..79 with-wild>
The path names of the files to be excluded from export are specified directly. A list of up to 20 names may be specified.
The first character of the file names must not be a hyphen. The file names may be specified as fully or partially qualified names, with or without a catalog/user ID. If required, the file name is extended by the user ID of the request and the default catalog ID.
The files can alternatively be selected using wildcards. Note, however, that only the HSMS administrator may use wildcards for user ID specification because only the
HSMS administrator is allowed to specify other user IDs. In the case of shared pubsets, the replacement of wildcards for catalog IDs does not refer to SF pubsets for which the home computer is the slave.
The following applies to file generations: when specifying fully qualified file names, the specification of a generation number (version) is permissible. Only the specified generations will be exported.
SUPPORT =
The files to be exported can be selected according to the volumes on which they reside.
SUPPORT = *ANY
The files are exported irrespective of the volume on which they reside.
SUPPORT = *PUBLIC-DISK
Restricts export to files residing on public volumes.
SUPPORT = *PRIVATE-DISK(...)
Restricts export to files which reside on private disks and which have been imported, i.e. recorded in the catalog of a pubset.
VOLUMES = *ALL
Files on all (imported) private disks are exported.
VOLUMES = list-poss(150): <vsn 1..6>
Volume serial numbers of private disks. All files having at least one extent to the specified disks are exported.
SUPPORT = *TAPE
Only the catalog entries of tape files are exported.
ADD-JV-NAMES =
Serves to specify the job variables to be exported.
ADD-JV-NAMES = *NONE
No job variables are exported.
ADD-JV-NAMES = *OWN
All job variables of the user’s own ID residing on any imported pubset (except for shared SF pubsets for which the home computer is the slave) are exported.
ADD-JV-NAMES = *ALL
All job variables residing on any imported pubset (except for shared SF pubsets for which the home computer is the slave) are exported.
ADD-JV-NAMES = *FROM-FILE(...)
The path names of the job variables to be exported are to be taken from a file. The nonprivileged caller must be owner or co-owner of this file. This list file must be a SAM file with variable-length records containing one path name per record.
ADD-LIST-FILE-NAME = <filename 1..54 without-gen-vers>
Path name of the list file.
ADD-JV-NAMES = list-poss(20): <filename 1..80 without-vers-with-wild> /
<partial-filename 2..79 with-wild>
The path names of the job variables to be exported are specified directly. A list of up to 20 names may be specified.
The job variables can alternatively be selected using wildcards. In the case of shared pubsets, the replacement of wildcards for catalog IDs does not refer to SF pubsets for which the home computer is the slave.
EXCEPT-JV-NAMES =
Serves to specify job variables that are to be excluded from export.
EXCEPT-JV-NAMES = *NONE
No job variable is to be excluded from export.
EXCEPT-JV-NAMES = *FROM-FILE(...)
The path names of the job variables to be excluded from export are to be taken from a file. The nonprivileged caller must be owner or co-owner of this file. This list file must be a SAM file with variable-length records containing one path name per record.
LIST-FILE-NAME = <filename 1..54 without-gen-vers>
Path name of the list file.
EXCEPT-JV-NAMES = list-poss(20):
<filename 1..80 without-vers-with-wild> /<partial-filename 2..79 with-wild>
The path names of the job variables to be excluded from export are specified directly. A list of up to 20 names may be specified. The first character of the job variable names must not be a hyphen.
The job variables can alternatively be selected using wildcards. In the case of shared pubsets, the replacement of wildcards for catalog IDs does not refer to SF pubsets for which the home computer is the slave.
SAVE-SAM-STRUCTURE = *YES/*NO
Determines whether the structure of SAM-Node files is to be saved.
SAM node files that have been saved without SAM structure can only be restored as a SAM node file again.
SAM node files that have been saved with SAM structure can be restored either as FILE-TYPE=*BS2000 (on public space or Net-Storage) or FILE-TYPE=*NODE-FILE.
PASSWORDS = *NONE / *SECRET-PROMPT / list-poss(63): <c-string 1..4> / <x-string 1..8> /
<integer -2147483648..2147483647>
If a file or job variable which is to be exported using ADD-FILE-NAMES or replaced using SELECT-FILES is protected by a password, the passwords must be specified here. The HSMS administrator can export files and job variables without specifying passwords.
If a save file protected by a password is to be updated, the password must also be specified here. The PASSWORDS operand has the following special characteristics:
The password entered is not logged.
The input field is automatically blanked out in an interactive dialog.
In unguided dialog and foreground procedures, the entry *SECRET or ^ permits concealed input of the password.
COMPRESS-FILES = *NO / *YES
Determines whether or not data is compressed before being written to the output volume.
SAVE-DIRECTORY = *NO / *YES
Determines whether or not the directory is written to the export volume as the last file in the export run.
OUTPUT-SAVE-FILE =
Defines the save file to which the exported files are to be written.
OUTPUT-SAVE-FILE = *NEW(...)
The exported files are to be written to a new save file. The following attributes for this save file can be defined here:
RETENTION-PERIOD = 0 / <integer 0..16383 days>
Physical retention period in days. During this period, neither the save file nor the save volume may be modified or deleted.
USER-ACCESS = *ALL-USERS
The save file is created as a shareable file. The data can be imported under a different user ID.
USER-ACCESS = *OWNER-ONLY
The save file is created as a non-shareable file. The data can be imported only under the same user ID.
SAVE-FILE-PASSWORD = *NONE / *SECRET-PROMPT / <c-string 1..4> / <x-string 1..8> /
<integer -2147483648..2147483647>
The save file to be created can be assigned a password which must be entered when the file is continued or imported.
The SAVE-FILE-PASSWORD operand has the following special characteristics:
The password entered is not logged.
The input field is automatically blanked out in an interactive dialog.
In unguided dialog and foreground procedures, the entry *SECRET or ^ permits concealed input of the password.
OUTPUT-SAVE-FILE = *CONTINUE(...)
The save file that can be specified through the following entries is to be continued.
The save file from which the user wishes to copy may not be specified (see the "SAVE-FILE-ID" operand). The default *LATEST may not be used for both save files.
SAVE-FILE-ID = *LATEST
The most recently created save file is continued.
SAVE-FILE-ID = <composed-name 15..15>
The specified save file is continued. The save file ID must be specified in the format S.yymmdd.hhmmss
TO-STORAGE = *TAPE(...)
The files are exported to tape. The volumes can be defined in greater detail; if several volumes are specified, they all must be of the same device type.
VOLUMES = *FROM-POOL
The volumes are taken from the volume pool of the specified archive or the associated MAREN pool.
VOLUMES = *FROM-OPERATOR
The volumes are to be allocated by the operator on request.
VOLUMES = list-poss(100): <vsn 1..6>
List of volume serial numbers, which will be requested in the specified order.
DEVICE-TYPE = *STD / <device>
Device type of the requested volumes. The device type must belong to the class “TAPE”. Only device types known in the system are accepted. In interactive mode, DEVICE-TYPE=? calls up a list of the available device types.
The default value is the value defined with the S2-DEVICE-TYPE operand of the MODIFY-HSMS-PARAMETERS statement if OUTPUT-SAVE-FILE=NEW(...) or the device type of the device previously used if OUTPUT-SAVE-FILE=CONTINUE(...).
LOCATION = *ANY / <alphanum-name 1..8>
Location used for requesting volumes. This location must be known to MAREN. If the location manager is in use, the location should be properly defined in MARENLM. Otherwise MAREN ignores the specified value.
If MAREN is not in use, you must specify for LOCATION the value *ANY.
LOCATION = *ANY
No location is to be used.
TO-STORAGE = *PUBLIC-DISK(...)
This operand value is only available to the HSMS administrator.
The save file is to be exported to a pubset.
PUBSET-ID = <cat-id>
Catalog ID of the pubset.
TO-STORAGE = *NET-STORAGE(...)
The save file is to be exported to a Net-Storage.
VOLUMES = list-poss(16): <vsn 1..6>
Specifies the Net-Storage volume to which the files are to be copied. The volume specified must be accessible.
More than one Net-Storage volume can also be specified in a list (e.g. when there is more than one save task).
OPERATION-CONTROL =
Enables you to define certain parameters for the execution of the export run.
OPERATION-CONTROL = *STD
The default values of the operands described below apply.
OPERATION-CONTROL = *PARAMETERS(...)
The following operands which control the export run can be modified:
REQUEST-NAME = *STD / <name 1..8>
Request name that can be used in the request management statements (DELETE-REQUESTS, RESTART-REQUESTS and SHOW-REQUESTS) to refer to this request.The name is extended internally by a prefix derived from the user ID (or SYSHSMS for the HSMS administrator) and a suffix in the form of a time stamp.
Unless otherwise specified, the request name is formed by the short code “UES#” and the TSN of the calling user task yyyy as follows: UES#yyyy.
REQUEST-DESCRIPTOR = *NONE / <text 1..60>
It is possible to enter any text that describes the request in more detail.
This text is displayed at the operator console when the request is started. The text can be output using the HSMS statement SHOW-REQUESTS.
EXPRESS-REQUEST = *NO / *YES
This operand is only available to the HSMS administrator.
Determines whether tape access is to take place during the sessions defined for express requests.
CONTROL-JV = *NONE / <filename 1..54 without-gen-vers>
Specifies the name of a job variable that HSMS supplies with various values corresponding to important actions performed by HSMS/ARCHIVE.
The nonprivileged caller must be owner or co-owner of this job variable. The user issuing the request can query the job variable to obtain an overview of the current processing status. How to use the job variable is described in detail in the “HSMS Vol. 1” manual [1] in the section “Job variable for request monitoring”.
WAIT-FOR-COMPLETION = *NO / *YES
Specifies whether the user wishes to wait until processing of his or her request has been completed (synchronous processing) or whether control is to be returned to the user after the validity of the HSMS statement has been checked (asynchronous processing).The maximum wait times for batch tasks and interactive tasks are different and are determined by preset global HSMS parameters.
Interactive tasks are permitted to carry out synchronous HSMS statement processing during tape sessions only.
CATALOG-ID-MODE = *YES / *NO
Determines whether the data is written to the save file with or without a catalog ID (according to the CATID parameter in ARCHIVE).
PARALLEL-RUNS = 1 / <integer 1..16>
Number of save tasks (ARCHIVE subtasks) running in parallel.
There must be two tape devices available for each task.Unless otherwise specified, only one save task is running.
For further information on parallel processing, see the “HSMS Vol. 1” manual [1].
WRITE-CHECKPOINTS = *YES / *NO
Defines whether any checkpoints are to be written to the ARCHIVE checkpoint file during processing; these checkpoints permit a request to be restarted following an interruption (state INTERRUPTED).
Unless otherwise specified, the preset value from the archive definition applies.
OPERATOR-INTERACTION = *NOT-ALLOWED / *ALLOWED
Determines whether messages requiring an operator response are to be output at the console (*ALLOWED) or not (*NOT-ALLOWED). If *NOT-ALLOWED applies, HSMS performs default handling (see the description of the PARAM statement in the “ARCHIVE” manual [2]).
TAPE-CONTROL =
Defines the parameters which are relevant for export to tape.
TAPE-CONTROL = *STD
The default values of the operands described below apply.
TAPE-CONTROL = *PARAMETERS(...)
The parameters relevant for export to tape can be modified as follows:
BLOCKING-FACTOR = *STD / <integer 15..15 2Kbyte> / *MAX
Blocking factor to be used for writing the save file to tape, specified as the number of 2-Kbyte blocks (PAM pages) written to tape in a single input/output operation. As the higher blocking factor means that the occupancy level of the volume and the tape processing performance improve, values below 15 should not be selected.When the default value *STD is selected, the default values of the ARCHIVE parameters apply (BLOCK-SIZE-TAPE for tapes, BLOCK-SIZE-T-C for magnetic tape cartridges).
*MAX selects the maximum blocking factor possible in the current BS2000 version. Currently this is the value 128.
UNLOAD-TAPE = *NO / *YES
Specifies whether or not tapes are to be unloaded after processing.
PERFORMANCE-ANALYSIS =
Specifies whether a statistics file is to be produced for each ARCHIVE subtask.
ARCHIVE writes a new line to this statistics file:
when it opens a save file ARCHIVE.SAVE.FILE.
when it closes this save file.
whenever it begins saving or restoring a new file.
every 2 seconds while it is saving/restoring.
This gives a detailed overview of the ARCHIVE activities taking place during the save and restore operations.
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 =
Determines whether a report is to be output for this export request and to determine the scope of this report.
REPORT = *SUMMARY
A summary of the results of the export request, including any error messages, is to be output.
REPORT = *FULL
A full report is to be output, including a list of all exported 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 for this export request is to be printed.
OUTPUT = *NONE
No report is output. Nevertheless the report is available as a pdf file via the SE manager application Backup Monitoring, if the monitoring is activated in the global HSMS parameters.
OUTPUT = *MAIL
The report for this export 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 export 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 export request is to be prepared for printing 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.
For nonprivileged callers the report files must be under the user’s own user ID. If not, co-ownership is a prerequisite.