Description

A DELETE_ENTRYLIST request allows you to delete multiple entries that are designated in an entry list contained in the storage area specified by BUFLIST or BUFFER. To designate the entries to be deleted, put either their entry identifier or entry name into the buffer (BUFFER) or buffer list buffers(BUFLIST). The LISTTYPE parameter indicates how the entries to be deleted are listed in the buffer. They may be listed by either entry identifier or by entry name, but not a combination of the two.

You can also request that a subset of the entries identified in the entry list be deleted by specifying the indexes into the entry list identifying the entries with which processing should begin (FIRSTELEM) and end (LASTELEM).

You can also restrict processing to only those entries that satisfy either one or both of the following criteria:

Reside on a certain list (which you specify using LISTNUM)
Contain data that satisfies a version number comparison (which you specify using VERSCOMP).

If you do not specify either LISTNUM or VERSCOMP, every entry between FIRSTELEM and LASTELEM will be deleted.

With a coupling facility of CFLEVEL=1 or higher, you can further restrict processing to only those entries that satisfy the following additional criteria:

A successful comparison of the list authority value for the target list with a user-specified value. You specify the list authority comparison requirements using AUTHCOMP and AUTHCOMPTYPE.
A successful comparison of the entry key value with a user-specified value (KEYCOMP). If the comparison is not successful, the current list entry is not deleted and processing continues with the next entry to be considered.
An successful comparison of the version number, which is enhanced to allow for an additional equal-or-less-than-equal comparison operation.

When the DELETE_ENTRYLIST request completes, the number of deleted entries is returned in the answer area (ANSAREA).

When an entry identified in the entry list does not exist, or does not exist with the indicated version number and/or list number, processing is halted and the index of the failing entry is returned in the answer area. All the entries on the list preceding this entry are deleted; all succeeding entries have not yet been deleted. To continue processing, update FIRSTELEM and reissue the macro.

If the request completes prematurely because it exceeds the model-dependent time-out criteria, the number of deleted entries thus far and the index of the next entry to be deleted is returned in the answer area. You can update FIRSTELEM to this returned index (LAAFAILINDEX) on a subsequent DELETE_ENTRYLIST request to finish deleting the entries.