This statement is for use by HSMS administrators only. It places an SM pubset under HSMS control.
The statement checks the status of an SM pubset and activates the attribute “under HSMS control” for that SM pubset. This action is irreversible.
The statement creates the control and request files of the SM pubsets and opens the generic catalog facility of the SM pubset.
The HSMS administrator can specify all the parameters of the SM pubset. The system archives for the SM pubset can also be defined. It should be borne in mind that only a subset of the archive parameters can be specified for creating the backup and migration archives.
Existing archive directories can be assigned to the system archives. A long-term archive that is defined in the global HSMS parameters, can be assigned to the SM pubset; but it is not created automatically (same procedure as for SF pubsets).
Note
If there is no control file on the control volume set of the SM pubset when the pubset is converted, a control file is created. If a control file does exist, it is overwritten.
Format (only for HSMS administrators)
CREATE-SM-PUBSET-PARAMETERS | Alias: CSP | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SM-PUBSET-ID = <cat-id>
The catalog ID of the pubset to be converted must be specified explicitly.
The specified SM pubset must be imported locally before the conversion and the SYSHSMS user ID created on the pubset.
GLOBAL-PARAMETERS =
Defines the parameters for an SM pubset under HSMS control.
GLOBAL-PARAMETERS = *STD
All default values are used.
GLOBAL-PARAMETERS = *PARAMETERS(...)
The parameters for an SM pubset are defined.
DESTROY-BY-DELETE =
Determines whether, during deletion, the save file of the released storage space is to be overwritten with binary zeros for data protection reasons.
DESTROY-BY-DELETE = *NO
When the save file is deleted, the released storage space is not overwritten with binary zeros.
DESTROY-BY-DELETE = *YES
When the save file is deleted, the released storage space is overwritten with binary zeros for data protection reasons. Subsequent deletion of the save file therefore involves a longer run time.
S1-DEFINITION =
Defines the S1 level of the SM pubset.
S1-DEFINITION = *STD
All the default values are used.
S1-DEFINITION = *PARAMETERS(...)
The S1 level of the SM pubset is specified.
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 S1 volume set must be selected from the volume set of the SM pubset reserved by HSMS. If an incorrect S1 volume set is specified, the statement is rejected.
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 = *STD / *UNDEFINED / <device>
Default device type with which the objects of the SM pubsets are to be saved to the S2 level. The device type must belong to the class “TAPE”. 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. In this case, the value is taken from the HSMS-specific parameters of the SF pubset environment.
SYSBACKUP =
Defines the default backup archive for the SM pubset. The default backup archive is created with the following attributes:
USER-ACCESS=*ALL-USERS(ACCESS=*READ),RETENTION-PERIOD=32, SAVE-FILE-STRUCTURE=*SEVERAL-SVID.
If these presettings are unsuitable for your purposes, you can:
change them with the MODIFY-ARCHIVE-ATTRIBUTES statement or
later create an archive using the CREATE-ARCHIVE statement and assign it the system backup archive of the SM pubset with MODIFY-SM-PUBSET-PARAMETERS.
If an error occurs during creation of the archive, a warning is output although the processing is continued.
SYSBACKUP = *UNDEFINED
No default backup archive is defined for the SM pubset.
SYSBACKUP = *PARAMETERS(...)
Defines the parameters for the default backup archive. The default backup archive is created with the attribute USER-ACCESS=*ALL-USERS(ACCESS=*READ) during conversion of the SM pubset.
ARCHIVE-NAME =
Defines the name of the archive.
ARCHIVE-NAME = *DEFAULT-NAME
The backup archive is created with the default attribute values. It is given the default name :cat-id:HSMS.STD.BA.
ARCHIVE-NAME = <filename 1..22 without-cat-gen-vers>
The default archive is given an explicit name which is local for the SM pubset.
DIRECTORY-NAME =
The name of the archive directory is defined for the specified archive.
DIRECTORY-NAME = *DEFAULT-NAME
A default archive directory is assigned with the name :cat-id:HSMS.DIR.BA.
DIRECTORY-NAME = <filename 1..54 without-gen-vers>(...)
The archive directory is given an explicit name. The specified file may be cataloged, but must be empty. The catalog ID of the archive directory name must be the SM pubset ID.
NEW-DIRECTORY = *YES
The specified archive directory is created for the definition of the archive.
NEW-DIRECTORY = *NO
An existing archive directory is used for the definition of the archive.
SYSARCHIVE =
Defines the default long-term archive for the SM pubset.
If the long-term archive is defined in the SF pubset environment, it must already exist.
For an SM pubset environment the default long-term archive is created with the following attributes:
USER-ACCESS=*ALL-USERS(ACCESS=*READ),RETENTION-PERIOD=32,SAVE-FILE-STRUCTURE=*SEVERAL-SVID.
If these presettings are unsuitable for your purposes, you can:
change them with the MODIFY-ARCHIVE-ATTRIBUTES statement or
later create an archive using the CREATE-ARCHIVE statement and assign it to the system long-term archive of the SM pubset with MODIFY-SM-PUBSET-PARAMETERS.
If an error occurs during creation of the archive, a warning is output although the processing is continued.
SYSARCHIVE = *STD
Points to the system archive that is defined in the global HSMS parameters.
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 long-term archive is created during conversion of the SM pubset.
ARCHIVE-NAME =
Defines the name of the archive.
ARCHIVE-NAME = *DEFAULT-NAME
The long-term archive is given the default name :environment cat-id:HSMS.STD.AR.
ARCHIVE-NAME = <filename 1..22 without-cat-gen-vers>
The default archive is given an explicit name.
DIRECTORY-NAME =
Defines the name of the archive directory. This operand is pointless:
in an SF pubset environment, because the archive must already exist.
in an SM pubset environment, if the specified archive already exists.
DIRECTORY-NAME = *DEFAULT-NAME
With an SM pubset a default archive directory called :environment cat-id:HSMS.DIR.AR is assigned.
With an SF pubset this value represents the archive directory that is already assigned to the archive.
DIRECTORY-NAME = <filename 1..54 without-gen-vers>(...)
With an SF pubset this value is ignored.
With an SM pubset the archive directory assigned to the archive is given an explicit name. The specified file may be cataloged, but must be empty. The catalog ID of the archive directory name must be the SM pubset ID.
NEW-DIRECTORY = *YES
The specified archive directory is created for the definition of the archive.
NEW-DIRECTORY = *NO
An existing archive directory is used for the definition of the archive.
SYSMIGRATE =
The default migration archive is defined for the SM pubset.
SYSMIGRATE = *UNDEFINED
No default migration archive is defined for the SM pubset.
SYSMIGRATE = *PARAMETERS(...)
Defines the parameters for the default migration archive which is created with the following attributes:
USER-ACCESS=*ALL-USERS(ACCESS=*READ),RETENTION-PERIOD=32,SAVE-FILE-STRUCTURE=*SEVERAL-SVID.
If these presettings are unsuitable for your purposes, you can:
change them with the MODIFY-ARCHIVE-ATTRIBUTES statement or
later create an archive using the CREATE-ARCHIVE statement and assign it the system backup archive of the SM pubset with MODIFY-SM-PUBSET-PARAMETERS.
If an error occurs during creation of the archive, a warning is output although the processing is continued.
ARCHIVE-NAME =
Defines the archive name.
ARCHIVE-NAME = *DEFAULT-NAME
A migration archive is created with the default attribute values. It is given the default name :cat-id:HSMS.STD.MI.
ARCHIVE-NAME = <filename 1..22 without-cat-gen-vers>
The default archive is given an explicit name which is local for the SM pubset.
DIRECTORY-NAME =
The name of the archive directory is defined for the specified archive.
DIRECTORY-NAME = *DEFAULT-NAME
A default archive directory is assigned with the name :cat-id:HSMS.DIR.MI.
DIRECTORY-NAME = <filename 1..54 without-gen-vers>(...)
The archive directory is given an explicit name. The specified file may be cataloged, but must be empty. The catalog ID of the archive directory name must be the SM pubset ID.
NEW-DIRECTORY = *YES
The specified archive directory is created for the definition of the archive.
NEW-DIRECTORY = *NO
An existing archive directory is used for the definition of the archive.
SYSNODEBACKUP =
Defines the default archive for node backup of a BS2000-UFS (POSIX) or node S0 for the SM pubset. It is created with the following attributes:
USER-ACCESS=*ALL-USERS(ACCESS=*READ),RETENTION-PERIOD=32,SAVE-FILE-STRUCTURE=*SEVERAL-SVID.
If these presettings are unsuitable for your purposes, you can:
change them using the MODIFY-ARCHIVE-ATTRIBUTES statement or
later create an archive using the CREATE-ARCHIVE statement and assign this archive to the system archive for node backup of SM pubsets using the MODIFY-SM-PUBSET-PARAMETERS.
If an error occurs during creation of the archive, a warning is output but the processing is continued.
SYSNODEBACKUP = *UNDEFINED
No default archive for node backup of a BS2000-UFS (POSIX) or node S0 is defined for the SM pubset.
SYSNODEBACKUP = *PARAMETERS(...)
Defines the parameters for the default archive for node backup of a BS2000-UFS (POSIX) or node S0. It is created with the attributes USER-ACCESS=*ALL-USERS(ACCESS=*READ) during conversion of the SM pubset.
ARCHIVE-NAME =
Defines the name of the archive.
ARCHIVE-NAME = *DEFAULT-NAME
The node backup archive is created with the default attribute values. It is given the default name :cat-id:HSMS.STD.NB.
ARCHIVE-NAME = <filename 1..22 without-cat-gen-vers>
The default archive is given an explicit name which is local for the SM pubset.
DIRECTORY-NAME =
The name of the archive directory is defined for the specified archive.
DIRECTORY-NAME = *DEFAULT-NAME
A default archive directory with the name :cat-id:HSMS.DIR.NB is assigned.
DIRECTORY-NAME = <filename 1..54 without-gen-vers>(...)
The archive directory is given an explicit name. The specified file may be cataloged, but must be empty. The catalog ID of the archive directory name must be the SM pubset ID.
NEW-DIRECTORY = *YES
The specified archive directory is created for the definition of the archive.
NEW-DIRECTORY = *NO
An existing archive directory is used for the definition of the archive.
SYSNODEARCHIVE =
Defines the default long-term archive for node archival of a BS2000-UFS (POSIX) or node S0 for the SM pubset. It is created with the following attributes: USER-ACCESS=*ALL-USERS(ACCESS=*READ),RETENTION-PERIOD=32,SAVE-FILE-STRUCTURE=*SEVERAL-SVID.
If these presettings are unsuitable for your purposes, you can:
change them using the MODIFY-ARCHIVE-ATTRIBUTES statement or
later create an archive using the CREATE-ARCHIVE statement and assign it the system long-term archive for nodes of the SM pubset using MODIFY-SM-PUBSET-PARAMETERS.
If an error occurs during creation of the archive, a warning will be output, but processing is continued.
SYSNODEARCHIVE = *UNDEFINED
No default long-term archive for node archival of a BS2000-UFS (POSIX) or node S0 is defined for the SM pubset.
SYSNODEARCHIVE = *PARAMETERS(...)
Defines the parameters for the default long-term archive for node archival of a BS2000-UFS (POSIX) or node S0. It is created during the conversion of the SM pubset with the following attributes: USER-ACCESS=*ALL-USERS(ACCESS=*READ).
ARCHIVE-NAME =
Defines the name of the archive.
ARCHIVE-NAME = *DEFAULT-NAME
The long-term archive for nodes is created with the default attribute values. It is given the default name :cat-id:HSMS.STD.NA.
ARCHIVE-NAME = <filename 1..22 without-cat-gen-vers>
The default archive is given an explicit name which is local for the SM pubset.
DIRECTORY-NAME =
The name of the archive directory is defined for the specified archive.
DIRECTORY-NAME = *DEFAULT-NAME
A default archive directory is assigned with the name :cat-id:HSMS.DIR.NA.
DIRECTORY-NAME = <filename 1..54 without-gen-vers>(...)
The archive directory is given an explicit name. The specified archive directory may be cataloged, but must be empty. The catalog ID of the archive directory must be the SM pubset ID.
NEW-DIRECTORY = *YES
The specified archive directory is created for the definition of the archive.
NEW-DIRECTORY = *NO
An existing archive directory is used for the definition of the archive.
SYSVERSION =
Defines the default version backup archive for the SM pubset. The default version backup archive is created with the following attributes: USER-ACCESS=*ALL-USERS(ACCESS=*READ),RETENTION-PERIOD=32,SAVE-FILE-STRUCTURE=*SEVERAL-SVID.
If these presettings are unsuitable for your purposes, you can:
change them using the MODIFY-ARCHIVE-ATTRIBUTES statement or
later create an archive using the CREATE-ARCHIVE statement and assign it the system version backup archive of the SM pubset with MODIFY-SM-PUBSET-PARAMETERS.
If an error occurs during creation of the archive, a warning will be output, but processing is continued.
SYSVERSION = *UNDEFINED
No default version backup archive is defined for the SM pubset.
SYSVERSION = *PARAMETERS(...)
Defines the parameters for the default version backup archive. The default version backup archive is created during the conversion of the SM pubset with the following attributes: USER-ACCESS=*ALL-USERS(ACCESS=*READ).
ARCHIVE-NAME =
Defines the name of the archive.
ARCHIVE-NAME = *DEFAULT-NAME
The version backup archive is created with the default attribute values. It is given the default name :cat-id:HSMS.STD.VE.
ARCHIVE-NAME = <filename 1..22 without-cat-gen-vers>
The default archive is given an explicit name which is local for the SM pubset.
DIRECTORY-NAME =
The name of the archive directory is defined for the specified archive.
DIRECTORY-NAME = *DEFAULT-NAME
A default archive directory is assigned with the name :cat-id:HSMS.DIR.VE.
DIRECTORY-NAME = <filename 1..54 without-gen-vers>(...)
The archive directory is given an explicit name. The specified archive directory may be cataloged, but must be empty. The catalog ID of the archive directory must be the SM pubset ID.
NEW-DIRECTORY = *YES
The specified archive directory is created for the definition of the archive.
NEW-DIRECTORY = *NO
An existing archive directory is used for the definition of the archive.
MIGRATION-CONTROL =
The parameters are defined for the migration control.
MIGRATION-CONTROL = *STD
All the default values are used.
MIGRATION-CONTROL = *PARAMETERS(...)
MIGRATION =
Defines whether and to which extent nonprivileged users may migrate files from this pubset.
MIGRATION = *ALLOWED
Nonprivileged users can migrate files from this pubset without restrictions.
MIGRATION = *S2-ONLY
Nonprivileged users may migrate files from S0 to S2 only.
MIGRATION = *INHIBITED
Only the HSMS administrator may migrate files from this pubset. Migration is not permitted for any other user.
BACKUP-MANDATORY = *YES / *NO
*YES prohibits the migration of files, which have not yet been saved (apart from those in backup class E). *NO allows it.
EXCEPT-FILE = *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. The except file must be a SAM file with variable-length records which contains a path name in each record. It can be created, for example, using the HSMS statement SELECT-FILE-NAMES or the BS2000 command SHOW-FILE-ATTRIBUTES. The except file must be on the SM pubset.
FILE-INHIBIT =
Defines whether the migration inhibits that have been set by the user are 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. In this case, the value is taken from the HSMS-specific parameters of the SF environment.
FILE-INHIBIT = *RESPECTED
Migration inhibits set by the user are respected. The files concerned are not migrated.
FILE-INHIBIT = *IGNORED
Migration inhibits set by the user are ignored. The files concerned are migrated.