Explanation
An HBDELETE or BDELETE command was issued to delete
one or more backup versions of data set
dsname.
When the failure is due to a security check and either more than one
version exists for a cataloged data set, or there are multiple versions
for an uncataloged data set from the same volume, the message is issued
once. The values for
return-code are:
- Retcode
- Meaning
- 2
- The migration control data set data set record (MCD) for the data
set is found in the migration control data set (MCDS), but the MCD
record does not indicate the data set is migrated.
- 3
- MIGRAT is returned as the volume serial of the volume where the
data set resides, but no MCD record is found in the MCDS.
- 14
- An error is detected while obtaining VSAM data set information.
The meanings for
reason-code are:
- Code
- Meaning
- 5
- An attempt was made to backup a GDG base entry. The data set is
only an entry in the catalog and not a cataloged data set.
- 6
- There is an error in a catalog entry for a non-VSAM data set.
- 9
- Unsupported data set for BACKUP. The catalog entry shows the VSAM
data set is a non-SMS-managed data set defined with key ranges.
- 10
- The catalog entry indicates that the data set is a multivolume
data set. If the data set is VSAM, it is not an SMS-managed data set,
and one component is multivolume.
- 11
- Unsupported data set for backup. The catalog entry shows at least
one AIX® defined with key ranges
and the base cluster is not defined with key ranges.
- 12
- The components of the non-SMS-managed VSAM cluster are on different
volumes.
- 14
- The catalog entry is not a VSAM base cluster or a non-VSAM data
set; the catalog entry is a VSAM page space, or a LOCATE error occurred
for the data set name.
- 15
- A component of the VSAM data set has a logical record length that
is too large for DFSMShsm.
The maximum allowable logical record length is 32,752 bytes for a
relative record data set and 32,756 bytes for an entry-sequenced or
key-sequenced data set.
- 16
- A component of the VSAM data set is open for output.
- 18
- A LOCATE error occurred for the data or index component of the
VSAM base cluster.
- 19
- A LOCATE error occurred for the path component of the VSAM base
cluster.
- 20
- The data set name is a VSAM component name instead of a cluster
name.
- 24
- The catalog entry indicates that the data set is a non-VSAM multivolume
data set. The data set’s volser list also
indicates multiple volumes.
- 28
- A LOCATE error occurred for a VSAM AIX* (alternate index) cluster.
- 38
- A LOCATE error occurred for the data or index component of the
VSAM AIX cluster.
- 39
- A LOCATE error occurred for the path component of the VSAM AIX cluster.
- 40
- At least one component of the VSAM data set is empty.
- 42
- One or more retained copies exist for data set dsname.
Active and retained backup copies of this data set can only be deleted
on a z/OS® V1R11 or later system.
- 52
- a GETMAIN error occurred during the process of getting the catalog
information about a VSAM data set.
- 20
- An ARCBZKEY error has occurred obtaining the key for the BCDS
Z record. See additional information in previously issued TRAP message.
- 22
- Password check fails. The reason-code 8 indicates
the password is not specified or the password is incorrectly specified.
- 30
- Check fails on allocation authority. The user does not have allocation
authority, because a RACF® generic
profile exists for the data set and it denies access to the user.
- 32
- The backup version for deletion is the most recent backup version
of a retired data set. The backup version is not deleted unless the
VERSION parameter and the version number of the retired version are
specified, or the DATE and TIME parameters and the date and time when
the retired version was created are specified.
- 39
- RACF check fails. The reason-code is
the return code from ARCRACF.For
the meanings of reason-code, see Table 16.
System action
DFSMShsm processing continues.
System programmer response
Programmer response
If it is necessary to delete backup versions
of data sets for which you do not have the required level of access,
notify the storage administrator or system programmer for assistance. For RETURN CODE=42, reissue the BDELETE command on a z/OS V1R11 or later system.