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.