Integration Jobs Pane

This pane enables you to schedule integration jobs to run with external data repositories. The Statistics, Query Status, and Job Errors tabs display runtime details about the selected jobs.

To access
  • Select the Population or Data Push tab on the Integration Studio page.

  • To access the Statistics, Query Status, or Job Error tabs, select an integration point, select the Population or Data Push tab on the Integration Studio page, and then select a job.

Important information This pane is displayed only when population or data push is supported by the adapter on which you are basing your integration point.
Relevant tasks
See also

User interface elements are described below:

UI Element (A-Z) Description
New Integration Job. Enables you to create an integration job. For details, see New Integration Job/Edit Integration Job Dialog Box.
Edit Integration Job. Enables you to edit an existing integration job.
Delete Integration Job. Deletes the selected integration job from the list.

Refresh. Refreshes the list of integration jobs.

Note If you refresh the list of jobs before you save a new job, you are given a choice:

  • Yes. The job is saved and the integration is refreshed.

  • No. The job is not saved and the integration is refreshed.

  • Cancel. The job is not saved and the integration is not refreshed.

Run Job - Synchronize Changes. Runs the selected population or data push job and synchronizes only the changes in the data since the last time the job was run.

By default, scheduled jobs synchronize only changes except for the first time a job runs. In that case, a full population or data push job runs, in which all relevant data for the job is synchronized.

Note  

  • If the job is scheduled to run an all-data synchronization while you are running a changes synchronization, the scheduled all-data synchronization will run when the job has finished synchronizing the changes.
  • If CIs in a data push job fail, the query is displayed in the Query Status tab with the status: Passed with failures. You can drill down to see the errors that occurred and the CIs affected. This error data is saved in the system. When the job runs again to synchronize changes, UCMDB remembers the failed CIs and repushes these as well. For details, see Query Status Tab below.

Run Job - Synchronize All Data. Runs a full population or data push job. This job copies or pushes all the relevant data for the job.

Note If the job is scheduled to run a changes synchronization while you are running an all-data synchronization, the scheduled changes synchronization will run when the job has finished synchronizing all of the data.

Stop Running Job. Stops running the selected job.

Available for: Data Push jobs only

Clear Probe Results Cache. Clears the cache of all job results for this integration from the Data Flow probe as well as the last time the data was synchronized. The next time you run a synchronization, all the data is synchronized again.

Available for: Population jobs only

View Integration Point Log. Displays the log of the integration point.
<right-click integration job menu>

In addition to the options described above, the right-click menu provides the following functionality:

  • Show Results For Job. DFM sends an ad hoc request to the Probe and retrieves the latest results of the job.

    This ad hoc request does not run the job, but brings the results of the previous job run that are stored in the Probe's database. If the job has not yet run, a message is displayed.

    Available for: Population jobs only.

    Note Results are not displayed if the total number of results exceeds 10,000.

  • View Communication log. Opens the log that includes information about the connection between the Probe and the remote machine. This is on condition that you have set the Create communication log to Always or On failure. For details, see Execution Options Pane.

    Available for: Population jobs based on Jython adapters only.

Job Name Name given to the population or data push job.
Last Synchronization Type

The type of the last run:

  • None. The job has not yet run.

  • Changes. The job synchronized only the changes in the data since the last time it ran.

  • Full. The job synchronized all the relevant data for the job.

Available for: Data push jobs only

Status

Population jobs:

  • Waiting for Probe. The job is waiting to be received by the Probe.

  • Did not run. The job has been received by the Probe but the Probe is not yet ready to run the job.

  • Preparing to run. The Probe is preparing to run the job.

    Note The status is preceded by another instance of the Waiting for Probe status, but this time Waiting for Probe indicates that the Probe is now ready to prepare the job for the run.

  • Running. The job is running.

  • Completed Successfully. The job ran successfully.

  • Completed. The job ran successfully but errors or warnings were reported. See details on the errors or warnings in the Query Status Tab below.

  • Failed. The job did not run successfully.

  • Disabled. The integration point is deactivated or the trigger CI is missing.

Data push jobs:

  • Did not run. The job has not yet run.

  • Running. The job is currently running.

  • Ended. The period between Running and Succeeded or Failed.

  • Completed. The job ran successfully but errors or warnings were reported. See details on the errors or warnings in the Query Status Tab below.
  • Completed Successfully.. The last run was successful.

  • Failed. The last run was not successful.

Start time / Finish time

The time that the integration job actually started running, and when it finished running. These columns are refreshed every time the job goes into the Running state.

Available for: Population jobs only

Statistics Tab

This tab displays information about the CIs synchronized by the job.

