This documentation supports the 18.08 version of BMC Atrium Core.

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

Copying CIs from one dataset to another

A configuration manager can use the copy activity, to copy instances from one dataset to another. You can use this activity to create datasets such as baselines, snapshots, archives and future states.

For example, Calbro services wants to make changes to the CIs from BMC.ADDM dataset to run some tests. Instead of making changes to the dataset directly, they want to copy the CIs to another dataset and then run the tests in this dataset. They choose to copy all those CIs in which 'Model' = $\NULL$ AND 'MarketVersion' != "1.2.3" from BMC.ADDM dataset into a new dataset.

Before you begin

Create a qualification ruleset if you want to copy specific instances to the target dataset. For creating a qualification ruleset, see Creating qualification rules for reconciliation activities.

To create a Copy activity in a reconciliation job

  1. In the Reconciliation console, click Create Job or open an exist reconciliation job.
    See Creating and editing a customized reconciliation job.
  2. In the Activities area, click New to define a new Copy activity.
  3. For Type, select Copy.
  4. Enter the following information:

    FieldDescription

    Name

    Type a unique name. The name must contain only those characters that the operating system of your server allows for file names. For example, on a windows server, your job name cannot contain the following characters: \ / : * ? " < > |.

    Namespace

    Select a Namespace from the list. Only classes in the selected namespaces can participate in the activity. For more information, see Namespaces and reconciliation.

    Status

    Active - runs the copy activity when the reconciliation job runs.

    Inactive - Does not run the copy activity when the reconciliation job runs.

    Continue on Error

    Defines whether the job continues if the activity has an error.

    Selected - The job continues to run even if an error occurs in this activity.

    Cleared - The job terminates if an error occurs in this activity.

    Sequence

    Specify the order that want this activity to run in relation to other activities in a job. For example, if this activity has a value of 2 it runs before an activity with a value of 3. The sequence can be from 0 to 1000.

  5. From the Source Dataset and Target Dataset lists, select datasets to use in the Copy activity.

  6. Set the option combination for the copy activity by using the information in the following table. 
    For possible combinations of the options available in a Copy activity, see Option combinations for Copy activity.

    OptionDescription
    Copy RelationshipsDetermines whether to restore direct relationships to instances in the target dataset. For example, when a copied CI is a member of a relationship in the source dataset, and the other member of the same relationship already exists in the target dataset without the relationship, the relationship instance is copied to restore the connection between those CIs in the target dataset. The other member is not copied, and the action is not recursive.
    • By Qualifier — Copy only the relationships included in the Qualification Set.
    • Copy All — Copy relationships included in the Qualification Set, and also restore direct relationships to instances in the target dataset.
    Collision ResolutionDetermines action when there are matching instances in the source and target databases.
    • Overwrite - Replace the existing instance in the target dataset with the instance from the source dataset.
    • Display Error - Write an error message to the activity log file and not copy the instance.
    Include Child CIsSelect whether to copy weak destination CIs.
    • Select - Copy only the CIs included in the Qualification Set.
    • Clear - Copy CIs included in the Qualification Set, CIs related as destination members in a weak relationship, and those relationships too. This option preserves composite objects.
    Identity RequiredSelect whether to copy instances with or without a reconciliation identity.
    • Select - Copy only identified instances.
    • Clear - Copy identified and unidentified instances.
  7. To save the activity, click Done.
  8. In the Job Editor, click Save

Option combinations for Copy activity

The following table describes the behavior of the Copy activity for each combination of options.


Combinations

Behavior

Copy Relationships: By Qualifier
Collision Resolution: Overwrite
Include Child CIs: No
Identity Required: Yes

Only instances with a reconciliation identity are copied, and they replace existing instances.

Only CIs and relationships specified in the Qualification are copied.

Copy Relationships: Copy All
Collision Resolution: Overwrite
Include Child CIs: No
Identity Required: Yes

Only instances with a reconciliation identity are copied.

They replace existing instances in the target dataset.

Relationships of copied CIs, where the other member of the relationship exists in the target dataset, are also copied.


Copy Relationships: By Qualifier
Collision Resolution: Display Error
Include Child CIs: No
Identity Required: Yes

Only instances with a reconciliation identity are copied.

