IBM Support

QMGTOOLS: Run AA Macros

Technote (troubleshooting)


Problem(Abstract)

There are times when you will need to go into the Advance Analysis macro to dump information to be analyzed by IBM Support. This document assists in the use of a tool to gather that information easily.

Resolving the problem

There are times when you will need to go into the Advance Analysis macro to dump information to be analyzed by IBM Support. This document assists in the use of a tool to gather that information easily.

Diagnosing the problem

The MustGather tools library (QMGTOOLS) contains a program to assist in collecting advance analysis macros from a command line interface. This is also useful if using a trap program.

Resolving the problem

1. If the QMGTOOLS toolkit has not yet been installed, you should refer to the following document for information on how to download and install the QMGTOOLS toolkit on your IBM i server:

MustGather: How To Obtain and Install QMGTOOLS
2. Add QMGTOOLS to the your library list (ADDLIBLE QMGTOOLS) and type GO MG.
3. Go into the Misc Tools option. In this example, it is Option 9.

4. From the Misc menu, choose the option Run AA Macros.

5. The command is shown below:

Note: The user using this command should have *ALLOBJ and *SPLCTL or *JOBCTL.



REQUEST - the macro to run.
At the time of this writing, the valid macros that can be run are listed as follows:

*ASMINFO Provides diagnostis traces for ASM geographic mirroring
*BATTERYINFO Provides information about the cache battery
*CLUSTERINFO Provides partition clustering information
*DSPHS Provides DASD parity set information
*DSMINFO Provides information about disk configuration
*DSTINFO Provides DST flight recorder and dump everything this flight recorder can dump
*FLASHLEVELS Provides the level of hypervisor code that will be loaded thru an in-band update
*GATEINFO Provides data on the gate residing at the given address, gate waiters and waitlist waiters will be dumped
*GEOSTAT Provides the status of geographic mirroring on ALL ASPs
*IOHRIDEBUG Provides configuration information including VPD, logical and packaging resource hierarchy information and console data.
*LIDMGRPFR Provides the LIC Manager Flight Record
*LLHISTORYLOG Provides the Link Loader History Log
*LOCKINFO Provides all information from the lock table
*LOGSENSESTATS Provides external storage performance data –all ASPs, -all pages and –dec display
*MPLINFO Provides system MPL class information and a list of MI threads, with selected thread information relative to managing a thread within a MPL class. The MI thread information available includes the MPL class id for the thread, the thread status relative to the MPL class, wait status, wait object information, thread run time, and thread priority.
*MUTEXINFO Provides a list of mutex objects running on the system. These contain the actual locking mechanism and data useful in debugging synchronization problems.
*OPSCONSOLE Provides the Operations Console Flight Recorder data. Dumps problem debug info.
*PALLIST Lists the Product Activity Log entries.
*POOLINFO Lists all the data in the Pool Table
*PROCESSINFO Dumps information about the processes for all active tasks on the system. Or if the –NAMES parameter is used; it will dump information about tasks that match the input parameter name.
*QUEUEINFO Dumps the information about an MI queue at the specified address. It skips dumping drop-off and queue messages.
*QUEUESPACE Provides information on:
Queue Space Address
Status flags
Log message count
Ext message count
Allocated size of queue space
Threshold size of queue space
Current message index
Process Control Space (PCS) address of owning process
Threshold Exceeded Event Count
SID Addresses in the SID Table - SIDs that make up the queue space
Messages in queue space:
log messages when -i is not specified
invocation messages when -i is specified
*RACKCONFIG Collects a rack configuration
*SECLOG Displays information about the DST security audit log.
*SEIZEINFO Dumps all the data in the seize table.
*SERVICEDOCS Dumps all service information. The data dumped is the contents of the following Advanced Analysis commands:
taskinfo -ALL -F A -TF 2
mplinfo
waiters
seizeinfo ALL
poolinfo
systemmonitor (flightlog system)
liclog LIST LAST 2 IPL (vlog)
taskinfo is collected a second time

Note : If you need to collect the lock information, collect SERVICEDOCS natively from SST and put in the OPTIONS field one of these :

-lock to collect the lockinfo TABLE
-lockd to collect the lockinfo TABLE = D
SID87 Provides data from the last IOP dump
SID187 Provides data from the last IOP dump
SMCAPACITYBALANCE Provides information and control of the capacity balance with regards to honoring or ignoring media preference boundaries when capacity balancing Returns the state of the capacity balance flag, ON/OFF
SMSTAYSSD Provides information and control of the Stay Off SSD flag. Returns either ON/OFF.
SSDGAUGE Provides life expectancy gauge for SSD devices.
SSDSTATS Provided life expectancy for SSD devices.
STS Provides information on the Service Tool Server flight recorder.
*TASKINFO Dumps stack information and status for all the tasks/processes in the system.
*WAITERS A list of all tasks organized by their dispatcher state (active, ready, or blocked), and for those that are blocked, they are grouped according to their wait object.


DATA - parameters that are pass to the macros, so macros above require parameters. As of this writing, macros needing or allowing parameters are as follows.

*ASMINFO <ASP number>
*GATEINFO <address>
*PROCESSINFO optional --> -NAMES <name of task>
*QUEUESPACE -a ADDRESS
-I
-PCS
-QS
*QUEUEINFO <address>


SST User Profile - A user profile that can access SST.

OUTPUT - Print or copy the data to a physical file member
6. An example of using the command from the command line to get servicedocs for a hang job issue is as follows:

QMGTOOLS/RUNAA RQS(*SERVICEDOCS) USRPRF(QSECOFR) OUTPUT(*PRINT)

Sending data to IBM

http://www-01.ibm.com/support/docview.wss?uid=nas8N1019224


Cross reference information
Segment Product Component Platform Version Edition
Operating System IBM i 6.1
Operating System IBM i 7.1
Operating System IBM i 7.3
Operating System IBM i 7.2

Historical Number

670614801

Document information

More support for: IBM i
Data Collection

Software version: 7.1, 7.2, 7.3

Operating system(s): IBM i

Reference #: N1010377

Modified date: 22 May 2013


Translate this page: