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
Was this topic helpful?
Document Information
Modified date:
18 December 2019
UID
ibm10870050