z/OS MVS Programming: Sysplex Services Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Handling an Incompletely Processed DELETE_MULT Request

z/OS MVS Programming: Sysplex Services Guide
SA23-1400-00

A DELETE_MULT request can time out before finishing all its processing. If this happens, IXLLIST:
  • Sets the IXLLIST return code to IXLRETCODEWARNING and the reason code to IXLRSNCODETIMEOUT to indicate that processing did not complete.
  • Returns in the LAADELCNT field of the answer area, the count of list entries that have been deleted on that invocation.
  • Returns in the LAARESTOKEN or LAAEXTRESTOKEN field of the answer area, a restart token to be provided when you reissue the request to continue the scan.

To reissue the DELETE_MULT request, access the restart token returned in the LAARESTOKEN or LAAEXTRESTOKEN field of the answer area and specify the token with the RESTOKEN or EXTRESTOKEN parameter on the next DELETE_MULT invocation. Continue to reissue the request until the return code indicates that all processing has completed.

If you do not have exclusive access to the list structure, it could be modified by other users between the time you issue the DELETE_MULT request and the time you reissue it. Since the DELETE_MULT request uses a restart token instead of the next entry's list controls to indicate where scanning should resume, scanning can resume successfully even if a particular list entry is moved or deleted.

You can avoid coding a separate IXLLIST invocation with the RESTOKEN or EXTRESTOKEN parameter to handle incomplete processing, by coding a single IXLLIST invocation with the restart token initialized to zero for the first time through. A restart token of zero causes IXLLIST to treat the invocation as a new request. When reissuing the request due to premature completion, be sure to first set the restart token to the value from the LAARESTOKEN or LAAEXTRESTOKEN field.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014