EZACIC25 replaces the GETHOSTBYNAME socket call. It is
invoked by a EXEC CICS® LINK
COMMAREA(com-area) where com-area is defined as follows:
- Field name
- Description
- Return code
- A fullword binary variable specifying the results of the function:
- Value
- Meaning
- -1
- ERRNO value returned from GETHOSTBYNAME() call. Check ERRNO field.
- 0
- Host name could not be resolved either within the cache or by
use of the GETHOSTBYNAME call.
Note: In some instances, a 10214 errno
is returned from the resolve, which can mean that the host name could
not be resolved by use of the GETHOSTBYNAME call.
- 1
- Host name was resolved using cache.
- 2
- Host name was resolved using GETHOSTBYNAME call.
- ERRNO
- A fullword binary field specifying the ERRNO returned from the
GETHOSTBYNAME call.
- HOSTENT address
- The address of the returned HOSTENT structure.
- Command
- A 4-byte character field specifying the requested operation.
- Value
- Meaning
- GHBN
- GETHOSTBYNAME. This is the only function supported.
- Namelen
- A fullword binary variable specifying the actual length of the
host name for the query.
- Query_Type
- A 1-byte character field specifying the type of query:
- Value
- Meaning
- 0
- Attempt query using cache. If unsuccessful, attempt using GETHOSTBYNAME()
call.
- 1
- Attempt query using GETHOSTBYNAME() call. This forces a cache
refresh for this entry.
- 2
- Attempt query using cache only.
Note: If the cache contains a matching record, the
contents of that record is returned regardless of its age.
- Name
- A 256-byte character variable specifying the host name for the
query.
If the transaction program is executing in the
Open Transaction Environment, a TCB switch occurs for each call to
EZACIC25.