Share via


Manage Queue Jobs (Project Server 2010 settings)

 

Applies to: Project Server 2010

Topic Last Modified: 2011-04-15

The Manage Queue Jobs settings are available through the Microsoft Project Server 2010 Server Settings page in the Queue section. For more information about related administrative settings, see Queue (Project Server 2010 settings).

The Manage Queue Jobs page lets you view Project Server 2010 operations ("jobs") that have been processed by the Microsoft Project Server 2010 queue system. You can use the configuration options to filter jobs and only see the jobs that you are interested in viewing. You can also retry or cancel jobs through this page. The page contains two sections:

  • Queue Jobs settings   Contains settings that let you configure which jobs appear in the Jobs Grid and configure which columns are displayed.

  • Jobs Grid   Displays jobs that have been processed by the queue, based on the Queue Jobs settings.

Queue Jobs settings

The Manage Queue Jobs page lets you view jobs in the queue through the jobs grid. Viewable jobs are displayed according to the following filter options:

  • Filter Type

  • Job History

  • Job Types

  • Job Completion States

  • Columns

  • Advanced Options

Filter Type

The Filter Type configuration option lets you select filters to query for specific types of jobs that will appear in the Jobs Grid. The filters available in the Filter Type drop-down list are as follows:

  • By Status   Displays jobs in the queue in order by status. This is the default setting.

  • My Jobs   Displays only the jobs initiated by you.

  • By Project   Displays jobs in the queue in order by project.

  • By ID   Displays jobs in the queue in order by Job ID.

  • Active   Displays all jobs that have a status of Active.

  • Blocked   Displays all jobs that have a status of Blocked.

To select a filter

  1. On the Server Settings page, in the Queue section, click Manage Queue Jobs.

  2. On the Manage Queue Jobs page, in the Filter Type section, click the Filter Type drop-down list and select the type of filter that you want to use to determine which jobs appear in the Jobs Grid.

  3. In the Jobs Grid, click Refresh Status.

    Jobs in the Jobs Grid appear according to the filter type that you select. For example, if you select the By Status filter, jobs are listed alphabetically by status.

Job History

This configuration option enables you to select the date range of jobs that appear in the Jobs Grid. Use the From and To fields to select a beginning and end data. The default selection is to select the one-day date range for the present date.

You can use the Maximum Number of Jobs field to limit the number of jobs that appear for a given date range. If the selected date range contains a very large number of jobs that have to appear in the Jobs Grid, the load time for the Manage Queue Jobs page can be very long. The Maximum Number of Jobs field lets you limit the jobs that appear. The default setting is 500.

To configure the Job History setting

  1. On the Server Settings page, in the Queue section, click Manage Queue Jobs.

  2. On the Manage Queue Jobs page, in the Job History section, specify the following values:

    • In the From field, specify the start date for which you want jobs to appear in the Jobs Grid. You can also click the calendar icon to select a start date.

    • In the To field, specify the end date for which you want jobs to appear in the Jobs Grid. You can also click the calendar icon to select an end date.

  3. In the Maximum number of jobs per queue box, you can specify the maximum number of jobs that you want to display. The default value is 500.

  4. In the Jobs Grid, click Refresh Status.

Job Types

The Job Types configuration option lets you select the type of job (for example, Project Create, Timesheet Submit, Notifications, and so on) that you want to appear in the Jobs Grid. By default, all job types are listed in the Selected Jobs list.

To configure the Job Types setting

  1. On the Server Settings page, in the Queue section, click Manage Queue Jobs.

  2. On the Manage Queue Jobs page, in the Job Types section:

    • If you want to keep certain job types from appearing in the Jobs Grid, from the Selected Jobs list, select the job types that you do not want to appear in the Jobs Grid, and then click Remove. (This action moves the selected job types to the Available Jobs list.) Click Remove All if you want to remove all job types from the Selected Jobs list.

    • If you want to add jobs types to the Jobs Grid, from the Available Jobs list, select the job types that you want to appear in the Jobs Grid, and then click Add. This action moves the selected job types to the Selected Jobs list. Click Add All if you want to add all job types to the Selected Jobs list.

  3. In the Jobs Grid, click Refresh Status.

Job Completion States

The Job Completion States configuration option lets you select the job states (for example, Success, Blocked Due to a Failed Job, Processing, and so on) of the jobs that you want to appear in the Jobs Grid. By default, all job state types except Success are listed in the Selected Jobs list. By default, Success is not available because we assume Project Server Administrators are more interested in problems that can be caused by non-successful jobs instead of successful jobs.

