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


Processing Multiple Resource Requests (REQUEST=PROCESSMULT)

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

Use the PROCESSMULT request to have the system process multiple requests for resources with a single invocation of IXLLOCK. IXLLOCK Version 1 supports the PROCESSMULT option with the ‘RELEASE’ type. As with a single ‘RELEASE’ request, you can specify either to keep or to delete the record data associated with the resource request. However, note that there is no support for updating the record data when keeping it with the PROCESSMULT RELEASE option. REQUEST=PROCESSMULT also does not support resource names with a length greater than 64 characters.

The PROCESSMULT request type is valid only for a structure allocated in a coupling facility with CFLEVEL=2 or higher.

For each resource request that you wish to process, you build a lock request block (LRB) to represent that request. An LRB is mapped by the macro IXLYLRB. You can specify up to 128 resource requests on a PROCESSMULT invocation. You build the LRBs representing these resource requests in the virtual storage area specified by REQBUFFER. The REQBUFFER area can hold from 1 to 128 individual lock request blocks. For a description of IXLYLRB, see z/OS® MVS™ Data Areas in the z/OS Internet library.

Table 1 shows the information that each lock request block contains.

Table 1. IXLLOCK Lock Request Block Information
Field Name Description
LRB_XTYPE Type of request Value must be LRB_XTYPE_RELEASEVERS0
LRB_XRNAME Resource name
LRB_XHASHVAL Hash value
LRB_XUDATAVAL User data value
LRB_XMODE Mode in which the request is to be processed if it cannot be serviced immediately:
0 (LRB_XMODE_SYNCEXIT)
Process the request asynchronously and give control to the user's complete exit when the request is complete.
1 (LRB_XMODE_NORESPONSE)
Do not inform the caller when the request is complete.
LRB_XRDATA Record data options
X'20' (LRB_XRDATA_DELETE)
Delete the record data entry associated with the resource that is being RELEASEd.
X'04' (LRB_XRDATA_KEEP)
Keep the record data entry associated with the resource that is being RELEASEd.
LRB_XRETCODE Return code from this request for this LRB.
LRB_XRSNCODE Reason code from this request for this LRB.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014