Verbs and Built-in Functions › &SOCKET TRANSFER_REQUEST

&SOCKET TRANSFER_REQUEST

Transfers the socket ID from the current NCL process to another NCL process identified by NCL ID.

&SOCKET TRANSFER_REQUEST ID=socket_id NCLID=ncl_id

To transfer ownership of a socket from one process to another.

Operands:

ID=socklet_id

(Mandatory) Specifies the identifier of the socket to be transferred.

NCLID=ncl_id

(Mandatory) Nominates the NCL process to which ownership of the socket is being transferred. The notification message (see below) will be queued to the internal environment of the process to indicate that it has been targeted for a transfer request.

Examples: &SOCKET TRANSFER_REQUEST

&SOCKET TRANSFER_REQUEST ID=&NSOC NCLID=&NID

Return Codes:

0

Transfer successful

8

Transfer failed; see &ZFDBK for reason code, &ZSOCERRN and &ZSOCVERR for further error information.

Notification Message Format:

&SOCKET TRANSFER_REQUEST issues the following message and queues it to the request queue of an NCL process that it has targeted for a transfer request:

N00101 NOTIFY: TCP/IP EVENT: TRANSFER RESOURCE: ID=socket_id NCLID=ncl_id

This request is completed after the target NCL process executes the &SOCKET TRANSFER_ACCEPT verb.

&APPC START NOTIFY=YES is a useful means to start a process and find out the NCL ID (this does not require an APPC conversation).

There should be no asynchronous requests outstanding when &SOCKET TRANSFER_REQUEST is issued.

More information:

&SOCKET TRANSFER_ACCEPT