This statement is for the HSMS administrator only and is used to modify the parameters of an SM pubset that is under HSMS control. If no SM pubset parameters which were set earlier exist when an HSMS session for the SM pubset if started the preset values specified by HSMS apply (see "Presettings").
Format (only for HSMS administrators)
MODIFY-SM-PUBSET-PARAMETERS | Alias: MSP | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SM-PUBSET-ID = <cat-id>
The catalog ID of the pubset for which the parameters are to be modified is specified explicitly.
The specified SM pubset must first be imported locally.
GLOBAL-PARAMETERS = *UNCHANGED / *PARAMETERS(...)
Defines the parameters for an SM pubset under HSMS control.
GLOBAL-PARAMETERS = *PARAMETERS(...)
DESTROY-BY-DELETE = *UNCHANGED / *NO / *YES
Defines the default value for the DESTROY-BY-DELETE parameter in the archive definition.
DESTROY-BY-DELETE = *YES
When the save file is deleted, the released storage space is overwritten with binary zeros for data protection reasons. If overwrite is declared, later deletion of the save file involves a longer run time.
S1-DEFINITION = *UNCHANGED / *PARAMETERS(...)
Defines the S1 level of the SM pubset.
S1-DEFINITION = *PARAMETERS(...)
S1-VOLUME-SET = *UNCHANGED / *UNDEFINED / <cat-id>
Defines the S1 level of the SM pubset.
S1-VOLUME-SET = *UNDEFINED
No S1 level is defined for the SM pubset.
S1-VOLUME-SET = <cat-id>
The catalog ID of the volume set that is to serve as the S1 level is specified explicitly. This volume set must be selected from the volume sets of the SM pubset reserved by HSMS.
S1-VOLUME-SET = *ALL-HSMS-CONTROLLED
The volume set for S1 level is not defined explicitly. Each volume set of the SM pubset which is under HSMS control can be used as S1 level. Several of these volume sets can be used if not enough space is available on a volume set during a save run.
This setting makes sense only if BS2000 OSD/BC V11.0 or higher is used on all systems of the shared pubset network and if SAVE-FILE-PROCESSING=*HSMS-V10-COMPATIBLE is set.
This statement is rejected in the following cases:
If no volume set under HSMS control exists, the specification of *ALL-HSMS-CONTROLLED is rejected with the message HSM050A.
On a BS2000 system with BS2000 OSD/BC earlier than V11.0, the specification of *ALL-HSMS-CONTROLLED is rejected with the message HSM021D.
The error message indicates that the setting does not make sense in the existing shared pubset network. However, it does not prevent the statement from being accepted on another system in the network if a BS2000 version V11.0 or higher exists.
S2-DEVICE-TYPE = *UNCHANGED / *STD / *UNDEFINED / <device>
Default device type with which the objects of the SM pubset are to be saved to the S2 level. The device type must be of the “TAPE” class. Only device types known in the system are accepted. In interactive mode, DEVICE-TYPE=? calls up a list of the available device types.
S2-DEVICE-TYPE = *STD
The value *STD is stored in the specific parameters of the SM pubset. When this option is used, the current value is taken from the host’s HSMS parameters.
SYSBACKUP =
Definition of the default backup archive for the SM pubset.
SYSBACKUP = *UNCHANGED
The default backup archive is not changed.
SYSBACKUP = *UNDEFINED
No default backup archive is defined for the SM pubset.
SYSBACKUP = <filename 1..22 without-cat-gen-vers>
The default backup archive is specified explicitly. This name is local for the SM pubset. The specified archive must already exist.
SYSARCHIVE =
Definition of the default long-term archive for the SM pubset.
SYSARCHIVE = *UNCHANGED
The default long-term archive is not changed.
SYSARCHIVE = *STD
Reference is made to the system archive that is defined in the global HSMS parameters and which is then usable for both the SF environment and this SM environment.
SYSARCHIVE = *UNDEFINED
No default long-term archive is defined for the SM pubset.
SYSARCHIVE = *PARAMETERS(...)
Defines the parameters for the default long-term archive. This long-term archive can be a global SF archive or a local SM archive.
ENVIRONMENT =
Defines the environment type.
ENVIRONMENT = *SINGLE-FEATURE
The default long-term archive must already exist in the SF pubset environment.
ENVIRONMENT = *SYSTEM-MANAGED
The default long-term archive must already exist in the SM pubset environment.
ARCHIVE-NAME =
Name of the default long-term archive.
ARCHIVE-NAME = *DEFAULT-NAME
The long-term archive with the default name :environment cat-id:HSMS.STD.AR is used.
ARCHIVE-NAME = *UNCHANGED
The default long-term archive is not changed.
ARCHIVE-NAME = <filename 1..22 without-cat-gen-vers>
The default long-term archive is specified explicitly.
SYSMIGRATE =
Definition of the default migration archive for the SM pubset.
SYSMIGRATE = *UNCHANGED
The default migration archive is not changed.
SYSMIGRATE = *UNDEFINED
No default migration archive is defined for the SM pubset.
SYSMIGRATE = <filename 1..22 without-cat-gen-vers>
The default migration archive is specified explicitly. The archive must already exist and must be local for the SM pubset.
SYSNODEBACKUP =
Definition of the default backup archive for node files of a BS2000-UFS (POSIX) or node S0 for the current SM pubset.
SYSNODEBACKUP = *UNCHANGED
The default backup archive for node files of a BS2000-UFS (POSIX) or node S0 is not changed.
SYSNODEBACKUP = *UNDEFINED
No default backup archive for node files of a BS2000-UFS (POSIX) or node S0 is defined on the current SM pubset.
SYSNODEBACKUP = <filename 1..22 without-cat-gen-vers>
The default backup archive for node files of a BS2000-UFS (POSIX) or node S0 is specified explicitly and is local for the SM pubset. The specified archive must already exist and be set up with the following attributes: USER-ACCESS=*ALL-USERS(ACCESS=*READ).
SYSNODEARCHIVE =
Definition of the default long-term archive for all node files of a BS2000-UFS (POSIX) or node S0 for the current SM pubset.
SYSNODEARCHIVE = *UNCHANGED
The default long-term archive for node files of a BS2000-UFS (POSIX) or node S0 is not changed.
SYSNODEARCHIVE = *UNDEFINED
There is no default long-term archive for node files of a BS2000-UFS (POSIX) or node S0 specified on the current SM pubset.
SYSNODEARCHIVE = <filename 1..22 without-cat-gen-vers>
The default long-term archive for node files of a BS2000-UFS (POSIX) or node S0 is specified explicitly. The specified archive must already exist with the following attributes: USER-ACCESS=*ALL-USERS(ACCESS=*READ).
SYSVERSION =
Definition of the default version backup archive for the SM pubset.
SYSVERSION = *UNCHANGED
The default version backup archive is not changed.
SYSVERSION = *UNDEFINED
No default version backup archive is defined for the SM pubset.
SYSVERSION = <filename 1..22 without-cat-gen-vers>
The default version backup archive is specified explicitly. This name is local for the SM pubset. The specified archive must already exist.
MIGRATION-CONTROL = *UNCHANGED / *PARAMETERS(...)
Defines the parameters for the migration control.
MIGRATION-CONTROL = *PARAMETERS(...)
MIGRATION = *UNCHANGED / *ALLOWED / *INHIBITED
Defines whether nonprivileged users are allowed to migrate files from this pubset and how many files they are allowed to migrate.
MIGRATION = *ALLOWED
Nonprivileged users can migrate files from this pubset without restrictions.
MIGRATION = *S2-ONLY
Nonprivileged users are only allowed to migrate files from S0 to S2.
MIGRATION = *INHIBITED
Only the HSMS administrator is allowed to migrate objects from this pubset. Migration is not allowed for any other user.
BACKUP-MANDATORY = *UNCHANGED / *YES / *NO
*YES prohibits the migration of files, which have not yet been saved. *NO allows it.
EXCEPT-FILE = *UNCHANGED / *NONE / <filename 1..54 without-cat-gen-vers>
An except file can be specified which contains in records the names of files to be excluded from the migration. The except file may also contain partially qualified file names and names with wildcards. The file names must be written in uppercase letters.The except file must be a SAM file of variable-length records with one path name per record. It can be created, for example, with the HSMS statement SELECT-FILE-NAMES or with the BS2000 command SHOW-FILE-ATTRIBUTES. The except file must be on the SM pubset.
FILE-INHIBIT = *UNCHANGED / *STD / *RESPECTED / *IGNORED
Defines whether the migration inhibits that are set by the user are to be respected. The user can declare migration inhibits with BS2000 commands CREATE-FILE and MODIFY-FILE-ATTRIBUTES.
FILE-INHIBIT = *STD
The value *STD is stored in the specific parameters of the SM pubset. When this option is used, the current value is taken from the HSMS parameters of the SF environment.
FILE-INHIBIT = *RESPECTED
Migration inhibits set by the user are to be respected. The files concerned are not migrated.
FILE-INHIBIT = *IGNORED
Migration inhibits set by the user are ignored. The files concerned are migrated.
Presettings
If at the start of an HSMS session for an imported pubset no previously set SM pubset parameters exist, the presettings defined by HSMS apply, which are shown in the table below. Otherwise, the values that are stored in the control file are used.
Operand value | Presettings prescribed by HSMS |
DESTROY-BY-DELETE | *NO |
S1-DEFINITION | *UNDEFINED |
S2-DEVICE-TYPE | c'TAPE-C4' |
SYSBACKUP | *UNDEFINED |
SYSARCHIVE | *UNDEFINED |
SYSMIGRATE | *UNDEFINED |
SYSNODEBACKUP | *UNDEFINED |
SYSNODEARCHIVE | *UNDEFINED |
SYSVERSION | *UNDEFINED |
MIGRATION | *S2-ONLY |
BACKUP-MANDATORY | *NO |
EXCEPT-FILE | *NONE |
FILE-INHIBIT | *RESPECTED |