Terminal waits - first considerations
When you investigate a terminal wait, there are preliminary considerations that might lead to a simple solution.
- Look for an obvious physical explanation for the wait, for example, a terminal operator has not responded to a request for input. For a printer, is it powered off, or has it run out of paper?
- Check in the CSTL and CSNE logs for any messages. If either DFHTCP
or DFHZCP detected an error related to terminal control, a message
is sent to the CSNE log, and might also be sent to the console.
If there is a message that reports a terminal error that can be related to the task, the message should provide more information about why the task is waiting. For an explanation of the message, and a description of the system action in response to the error, use the CMAC transaction or see CICS messages.
The CSNE log entry might show that an error was detected, but that TACP or NACP took no action. This situation might occur if the line or terminal is out of service, or if the error actions are turned off in the user exits of DFHTEP and DFHNEP. In this situation, the CICS code to resume the waiting task would never run, and the task would wait indefinitely.
- Check whether any HANDLE CONDITION routines for terminal errors are coded incorrectly. If there is an attempt to access the terminal with such an error in a routine, the application might wait indefinitely.
- If the terminal is installed using autoinstall, check whether
the system loaded DFHZATA, the autoinstall program, or DFHZCQ, which
is called by DFHZATA. The system might fail to load DFHZATA or DFHZCQ
because of a short-on-storage condition. If so, deal with the cause
of the short-on-storage condition.
Check the delete delay that you have specified; if the delay is too short, your system might be deleting and reinstalling terminals unnecessarily.
If storage fragmentation prevents DFHZATA or DFHZCQ from being loaded, consider defining them as resident. However, be aware that DFHZCQ is a large program, and check your storage requirements before making this change.
If none of the preliminary considerations apply, start a systematic investigation into the reason for the wait.