Previous Topic: Deleting Expired Data SetsNext Topic: Deleting Expired Volumes

FILES Maintenance › IXMAINT Utility General Information › DSNDELETE Command

DSNDELETE Command

The DSNDELETE command syntax is:

DSNDELETE SIMULATE,DSNAMES=,VOLUMES=,COPIES=,DATE=,LIST=,SCRATCH=,DELPROF=,SMSNOSMS,PRIMARY2=, NOVALIDATE
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.

DSNAMES=

This optional parameter indicates that processing is to be limited to the data set names and patterns specified in the supplied list. From 1 to 20 entries can be supplied.

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.

Note: Sysparm IXMCLEAN can increase the number of volumes selected for processing. The purpose of this sysparm (described in IXMCLEANy in the Systems Guide) is to cleanup broken chains between ARCHVOLS and DSNINDEX records. So even you restrict the number of volumes to be selected by specifying VOLUMES= on your command, IXMCLEAN will add to this list any unchained ARCHVOL.

COPIES=

This optional parameter can be defined 1-9999 to indicate that this number of versions of each data set is to be maintained in the archives. For example, if COPIES=3 was specified, all but the three most current unexpired versions of a data set are to be deleted from the archives, regardless of their expiration dates.

Note: GDG data set names are not considered special for this support. For the example given, the three most current versions of each DSN.GxxxxVyy-named data set will be kept.

A version is determined by the data set name and original volume of a data set. If multiple copies of a data set are archived on the same date they are considered one version of the data set. Member level backups, described in the section Member Level Backup in the chapter "Backup/Archive", are not counted as a copy under this process.

For additional information on other processing options, see the keyword parameter SMSNOSMS, and the sysparm descriptions for DSNDUPVLn and IXMDUPDTn in the Systems Guide.

DATE=YYDDD

This parameter can specify a date in any accepted CA Disk format to be used as the 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 all DSNINDEX records that point to it have been deleted and the ARCHVOLS record is being deleted as a result. SCRATCH=YES is the default. SCRATCH=NO will keep the archive data set on disk even though there are no more DSNINDEX records and 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.

SMSNOSMS

Normally, the DSNDELETE command manages SMS and non-SMS DSNINDEX records quite differently. SMS DSNINDEX records are managed according to their Management Class attributes, whereas non-SMS records are managed by the combination of their expiration date and any DSNDELETE parameters. This parameter causes all DSNINDEX records to be managed as non-SMS.

Note: This keyword parameter is only valid when used with the COPIES= parameter. For details, see COPIES=.

For example, to cause all DSNINDEX records (SMS and non‑SMS) to be reduced to 2 copies each, execute the following command:

DSNDELETE COPIES=2,SMSNOSMS

PRIMARY2=

This optional parameter indicates whether processing is to be limited by type of DSNINDEX record. PRIMARY2=YES is the default which indicates all DSNINDEX record types are processed. PRIMARY2=NO will keep PRIMARY2 type DSNINDEX records from being processed even though they may be expired. PRIMARY2=ONLY will cause only PRIMARY2 type DSNINDEX records to be processed.

NOVALIDATE

This optional parameter indicates that validation of the DSNINDEX and ARCHVOLS subfiles for and 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.