REQUEST=PROCESSMULT

This request type is valid only for a structure allocated in a coupling facility of CFLEVEL=2 or higher. The parameter descriptions for REQUEST=PROCESSMULT are listed in alphabetical order.

,REQBUFFER=reqbuffer

Use this input parameter to specify the virtual storage area that contains from 1 to 128 lock request blocks that correspond to resource requests. The macro IXLYLRB maps each lock request block. The virtual storage area must reside in fixed or disabled reference storage and be addressable from the caller's primary address space.

To Code: Specify the RS-type name or address (using a register from 2 to 12) of an input buffer that contains the lock request blocks to be processed. The length of the buffer is determined by the number of lock request blocks that it contains.

,REQNUM=reqnum

Use this input parameter to specify the number of lock request blocks that are in the area identified by REQBUFFER. The value of REQNUM must be in the range of 1 to 128.

To Code: Specify the RS-type name or address (using a register from 2 to 12) of a halfword input field that contains the number of lock request blocks in the REQBUFFER area.

,REQPROC=reqproc

Use this output parameter to contain the number of lock request blocks that the system processed.

When the PROCESSMULT request is completed synchronously, there are two situations:

If all lock request blocks were processed, this value is equal to the value specified for the REQNUM keyword.
If an error occurred so that only a partial set of lock request blocks were processed, this value indicates the number of lock request blocks that were processed before the error occurred. The LRBs that follow the LRB designated by REQPROC are in an indeterminate state.

When the PROCESSMULT request is completed asynchronously, this value is zero.

To Code: Specify the RS-type name or address (using a register from 2 to 12) of a halfword output field to contain the number of lock request blocks that the system processed.

,MODE=SYNCSUSPEND

,MODE=NORESPONSE

,MODE=VALUE

Use this input parameter to specify how the request should be processed if it is not able to be serviced immediately. If the request is able to be processed immediately, the MODE keyword is ignored and control is returned to the invoker with all information regarding the completed request.

SYNCSUSPEND: Indicates that the PROCESSMULT request is to be handled synchronously. The caller receives control back only when the request is complete. If necessary, the caller is suspended until the request is complete.
NORESPONSE: Indicates that the requestor does not want to be informed when the PROCESSMULT request is complete. Return and reason codes are returned to the caller indicating that the request will be processed asynchronously. However, the connected user's COMPLETE exit will not be invoked to report request completion.
VALUE: Indicates that the contents of MODEVAL are to be used to specify how the request is to be processed if it cannot be serviced immediately.

,MODEVAL=modeval

Use this input parameter to specify the value as represented in IXLYCON, of the desired mode in which the request is to be processed.

The valid IXLYCON constants for a PROCESSMULT request are as follows:

IXLMODESYNCSUSPEND
IXLMODENORESPONSE

If you specify a value other than one of the IXLYCON constants that is valid for a PROCESSMULT request, the IXLLOCK request fails with reason code IXLRSNCODEBADMODEVAL.

TO CODE: Specify the RS-type name or address (using a register from 2 to 12) of a one-byte input field that contains a value indicating the desired mode in which the request is to be processed.