PBS Pro Community Forum Link: http://community.pbspro.org/t/pp-289-unique-job-ids-up-to-1-trillion/465

Currently the largest possible Job ID which PBS can hold is "9999999". Which is a bit low for sites submitting lot of jobs. With new enhancement the largest possible Job ID that PBS would now hold will be "999999999999". Thus the range will be (0 to 999999999999) with a total of 1 trillion unique job IDs. 

• Interface 1: max_job_sequence_id server attribute

  • Visibility: Public
  • Change Control: Stable
  • Details: Using this attribute admin can change max job sequence id in the server. Once max job sequence id reaches to the max value(999999999999) then server will rollback the job sequence id to 0 (i.e next job or reservation id). If the max_job_sequence_id is set to something smaller than current max_job_sequence_id then it will wrap to 0(ZERO).
    • Default value of the attribute will be 9999999.
    • Max value for the attribute is "999999999999"
    • Min value for the attribute is "9999999"
    • max_job_sequence_id attribute value can be anything between 9999999 to 999999999999 only.

• Log/Error messages:
  • When non privileged user try to set max_job_sequence_id then following error message will be displayed by qmgr:
    • qmgr obj= svr=default: Unauthorized Request 
      qmgr: Error (15007) returned from server
  • When admin try to set invalid value for max_job_sequence_id then following error message will be displayed by qmgr:

    • qmgr obj= svr=default: Cannot set max_job_sequence_id < 9999999, or > 999999999999

    • qmgr: Error (15225) returned from server

  • Following log message will be added to server logs when admin sets max_job_sequence_id:
    • Log event: PBSEVENT_ADMIN
    • Log level: LOG_NOTICE
    • Log message:svr_max_job_sequence_id set to val <value>
  • Following log message will be added to server logs when admin unset max_job_sequence_id:
    • Log event: PBSEVENT_ADMIN
    • Log level: LOG_NOTICE
    • Log message:svr_max_job_sequence_id reverting back to default val <value>

• Interface 2: qstat output
  

  • Visibility: Public
  • Change Control: Stable
  • Details: As PBS_MAXSEQNUM changed from 7 to 12 to support 1 trillion sequence id, so all qstat output's header also got changed for all the options (like qstat -n/-s/-st etc). In all the qstat options only change is the space between two fields "Job id" and "Name", increased the count of '-'(hyphen's) between them. Given below the output of qstat command(see below space between "Job id" and "Name" field and also count of '-' in next line).
    
    • Previous output :

      • Job id            Name             User              Time Use S Queue
        ----------------  ---------------- ----------------  -------- - -----
        1.vision          STDIN            pbsuser1          00:00:00 R workq

  • • New output :

                   Job id                 Name             User              Time Use S Queue
                   ---------------------  ---------------- ----------------  -------- - -----
                   1.vision               STDIN            pbsuser1          00:00:00 R workq

                            Example: Given below an example in which we can see the change in qstat output format:

                                           Previous Output: If max job id is "9999999"  and server name is "servername-cent7" then output displays in Job id column like 9999999.servernam

                                           New Output: Now, if max job id is increased to "999999999999" then output would be like 999999999999.serv

• Interface 3: pbs_rstat output
  

  • Visibility: Public
  • Change Control: Stable
  • Details: As PBS_MAXSEQNUM increased from 7 to 12, so pbs_rstat output header also got changed slightly (increased the count of '-'(hyphen's) at the end of the line) and also need to increase the column width of "Resv ID" and "Queue". Currently, width of "Resv ID" and "Queue" is 10 and 8 so after implementation it would be become 15 and 13 respectively. These changes will definitely break the backward compatibility of pbs_rstat command. 
    
    • Given below the output of pbs_rstat command.
    • Previous output:

                                                        Resv ID Queue User State Start / Duration / End

                                                       ---------------------------------------------------------------------

                                                        R5.blrpc67 R5 bhagatr@ CO Today 14:00 / 7200 / Today 16:00   

• • • New output:

                                                        Resv ID Queue User State Start / Duration / End

                                                        ------------------------------------------------------------------------------- // added extra '-' here

                                                        R6.blrpc67 R5 bhagatr@ CO Today 17:00 / 7200 / Today 18:00

                              Example: Given below an example in which we can see the change in pbs_rstat output format:

                                           Previous Output: If max reservation id is "9999999"  and server name is "servername-cent7" then output displays like: 

                                            New Output: Now, if column width is increased to 15(Resv ID) and 13(Queue) and max reservation id also increased to "999999999999" then output would be like:

Limitation: With this implementation the maximum length of Job name (PBS_MAXJOBNAME) will be limited to 230 character wide.