IBM Support

MustGather: Collecting Job Watcher Data

Troubleshooting


Problem

Job Watcher commands are native to the operating system. Included in this document are instructions to collect Job Watcher data to aid in solving job or system-wide performance issues.

Resolving The Problem

Job Watcher commands are native to the operating system. Included in this document are instructions to collect Job Watcher data to aid in solving job or system-wide performance issues.

You should use the following instructions to collect one hour's worth of Job Watcher data.
Note: An IBM Support Representative might change some of the parameters specified, based on a specific problem being reported.

Step 1. Verify the required Job Watcher PTFs are applied:

V7R1:
https://www.ibm.com/support/pages/job-watcher-performance-explorer-pex-and-disk-watcher-ptfs-ibm-i-71
V7R2: https://www.ibm.com/support/pages/job-watcher-performance-explorer-pex-and-disk-watcher-ptfs-ibm-i-72
V7R3: https://www.ibm.com/support/pages/job-watcher-performance-explorer-pex-and-disk-watcher-ptfs-ibm-i-73
V7R4: https://www.ibm.com/support/pages/job-watcher-performance-explorer-pex-and-disk-watcher-ptfs-ibm-i-74

Step 2. Create a library for the data:

CRTLIB TSXXXXXXX (where XXXXXXX = your Case number without the leading zeros)

Step 3. Create the Job Watcher definition:

QSYS/ADDJWDFN DFN(QSLOW5) COLITV(5) ADDDTACGY((*CALLSTACK *ALWAYS) (*SQLCURSTMT *ALWAYS) ) WAITSTK((*CONFLICT 1) (*ABNWAIT 1) ) JOB((*ALL)) TASKNAME(*ALL) FRCRCD(*ITVEND) INCALLFST(*YES)

Step 4. Start the Job Watcher collection:

SBMJOB CMD(STRJW DFN(QSLOW5) COL(RUN1) LIB(TSXXXXXXX) ENDCOL((*NBRSEC 3600) (*DASDMB 4096))) JOB(JOBWATCHER) JOBQ(QSYS/QSYSNOMAX)

Note: Allow Job Watcher to collect for a few minutes before recreating the issue.  If you would like to collect for a smaller amount of time, change the ENDCOL parameter in Step 4 to something less than 3600 seconds. If you would like to collect for more time, increase the ENDCOL parameter to a maximum of 7200 seconds. If more data is needed, wait for the batch job in Step 4 to complete and start another collection (per Step 4, issue another SBMJOB command and alter the COL parameter to say RUN2, for example).

Step 5. After the JOBWATCHER batch job ends, save the data:

CRTSAVF QGPL/JWSAVF
SAVLIB LIB(TSXXXXXXX) DEV(*SAVF) SAVF(QGPL/JWSAVF) DTACPR(*MEDIUM)

Step 6.
Instructions for Sending Data to IBM i Support

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

The preferred data upload method is QMGTOOLS: FTP Data to IBM
http://www-01.ibm.com/support/docview.wss?uid=nas8N1010370

Step 7.  Send in a system snapshot by using QMGTOOLS
http://www-01.ibm.com/support/docview.wss?uid=nas8N1010353


If you would like to analyze the data using the iDoctor GUI client interface you should visit http://public.dhe.ibm.com/services/us/igsc/idoctor/html/downloadOptions.html. After registering for a 45-day Job Watcher Trial and reviewing the New User GUI Installation Requirements, you should click on the appropriate release of the operating system and download the Job Watcher Install Image.

If you would like to setup a continuous Job Watcher collection consider using QMGTOOLS with this document -
https://www.ibm.com/support/pages/qmgtools-job-watcher-monitor-function-continuous-job-watcher


To learn more about Job Watcher, refer to the following URL: http://public.dhe.ibm.com/services/us/igsc/idoctor/html/JW.html

Internal Use Only

I5/OS (5761SS100)

[{"Business Unit":{"code":"BU009","label":"Systems - Cognitive"},"Product":{"code":"SGYQGH","label":"IBM i"},"Component":"Performance","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions","Edition":""}]

Historical Number

579609384

Document Information

Modified date:
06 November 2019

UID

nas8N1011896