Verbs and Built-in Functions › &SOCKET TRANSFER_ACCEPT

&SOCKET TRANSFER_ACCEPT

Accepts a socket ID from a donor NCL process.

&SOCKET TRANSFER_ACCEPT ID=socket_id

TRANSFER_ACCEPT is used to accept a socket from a donor NCL process. The TRANSFER_ACCEPT should be performed upon receipt of a notification message (see below) from the donor NCL process, indicating that it has been targeted to receive a socket.

Operands:

ID=socket_id

(Mandatory) Specifies the identifier of the socket to be used for communication.

Examples: &SOCKET TRANSFER_ACCEPT

&INTREAD ARGS TYPE=ANY 
&IF &1 EQ N00101 &THEN +
  &DO
     &NSOC = &REMSTR (=) &7
     &SOCKET TRANSFER_ACCEPT ID=&NSOC
  &DOEND

Return Codes:

0

Transfer successful.

8

Transfer failed; see &ZFDBK for reason code.

Notes:

An &SOCKET TRANSFER_REQUEST issued by another process causes a notification message to be queued to the request queue of the target process.

The information returned is set into the NCL variables, &ZSOCID. This variable will contain the socket number to be used for communications.

Notification Message Format:

&SOCKET TRANSFER_ACCEPT should be issued upon receipt of the following message, queued to the internal environment of this process, indicating that it has been targeted for a transfer request:

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

More information:

&SOCKET TRANSFER_REQUEST