Important This version of the product has reached end of support. The documentation is available for your convenience. However, you must be logged in to access it. You will not be able to leave comments.

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 Parameters (see Managing-system-parameters). This topic contains the following sections:

To view the list of jobs

  1. Navigate to Network > Actions > Jobs.
    JobsListing.png

  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.

    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.

    Print View

    Print the jobs list

    Refresh

    Update the status for all listed jobs

    Help

    Display help for the jobs list

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

    Icon

    Action

    Description

    Icon_View.png

    View

    Display details about the job

    Icon_Edit.png

    Edit

    Edit the job

    Icon_Copy.png

    Copy

    Copy the job

    BNA_Icon_FailedCopyJobs.png

    New in 8.9.02

    Copy only actions with device failures

    Copy a failed job, including actions only on devices that failed in the job.1

    Icon_Submit.png

    Submit

    Submit the job for execution

    Icon_JobApproval.png

    Approve

    Approve the job

    Icon_JobRejection.png

    Reject

    Reject the job

    Icon_Abort.png

    Cancel/Abort

    Cancel the job. Individual device actions already in progress cannot be aborted.

    Icon_Delete.png

    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:
    JobDetailsViaID.png
    Note: In versions 8.9.01 and later, the Send Email option has been replaced with Send Notification. 
  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 three completed actions. Select the link under Status to view Job Details for that action.
    StatusJobs.png

Back to top

To view the job details report

  1. Create a job.
    The job shown in the following figure executes a Deploy to Active action on a device:
    JobDtoAAction.png
  2. Click Icon_View.png as shown in the preceding figure to view the job details and configuration changes.
    JobDetaillsDtoA.png
    Note: In versions 8.9.01 and later, the Send Email option has been replaced with Send Notification.
  3. Click various links on the Job Details report to drill down to more information.
  4. Click View Job Summary Report by Job ID Icon_Reportdetails.png 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.
    JobSummaryReportviaID.png
  5. Select View Change Details Report Icon_Reportdetails.png to view details of the change.

    ChangeDetailsReportViaJobID.png
  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:

    DtAActionDetails.png
    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.

    JobDetailsSubactions.png
  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.
    TranscriptDtADetails.png
  9. To view the contents of a script that was depoyed 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.
    MergeScriptDetails.png

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 Submit.

Back to top

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*