QIO Configuration and Management Manual

Managing the QIO Subsystem
QIO Configuration and Management Manual—424717-008
3-2
Monitoring Subsystem Operations
Monitoring Subsystem Operations
The SCF STATUS command is useful for monitoring the operation of the QIO
subsystem.
The STATUS MON command with the DETAIL option displays the number of client
processes and client process queues using the QIOMON process.
Some of the values displayed with the STATUS commands are configurable for QIO
via the configuration file specified when starting the QIOMON process. For information
on which keywords and values can be set in the QIO configuration file, and instructions
for reconfiguring the QIOMON process, see Section 2, Configuring the QIO
Subsystem.
Troubleshooting
Several types of problems can occur if the QIO subsystem is not configured correctly.

If the QIOMON process fails to start, an EMS event number 2 “Object Unavailable”
event is produced. Usually these events indicate that the amount of memory
available in the CPU is not sufficient for the specified QIO configuration or that the
QIOMON process and the QIO library (QIOLIB) are not from the same release.
The symptom string displayed in the event describes the cause of the problem.

If the QIOMON process starts but the client processes fail, a QIO resource
shortage might have been detected. This situation normally causes a QIO event 3,
4, or 5, possibly multiple times. The client process typically reports its own event
that identifies a failure to obtain resources and then reacts to that condition. The
reaction of the client process on a failure to obtain QIO resources depends upon
the client process; it might decline a request (such as adding a TCP/IP subnet),
exercise a flow control protocol on an API (such as not receiving data on a socket),
or fail to start. Use the SCF STATUS SEGMENT $ZM* command with the DETAIL
option to examine the QIO segment object. The display of this command shows
the resources in use for the segment that has a resource shortage.
If you need to change any values in the QIO configuration file, see Before You Begin
on page 2-6. For more information on changing the configuration file, see
Understanding the Configuration File
on page 2-7.
SCF> status mon $zm02, detail
QIO Detailed Status MON \NATIVE.$ZM02
State...................... STARTED
CPU........................ 2
Priority................... 201
Num Queues................. 27
Num Appls.................. 7
Trace Status............... OFF
Trace FileName.............