5.11 Checking and Changing Job Status

Once AppManager starts a job, the job typically goes through the following states in its life cycle:

This status...	Indicates...
Pending	A temporary state when AppManager first starts a job or when you temporarily stop and restart a job. If a job stays in this state for very long, it might indicate a network communication problem or that an agent computer has been shut down. Click the + (plus sign) next to a parent job to see additional status details about child jobs: Start indicates the job is in the process of starting. Stop indicates the job is in the process of stopping.
Running	AppManager started the job, but the job might or might not be actively executing its monitoring functions. Click the + (plus sign) next to a parent job to see additional status details about child jobs: Active indicates the job is currently running on the agent computer, monitoring computer resources according to the schedule and parameters you set. Any corrective actions you defined for the job occur automatically when the event condition is met. Scheduled indicates the job has not started executing its monitoring functions. Monitoring takes place according to the schedule you set. Inactive indicates the job is currently inactive due to scheduled maintenance. When the maintenance period is over, the job will resume running according to the schedule you set. To prevent jobs from running during scheduled maintenance periods, run the AMADMIN_SchedMaint Knowledge Script. For more information about this Knowledge Script, double-click it and then click Help on the Values tab in the Properties window.
Stopped	The job has run to completion or has been stopped manually.
Closed	The job is no longer in use but is still available for historical purposes and you can re-open it in the future.
Error	The job encountered a problem (for example, an error in the agent computer’s runtime configuration prevented the job from running properly).

5.11.1 Viewing Jobs in the Jobs View

Click the Jobs view to get more details about all jobs, including the current status of each job, whether a Knowledge Script Group or a monitoring policy started the job, where the job is running, the name of the Knowledge Script being run, and the time the job was submitted.

The Jobs view lists all child jobs. You can group by Parent Job ID by dragging the column header to the Group By field.

5.11.2 Viewing the Actual Script for a Running Job

To view the actual script that is running on a computer:

In the Enterprise Layout view of the Navigation pane, click the appropriate Jobs view.
In the Jobs view, double-click a child job to view its properties.
Click the View KS button .

5.11.3 Changing the Sorting Order

You can click any of the headings in the Jobs view to sort all parent entries in that field or toggle the sorting order preference. For example, jobs in the Jobs view are normally sorted by job ID in ascending order. To sort the job list by Knowledge Script, click the Knowledge Script header. To reverse the sorting order from ascending to descending, click the Knowledge Script header again.

5.11.4 Changing Job Status

You can change the status of a particular job or all jobs running on an object in the Jobs view.

For a particular job, you can click the job’s status icon in the view pane. Clicking a running job stops it; clicking a stopped job, restarts it. You can attempt to restart a job with an Error status, but if the job still encounters an error, the status will return to Error.

To stop or start a particular job:

In the Enterprise Layout view of the Navigation pane, click the appropriate Jobs view.
(Conditional) To stop a job, in the view pane, click the green status icon for the job you want to stop.

The status and icon changes to Pending (yellow) and then to Stopped (red).
(Conditional) To start a job, in the view pane, click the red status icon for the job you want to start.

The status (and icon) changes to Pending (yellow) and then to Running (green).

5.11.5 Changing Properties of a Running Job

To change the properties of a job that is running:

In the Enterprise Layout view of the Navigation pane, click the appropriate Jobs view.
In the view pane, select the job you want to modify.
In the Tasks pane, click Job Properties.
Change the properties you want in any tab of the Job Properties window (for example, modify the schedule, set a new threshold value, or modify the list of objects that the job monitors).
Click OK.

AppManager temporarily changes the job to a pending state and then resumes running it with the new properties.

5.11.6 Viewing Job Comments

Console operators and administrators add job comments. The comments usually include information about the job, for example, information about why the monitoring values of the job were changed.

This information can be added to the properties of an ad hoc job. In the Control Center console, you can group jobs by job comment information. Job comments are not applicable to policy-based jobs or jobs that a Knowledge Script Group starts.

You can view a job comment:

On the Values tab of the Properties window for the job. The Comments field contains the latest comment. To view all of the comments for the job, click History.

The Job Comment History window displays the comment information for the job along with information about when the comment was made and who created the comment.

You can delete job comments from the Job Comment History window by clicking the comment you want and clicking Delete.
In the Comment column of the Jobs view.

5.11.7 Adding Comments to a Job

Adding comments to a job allows you to record and share information with other console operators and administrators. You cannot add comments to a policy-based job.

When you add comments to a job, AppManager automatically restarts the job and then displays the comment information in the Comments field.

To add comments to a job:

In the Enterprise Layout view of the Navigation pane, click the appropriate Jobs view.
In the view pane, select the job where you want to add comments.
In the Tasks pane, click Job Properties.
On the Values tab of the Job Properties window, use the Comments field to enter the text (up to 256 characters) you want saved with the job. You can also specify a URL to create a hyperlink to a web site.
Click OK to apply your changes and close the window.

AppManager automatically restarts the job.