z/OS Communications Server: IP Sockets Application Programming Interface Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Parameter values set by the application

z/OS Communications Server: IP Sockets Application Programming Interface Guide and Reference
SC27-3660-00

SOC-FUNCTION
A 16-byte field containing CONNECT. Left-justify the field and pad it on the right with blanks.
S
A halfword binary number specifying the socket descriptor of the socket that is to be used to establish a connection.
NAME

An IPv4 socket address structure that contains the IPv4 socket address of the target to which the local, client socket is to be connected.

FAMILY
A halfword binary field specifying the IPv4 addressing family. The value must be decimal 2 for AF_INET.
PORT
A halfword binary field that is set to the server’s port number in network byte order. For example, if the port number is 5000 in decimal, it is stored as X'1388' in hex.
IP-ADDRESS
A fullword binary field that is set to the 32-bit IPv4 IP address of the server’s host machine in network byte order. For example, if the IP address is 129.4.5.12 in dotted decimal notation, it would be represented as X'8104050C' in hex.
RESERVED
Specifies an 8-byte reserved field. This field is required, but is not used.

An IPv6 socket address structure that contains the IPv6 socket address of the target to which the local, client socket is to be connected.

FAMILY
A halfword binary field specifying the IPv6 addressing family. For TCP/IP the value is decimal 19 for AF_INET6.
PORT
A halfword binary field that is set to the server’s port number in network byte order. For example, if the port number is 5000 in decimal, it is stored as X'1388' in hex.
FLOWINFO
A fullword binary field specifying the traffic class and flow label. This field must be set to 0.
IP-ADDRESS
A 16-byte binary field that is set to the 128-bit IPv6 IP address of the server’s host machine in network byte order. For example, if the IPv6 IP address is 12ab:0:0:cd30:123:4567:89ab:cedf in colon hex notation, it is set to X'12AB00000000CD300123456789ABCDEF'.
SCOPE-ID
A fullword binary field which identifies a set of interfaces as appropriate for the scope of the address carried in the IPv6-ADDRESS field. A value of 0 indicates the SCOPE-ID field does not identify the set of interfaces to be used, and may be specified for any address types and scopes. For a link scope IPv6-ADDRESS, SCOPE-ID may specify a link index which identifies a set of interfaces. For all other address scopes, SCOPE-ID must be set to 0.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014