Using the monitor and control servlet

You can use the monitor and control servlet to review job information and 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 IBM Rational Publishing Engine Monitor and Control servlet does not work in a load balanced environment. Due to its design, a single IBM Rational Publishing Engine Monitor and Control instance can service multiple IBM Rational Publishing Engine WebServices. This does not impose any restrictions on the IBM Rational Publishing Engine clients that use the IBM Rational Publishing Engine Monitor and Control servlet and their ability to run in a load balanced environment.
Note:
  • If you use Internet Explorer 8, apply all the Internet Explorer patches/security updates.
  • Disable the Compatibility View in Internet Explorer for the correct display of IBM Rational Publishing Engine Monitor and Control web UI.

Procedure

Reviewing job information and changing the state of a job:

  1. Log in to the IBM Rational Publishing Engine Document Generation Job Monitor and Control log in page. Enter your User ID and Password and click Log In.
    Note: Use only the administrator credentials.
    The document generation processes cancelled by you from the RPE Launcher or the Document Studio will display as Failed/Aborted in the IBM Rational Publishing Engine Monitor and Control web UI. Only the jobs cancelled by the IBM Rational Publishing Engine Monitor and Control admin will display as Cancelled.
  2. On an individual job, click View Details in the Actions column or move the mouse pointer over the job status in the Progress column. The following information on 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.
    • Changing the state of the selected job: For example, to pause a running job. Selected the specific running job and click Pause in the Actions column. The selected job will stop running and will stay on pause. The status of the running job will change from Running to Paused in the Progress column.

Deleting a job

Procedure

  1. Select the specific job and click Delete in the Actions column. The status of the selected job will change to from its current state to Deleted in the Progress column.
  2. You cannot restore a job after you have deleted it.
    Note: Deletion of a job is final.

Searching jobs

Procedure

On the Document Generation Jobs page, enter your query in the search field which is in the upper-right corner of the page and click the submit icon. The search results are displayed in response to your query. The Search applies to the type of jobs displayed at a particular instance. For example, if the type of jobs displayed is Paused, then running a search for the term XYZ will list all the paused jobs that contain XYZ in either of the following fields: Workstation ID, User ID, Execution.
The search function will match the results (case sensitive) in the following fields:
  • Workstation ID: Contains the name of the machine from which the job was requested.
  • User ID.
  • Execution: Contains the name of the machine that performed the document generation job and the type of execution, wether local or remote.

Review a job alarm

For the jobs that are running, if the values in the Last Update column extend beyond the threshold, (for example, a job that is running for more than five minutes), an alarm is triggered. The alarm time is set to five minutes.
Note: An alarm is a document generation job in a Running state that has not being updated in the past five minutes or more.

Procedure

Move the mouse pointer over the specific job that triggered the alarm. A Document Generation Alarm displays asking you to check the log for further information.

Feedback