The freeaddrinfo callable service frees the Addr_Info structure(s) that are obtained by the getaddrinfo callable service (getaddrinfo (BPX1GAI, BPX4GAI) — Get the IP address and information for a service name or location).
Operation | Environment |
---|---|
Authorization: | Supervisor state or problem state, any PSW key |
Dispatchable unit mode: | Task |
Cross memory mode: | PASN = HASN |
AMODE (BPX1FAI): | 31-bit |
AMODE (BPX4FAI): | 64-bit |
ASC mode: | Primary mode |
Interrupt status: | Enabled for interrupts |
Locks: | Unlocked |
Control parameters: | All parameters must be addressable by the caller and in the primary address space. |
|
AMODE 64 callers use BPX4FAI with the same parameters.
The name of a fullword field that contains a pointer to an Addr_Info structure or a linked list of Addr_Info structures returned by the getaddrinfo callable service. See Addr_Info – AddrInfo Data Structure in the EZBREHST assembler macro for more information about the format of this structure. The EZBREHST macro is shipped in the installation's MACLIB SMP/E DDEF location.
Return_code | Explanation |
---|---|
EAI_AGAIN | The resolver address space has not been started. Try the request later. |
EAI_FAIL | An unrecoverable error occurred. |
The name of a fullword in which the freeaddrinfo service stores the reason code. The freeaddrinfo service returns Reason_code only if Return_value is -1. Reason_code further qualifies the Return_code value. For the reason codes, see z/OS V2R1.0 Communications Server: IP and SNA Codes.
None.
For an example using this callable service, see BPX1FAI (freeaddrinfo) example.