IBM Support

QMGTOOLS: Job Watcher Monitor Function (Continuous Job Watcher)

Question & Answer


Question

Is there a continuous Job Watcher function?

Answer

QMGTOOLS provides a program that allows for a continuous Job Watcher (JW) collection that collects and keeps a certain amount of collections.
Important notes: The MustGather Data Capture tool is provided as-is. It is created by IBM Support to help assist the user to capture data for debug. If you would like more information on using a JW monitor for your own purposes, see the following link.
Please install the required PTFs before collecting data: https://public.dhe.ibm.com/services/us/igsc/idoctor/html/ptfs.html
 
Installing QMGTOOLS
If QMGTOOLS is not installed, follow this URL :
 
Usage

Step 1 - Go to the Performance/Misc menu

To get to the Performance menu, type command GO QMGTOOLS/MG and the main Must Gather menu should be available like the example below. In this example, the Performance/Misc menu is option 3.

image 8916

Step 2 - Select the Monitors section and then select Continuous JW trace

image 8917


image 8926



Step 3 - Parameters

After selecting the Continuous JW trace, there is two options. *START to start the trace or *STOP to stop the trace.

When selecting *START, several parameters will appear in the next screen.

 
image 8927

 
Size of Job Watcher per collection The size of the collection in gigabytes
Second per collection How many seconds to run Job Watcher cycles to a new collection. Default is 1800 seconds or 30 minutes
Collection interval Job Watcher's main function is to take a snapshot of the system every xx seconds. Default is 10 seconds.
JW collection to keep How many collections to keep. Default is 2.
Library for collection The library to store the JW data (collection). Default IBMJW.

Note: Job Watcher will write to this library, so if any save is performed, omit this library if this program is active.
Collect SQL statements Collect SQL statements.
*NONE - does not collect any SQL statements
*LOW - collects *SQLCURSTMT *ALWAYS
*MED - collects *SQLSTMT *ALWAYS
*HIGH - collects *SQLDETAIL *ALWAYS
Include inactive jobs/tasks *YES, *NO

Specifies whether detailed data for all jobs and tasks, including inactive jobs and tasks, will be collected for
the first interval.
F-keys
F1 = Continue Continue and run the continuous JW program
F6 = Save and Exit To change defaults to parameters listed here, press F6 to save and exit the program. You will need to start again via *START command if you want to run the program.

You would normally do this if you would like to start the continuous JW trace without being prompted by this parameter screen.


Step 4 - Starting the job

From Step 3, after pressing F1, the continuous Job Watcher will be submitted. The jobs that are submitted will be:

JWMON jobxxxx BATCH ACTIVE PGM-QJWMON
IBMJW jobxxxx BATCH ACTIVE PGM-QJW

Note: If you want to start the continuous JW without going through the parameter screen, then submit the command the example below. However, before doing so, please verify the parameters from Step 3 and hit F6 to save/exit so the new defaults can be saved.

SBMJOB CMD(QMGTOOLS/QJWMONCMD FUNCTION(*START)) JOB(QJWMON) JOBQ(QSYSNOMAX)


Step 5 - Ending the JW continuous job

QMGTOOLS/QJWMONCMD FUNCTION(*STOP)

 
Where the data is stored

JW location

The JW data is located in the library specified by the parameter Library for collection. To save all of the collections, use the SAVLIB command or, to save some of the collections, use the SAVPFRCOL LIB(TheJWLIB) COLTYPE(*JWFILE) SAVF(TheSAVFLIB/theSAVF) command. 
The preferred data upload method is QMGTOOLS: FTP Data to IBM

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

Historical Number

N1020478

Document Information

Modified date:
18 January 2022

UID

nas8N1020478