Parameter values set by the application

SOC-FUNCTION

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

S

A value or the address of a halfword binary number specifying the socket descriptor.

MSG

A pointer to an array of message headers from which messages are sent.

Field

Description

NAME

On input, a pointer to a buffer where the sender's address is stored upon completion of the call. The storage being pointed to should be for an IPv4 socket address or an IPv6 socket address. The IPv4 socket address structure contains the following fields:

Field: Description
FAMILY: Output parameter. A halfword binary number specifying the IPv4 addressing family. The value for IPv4 socket descriptor (S parameter) is decimal 2, indicating AF_INET.
PORT: Output parameter. A halfword binary number specifying the port number of the sending socket.
IP-ADDRESS: Output parameter. A fullword binary number specifying the 32-bit IPv4 IP address of the sending socket.
RESERVED: Output parameter. An 8-byte reserved field. This field is required, but is not used.

The IPv6 socket address structure contains the following fields:

Field: Description
FAMILY: Output parameter. A halfword binary number specifying the IPv6 addressing family. The value for IPv6 socket descriptor (S parameter) is decimal 19, indicating AF_INET6.
PORT: Output parameter. A halfword binary number specifying the port number of the sending socket.
FLOWINFO: A fullword binary field specifying the traffic class and flow label. This field must be set to 0.
IP-ADDRESS: Output parameter. A 16-byte binary field set to the 128-bit IPv6 IP address of the sending socket.
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 can be specified for any address types and scopes. For a link scope IPv6-ADDRESS, SCOPE-ID can specify a link index which identifies a set of interfaces. For all other address scopes, SCOPE-ID must be set to 0.

NAME-LEN

On input, a pointer to the size of the address buffer.

IOV

On input, a pointer to an array of three fullword structures with the number of structures equal to the value in IOVCNT and the format of the structures as follows:

Fullword 1: A pointer to the address of a data buffer.
Fullword 2: Reserved.
Fullword 3: A pointer to the length of the data buffer referenced in Fullword 1.

In COBOL, the IOV structure must be defined separately in the Linkage section, as shown in the example.

IOVCNT

On input, a pointer to a fullword binary field specifying the number of data buffers provided for this call.

ACCRIGHTS

On input, a pointer to the access rights received. This field is ignored.

ACCRIGHTS-LEN

On input, a pointer to the length of the access rights received. This field is ignored.

FLAGS

A fullword field containing the following information:

Literal Value	Binary Value	Description
NO-FLAG	X'00000000'	No flag is set. The command behaves like a WRITE call.
MSG-OOB	X'00000001'	Send out-of-band data. (Stream sockets only.)
MSG-DONTROUTE	X'00000004'	Do not route. Routing is provided by the calling program.