IBM Support

MustGather: Reporting a save/restore performance issue that happend in the past

How To


Summary

This document should be followed when reporting a save/restore performance issue with your IBM i system. The document covers the following: performance questionnaire and collecting and uploading data.

Steps

Summary

This document should be followed when reporting a performance issue for any save/restore related functions on your IBM i system. The document covers the following: performance questionnaire and collecting and uploading data.

We always want joblogs if they are available. If joblogs are available for both a 'normal' example of a job and a 'long-running' example it is very helpful to have both. Please send joblogs in .txt format.  We have tools that work with joblogs, but the do not work with PDF files.

Steps

WARNING: The data cannot be reviewed without a clear explanation of the problem.
A problem description of "everything is slow", lacks important details; use Step 1 to provide the required details. 
 
Step 1:  Required Performance Questionnaire
  1. What needs to be fixed? For example, The backup job #####/User/Name ran 4 hours last night but it normally runs in 30 minutes, OR our backup job, named DAILYBKU running BRMS control group DAILY, is running twice as long as normal.
  2. What business function is impacted by slow performance on the system? For example, when the backup job does not complete by 3am, our nightly batch jobs do not kick off on time causing production delays in the morning.
  3. What is the timeline of this issue? For example, The DAILY backup suddenly started running twice as long on May 20 after we installed the latest cume and group ptfs OR the DAILY backup has been getting longer for the past several months and has now reached a critical level.
*If the issue appears to be system wide, please use this document and open a case with the system performance team.

 
Step 2: Verify the IBM MustGather tool is installed and current before proceeding! 
If the tool cannot be installed or updated, follow the Related Information section for alternate data collection instructions.
 
QMGTOOLS is a light-weight, noninvasive data collector tool provided by IBM.  The tool collects many logs and can take 30 - 60 minutes to complete.
  1. CALL PGM(QMGTOOLS/QGETVER) to display the build version. If it is more than three months old, proceed with step 2.
  2. QMGTOOLS/CMPVER then F6 = download and update
  3. If the QMGTOOLS library does not exist,  install the tool by using these instructions.
 
Step 3:  Collect SYSSNAP data
NOTE:  The light-weight QMGTOOLS/SYSSNAP command is non-invasive but can take several minutes to an hour or more to complete.  
 
Use the following on the IBM i command line: 
 
CALL QSYS/QCMD
QMGTOOLS/SYSSNAP OUTPUT(*IFS) COLLECTDFT(Y) LICLOGS(Y) PALS(Y) QHST(Y/Y) COLSRDTA(Y/Y/Y) CSDATA(Y) DAYSPRV(*DATE) STRDATE(MMDDYY)                  
                                                  
 
Where STRDATE is the MMDDYY of the beginning of the job.  It is very useful to have data for a 'normal' job and a 'long-running' job. If the performance issue started suddenly, please make the STRDATE far enough back to collect data for both a normal and long-running example.
Step 4:  Instructions for Sending Data to IBM i Support
NOTE: If you are a Blue Diamond Client, follow these instructions for sending data. 
 
The data will be stored in the IFS under the /tmp/SystemName_SYSSNAP_timestamp.zip directory.  Use QMGTOOLS to send the data. NOTE: you need to set up a transfer id (and optionally store it in QMGTOOLS) to transfer the data via QMGTOOLS. 
 
Example:  QMGTOOLS/FTP2IBMCMD FTPTYPE(*HTTPS) IBMID(transferID) IBMPWD(transferPWD) INPUT(*IFS) CASENBR(TSxxxxxxxxx) IFSFILE('/tmp/SYSNAME_SYSSNAP_202209272037.zip')
                                       
Reference:  https://www.ibm.com/support/pages/qmgtools-ftp-data-ibm
Alternate Methods:  https://www.ibm.com/support/pages/mustgather-instructions-sending-data-ibm-i-support

Document Location

Worldwide

[{"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":"a8m0z0000000CNIAA2","label":"Backup Recovery Install Migration-\u003EPerformance"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions"}]

Document Information

Modified date:
22 May 2024

UID

ibm17154648

Page Feedback