Previous Topic: Deleting Expired VolumesNext Topic: Purging Archive Data Sets/Volumes


VOLDELETE Command

The VOLDELETE command syntax is:

DSNDELETE
VOLDELETE SIMULATE,VOLUMES=,EXPDSNS,DATE=,LIST=,SCRATCH=,DELPROF=,NONVALIDATE
SIMULATE

This optional parameter indicates that the execution is to be simulated. Messages will be issued as if processing has taken place, but no updates to the archive index will be performed.

VOLUMES=

This optional parameter indicates that processing is to be limited to the volumes specified in the supplied list. For archive data sets on disk (rather than tape), this list consists of the CA Disk-generated keys rather than the actual volumes. From 1 to 40 volume serial numbers, prefixes, or patterns can be supplied.

EXPDSNS

This optional parameter indicates that in addition to expired volumes, all expired data sets are also to be deleted, regardless of their presence on an unexpired volume. Specifying this parameter is equivalent to running DSNDELETE VOL=/,DSN=/ before running VOLDELETE. That is, all expired DSNINDEX records encountered during processing will be deleted regardless of what ARCHVOLS record they point to. In addition, if all DSNINDEX records pointing to a given ARCHVOLS record are deleted, the ARCHVOLS records will also be deleted. This can be confusing in that if this occurs, it is possible that an ARCHVOLS record can be deleted that was not specified on the VOLDELETE command of this job.

Note: This parameter does not process SMS-managed data sets.

DATE=

This parameter can specify a date in any accepted CA Disk format to be used as the current date (instead of the real current date) whenever date comparisons are made.

LIST=

Normally a message is printed for each data set deleted from the archives. If you want to suppress the messages, use this parameter. LIST=NONE will suppress all messages. ALL is the default.

SCRATCH=

This keyword parameter tells CA Disk whether or not to scratch the archive data set on disk when the ARCHVOLS record is being deleted. SCRATCH=YES is the default. SCRATCH=NO will keep the archive data set on disk even though the ARCHVOLS record is being deleted.

DELPROF=

This keyword parameter tells CA Disk whether or not to delete the discrete RACF profile associated with a DSNINDEX record being deleted. (This is the discrete profile that CA Disk created and saved when the DSNINDEX record was built. Generic profiles are not touched, regardless of the value of this parameter.) DELPROF=YES is the default. DELPROF=NO will keep the discrete profile even though the DSNINDEX record is being deleted.

NOVALIDATE

This optional parameter indicates that validation of the DSNINDEX and ARCHVOLS subfiles for an FDS will not be done. By default, IXMAINT confirms the integrity of index and data address pointers as well key sequence within the FDS for the DSNINDEX and ARCHVOLS subfiles before proceeding to delete records. If a pointer is in error indicating some sort of data set corruption has occurred, processing will be terminated with a user abend code U100 to ensure the corruption is noticed by those running the system. If the abend occurs, see the FDS Processing section of the Systems Guide for instructions on FDS recovery.