QMGTOOLS - Collect Com Data (Hardware Data Collection)

QMGTOOLS - Collect Com Data (Hardware Data Collection)
Troubleshooting
Problem
The QMGTOOLS library provides an efficient way to gather data to debug hardware issues.
Diagnosing The Problem
The QMGTOOLS library provides an efficient way to gather data to debug hardware issues. This document
describes communications data collection.
Resolving The Problem
Data collected from the Com data collection are as follows :
ALTSTACK AA macro
HEAFR AA macro
IOFR AA macro
PAL entries
Rack config
SERVICEDOCS AA macro
SID87 if PAL selected
VIOFR AA macro
VLOG entries
Note: This process uses a virtual device to sign onto the system as if it was a user. Once signed on, it goes into
SST and runs the necessary commands to dump the data. There may be issues if the system is in restricted a
state where no new sessions are allowed. Other issues may occur if the system has a unique sign on method
such as two factor authentication.
Step 1
Obtain and install a copy of QMGTOOLS library from IBM. Follow the links below for instructions.
http://www-01.ibm.com/support/docview.wss?uid=nas8N1011297
Step 2
Once installed, add QMGTOOLS to your library list via ADDLIBLE command. Run command GO MG to bring up
the QMGTOOLS main menu. In the example, option 19 is the Hardware data collection menu. Take that option.

The Hardware data collection menu has these options (as more menu options are added, this document will
reflect the changes).

Step 3
Select the menu option titled Collect Com Data or prompt on command QMGTOOLS/COL_COM.

OS400 user ID/password Credentials for sign on to i5/OS
SST user ID/password Credentials for SST
Virtual Device
Virtual device to use for signing on to the system
Note: This process uses a virtual device to sign onto the system as if it was
a user. Once signed on, it goes into SST and runs the necessary
commands to dump the data. There may be issues if the system is in
restricted a state where no new sessions are allowed. Other issues may
occur if the system has a unique sign on method such as two factor
authentication.
PAL/VLOG Y/N to collect PALs/VLOGs
Begin/End date If collecting PAL/VLOG entries, specify begin and end date
FTP data to IBM FTP data to IBM when done
Once the data is collected, the user will be presented with a screen like this (if FTP to IBM was used - default to
Y). Note the location of the file as shown here. If uploading the data fails using QMGTOOLS, this is the file that
needs to be retrieved and sent to IBM support.

Enter the PMR/PMH and hit F1 to continue to upload data to IBM.
If the upload is successful, a job would be submitted to batch to perform the upload. Additional information about
the FTP function can be found at the following link.
http://www-01.ibm.com/support/docview.wss?uid=nas8N1010370
Step 4
If there is a failure using QMGTOOLS to upload data to IBM. Refer to this link for manual instructions to retrieve
and send data to IBM.
QMGTOOLS - Sending Data To IBM Manually
https://www-01.ibm.com/support/docview.wss?uid=ibm10869926