Managing document-style report generation jobs

You can use the Job details page in Publishing Document Builder to view the document-style report generation jobs that are currently running on the server. You can review job information, change the state of a job, cancel a job, or search for a job.

Before you begin

Deploy Publishing Document Builder.
Important: You must have the admin privileges to administer Publishing Document Builder and the pub_admin role assigned to you.

Procedure

  1. You can view jobs that have been running for a long time on the Long running jobs tab, or view all jobs on the Jobs tab.
  2. To see the details for an individual job, click View job details View job detailsin the Actions column.
  3. To pause a job, select the specific running job and click Pause Pause in the Actions column. The selected job stops running and remains paused.
  4. To resume a job, select the specific running job and click Resume Resume in the Actions column. The selected job resumes.
  5. To cancel a job, select the specific running job and click Cancel Cancel in the Actions column.
    Table 1. Document-style report generation job statuses
    Status Description
    Running Jobs that are currently in progress.
    Paused Jobs that have been paused by the administrator or the user.
    Failed Jobs that might not be completed successfully.
    Cancelled Jobs that have been canceled by the administrator.
    Finished Jobs that completed successfully.
    Note: Administrators can change the threshold that triggers the job to appear on the Long running jobs tab by setting the Long running jobs threshold value under Monitor and control on the Runtime variables tab.
  6. To refresh the status of the jobs, click the Refresh icon.
    Administrators can change how often the page refreshes by setting the Job details refresh interval value under Monitor and control on the Runtime variables tab. Finished jobs are not displayed by default. If you are monitoring a long-running job, and the job disappears because it has completed, you can find the job by clicking the Jobs tab and then Advanced search link. Select the Finished job status and search for your completed job.
  7. You can search for jobs within the page by entering text in the Find in page field, or use Advanced search link to search all jobs by name, user, status, or date. You can also page through the list of reports or sort the reports by columns.

Results

You can now manage document generation jobs in Publishing Document Builder. For more information, see video Monitoring and controlling document generation jobs in Publishing Document Builder: