IBM Support

MustGather: Collecting Job Watcher Data for Java issues

Troubleshooting


Problem

Slowness with jobs that run java commands.

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.

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: http://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:
Change the DFN and JOB parameter to the jobname having issues so we know this definition is only for that
QSYS/ADDJWDFN DFN(JOBNAME) TEXT('5 second intervals, call stacks, SQL, J9') COLITV(5) ADDDTACGY((*CALLSTACK *ALWAYS) (*SQLCURSTMT *ALWAYS) (*JAVA *ALWAYS) (*JAVASTACK *ALWAYS)) WAITSTK((*CONFLICT 1) (*ABNWAIT 1)) JOB((* JOBNAME)) TASKNAME(*ALL) FRCRCD(*ITVEND)

Step 4. Start the Job Watcher collection:
SBMJOB CMD(STRJW DFN(JOBNAME) 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.  Collect 3 java dumps while the job watcher is running using Step 3 from this document: MustGather: Java Virtual Machine General Issues: How to Collect Data for the IBM Technology for Java VM 

Step 6. 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 7. Instructions for Sending Data to IBM i Support:
The preferred data upload method is QMGTOOLS: FTP Data to IBM
Step 8.  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, 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, click the appropriate release of the operating system and download the Job Watcher Install Image.
 

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":"a8m0z0000000CKxAAM","label":"Performance-\u003ETools-\u003EJob Watcher"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions"}]

Document Information

Modified date:
10 June 2024

UID

ibm16583517

Page Feedback