Professional Documents
Culture Documents
Release 7.1
This edition applies to version 7, release 1, modification 0 of IBM Tivoli Change and Configuration Management Database and
to all subsequent releases and modifications until otherwise indicated in new editions. This edition replaces any previous
edition of this document.
Portions 1996-2003 Visual Mining, Inc. Visual Mining NetCharts Server provided by Visual Mining, Inc.
US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM
Corp.
Contents
Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Intended Audience
This guide is written for information technology managers, system
administrators, and other personnel responsible for managing data about
information technology assets. The Reconciliation module applications are
administrative applications.
IBM Support
IBM Software Support provides assistance with product defects.
Before contacting IBM Software Support, your company must have an active IBM
software maintenance contract, and you must be authorized to submit problems
to IBM. For information about the types of maintenance contracts available, see
"Enhanced Support," in the Software Support Handbook at
techsupport.services.ibm.com/guides/services.html.
Complete the following steps to contact IBM Software Support with a problem:
3 Submit your problem to IBM Software Support in one of the following ways:
a Online: Click the Report problems tab on the IBM Software Support site:
www.ibm.com/software/support/probsub.html.
If the problem you submit is for a software defect or for missing or inaccurate
documentation, IBM Support creates an Authorized Program Analysis Report
(APAR). The APAR describes the problem in detail. Whenever possible, IBM
Support provides a workaround that you can implement until the APAR is
resolved and a fix is delivered. IBM publishes resolved APARs on the IBM
Support web site daily, so that other users who experience the same problem can
benefit from the same resolution.
Overview
Configuration Items In the Configuration Items application you create and maintain data about
Application configuration items that conform to rules and relationships that you specify. This
is data that you record about what you have acquired and installed. It represents
your authorized inventory, how things should be and what you have planned.
These configuration items are in effect "authorized" configuration items.
Actual Configuration In the Actual Configuration Items application you maintain information about
Items Application data collected directly from components actually installed in your enterprise. To
gather this data, discovery tools scan computers, network devices, and other
information technology components deployed in your enterprise and record
information about the hardware and software installed on those components. An
integration tool, such as IBM Tivoli Integration Composer, imports the collected
data into CCMDB.
Reconciliation The Reconciliation module applications let you evaluate data about information
Applications technology devices and networks. You use the Reconciliation module applications
to perform two functions:
! define reconciliation tasks that let you compare information from one data set
with information in another data set
Defining Reconciliation To define the parameters for a reconciliation, you create a reconciliation task that
Tasks combines the elements required for a reconciliation into a specific task. A
reconciliation task consists of three possible components: a task filter (optional),
one or more link rules (required), and one or more comparison rules (optional).
You use the Reconciliation module applications to create these components. After
you create a reconciliation task, you use the Cron Task Setup application to create
a schedule for running the reconciliation.
Reconciliation Options For CCMDB, there are three basic types of reconciliations that you can perform:
For example, you can evaluate authorized CI records for computer systems at
a specific site to determine whether the RAM on the computers in authorized
CIs matches the RAM actually installed on computers in actual CIs.
! Matches found specifies the ratio of object instances in Data Set 1 to object
instances in Data Set 2 to look for in the comparison.
For example, you can run a full CI comparison and use the results to
determine whether the relationships in authorized CI data between a
computer system, operating system, and software component matches the
relationships in actual CI data. For example, when you reconcile authorized
CIs against actual CIs, is there a successful match to indicate that for the
computer system Mail Server 1, Lotus Domino Server is installed on
Microsoft Windows XP and that Windows XP runs on Mail Server 1?
Viewing Reconciliation After the system executes a reconciliation task, you can view the results of the
Results reconciliation in either the CI Link Results or CI Reconciliation Results
application.
You can also use the CI Reconciliation Results application to mark reconciliation
results resolved after you review and resolve discrepancies between authorized
CI data and actual CI data. When you mark a result as resolved, you can also
record information about how you resolved the discrepancies.
Classification Hierarchy
To fully understand the reconciliation process, it is important to understand the
classification hierarchy used for configuration items in CCMDB. In CCMDB,
related configuration items are organized into a logical hierarchy or tree. The top-
level configuration item of the tree is called the ancestor.
Reconciliation Tasks This application combines one or more link rules and, if necessary, a task filter,
and one or more comparison rules into a reconciliation task. This application also
lets you specify how the system reports results for comparison rule evaluations
all results, failed reconciliations, or successful reconciliations.
Task Filters This application defines a subset of either Data Set 1 or Data Set 2 to reconcile. If
you do not define a task filter for a reconciliation task, the system compares all
top-level authorized CI objects with all actual CI objects when it processes the
reconciliation task.
Link Rules This application establishes a link between a top-level object in Data Set 1 and a
top-level object in Data Set 2. A link rule establishes the basis of the comparison
by identifying the object and attribute in Data Set 1 to link to a specific attribute of
the object in Data Set 2.
Comparison Rules This application defines how to compare objects or attributes of a child or parent
object in Data Set 1 with a child or parent in Data Set 2 when the system executes
a reconciliation task. Comparison rules are optional components of a
reconciliation task, and a task can include more than one comparison rule. The
system applies comparison rules only after a link rule establishes a successful link
between an object from Data Set 1 and an object from Data Set 2. The system lists
results for comparison rule reconciliations in the CI Reconciliation Results
application.
CI Link Results This application lists successful one-to-one links between a top-level object in
Data Set 1 and a top-level object in Data Set 2.
! Link Rule Failures A link failure occurs when the system processes a link
rule and does not find a successful one-to-one link between the object in Data
Set 1 and the object in Data Set 2. Link failures occur when the reconciliation
process finds no links or finds multiple links.
! instances where the object from Data Set 1 failed to reconcile against the
object from Data Set 2
! instances where the object from Data Set 1 successfully matched the object
from Data Set 2
Setting Up a Reconciliation
CCMDB reconciles Data Set 1 and Data Set 2 by performing a rule-based compare
operation defined in a reconciliation task. You use Reconciliation module
applications to define a reconciliation task and then use the Cron Task Setup
application in the System Configuration module to create a cron task that
schedules the reconciliation task to run. After the reconciliation task runs,
authorized users can view results of the reconciliation in the CI Link Results and
CI Reconciliation Results applications.
Examples
You can set up a task filter for actual CIs based on a specific site such as
Boston. A reconciliation task using this task filter selects actual CIs only at the
Boston site for evaluation. Using the link rule or rules in the task, the system
compares the selected actual CIs with all top-level authorized CIs to
determine whether there is a link.
You can set up a task filter for authorized CIs based on a specific site such as
Boston. A reconciliation task using this task filter selects top-level authorized
CIs only at the Boston site for evaluation. Using the link rule or rules in the
task, the system compares the selected authorized CIs with all actual CIs to
determine whether there is a link.
Once you create a task filter, you use the Reconciliation Tasks application to
associate the filter with a specific reconciliation task, and the system applies the
task filter each time the reconciliation task is run. Setting up a task filter for a
reconciliation task is optional. If you do not define a task filter for a reconciliation
task, the system compares all top-level authorized CI objects with all top-level
actual CI objects.
You use the Task Filters application to perform the following actions:
! Task Filter to define new task filters and view, edit, and delete existing task
filters.
! Filter name a unique name (specified in the Filter field) that identifies the
task filter.
! Filter type type (specified in the Filter Type field) of task filter. The type
selected determines which set of objects the filter applies to. For CCMDB
configuration items, you can select either CI or Actual CI.
! Filter clause(s) In the Task Filter Clauses table window, you define at least
one clause that specifies an attribute and a value for the task filter. You can
create multiple attribute clauses for a task filter.
If you create multiple clauses that specify different attributes, the system
processes the clauses using logical AND between the clauses. For example, if
you set up a task filter for actual CIs based on the Site and Service Group
attributes, the system selects only actual CIs for the specified site and the
specified service group; both criteria must be met.
If you create multiple clauses for the same attribute, the system processes the
clauses using logical OR between clauses. For example, if you create a task
filter for authorized CIs with two filter clauses for Site, one for Boston and one
for New York, the system selects records that have either Boston or New York
as a site.
To specify an attribute, you select from a predefined value list. The values in
the list depend on the value that you select for the Filter Type field. The
following table shows the values available for each filter type.
CI CI Number
Class Structure
Collection
Item
Location
Organization ID
Service
Service Group
Site ID
Status
Work Order
GUID
Asset Asset
Custodian
GL Account
Organization
Site
Status
Usage
Work Order
System Role
Setting Up a Reconciliation 7
Setting Up Link Rules
When you save a modified task filter, the application evaluates the filter to
determine whether the clauses are valid expressions; if a clause is not valid, the
application displays an error message and does not save the task filter.
You cannot delete a task filter if it is associated with a task defined in the
Reconciliation Tasks application. If you attempt to delete a task filter associated
with a task, the application displays an error message.
Once you create a link rule, you use the Reconciliation Tasks application to
associate the link rule with a specific reconciliation task, and the system applies
the link rule each time it executes the reconciliation task. When the system
executes the reconciliation task, it evaluates each link rule on the task and
attempts to match the object and attribute defined in the rule for Data Set 1 with
the object and attribute defined in the rule for Data Set 2.
You use the Link Rules application to perform the following actions:
! Link Rule to define new link rules and view, edit, duplicate, and delete
existing link rules.
! Link name a unique name (specified in the Link field) that identifies the link
rule.
! Data set specifications for Data Set 1 and Data Set 2 that indicate what data to
reconcile.
! Link clauses In the Link Clauses table window, you must define at least one
clause that defines a relation (or link) between a top-level object in Data Set 1
and a top-level object in Data Set 2. Each link clause identifies an object and
attribute in Data Set 1 to link to a specific attribute in Data Set 2 when the
system executes a reconciliation task.
NOTE The Link Clauses table window displays selected fields for each
clause. To view all fields for a clause, select a row and click View
Details .
Open Parenthesis ( ... Marks the beginning of a set of Optional. However, for each open
clauses grouped together so that parenthesis, use a corresponding close
the system can perform operations parenthesis.
on them in a specific order.
Setting Up a Reconciliation 9
Setting Up Link Rules
For assets:
! ASSET (Asset)
! ASSETSPEC (Asset Specification)
! CI (Configuration Item)
! CISPEC (CI Specification)
Data Set 1 Class Structure When you select a specification as ! Mandatory if you select ASSETSPEC or
the Data Set 1 object, this field CISPEC for the object.
identifies a specific class structure
for reconciliation. ! Selected from a value list. Values in the
list are class structure identifiers for the
top-level objects.
Data Set 1 Classification Displays the classification for the Read-only field.
selected class structure.
Data Set 1 Attribute Title Displays the title of the Data Set 1 Read-only field.
object attribute.
Operator Identifies the type of link between The equals ( = ) operator is read-only; it
Data Set 1 and Data Set 2. cannot be changed.
Data Set 2 Object Identifies the target object in Data Selected from a value list that includes the
Set 2. following values:
! For assets:
DEPLOYEDASSET
Data Set 2 Class Structure When you select a specification as ! Mandatory if you select ACTCISPEC.
the Data Set 2 object, this field
identifies a specific class structure ! Selected from a value list. Values in the
for reconciliation. list are class structure identifiers for the
top-level objects.
Data Set 2 Classification Displays the classification for the Read-only field.
selected class structure.
Data Set 2 Attribute Title Displays the title of the Data Set 2 Read-only field.
attribute selected.
Close Parenthesis ... ) Marks the end of a set of clauses Optional. However, for each close
grouped together so that the parenthesis, use a corresponding open
system can perform operations on parenthesis.
them in a specific order.
Sequence Operator When more than one link clause ! Required if a link rule consists of more
exists, this operator prescribes than one clause.
how the current clause relates to
the next clause in the sequence. ! Must be empty for the last row in the
sequence (that is, the row with the
highest sequence number).
! AND
! OR
Before you can save a link rule, you must satisfy the following requirements:
! Define data set specifications for Data Set 1 and Data Set 2 that indicate what
data to reconcile.
Setting Up a Reconciliation 11
Setting Up Link Rules
! Clauses must be valid expressions. When you save a link rule, the application
uses the following rules to determine whether clauses are valid expressions. If
the application determines that a clause is not valid, it displays an error
message and does not save the link rule.
! All rows except the row with the highest sequence number must have a
value specified in the Sequence Operator field.
! The row with the highest sequence number must not have a sequence
operator (After the application sorts the clauses, this is the last row in the
table window.).
When you save a modified link clause, the application evaluates the link rule to
determine whether the clauses are valid expressions; if a clause is not valid, the
application displays an error message and does not save the link rule.
You cannot delete a link rule if it is associated with a task defined in the
Reconciliation Tasks application. If you attempt to delete a link rule associated
with a task, the application displays an error message.
To create a comparison rule, you must define Data Set 1 and Data Set 2. Then you
define the comparison rule. You can define a filter for Data Set 1 or Data Set 2 to
limit your comparison to a subset of either data set.
! Matches found specifies the ratio of object instances in Data Set 1 to object
instances in Data Set 2 to look for in the comparison.
Once you create a comparison rule, you use the Reconciliation Tasks application
to associate the rule with a specific reconciliation task, and the system includes
the comparison rule each time it executes the reconciliation task. When the system
runs a reconciliation task, it processes link rules first. The link rule specifies the
top-level object and attribute in one data set to match with a specific attribute of a
top-level object in another data set. When the system processes a reconciliation
task, it processes comparison rules in the task only if the link rule successfully
links an object in Data Set 1 with an object in Data Set 2.
! instances where the object from Data Set 1 failed to reconcile against the object
from Data Set 2
! instances where the object from Data Set 1 successfully matched the object
from Data Set 2
When the system executes a reconciliation task, it lists results of comparison rule
evaluations in the CI Reconciliation Results application.
In summary, you use the Comparison Rules application to perform the following
actions:
Setting Up a Reconciliation 13
Setting Up Comparison Rules
Comparison Rule Tabs The Comparison Rules application has the following tabs:
! Comparison Rule to define new comparison rules and to view, edit, and
delete existing comparison rules.
! Data Set 1 Filter Subtab to define one or more filter clauses that specify a
subset of Data Set 1 objects to reconcile against Data Set 2 objects when
you use a comparison rule.
! Data Set 2 Filter Subtab to define one or more filter clauses that specify a
subset of Data Set 2 objects to reconcile against Data Set 1 objects when
you use a comparison rule.
! Matches Found Subtab to define one or more matches found clauses that
specify the acceptable ratio of Data Set 1 object instances to Data Set 2
object instances in the comparison after the system applies the data set
filter or filters.
! Data set specifications for Data Set 1 and Data Set 2 that indicate what data to
reconcile. (required)
! Data Set 1 filter clause(s) a Data Set 1 filter is optional; however, if you
include matches found clauses, you must have a Data Set 1 filter, a Data Set 2
filter, or both.
! Data Set 2 filter clause(s) a Data Set 2 filter is optional; however, if you
include matches found clauses, you must have a Data Set 1 filter, a Data Set 2
filter, or both.
! Select an object from Data Set 1 if the selected attribute matches a specified
value based on the operator selected. Using the operator specified in the
clause, the system evaluates each top-level object in Data Set 1 and all its
children and selects any objects that match the value specified.
! Select an object from Data Set 1 if the selected attribute of a class specification
matches a specified value. Using the operator specified in the clause, the
system evaluates each top-level object in Data Set 1 and all its children and
selects any objects that belong to the class specified in the clause. Any object
that has a different class is skipped. Then the filter uses the operator to
evaluate the attribute value and selects all objects that match the value
specified.
! Select an object from Data Set 1 if the specified classification exists. The system
evaluates each top-level object in Data Set 1 and all its children and selects all
instances that have the specified class.
The following table describes the elements of a Data Set 1 filter clause.
Setting Up a Reconciliation 15
Setting Up Comparison Rules
Open Parenthesis ( ... Marks the beginning of an Optional. However, for each open
expression. Parenthesis marks group parenthesis, use a corresponding close
expressions to control the order of parenthesis.
operations when you use multiple
clauses joined by a logical operator
(AND or OR).
! ASSET (Asset)
! ASSETSPEC (Asset Specification)
! ITEM (Item)
! ITEMSPEC (Item Specification)
! CI (Configuration Item)
! CISPEC (CI Specification)
Data Set 1 Class When you select a specification as the ! Mandatory if you select a specification
Structure Data Set 1 object, this field identifies a for the object.
specific class structure for
reconciliation. ! Selected from a value list. Values in the
list are class structure identifiers for the
top-level objects.
Data Set 1 Attribute Displays the title of the attribute Read-only field.
Title selected.
Operator Identifies the operator for the Mandatory if you select an attribute.
attribute specification. Otherwise the field is read-only.
Value Specifies a value for the attribute ! If you do not select an attribute, the field
selected. is read-only.
Close Parenthesis ... ) Marks the end of an expression. Optional. However, for each close
Parenthesis marks group expressions parenthesis, use a corresponding open
to control the order of operations parenthesis.
when you use multiple clauses joined
by a logical operator (AND or OR).
Sequence Operator When more than one clause exists, ! Required if the filter consists of more
this operator prescribes how the than one clause.
current clause relates to the next
clause in the sequence. ! Do not enter a value for the last row in
the sequence (that is, the row with the
highest sequence number).
! AND
! OR
Setting Up a Reconciliation 17
Setting Up Comparison Rules
Value: Bedford
Wildcard Use You can use a wildcard character or characters with letters or numbers to
indicate you want to find records that begin with, end with, or contain those
letters/numbers. The Reconciliation module applications use standard wildcard
rules. The following table describes the four wildcard characters available.
Wildcard Characters
123* or 123% records that start with 123, such as 123, 12345,
123ABC, etc.
Elec* or Elec% records that contain words that start with Elec,
such as electric, electromagnetic, or electrode.
123? or 123_ any four-character records that start with 123, such
as 1234, 1230, 123g, etc.
_18 or ?18 any three-character records that end with 18, such
as 418 or J18.
There should be no space between the wildcard character and the other
characters.
Logical AND/OR A Data Set 1 filter can be a logical expression made of multiple clauses using the
logical operators AND and OR. Operations on clauses are binary; that is, two
values are considered at a time. Clauses are evaluated from left to right. You can
use parentheses to alter the order of operations. By default, AND has a higher
priority than OR; consequently, if no parentheses are present, operands joined by
AND are processed first.
Setting Up a Reconciliation 19
Setting Up Comparison Rules
Example
is evaluated as
Example
is evaluated as
Result OR Clause E
Logical OR When the system processes two clauses joined with the logical operator OR, it
selects an object for the output set if it meets the criteria of either of the two
clauses. If the object matches one of the specified criteria, the system selects it.
Logical AND When the system processes two clauses joined with the logical operator AND, it
selects an object for the output set only if it meets the criteria of both clauses.
When evaluating clauses in a filter, in order to ensure that the correct set of output
objects is created for the comparison rule, the system always fully evaluates all
clauses; that is, the system does not apply any shortcuts to the logical expression
even if it becomes obvious before all clauses are evaluated that the expression will
succeed or fail.
! Select an object from Data Set 2 if the selected attribute matches a specified
value based on the operator selected. Using the operator specified in the
clause, the system evaluates each top-level object in Data Set 2 and all its
children and selects any objects that match the value specified.
! Select an object from Data Set 2 if the selected attribute of a class specification
matches a specified value. Using the operator specified in the clause, the
system evaluates each top-level object in Data Set 2 and all its children and
selects any objects that belong to the class specified in the clause. Any object
that has a different class is skipped. Then the filter uses the operator to
evaluate the attribute value and selects all objects that match the value
specified.
! Select an object from Data Set 2 if the specified classification exists. The system
evaluates each top-level object in Data Set 2 and all its children and selects all
instances that have the specified class.
The following table describes the elements of a Data Set 2 filter clause.
Open Parenthesis ( ... Marks the beginning of an expression. Optional. However, for each open
Parenthesis marks group expressions to parenthesis, use a corresponding close
control the order of operations when parenthesis.
you use multiple clauses joined by a
logical operator (AND or OR).
Data Set 2 Object Specifies the target object in Data Set 2. ! Mandatory.
Data Set 2 Class When you select a specification as the ! Mandatory if you select a specification
Structure Data Set 2 object, this field identifies a for the object.
specific class structure for reconciliation.
! Selected from a value list. Values in the
list are class structure identifiers for
the top-level objects.
Data Set 2 Attribute Displays the title of the attribute Read-only field.
Title selected.
Operator Identifies the operator for the attribute Mandatory if you select an attribute.
specification. Otherwise the field is read-only.
Setting Up a Reconciliation 21
Setting Up Comparison Rules
Value Specifies a value for the attribute ! If you do not select an attribute, the
selected. field is read-only.
Close Parenthesis ... ) Marks the end of an expression. Optional. However, for each close
Parenthesis marks group expressions to parenthesis, use a corresponding open
control the order of operations when parenthesis.
you use multiple clauses joined by a
logical operator (AND or OR).
Sequence Operator When more than one clause exists, this ! Required if the filter consists of more
operator prescribes how the current than one clause.
clause relates to the next clause in the
sequence. ! Do not enter a value for the last row in
the sequence (that is, the row with the
highest sequence number).
! AND
! OR
A Data Set 2 filter can be a logical expression made of multiple clauses using the
logical operators AND and OR. Operations on expressions are binary; that is, two
values are considered at a time. Expressions are evaluated from left to right. You
can use parentheses to alter the order of operations. By default, AND has a higher
Example
is evaluated as
Example
is evaluated as
Result OR Clause E
Logical OR When the system processes two clauses joined with the logical operator OR, it
selects an object for the output set if it meets the criteria of either of the two
clauses. If the object matches one of the specified criteria, the system selects it.
Logical AND When evaluating two clauses joined with the logical operator AND, the system
first checks the type of objects specified (for example, processor, computer
system, operating system) in the two clauses. If both clauses specify objects of the
same type, the system selects only objects that are specified in both clauses. This
means that only the objects that are specified in both clauses joined by the AND
operator go to the output set.
When one of the clauses joined by the logical operator AND yields an empty set,
the system does not select any objects for the output set.
When the clauses do not yield an empty set and specify objects of different types
(for example, computer system and operating system), the system selects an
object if it meets the criteria of either of the two clauses, the same way it would
select objects if using the logical operator OR.
This behavior of the logical AND for Data Set 2 might seem counterintuitive at
first, but consider the case when the filter is designed to select all Dell computer
systems with Microsoft Windows XP operating systems. A filter for this situation
must have at least two clausesone that selects computer systems with the
manufacturer Dell and another that selects Windows XP operating systems. These
two clauses are joined with a logical AND, but they contain different types of
objects. The comparison rule will yield a successful result if both the clauses
produce a non-empty set and the system finds objects that match either the
computer system or operating system.
Setting Up a Reconciliation 23
Setting Up Comparison Rules
When evaluating a filter, in order to ensure that the correct set of output objects is
created for the comparison rule, the system always fully evaluates all clauses; that
is, the system does not apply any shortcuts to the logical expression even if it
becomes obvious before all clauses are evaluated that the expression will succeed
or fail.
Each clause identifies an object in Data Set 1 and an object in Data Set 2 to
evaluate; the clause also includes an operator that specifies the number of
instances of the Data Set 1 object and the number of instances of the Data Set 2
object.
Open Parenthesis ( ... Marks the beginning of an Optional. However, for each open parenthesis,
expression. Parenthesis marks use a corresponding close parenthesis.
group expressions to control the
order of operations when you use
multiple clauses joined by a logical
operator (AND or OR).
For assets:
! ASSET (Asset)
! ASSETSPEC (Asset Specification)
! ITEM (Item)
! ITEMSPEC (Item Specification)
! CI (Configuration Item)
! CISPEC (CI Specification)
Data Set 1 Class When you select a specification as ! Mandatory if you select a specification for
Structure the Data Set 1 object, this field the object.
identifies a specific class structure
for the Data Set 1 filter. ! Selected from a value list. Values in the list
are class structure identifiers for the
objects that belong to the top-level Data
Set 1 objects.
! At least 1 to at least 1
! At least 1 to exactly 1
! Exactly 1 to at least 1
! Exactly 1 to exactly 1
! Exactly N to exactly N
Data Set 2 Object Specifies the Data Set 2 object for ! Mandatory.
reconciliation.
! Selected from a value list.
Data Set 2 Class When you select a specification as ! Mandatory if you select ACTCISPEC for
Structure the Data Set 2 object, this field the Data Set 2 object.
identifies a specific class structure
for the Data Set 2 filter. ! Selected from a value list. Values in the list
are class structure identifiers for the
objects that belong to the top-level Data
Set 2 objects.
Close Parenthesis ... ) Marks the end of an expression. Optional. However, for each close parenthesis,
Parenthesis marks group use a corresponding open parenthesis.
expressions to control the order of
operations when you use multiple
clauses joined by a logical operator
(AND or OR).
Setting Up a Reconciliation 25
Setting Up Comparison Rules
Sequence Operator When more than one clause exists, ! Required if more than one clause exists.
this operator prescribes how the
current clause relates to the next ! Must be empty for the last row in the
clause in the sequence. sequence (that is, the row with the highest
sequence number).
! AND
! OR
The following table describes the operators you can use to define the ratio
between Data Set 1 object instances and Data Set 2 object instances:
Operator Description
At least 1 to at least 1 At least one Data Set 1 object exists, but you can have
more than one;
and
at least one Data Set 2 object exists, but you can have
more than one.
At least 1 to exactly 1 At least one Data Set 1 object exists, but you can have
more than one;
and
and
at least one Data Set 2 object exists, but you can have
more than one.
and
and
Open Parenthesis ( ... Marks the beginning of an expression. Optional. However, for each open
Parenthesis marks group expressions parenthesis, use a corresponding close
to control the order of operations parenthesis.
when you use multiple clauses joined
by a logical operator (AND or OR).
Data Set 1 Object Specifies the Data Set 1 object for ! Mandatory.
reconciliation.
! Selected from a value list that includes
the following values:
For assets:
! ASSET (Asset)
! ASSETSPEC (Asset Specification)
! ITEM (Item)
! ITEMSPEC (Item Specification)
! CI (Configuration Item)
! CISPEC (CI Specification)
Data Set 1 Class When you select a specification as the ! Mandatory if you select a specification
Structure Data Set 1 object, this field identifies a for the Data Set 1 object.
specific class structure for the object
in the attributes equality clause. ! Selected from a value list. Values in the
list are class structure identifiers for the
objects that belong to the top-level Data
Set 1 objects.
Setting Up a Reconciliation 27
Setting Up Comparison Rules
Data Set 1 Attribute Displays the title of the Data Set 1 Read-only field.
Title attribute selected.
Operator Identifies the operator for the Mandatory. The equals (=) operator is read-
reconciliation. only; it cannot be changed.
Data Set 2 Object Specifies the Data Set 2 object for ! Mandatory.
reconciliation.
! Selected from a value list.
Data Set 2 Class When you select a specification for ! Mandatory if you select ACTCISPEC
Structure the Data Set 2 object, this field for the Data Set 2 object.
identifies a specific class structure for
the Data Set 2 object in the attributes ! Selected from a value list. Values in the
equality clause. list are class structure identifiers for the
objects that belong to the top-level Data
Set 2 objects.
Data Set 2 Attribute Displays the title of the Data Set 2 Read-only field.
Title attribute selected.
Data Set 2 Unit of Displays the title of the Data Set 2 unit Read-only field.
Measure Attribute of measure attribute.
Title
Close Parenthesis ... ) Marks the end of an expression. Optional. However, for each close
Parenthesis marks group expressions parenthesis, use a corresponding open
to control the order of operations parenthesis.
when you use multiple clauses joined
by a logical operator (AND or OR).
Sequence Operator When more than one clause exists, ! Required if more than one clause exists.
this operator prescribes how the
current clause relates to the next ! Must be empty for the last row in the
clause in the sequence. sequence (that is, the row with the
highest sequence number).
! AND
! OR
Before you can save a comparison rule, you must satisfy the following
requirements:
! Define data set specifications for Data Set 1 and Data Set 2 that indicate what
data to reconcile.
NOTE Full configuration item (CI) comparison rules are a special kind of
comparison rule that let you compare CI relationships. For more
information about full CI comparison rules, see Chapter 4, "Setting Up
a Full CI Comparison," on page 39.
! If you create a matches found clause, define a Data Set 1 filter or a Data Set 2
filter or both.
! Create clauses that are valid expressions. When you save a comparison rule,
the application uses the following rules to determine whether clauses are
valid expressions. If the application determines a clause is not valid, it
displays an error message and does not save the comparison rule.
NOTE You can enter sequence numbers in random order; when you save
a record, the application sorts the clauses and displays them in
ascending numerical order.
Setting Up a Reconciliation 29
Setting Up Comparison Rules
! All rows except the row with the highest sequence number must have a
value specified in the Sequence Operator field.
! The row with the highest sequence number must not have a sequence
operator (After the application sorts the clauses, this is the last row in the
table window.).
! Change the data in the description field or in existing fields in Data Set 1 filter
clauses, Data Set 2 filter clauses, matches found clauses, or attributes equality
clauses.
! Add new Data Set 1 filter, Data Set 2 filter, matches found, or attributes
equality clauses.
! Delete existing Data Set 1 filter, Data Set 2 filter, matches found, or attributes
equality clauses.
NOTE If the comparison rule has a matches found clause, define at least one
Data Set 1 filter or Data Set 2 filter clause. If you attempt to delete the
last filter clause on a comparison rule that has a matches found clause,
the application displays an error message and does not delete the
clause.
You cannot modify the comparison rule name in the Comparison field. You
cannot change the data sets selected in the Data Set 1 and Data Set 2 fields.
You use the Reconciliation Tasks application to perform the following actions:
! Reconciliation Task to define new tasks and to view, edit, duplicate, and
delete existing tasks.
Task Filter (optional) A task filter specifies a subset of either Data Set 1 or Data Set 2 to evaluate when
the system executes a reconciliation task.
For example, you can define a filter that selects CIs only at your Boston site; in this
case the reconciliation task evaluates top-level CIs only at the Boston site but
evaluates all actual CIs.
You can apply only one task filter to a reconciliation task. For CCMDB, if you do
not define a task filter for a reconciliation task, the system uses all CIs (authorized
configuration items) as the default when it processes the reconciliation task. Task
filters apply only to link rules, not comparison rules.
Link Rule (required) A reconciliation task must include one or more link rules. A link rule specifies
which top-level object and attribute in Data Set 1 to link to a specific attribute of a
top-level object in Data Set 2. Link rules are often based on unique identifiers. The
attribute most commonly used to link CIs with actual CIs is ACTCINUM, the
actual CI number.
If you add multiple link rules, you must assign a sequence number to each rule to
specify the order in which to process the rule. Sequence numbers and link rule
names must be unique for each rule. When the system executes the reconciliation
task, it evaluates each link rule and attempts to match the object and attribute in
Data Set 1 with the object and attribute in Data Set 2.
Setting Up a Reconciliation 31
Setting Up Reconciliation Tasks
Comparison Rule A comparison rule is an optional component that defines how to compare objects
(optional) or attributes of a child or parent object in Data Set 1 with a child or parent in Data
Set 2 when the system executes a reconciliation task. You can add one or more
comparison rules to a reconciliation task. If you add a comparison rule, you must
select a value in the Comparison Results field in the Reconciliation Tasks
application to specify what kind of comparison results to display in the CI
Reconciliation Results application. The system applies comparison rules only
after it establishes a successful link between an object from Data Set 1 and an
object from Data Set 2.
Scheduling Tasks When you schedule a reconciliation task in the Cron Task Setup application, you
must use the name specified in the Reconciliation Task field in the Reconciliation
Tasks application to set up the cron task. The system lets you schedule cron tasks
for multiple reconciliation tasks. You cannot delete reconciliation task records that
are associated with a cron task.
When the system executes a reconciliation task, it lists results in the CI Link
Results application and in the CI Reconciliation Results application. For more
information about viewing link results and reconciliation results, see Chapter 6,
"Viewing Results of a Reconciliation," on page 47.
! Task filter (optional) You specify a task filter for the reconciliation task by
selecting a task filter in the Task Filter field. When you select a task filter, the
application displays the type for the selected filter in the Filter Type field.
! Filter type type of task filter associated with the reconciliation task.
! Data set specifications for Data Set 1 and Data Set 2 that indicate what data to
reconcile.
! Link Rule(s) In the Link Rules table window, you specify one or more link
rules for the reconciliation task. The Link Rules table window on the
Reconciliation Task tab displays the following information about the link
rules used in the reconciliation task:
You can use the Select Link Rule button in the Link Rules table window to
select one or more link rules for a reconciliation task. Selecting this button
opens a dialog box that lists link rules that you have created.
You can use the Select Comparison Rule button in the Comparison Rules
table window to select one or more comparison rules for a reconciliation task.
Selecting this button opens a dialog box that lists comparison rules that you
have created.
From the Reconciliation Task tab, you have several options that you can use to
add task filters, link rules, and comparison rules to the task:
! You can click Select Link Rule to open the Select Link Rule dialog box. This
dialog box displays a list of existing link rules. You can select one or more link
rules for the task.
! You can click Select Comparison Rule to open the Select Comparison Rule
dialog box. This dialog box displays a list of existing comparison rules. You
can select one or more comparison rules for the task.
! You can click Detail Menu icon next to the Task Filter, Link, and
Comparison fields to select one of the following options:
! Open a Select Value dialog box to choose from a set of existing task filters,
link rules, or comparison rules.
Setting Up a Reconciliation 33
Setting Up Reconciliation Tasks
! Go to the selected application. Once you are in the application, you can
create a new task filter, link rule, or comparison rule; or you can select an
existing record and modify it. You can return the value to the
Reconciliation Tasks application. You can also return to the Reconciliation
Tasks application without selecting a value.
! Description field
! Is Case Sensitive? check box
! Comparison Results field (if the task contains comparison rules)
You cannot change the name of the reconciliation task in the Reconciliation Task
field.
You can also modify the components of the reconciliation tasktask filter,
comparison rules, or link rules.
Modifying the Task Filter In the Task Filter field, you can select a different task filter or you can delete a task
filter. You can also go to the Task Filters application and create a new task filter or
modify the values in an existing task filter and return the new or modified task
filter to the Reconciliation Tasks application.
Modifying Link Rules You use the Link Rules table window on the Reconciliation Task tab in the
Reconciliation Tasks application to modify existing link rules on a reconciliation
task. You can add a new link rule to a task or delete an existing link rule from a
task. You cannot change the name of an existing link rule.
Modifying Comparison You use the Comparison Rules table window on the Reconciliation Task tab in the
Rules Reconciliation Tasks application to modify comparison rules on an existing task.
You can add a new comparison rule to a task or delete an existing comparison
rule from a task. You cannot change the name of an existing comparison rule.
When you duplicate the reconciliation task, the application clears the
Reconciliation Task field, and you must enter a new name for the duplicated
reconciliation task. The application also clears the Last Completion Date field.
Reconciliation Process
! Initialization
! Linking
! Comparing
Initialization Phase In the initialization phase, the system checks for a task filter to determine which
set of objects to evaluate.
Link Phase In the link phase, the system processes one or more link rules to determine
whether there is a link or match between a top-level object in Data Set 1 and a top-
level object in Data Set 2. When the system executes the reconciliation task, a link
rule might successfully identify a link between an object in Data Set 1 and an
object in Data Set 2, or it might not be able to identify a successful link. The system
creates result records for both successful and failed links.
Comparison Phase If the system establishes a successful link, it processes any comparison rules in the
reconciliation task, applying the comparison rules one by one to each linked pair
of Data Set 1 and Data Set 2 objects. A comparison rule compares either instances
of the top-level objects and their children (a matches found comparison) or
attributes of the top-level objects and their children (an attributes equality
comparison). The system creates comparison result records for each comparison
rule evaluated.
Initialization Phase
The purpose of the reconciliation process is to compare objects in Data Set 1 with
objects in Data Set 2. When setting up a reconciliation task, it is important to
consider which of the two data sets is the basis or leading set for comparison.
When the system performs a reconciliation, it takes the first object in the leading
set and attempts to find a match for that object in the corresponding data set using
the link rule or rules specified in the reconciliation task.
You can use a task filter to specify a subset of either authorized CIs or actual CIs to
evaluate. The system determines the leading set based on the type of the task filter
specified in the reconciliation task. By default, if a reconciliation task has no task
filter, the system selects all authorized CIs for the leading set.
For example, if you want to evaluate authorized CIs at your Boston location,
define a task filter with the type CI for the Boston location. The system then
selects authorized CIs at the Boston location for the leading set in the
reconciliation. It compares each of the authorized CIs at the Boston location with
all the actual CIs.
Conversely, if you want to evaluate actual CIs at your Boston location, define a
task filter with the type ACTCI for the Boston location. The system then selects
actual CIs at the Boston location for the leading set in the reconciliation. It
compares each of the actual CIs at the Boston location with all the authorized CIs.
Link Phase
In the link phase, the system attempts to find a match or link between each object
in the leading set and an object in the subordinate set. The system compares
objects in the leading set to the whole subordinate set in the following manner:
! The system selects the first object in the leading data set and looks for a match
in the corresponding data set using the first link rule in the reconciliation task.
! If the system finds a match for the object in the leading set, it checks the
subordinate set for additional matches.
! If evaluation of the first link rule does not find a match to an object in the
subordinate set, the system processes the next link rule in the
reconciliation task. The system processes link rules in a task in a cascading
sequence, based on sequence numbers, until the first match or until it
reaches the end of the cascading rule list.
! If the system processes all link rules and finds no match to an object in the
subordinate set, it creates a link rule failure record for the CI
Reconciliation Results application.
! When a link rule in a reconciliation task yields a match for an object (single or
multiple), the system does not process any more link rules for that object. The
system selects the next object in the leading data set and attempts to find a
match for that object.
It is possible for two different objects in the leading set to link to one subordinate
object. If that happens, the system creates a link failure record.
The following diagram illustrates how the system processes the leading set using
link rules:
Comparison Phase
Processing during the comparison phase depends on the type of comparison that
you choose. The process for full CI comparison rules differs from the process for
matches found and attributes equality rules. The following section describes how
the system processes matches found and attributes equality comparison rules. For
more information about how the system processes full CI comparison rules, see
Chapter 4, "Setting Up a Full CI Comparison," on page 39.
Unlike the link phase, which processes only top-level objects, the comparison
phase evaluates entire hierarchies. Using the clauses defined in the comparison
rule, the system evaluates each of the linked pairs collected by a link rule, one pair
at a time, processing children as well as parents.
You can limit the scope of the comparison by defining filters that select a subset of
data to compare. When processing comparison rules, the system first processes
any filters in the comparison rule and creates output sets for further evaluation.
The system then applies the comparison rule clauses to the objects in the output
sets created by the filters.
1 Create a Data Set 1 output set. If a Data Set 1 filter exists, include the objects
specified in the filter. If no Data Set 1 filter exists, include all CIs.
2 Create a Data Set 2 output set. If a Data Set 2 filter exists, include the objects
specified in the filter. If no Data Set 2 filter exists, include all actual CIs.
Example
You can run a full CI comparison and use the results to determine whether the
relationships in authorized CI data between a computer system, operating
system, and software component match the relationships in actual CI data.
For example, when you reconcile authorized CIs against actual CIs, is there a
successful match to indicate that for the computer system Mail Server 1, Lotus
Domino Server is installed on Microsoft Windows XP and that Windows XP
runs on Mail Server 1?
In most cases, for a full CI comparison, use a link rule that links CIs in Data Set 1
with actual CIs in Data Set 2 based on ACTCINUM (actual CI number) as the
value in the Attribute field for both Data Set 1 and Data Set 2.
When you create the comparison rule for full CI comparison, name the rule, select
CI for the Data Set 1 Field, and select the Full CI Comparison check box. The
Comparison Rules application disables the subtabs for data set filters, matches
found, and attributes equality. You cannot define comparison rule filters or define
comparison rule clauses when creating a full CI comparison rule.
For CI to actual CI relationship comparison, the system uses the task filter (if one
exists) and link rule to determine what objects in Data Set 1 to link to objects in
Data Set 2. Once the link is established between instances, relationships and
attributes for the authorized CI returned in the link and for all subsequent lower
level authorized CIs down the tree are compared with the linked Actual CI.
4 In the Data Set 1 field, click Select Value and select the value CI.
6 In the Data Set Object 1 field, click Select Value and select the value CI.
7 In the Data Set Object 1 Attribute field, click Select Value and select the
value ACTCINUM.
8 In the Data Set Object 2 field, click Select Value and select the value ACTCI.
9 In the Data Set Object 2 Attribute field, click Select Value and select the
value ACTCINUM.
10 Save the link rule record. Use it in the reconciliation task for full CI
comparison.
Operator: =
2 In the Comparison field, enter the name that you want to assign to the
comparison rule. This name is the unique identifier of the comparison rule.
4 In the Type of Reconciliation section, in the Data Set 1 field, click the Select
Value icon and select CI. The application automatically populates the Data
Set 2 field with ACTUAL CI.
5 Select the Full CI Comparison check box. The application disables the
comparison rule subtabs.
6 When you complete the comparison rule, click the Save Comparison Rule icon
to save the comparison rule.
For full CI comparison, authorized CIs are compared to actual CIs in the
following manner:
! If a task filter exists in the reconciliation task, the system selects authorized CI
objects based on the attributes defined in the task filter. If no task filter exists,
the system selects all authorized CIs for the leading set.
! Using the link rule or rules, the system compares CI objects in the leading set
with actual CI objects and determines whether there is a successful match.
! If the link rule establishes a match between instances, the system compares
the relationships and attributes for the top-level authorized CI in the link with
the relationships and attributes of corresponding top-level actual CI.
! Validity of the specific target for the relationship (that is, whether it is
the correct type).
! Whether the relationship name between the source and the target
matches.
Data Reliability
Data might be unreliable if any of the following conditions exist:
2 Use Integration Composer to import the collected data into the Maximo
database. For more information about importing data with Integration
Composer, refer to the IBM Tivoli Integration Composer System Administrators
Guide, Integration Composer Help, or Integration Adapter for Tivoli Application
Dependency Discovery Manager Implementation Guide.
Resource Allocation
Because the reconciliation process demands a large amount of server resources,
run reconciliations at a time when the server is least busy, such as late evening.
psdi.app.recontask.engine.ReconCronTask
Note that the Class field contains the class file for the reconciliation process. The
Value field for the parameter RECONTASKNAME in the Cron Task Parameters
table window contains the reconciliation task name entered in the Reconciliation
Task field in the Reconciliation Tasks application.
In addition, you should make sure that Integration Composer imports data before
reconciliation cron tasks are processed. You should also define reconciliation cron
tasks so that imports from Integration Composer and reconciliation cron tasks do
not occur simultaneously.
Scheduling Reconciliations 45
Setting Up a Reconciliation Cron Task
You use the CI Link Results application to perform the following actions:
For each object in the list, the application displays the following information
about the most recent link:
! Rule name name of the rule that generated the result. You can use the Detail
Menu in this field to navigate to the Link Rules application.
! Link date date and time the link result record was created.
The Authorized CI Information area displays the following information about the
authorized CI:
! CI authorized CI object. You can use the Detail Menu in this field to perform
the following actions:
The Actual CI Information area displays the following information about the
actual CI;
On the List tab you can delete selected CI link results or all CI link results in the
table window. Use the Select Records check box to select individual records to
delete or clear the check box to delete all records in the table window. If
appropriate, you can apply a filter to search for selected link results and then
delete all link results found.
You can also delete a record from the CI Link Result tab by selecting the record
that you want to delete and then selecting Delete CI Link Result(s) from the
Select Action menu.
! Link Rule Failures A link failure occurs when the system processes a link
rule and does not find a successful one-to-one link between the object in Data
Set 1 and the object in Data Set 2. Link failures occur when the reconciliation
process finds no links or finds multiple links.
! instances where the object from Data Set 1 failed to reconcile against the
object from Data Set 2
! instances where the object from Data Set 1 successfully matched the object
from Data Set 2
If you want to view only link rule failure or comparison rule results, you can use
the advanced search features to display only link results or comparison results.
You can also use the reconciliation results application to record information about
how you resolve discrepancies between Data Set 1 and Data Set 2. If you evaluate
a discrepancy and resolve it, you can mark a result record resolved. You can also
enter information about how you resolved the issue or an explanation about why
the discrepancy exists in the Comments field on the reconciliation result tab.
! Result Type type of results displayed (either link rule failures or comparison
rule results).
! Rule Name name of the rule that generated the result. If multiple link rules
exist and the system found no matches for any of the cascading link rules, the
field is blank. You can use the Detail Menu in this field to navigate to the Link
Rules application or the Comparison Rules application.
! Created Date date and time the reconciliation result record was created.
! Actual CI unique database identifier of the actual CI. You can use the Detail
Menu in this field to perform the following actions:
! view Classifications
! view Attributes
! navigate to the Actual Configuration Items application
! CI unique identifier for the object. You can use the Detail Menu in this field
to perform the following actions:
! view Classifications
! view Attributes
! navigate to the Configuration Items application
! view Work Details
! view Actual CI Details
! view CI Collections
! view CI Relationship History
In some cases fields displayed on the reconciliation result tab are empty. For
example, the system might not be able to determine a value based on the rule
definition. In some cases, multiple operations performed on different objects fail
to produce results. The system displays the maximum amount of unambiguous
information available.
The following table describes the result messages CCMDB displays for
comparison rule evaluations in the Message field.
C1a No CIs were retrieved by the The comparison rule has a Data Set 1 filter, and the system did
comparison filter. not retrieve any objects from Data Set 1 when applying this
filter.
C2a No actual CIs were retrieved by The comparison rule has a Data Set 2 filter, and the system did
the comparison filter. not retrieve any objects from Data Set 2 when applying this
filter.
C3 Matches found comparison has The number of Data Set 1 objects and the number of Data Set 2
succeeded. objects (after the system applied any applicable filter or filters)
matched the ratio specified in the rule.
or
or
C4b Attribute equality comparison The attributes for the Data Set 1 object and the Data Set 2 object
has succeeded. (and, if applicable, their measurement units) match exactly.
C5 Matches found comparison has The number of Data Set 1 objects and the number of Data Set 2
failed. objects (after the system applied any applicable filters) did not
match the ratio specified in the rule.
C6b Attribute equality comparison The attributes for the Data Set 1 and the Data Set 2 objects (or,
has failed. if applicable, their measurement units) did not match exactly.
C7 No CI object for attribute This result message occurs only when a specification is
equality comparison. selected for the Data Set 1 Object field. The message indicates
that the system did not find any object in Data Set 1 with the
class specified.
C8 No actual CIs object for attribute The system did not find any of the Data Set 2 objects specified
equality comparison. by the comparison rule.
C9 No CI and actual CI object for The system did not find any Data Set 1 object or Data Set 2
attribute equality comparison. object specified in the comparison rule.
aIf a comparison rule has both a Data Set 1 filter and a Data Set 2 filter and neither filter returns any records, the system might display both
Messages C3 and C4 indicate that the system successfully matched the Data Set 1
object and Data Set 2 object when the comparison rule was processed. All other
messages indicate that the system did not successfully match a Data Set 1 object to
a Data Set 2 object.
The following table describes the link failure messages CCMDB displays in the
Messages field.
L01 No CIs were retrieved in task Leading Set in the Reconciliation Task: CI
<TASK_NAME>.
Reason for Link Failure: When the system processed the
specified reconciliation task (that is, <TASK_NAME>), it did
not retrieve CI objects from the database.
L02 No actual CIs were retrieved Leading Set in the Reconciliation Task: Actual CI
in task <TASK_NAME>.
Reason for Link Failure: When the system processed the
specified reconciliation task (that is, <TASK_NAME>), it did
not retrieve actual CIs from the database.
L03 This CI has no matching Leading Set in the Reconciliation Task: CIs
actual CI.
Reason for Link Failure: The system did not find an actual CI
that matched the CI in the leading set.
! If one link rule exists, the system displays the link rule
name.
L04 This actual CI has no Leading Set in the Reconciliation Task: Actual CIs
matching CI.
Reason for Link Failure: The system did not find an object in
CIs that matched the Actual CI object in the leading set.
! If one link rule exists, the system displays the link rule
name.
L05 This CI links to more than Leading Set in the Reconciliation Task: CIs
one actual CI.
Reason for Link Failure: When the system processed the
reconciliation task, the link rule specified in the Rule Name
field found more than one object in the actual CI data set that
matched the CI object in the leading set.
L06 This actual CI links to more Leading Set in the Reconciliation Task: Actual CIs
than one CI.
Reason for Link Failure: When the system processed the
reconciliation task, the link rule specified in the Rule Name
field found more than one object in the CI data set that
matched the actual CI object in the leading set.
L09 More than one actual CI links Leading Set in the Reconciliation Task: Actual CIs
to this CI.
Reason for Link Failure: When the system processed the
reconciliation task, the link rule specified in the Rule Name
field found more than one object in the actual CI data set that
matched the CI object in the subordinate set.
L10 More than one CI links to this Leading Set in the Reconciliation Task: CIs
actual CI.
Reason for Link Failure: When the system processed the
reconciliation task, the link rule specified in the Rule Name
field found more than one object in the CI data set that
matched the actual CI object in the subordinate set.
L11 More than one actual CI links Leading Set in the Reconciliation Task: Actual CIs
to this CI due to different
cascading rules. Reason for Link Failure: When the system processed the
reconciliation task, different cascading link rules found more
than one actual CI object in the leading set that matched the
same CI.
L12 More than one CI links to this Leading Set in the Reconciliation Task: CIs
actual CI due to different
cascading rules. Reason for Link Failure: When the system processed the
reconciliation task, different cascading link rules found more
than one CI object in the leading set that matched the same
actual CI.
The system generates the following messages when there is no task filter or when
the task filter has the type CI: L01, L03, L05.
The system generates the following messages when the task filter has the type
Actual CI: L02, L04, L06,.
R1 Relationship comparison between {Authorized CI} and {Related Authorized CI) has failed.
R2 Relationship comparison between {Authorized CI} and {Related Authorized CI} has
succeeded.
2 On the Advanced Search menu, select More Search Fields. The application
displays the Select Value dialog box.
3 In the Result Type field, click Select Value to select the type of result that you
want to view. The application displays the Select Value dialog box.
4 In the Select Value dialog box, select the type of result that you want to view.
The application displays the selected value in the Result Type field on the
More Search Fields dialog box.
5 On the More Search Fields dialog box, click Find. The application displays
the selected results in CI Reconciliation Results table window on the List tab.
Resolving from the List In the table window on the List tab, you can mark selected reconciliation results
Tab resolved or mark all reconciliation results resolved. Use the Select Records check
box to select individual records to resolve or clear the check box to mark all
records resolved.
To mark CI reconciliation results resolved from the List tab, select one of the
following options:
1 From the Select Action menu, select Mark Result(s) Resolved. The
application displays a confirmation dialog box asking you to confirm that
you want to mark all rows as resolved.
2 On the confirmation dialog box, click Yes. The application marks all
reconciliation results in the table window resolved.
NOTE You cannot use this feature unless your result set is less than 200 rows.
2 In the List table window, select the Select Row check box for each record
that you want to mark resolved.
3 After you have selected the check box for each record that you want to
resolve, select Mark Result(s) Resolved from the Select Action menu. The
4 On the confirmation dialog box, click Yes. The application marks the
selected reconciliation results resolved.
Resolving from the CI To mark reconciliation results as resolved from the CI Reconciliation Result tab,
Reconciliation Result Tab complete the following steps:
! From the Select Action menu on the CI Reconciliation Result tab, select
Mark Result(s) Resolved. The application displays a confirmation dialog
box asking you to confirm that you want to mark the record as resolved.
On the confirmation dialog box, click Yes. The application marks the
reconciliation result record resolved.
4 When you finish viewing the result, click the Save icon to save the comment.
On the List tab you can delete selected reconciliation results or all reconciliation
results in the table window. Use the Select Records check box to select individual
records to delete or clear the check box to delete all records in the table window. If
appropriate, you can apply a filter to search for selected reconciliation results and
then delete all reconciliation results found.
You can also delete a record from the CI Reconciliation Result tab by selecting the
record that you want to delete and then selecting Delete CI Reconciliation
Result(s) from the Select Action menu.
! matches found
! attributes equality
! full CI comparison
The examples illustrate how to set up task filters, link rules, and comparison
rules.
To process this reconciliation, define a task filter that selects authorized CI records
at the McLean site for evaluation.
For this subset of records, use a link rule based on actual CI number to search for
a match between a computer system in authorized CIs and a computer system in
actual CIs.
Note that if the system does not succeed in establishing a link between the
authorized CI and an actual CI, the system reports link failure results that you can
view in the CI Reconciliation Results application.
! link rule that matches actual CI number in authorized CIs with the
corresponding actual CI number in actual CIs
! a Data Set 1 filter that selects authorized CIs that have Windows XP
installed
Task Filter 1 In the Task Filters application, define a task filter to select only authorized CIs
at the McLean site. To do this you specify the following parameters:
Filter Type CI
Attribute SITEID
Value McLean
When you use this task filter, the system selects authorized CIs at the McLean
site for the leading set in the reconciliation.
Link Rule 2 In the Link Rules application, define a link rule that searches for links between
computer systems in authorized CIs and computer systems in actual CIs
based on actual CI numbers. To define this link rule, you set up the following
parameters:
Data Set 1 CI
Comparison Rule 3 Define a Data Set 1 filter for the comparison rule that selects authorized CIs
that have the Windows XP operating system. To set up the actual CI filter,
select the following parameters:
Operator LIKE
Value WINDOWS XP
In this case, the system selects authorized CIs with operating systems with a
name like Windows XP and applies the comparison rule to those authorized
CIs.
4 In addition, add a matches found clause to the comparison rule that specifies
you want to find at least 1 instance of the actual CI object for each instance of
the authorized CI. To define the matches found clause, you specify the
following parameters:
Reconciliation Task 5 Create a reconciliation task named XPComplianceMclean that combines the
following components into a reconciliation task that you can schedule in the
Cron Task Setup application:
! link rule that matches actual CI number in authorized CIs with the
corresponding actual CI number in actual CIs
! instances where the object from Data Set 1 failed to reconcile against the
object from Data Set 2
! instances where the object from Data Set 1 successfully matched the object
from Data Set 2
Cron Task 8 In the Cron Task Setup application, define a cron task to schedule execution of
the operating system compliance reconciliation task. In the Cron Task
application, make sure that you use the same value in the Value field on the
Parameters tab that you used in the Reconciliation Task field on the
Reconciliation Task tab: XPComplianceMclean.
CI Link Results In the CI Link Results application, you can view the instances where the actual CI
Application number on an authorized CI matched an actual CI number on an actual CI.
CI Reconciliation Results In the CI Reconciliation Results application you can view two types of
Application reconciliation results:
! instances where the link rule based on actual CI number did not find a
successful link between an authorized CI and an actual CI
If you evaluate a discrepancy and resolve it, you can mark a result record
resolved. You can also enter information about how you resolved the issue or an
explanation about why the discrepancy exists in the Comments field on the CI
Reconciliation Result tab.
To process this reconciliation, define a reconciliation task with a task filter that
selects CI records at the McLean site for evaluation.
For this subset of records, use a link rule based on actual configuration item
number to search for a match between a CI and an actual CI.
! link rule that matches actual CI number in authorized CIs with the
corresponding actual CI number in actual CIs
Task Filter 1 Define a task filter to select only authorized CIs at the McLean site. To do this
you specify the following parameters:
Filter Type CI
Attribute SITEID
Value McLean
When you use this task filter, the system selects authorized CIs at the McLean
site for the leading set in the reconciliation.
Link Rule 2 In the Link Rules application, define a link rule that searches for links between
computer systems in authorized CIs and computer systems in actual CIs
based on actual CI numbers. To define this link rule, you set up the following
parameters:
Data Set 1 CI
Comparison Rule 3 In the Comparison Rules application, define a comparison rule ( with an
attributes equality clause that compares memory size for the computer
systems in authorized CIs (Data Set 1) with memory size of computer systems
in actual CIs (Data Set 2). To define the attributes equality clause, you set up
the following parameters:
Reconciliation Task 4 In the Reconciliation Tasks application, create a reconciliation task named
MemComplianceMclean that combines the following components into a
reconciliation task that you can schedule in the Cron Task Setup application:
! link rule that matches actual CI number in authorized CIs with the
corresponding actual CI number in actual CIs
! instances where the object from Data Set 1 fails to reconcile against the
object from Data Set 2
! instances where the object from Data Set 1 successfully matches the object
from Data Set 2
Cron Task 7 In the Cron Task Setup application, define a cron task to schedule execution of
the memory compliance reconciliation task. In the Cron Task application,
make sure that you use the same value in the Value field on the Parameters
tab that you used in the Reconciliation Task field on the Reconciliation Task
tab: MemComplianceMclean.
CI Link Results In the CI Link Results application, you can view the instances where the actual CI
Application number on an authorized CI matched an actual CI number on an actual CI.
CI Reconciliation Results In the CI Reconciliation Results application you can view two types of
Application reconciliation results:
! instances where the link rule based on actual CI number did not find a
successful link between an authorized CI and an actual CI
If you evaluate a discrepancy and resolve it, you can mark a result record
resolved. You can also enter information about how you resolved the issue or an
explanation about why the discrepancy exists in the Comments field on the
reconciliation result tab.
Full CI Comparison
In this sample scenario, CCMDB compares authorized CI records for computer
systems at the McLean site with actual CI records. Because this is a full CI
comparison rule, this scenario compares the relationships of authorized CIs and
the attributes associated with the authorized CIs with the relationships and
attributes associated with the corresponding actual CIs.
To process this reconciliation, define a task filter with two clauses, one that selects
authorized CI records at the McLean site and a second that selects generic
computer systems. When processing this task filter, the system selects an actual
CI only if the item is a computer system assigned to the McLean site. Both
conditions must be met. The system creates a leading set based on these two
criteria.
For the reconciliation task, use a link rule based on actual CI number to search for
a match between a computer system in authorized CIs and a computer system in
actual CIs.
In the comparison rule defined for this task, select the Full CI Comparison check
box. If the system succeeds in matching an authorized CI (that is, a computer
system at the Mclean site) to an actual CI, it processes the comparison rule on the
reconciliation task and compares the relationships and attributes of that computer
system with the corresponding computer system in actual CIs.
Note that if the system does not succeed in establishing a link between the
authorized CI and an actual CI, the system reports link failure results that you can
view in the CI Reconciliation Results application.
! CI task filter with two clauses: one to select CIs for McLean and a second
to select only generic computer systems
! link rule that matches actual CI number in authorized CIs with the
corresponding actual CI number in actual CIs
Task Filter 1 In the Task Filters application, define a task filter and select CI for the Filter
Type field.
a To select only authorized CIs at the McLean site, create a task filter
clause with the following parameters:
Attribute SITEID
Value McLean
Attribute CLASSSTRUCTUREID
When you use this task filter, the system selects computer systems at the
McLean site for the leading set in the reconciliation.
Link Rule 3 In the Link Rules application, define a link rule that searches for links between
computer systems in authorized CIs and computer systems in actual CIs
based on actual CI numbers. To define this link rule, you set up the following
parameters:
Data Set 1 CI
Comparison Rule 4 Define a comparison rule for full CI comparison. Name the rule, select CI for
the Data Set 1 field, and select the Full CI Comparison check box. The
Comparison Rules application disables the subtabs for data set filters,
matches found, and attributes equality. You cannot define comparison rule
filters or define comparison rule clauses when creating a full CI comparison
rule.
Reconciliation Task 5 In the Reconciliation Tasks application, set up a reconciliation task that
combines the following components into a reconciliation task that you can
schedule in the Cron Task Setup application:
! CI task filter that selects computers in authorized CIs at the McLean site
! link rule that matches actual CI number in authorized CIs with the
corresponding actual CI number in actual CIs
! instances where the object from Data Set 1 fails to reconcile against the
object from Data Set 2
! instances where the object from Data Set 1 successfully matches the object
from Data Set 2
Cron Task 8 In the Cron Task Setup application, define a cron task to schedule execution of
the full CI comparison reconciliation task. In the Cron Task application, make
sure that you use the same value in the Value field on the Parameters tab that
you used in the Reconciliation Task field on the Reconciliation Task tab.
CI Link Results In the CI Link Results application, you can view the instances where the actual CI
Application number on an authorized CI matched an actual CI number on an actual CI.
CI Reconciliation Results In the CI Reconciliation Results application you can view two types of
Application reconciliation results:
! instances where the link rule based on actual CI number did not find a
successful link between an authorized CI and an actual CI
If you evaluate a discrepancy and resolve it, you can mark a result record
resolved. You can also enter information about how you resolved the issue or an
explanation about why the discrepancy exists in the Comments field on the
reconciliation result tab.
This information was developed for products and services offered in the U.S.A.
IBM may not offer the products, services, or features discussed in this document
in other countries. Consult your local IBM representative for information on the
products and services currently available in your area. Any reference to an IBM
product, program, or service is not intended to state or imply that only that IBM
product, program, or service may be used. Any functionally equivalent product,
program, or service that does not infringe any IBM intellectual property right
may be used instead. However, it is the user's responsibility to evaluate and verify
the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not grant you
any license to these patents. You can send license inquiries, in writing, to:
For license inquiries regarding double-byte (DBCS) information, contact the IBM
Intellectual Property Department in your country or send inquiries, in writing, to:
The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law:
Any references in this information to non-IBM Web sites are provided for
convenience only and do not in any manner serve as an endorsement of those
Web sites. The materials at those Web sites are not part of the materials for this
IBM product and use of those Web sites is at your own risk.
Licensees of this program who wish to have information about it for the purpose
of enabling: (i) the exchange of information between independently created
programs and other programs (including this one) and (ii) the mutual use of the
information which has been exchanged, should contact:
IBM Corporation
2Z4A/101
11400 Burnet Road
Austin, TX 78758 U.S.A.
The licensed program described in this document and all licensed material
available for it are provided by IBM under terms of the IBM Customer
Agreement, IBM International Program License Agreement or any equivalent
agreement between us.
All statements regarding IBM's future direction or intent are subject to change or
withdrawal without notice, and represent goals and objectives only.
This information contains examples of data and reports used in daily business
operations. To illustrate them as completely as possible, the examples include the
names of individuals, companies, brands, and products. All of these names are
fictitious and any similarity to the names and addresses used by an actual
business enterprise is entirely coincidental.
If you are viewing this information softcopy, the photographs and color
illustrations may not appear.
Trademarks
Adobe, Acrobat, Portable Document Format (PDF), and PostScript are either
registered trademarks or trademarks of Adobe Systems Incorporated in the
United States, other countries, or both.
AIX, IBM, IBM Corporation, the IBM logo, Tivoli, and WebSphere are
registered trademarks of the International Business Machines Corporation in
the United States, other countries, or both.
68 IBM Tivoli Change and Configuration Management Database: Reconciliation Module Implementation Guide
Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino
logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are
trademarks or registered trademarks of Intel Corporation or its subsidiaries in
the United States and other countries.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of
Microsoft Corporation in the United States, other countries, or both.
Sun, Sun Microsystems, the Sun logo, and Solaris are trademarks of Sun
Microsystems, Inc.
UNIX is a registered trademark of The Open Group in the United States and
other countries.
69
70 IBM Tivoli Change and Configuration Management Database: Reconciliation Module Implementation Guide
Index
A L
D online support v
deleting 34
duplicating 34
modifying 34
setting up 4
Reconciliation Tasks application 31
task filters
components 6
deleting 8
duplicating 8
filter type 6
modifying 8
Task Filters application 5
wildcard characters 18