Explanation
The POA poaname message queue
would reach the limit (POAQLIM) specified on the APPL definition statement
with the message or message group destined for the POA. This can occur
when the POA is not issuing RCVCMD macros quickly enough to clear
the VTAM® message queue for
this application. It can also occur when POAQLIM is too small to allow
for very large message groups, such as output from a VTAM DISPLAY command.
poaname is
the name of the POA that has reached the specified message queue limit.
System action
All further messages destined for poaname are
discarded until the message queue is cleared.
Operator response
- Issue DISPLAY ID=poaname and save the system
log. Message IST271I will provide the jobname related
to the poaname.
- Save the system log and request a dump of the application program
(jobname) and VTAM for
problem determination.
System programmer response
- If the POA is not issuing RCVCMD macros quickly enough, you can
clear the message queue for poaname by issuing
RCVCMD macros with OPTCD=NQ until the queue is empty.
- If RCVCMD macros are being issued quickly enough, examine the
dump and the VTAM internal
trace (if available) to determine why the messages are not being received
quickly enough. Check to ensure that the RCVCMD macros are being received
by VTAM.
- You might need to change the POA RCVCMD processing so that RCVCMDs
are issued more frequently.
- You can also change the dispatching priority of the POA. See your
operating system documentation for information on dispatching priority.
- You can cancel the job related to poaname.
This will clear the VTAM message
queue for poaname.
- If you determine that the 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.
See the z/OS Communications Server: SNA Programming for information on program operator coding
requirements in program operator applications and the RCVCMD macro.
Routing code
Descriptor code