RTVJOBPERF RETRIEVE JOB PERFORMANCE TAAJOFH |
The Retrieve Job Performance command retrieves performance
information about the current job. A 'reset' of the statistics must
first be used for the job by using either RESJOBPERF or RTVJOBPERF
RESET(*YES). Following the running of normal commands, RTVJOBPERF
RESET(*NO) may then be used to retrieve the performance information
that has occurred since the last 'reset'.
The API QUSRJOBI is used to retrieve the statistics.
A typical series of commands is thus:
DCL &CPUTIM *DEC LEN(15 0)
.
RESJOBPERF
/* */
/* Your commands that you want to access */
/* performance statistics for */
/* */
RTVJOBPERF RESET(*NO) CPUTIM(&CPUTIM)
The CPU time in milliseconds would be returned that the job has used
since the last reset.
See the CVTJOBPERF tool for collecting information about other jobs.
The RESJOBPERF command is a simple front end to RTVJOBPERF that make
it more obvious that you are resetting the job performance
statistics.
RTVJOBPERF escape messages you can monitor for
----------------------------------------------
None. Escape messages from based on functions will be re-sent.
RESJOBPERF escape messages you can monitor for
----------------------------------------------
None. Escape messages from based on functions will be re-sent.
RTVJOBPERF Command parameters *CMD
-----------------------------
RESET A *YES/*NO value that determines when to reset the
job performance statistics.
Either the companion command RESJOBPERF or
RTVJOBPERF with RESET(*YES) must be specified to
both begin the collection of job statistics or reset
the statistics. Each time *YES is specified, the
system resets the statistics for the job.
*NO is used when job statistics from the last reset
should be retrieved.
DSKCNT A count of the number of disk I/Os that have
occurred. This is the sum of DSKSYNCNT and
DSKASYCNT. This is an optional return variable that
if used must be specified as *DEC LEN(15 0).
DSKSYNCNT A count of the number of synchronous disk I/Os that
have occurred. This is an optional return variable
that if used must be specified as *DEC LEN(15 0).
DSKASYCNT A count of the number of asynchronous disk I/Os that
have occurred. This is an optional return variable
that if used must be specified as *DEC LEN(15 0).
RSPTIM The number of milliseconds of response time. This
value will be 0 for a batch job. This is an
optional return variable that if used must be
specified as *DEC LEN(9 0).
TRANS The number of transactions that have occurred. This
value will be 0 for a batch job. This is an
optional return variable that if used must be
specified as *DEC LEN(9 0).
CPUPCT The percentage of CPU time for the job relative to
the total system. This value is returned as 5
digits with an implied value on 'nnnn.n'. If '103'
is returned, the job has used 10.3 percent of the
CPU. This is an optional return variable that if
used must be specified as *DEC LEN(5 0).
DBFCPUPCT The percentage of data base CPU time for the job
relative to the total system CPU time. This value
is returned as 5 digits with an implied value on
'nnnn.n'. If '103' is returned, the data base
activity for the job has used 10.3 percent of the
CPU. This is an optional return variable that if
used must be specified as *DEC LEN(5 0).
CPUTIM The amount of CPU time in milliseconds. This is an
optional return variable that if used must be
specified as *DEC LEN(15 0).
DBFCPUTIM The amount of data base CPU time in milliseconds.
This is an optional return variable that if used
must be specified as *DEC LEN(15 0).
LCKWATTIM The amount of lock wait time in milliseconds. This
is an optional return variable that if used must be
specified as *DEC LEN(15 0).
PAGEFAULT The number of page faults. This is an optional
return variable that if used must be specified as
*DEC LEN(15 0).
RESJOBPERF Command parameters *CMD
-----------------------------
No parameters exist.
Restrictions
------------
The RESET parameter must first be used for the job followed by the
commands that you want to report statistics on.
Because the command returns variables, RTVJOBPERF may only be used in
a CL program.
Prerequisites
-------------
The following TAA Tools must be on your system:
SNDESCINF Send escape information
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
TAAJOFH *CMD TAAJOFH QATTCMD
TAAJOFH2 *CMD TAAJOFH2 QATTCMD
TAAJOBHC *PGM CLP TAAJOFHC QATTCL
TAAJOBHC2 *PGM CLP TAAJOFHC2 QATTCL
TAAJOFHR *PGM RPGLE TAAJOFHR QATTRPG
|
Added to TAA Productivity tools April 15, 2010
