The CICS_EciListSystems function provides a list
of CICS® servers to which CICS_ExternalCall requests
can be directed. There is no guarantee that a communications link
exists between the Client daemon and
any server in the list, or that any of the servers is available to
process requests.
The list of servers is returned as an array of system information
structures, one element for each CICS server.
The structure, called
CICS_EciSystem_t, defines the following
fields.
- SystemName
- A pointer to a null-terminated string specifying the name of a CICS server.
If the name is shorter than CICS_ECI_SYSTEM_MAX, it is padded with spaces to a length of CICS_ECI_SYSTEM_MAX + 1.
- Description
- A pointer to a null-terminated string that provides a description
of the system, if one is available. If the description is shorter
than CICS_ECI_DESCRIPTION_MAX characters, it is padded with nulls
to a length of CICS_ECI_DESCRIPTION_MAX + 1.