Why am I getting a IST983E error after issuing a VTAM Display command?

This particular error can occur if the POAQLIM parameter is not defined on the VTAM APPL definition statements for program operator applications, or if the POAQLIM parameter is set to a value which is too low.

POAQLIM is a parameter on the APPL definition statement for a program operator to limit the number of messages that can be queued to a program operator. If you do not assign a value to POAQLIM, the POAQLIM value defaults to 5000. If the POAQLIM value is reached for a program operator, error message IST983E is issued and no more messages are sent to that program operator. All further messages destined for poaname are discarded until the VTAM message queue for poaname is cleared.

To clear the VTAM message queue for poaname, do one of the following:

• issue RCVCMD macros with OPTCD=NQ until the queue is empty

• cancel the job related to poaname. This will clear the VTAM message queue for poaname. To determine the name of the job related to poaname, issue DISPLAY ID=poaname and save the system log. Message IST271I in the DISPLAY ID output will provide the jobname related to the poaname.

To avoid getting the IST983E message again, you should ensure that POAQLIM is greater than the largest number of messages that a program operator expects to receive in response to any single VTAM command.

Determine whether POAQLIM is already defined on the VTAM APPL definition statements for program operator applications.

If POAQLIM is already defined, then your POAQLIM value is too low. You can increase POAQLIM on the APPL statement for poaname, enter a VARY NET,ACT,UPDATE=ALL command for the application major node, and recycle the application.

If, on the other hand, POAQLIM is not defined:

• Determine whether any program operator issues a command that can receive greater than 5000 messages in response to the command. One way to do this is to review VTAM command response output in the network log.

• If necessary, define POAQLIM greater than 5000 on the VTAM APPL definition statements for program operator applications. Be sure to define a high enough POAQLIM value so that a program operator's use of commands and expected response messages falls within the value.