This documentation supports the 9.1 to 9.1 Service Pack 3 version and its patches of BMC Atrium Core. The documentation for version 9.1.04 and its patches is available here.

To view the latest version, select the version from the Product version menu.

Triggering jobs to import data into BMC Atrium CMDB

To import data from an external data source into the BMC.Asset dataset (production dataset), a record is processed sequentially by Atrium Integrator, Normalization Engine, and Reconciliation Engine jobs. However, the sequential job execution offers the following challenges:

  • Each of these jobs can have independent schedules but, must run sequentially.
  • These can be long running jobs and you may need to predict the end time of a job run in order to schedule the next one in the sequence. This creates an issue in lining up schedules for jobs because it is not possible to predict when a job earlier in the chain will finish. 
  • This leads to time gaps between subsequent runs or overlapping runs, which can result in inefficient utilization of the system or undesired results. 

With the triggering mechanism, you need to schedule only the first job in the sequence and the subsequent ones are triggered upon completion of the previous one. You don't need to track the schedules for Normalization Engine, and Reconciliation Engine jobs when they are run sequentially. 

The following diagram illustrates how using the triggering mechanism you can reduce manual monitoring to sequentially run Atrium Integrator, Normalization Engine, and Reconciliation Engine jobs.

To trigger jobs to import data in BMC Atrium CMDB

You need to:

  1. Schedule the Atrium Integrator job
  2. Trigger the Atrium Integrator job.
  3. Trigger the Normalization Engine job.
  4. Trigger the Reconciliation Engine job.

You have to perform these steps once. After you configure the triggers, the Normalization and Reconciliation jobs will be triggered automatically every time the scheduled Atrium Integrator job runs.

Step1: Schedule the Atrium Integrator job

  1. Schedule the Atrium Integrator job. See, Managing Atrium Integrator job schedule.
  2. Create an event driven Atrium Integrator job by using the Application Pending form. To create a request on the Application Pending form, see Setting up event-driven jobs in Atrium Integrator.

Step2: Set up a trigger for the Atrium Integrator job

Perform the following steps, to ensure that after the job is completed, an entry is created in the UDM:JobLog form with the status as END. This is required to trigger the Normalization Engine Job.

  1. Log in to BMC Remedy Mid Tier with your credentials.
  2. In the Applications pane, click Atrium Integrator > Atrium Integrator Console.
  3. In the Atrium Integrator Console, click Launch Spoon.
  4. To open a job, go to Tools > Repository > Explore to open the Repository explorer dialog box.
  5. Click Edit > Settings. 
    The Job Properties dialog box is displayed. 
  6. Click the Log tab. 
  7. Click Job
  8. Enter the <AR server name> in the Log Connection field. 
  9. Enter UDM:JobLog form name in the Log table field.
  10. Click Job Entry
  11. Enter the <AR server name> in the Log Connection field. 
  12. Enter UDM:JobEntryLog form name in the Update Log table field.
  13. Click OK.

If you have created the job in Atrium Integrator Spoon, the job is history is not displayed and you need to perform the workaround discussed in the Job fails to run in Atrium Integrator console topic.

Step 3: Trigger the Normalization Engine job

After the job is completed an entry is created in the NE:JobRun form with job status as Complete. This is required to trigger the Reconciliation job.

  1. Download the runNEandREJob.def and files. Click the links to download the attachments. 

  2. Extract the contents of the file in the BMC Atrium Core installation directory.
  3. Import the runNEandREJob.def file into BMC Remedy Developer Studio. For information about how to import object definitions, see Importing object definitions.
    This creates the RunNEJob and the RunREJob filter.
  4. Open the RunNEJob filter. Under IfAction>RunProcess, update the following variables in the command line as needed:
    1. batchFilePath – Enter the complete path of the batch file (after extracting)

    2. NE_JobName – Enter the name of the job that you want to execute. 

    3. Setup a filter qualification that runs the job only after this Atrium Integrator job is completed. 
      For example,  'Status' = "End" AND 'Job Name' = "<AI JOB Name>"
  5. Save the filter.

Step 4: Trigger the Reconciliation Engine job

Open the RunREJob filter and modify the run process action using the following command:

Application-Command Reconciliation Trigger-Job -o "Atrium Explorer - Identification and Merge" -l "-w $DatasetId$ -d BMC.AE

See Run process workflow action to perform event-driven reconciliation for more information about run process workflow actions.

After the Normalization Engine job is complete, the RunREJob filter runs automatically and triggers the reconciliation engine job.

By default, the Atrium Explorer - Identification and Merge reconciliation job is triggered. If you want to change the Reconciliation job you want to trigger, you must update the command option in the runNEandREJob.def file and perform steps mentioned in Step 3.

Was this page helpful? Yes No Submitting... Thank you


  1. Amar Achmedan


    the link to is not valid. Can you correct it?


    Oct 04, 2017 05:32
    1. Chaitanya vikas Ghanta

      Hi Amar, 

      Please check if this is working now.



      Jan 15, 2019 01:38