If they match existing instances in the target dataset, an error is written to the activity log.

Only CIs and relationships specified in the Qualification are copied.

Copy Relationships: Copy All
Collision Resolution: Display Error
Include Child CIs: No
Identity Required: Yes

Only instances with a reconciliation identity are copied.

If they match existing instances in the target dataset, an error is written to the activity log.

Relationships of copied CIs, where the other member of the relationship exists in the target dataset, are also copied.

Copy Relationships: By Qualifier
Collision Resolution: Overwrite
Include Child CIs: Yes
Identity Required: Yes

Only instances with a reconciliation identity are copied.

They replace existing instances.

In addition to instances specified in the Qualification, all weak relationships and CIs below them are also copied.

Copy Relationships: Copy All
Collision Resolution: Overwrite
Include Child CIs: Yes
Identity Required: Yes

Only instances with a reconciliation identity are copied.

They replace existing instances.

In addition to instances specified in the Qualification, all weak relationships and CIs below them are also copied.

Relationships of copied CIs, where the other member of the relationship exists in the target dataset, are also copied.

Copy Relationships: By Qualifier
Collision Resolution: Display Error
Include Child CIs: Yes
Identity Required: Yes

Only instances with a reconciliation identity are copied.

If they match existing instances in the target dataset, an error is written to the activity log.

In addition to instances specified in the Qualification, all weak relationships and CIs below them are also copied.

Copy Relationships: Copy All
Collision Resolution: Display Error
Include Child CIs: Yes
Identity Required: Yes

Only instances with a reconciliation identity are copied.

If they match existing instances in the target dataset, an error is written to the activity log.

In addition to instances specified in the Qualification, all weak relationships and CIs below them are also copied.

Relationships of copied CIs, where the other member of the relationship exists in the target dataset, are also copied.

Copy Relationships: By Qualifier
Collision Resolution: Overwrite
Include Child CIs: No
Identity Required: No

Instances with and without a reconciliation identity are copied.

They replace existing instances.

Only instances specified in the Qualification are copied.

Copy Relationships: Copy All
Collision Resolution: Overwrite
Include Child CIs: No
Identity Required: No

Instances with and without a reconciliation identity are copied.

They replace existing instances.

Relationships of copied CIs, where the other member of the relationship exists in the target dataset, are also copied.

Copy Relationships: By Qualifier
Collision Resolution: Display Error
Include Child CIs: No
Identity Required: No

Instances with and without a reconciliation identity are copied.

If they match existing instances in the target dataset, an error is written to the activity log.

Only instances specified in the Qualification are copied.

Copy Relationships: Copy All
Collision Resolution: Display Error
Include Child CIs: No
Identity Required: No

Instances with and without a reconciliation identity are copied.

If they match existing instances in the target dataset, an error is written to the activity log.

Relationships of copied CIs, where the other member of the relationship exists in the target dataset, are also copied.

Copy Relationships: By Qualifier
Collision Resolution: Overwrite
Include Child CIs: Yes
Identity Required: No

Instances with and without a reconciliation identity are copied.

They replace existing instances.

In addition to instances specified in the Qualification, all weak relationships and CIs below them are also copied.


Copy Relationships: Copy All
Collision Resolution: Overwrite
Include Child CIs: Yes
Identity Required: No

Instances with and without a reconciliation identity are copied.

They replace existing instances.

In addition to instances specified in the Qualification, all weak relationships and CIs below them are also copied.

Relationships of copied CIs, where the other member of the relationship exists in the target dataset, are also copied.

Copy Relationships: By Qualifier
Collision Resolution: Display Error
Include Child CIs: Yes
Identity Required: No

Instances with and without a reconciliation identity are copied.

If they match existing instances in the target dataset, an error is written to the activity log.

In addition to instances specified in the Qualification, all weak relationships and CIs below them are also copied.

Copy Relationships: Copy All
Collision Resolution: Display Error
Include Child CIs: Yes
Identity Required: No

Instances with and without a reconciliation identity are copied.

If they match existing instances in the target dataset, an error is written to the activity log.

In addition to instances specified in the Qualification, all weak relationships and CIs below them are also copied.

Relationships of copied CIs, where the other member of the relationship exists in the target dataset, are also copied.

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

Comments