Parameter values set by the application

SOC-FUNCTION

A 16-byte character field containing GIVESOCKET. The field is left-justified and padded on the right with blanks.

S

A halfword binary number set to the socket descriptor of the socket to be given.

CLIENT

A structure containing the identifier of the application to which the socket should be given.

DOMAIN

A fullword binary number that must be set to decimal 2, indicating AF_INET, or decimal 19 indicating AF_INET6.

Note: A socket given by GIVESOCKET can only be taken by a TAKESOCKET with the same DOMAIN (AF_INET or AF_INET6).

NAME

Specifies an eight-character field, left-justified, padded to the right with blanks, that can be set to the name of the MVS™ address space that will contain the application that is going to take the socket.

If the socket-taking application is in the same address space as the socket-giving application (as in CICS®), NAME can be specified. The socket-giving application can determine its own address space name by issuing the GETCLIENTID call.
If the socket-taking application is in a different MVS address space (as in IMS™), this field should be set to blanks. When this is done, any MVS address space that requests the socket can have it.

TASK

Specifies an 8-byte field that can be set to blanks, or to the identifier of the socket-taking MVS subtask. If this field is set to blanks, any subtask in the address space specified in the NAME field can take the socket.

As used by IMS and CICS, the field should be set to blanks.
If TASK identifier is non-blank, the socket-receiving task should already be in execution when the GIVESOCKET is issued.

RESERVED

A 20-byte reserved field. This field is required, but not used.