An input parameter. A socket address structure to be translated which has the following fields:
The IPv4 socket address structure must specify the following fields:
The IPv6 socket address structure specifies the following fields:
If the IPv6-ADDRESS value is a link-local address, and the SCOPE-ID interface index is nonzero, scope information is appended to the resolved host name using the format host%scope information. The scope information can be either the numeric form of the SCOPE-ID interface index or the interface name associated with the SCOPE-ID interface index. Use the NI_NUMERICSCOPE option to select which form should be returned. The combined host name and scope information will still be at most 255 bytes long. For more information about scope information and GETNAMEINFO processing, see z/OS Communications Server: IPv6 Network and Application Design Guide.
Flag name | Binary value | Decimal value | Description |
---|---|---|---|
'NI_NOFQDN' | X'00000001' | 1 | Return the NAME portion of the fully qualified domain name. |
'NI_NUMERICHOST' | X'00000002' | 2 | Only return the numeric form of host's address. |
'NI_NAMEREQD' | X'00000004' | 4 | Return an error if the host's name cannot be located. |
'NI_NUMERICSERV' | X'00000008' | 8 | Only return the numeric form of the service address. |
'NI_DGRAM' | X'00000010' | 16 | Indicates that the service is a datagram service. The default behavior is to assume that the service is a stream service. |
'NI_NUMERICSCOPE' | X'00000020' | 32 | Only return the numeric form of the scope information, when applicable |
See Socket call error return codes for information about ERRNO return codes.