|
|
|
&APPC TRANSFER_REQUEST requests the transfer of ownership of an LU6.2 conversation from one NCL process to another. The short form is &APPC TRANSFER.
This verb has the following format:
&APPC{ TRANSFER_REQUEST | TRANSFER }
[ NCLID=nclid | SERVER=servername ]
[ ID=id ]
[ WAIT=nn ]
Operands:
Indicates this is a request to transfer ownership. The procedure is suspended pending completion of the request. The NCLID parameter must be supplied to indicate the target process to which the conversation is to be passed. If the ID parameter is omitted, the current conversation for this procedure is assumed. A notification is sent to the target process indicating that a transfer request has been issued. If the request completes successfully, the conversation is no longer available to this procedure for operation.
Nominates the target NCL process to which ownership of the LU6.2 conversation is to be transferred. The notification message (see below) is queued to the internal environment of this process to indicate it has been targeted for a transfer request.
SERVER=servername is an alternative way to nominate the target NCL process. If this operand is used, a search is performed for the server name registered for the region, user or system, in that order.
Specifies the conversation identifier (as first returned by the system variable &ZAPPCID after successful allocation) that references a particular conversation. If this parameter is omitted, the current (last referenced, or only) conversation is assumed.
Specifies the time, in seconds (for example, 10), or seconds and hundredths (for example, 1.25), for which the procedure is prepared to wait for the transfer to be accepted or rejected. If not successful before this interval expires the transfer request is canceled, and an unsuccessful return code (&RETCODE is set to 4, &ZFDBK is set to 0) results.
Examples: &APPC TRANSFER_REQUEST
&APPC TRANSFER_REQUEST NCLID=123
&APPC TRANSFER NCLID=123
Return Codes:
The return codes are as follows:
Request successful
Request unsuccessful
Remote program error
State check
Request or conversation error
&ZFDBK is also set, plus all APPC system variables.
State Transition:
This request is valid from send or receive state only, and no state changes occur as a result.
Notification Message Format:
When a TRANSFER_REQUEST is issued the following message is placed on the request queue of the internal environment for the NCL process targeted:
N00101 NOTIFY: APPC EVENT: TRANSFER RESOURCE: id
id is the system unique conversation identifier being transferred. This value must be supplied on any subsequent TRANSFER_ACCEPT or TRANSFER_REJECT request by the target procedure.
Notes:
| Copyright © 2009 CA. All rights reserved. |
|