Follow the PBS Pro Design Document Guidelines.

Links

Link to discussion on Developer Forum: http://community.pbspro.org/t/flag-fields-where-data-is-truncated-in-qstat/1604
Link to issue: <issue link if available>
Link to pull request: https://github.com/PBSPro/pbspro/pull/1150

Overview

Qstat has limited amounts of space for each column. Some of the columns are generous (job ids with -w are 30 characters long), but some aren't.

This feature will let qstat flag fields that were truncated.

Technical Details

Problem

Truncation can lead to some confusing outputs, where qstat shows my 1234 node job only has 123 nodes:

[vstumpf@shecil ~]$ qstat -s
shecil: 
                                                            Req'd  Req'd   Elap
Job ID          Username Queue    Jobname    SessID NDS TSK Memory Time  S Time
--------------- -------- -------- ---------- ------ --- --- ------ ----- - -----
5.shecil        vstumpf  workq    STDIN       22829 123   1    --    --  R 00:00

If I use -w to increase the column width, it will only help a bit; the number will then get truncated at 9999 instead of 999.

To get rid of this confusion, qstat should make it clear that there is data being truncated.

Solution

qstat will now print an asterisk (*) instead of the last character printed if it is truncated.This will notify the user that the data is truncated, and should either use -w for a wider output, or -f for a full status.

So my 1234 node job will now show like this:

[vstumpf@shecil ~]$ qstat -s
shecil:
                                                            Req'd  Req'd   Elap
Job ID          Username Queue    Jobname    SessID NDS TSK Memory Time  S Time
--------------- -------- -------- ---------- ------ --- --- ------ ----- - -----
5.shecil        vstumpf  workq    STDIN       22829 12*   1    --    --  R 00:00

OSS Site Map

Project Documentation Main Page

Developer Guide Pages