© 2008 Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice Lesson # 8 HP UCMDB 8.0 Essentials Introduction to TQL

2 Lesson Objectives In this lesson, you will learn how to: Describe the purpose and use of Topology Query Language (TQL) Describe the applications and systems that use TQL Create a basic TQL query Use Attribute conditions on a TQL to filter the results Use Cardinality conditions on a TQL to filter the results Use Element ID conditions on a TQL to filter the results Use the Include Subtypes property Create a query to extract information from the CMDB to solve business problems About this Chapter

3 Introduction to TQL TQL stands for Topology Query Language TQL is a graphical language composed of nodes and links TQL is the method for finding data in the CMDB TQL is a constraint language, like Prolog or SQL TQL queries are composed of assertions. TQL queries return objects which match the criteria Topology Query Language Overview

4 TQL Dependant Subsystems Topology Query Language Overview

5 TQL Query Process Topology Query Language Overview

6 TQL Query Example TQL Query CMDB data TQL result Topology Query Language Overview

7 Building a TQL Query Add nodes and relationships Graphical expression of nodes and links Defines the data to be returned from the CMDB Filter the resulting TQL Constraints to limit the CIs returned from the CMDB TQL node condition TQL relationship condition Topology Query Language Overview

8 Constraint Types CIT Instance Attributes Specific value or a range of values of an attribute –Host IP must begin with “ *” –Host OS must equal Linux Relationships among CIT instances Cardinality of linked nodes –A host should have exactly two network interfaces Topology Query Language Overview

9 Attribute Constraints Constraints based on an intrinsic characteristic of an object May be chained using Boolean logic (A and B or C) Available constraints are based on the SQL “where clause” query syntax Constraints include =, !=,, NULL, NOT NULL, LIKE, NOT LIKE & LIKE ignore case Example: Host object with a DNS Name of “foo.bar.com” Host with operating system like %Windows 2003% Topology Query Language Overview

10 Relationship Constraints Cardinality Constraint based on relationships between instances Can be applied to one or both ends of a link between two nodes May be used in combination with other constraints Examples 1..* -- At least one to one, possibly to many 0..* -- Optional Must not be there Must be in the range 7 to 14 Topology Query Language Overview

11 Common Cardinality Constraints 0..* Indicates none or more The CI may or may not exist The CI is optional 0..0 Indicates that the CI has no CIs linked to it None may exist 1..* Indicates that the CI has at least one CI linked to it 1 to many Topology Query Language Overview

12 Single Object Discovery TQL DISCOVERY: ACTIVITY Assume the CMDB is populated with the following basic geometric shapes. Each shape represents a component of the environment. What does this TQL select from the CMDB? TQL

13 Multiple Object Discovery TQL DISCOVERY: ACTIVITY What does this TQL select from the CMDB? TQL

14 Complex Discovery TQL DISCOVERY: ACTIVITY What does this TQL select from the CMDB? TQL

15 Discovery Filter TQL DISCOVERY: ACTIVITY How would we modify this TQL to return all squares, and also any circles attached to squares? TQL

16 TQL Usage Across the Modeling Managers Topology Query Language Overview

17 New TQL Overview Defines the name, type and properties of the TQL TQL Types View Report Correlation Enrichment Integration Discovery Structure to hold the links and nodes Topology Query Language Overview Identity

18 Creating a New TQL Topology Query Language Overview

19 Nodes and Relationships Overview Defines the query in a graphical expression of nodes and links Defines the CITs and relationships whose instances will be returned from the CMDB Topology Query Language Overview Identity

20 Adding Nodes to a TQL Topology Query Language Overview

21 Defining Relationships Between Nodes Topology Query Language Overview

22 Basic Query: all Unix hosts TQL Query for all Unix hosts with CPU? Topology Query Language Examples

23 Basic Query: Unix hosts with Apache TQL for all networks with Unix hosts with their IP Addresses? Topology Query Language Examples

24 Basic Query: Unix host resources Where can you verify the relationship type between two CIT’s? Topology Query Language Examples

25 Attribute Conditions Review Places conditions on the query to constrain the results Filters the CIs returned to the view Constrains by the value of an attribute Topology Query Language Overview Identity

26 TQL Node Properties Dialog Topology Query Language Overview

27 TQL Node Attribute Conditions Host Operating System Equal ignore case "windows 2003" AND Host Operating System Release Equal "5" Topology Query Language Overview

28 Adding Attribute Conditions Topology Query Language Overview

29 Fixed Value Parameterized Conditions Topology Query Language Overview

30 Example - Windows 2003 Servers TQL Definition Result Set Topology Query Language Examples

31 Example - Unix Host with OS other than Linux Result Set Topology Query Language Examples TQL Definition

32 Identity Conditions Overview Places conditions on the query to constrain the results Filters the CIs returned to the view Constrains by a CIT instance Topology Query Language Overview Identity

33 Defining an Identity (Select Identities) Topology Query Language Overview

34 All Hosts on the Subnet TQL Topology Query Language Overview

35 Cardinality Conditions Review Places conditions on the query to constrain the results Filters the CIs returned to the view Constrains by the number of relationships from one CI to another Topology Query Language Overview Identity

36 Defining Relationship Cardinality Topology Query Language Overview

37 Adding Relationship Cardinality Topology Query Language Overview

38 Unix Hosts and their CPUs What would be displayed for 0..* cardinality from CPU to Unix? Topology Query Language Example

39 Unix Hosts with CPUs Topology Query Language Example

40 Unix Hosts with 2 or more CPUs Topology Query Language Examples

41 Include Subtypes Property Overview A node or relationship condition selected by default When selected the TQL results include the CI Type instances and instances of all subtypes Host CIT returns Hosts, Unix, Windows, etc. When deselected the TQL results include the CI Type instances but none of the instances of any of the subtypes Host CIT returns Hosts only Topology Query Language Overview

42 Editing Include Subtypes Properties Topology Query Language Overview

43 Using Include Subtype Properties Topology Query Language Overview

44 Review Questions INTRODUCTION TO TQL 1. What are the different types of TQLs? Why do we need different types of TQLs? 2. List one major difference between SQL and TQL. 3. How is SQL syntax used by TQL? 4. What is the purpose of an Attribute condition? 5. When might an Identity condition be used in a View TQL? 6. What property specifies relationships between instances retrieved by the TQL? 7. When defining cardinality, what does * indicate?

45 Summary Key points in this lesson: A TQL query provides a graphical or tabular representation of nodes and relationships between the nodes A TQL may be built in any of the Modeling managers except IT Universe Manager and CI Type Manager A TQL query consists of nodes and relationships along with their conditions A TQL can be edited by adding/subtracting nodes and setting attribute, element id and cardinality conditions All TQL types can be created in Query Manager but only integration and discovery TQLs can be edited in Query Manager Chapter Summary

46 Exercises INTRODUCTION TO TQL Please complete the lesson review questions and exercises in your book. After everyone is finished, the instructor will review the answers.

47