| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Start Job Watcher (STRJW) command starts the collection of detailed job performance data. It allows the user to obtain detailed data related to a selected set of jobs or tasks on the system. Job Watcher collects data on a sampling basis and writes the collected data to a set of database files. The file names all begin with the letters 'QAPYJW'. In addition to basic job information the user may optionally request SQL, activation group, sockets and TCP, and call stack data.
Restrictions:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| DFN | Definition | Name, *SELECT | Optional |
| COL | Collection | Name, *GEN | Optional |
| LIB | Library | Name, QPFRDATA | Optional |
| TEXT | Text 'description' | Character value, *DFN, *BLANK | Optional |
| RPLDTA | Replace data | *NO, *YES | Optional |
| COLITV | Collection interval | 0.1-3600.0, *DFN, *NODELAY | Optional |
| ENDCOL | End collection | Single values: *NOITVDTA Other values (up to 3 repetitions): Element list |
Optional |
| Element 1: Option | *NBRSEC, *DASDMB, *NBRITV | ||
| Element 2: Value | Integer, 60 | ||
| JOB | Job name | Single values: *DFN, *ALL, *NONE Other values (up to 20 repetitions): Qualified job name |
Optional |
| Qualifier 1: Job name | Generic name, name | ||
| Qualifier 2: User | Generic name, name, *ALL | ||
| Qualifier 3: Number | 000000-999999, *ALL | ||
| TASKNAME | Task name | Single values: *DFN, *ALL, *NONE Other values (up to 20 repetitions): Character value |
Optional |
| TDENBR | TDE number | Single values: *DFN Other values (up to 20 repetitions): Hexadecimal value |
Optional |
| Top |
Specifies the Job Watcher definition to use when starting a new Job Watcher collection. The definition identifies the parameters to use when starting a Job Watcher collection. A new Job Watcher definition can be created using the Add Job Watcher Definition (ADDJWDFN) command.
| Top |
Specifies the name of the collection. The name of the collection is the name of the database file member to which the output data will be written. If a member by this name does not exist in each Job Watcher database file, one will be created with the specified name. If a member by this name already exists, you must specify *YES on the Replace data (RPLDTA) parameter in order to write over the data in the existing member.
| Top |
Specifies the library where the database files for the Job Watcher data will exist. Each file that is not found in the specified library is automatically created in that library.
| Top |
Specifies the text to be used for each member across the set of Job Watcher database files associated with the collection.
| Top |
Specifies whether an existing set of Job Watcher database file members should be replaced with a new set of members with the same name.
| Top |
Specifies the interval between retrieval of job/task data. Job/task data is collected from the system on a sampling basis. This value specifies the amount of time that will elapse between the collection of each sample.
| Top |
Specifies the criteria which will end the collection. This parameter allows you to specify multiple conditions which will end the collection of data. If more than one end option is specified, the Job Watcher collection will end the first time any one of the specified criteria has been met.
You can specify 3 values for this parameter.
Element 1: Option
Single values
Other values
Element 2: Value
| Top |
Specifies the jobs that will be included in the Job Watcher collection. If a value is specified on this parameter it will override the value in the Job Watcher definition.
Single values
Other values (up to 20 repetitions)
Qualifier 1: Job name
Qualifier 2: User
Qualifier 3: Number
| Top |
Specifies the name of the task(s) which will be included in the Job Watcher collection. If a value is specified on this parameter it will override the value in the Job Watcher definition.
Single values
Other values (up to 20 repetitions)
| Top |
Specifies the Task Dispatching Element (TDE) number of the TDE(s) which will be included in the Job Watcher collection. The TDE number is a unique identifier assigned to each job, thread, and task running in the system. The TDE number may be found by using the Display list of tasks option in the Display/Alter/Dump function of Start System Service Tools (STRSST). If a value is specified on this parameter it will override the value in the Job Watcher definition.
Single values
Other values (up to 20 repetitions)
| Top |
Example 1: Start Job Watcher Using a Definition
STRJW DFN(MYDFN) COL(TEST) LIB(MYLIB)
This command will start a Job Watcher collection using the definition called MYDFN to determine which data will be collected. Assuming the shipped default of ENDCOL(*NBRSEC 60) is used, data collection will end after 60 seconds. Collected data will be written to the Job Watcher database files in library MYLIB in member TEST. The Job Watcher database file names all begin with 'QAPYJW'.
Example 2: Start Job Watcher Using a Collection Interval
STRJW DFN(MYDFN) COLITV(5) ENDCOL((*NBRITV 200))
This command will start Job Watcher to collect data using the definition called MYDFN. Data will be collected at an interval of 5 seconds, overriding the interval specified in the definition. Data collection will end after 200 intervals have been collected. Data will be written to the Job Watcher database files in library QPFRDATA in a member name which will be generated by Job Watcher based on the date and time the collection started.
Example 3: Start Job Watcher, Prompting to Select a Definition
STRJW DFN(*SELECT) COL(TEST) LIB(MYLIB)
ENDCOL((*DASDMB 100))
This command will open a prompt panel listing all Job Watcher definitions which currently exist on the system. The definition selected on this panel will be used to determine what data will be collected. Data collection will end after 100 megabytes of data have been written to the Job Watcher database files in library MYLIB in member TEST.
| Top |
*ESCAPE Messages
| Top |