How To
Summary
This document should be followed when reporting a network/communication performance issue with your IBM i system. The document covers the following: performance questionnaire and collecting and uploading data.
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.
A problem description of "everything is slow", lacks important details; use Step 1 to provide the required details.
Step 1: Required Performance Questionnaire
- What needs to be fixed? For example, our payroll jobs, named ABCCO, are running one hour longer and causing service agreements to be exceeded. The problem started after we applied PTFs on Sept. 15.
- What business function is impacted by slow performance on the system? For example, when payroll jobs do not complete by midnight, a financial impact occurs as the business is fined if payroll does not complete on pay day.
- To what extent has the performance of the business function changed and how is the slowness observed or measured? For example, a process used to complete in few minutes and now takes five hours to complete, causing night batch jobs (named ABCCO*) to run during daytime hours, leading to complaints from QPADEV* interactive users.
- What are the IBM i jobs (users or subsystems) responsible for processing the slow function? If you are not sure, what other information can you give us to identify the jobs in question?* For example, DRDA application is slow so focus on the QRWTSRVR jobs with user ID XYZ.
- What is the timeline of this issue? For example, we first noticed the problem on Sept 15th at 23:00, but the problem does not happen every night. On Sept 16th, the job completed normally. We need the problem resolved by Sept. 30th (before the next pay day).
*If the issue appears to be system wide, pick an example of one important job or workload that is measurably slower and provide us with the details as a focus point.
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 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.
- CALL PGM(QMGTOOLS/QGETVER) to display the build version. If it is more than three months old, proceed with step 2.
- QMGTOOLS/CMPVER then F6 = download and update
- 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 where MMDDYY is the date the performance issue occurred:
CALL QSYS/QCMD
QMGTOOLS/SYSSNAP OUTPUT(*IFS) COLLECTDFT(Y) LICLOGS(Y) PALS(Y) QHST(Y) COLDEVD(N) SRVDOCS(Y) COLSRDTA(N) COLSQL(Y) CSDATA(Y) DAYSPRV(3)
Step 4: Instructions for Sending Data to IBM i Support
NOTE: If you are a Blue Diamond client, use these instructions for sending the data
- The data is stored in the IFS under the /tmp/SystemName_SYSSNAP_timestamp.zip directory.
- NOTE: you need to set up a transfer id (and optionally store it in QMGTOOLS) to transfer the data via QMGTOOLS. Instructions for setting up a transfer ID.
- Use QMGTOOLS/FTP2IBMCMD to send the data. QMGTOOLS/FTP2IBMCMD FTPTYPE(*HTTPS) IBMID(transferID) IBMPWD(transferPWD) INPUT(*IFS) CASENBR(TSxxxxxxxxx) IFSFILE('/tmp/SYSNAME_SYSSNAP_202310272037.zip')
- If you cannot use QMGTOOLS/FTP2IBMCMD to FTP out of the system, see alternative methods here: https://www.ibm.com/support/pages/mustgather-instructions-sending-data-ibm-i-support
Related Information
Document Location
Worldwide
[{"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":"a8m0z0000000CHoAAM","label":"Performance"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.2.0;7.3.0;7.4.0;7.5.0"}]
Was this topic helpful?
Document Information
Modified date:
16 January 2024
UID
ibm16473739