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 the System Snapshot (SYSSNAP) program which collects general information about the IBM i from the command line interface. A typical SYSSNAP data collection will include many of the files shown below, depending on the current PTF level, and the options taken when the SYSSNAP was run.

Note: This list is dynamic. Depending on the current PTF level, some of the AA macro options might not be available. 

  • SYSSNAP

    Analyze_Default_Passwords.txt
    ASP_INFO.TXT
    COMMAND_DFT_CHANGE_REPORT.csv
    CS_Settings.txt
    DDM_lowest_authentication.txt
    DDM_Server_Authority.txt
    Display_Authorized_Users.txt
    Display_Function_Usage.txt
    Display_Hardware_Resource.txt
    Display_Job_Table.txt
    DISPLAY_PLATFORM_INFO.txt
    Display_Security_Attributes.txt
    Display_Security_Auditing.txt
    Display_Software_Resource.txt
    DSPCLUINF.txt
    DSPCRGINF.txt
    DSPIPLA.txt
    DSPJOB.txt
    DSPNETA.txt
    DSPUPSSTS.txt
    Firmware_Status.txt
    hardware_cmn.csv
    hardware_crp.csv
    hardware_csa.csv
    hardware_lws.csv
    hardware_prc.csv
    hardware_stg.csv
    JOB_QUEUE_ENTRIES_WAITING.csv
    JOB_QUEUE_INFO.csv
    Miscellaneous.txt
    Print_Profile_Internals.txt
    QADBERAP.txt
    QHST.txt
    QLZARCAPI.txt
    QPRUV_library.txt
    QPRUV_ObjectList.csv
    QSECOFR_basic_info.txt
    QSFWINV_program.txt
    QSYSOPR_messages.txt
    QSZRTVPR.txt
    QTCPCTL_joblog.txt
    QTCPWRK_joblog.txt
    QTRXLSIX_QRECOVERY.txt
    QUSRBRM_library.txt
    QWCCRTECCALL_QWCCRTEC_api.txt
    QWCRSSTS.txt
    Rack_configuration.txt
    SCPF_joblog.txt
    SYSFIELDS_FIELDPROCS.csv
    SYSFUNCS_INFO.csv
    SYSPROCS_INFO.csv
    SYSSNAP_joblog.txt
    System_Entry_Point_Table.txt
    System_Values.txt
    Tool_log.txt
    Tool_version.txt
    Work_With_Subsystems.txt
    WRKACTJOB.txt
    WRKACTJOB_tempstorage.txt
    WRKCTLD.txt
    WRKDEVD.txt
    WRKDSKSTS.txt
    WRKENVVAR.txt
    WRKJOBQ.txt
    WRKJOBQ_QBATCH.txt
    WRKJOBQ_QSYSNOMAX.txt
    WRKJOBSCDE_basic.txt
    WRKJOBSCDE_full.txt
    WRKLIND.txt
    WRKNWID.txt
    WRKNWSD.txt
    WRKRDBDIRE.txt
    WRKREGINF.txt
    WRKSHRPOOL.txt
    WRKSYSSTS.txt

  • LICENSE

    DSPLICKEY.txt
    LZA_OBJECT_DIRECTORY.txt
    QLZARTVK.txt
    QLZAVXFR.txt
    WRKLICINF.txt

  • NETSERVER

    QAZLSCFG
    QAZLSSHR

  • PALS

    PALS.txt
    PRTPALCLP_joblog.txt

  • PTF_INFO

    DSPPTF.txt
    DSPPTF_not_applied.txt
    Group_PTFs.txt
    Master_PTF_index.txt
    PTF_INFO.csv

  • SSH

    sshd_config.txt
    ssh_config.txt
    SSH_Version.txt

  • SSTDUMPS

    ASMINFO_144.txt
    BATTERYINFO.txt
    BRIDGEFR.txt
    CLUSTERINFO.txt
    DEBUGDDD.txt
    DISKALLDEBUG.txt
    DSMINFO.txt
    DUMPGSD.txt
    DUMPMIRRORINFO.txt
    DUMPTAPEINFO_DEVICES.txt
    DUMPTAPEINFO_MPMAP.txt
    DUMPVHRIPERS.txt
    Flash_Levels.txt
    GEOSTAT.txt
    HEAPINFO.txt
    IODD_ALLOBJECTS.txt
    IOFR.txt
    IOFR.txt_001
    IOHRIDEBUG.txt
    IONIOTAPE_-DMPPRMP.txt
    IONIOTAPE_IDS.txt
    IONIOTAPE_IDS_DEEP.txt
    IONIOTAPE_LIB.txt
    IOSW.txt
    IOTAPEPATHS.txt
    IPLFR.txt
    LISTTAPEDEVICES_ALL_DETAIL.txt
    LISTTAPEDEVICES_ALL_WIDE.txt
    LLHISTORYLOG.txt
    MSDINFO.txt
    NETSTAT_PIF.txt
    NVMEGAUGE.txt
    OPSCONSOLE.txt
    RMTSTG.txt
    SID87.txt
    SSDGAUGE.txt
    TLSCONFIG.txt
    TRACEINFO.txt
    VIOFR.txt
    WRKSQEVAR.txt

  • TCP

    Line_descriptions.txt
    prttcpifc.csv
    prttcprte.csv
    TCP_Connection_Status.txt
    TCP_Connection_Status2.txt
    TCP_Host_Table.txt
    TCP_Interfaces.txt
    TCP_Routes.txt
    Tool_log.txt
    WHOAMI.txt
    WRKSRVTBLE.txt

  • WRKCFGSTS

    WRKCFGSTS_CTL.txt
    WRKCFGSTS_DEV.txt
    WRKCFGSTS_LIN.txt
    WRKCFGSTS_NWI.txt
    WRKCFGSTS_NWS.txt

  • WRKPRB

    DSPPRB_BASIC.csv
    DSPPRB_CAUSE.csv
    DSPPRB_FIX.csv
    DSPPRB_SPTDTA.csv
    DSPPRB_USRTXT.csv

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. 
https://www.ibm.com/support/pages/mustgather-how-obtain-and-install-qmgtools-and-keep-it-current
 
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.

image-20250417102429-1
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.
 
 FTP Type Default is *NONE.  Specify *HTTPS if you wish the SYSSNAP data be uploaded to the case that you have open.  This requires TransferID
IBM/BD/TransferID Defaults to *STORED.  Transfer ID can be specified, or stored first with GO MG option 25  (STORFTPPWD).  Using *STORED makes it much easier for repeated uploads
IBM/BD/Transfer ID Password Specify password if transferID is not *STORED
Case Number The Case identifier.  TSxxxxxxxxx  (Example TS123456789)

System snapshot screen capture of parameters

System snapshot screen capture of parameters

System snapshot screen capture of parameters

image-20250417103004-2
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
For assistance with uploading information to IBM Support, please see 
http://www-01.ibm.com/support/docview.wss?uid=nas8N1019224

[{"Type":"MASTER","Line of Business":{"code":"LOB68","label":"Power HW"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"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:
17 April 2025

UID

nas8N1010353

Page Feedback