Note Statistics for population jobs are accumulative and therefore can be filtered, whereas the data push statistics are always relevant for the last job run only.

User interface elements are described below (unlabeled elements are shown in angle brackets):

UI Element (A–Z) Description
Refresh. Refreshes the details statistics displayed.

View Instances. Displays all new and updated CIs. Select a CIT and click:

  • View Created Instances to display created CIs of the selected type
  • View Updated Instances to display updated CIs of the select type

Available for: Population jobs only

Select the time range or Probe for which to display statistics about the selected job.

  • By Time Range.

    • All. Displays statistics for all job runs.

    • From Now/Last Minute/Last Hour/Last Day/Last Week. Choose a period of time for which to display statistics about the CITs.

    • Custom Range. Click to open the Change Timeframe dialog box: Enter the date or click the arrow to choose a date and time from the calendar, for the From and To dates (or click Now to enter the current date and time). Click Last Day to enter the current date and time in the To box and yesterday's date and time in the From box. Click OK to save the changes.

  • By Probe. To view statistics for a specific Probe, select to open the Choose Probe dialog box.

Available for: Population jobs only

<Statistics table>
  • CIT. (Population jobs only) The name of the discovered CIT.

  • Query Name. (Data push jobs only) The name of the query whose data is being pushed.

  • Created. The number of CIs created in the period selected or for the selected Probe.

  • Updated. The number of CIs that were updated in the period selected.

  • Deleted. The number of CIs deleted in the period selected or for the selected Probe.

  • Failed. The number of CIs that were not pushed.

    Available for: Service Manager 9.3 adapter only

  • Ignored. The number of CIs that were ignored because of the reconciliation rule in the external system.

    Available for: Asset Manager Generic adapter 1.01 (or later) only.

Note For most adapters, when you repush the same CIs to a remote machine, the CIs are reported as Created in the Statistics table. For the Cmdb10xAdapter, AMPushAdapter and genericPushAdapter, the CIs are reported as Updated (actual status).

Last updated The date and time that the results for the selected job were last updated.
Valid to The date when the data was last synchronized.

Query Status Tab

This tab displays information about the queries defined for the job.

Note This tab is displayed for non-Jython data push and population integration adapters only.

User interface elements are described below:

UI Element (A–Z) Description
Refresh. Refreshes the list of queries.

Push selected failed data. Enables you to repush the selected query/CI manually.

Available: When a failed query or CI is selected

Suppress selected failures/warnings. Enables you to suppress errors for a selected query/CI.

Available: When a failed query or CI is selected

Note The Suppress feature removes the failed CI from the list of errors. The error is displayed again if the CI fails at the next synchronization attempt.

Open the Query Editor. Enables you to view and edit the selected TQL query in the Integration Query Editor.

Available: For Push jobs only.

<Query details>

Displays the details of the selected job's queries:

  • Query Name. The name of the query.
  • Status.

    • Population jobs. The latest status of the query after the job finishes running.
    • Data push jobs. The current status or the last known status of the query. If a query passed with failures, you can double-click the query to view the errors that occurred and on which CIs they occurred. To repush the query, click the Push selected failed data button. To suppress all the errors for the query, click the Suppress selected failures/warnings button.

  • Start Time/Finish Time. The time at which data push for this query started and finished.

    Available for: Data push jobs only

<Errors and warnings>

When you double-click a job that did not complete successfully, the table displays errors and warnings that occurred, the CI type affected, and the number of CIs that failed.

Double-click a row to see the CIs that failed due to a particular error.

To repush the CIs, click the Push selected failed data button. To suppress all the errors for the selected CI type, click the Suppress selected failures/warnings button.

Available for: Data push jobs only

<Failed CIs>

When you double-click an error or warning, the table displays the exact errors that occurred, the CIs on which they occurred, and when they occurred. The CIs are distinguished by their display label and external ID.

To repush the CI, click the Push selected failed data button. To suppress all the errors for the selected CI, click the Suppress selected failures/warnings button.

Available for: Data push jobs only

Job Errors Tab

This tab displays the errors or warnings reported during the job run.

Note This tab is displayed for Jython integration adapters only.

User interface elements are described below (unlabeled elements are shown in angle brackets):

UI Element (A–Z) Description
Refresh. Refreshes the list of errors.
View Details. Displays details about the selected error.
<List of error messages>
  • Message. A message describing warnings (if the job succeeded with warnings) or the cause for failure if the job failed.
  • Severity. For details, see Error Severity Levels.
  • Reported. The time at which the error is being reported by the job.
  • Query. Displayed for data push jobs only. The name of the query for which the error is being reported.