jstat(1) jstat(1) NAME jstat - displays job status information SYNOPSIS jstat [-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 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 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 ALSO csh(1), jlimit(1), sh(1). Page 3