Function name: |
Parameters: |
To allow the user to select a server, or override the one passed to CICS_EpiAddTerminal or CICS_EpiAddExTerminal in the System parameter.
On each invocation of CICS_EpiAddTerminal or CICS_EpiAddExTerminal, after the EPI has validated the parameters.
Note on selection of systems:
If the calling application does not specify system name in its parameter list, then it is expecting that the system will be dynamically selected, and the exit may safely select the system.
CICS_EpiAddTerminalExit and CICS_EpiSystemIdExit:
The relationship between these exits is as follows. The exits will get multiple chances to make a selection of the system. The first chance will always occur on the CICS_EpiAddTerminalExit. This exit will only receive the parameters passed by the application to CICS_EpiAddTerminal or CICS_EpiAddExTerminal. If an error occurs when CICS tries to add the terminal (whether or not the exit has made a selection) then CICS_EpiSystemIdExit will be called. CICS_EpiSystemIdExit will additionally be passed the error that occurred on the attempt to add the terminal, and will get a chance to correct the error. This continues to occur until either a terminal is successfully added, or until CICS_EpiSystemIdExit signals to give up.
If no error occurs on the attempt to add the terminal, then CICS_EpiSystemIdExit will not be called.