This statement is used for selecting file names from node archives according to criteria that are meaningful within HSMS. It refers only to backups or archivals of a BS2000-UFS (POSIX) or node S0.
This HSMS statement causes a list of file names to be compiled and optionally written to a file that can subsequently be referred to in an action statement. The criteria used for selection are not documented.
This statement has different formats for nonprivileged users and HSMS administrators. Privileged operands or operand values are marked with *P).
Format
SELECT-NODE-FILES | Alias: SNF | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
*P) Privileged operand or operand value
PATH-NAMES =
Serves to specify the path names of the node files of a BS2000-UFS (POSIX) or node S0 to be selected. Specification of this operand is mandatory.
The user can further restrict the selection made here by means of other operands, e.g. by EXCEPT-PATH-NAMES.
If node files from several different node S0s are specified when selecting from a system archive, the same system archive must be assigned to all these node S0s.
The option of selecting the node files of other users or node files of remote node S0s is restricted to the HSMS administrator.
More information about path names can be found in the “HSMS Vol. 1” manual [1].
PATH-NAMES = *OWN
*OWN is equivalent to “ / ” (root), subject to the restriction that the user must be the owner of all the node files.
Meaning for the HSMS administrator:
The system is to select all node files and directories belonging to the user ID root and which reside on the central BS2000-UFS nodes in the specified environment.
Meaning for nonprivileged users:
The system is to select all node files and directories belonging to the user and which reside on the central BS2000-UFS in the specified environment.
PATH-NAMES = *ALL
Meaning for the HSMS administrator:
The system is to select all node files that reside on the local BS2000-UFS and on a connected node S0 under HSMS control in the specified environment. The selection is made from the directory file for node files. *ALL is equivalent to “ / ”.
Meaning for the nonprivileged user:
All node files that reside on the local BS2000-UFS in the specified environment and which meet the following conditions are to be selected:
If the node files are to be selected from a long-term archive, the nonprivileged user must have had read access to the files at save time.
If the node files are to be selected from a backup archive, the nonprivileged user must be the owner of the files.
The selection is made from the directory file for node files.
PATH-NAMES = *SELECTED
The path names of the node files to be selected are to be taken from a list that was compiled within the same HSMS run by means of the HSMS statement SELECT-NODE-FILES.
PATH-NAMES = *FROM-FILE(...)
The path names of the node files to be selected 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. Only path names of node files are permitted in this list.
LIST-FILE-NAME = <filename 1..54 without-gen-vers>
BS2000 path name of the list file.
PATH-NAMES = *FROM-LIBRARY-ELEMENT(...)
The path names of the node files which are to be selected are taken from a PLAM library element (type S). The library element contains one path name per record.
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.
PATH-NAMES = *PATH-NAME(...)
The path name of the file to be selected is specified directly.
PATH = <posix-pathname 1..1023 with-wild>
Path name of the node file.
NODE-ID =
This operand is only available to the HSMS administrator.
Physical location of the node file to be selected.
NODE-ID = *BS2000-UFS
The node file resides on the local BS2000-UFS in the branch which corresponds with the specified environment.
NODE-ID = *ALL
The local BS2000-UFS and all existing node S0s are searched for the node file.
NODE-ID = <posix-filename 1..48 with-wild>
Name of the node S0 on which the node file resides. The node S0 which is defined with //MODIFY-NODE-PARAMETERS is mounted under the directory /HSMS/<node-id> in POSIX, and access takes place via NFS.
EXCEPT-PATH-NAMES =
Serves to specify node files that are to be excluded from selection.
EXCEPT-PATH-NAMES = *NONE
All node files specified with the PATH-NAMES operand are to be selected.
EXCEPT-PATH-NAMES = *FROM-FILE(...)
The path names of the node files to be excluded from selection 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>
BS2000 path name of the list file.
EXCEPT-PATH-NAMES = *FROM-LIBRARY-ELEMENT(...)
The path names of the node files which are not to be selected are taken from a PLAM library element (type S). The library element contains one path name per record.
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-PATH-NAMES = *PATH-NAME(...)
The path name of the node file to be excluded from selection is specified directly. The first character of the path names must not be a hyphen.
The path names may contain wildcards. Note, however, that only the HSMS administrator may use wildcards for node ID specification. Depending on the values specified for SELECT-FROM, the wildcards are replaced according to the file names in the node list or the directory file.
PATH = <posix-pathname 1..1023 with-wild>
Path name of the node file.
NODE-ID =
This operand is only available to the HSMS administrator.
Physical location of the node file to be excluded from selection.
NODE-ID = *BS2000-UFS
The node file resides on the local BS2000-UFS in the branch which corresponds with the specified environment.
NODE-ID = *ALL
The node files on the local BS2000-UFS and on all existing node S0s are excluded.
NODE-ID = <posix-filename 1..48 with-wild>
Name of the node S0 which is to be excluded.
SELECT-FROM =
Defines that the node files are to be selected from an archive.
SELECT-FROM = *ARCHIVE(...)
The node files are to be selected from an archive.
ENVIRONMENT =
HSMS environment in which the archive is defined.
ENVIRONMENT = *NODE-STD
The environment is derived from either:
The PATH-NAMES=*PATH-NAME(NODE-ID) operand or
The list of node IDs which is referenced in the file using the PATH-NAMES=*FROM-FILE(LIST-FILE-NAME) operand.
For a workstation, this is the environment in which the HSMS statement MODIFY-NODE-PARAMETERS is performed.
For a privileged user under BS2000-UFS, it is a SINGLE-FEATURE environment; for a nonprivileged user *NODE-STD takes the value of the environment in which the home directory of the user is defined.
If the affected node files are located in different environments the statement is rejected with the message HSM0530.
ENVIRONMENT = *SINGLE-FEATURE
The archive is defined in the SF environment.
ENVIRONMENT = *SYSTEM-MANAGED(...)
The archive is defined in the specified SM pubset environment.
CATALOG-ID = <cat-id>
Catalog ID of the SM pubset environment.
ARCHIVE-NAME =
Name of the archive used for selection.
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 nonprivileged users 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 = *SYSNODEBACKUP
The node files are to be selected from the assigned default system backup archive.
ARCHIVE-NAME = *SYSNODEARCHIVE
The node files are to be selected from the assigned default long-term system archive.
ARCHIVE-NAME = <filename 1..22 without-cat-gen-vers>
The node files are to be selected from the specified private archive.
SAVE-VERSION-NAME = *ANY / <name 1..8>
The save versions to be used for file selection can be selected using the names assigned to them at creation time as the selection criterion.
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 criterion.
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(...)
Serves to select the save versions using a time interval as the selection criterion.The interval includes all save versions created between CREATED-AFTER and CREATED-BEFORE.
Unless otherwise specified, all save versions, starting with 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>
Restricts selection to save versions created on or before the specified date.
CREATED-BEFORE = <integer -99999..0 days>
Restricts selection to save versions created on or before the specified relative date.
CREATED-AFTER = *EARLIEST-DATE
The save versions are to be selected irrespective of whether they were created after a specific date.
CREATED-AFTER = <date with-compl>
Restricts selection to save versions created on or after the specified date.
CREATED-AFTER = <integer -99999..0 days>
Restricts selection 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 created on or before the specified date is to be used for selection.
TIME = 23:59:59 / <time>
The last save version created at or before the specified date and time is to be used for selection.
EXPIRATION-DATE =
The save versions to be used for file selection can be selected using their expiration date as the selection criterion.
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 the expiration date.
With long-term archives, the expiration date of a save version is derived from the file expiration date, with 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 file selection irrespective of their expiration date.
EXPIRATION-DATE = *INTERVAL(...)
The save versions to be used for file 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>
Restricts selection to save versions whose retention period expires before the specified date.
EXPIRATION-AFTER = *EARLIEST-DATE / <date with-compl> / <integer -99999..99999 days>
Restricts selection to save versions whose retention period expires after the specified date.
FILE-SAVE-STATE =
Serves to select the node files according to their save type, i.e. depending on whether and how they were saved.
FILE-SAVE-STATE = *ANY
The node files are to be selected irrespective of whether and how they were saved.
FILE-SAVE-STATE = *SAVED(...)
Restricts selection to saved node files.
TYPE =
Serves to select the node files using their save type as the selection criterion.
TYPE = *ANY
The node files are to be selected irrespective of their save type.
TYPE = *MODIFIED-DURING-SAVE
Restricts selection to node files which were opened while being saved.
FILE-SAVE-STATE = *CATALOGED-NOT-SAVED
Restricts selection to node files which were not saved but which are indicated in the archive directory (save type CNS). These can be
node files which were not saved during an incremental backup because they were not modified
or node files which could not be saved due to an error.
SELECTION-BOUNDARY =
Defines which part of the node file tree is used for file name expansion.
SELECTION-BOUNDARY = *ALL-FILE-SYSTEMS
All node files and directories specified with the PATH-NAMES operand will be processed.
Any node files and directories subordinated to a directory to be processed will be included in the selection.
Node files and directories will be selected from all levels of the file tree.
SELECTION-BOUNDARY = *SPECIFIED-PATHS
All node files and directories specified with the PATH-NAMES operand will be processed.
For directories, only their inodes will be included. Any node files and directories subordinated to a directory to be processed will be ignored.
OUTPUT =
Specifies where the created list of file names is to be output.
OUTPUT = *SELECT-LIST
The created list of file names is written to a temporary file. It can be accessed with PATH-NAMES=*SELECTED in a subsequent HSMS statement.
The file is automatically deleted at the end of the task.
OUTPUT = <filename 1..54 without-gen-vers>
The created list of file 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 will be rejected.
For nonprivileged callers the report files must be under the user’s own user ID. If not, co-ownership is a prerequisite.
Example
The HSMS administrator selects all the node files located in the default system archive.
//SELECT-NODE-FILES PATH-NAMES=*ALL, - // OUTPUT=HSMS.SELECTION1
All the node files in the archive SYSNODEBACKUP are selected and saved in the file HSMS.SELECTION1.