IBM Support

QMGTOOLS: Run AA Macros

Troubleshooting


Problem

There are times when you need to go into the Advance Analysis macro to dump data for analysis by IBM Support. This document helps in the use of a tool to gather that information easily.

Resolving The Problem

There are times when you need to go into the Advance Analysis macro to dump data for analysis by IBM Support. This document helps in the use of a tool to gather that information easily.

Diagnosing the problem

The MustGather tools library (QMGTOOLS) contains a program to help in collecting advance analysis macros from a command-line interface. This function can be part of a trap program.

Resolving the problem
1. 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 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 following contains information for the command, RUNAA.

Note: The user that uses this command might need *ALLOBJ and *SPLCTL or *JOBCTL.



REQUEST - the macro to run.
At the time, of this writing, the available macros are listed in the chart.
 
Note: Depending on the current PTF level, some of these options may not be available. At the time of this writing, the current PTF that provides all of these options are MF68476 (R740), MF68477 (R730) and MF68478 (R720). Also, QMGTOOLS must be at the latest build. Refer to this URL for information on how to update QMGTOOLS:
*ASMINFO
Provides diagnostis traces for ASM geographic mirroring
Required:
<ASP number>
*BATTERYINFO Provides information about the cache battery
*BRIDGEFR Provides information about the ethernet bridge
*CLUSTERINFO Provides partition clustering information
*DASDREQUEST Provides current DASD requests detail
*DEBUGDDD Provides partition information on the device domain data
*DEBUGIOA
Provides IOA information
Required:
-SUB xx where xx is the sub command
-IOA xxxx where xxxx is the storage controller like DC07
Optional:
-LENGTH xxxxx where xxxxx length of data returned
-PAL creates PAL entry
*DISKALLDEBUG
Provides all disk debug information. It will collect the listed macros. Similiar to IODD DUMPALLDEBUG macro.
IODD dasd
IODD mpdasd
IOFR -num 3
IODASDFR -all -full
IODASDFR -summary
*DISKFWLEVEL Provides information on disk firmware level
*DSPHS
Provides DASD parity set information
*DSMINFO Provides information about disk configuration
*DSPHOTSPARES Provides hot spare stop candidates, disk in existing device parity sets, and which parity sets are protected with hot spares
*DSTINFO Provides DST flight recorder and dump everything this flight recorder can dump
*DUMPMIRRORINFO Provides Mirrored Database information (release dependent)
*DUMPVHRIPERS Provides persistent VHRI data
*FABQUERY
Allows passing Fabric Query command to an IOA
Required:
-SUB xx where xx is the sub command option sent to the IOA
-IOA xxxx where xxxx is the storage controller like DC07
Optional:
-LENGTH xxxxx where xxxxx is the length of data returned
-DSP x where x can be 0=single, 1=detailed, 2=graphical, 9=raw
*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
*GETPWDLVL Provides Service tool password leveld
*GEOSTAT Provides the status of geographic mirroring on ALL ASPs
*HEADERFINDER
Provides a disk scan for bad disk headers
Parameters:
-L -U xxxx where xxxx is the unit number
-ASP xxx where xxx is ASP number
-STATUS provides % complete
-STOP stops the scan
*HRIFR Provides HRI IPL flight recorders
*IOFR Provides IO flight recorders (uses -ALL as parameter)
*IOHRIDEBUG Provides configuration information including VPD, logical and packaging resource hierarchy information and console data.
*IOSW Provides IO switchable entity information
*IOTAPEPATHS Provides information on tape resource paths
*IPLFR Provides a dump of IPL flight recorder
*JAVAGCINFO
Provides information on Java
Parameters:
-GCCYCLES
-DUMPJVMS
*JAVALOCKINF Provides information on Java locks
*LEVELOFPROTECTION Provides disk unit level of protection
*LICLOG
Provides methods to dump LIC logs
Parameters
LIST
NOTE
DUMP
Additional qualifiers such as ID, ALL, #IPLs, Date/Time
*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
*MOST Provides information on Ops console MOST flight recorders
*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.
*MSDINFO Provides information of MSDs contained on the partition
*MSDUSER Provides users viewing MSD
*MUTEXINFO Provides a list of mutex objects running on the system. These contain the actual locking mechanism and data useful in debugging synchronization problems.
*NETSTAT Collects the NETSTAT AA macro with -PIF option
*NVMEGAUGE Provides life expectancy gauge for NVME devices (release dependent)
*OPSCONSOLE Provides the Operations Console Flight Recorder data. Dumps problem debug info.
*PALLIST Lists the Product Activity Log entries.
*PERCENTTOSSD Provides a mechanism to control the percent the trace and balance function will use during the balance operation
*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
Parameters:
-a ADDRESS
-I
-PCS
-QS
*RACKCONFIG Collects a rack configuration
*RDMAINFO
Collects these items:
RDMASTAT -GRP
RDMASTAT -CNN
RDMASTAT -DUMPEPLS
RDMASTAT -DUMP QP
RDMASTAT -NRGLOG
RDMACONFIG -DISPLAY
LICLOG DUMP LAST HOUR TYPE 2C00
*RMTSTG
Provides Temporary storage accounting buckets. No parameters will dump all in-use buckets.
Optional parameters:
-L Display details for leaked allocations
-V xx where xx is the verbose bucket number
*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.
*TEST Reserved for internal use
*TLSCONFIG Same output as SSLCONFIG -DISPLAY
*TRACEINFO Provides listing of traces running on system (similar to WRKTRC command)
*VIOFR
Provides virtual IO flight recorders. Collects these information :
-iom -detail -fr
-vlan -detail -fr -all
-scsi -detail -fr -bus -devices
-client -detail -fr -engine -login -bus -transporter -crq
-vfc -detail -fr -ports -login -luns -bus -nexus -transporter -crq
*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.
*WRKSQEVAR No parameters accepted. Will show history (h option).

DATA - parameters that are pass to the macro (some do not accept additional data)
SST User Profile - A user profile that is linked to an SST profile.
Note: If the profile fails, this tool will swap to QSECOFR and use that instead. The user using this command needs to have authority to QSECOFR.
OUTPUT - spoolfile, physical file, or as a text file in the IFS
6.
An example of using the command from the command line to get SERVICEDOCS for a hang job is :

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

Sending data to IBM

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Component":"Data Collection","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.4;7.3;7.2;7.1","Edition":"","Line of Business":{"code":"LOB57","label":"Power"}}]

Historical Number

670614801

Document Information

Modified date:
31 March 2021

UID

nas8N1010377

Page Feedback