|
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.
|