Allow -w for qstat's alternate job status options
Follow the PBS Pro Design Document Guidelines.
Links
- Link to discussion on Developer Forum: http://community.pbspro.org/t/design-for-allowing-w-for-more-qstat-options/1579
- Link to issue: <issue link if available>
- Link to pull request: https://github.com/PBSPro/pbspro/pull/1115
Overview
Without wide option "-w" to qstat, it truncates the data in most of the columns in the output. Sometimes the output confuses users and admins. For example a job with 2000 cores is shown as 200 cores.
Unfortunately, "-w" option stopped working with the combination of "-r", "-t" and "-rwt". This is correct behavior as per documentation. However, it used to work in versions < 18.0
Design
Instead of only allowing -w to be used with any of "ansTf", allow it for any of qstat's alternate job status options. Also, allow it for the "normal" display.
The only new code that has to be written is for qstat -w
, as that has not ever been allowed.
Keeping with the design of -w, the output of qstat -w
will consist of the following:
Column Name | Normal spacing | Wide spacing |
---|---|---|
Job id | 17 (or 22 if maxjobid > 10million) | 30 |
Job name | 16 | 15 |
Username | 16 | 15 |
Queue | 16 | 15 |
The following is a comparison:
[vstumpf@shecil pbspro]$ qstat
Job id Name User Time Use S Queue
---------------- ---------------- ---------------- -------- - -----
1.shecil STDIN vstumpf 00:00:00 R workq
2[].shecil STDIN vstumpf 0 B workq
3.superlongserver STDIN vstumpf 00:00:00 R workq
4.superlongserver STDIN vstumpf 00:00:00 R workq
5[].superlongserv STDIN vstumpf 0 B workq
1000000.superlong STDIN vstumpf 00:00:00 R workq
1000001.superlong STDIN vstumpf 0 Q workq
[vstumpf@shecil pbspro]$ qstat -w
Job id Name User Time Use S Queue
------------------------------ ---------------- ---------------- -------- - -----
1.shecil STDIN vstumpf 00:00:00 R workq
2[].shecil STDIN vstumpf 0 B workq
3.superlongservername STDIN vstumpf 00:00:00 R workq
4.superlongservername STDIN vstumpf 00:00:00 R workq
5[].superlongservername STDIN vstumpf 0 B workq
1000000.superlongservername STDIN vstumpf 00:00:00 R workq
1000001.superlongservername STDIN vstumpf 0 Q workq
Project Documentation Main Page