IBM Support

QMGTOOLS: System Snapshot (SYSSNAP)

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.

QMGTOOLS main menu

4.



 
The options are as follows:
 
Output
Currently only supports *IFS.  If *PF is specified, it will change automatically to *IFS and use the IFS directory path.

NOTE: Do not use SYSSNAP if QMGTOOLS has a build date less that November 10, 2014 or the build data is between April 17,2019 and before July 16, 2019.
Collect default info Default is Y, which collects the normal data specified in the beginning of this document. If you want specific data such as the selectable parameters only, then set to N. Selectable parameters are after this parameter.
Collect VLOGS Y or N to collect VLOG entries
Collect PALS Y or N to collect PAL entries
Collect QHST
PRTSECLVL
Y or N
If Collect QHST is Y, Y or N to print the history with SEC level
Collect device descriptions Collect information on descriptions of type *NWS, *NWI, *LIN, *CTL, *DEV
Collect SERVICEDOCS Y or N to collect SERVICEDOCS AA macro
Collect SR data Y or N to collect Save Restore data
Collect BRMS data (QSRSRV) If collect SR data is Y and this parameter is Y, then collect BRMS data by using service program QSRSRV
Collect device FR (QSRSRV) If collect SR data is Y and this parameter is Y, then collect device flight recorders by using service program QSRSRV
Collect SQL data Y or N to collect SQL data
Collect PC snapshot
Y or N to collect plan cache snapshot (Collect SQL data must be Y)
Collect active dump
If collect SQL data is Y and this parameter is Y, then we get an active dump of an SQL job by using program QQQOOOCACH with A:D option.
Job name, user, number If collect active dump is Y, then enter the job information to dump
Collect CS data
Y or N to collect Collection Services data
Previous days to collect
If VLOGS, PALS, QHST, Collect CS data was specified, how many days to you want to go back to collect or put in *DATE if you want a date range
*NOTE  CS data will only be collected for a maximum of 5 days
Begin/End data
If *DATE is specified for Previous Days To Collect, put the begin and end date here
*NOTE  CS data will only be collected for a maximum of 5 days.  It will capture the
last 5 days of the begin/end data.
Additional library to save Add up to 3 libraries that you want to save along with SYSSNAP.
Library name
  File Name
  Recreate file
If the output is *PF, then specify the library to put the file. Default library is QTILIB. Default file is SYSSNAP. Recreate file means you want to delete the one that is already there from a previous collection.
IFS directory Where to place the SYSSNAP directory of the collect data. Default is /tmp.  The IFS Path MUST NOT contain spaces.
Zip data
Y or N to zip the collected data. Once compressed, the name of the file is /tmp/<system_name>_SYSSNAPxxxx.zip where xxxx is a number.

System snapshot screen capture of parameters

System snapshot screen capture of parameters

System snapshot screen capture of parameters

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.
 
SYSSNAP completion screen

Collecting and sending diagnostic information to IBM Support

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

[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000CGbAAM","label":"General Information"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions"}]

Historical Number

674355535

Document Information

Modified date:
02 November 2023

UID

nas8N1010353