Troubleshooting
Problem
Help collecting general information about the IBM i for technical support.
Diagnosing The Problem
The MustGather tools library (QMGTOOLS) contains a program to help collecting general information about the IBM i from a command line
interface. Data collected is as follows.
Note: This list is dynamic. Depending on the current PTF level, some of the AA macro options might not be available. At the time, of this writing, the current PTF that provides all of these options are MF65599 (R730) and MF65598 (R720).
Check the QMGTOOLS version by running command: CALL QMGTOOLS/QGETVER or GO QMGTOOLS/MG then option 12. Make sure you are at the latest build date. Do not use if QMGTOOLS has a build date less than November 10, 2014 (APAR - SE60609) or if the build date is between April 17,2019 and before July 16,2019. Follow this URL for instructions to get the latest QMGTOOLS:
https://www.ibm.com/support/pages/mustgather-how-obtain-and-install-qmgtools-and-keep-it-current
Analyze default passwords (ANZDFTPWD)
ASP information
BATTERYINFO AA macro
BRIDGEFR AA macro
Cluster Information
AA macro
Collect Services settings
Configuration descriptions (*NWS, *NWI, *LIN, *CTL, *DEV) - selectable parameter
CS Data (Collection Services) - selectable parameter
Display Authorized Users
Display Function Usage
Display Hardware Resources
Display Job Table
Display Security Attributes
Display Security Auditing
Display Software Resources
DDM Lowest Authentication
DDM Server Authority
Dump System Object For QGPL library
DISKALLDEBUG AA macro (contains disk debug data)
Display IPL Attributes
Display Network Attributes
Display PTF
Display software resources
DSMINFO AA macro
DUMPVHRIPERS AA macro (provides persistent VHRI data)
Environment variables
Firmware Status
Flash Levels AA macro
GEOSTAT AA macro
Group PTFs
Installed Software Information (QSFWINV)
IODD -ALLOBJECTS AA macro
IOFR AA macro
IOHRIDEBUG AA macro
IOSW macro
LLHISTORYLOG AA macro
Master PTF Index
MUTEXINFO AA macro - if SERVICEDOCS AA macro is selected
OPSCONSOLE AA macro
PALs - selectable parameter
Print Profile Internal
Print rebuild access path information
Print software resources
QHST - selectable option
QLZARCAPI API (partition capacity information)
QSECOFR Basic Information
QSYSOPR message queue
QUSRBRM Library Information
QWCCRTEC API (Time spent in IPL)
Rack Configuration
SERVICEDOCS AA macro - selectable option
SID87
System Entry Point Table
System Values
SCPF job log
TCP attributes
TCP connection Status
TCP domain Information
TCP host Table
TCP Interfaces
TCP Routes
TLSCONFIG AA macro (provides SSL config information)
VIOFR AA macro
VLOGs - selectable option
Work With Subsystems
Work Active Jobs
Work Disk Status
Work With Job Schedule Entries
Work License Information
Work Reg Information
Work Shared Pool
Work System Status
WRKPRB information
XSM information
Resolving The Problem
NOTE: Do not use if QMGTOOLS has a build date less than November 10, 2014 (APAR - SE60609) or the build date is between April 17, 2019 and before July 16, 2019.
1. |
Use the latest QMGTOOLS build. See the following document on how to download and install the QMGTOOLS toolkit on your IBM i server. The following URL contains additional information.
http://www-01.ibm.com/support/docview.wss?uid=nas8N1011297 |
||||||||||||||||||||||||||||||||||||||||||
2. |
To run SYSSNAP from a command line, see the following URL.
Add QMGTOOLS to the library list (ADDLIBLE QMGTOOLS) and type GO MG.
Note: The user running this command needs to have some authority like QSECOFR to avoid errors.
|
||||||||||||||||||||||||||||||||||||||||||
3. |
Select the System Snapshot option. In this example, it is Option 1. |
||||||||||||||||||||||||||||||||||||||||||
4. |
The options are as follows:
|
||||||||||||||||||||||||||||||||||||||||||
5. |
Once completed, you receive a notification similar to the following example regarding where the data is stored. If you do not see that message, check your job log for the data location.
|
Collecting and sending diagnostic information to IBM Support
http://www-01.ibm.com/support/docview.wss?uid=nas8N1019224
Historical Number
674355535
Was this topic helpful?
Document Information
Modified date:
02 November 2023
UID
nas8N1010353