The CICS_EpiAddTerminal function installs a new terminal resource, or reserves an existing terminal resource, for the application's use.
CICS_EpiAddTerminal | NameSpace |
It provides a terminal index, which should be used to identify the terminal resource on all further EPI calls. It also provides the information defined in the CICS_EpiDetails_t data structure.
There is a limit on the number of terminals you can add with this operation: The maximum varies according to the resources available on the client system.
If the string is all nulls, the default server is selected by the EPI. To determine the name of the server chosen, use CICS_EpiInquireSystem.
The EPI uses this parameter only for input.
If a string is supplied that is shorter than CICS_EPI_NETNAME_MAX, it must be padded with nulls to a length of CICS_EPI_NETNAME_MAX + 1.
The string is transmitted to the server without conversion to uppercase.
The characters used are translated from the client’s code page to an EBCDIC code page before transmission. If the server uses an ASCII code page, they will be retranslated. The only characters guaranteed to be invariant under these translations are the uppercase characters A to Z, and the numeric characters 0 to 9. Some EBCDIC servers (Katakana and Hebrew character set A) do not use the standard representations of the lowercase alphabetic characters; use them with care when communicating with such servers.
The EPI uses this parameter only for input.
If a string is supplied that is shorter than CICS_EPI_DEVTYPE_MAX characters, it should be padded with nulls to a length of CICS_EPI_DEVTYPE_MAX + 1.
The string is transmitted to the server without conversion to uppercase.
The characters used are translated from the client’s code page to an EBCDIC code page before transmission. If the server uses an ASCII code page, they will be retranslated. The only characters guaranteed to be invariant under these translations are the uppercase characters A to Z, and the numeric characters 0 to 9. Some EBCDIC servers (Katakana and Hebrew character set A) do not use the standard representations of the lowercase alphabetic characters; use them with care when communicating with such servers.
The EPI uses this parameter only for input.
The EPI uses this parameter only for input.
The EPI uses the fields in this structure only for output.
The EPI uses this parameter only for output.