CICS_EpiTermIdExit
This exit enables the user to find out the terminal ID allocated to a new EPI terminal, after a successful EPI call to CICS_EpiAddTerminal.
| Function name: | Parameters: |
|---|---|
| CICS_EpiTermIdExit
|
Anchor
TermIndex System |
Purpose
CICS_EpiTermIdExit is provided for compatibility with older applications only. All new applications that use the EPI exits use CICS_EpiTermIdInfoExit instead.
When called
On each invocation of CICS_EpiAddTerminal, after the server has allocated the terminal.
Parameters
- Anchor
- Input parameter. The pointer set up by CICS_EpiInitializeExit.
- TermIndex
- Input parameter. This is the terminal index for the terminal resource just reserved or installed.
- System
- Input parameter. A pointer to a null-terminated string that specifies the name of the server in which the terminal resource has been reserved or installed.
Return codes
- CICS_EXIT_OK
- Processing continues.
- CICS_EXIT_BAD_ANCHOR
- CICS® detected an invalid anchor field. The EPI writes a CICS Transaction Gateway trace record, and then continues as for CICS_EXIT_OK.
- CICS_EXIT_BAD_PARM
- CICS detected an invalid parameter. The EPI writes a CICS Transaction Gateway trace record, and then continues as for CICS_EXIT_OK.
- user-defined
- User-defined return codes must have a value not less than CICS_EXIT_USER_BASE. The EPI writes a CICS Transaction Gateway trace record, and then continues as for CICS_EXIT_OK.