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: https://public.dhe.ibm.com/services/us/igsc/idoctor/html/ptfs.html

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) TGTRLS(*CURRENT) DTACPR(*MEDIUM)

Step 6. Instructions for Sending Data to IBM i Support

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

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

Related Information

MustGather: Collecting Job Watcher Data for Communications Performance Problems

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Component":"Performance","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB57","label":"Power"}}]

Historical Number

579609384

Was this topic helpful?

Document Information

Modified date:
04 August 2023

UID

nas8N1011896

Tips