Viewing the jobs listing

 The Jobs page displays all pending, in progress, and executed jobs. Jobs remain in the jobs list until purged by the system based on the purging criteria defined under Admin > System Admin > System Parameters (see Managing-system-parameters). This topic contains the following sections:

• • To view the list of jobs
  • To view the job ID information
  • To view the job details report
  • To define a filter for the jobs listing

To view the list of jobs

1. Navigate to Network > Actions > Jobs.
   

2. (Optional) Perform one of the following tasks by using the menu options that are available on the Jobs page:

   Menu option	Description
   Views	Display predefined jobs matching a favorite view. See About-lists-and-views and Managing-and-sharing-views. The default view, Recent Jobs, does not show the Telnet/SSH Session jobs by default. Starting from version 20.02.02, this view shows all types of jobs by default, including the Telnet/SSH Session jobs.
   Filter	Filter the predefined jobs list based on selected criteria. You can use a wildcard for the network span.
   Add	Create a new job
   Reconcile	Reconcile a job. To track changes that occurred without prior approval in the Change Management system, a network engineer can reconcile latent changes. Note: Reconciling jobs is only available if your site has performed the Remedy integration procedure and the system parameter, Enable Continuous Compliance for Network Administration is selected.
   Refresh	Update the status for all listed jobs

3. (Optional) Perform one of the following actions by clicking an icon in the Actions column on the Jobs page:

   Icon	Action	Description
   	Edit	Edit the job
   	Copy	Copy the job
   	Copy only actions with device failures	Copy a failed job, including actions only on devices that failed in the job.1
   	Submit	Submit the job for execution
   	Approve	Approve the job
   	Reject	Reject the job
   	Cancel/Abort	Cancel the job. Individual device actions already in progress cannot be aborted.
   	Delete	Delete the job

   When copying only actions with device failures, the job includes actions where at least one device reported a status other than success. The network span for these copied actions is only the devices that did not succeed, except for the Find Endpoint and Quarantine Endpoint actions, where the action uses the original network span.
   If the original job was set to skip the remaining actions on error, the copied job includes all of the actions that follow the action that failed, with the original network span. That is, the copied job executes fully the actions that never executed in the original job.
   Before copying only actions with device failures, verify that the failures are such that a re-execution of the action has a chance of success. If the error required you to take any corrective action (such as restoring connectivity to a remote device agent or to a device), make sure that you have taken the necessary actions or the action simply fails again. There are also warnings that do not warrant re-execution of the same action. For example, if you deploy a new OS image but do not reboot the device, the action reports a warning that the running operating system is not what you deployed; you should not re-execute the deploy OS image action, but should reboot the device.

Back to top

To view the job ID information

1. To navigate to various Job options, click any Job ID link, as shown in the following figure:
    
2. (Optional) If the job is pending, click View Job Conflicts Report to display all the devices in multiple pending jobs so you can resolve any conflicts, as appropriate.
3. (Optional) Select the arrow on a job entry to view the actions in the job and, if the job has run, the status of each action.
   
   The example below shows a job with one completed actions. Select the link under Status to view Job Details for that action.
   

Back to top

To view the job details report

1. Create a job.
   The job shown in the following figure executes a Remediate action on a device:
   
2. Click View  as shown in the preceding figure to view the job details and configuration changes.
   
   
   
3. Click various links on the Job Details report to drill down to more information.
4. Click View Job Summary Report By Job ID  to view the Job Summary information, as shown in the following figure.
   
   The pages in this sequence are intended for general information. They do not necessarily give details of the same job. The configuration change produced by the job is highlighted in red.
   
5. Select View Change Details Report  to view details of the change.
   
   
6. In the Job Details report, click the arrow next to the name of an action to view details of the action, as shown in the following figure:
   
   
   Note that remediating actions show sub-actions within the main action, as shown in the following example. Click the arrow handles to view the sub-action details.
   
   
7. Click the completion status link (Succeeded or Failed) in the Status column in the Job Details report to view the device transcript.
   The transcript shows the commands that the system sends to the device and the responses the device sends back.
8. Click the handles to view the part of the transcript that you want to see in detail. The following figure shows the Deploy to Active part.
   
9. To view the contents of a script that was deployed to the device, click Merge Script in the Status column in the Job Details report, as shown in the following figure. The deployed script shows you any computed script that makes the device compliant, and it shows resolved substitution parameters.
   

Back to top

To define a filter for the jobs listing

1. Select Network > Actions > Jobs.
2. Click the Filter menu option above the list of jobs.
3. Select or specify any of the following optional attributes:
   • Time when the job was created
   • Actions that are added to the job
   • Job ID
   • Change ID that tracks the specified job to the external Change ID
   • Task ID that tracks the specified job to the external Task ID
   • Network span of the action in the job
   • Originator (user, system, or policy) of the job
   • The predefined job that was used to prepare the job.
   • Person who last edited the job
   • Current status (Aborted, Completed, Draft, Cancelled, and so on) of the job
   • Reconciliation status (Aborted, Success, Failed, In Progress, and so on) of the job
   • Job approval type used to approve the job execution
4. Click Save.

Back to top