Resetting the job count

Resetting the job count to zero on a server

On the Servers page, use Reset Job Count to reset the job count (BF_JOBS) for the selected server to zero. BF_JOBS is the number of steps or jobs currently running on the server; if this number is set too low, jobs can fail from job contention.

This selection allows you to reset BF_JOBS if it does not correctly reset when a job completes, fails, or is canceled.

For example, canceling multiple jobs occasionally fails to reset BF_JOBS. If BF_JOBS is not reset, it can reach the limit for the Max Jobs settings, causing steps or jobs to not run.

  1. Select Servers to display the list of servers.
  2. Select a server.
  3. Click Reset Job Count.

Resetting the job count to zero on all servers

Use the Reset Server Job-Count page to simultaneously reset to zero the job count (BF_JOBS) for all servers. The BF_JOBS property is the number of steps or jobs that are running on the server; if this number is set too low, jobs can fail from job contention.

After you reset the BF_JOBS value for all servers, the Reset Server Job-Count value reverts to No, the default setting.

For example, when you cancel several jobs, occasionally the build system fails to reset the BF_JOBS value. If the BF_JOBS value is not reset, the value can reach the limit for the default Max Jobs system settings, causing steps or jobs to not run.

  1. Click Administration > System to display the list of system configuration settings.
  2. Locate Reset Server Job-Count.
  3. Click Reset Server Job-Count.
  4. Click the Details tab, and click Yes as the value.
  5. Click Save.

Feedback