Managing document generation jobs in the monitor and control servlet

You can use the monitor and control servlet to review job information, change the state of a job, delete a job, search for a job, and review a job alarm.

Before you begin

About this task

The Rational Publishing Engine monitor and control servlet does not work in a load balanced environment. Due to its design, a single Rational Publishing Engine monitor and control instance can service multiple Rational Publishing Engine web services. This does not impose any restrictions on the Rational Publishing Engine clients that use the Rational Publishing Engine monitor and control servlet and does affect their ability to run in a load balanced environment.
Note:
  • If you use Internet Explorer 8, apply all the Internet Explorer patches and security updates.
  • Disable the Compatibility View in Internet Explorer for the correct display of Rational Publishing Engine monitor and control web user interface.
All Document Generation Jobs page

Procedure

To review job information:

  1. Log in to the Rational Publishing Engine monitor and control servlet administration console. Example: http://server:port/rpemc/ui/index.html
  2. Enter the rpe_mc_admin User ID and Password created when the monitor and control servlet was deployed.
    Note: Use only the administrator credentials.
  3. Click Log In.
  4. On an individual job, click View Details in the Actions column or move the cursor over the job status in the Progress column. The following information about the status of the selected job displays: Progress, Creation time, Last Update, Workstation ID, User ID, and the Log of the events carried out to execute the job. When you cancel document generation processes in the RPE Launcher or the Document Studio, these processes display as Failed in the Rational Publishing Engine Monitor and Control web user interface. Only the jobs canceled by the Rational Publishing Engine Monitor and Control administrator display as Canceled.
    1. To pause a job, select the specific running job and click Pause in the Actions column. The selected job stops running and remains paused. The status of the running job changes from Running to Paused in the Progress column.

Deleting a job

Before you begin

Note: You cannot restore a job after you delete it.

Procedure

Select the specific job and click Delete in the Actions column. The status of the selected job changes from its current state to Deleted in the Progress column.

Searching jobs

Procedure

On the Document Generation Jobs page, enter your query in the search field and click the Submit icon. The search results display. The search results include the type of jobs displayed at a specific time. For example, if the type of job displayed is Paused, then running a search for the term XYZ lists all the currently paused jobs that contain XYZ.
The search function matches the case-sensitive results in the following fields:
  • Workstation ID: The name of the machine from which the job was requested.
  • User ID: The name of the user.
  • Execution: The name of the machine that performed the document generation job and the type of execution, whether local or remote.

Reviewing a job alarm

For the jobs that are running, if the values in the Last Update column extend beyond the a certain amount of time, an alarm is triggered. The default alarm time is set to 5 minutes.

Procedure

Move the cursor over the specific job that triggered the alarm. The Document Generation Alarm asks you to check the log for further information.

Feedback