Programming interface information
Programming interface information
If installation exits ARCSKEXT and
ARCCREXT have been previously link-edited and if the SETSYS EXITON(ARCSKEXT)
and SETSYS EXITON(ARCCREXT) commands have been issued (you can use
the QUERY SETSYS command to display the status of these exits), ARCSKEXT
and ARCCREXT are called during aggregate recovery verification. Installation
exit ARCSKEXT is called for each data set to be recovered, allowing
you to specify if that data set should be skipped or included in the
aggregate recovery.
Installation exit ARCCREXT is called whenever
a data set naming conflict is detected. This exit allows you to specify
that the data set is to be:
- Skipped—The data sets are not recovered.
- Renamed—You give the source data sets on the data file new names.
Data sets must not already exist with the new names you specify.
The rename process does not apply to migrated VSAM data sets. If
you specify that a migrated VSAM data set should be renamed, it is
skipped.
Note: DFSMSdss renaming of a VSAM sphere does not cause
any alternate indexes to be renamed. If a data set naming conflict
exists for alternate indexes, the alternate indices are not recovered.
- Replaced—The like-named data sets at the recovery site are replaced
with the corresponding aggregate backup data sets. (This is the same
result as if you had specified the DSCONFLICT(REPLACE) parameter on
the ARECOVER command.)
Note: When using the DSCONFLICT(REPLACE) parameter,
the data set is deleted before attempting the recovery of the data
set from the aggregate backup output files. If the recovery fails,
the data set remains deleted. Causes of recovery failure include:
- I/O errors on the input tape
- Failure to allocate the new data set
- Recovering at a site that does not support the type of data set
being recovered
- Renamed target—The like-named target data sets at the recovery
site are renamed using the new high-level qualifier specified. This
is similar to the use of the DSCONFLICT RENAMETARGET(level)
parameter.
If installation exit ARCTVEXT has been previously link-edited
and if the SETSYS EXITON(ARCTVEXT) command has been issued (you can
use the QUERY SETSYS command to display the status of this exit),
ARCTVEXT is called during aggregate recovery. This exit is called
when rolling off old ABARS versions to indicate to tape management
systems, excluding DFSMSrmm, that ABARS is expiring a tape volume.
End of programming interface information
End of programming interface information