REQUEST=RELEASE

The parameter descriptions for REQUEST=RELEASE are listed in alphabetical order. Default values are underlined.

,HASHVAL=hashval

Use this input parameter to specify a hash value associated with the resource name. The hash value along with the resource name serves to fully qualify an IXLLOCK resource. The method of producing the hash value is completely at the discretion of the connected user. Typically, the value provided for this keyword is the output of a user-defined hashing algorithm that receives a resource name as input.

To Code: Specify the RS-type name or address (using a register from 2 to 12) of an input fullword field that contains a hash value associated with the resource name.

,MODE=SYNCSUSPEND

,MODE=SYNCEXIT

,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 caller with all information regarding the completed request.

SYNCSUSPEND: Indicates that the RELEASE request be handled synchronously. The caller receives control back only when the request is complete. If necessary, the caller is suspended until the request completes.
SYNCEXIT: Indicates that the RELEASE request be handled asynchronously. Return and reason codes are returned to the caller indicating that the request will be processed in this manner. Request completion is reported through the connected user's complete exit. The user-specified complete exit may be given control before control returns to the next sequential instruction after the connected user's IXLLOCK request.
NORESPONSE: Indicates that the requestor does not want to be informed when the RELEASE 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 RELEASE request are:

IXLMODESYNCSUSPEND
IXLMODESYNCEXIT
IXLMODENORESPONSE

If you specify a value other than one of the IXLYCON constants that is valid for a RELEASE 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.

,RDATA=DELETE

,RDATA=KEEP

Use this input parameter to specify the record data operation, if any, that is to be performed as part of obtaining the specified resource.

DELETE: Indicates that the record data entry associated with this resource is to be deleted. If no record data entry is currently allocated and associated with this resource, then this keyword is ignored.
KEEP: Indicates that the record data entry associated with this resource is to be kept even though ownership of the resource is being relinquished.
Note that the record data entry that was kept may eventually be re-associated with a new resource through the REACQUIRE option of IXLLOCK REQUEST=OBTAIN or manipulated through the XES record data service, IXLRT. If the KEEP option is specified and no associated record data entry exists, informational return and reason codes will be returned to the invoker.

,RDATAVAL=rdataval

Use this input/output parameter to specify the user-defined data to be written to the record data entry. The contents of RDATAVAL are at the discretion of the connected user and have no meaning to the system. The contention exit may modify the value that is to be written to the record data entry as part of granting the request.

If completion of the OBTAIN request is presented to the user synchronously, the input variable will contain the resultant record data value.

To Code: Specify the RS-type name or address (using a register from 2 to 12) of a 64-character input/output field that contains user-defined data to be written to the record data entry. The contents of RDATAVAL are at the discretion of the connected user and have no meaning to the system. The contention exit may modify the value that is to be written to the record data entry as part of granting the request.

,RNAME=rname

Use this input parameter to specify the resource name for which the request is to be processed. The resource name and length along with the hash value serve to fully qualify an IXLLOCK request.

To Code: Specify the RS-type name or address (using a register from 2 to 12) of the character input field that contains the resource name for which the request is being processed.

,RNAMELEN=NO_RNAMELEN

,RNAMELEN=rnamelen

Use this input parameter to specify the length of the resource name identified by RNAME. The resource name length attribute is established on the IXLCONN invocation. The resource name and length along with the hash value serve to fully qualify an IXLLOCK request.

RNAMELEN is valid only when variable-length resource names are in effect for the lock structure. The value you specify for RNAMELEN must be between 1 and 300 inclusive.

If you specify RNAMELEN for a lock structure that does not have the variable-length name attribute, the system rejects the request with reason code IXLRSNCODENOVARRNAME.
If you specify a value for RNAMELEN that is different from the actual length of RNAME, the system uses the RNAMELEN value as the length of RNAME.
If you do not specify RNAMELEN, the length of the resource name defaults to 64 bytes.

To Code: Specify the RS-type name or address (using a register from 2 to 12) of a fullword input field that contains the resource name length of the resource identified by RNAME.

,UDATAVAL=ALL_ZEROES

,UDATAVAL=udataval

Use this input/output parameter to specify user-defined data to be associated with the resource. The contents of UDATAVAL are at the discretion of the connected user and have no meaning to the system. UDATAVAL is presented to the complete, notify, and contention exits when driven.

Note that while a RELEASE request cannot be denied by the contention exit, the contents of the user data associated with the request may be modified.

If request completion is reported to the connected user synchronously, UDATAVAL, if specified, will contain the resultant user data value.

To Code: Specify the RS-type name or address (using a register from 2 to 12) of a 64-character input/output field that contains user-defined data to be associated with the resource.

,UPDATERDATA=NO

,UPDATERDATA=YES

Use this input parameter to specify whether or not to update the data in the record data entry that has been kept.

NO: Indicates that the data in the record data entry is not to be updated.
YES: Indicates that the data in the record data entry is to be updated with the data specified by RDATAVAL. RDATAVAL is a required keyword when UPDATERDATA=YES is specified.