DELETE control statement

The DELETE control statement specifies qualifiers to select which fault entries should be deleted.

Read syntax diagramSkip visual syntax diagram
Syntax

                .-& or |----------------------------------.        
                V                                         |        
>>-DELETE--(--+---+-ABEND_DATE--+->-+--+-yyyy/mm/dd-+---+-+-+--)-><
              |   |             +-<-+  '-TODAY-days-'   |   |      
              |   |             '-=-'                   |   |      
              |   '-+-USER_ID-------------+--=--literal-'   |      
              |     +-ABEND_CODE----------+                 |      
              |     +-JOB_NAME------------+                 |      
              |     '-CICS_TRANSACTION_ID-'                 |      
              +-UTILIZATION--=--percent---------------------+      
              '-ALL-----------------------------------------'      

Description: DELETE(ALL)

The DELETE(ALL) control statement is used to delete all fault entries in the history files that were specified unconditionally in a prior FILES control statement. The fault entries are deleted regardless of any lock flag setting and no user exit is called.

Run HFZUTIL with DELETE(ALL) against a history file before the history file itself is deleted to ensure that all associated dump data sets (such as RFR or XDUMP) are also deleted. If this is not done, orphaned dump data sets might be left allocated if the history file is deleted.

Important: When using this control statement, the user ID under which HFZUTIL is running must have ALTER data set security access to the history files specified. XFACILIT access is not sufficient.

Description: Other than DELETE(ALL)

With the exception of DELETE(ALL), the HFZUTIL DELETE function should only be used for PDS history files. PDSE history files (which we recommend are used) should use automatic space management. For information about automatic space management, see AUTO-managed PDSE history files.

Note: Deletion of a locked fault entry is only possible when overriding the default action using the HFZUTIL Delete user exit. For more information about HFZUTIL Delete user exit specification and usage, see EXITS control statement. For general information about the lock flag, and how to change its value prior to running the HFZUTIL batch utility, see Viewing fault entry information.

The UTILIZATION qualifier can be used to delete entries, starting with the oldest entry, until the specified percentage of utilization is reached. This qualifier is only available for PDSE history files. UTILIZATION cannot be qualified with extra & or | operators, it must be the only operator in the DELETE statement when used. It can be preceded or followed by any other DELETE statements.

Note: When using the UTILIZATION qualifier, HFZUTIL attempts to delete usage back to the specified percentage full at the time of running HFZUTIL. It is not a way of telling Z Abend Investigator to maintain the usage at the specified percentage as new fault entries are created. PDSE history files are by default AUTO-managed and use the existing data set extents as much as possible, without allocating more extents.

The remaining qualifiers follow the same rules as the LISTHF qualifiers above.

The HFZUTIL Delete user exit can be used with the DELETE control statement to further select the history file entries that should be deleted. See HFZUTIL Delete user exit.

Examples of using the DELETE control statement are provided in Example 2. Deleting history file entries by date and Example 3. Deleting history file entries by utilization.