This statement is for the HSMS administrator only. The statement relates only to SF pubsets. It is used for placing a SF pubset under HSMS management and redefining the SF pubset parameters. As of HSMS V10.0A it is also possible to specify SM pubsets in the statement for further use as S1 storage level of SF pubsets (operand S1-PUBSET-ID; so called S1-SM-pubset).
An entry in the HSMS control file is made only for those SF pubsets whose parameter values differ from the default values of the HSMS parameters. The modified values apply as of statement entry (equivalent to VALID-PERIOD=*PERMANENT).
An entry can be deleted from the HSMS control file by resetting all pubset parameters to their default values (this takes effect as of the next HSMS session).
Since this HSMS statement can be used both to place pubsets under HSMS management and to modify the parameter values for pubsets already under HSMS management, the operand value *UNCHANGED has two different meanings:
For placing pubsets under HSMS management, *UNCHANGED means that the default values apply; these are listed in the table "Default values".
When redefining parameter values, *UNCHANGED means that the values defined via a previous MODIFY-PUBSET-PARAMETERS statement are not changed. These can be interrogated by means of the HSMS statement SHOW-PUBSET-PARAMETERS.
Format (only for HSMS administrators)
MODIFY-PUBSET-PARAMETERS | Alias: MPP | ||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||
PUBSET-ID = <cat-id>
ID of the SF or SM pubset whose parameters are to be redefined. The SF pubset must already have been defined in or imported to the HSMS control file. If an SM pubset is used it must already have been put under HSMS control (by CREATE-SM-PUBSET-PARAMETERS statement) and have its local HSMS control file. An SM pubset may only be used, if the global HSMS parameter SAVE-FILE-PROCESSING is set to *HSMS-V10-COMPATIBLE.
The user ID SYSHSMS must be created on a pubset before it is assigned for the first time.
STORAGE-LEVEL = *UNCHANGED / *UNDEFINED / *S0(...) / *S1
Storage level to which the pubset is to be assigned. If a pubset is reset from *S0 to *UNDEFINED, all values set for the substructure of STORAGE-LEVEL=*S0 are simultaneously reset to their default values. The default values are listed at the end of the operand description for this statement.
STORAGE-LEVEL = *UNDEFINED
The pubset is not to be assigned to any storage level. This pubset cannot be used for migration. It is possible, however, to assign archives of this pubset for backup and archival.
With this value you can remove dismounted pubsets from the global HSMS control file.
STORAGE-LEVEL = *S0(...)
The pubset is to be assigned to storage level S0. This pubset must not be an SM pubset. Additional parameters can be set for this pubset:
S1-PUBSET-ID = *UNCHANGED / *STD / <cat-id>
Serves to define the default S1 pubset to be assigned to this pubset. The pubset with the specified pubset ID must be defined as an S1 pubset beforehand. It can be an SF or an SM pubset.
S1-PUBSET-ID = *STD
The global S1 pubset as defined in the HSMS parameters is to be assigned.
SYSMIGRATE = *UNCHANGED / *STD / <filename 1..22 without-cat-gen-vers>
Name of the default system migration archive.
The HSMS administrator must previously have created the specified archive as the public migration archive by means of the HSMS statement CREATE-ARCHIVE.
SYSMIGRATE = *STD
Assigns the default system migration archive as defined in the HSMS parameters as the default archive for this pubset.
MIGRATION = *UNCHANGED / *ALLOWED / *S2-ONLY /*INHIBITED
Determines whether nonprivileged users are to be permitted 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 restriction.
MIGRATION = *S2-ONLY
Nonprivileged users are allowed to migrate files only from S0 to S2.
MIGRATION = *INHIBITED
Only the HSMS administrator is allowed to migrate files from this pubset. For all other users migration is prohibited.
STORAGE-LEVEL = *S1
The pubset is to be assigned to storage level S1.
SYSARCHIVE = *UNCHANGED / *STD /<filename 1..22 without-cat-gen-vers>
Name of the default long-term system archive.
The HSMS administrator must previously have created the specified archive as the public long-term archive by means of the HSMS statement CREATE-ARCHIVE.
SYSARCHIVE = *STD
Assigns the default long-term system archive as defined in the HSMS parameters as the default archive for this pubset.
SYSBACKUP = *UNCHANGED / *STD /<filename 1..22 without-cat-gen-vers>
Name of the default system backup archive.
The HSMS administrator must previously have created the specified archive as the public backup archive by means of the HSMS statement CREATE-ARCHIVE.
SYSBACKUP = *STD
Assigns the default system backup archive as defined in the HSMS control file as the default archive for this pubset.
SYSVERSION = *UNCHANGED / *UNDEFINED /<filename 1..22 without-cat-gen-vers>
Name of the default system version backup archive.
The HSMS administrator previously must have created the specified archive as the public version backup archive by means of the HSMS statement CREATE-ARCHIVE. The specified version backup archive must not be already assigned to another pubset.
SYSVERSION = *UNDEFINED
No system version backup archive is assigned for this pubset.
Default values
The following default operand values apply for the first MODIFY-PUBSET-PARAMETERS statement:
Operand value | Default value |
STORAGE-LEVEL | *UNDEFINED |
SYSARCHIVE | global definition from the HSMS parameters |
SYSBACKUP | global definition from the HSMS parameters |
| if S0: | |
S1-PUBSET-ID | global definition from the HSMS parameters |
SYSMIGRATE | global definition from the HSMS parameters |
MIGRATION | *ALLOWED |
| SYSVERSION | *UNDEFINED |
These default values ensure that backup and archival to the appropriate system archive remain possible for all pubsets available, even if they are not under HSMS management. In contrast to this, a pubset which is to be used for migration must be explicitly defined for this purpose.