This statement is used for deleting an archive definition from the HSMS control file. Only the archive definition is deleted; the archive directory and the save files managed in the archive are retained.
Only the HSMS administrator and the archive owner are authorized to delete a record.
If an archive linked with the shadow archive is deleted, the shadow archive is also deleted.
If the statement is issued for a shadow archive, the following functions are available (SHADOW-FUNCTION operand):
Default: The shadow archive is deleted and the connection between the shadow archive and the associated backup or long-term archive is cancelled.
The shadow archive is deleted and the archive directory of the shadow archive replaces the archive directory of the associated backup or long-term archive.
Only the connection to the associated backup or long-term archive is cancelled and the shadow archive becomes an independent archive.
This statement has the same format for nonprivileged users and HSMS administrators.
Format
DELETE-ARCHIVE | Alias: DLA | ||||||||||||||||||||
| |||||||||||||||||||||
ARCHIVE-NAME = <filename 1..22 without-cat-gen-vers>
Name of the archive to be deleted. The archive is only deleted if all the requests in the request file in the same environment have been completed.
Note
If references still exist to a deleted archive for migrated files or in SM pubset parameters (SYSARCHIVE, SYSBACKUP, SYSMIGRATE, etc.), inconsistencies may occur. It is therefore essential to remove such references.
ENVIRONMENT =
Determines the HSMS environment in which the specified archive is located.
ENVIRONMENT = *STD
The archive is located in the default environment for the DMS archive:
For privileged users: *STD is set to the value *SINGLE-FEATURE.
For nonprivileged users: *STD is the environment that is associated with the user’s default pubset (the default pubset is defined in the user catalog).
ENVIRONMENT = *NODE-STD
The archive is located in the default archive for node archives:
For privileged users: *NODE-STD is set to the value *SINGLE-FEATURE.
For nonprivileged users: *NODE-STD is set to the value of the environment in which the home directory of the user is defined.
ENVIRONMENT = *SINGLE-FEATURE
The archive is located in the SF environment.
ENVIRONMENT = *SYSTEM-MANAGED(...)
The archive is located in the specified SM pubset environment.
CATALOG-ID = <cat-id>
Catalog ID of the SM pubset for which the HSMS statement is valid.
SHADOW-FUNCTION =
For shadow archives, provides further functions in addition to deleting.
SHADOW-FUNCTION = *DELETE
The shadow archive is deleted and the connection between the shadow archive and the associated backup or long-term archive is cancelled.
SHADOW-FUNCTION = *REPLACE-ORIGINAL
The shadow archive is deleted and the archive directory of the shadow directory replaces the archive directory of the associated backup or long-term archive.
SHADOW-FUNCTION = *SEPARATE-SHADOW
Only the connection to the associated backup or long-term archive is cancelled and the shadow archive becomes an independent archive.