SVTSUTIL Batch Commands › SVTSUTIL Batch Commands › LDS_DELETE

LDS_DELETE

This command is used when running the SVTSUTIL program to delete static cache LDSs. The command performs the following function:

• Remove static cache LDS entries from the Global VCAT and delete them from the DASD buffer, if they are defined
• Create LDS Define and LDS Initialization control statements to recover the cache LDSs that were deleted by the utility
• Provide reports and analysis of the DASD buffer

Syntax

LDS_DELETE   [SIMulate|LIVE],
             [CACHE_VOLUME={*|/|volser
                               |(volser1,volser2,…,volsern)}
                               |vol*|vol/}],
             [CLEAN_NOT_ALLOC],
             [RELEASE_TARGET_PERCENT=nnn%],
             [CLEAN_INELIGIBLE_ONLY]

The optional SIMULATE parameter can be used to invoke all functions of the LDS_Delete utility without updating the GLOBAL VCAT or deleting the LDSs from the DASD buffer. SIMULATE can be abbreviated to SIM and is the default value.

Note: If the UTLWK03 DD is changed to a SYSOUT or a data set, you can view the IDCAMS DELETE commands generated by the utility for the LDSs processed.

The optional LIVE parameter removes the LDS entries from the GLOBAL VCAT and deletes the LDSs from the DASD buffer.

Note: The UTLWK03 file must be allocated to a DASD data set during LIVE operation mode in order for the generated IDCAMS statements to be processed.

You can use the CACHE_VOLUME parameter to identify the DASD buffer volume or volumes to be processed. A single VOLSER, a list of VOLSERs enclosed in parentheses, a VOLSER prefix (for example, vol* or vol/), or an asterisk (*) or a forward slash (/) for all VOLSERs can be coded. The parameter can be abbreviated to CV and can be defined more than once to define several DASD Buffer volumes (for example, CV=volser1,CV=volser2).

Note: If the CLEAN_INELIGIBLE_ONLY parameter is coded, the CACHE_VOLUME parameter is ignored.

The optional CLEAN_NOT_ALLOC parameter is used to delete LDSs that are defined on DASD, but have not been added to the Global VCAT being processed. The LDS_DELETE command will process these orphan LDSs in addition to the LDSs that were added to the Global VCAT being processed. This parameter should not be used in an environment where multiple CA Vtape Complexes are defined with the same DSN PREFIX. The parameter can be abbreviated to CNA.

Note: The CLEAN_NOT_ALLOC parameter is mutually exclusive with the CLEAN_INELIGIBLE_ONLY parameter.

The RELEASE_TARGET_PERCENT parameter defines the maximum percentage of the total DASD buffer to delete. A specification of 100% permits LDS_DELETE to delete 100% of the DASD buffer. The parameter can be abbreviated to RTP.

Note: The percentage coded is converted to a number of LDSs and establishes the maximum number of LDSs that can be deleted.

The optional CLEAN_INELIGIBLE_ONLY parameter is used to delete LDSs that have been marked ineligible for allocation in the Global VCAT and which are either uncataloged or contain invalid control information. The parameter can be abbreviated to CIO.

Note: The CLEAN_INELIGIBLE_ONLY parameter specification is mutually exclusive with the CLEAN_NOT_ALLOC parameter.

Sample JCL can be found in PREFIX.CCUUJCL(LDSDELT).