The files which are to be processed by a specific HSMS statement are selected by means of its FILE-NAMES and EXCEPT-FILE-NAMES operands. In the HSMS statement COPY-SAVE-FILE, the corresponding operands are SELECT-FILES and EXCEPT-FILES. The selection can be further restricted via additional operands. Some HSMS statements offer the option of confirming the final selection of files via a screen mask.
The simplest way to select files is to process all the files of a given user ID or, in the case of the HSMS administrator, all the files in the system by means of a single HSMS statement:
FILE-NAMES/SELECT-FILES=*OWN/*ALL
This is advisable especially when making full backups, but also whenever files are to be selected according to specific criteria (see below), instead of by file name.
When *OWN/*ALL is specified, shared pubsets are in many cases ignored if the home computer is a slave. Details are provided under the various HSMS statements.
Direct specification of file names
All HSMS statements that are used to process files permit the file names to be entered directly. Up to 20 files can be specified per HSMS statement. If more than 20 files are to be specified, the input should be made by means of a file (see “Specification of file names in a file” below).
The files may be specified using fully-qualified or partially-qualified names, and with or without specification of the catalog ID and user ID.
The use of wildcards is permitted; the syntax for wildcards is described in “HSMS Vol. 2” [1] under “Metasyntax”.
When wildcards are resolved in the catalog ID, shared pubsets for which the home computer is a slave are in many cases completely ignored. Details are provided under the relevant HSMS statement.
By specifying partially-qualified catalog IDs or user IDs, it is easy to process entire pubsets and user IDs.
Nonprivileged users can also process files belonging to other user IDs if they are co-owners of these files (see the “SECOS” manual [16]).
Specification of file names in a file or library elements
It is also possible to pass the file names to HSMS in a list file, in which each file record contains the name of a file to be processed. This list file must be a SAM file with variable record length and contain uppercase letters only. Alternatively, a library element of type S can also be used. To create a input file, you can use for example the BS2000 command:
/SHOW-FILE-ATTRIBUTES ...,OUTPUT=<file name>(FORM-NAME=*FILE-NAME)
or the HSMS statement SELECT-FILE-NAMES. The procedure for creating a file with the HSMS statement SELECT-FILE-NAMES is described on "Selection by means of the HSMS statement SELECT-FILE-NAMES".
The file names in the file may be fully qualified or partially qualified, and with or without specification of the catalog ID and user ID. Only uppercase letters are permitted. The wildcard syntax (see the section "Metasyntax" in "HSMS Vol. 2” [1]) may be used, with the following restriction:
The file names in the file may not be prefixed with a hyphen to exclude them from processing.
The name of this file or the library element must be specified in the FILE-NAMES, EXCEPT-FILE-NAMES, SELECT-FILES, or EXCEPT-FILES operand of the relevant HSMS statement with *FROM-FILE(...) or *FROM-LIBRARY-ELEMENT(...). e.g.:
FILE-NAMES/SELECT-FILES=*FROM-FILE(LIST-FILE-NAME=<filename>) or *FROM-LIBRARY-ELEMENT(LIBRARY=<library>,ELEMENT=<element>)
For a nonprivileged user, the file or the library must be under his/her user ID or access must be permitted by co-ownership.
Restriction of selection via statement operands
Many HSMS statements permit the set of files defined by means of FILE-NAMES to be further qualified through the specification of additional operands: files selected by means of FILE-NAMES are not processed unless they also fulfill the conditions defined by the other operands.
Example
//BACKUP-FILES FILE-NAMES=*ALL,SUPPORT=*PRIVATE-DISK(...)
Instead of backing up all the files, HSMS backs up only those that reside on a private disk (which may also be specified).
All the default values of these qualifying operands have been defined in such a way as to ensure that they do not interfere with file selection by means of FILE-NAMES.
Selection of files on Net-Storage
In BS2000/OSD-BC V9.0 and higher a pubset can be provided with additional storage space which a net server makes available as Net-Storage. This enables files from pubsets to reside either on local pubset disks or remotely on a Net-Storage. BS2000 OSD/BC V10.0 and higher supports both the file type BS2000 and node file on Net-Storage.
Selecting of Net-Storage files residing on volumes of NETVOL volume type is not possible on BS2000 systems lower than V21.0A. This should be taken into account when working with shared pubsets.
When backup takes place using BACKUP-FILES, you can specify in the save options (SAVE-OPTIONS) that data from Net-Storage files of the type BS2000 residing on volumes of NETSTOR is not to be saved. The catalog entries of the files are saved independently of this. The specification is ignored for Net-Storage files residing volumes of type NETVOL. The data of such files is saved irrespectively of the save option (SAVE-NET-STOR-DATA).
Net-Storage files of the type node file are always saved with data irrespective of the specification in the SAVE-NET-STOR-DATA operand.
Example
//BACKUP-FILES FILE-NAMES=*ALL,..., SAVE-OPTIONS=*PAR(SAVE-NET-STOR-DATA=*NO)
When the save operation is restricted in the SUPPORT operand to files from shared disks, the save can also be restricted to files which reside on Net-Storage or to files which reside on local pubset disks.
In the case of Net-Storage the backup can also be restricted to the file type BS2000 or node file in the FILE-TYPE operand. By default all Net-Storage files are saved irrespective of the file type.
Examples
//BACKUP-FILES FILE-NAMES=*ALL,..., SUPPORT=*PUBLIC-DISK(STORAGE-TYPE=*PUBLIC-SPACE),...
Only files from local pubset disks are backed up.
When only files residing on Net-Storage should be selected, a mixture of volumes of both type NETSTOR and NETVOL can be specified in the VOLUMES operand. The files from NETVOL volumes are available for selection on BS2000 V21.0A and higher.
//BACKUP-FILES FILE-NAMES=*ALL,...,
SUPPORT=*PUBLIC-DISK(
STORAGE-TYPE=*NET-STORAGE(VOLUMES=(1#VBIG,2#VBIG)))
Only files which reside on Net-Storage volumes 1#VBIG and 2#VBIG are saved.
//BACKUP-FILES FILE-NAMES=*ALL,...,
SUPPORT=*PUBLIC-DISK(
STORAGE-TYPE=*NET-STORAGE(VOLUMES=(1#VBIG,2#VBIG),
FILE-TYPE=*BS2000))
Only files of the type BS2000 which reside on Net-Storage volumes 1#VBIG and 2#VBIG are saved. Net-Storage files of the type node file which may exist in user-specific directories on these volumes are not saved.
This selection option is also available in the EXPORT-FILES, IMPORT-FILES, and RESTORE-FILES statements (in the ORIGINAL-SUPPORT or NEW-SUPPORT operand).
Selecting file generations
HSMS backs up file generations as well as file generation groups. File generation groups can be specified in the same way as files; all generations of the group will then be backed up. If a specific generation is to be processed, the specified file name must be fully-qualified (with generation number).