This section provides information on statement formats and operand descriptions.
Statement formats
Statement formats are represented in the familiar SDF form. Numerous HSMS statements are available to both the HSMS administrator and – in restricted form – to nonprivileged users.
If a statement can also be used by nonprivileged users, privileged operands and operand values are marked with *P) in the syntax format. Privileged operands and operand values are marked accordingly in the operand description.
With the exception of START-HSMS and STOP-HSMS, the HSMS administrator may always use the complete format. Operands reserved for the HSMS administrator cannot be made available to other users, not even by modifying their syntax file using SDF-A.
Operand description
The operand description does not in all cases give a complete list and detailed explanation of each and every operand value. If the meaning of an operand value is already clear from its name and from the operand description, no further explanation is given.
The default value is in most cases not listed and described separately.
Example from the HSMS statement BACKUP-FILES:
UNLOAD-TAPE = *STD / *NO / *YES
specifies whether or not tapes are to be unloaded after processing.
The preset value from the archive definition applies unless otherwise specified.
The operand value *UNCHANGED is never explained in an operand description. *UNCHANGED is used in MODIFY statements and has the following meaning:
The operand value used up to now is not changed. Since *UNCHANGED is always the default value, MODIFY statements cause only those operands to be changed that are explicitly specified.
Please read the remarks concerning *UNCHANGED at the beginning of the format descriptions of the HSMS statements MODIFY-HSMS-PARAMETERS and MODIFY-PUBSET-PARAMETERS.
Example from the HSMS statement MODIFY-ARCHIVE-ATTRIBUTES:
UNLOAD-TAPE = *UNCHANGED / *NO / *YES
specifies whether or not tapes are to be unloaded after processing.
As the meaning of all the operand values is without further explanation, no further operand description is given.
Example from the HSMS statement CREATE-ARCHIVE:
WRITE-CHECK = *NO / *YES / *SAVE-FILES / *RESTORED-FILES
specifies whether a read-after-write check is to be performed after each write operation for error detection purposes. Note that read-after-write checking will result in longer execution times.
WRITE-CHECK = *SAVE-FILES
restricts read-after-write checks to saved files.
WRITE-CHECK = *RESTORED-FILES
restricts read-after-write checks to restored files.
Since the meaning of the operand values *NO and *YES is clear without further explanation, only the remaining values are explained.
Details of general SDF metasyntax and of how to enter commands or statements are provided in the “SDF Dialog Interface” [3] and “Commands” [5] manuals.