This statement is used to select job variable names from a catalog, archives or directories according to criteria that are meaningful to HSMS.
This HSMS statement causes a list of job variable names to be drawn up and, if required, written to a file which can be used in a subsequent action statement. No information is retained about the criteria by which the selection was made.
The statement has the same format for nonprivileged users and HSMS administrators.
Format
SELECT-JV-NAMES | Alias: SJN | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
JV-NAMES =
The job variables to be selected must be specified. Specification is mandatory.
The SELECT-FROM operand defines that the job variables are to be selected from an archive directory. The selection can be further restricted by other operands, e.g. DIALOG-JV-SELECT.
If several pubsets are specified for the selection from a system archive, the same system archive must be assigned to all the pubsets.
All nonprivileged users can also select job variables belonging to other user IDs if they are co-owners of these job variables.
JV-NAMES = *OWN
All job variables of the user’s own ID on all imported pubsets (except for shared SF pubsets for which the home computer is the slave) are selected.
JV-NAMES = *ALL
All job variables on all imported pubsets (except for shared SF pubsets for which the home computer is the slave) are selected.
Meaning for nonprivileged users:
If SELECT-FROM=*ARCHIVE(...) is specified, all the job variables of which the user is the owner or co-owner are selected.
If SELECT-FROM=*CATALOG(...) is specified, all the job variables of which the user is the owner or co-owner or which are shareable are selected.
JV-NAMES = *SELECTED
The path names of the job variables to be selected are taken from a list which was generated in the same HSMS run with the HSMS statement SELECT-JV-NAMES.
JV-NAMES = *FROM-FILE(...)
The path names of the job variables to be selected are taken from a file. The nonprivileged caller must be owner or co-owner of this file. Only upper-case characters may be used.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.
JV-NAMES = *FROM-LIBRARY-ELEMENT(...)
The path names of the job variables which are to be selected 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 of the highest existing version is used.
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 selected is input directly. A list of up to 20 names can be specified.
The job variable names can be specified as fully or partially qualified names, with or without catalog or user ID. If required, the job variable name is extended by the user ID of the request and the default catalog ID of the user ID.
You can also use wildcard syntax to select the job variables. Depending on the specification in the SELECT-FROM operand, the wildcards are replaced according to the job variable names listed in the catalog or the archive directory.
For shared pubsets, wildcard replacement in catalog IDs does not refer to SF pubsets for which the home computer is the slave.
EXCEPT-JV-NAMES =
Job variables can be specified which are not to be selected.
EXCEPT-JV-NAMES = *NONE
All job variables are selected which are specified in the JV-NAMES operand.
EXCEPT-JV-NAMES = *FROM-FILE(...)
The path names of the job variables that are not to be selected are taken from a file. The nonprivileged caller must be owner or co-owner of this file. This file must be a SAM file with variable record lengths which contains a single path name per record. Only upper-case characters may be used.
LIST-FILE-NAME = <filename 1..54 without-gen-vers>
Path name of the list file.
EXCEPT-JV-NAMES = *FROM-LIBRARY-ELEMENT(...)
The path names of the job variables which are not to be selected 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 of the highest existing version is used.
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 not to be selected are input directly. A list of up to 20 names can be specified.
The job variable names can be specified as fully or partially qualified names, with or without catalog or user ID. If required, the job variable name is extended with the user ID of the request and the default catalog ID.
You can also use wildcard syntax to select the job variables. Depending on the specification in the SELECT-FROM operand, the wildcards are replaced according to the job variable names listed in the catalog or the archive directory.
The resolution of the wildcard syntax for catalog IDs does not refer to shared pubsets for which the home computer is a slave.
SELECT-FROM =
Determines whether the job variables are selected from pubset catalogs or archive directories.
SELECT-FROM = *CATALOG
The job variables are selected from the pubset catalog.
SELECT-FROM = *ARCHIVE(...)
The job variables are selected from an archive. The selection can be restricted further.
ARCHIVE-NAME =
Name of the archive from whose archive directory the job variables are to be selected.If the archive directory is protected by a password, this password must be entered by means of the ADD-PASSWORD command prior to statement entry. This also applies to HSMS administrators.
To enable a nonprivileged user to use another user’s archive, the archive must contain read access (USER-ACCESS=*ALL-USERS and ACCESS=*READ), or co-ownership of the archive directory.
ARCHIVE-NAME = *SYSBACKUP
The job variables are to be selected from the assigned default system backup archive in the specified environment.
ARCHIVE-NAME = *SYSARCHIVE
The job variables are to be selected from the assigned long-term system archive for archiving in the specified environment.
ARCHIVE-NAME = *BY-DIRECTORY-NAME(...)
The job variables are to be selected from a directory in the specified environment which does not have to belong to an HSMS archive, e.g. a directory for data transfer or an ARCHIVE directory file.
In cases like this, the directory can also have been created without a catalog ID.
DIRECTORY-NAME = <filename 1..54 without-gen-vers>
Path name of the directory file.
ARCHIVE-NAME = <filename 1..22 without-cat-gen-vers>
The job variables are to be selected from the specified archive in the specified environment.
ENVIRONMENT =
Defines the HSMS environment where the specified archive is located.
ENVIRONMENT = *STD
Meaning for privileged users: *STD is set to the value *SINGLE-FEATURE.
Meaning for nonprivileged users: *STD is the environment that is associated with the user’s default pubset (the default pubset is defined in the user catalog).
ENVIRONMENT = *SINGLE-FEATURE
The HSMS statement relates only to the SF environment.
ENVIRONMENT = *SYSTEM-MANAGED(...)
The HSMS statement relates only to the specified SM pubset environment.
CATALOG-ID = <cat-id>
Catalog ID of the SM pubset to which the HSMS statement applies.
SAVE-VERSION-NAME = *ANY / <name 1..8>
The save versions to be used for selection can be selected using the names assigned to them at creation time as the selection criteria.
Unless otherwise specified, the save versions are selected irrespective of their names.
SAVE-VERSION-DATE =
The save versions to be used for file selection can be selected using their creation date as the selection criteria.
In combination with explicit specification of a save version name, this operand restricts the selection of save versions to those with both the specified name and creation date.
SAVE-VERSION-DATE = *INTERVAL(...)
The save versions are to be selected using a time interval as the selection criterion. The interval includes all save versions created between CREATED-AFTER and CREATED-BEFORE.
Unless otherwise stated, all save versions starting from the one created first (*EARLIEST-DATE) up to the one created last (*LATEST-DATE) are selected.
CREATED-BEFORE = *LATEST-DATE
The save versions are to be selected irrespective of whether they were created before a specific date.
CREATED-BEFORE = <date with-compl>
The selection is restricted to save versions created on or before the specified date.
CREATED-BEFORE = <integer -99999..0 days>
The selection is restricted to save versions created on or before the specified relative date.
CREATED-AFTER = *EARLIEST-DATE
The save versions are selected irrespective of whether they were created after a specific date.
CREATED-AFTER = <date with-compl>
The save versions are to be selected irrespective of whether they were created after a specific date.
CREATED-AFTER = <integer -99999..0 days>
The selection is restricted to save versions created on or after the specified relative date.
SAVE-VERSION-DATE = *LATEST
Only the most recently created save version in the archive is to be used for selection.
SAVE-VERSION-DATE = <date with-compl>(...)
The last save version that was created on or before the specified date is to be used for the selection.
TIME = 23:59:59 / <time>
The last save version created on or before the specified date and at or before the specified time is to be used for selection.
EXPIRATION-DATE =
The save versions to be used for the job variable selection can be selected using their expiration date as the selection criterion.
In combination with explicit specification of a save name, this operand restricts the selection of save versions to those with both the specified name and the expiration date.For long-term archives, the expiration date of a save version is derived from the file expiration date and for backup archives it is derived from the physical retention period valid for the corresponding save file.
EXPIRATION-DATE = *ANY
The save versions are to be used for the job variable selection irrespective of their expiration date.
EXPIRATION-DATE = *INTERVAL(...)
The save versions to be used for the job variable selection can be selected on the basis of a time interval within which their retention period will expire.
EXPIRATION-BEFORE = *LATEST-DATE / <date with-compl> / <integer -99999..99999 days>
This restricts selection to save versions whose retention period expires before the specified date.
EXPIRATION-AFTER = *EARLIEST-DATE / <date with-compl> / <integer -99999..99999 days>
This restricts selection to save versions whose retention period expires after the specified date.
DIALOG-JV-SELECT =
Determines whether the job variable set selected by JV-NAMES and other operands is to be further restricted in the dialog.
The operand is only evaluated in the dialog. It is ignored for batch requests.
DIALOG-JV-SELECT = *NO
The selected job variable set is not restricted.
DIALOG-JV-SELECT = *YES
The selected job variable set is output in a screen mask. You can then mark individual files from the set displayed, thereby selecting them for or excluding them from selection.
For job variables selected from the catalog, the path name and size in bytes are shown in the screen mask. Details on the content of the screen mask are provided in the section "Dialog selection when selecting job variables via catalog IDs".
For job variables which are selected from an archive, the number of true save version (#VERS) of the job variables is displayed along with the date of the last true backup (LAST-SAVE) along with the path name. Details on the content of the screen mask are provided in the section "Dialog selection when selecting job variables from an archive".
OUTPUT =
Specifies where the created list is to be output.
OUTPUT = *SELECT-LIST
HSMS writes the created list of job variable names to a temporary file. It can be accessed in a subsequent HSMS statement with JV-NAMES=*SELECTED.
The file is automatically deleted at the end of the task.
OUTPUT = <filename 1..54 without-gen-vers>
The created list of job variable names is written to the specified file. It is structured as a SAM file with variable-length records. A SAM file which has already been cataloged may be expanded in order to merge several file name lists.
If the specified file is not a SAM file, the HSMS statement is rejected.
For nonprivileged callers the report files must be under the user’s own user ID. If not, co-ownership is a prerequisite.
Dialog selection when selecting job variables via catalog IDs
//SELECT-JV-NAMES ...,SELECT-FROM=*CATALOG,...,DIALOG-JV-SELECT=*YES,...
SELECT-JV-NAME (FROM CATALOG) #JVS = @@@@@@@@@@ SUPPORT = @@@@@@@@@@@@ -------------------------------------------------------------------------------- M JV-NAME #BYTES _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@ -------------------------------------------------------------------------------- NEXT-PAGE : (+,-,++,--, E, 'STRING') MARK : (A: ALL, N: NONE) @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Key
Colum Values | Meaning |
M | Mark column (mark character = job variable is selected, blank = job variable is not selected) |
JV-NAME | Path name of the job variable that can be selected |
#BYTES | Size of the job variable in bytes |
The procedure for selecting job variables is described in the “HSMS Vol. 1” manual [1].
Dialog selection when selecting job variables from an archive
//SELECT-JV-NAMES ...,SELECT-FROM=*ARCHIVE(...),DIALOG-JV-SELECT=*YES,...
SELECT-JV-NAME (FROM ARCHIVE) #JVS = @@@@@@@@@@ ENVIRONMENT = @@@@@@@@ ARCHIVE-NAME = @@@@@@@@@@@@@@@@@@@@@@ SV-NAME = @@@@@@@@ JV-SAVE-STATE = @@@@@@@@@@@@@@@@@@@@ SV-DATE = @@@@@@@@@ @@@@@@@@ @@@@@@@@ EXP-DATE = @@@@@@@@ @@@@@@@@ -------------------------------------------------------------------------------- M JV-NAME #SAVES LAST-SAVE SYS _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@ @@@@@@@@ @@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@ @@@@@@@@ @@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@ @@@@@@@@ @@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@ @@@@@@@@ @@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@ @@@@@@@@ @@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@ @@@@@@@@ @@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@ @@@@@@@@ @@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@ @@@@@@@@ @@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@ @@@@@@@@ @@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@ @@@@@@@@ @@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@ @@@@@@@@ @@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@ @@@@@@@@ @@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@ @@@@@@@@ @@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@ @@@@@@@@ @@@ _ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@ @@@@@@@@ @@@ -------------------------------------------------------------------------------- NEXT-PAGE : ____________ (+,-,++,--, E, 'STRING') MARK : __ (A: ALL, N: NONE) @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Key:
Column | Values | Meaning |
M | Mark column (mark character = job variable is selected, blank = job variable is not selected) | |
JV-NAME | Path name of the job variable that can be selected | |
#SAVES | Number of different save versions that contain this job variable | |
LAST-SAVE | Date of the last full save of this job variable | |
SYS | Displays whether there is another job variable with the same name in the system: | |
YES |
| |
blank |
|
The procedure for selecting job variables is described in the “HSMS Vol. 1” manual [1].