jstat(1)jstat(1)NAMEjstat - displays job status information
SYNOPSISjstat [-a] [-j job_id] [-l] [-p] [-P]
DESCRIPTION
The jstat command displays information for active jobs.
The jstat command accepts the following options:
-a Displays information about all jobs.
-j job_id Displays information only for the specified job ID
(job_id).
-l Displays limit information about the specified job
including the current usage, current limit, and
maximum limit. Memory information is displayed in
bytes.
-p Displays information about each process that belongs
to the job including the process ID, state, and
executing command.
-P Displays the memory information in pages rather than
in bytes. This option is used with the -l option.
The usage values and limits apply to the job as a whole. The usage
values are the aggregate sum of all running processes of the job at the
time of the jstat command invocation.
If no options are specified, the jstat command will return the current
job ID, user name of the job owner, and root command for that job. The
job ID is printed out in hexadecimal.
% jstat
JID OWNER COMMAND
--------------- -------------- --------------
0x17 dan -ksh
If the -j option with a job_id argument is specified, the jstat command
will return summary information for the entered job: job ID, owner, and
command. The job_id argument is expected in hexadecimal. The "0x"
prefix is optional.
% jstat-j 0x14
Page 1
jstat(1)jstat(1)
JID OWNER COMMAND
--------------- -------------- --------------
0x14 janet -csh
If the -l option is specified, the jstat command will print out the
current usage, high usage, current limit, and maximum limit information
for the current job. Summary information is always printed. vmemory is
virtual memory. ressetsize is resident set size.
% jstat-l
JID OWNER COMMAND
------------------ -------------- --------------
0x106f user1 -tcsh
LIMIT NAME USAGE HIGH USAGE CURRENT LIMIT MAX LIMIT
------------------ -------------- -------------- -------------- --------------
cputime 0 0 unlimited unlimited
datasize 272k 544k unlimited unlimited
files 8 32 400 5000
vmemory 4224k 14112k unlimited unlimited
ressetsize 3520k 6384k unlimited unlimited
threads 1 1 unlimited unlimited
processes 2 7 1024 1024
physmem 3520k 6384k unlimited unlimited
If the -p option is specified, the jstat command will print out
information for each process that belongs to that job. Process
information includes the PIDs, PPIDs, and COMMAND information for the
job. Summary information is always printed.
% jstat-p
JID OWNER COMMAND
--------------- -------------- --------------
0x17 dan -ksh
PID PPID COMMAND
--------------- -------------- --------------
2225 2308 -ksh
2350 2225 jstat-p
Page 2
jstat(1)jstat(1)
If the -l and -P options are specified, the jstat command will print out
the same information that the -l option dislays with the exception that
memory values are shown in pages. SGI systems support multiple page
sizes. For more information on pages sizes, see the "Multiple Page
Sizes" section, chapter 10, "System Performance Tuning" in the IRIX
Admin: System Configuration and Operation manual.
% jstat-lP
JID OWNER COMMAND
------------------ -------------- --------------
0x170 dan -csh
LIMIT NAME USAGE HIGH USAGE CURRENT LIMIT MAX LIMIT
------------------ -------------- -------------- -------------- --------------
cputime 0 0 unlimited unlimited
datasize 7 7 unlimited unlimited
files 9 35 400 5000
vmemory 120 245 unlimited unlimited
ressetsize 43 43 unlimited unlimited
threads 2 4 2048 2048
processes 2 4 1024 1024
physmem 43 43 unlimited unlimited
If the -a option is specified, the jstat command prints out information
for all jobs on the system.
% jstat-a
JID OWNER COMMAND
--------------- -------------- --------------
0x1 root -ksh
0x14 janet -csh
0x17 dan -ksh
NOTES
The jstat command is installed as part of the eoe.sw.jlimits package.
SEE ALSOcsh(1), jlimit(1), sh(1).
Page 3
