The CICS_EciListSystems function provides a list of CICS® servers
to which CICS_ExternalCall requests
may 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 nulls 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.