Each archive is created by means of the HSMS statement CREATE-ARCHIVE. The archive definition, including all its attributes, is stored in the HSMS control file, which also includes the name of the archive directory.
The HSMS control file depends on the environment in which the archive is defined:
For an SF pubset environment, it is the central HSMS control file.
For an SM pubset environment, it is the control file of the SM pubset.
During creation the archive must be given a name. The archive name has the format of a file name but must not have more than 12 characters. In addition to the name, the archive is assigned an owner ID.
The HSMS administrator can specify an owner ID explicitly. If no owner ID is specified, the default owner ID is SYSHSMS, regardless of the user ID involved.
An archive can be addressed in HSMS statements by specifying its owner ID and archive name in the following form:
[$owner-id.]archivename
Archives in which shared SF pubsets are managed, should be set up in such a way that a separate archive is created for each shared pubset. The archive must have a directory file on the respective shared pubset and the archive definition must be identical on all servers. A request issued for a shared pubset imported in slave mode can only be processed if only pubsets assigned to the same master computer will be affected by this request.
In the case of shared SM pubsets, the directory files for backup, migration and archival are automatically stored in an SM environment on the SM pubset itself. Therefore, with SM pubsets HSMS automatically guarantees the coherence of the archive definitions for backup and migration.
The HSMS statement CREATE-ARCHIVE also serves to define the archive attributes. These can be modified after creation by means of the HSMS statement MODIFY-ARCHIVE-ATTRIBUTES.
The owner of an archive can request information about its attributes by means of the HSMS statement SHOW-ARCHIVE-ATTRIBUTES.
From HSMS V8.0 the archive attributes are also stored in the directory file in the case of CREATE-ARCHIVE or MODIFY-ARCHIVE-ATTRIBUTES. If the archive definition is lost the attributes can be restored from the directory file using CREATE-ARCHIVE (see “Restoring an inadvertently deleted archive definition” in chapter "Deleting archive definitions").
MODIFY-ARCHIVE-ATTRIBUTES can be used to change the catalog ID of the archive directory accordingly when the pubset has been renamed.