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). Default value of the attribute will be 9999999. Max value for the attribute should be <= 999999999999 and Min value for this attribute should be > 0. If the max_job_sequence_id is set to something smaller than current max_job_sequence_id then it will wrap to 0.

• 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: Illegal attribute or resource value
      qmgr: Error (15014) 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: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: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). To adjust the spaces between two fields "Job id" and "Name/Username" increased by 5. 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 work

 

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