This setting can be helpful for troubleshooting jobs that are not completing successfully in the queue. For example, some users might have experienced problems over the past several days. You can see specifically which jobs are not completing successfully by going to the Job Completion States setting and adding all job states except Success. You can also select a Job History date range that begins shortly before the problems occurred (for example, seven days). In this scenario, the Jobs Grid should display information about all jobs that are in a non-successful job status that have occurred over the past week.

The Job Completion states that you can select for this setting are as follows:

  • Blocked Due to a Failed Job

  • Cancelled

  • Failed and Blocking Correlation

  • Failed but not Blocking Correlation

  • Getting Queued

  • Processing

  • Skipped for Optimization

  • Success

  • Waiting to be Processed

  • Waiting to be Processed (On Hold)

  • Waiting to be Processed (Ready for Launch)

  • Waiting to be Processed (Sleeping)

To configure the Job Completion States setting

  1. On the Server Settings page, in the Queue section, click Manage Queue Jobs.

  2. On the Manage Queue Jobs page, in the Job Completion States section, add all job states that you want to display in the Jobs Grid to the Selected Job States list. Job states that are shown in the Available Job States list will not appear in the Job Grid.

    • To move an available job state in the Available Job States list to the Selected Job States list, select the job and then click Add.

    • To remove a job state from the Selected Job States list, select the job and then click Remove. To select multiple job states press the Ctrl key while making your selections.

  3. In the Jobs Grid, click Refresh Status.

Columns

The Columns configuration option lets you select the columns that appear in the Jobs Grid. It also lets you configure the order of the columns in the Jobs Grid.

The column options available to you are as follows:

  • Completed Time

  • Correlation ID

  • Correlation Priority

  • Entry Time

  • Job ID

  • JobGroup ID

  • JobInfo ID

  • Job State

  • Job Type

  • Last Admin Action

  • Position

  • Priority

  • Project Name

  • Queue Type

To configure the Columns setting

  1. On the Server Settings page, in the Queue section, click Manage Queue Jobs.

  2. On the Manage Queue Jobs page, in the Columns section, add all job states that you want to display in the Jobs Grid to the Selected Job States list. Job states that are shown in the Available Job States list will not appear in the Job Grid.

    • To move an available job state in the Available Job States list to the Selected Job States list, select the job and then click Add.

    • To remove a job state from the Selected Job States list, select the job and then click Remove. To select multiple job states press the Ctrl key while making your selections.

  3. In the Jobs Grid, click Refresh Status.

Advanced Options

Both of the Advanced Options queue settings apply to the way that jobs in the queue are canceled:

  • Cancel jobs getting enqueued   Select this option to cancel all jobs that remain in a “getting enqueued” state for a prolonged time. When a job is in this state, it means that the queue has been told to start to receive a job that will be processed later. But it has not received a tag telling it that all the data for the job has been received. Until the full job has been received, the job will remain in the getting enqueued state. If a job remains in the getting enqueued state for a prolonged time, it is likely that something is preventing the job from finishing. If the job continues to remain in this state after you re-run it, review your ULS logs to troubleshoot why they problem is occurring.

    Saving a project from Project Professional to Project Server is a job that typically enqueues. When you save a project from Project Professional to the Project Server, the job synchronizes with the server. If the synchronization is not completed, then the job remains in the enqueued state.

    By default, this setting is enabled.

  • Cancel subsequent jobs in the correlation   When you cancel a job that spawns additional jobs, this option automatically cancels those jobs also. For example, a Project 1 Publish job that is canceled will also cancel the Project 1 Reporting job that was automatically created.

    By default, this setting is also enabled.

Make sure to click Refresh Status in the Jobs Grid after you make any changes.

Jobs Grid

The Jobs Grid provides a view of the jobs that meet the criteria listed in the Manage Queue Jobs page. Options within this section let you select a job or group of jobs and to apply the following options to them, if applicable:

  • Retry Job   Allows you to rerun selected jobs in the queue that were not completed successfully.

  • Cancel Job   Allows you to cancel selected jobs in the queue that were not completed successfully.

  • View Related Jobs   Allows you to view jobs that have a dependency relationship (for example, jobs in the same correlation) with a selected job in the queue.

  • Refresh Status   Allows you to update the jobs in your job grid with the latest status.

To retry a job

  1. In the Jobs Grid, find the job that you want to retry, and then select the check box in the far left column of this job.

  2. Click Retry Job. Recheck the status of the job in the Jobs Grid to verify the results of retrying the job.

To cancel a job

  1. In the Jobs Grid, find the job that you want to cancel, and then select the check box in the far left column of this job. Note that a job that has already completed successfully cannot be canceled.

  2. Click Cancel Job.

To view related jobs

  1. In the Jobs Grid, find the job for which you want to find related jobs, and then select the check box in the far left column of this job.

  2. Click View All Jobs. All jobs that have a dependency relationship with this job appear in the Jobs Grid.