Job status collection

Use this page to display information about submitted jobs, including the job ID, description, state, activation time, expiration time, and status summary. Jobs are submitted to administer nodes that have been registered with the job manager.

Deployment manager nodes and unfederated application server nodes that have been registered with an administrative agent are eligible to be registered with the job manager. The job manager can administer the entire deployment manager cell, not just the deployment manager.

To view this administrative console page, do either of the following:

To suspend a started job, resume a suspended job, or delete selected jobs, your ID must be authorized for the operator role.

Use one of the following buttons to suspend, resume, or delete a job.

Table 1. Button descriptions. Select a job and click a button.
Button Description
Suspend Specifies that an administrative agent or deployment manager can no longer retrieve the job.
Resume Specifies that an administrative agent or a deployment manager can retrieve the job.
Delete Specifies that a job and all its history are removed and no longer available. When you click Delete, you are given an opportunity to confirm or cancel the delete operation.

Find

When you click Jobs > Status, you can use the Find option to limit the submitted jobs to display. The Find results are displayed in the table that follows the Find and Preference options after you click Find. Clicking Reset clears the operators in column 2 and text in column 3.

Table 2. Find results. Read the column descriptions to learn about Find results.
Column 1 Column 2 Column 3
Except for the maximum results parameter, this column lists parameters that define a job.
  • Job ID, state, node name, group of nodes, and description parameters: Valid operators for the find operation are = (equal to), != (not equal to), is null, and is not null.
  • Activation time and the expiration time parameters: Valid operators are >=, and <=.
  • All parameters except maximum results: Specifies the string or partial string of a parameter. A partial string is designated using an asterisk (*). For example, setting the description to inventory* finds all jobs with a description that starts with inventory. You cannot use the asterisk in the job ID field or the fields related to time. You can search on an exact match for multiple items by including the items to match separated by commas. For example, you can search on two job IDs by entering 119489625729609463, 119489651801509472. When you search on more than one item, you cannot use the asterisk.
  • Maximum results: Specifies the number of records that the find operation displays. Enter a value between one and the maximum number of records that can be retrieved as defined in the job manager configuration.

Example: If the nodes are EastCoast1, EastCoast2, WestCoast1, and WestCoast2, you can enter East or East* for column 3 and = for column 2 of the node parameter. Job status is displayed for the jobs that include the EastCoast1 and EastCoast2 nodes.

Job ID

Specifies the job number of the job that you submitted.

Description

Specifies the description that you entered when you submitted the job.

State

Specifies whether the state of the job is Active, Pending, Expired, or Suspended.

Table 3. Job state descriptions. The state indicates whether the job is active.
State Description
Active The job is activated and not expired. The job does not have to be running to be active.
Pending The job has been submitted, but has not been activated.
Expired The expiration time that you specified during job submission was reached before the job was started. A job does not start on a node after the expiration time is reached. If the expiration time is reached while the job is running on any of its nodes, the job continues on those nodes.
Suspended The job has been suspended. If the suspension occurs while the job is running on a node, the job continues on that node. If the suspended job has not started when the suspension occurs, the job will not start on any of its nodes unless someone resumes the job. You can suspend a job from this console panel by clicking Suspend. You can resume a job from this console panel by clicking Resume.

Activation time

Specifies the activation time that you entered when you submitted the job or the actual time when the job was submitted if you did not specify an activation time.

The activation time is the time the job is available to run on the targeted nodes or groups of nodes.

Expiration time

Specifies the time the job is to expire. If the job has not started by the expiration time, the job will not start and the state will change to Expired. If the expiration time occurs while the job is running on a node, the job continues on that node.

When you submit the job, you can set the expiration date and time, choose the default expiration time option, or specify the amount of time until the job expires.

Status summary

Graphically provides an overview of how the job is running at its nodes. The graph is divided in up to four sections, indicating success, partial success, failure, or other, in that order, of the nodes in the job.

Table 4. Job status descriptions. The status indicates whether the job completes processing.
Status Description
Success Indicates the number of nodes on which the job completed successfully.
Partial success Indicates the number of nodes on which the job partially completed. Partial success can occur, for example, when a node represents multiple servers, and only some of the servers on the node complete successfully.
Failed Indicates the number of nodes on which the job failed to complete.
Other Indicates the number of nodes on which the job has some other status than success, partial success, or failure. A status of other can include nodes on which the job is currently running, or nodes on which the job has not started.



Subtopics
Related tasks
Administering nodes remotely using the job manager
Configuring deployment managers
Related information
Administrative console buttons
Reference topic    

Terms of Use | Feedback

Last updated: Oct 21, 2010 5:30:17 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-nd-iseries&topic=urun_jobstat
File name: uagt_jobstat.html