CICS_EpiInquireSystem

CICS_EpiInquireSystem

TermIndex
System

Purpose

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 whose location 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.