The CICS_EpiInquireSystem function
returns the name of the server on which a given terminal resource
(identified by its terminal index) is installed.
Parameters
- TermIndex
- The terminal index of the terminal resource, the location of which
is to be determined.
The EPI uses this parameter only for input.
- System
- A pointer to a string of length CICS_ECI_SYSTEM_MAX + 1 in which
the name of the server will be returned.
The EPI uses this parameter
only for output.
Return codes
- CICS_EPI_ERR_BAD_INDEX
- The TermIndex value is not a valid terminal index.
- CICS_EPI_ERR_FAILED
- The function failed for an unexpected reason.
- CICS_EPI_ERR_NOT_INIT
- CICS_EpiInitialize has not been executed.
- CICS_EPI_ERR_NULL_PARM
- System was a null pointer.
- CICS_EPI_ERR_IN_CALLBACK
- The function was called from a callback routine.
- CICS_EPI_NORMAL
- The function completed successfully. The name of the server is
returned in the System parameter padded with nulls
to a length of CICS_EPI_SYSTEM_MAX +1.