SHOWQ(1) User Contributed Perl Documentation SHOWQ(1) NAME showq - an expanded version of showq. SYNOPSIS showq [-A] [-C class] [-H] [-P] [-M] [-a account] [-b] [-c] [-f field_name] [-hp pattern] [-i] [-j jobid] [-m] [-o outspec] [-p partition] [-q qos] [-r] [-s status] [-u username] [-version] [-h] [-man] DESCRIPTION The showq command displays information about Moab jobs. OPTIONS -A Show jobs in hidden partitions. -C class_name Display only jobs requesting the class. -H Only show jobs without any other fields. -P Output is process based, and when applicable, diplay the masternode of the job, rather than the hostname. -M When applicable, diplay the masternode of the job, rather than the hostname. -a account_name Display only jobs requesting the account. -b Diplay only jobs that are blocked. -c Diplay only completed jobs. -f field_names Append additional field names to the default output format. fieldnames is a comma delimited list of fields. -h Display a brief help message -hp pattern If supported by your terminal, will display the specified pattern in inverse video. (Note: if your terminal should get hung up in inverse video mode, using "showq -cc" should clear it.) -i Display only eligible (idle) jobs. -j job_id Display this job. -m Display only non-running migrated jobs. -man Display man pages for this utility. -o outspec List only the fields specified by outspec. outspec may specify multiple fields, comma separated. Valid field specifications include: account, aging, ccode, class, dependency, effic, exehost, group, jobid, jobname, nodes, priority, procs, qos, rsvstarttime, state, username, xfactor, remaining/wclimit/walltime, completiontime/starttime/queuetime Field specifications may be abbreviated. Fields specified by the -o option will be listed in the order specified. Selecting any one of the following fields generates the correct heading and field depending on job category, so they are equivalent: remaining walltime wclimit As also are: starttime completedtime queuetime Default is: -o 'jobid username account qos class exehost state nodes remaining starttime' The environment variable SHOWQ_CONFIG may specify output format (e.g., "setenv SHOWQ_CONFIG jobid,username"). -p partition_name Displays only jobs listed in the specified partition. -q qos_name Displays only jobs listed in the specified partition. -r Display only active (running) jobs. -s status Display only jobs that have this status. -u user_name Display only jobs owned by the specified user. -v Display the verbose display, with more information. -version Display the version number. FIELDS The fields are as follows: ACCOUNT Account usage is charged to. CCODE Completion code for batch job. CLASS Class (pool, ie. pbatch) job has selected. DEPENDENCY The job that this one is waiting on. EFFIC CPU efficiency of job. EXEHOST Host of exectution. GROUP Group associated with user. JOBID Job identifier. JOBNAME Job name. NODES Number of nodes selected. PRIORITY Moab priority of job. PROCS Number of proccessors selected. QOS Quality of Service (defined below.) RSVSTARTTIME Highest priority job(s) projected startime. STATE Status of job (possibilities listed below.) USERNAME User owning job. XFACTOR Current expansion factor of job, where XFactor = (QueueTime + WallClockLimit) / WallClockLimit PROJECTEDSTARTTIME For non-active jobs, the time the job has is projected to begin exectuion. REMAINING/WCLIMIT/WALLTIME For active jobs, the time the job has until it has reached its wall clock limit or for idle/blocked/ completed jobs, the amount of time requested by the job. Time specified in [DD:]HH:MM:SS notation. COMPLETIONTIME/STARTTIME/ QUEUETIME Time job started running. POSSIBLE JOB STATES Supported status include: BatchHold Canceleing Completed Deferred Depend MaxJobs Migrated Multiple NoAcct NodeLimit ProcLimit Removed Running Starting SystemHold TooLong UserHold Wait Wcpu Wprio QOS DEFINITIONS Current possible values for "QOS"are: Normal - default Standby - preemptable Expedited - high priority, exempted from limits ADDITIONAL NOTES Jobs under the active heading are sorted by remaining time. Jobs under the eligible heading are sorted in priority order and if there is an asterisk after the job id, it has a pre-reservation. Jobs under the blocked headed are sorted by queue time. Jobs with a time limit > 300 days will show UNLIMITED. a '-' following the user name indicates failure to get the user's environment at job submission time.) If a job shows a "Multiple" status, use 'checkjob -v jobid' to determine its issues. AUTHOR NOTES I have taken some liberties with the status, trying to reflect a status that is more familiar to our users. In addition, this program also executes mdiag to try and get a little more status information than is provided by showq alone. There are requests in to CRI to provide more information than is currently available, and as that is provided this utility will be updated. REPORTING BUGS Report problems to Phil Eckert eckert2@llnl.gov. perl v5.16.3 2017-01-30 SHOWQ(1)