Previous Topic: Purging Archive Data Sets/VolumesNext Topic: SMS and IXMAINT

FILES Maintenance › IXMAINT Utility General Information › PURGE Command

PURGE Command

The PURGE command syntax is:

PURGE SIMULATE,VOLUMES=,DSNAMES=,LIST=,SCRATCH=,DELPROF=,NOVALIDATE,FORCE
SIMULATE

This optional parameter causes messages to be issued as if processing has taken place, but no updates to the archive index will be performed.

VOLUMES=

This parameter is required if the DSNAMES parameter is not specified; otherwise it is optional.

This optional parameter indicates that processing is to be limited to the volumes specified in the supplied list. The list should consist of primary volumes only, not copy volumes. Any copy volume that is listed will be ignored. Copy volumes and multivolume chains are automatically removed when their associated primary volumes are purged. 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.

Note: To remove a copy volume without removing the primary, use the IXUPDATE RESET command with COPY=NULL, or purge and rebuild the primary volume.

DSNAMES=

This optional parameter (required only if the VOLUMES parameter is not specified) indicates that processing is to be limited to the names specified in the supplied list. From 1 to 20 data set names, prefixes, or patterns can be entered. The names see DSNINDEX entries to be purged, not to ARCHVOLS entries.

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=NO is the default. SCRATCH=YES will scratch the archive data set from disk after the ARCHVOLS record has been 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=NO is the default for PURGE, which will keep the discrete profile even though the DSNINDEX record is being deleted. DELPROF=YES causes discrete profiles to be deleted along with the index records.

NOVALIDATE

This optional parameter indicates that validation of the DSNINDEX and ARCHVOLS subfiles will not be done. By default, IXMAINT confirms the integrity of index and data address pointers as well key sequence within the Files Data Set 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 Files Data Set Processing section of the Systems Guide for instructions on Files Data Set recovery.

FORCE

This optional parameter should be used when the archive volume being purged has been flagged as containing FAST Archive entries. FORCE is needed to prevent the unintentional deletion of the FAST Archive entries.