ibm tivoli license manager: data...

IBM Tivoli License Manager

Data Dictionary

Version 2.1

SC32-1432-01

��

Second Edition, October 2004

This edition applies to version 2.1 of IBM Tivoli License Manager (program number 5724-D33) and to all subsequent

releases and modifications until otherwise indicated in new editions.

IBM welcomes your comments.

Address your comments to:

IBM License Management Information Development

Rome Tivoli Lab

IBM Italia S.p.A.

Via Sciangai, 53

00144 Rome

Italy

Fax Number: (+39) 06 5966 2077

Internet ID: [email protected]

When you send information to IBM, you grant IBM a non-exclusive right to use or distribute the information in any

way it believes appropriate without incurring any obligation to you.

© Copyright International Business Machines Corporation 2002, 2004. All rights reserved.

US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract

with IBM Corp.

Note

Before using this information and the product it supports, read the information under “Notices” on page 73.

Contents

About this book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v

Who should read this book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v

What this book contains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v

Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v

Tivoli License Manager library . . . . . . . . . . . . . . . . . . . . . . . . . . . . v

Related publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

Accessing publications online . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

Ordering publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Accessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Tivoli technical training . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Contacting software support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Determine the business impact of your problem . . . . . . . . . . . . . . . . . . . . . . viii

Describe your problem and gather background information . . . . . . . . . . . . . . . . . . ix

Submit your problem to IBM Software Support . . . . . . . . . . . . . . . . . . . . . . ix

Searching knowledge bases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

Search the information center on your local system or network . . . . . . . . . . . . . . . . ix

Search the Internet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x

Obtaining fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x

Updating support information . . . . . . . . . . . . . . . . . . . . . . . . . . . . x

Conventions used in this book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

Typeface conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

Operating system-dependent notation . . . . . . . . . . . . . . . . . . . . . . . . . xii

Chapter 1. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Database table names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Key to using the tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Chapter 2. Tables in the administration server database . . . . . . . . . . . . . . . 3

Administrators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Optional fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Catalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Software use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Table Relationship Diagrams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

ADMIN_CUST_REL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

ADMINISTRATOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

AGENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

AGENT_EVENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

AGENT_H . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

AGENT_INV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

AGENT_INV_LIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

AGENT_SYNC_CUST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

AGENT_SYNC_DIV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

COMP_HIER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

COMP_MOD_REL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

COMPONENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

CONTRACT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

CONTROL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

COUNTRY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

CUST_OPT_FIELD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

CUSTOMER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

DIVISION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

© Copyright IBM Corp. 2002, 2004 iii

DIVISION_H . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

ENDUSER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

ENTITLEMENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

INV_H_COMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

INV_H_LIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

INV_H_LIC_COMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

INV_H_PLIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

INV_H_PLIC_COMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

LIC_TARGET_HREL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

LIC_TARGET_REL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

LIC_USER_HREL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

LIC_USER_REL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

LICENSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

LICENSE_DISTRIBUTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

LICENSE_H . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

MODULE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

NODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

NODE_H . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

OID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

OPT_FIELD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

OPT_FIELD_DEF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

PLIC_COMP_HREL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

PLIC_COMP_REL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

PLICENSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

PLICENSE_H . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

PROFILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

PROFILE_ACTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

SERVER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

SERVER_H . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

SERVICE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

UNKNOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

USAGE_COMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

USAGE_COMP_USER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

USAGE_H_COMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

USAGE_H_DIV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

USAGE_H_LIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

USAGE_H_LIC_COMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

USAGE_H_OOCOD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

USAGE_H_PLIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

USAGE_H_PLIC_COMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

USAGE_LIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

VENDOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

iv IBM Tivoli License Manager: Data Dictionary

About this book

This book is a reference to the tables and indexes of the IBM® Tivoli® License

Manager administration server database. It should be used to obtain information to

enable you to extract data from the Tivoli License Manager database, and to

construct your own views on that data.

Who should read this book

This book is intended for database administrators and those responsible for

integrating information derived from this product with that derived from others.

What this book contains

This book is organized as follows:

v Chapter 1, “Overview,” on page 1 provides a description of the structure of the

Tivoli License Manager databases.

v Chapter 2, “Tables in the administration server database,” on page 3 provides a

detailed reference for the tables of the administration server database.

Publications

This section lists publications in the Tivoli License Manager library and related

documents. It also describes how to access Tivoli publications online and how to

order Tivoli publications.

Tivoli License Manager library

The Tivoli License Manager library consists of the following books:

v IBM Tivoli License Manager: Administration, SC32-1430

Provides an overview of Tivoli License Manager and gives information about

how to use the product to set up a monitoring infrastructure, define licensing

conditions, and produce reports.

v IBM Tivoli License Manager: Planning, Installation, and Configuration, SC32-1431

Provides information about planning, installing, and configuring the Tivoli

License Manager product

v IBM Tivoli License Manager: Data Dictionary, SC32-1432

Provides descriptions of the database tables and indexes maintained in the Tivoli

License Manager administration server database.

v IBM Tivoli License Manager: Problem Determination, SC32-9102

Provides information about Tivoli License Manager diagnostic information,

including messages, traces, and event logs, and about tools and techniques for

diagnosing problems.

v IBM Tivoli License Manager: Catalog Management, SC32-1434

Describes how to use the software catalog management tool to maintain an

up-to-date master catalog of products and the modules that are used to detect

their presence and use on monitored computers.

v IBM Tivoli License Manager, Version 2.1: Warehouse Enablement Pack, Version 2.1.0

Implementation Guide for Tivoli Data Warehouse, Version 1.2, SC32-1433

© Copyright IBM Corp. 2002, 2004 v

Provides instructions and other information related to enabling the use of Tivoli

Data Warehouse with Tivoli License Manager.

v IBM Tivoli License Manager: Release Notes, SC32-1429

Provides a summary of changes made in the release, lists the supported

platforms for each component, documents known errors and workarounds, and

includes the latest information about the product that could not be included in

the main documentation. This document is not delivered on the publications CD,

but is available from the Tivoli Software Information Center. Updated versions

of the document may be placed on the Tivoli Software Information Center at any

time.

How to access the Tivoli Software Information Center is described in “Accessing

publications online.”

Related publications

The following documents also provide useful information:

v IBM DB2 Universal Database™: Quick Beginnings for DB2® Servers, GC09-4836

v IBM DB2 Universal Database: Quick Beginnings for DB2 Clients, GC09-4832

These Quick Beginnings guides provide an introduction to installing and

configuring DB2 products.

v http://www.ibm.com/software/webservers/appserv/infocenter.html provides

access to WebSphere® Application Server product information.

The Tivoli Software Glossary includes definitions for many of the technical terms

related to Tivoli software. The Tivoli Software Glossary is available, in English only,

at the following Web site:

www.ibm.com/software/tivoli/library/

Access the glossary by clicking the Glossary link on the left pane of the Tivoli

software library window.

Accessing publications online

The Tivoli License Manager documentation CD contains the publications that are

in the product library, other than the IBM Tivoli License Manager: Release Notes, in

all supported languages. The format of the publications is PDF, HTML, or both. To

access the publications using a Web browser, open the allpubs.htm file. The file is

in the root directory on the documentation CD. Select the language of your choice,

and an Information Center for the product in that language is displayed. Select the

publication and the format in which you want to view it.

Note: On Windows® platforms, an autorun opens the allpubs.htm file in your

default browser.

IBM posts publications for this and all other Tivoli products, as they become

available and whenever they are updated, to the Tivoli Software Information

Center Web site. Access the Tivoli Software Information Center by first going to the

Tivoli software library at the following Web address:

www.ibm.com/software/tivoli/library/

vi IBM Tivoli License Manager: Data Dictionary

http://www.ibm.com/software/webservers/appserv/infocenter.html

http://www.ibm.com/software/tivoli/library

http://www.ibm.com/software/tivoli/library

Scroll down and click the Product manuals link on the left pane of the Tivoli

software library window. In the Tivoli Technical Product Documents Alphabetical

Listing window, click the IBM Tivoli License Manager link to access the product

library at the Tivoli Information Center.

Note: If you print PDF documents on other than letter-sized paper, set the option

in the File → Print window that allows Adobe Reader to print letter-sized

pages on your local paper.

Ordering publications

You can order many Tivoli publications online at the following Web site:

www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgi

You can also order by telephone by calling one of these numbers:

v In the United States: 800-879-2755

v In Canada: 800-426-4968

In other countries, see the following Web site for a list of telephone numbers:

www.ibm.com/software/tivoli/order-lit/

Accessibility

Accessibility features help users with a physical disability, such as restricted

mobility or limited vision, to use software products successfully. With this product,

you can use assistive technologies to hear and navigate the interface. You can also

use the keyboard instead of the mouse to operate all features of the graphical user

interface.

This product is operated using a Web browser, which has certain built-in

accessibility features, and has been provided with specific shortcut keys for

navigating the Web interface, starting tasks, and performing toolbar actions.

For additional information, see the Accessibility appendix in the IBM Tivoli License

Manager: Administration.

Tivoli technical training

For Tivoli technical training information, refer to the following IBM Tivoli

Education Web site:

www.ibm.com/software/tivoli/education/

Contacting software 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. The type of software maintenance contract that you need depends on the

type of product you have:

About this book vii

http://publib.boulder.ibm.com/tividd/td/IBMTivoliLicenseManager2.1.html

http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgi

http://www.ibm.com/software/tivoli/order-lit/

http://www.ibm.com/software/tivoli/education

v For IBM distributed software products (including, but not limited to, Tivoli,

Lotus®, and Rational® products, as well as DB2 and WebSphere products that

run on Windows or UNIX® operating systems), enroll in Passport Advantage® in

one of the following ways:

– Online: Go to the Passport Advantage Web page and click How to Enroll .

The Web address is the following:

www.lotus.com/services/passport.nsf/WebDocs/Passport_Advantage_Home

– By phone: For the phone number to call in your country, go to the IBM

Software Support Web site

(techsupport.services.ibm.com/guides/contacts.html) and click the name of

your geographic region.v For IBM eServer™ software products (including, but not limited to, DB2 and

WebSphere products that run in zSeries®, pSeries®, and iSeries™ environments),

you can purchase a software maintenance agreement by working directly with

an IBM sales representative or an IBM Business Partner. For more information

about support for eServer software products, go to the IBM Technical Support

Advantage Web page (www.ibm.com/servers/eserver/techsupport.html).

If you are not sure what type of software maintenance contract you need, call

1-800-IBMSERV (1-800-426-7378) in the United States or, from other countries, go to

the contacts page of the IBM Software Support Handbook on the Web

(techsupport.services.ibm.com/guides/contacts.html) and click the name of your

geographic region for phone numbers of people who provide support for your

location.

Follow the steps in this topic to contact IBM Software Support:

1. “Determine the business impact of your problem”

2. “Describe your problem and gather background information” on page ix

3. “Submit your problem to IBM Software Support” on page ix

Determine the business impact of your problem

When you report a problem to IBM, you are asked to supply a severity level.

Therefore, you need to understand and assess the business impact of the problem

you are reporting. Use the following criteria:

Severity 1 Critical business impact: You are unable to use the program,

resulting in a critical impact on operations. This condition

requires an immediate solution.

Severity 2 Significant business impact: The program is usable but is

severely limited.

Severity 3 Some business impact: The program is usable with less

significant features (not critical to operations) unavailable.

Severity 4 Minimal business impact: The problem causes little impact on

operations, or a reasonable circumvention to the problem has

been implemented.

viii IBM Tivoli License Manager: Data Dictionary

http://www.lotus.com/services/passport.nsf/WebDocs/Passport_Advantage_Home

http://techsupport.services.ibm.com/guides/contacts.html

http://www.ibm.com/servers/eserver/techsupport.html

http://techsupport.services.ibm.com/guides/handbook.html

Describe your problem and gather background information

When explaining a problem to IBM, be as specific as possible. Include all relevant

background information so that IBM Software Support specialists can help you

solve the problem efficiently. To save time, know the answers to these questions:

v What software versions were you running when the problem occurred?

v Do you have logs, traces, and messages that are related to the problem

symptoms? IBM Software Support is likely to ask for this information.

v Can the problem be recreated? If so, what steps led to the failure?

v Have any changes been made to the system? (For example, hardware, operating

system, networking software, and so on.)

v Are you currently using a workaround for this problem? If so, please be

prepared to explain it when you report the problem.

The problem determination toolkit includes commands for assembling problem

determination information for all product components. For more information see

IBM Tivoli License Manager: Problem Determination.

Submit your problem to IBM Software Support

You can submit your problem in one of two ways:

v Online: Go to the ″Submit and track problems″ page on the IBM Software

Support site (www.ibm.com/software/support/probsub.html). Enter your

information into the appropriate problem submission tool.

v By phone: For the phone number to call in your country, go to the contacts page

of the IBM Software Support Handbook on the Web

(techsupport.services.ibm.com/guides/contacts.html) and click the name of your

geographic region.

If the problem you submit is for a software defect or for missing or inaccurate

documentation, IBM Software Support creates an Authorized Program Analysis

Report (APAR). The APAR describes the problem in detail. Whenever possible,

IBM Software Support provides a workaround for you to implement until the

APAR is resolved and a fix is delivered. IBM publishes resolved APARs on the

IBM product support Web pages daily, so that other users who experience the

same problem can benefit from the same resolutions.

For more information about problem resolution, see “Searching knowledge bases”

and “Obtaining fixes” on page x.

Searching knowledge bases

If you have a problem with your IBM software, you want it resolved quickly. Begin

by searching the available knowledge bases to determine whether the resolution to

your problem is already documented.

Search the information center on your local system or network

IBM provides extensive documentation that can be installed on your local machine

or on an intranet server. You can use the search function of this information center

to query conceptual information, instructions for completing tasks, reference

information, and support documents.

About this book ix

http://www.ibm.com/software/support/probsub.html

http://techsupport.services.ibm.com/guides/contacts.html

Search the Internet

If you cannot find an answer to your question in the information center, search the

Internet for the latest, most complete information that might help you resolve your

problem. To search multiple Internet resources for your product, expand the

product folder in the navigation frame to the left and select Support on the Web.

From this topic, you can search a variety of resources including:

v IBM technotes

v IBM downloads

v IBM Redbooks™

v IBM DeveloperWorks

v Forums and newsgroups

v Google

Obtaining fixes

A product fix might be available to resolve your problem. You can determine what

fixes are available for your IBM software product by checking the product support

Web site:

1. Go to the IBM Software Support Web site (www.ibm.com/software/support).

2. Under Products A - Z, select your product name. This opens a product-specific

support site.

3. Under Self help, follow the link to Search all Downloads, where you will find

a list of fixes, fix packs, and other service updates for your product. For tips on

refining your search, click Search tips.

4. Click the name of a fix to read the description and optionally download the fix.

To receive weekly e-mail notifications about fixes and other news about IBM

products, follow these steps:

1. From the support page for any IBM product, click My support in the

upper-right corner of the page.

2. If you have already registered, skip to the next step. If you have not registered,

click register in the upper-right corner of the support page to establish your

user ID and password.

3. Sign in to My support.

4. On the My support page, click Edit profiles in the left navigation pane, and

scroll to Select Mail Preferences. Select a product family and check the

appropriate boxes for the type of information you want.

5. Click Submit.

6. For e-mail notification for other products, repeat Steps 4 and 5.

For more information about types of fixes, see the Software Support Handbook

(techsupport.services.ibm.com/guides/handbook.html).

Updating support information

Information centers typically include one or more support information plug-ins.

These plug-ins add IBM technotes and other support documents to the information

center. The following steps describe how to update your support information

plug-ins:

1. Go to the IBM Software Support Web site (www.ibm.com/software/support).

2. Under Products A - Z, select your product name. This opens a product-specific

support site.

x IBM Tivoli License Manager: Data Dictionary

http://www.ibm.com/software/support

http://techsupport.services.ibm.com/guides/handbook.html

http://www.ibm.com/software/support

3. Under Search support for this product, type the keyword phrase:

com.ibm.support. Click the Download check box, and click Submit.

4. Check the search results for updates to support information plug-ins. All

support information plug-ins follow the naming convention,

″com.ibm.support.product.doc.″ If an update is available, select it from the list

and view the download instructions.

5. Save the attached zip file to a temporary location on your hard drive.

6. Unzip the downloaded file, making sure that you retain the subfolders.

7. From the location where you unzipped the file, copy the support information

plug-in folder to your Eclipse plug-ins folder. For example, if your IBM

software product is installed at c:\IBM\WebSphere\, copy the updated plug-in

folder (com.ibm.support.product.doc) to c:\IBM\WebSphere\eclipse\plugins.

8. To see the updated support information, start the information center (or shut it

down and restart it), and expand the Support information node in the

navigation tree.

Conventions used in this book

This book uses several conventions for special terms and actions, and operating

system-dependent paths.

Typeface conventions

This book uses the following typeface conventions:

Bold

v Lowercase commands and mixed case commands that are

otherwise difficult to distinguish from surrounding text

v Interface controls (check boxes, push buttons, radio buttons, spin

buttons, fields, folders, icons, list boxes, items inside list boxes,

multicolumn lists, containers, menu choices, menu names, tabs,

property sheets), labels (such as Tip:, and Operating system

considerations:)

v Column headings in a table

v Keywords and parameters in text

Italic

v Citations (titles of books, diskettes, and CDs)

v Words defined in text

v Emphasis of words (words as words)

v New terms in text

v Variables and values you must provide

Monospace

v Examples and code examples

v File names, programming keywords, and other elements that are

difficult to distinguish from surrounding text

v Message text and prompts addressed to the user

v Text that the user must type

v Values for arguments or command options

<text> Indicates a variable in a path name. For example, in the path

About this book xi

<INSTALL_DIR>\admin\conf, INSTALL_DIR depends on the location

where you have installed a Tivoli License Manager component,

while \admin\conf is constant.

Operating system-dependent notation

This book uses the Windows convention for environment variables and directory

notation.

When using the UNIX, Linux™, and OS/400® command line you should do the

following:

Environment variables

First verify the correct value for the UNIX, Linux, or OS/400 variable

name, as many variables in different platforms that perform the same task

have different names (for example, %TEMP% in Windows is equivalent to

$tmp in UNIX and Linux). Then replace %Windows_variable% with

$UNIX_variable

File and directory paths

Replace each backslash ( \ ) with a forward slash ( / ).

Note: If you are using the bash shell on a Windows system, you can use the UNIX

conventions.

xii IBM Tivoli License Manager: Data Dictionary

Chapter 1. Overview

This data dictionary describes the tables and application views that make up the

data model for the administration server database for Tivoli License Manager.

Note: Tivoli License Manager also has a runtime server database. However, the

runtime server database contains only working data and is thus not

documented here.

This documentation of the database is provided to enable you to extract data to

create reports that are not available within the product, or for any other use

outside the database.

Attention: Do not directly modify any of the data in these tables. Data can be

modified only by using the supplied Web GUI or the product tools (such as the

catalog manager and the data import commands).

The administration server database is called TLMA, and is the repository for all

information about each organization’s license data, such as license pools, runtime

servers, divisions, application users, and nodes. It also contains information about

applications that can be monitored, monitored product use, and installation.

Database table names

The evolution of Tivoli License Manager has led to the changing of some of the

terminology used in the product:

v If you are a user of earlier versions of the product you will have noted that the

major administrative grouping within the product used to be called customer,

whereas it is now called organization.

v Tivoli License Manager now monitors the use of software products, which in

some prior versions were termed components.

This change of terminology is both appropriate and necessary for both new and

prior users, so that the terms being used better reflect the current usage of Tivoli

License Manager.

The new terminology has been applied throughout all aspects of the user interface.

However, it should be noted that the original terms retain their place in the

internally-used database table names. Thus, the table that contains details of

organizations is still called CUSTOMER, and the table that contains details of

products is still called COMPONENT, even though the interfaces that allow data in

these tables to be updated refer to organization and product, respectively. Only

those users who need to extract data for their own purposes from the tables of

Tivoli License Manager, and thus need to understand the tables and their structure,

need to remember the previous terminology.

© Copyright IBM Corp. 2002, 2004 1

Key to using the tables

The key to reading the tables is as follows:

1. Columns of type VARCHAR_UTF and CHAR_UTF allow for the data entry to

be in UTF code (for double-byte languages). In DB2 this is achieved internally

by tripling the size of the column. For example, if a column allows up to 20

characters to be stored, it is shown as type VARCHAR_UTF, with a size of 20

although the space taken by the column in the database is 60 characters.

2. The definition of the LAST_MODIFIED column that appears in many tables is

as follows:

LAST_MODIFIED is a TIMESTAMP used to prevent errors in data

transactions. The database updates the LAST_MODIFIED field each time the

data is changed. The default is the current timestamp.

Using the tables

2 IBM Tivoli License Manager: Data Dictionary

Chapter 2. Tables in the administration server database

This chapter contains details of the permanent tables in the administration server

database. They are listed in alphabetic order.

The tables are divided into two schemas, ADM and SWCAT. However, aliases have

been provided for the SWCAT tables so that all of the tables can be referred to as if

they belonged to the ADM schema. Thus, to identify any field you use the syntax

ADM.<tableName>.<rowName>, for example,

ADM.ADMIN_CUST_REL.ADMINISTRATOR_ID.

In addition to the tables reported here, the administration server also creates some

temporary work tables for use by its various services. These tables are not

documented here.

The following sections group the tables according to their principal functionality:

Administrators

“ADMINISTRATOR” on page 10 Stores details of administrators.

“ADMIN_CUST_REL” on page 9 Maps the ADMINISTRATOR table to the CUSTOMER table

(many-to-many). It provides a list of the organizations to which each

administrator has access.

“PROFILE” on page 56 Defines administrator profiles.

“PROFILE_ACTION” on page 57 Defines actions not allowed for administrator profiles.

Topology

“CUSTOMER” on page 25 Stores information about each organization.

“COUNTRY” on page 23 Stores country information.

“DIVISION” on page 26 Stores details of the divisions that represent the organization’s primary

structural level. Also contains inventory-scan scheduling information for

all agents belonging to the division.

“DIVISION_H” on page 27 The history of the DIVISION table.

“SERVER” on page 58 Stores information about the Tivoli License Manager runtime servers.

“SERVER_H” on page 59 The history of the SERVER table. An entry is made or updated when a

server is added, changed, or removed.

“NODE” on page 44 Stores details of systems on which agents are installed.

“NODE_H” on page 45 The history of the NODE table.

“AGENT” on page 11 Stores details of installed Tivoli License Manager agents.

“AGENT_EVENT” on page 12 Stores details of events at agents.

“AGENT_H” on page 13 The history of the AGENT table.

“AGENT_SYNC_CUST” on page 16 Stores details by organization of the synchronization ratio at the date of

each aggregation.

“AGENT_SYNC_DIV” on page 17 Stores details by division of the synchronization ratio at the date of each

aggregation.


“ENDUSER” on page 28 Stores details of users of the applications that are monitored by Tivoli

License Manager.

Optional fields

“OPT_FIELD” on page 47 Stores the values of optional fields. Each line contains the value for one

optional field for one line in one table (the OPT_FIELD_DEF table

identifies the name of the optional field and the table it belongs to).

“OPT_FIELD_DEF” on page 48 Defines optional fields. Each line defines one optional field for one table.

The table contents are loaded when Tivoli License Manager is installed.

“CUST_OPT_FIELD” on page 24 Maps the CUSTOMER table to the OPT_FIELD_DEF table

(many-to-many). It provides the list of available custom fields for each

organization.

Catalog

“VENDOR” on page 72 Stores information about the software vendors.

“COMPONENT” on page 20 Stores details of software products.

“COMP_HIER” on page 18 Maps the relationships between products, versions and releases (a product

can contain many versions, each of which can contain many releases).

“COMP_MOD_REL” on page 19 Maps components to modules (many-to-many).

“MODULE” on page 43 Stores information about modules used by agents to detect running

applications. Currently only executable files are used. A module must be

linked to a component through the COMP_MOD_REL table.

“UNKNOWN” on page 61 Stores details of executable files that are installed on nodes running the

Tivoli License Manager agent, but which have not yet been associated

with a software component.

Licensing

“LICENSE” on page 39 Stores information about licenses.

“LICENSE_H” on page 42 A history of the LICENSE table.

“PLICENSE” on page 51 Stores details of procured software licenses.

“PLICENSE_H” on page 54 The history of the PLICENSE table.

“CONTRACT” on page 21 Stores details of contracts.

“ENTITLEMENT” on page 29 Defines the rules for the use of product licenses for which an organization

has set up an entitlement.

“LICENSE_DISTRIBUTION” on page 41 Stores details of licenses distributed to runtime servers.

“LIC_TARGET_REL” on page 36 Maps license distributions to an organization, or to one or more targets

(divisions, nodes, or agents).

“LIC_TARGET_HREL” on page 35 The history of the LIC_TARGET_REL table.

“LIC_USER_REL” on page 38 Maps the relationships between licenses and end-users (many-to-many).

“LIC_USER_HREL” on page 37 The history of the LIC_USER_REL table.

“PLIC_COMP_REL” on page 50 Maps the relationships between procured licenses and products (many to

many).

“PLIC_COMP_HREL” on page 49 The history of the PLIC_COMP_REL table.


Inventory

“AGENT_INV” on page 14 Stores a historical software inventory of each agent. This table stores

information about which products are installed on the system where the

agent runs, and when that information was collected and updated.

“AGENT_INV_LIC” on page 15 Stores a historical license inventory of each agent. This table stores

information about which product licenses are in use on the system where

the agent runs, and when that information was collected and updated.

“INV_H_LIC” on page 31 Stores inventory scan data aggregated by license.

“INV_H_LIC_COMP” on page 32 Stores inventory scan data aggregated by license and product

(component).

“INV_H_PLIC” on page 33 Stores inventory scan data aggregated by procured license.

“INV_H_PLIC_COMP” on page 34 Stores inventory scan data aggregated by procured license and product

(component).

“INV_H_COMP” on page 30 Stores inventory scan data aggregated by product (component).

Software use

“USAGE_LIC” on page 71 Stores license use information.

“USAGE_H_LIC” on page 66 Stores aggregated license use information by license.

“USAGE_H_LIC_COMP” on page 67 Stores aggregated license use information by license and product

(component).

“USAGE_COMP” on page 62 Stores product use information by product (component).

“USAGE_H_COMP” on page 64 Stores aggregated license use information by product (component).

“USAGE_H_DIV” on page 65 Stores aggregated license use information by division.

“USAGE_H_PLIC” on page 69 Stores aggregated license use information by procured license.

“USAGE_H_PLIC_COMP” on page 70 Stores aggregated license use information by procured license and product

(component).

“USAGE_H_OOCOD” on page 68 Stores license use data related to applications running on nodes that

support IBM capacity-based pricing.

“USAGE_COMP_USER” on page 63 Maps software use sessions to users.

Control

“SERVICE” on page 60 Provides a history of the service requests made.

“CONTROL” on page 22 Stores configuration information in key–value format for each schema.

Present on both schemas.

“OID” on page 46 Stores the most recent (highest) system-generated number for various

tables throughout a schema. Present on both schemas.

Chapter 2. Tables in the administration server database 5

Table Relationship Diagrams

This section contains the relationship diagrams for the principal tables in the

database. Each diagram lists the fields in the table, indicating which of them are

index fields. Arrows show the relationships between tables. Tables are grouped

according to their general use, but many tables are used in more than one use

grouping.


VE

ND

OR

PK

IDU

1N

AM

E

LAS

T_M

OD

IFIE

D

CO

MP

ON

EN

T

PK

IDU

1N

AM

E

U1

VE

RS

ION

TR

EE

_LE

VE

LU

1O

S_N

AM

E

LEV

EL_

IS_I

BM

DE

SC

RIP

TIO

NF

K1,

I1V

EN

DO

R_I

D

FK

2C

OM

PO

NE

NT

_ID

EX

T_I

D

LAS

T_M

OD

IFIE

D

CO

MP

_MO

D_R

EL

PK

,FK

1C

OM

PO

NE

NT

_ID

PK

,FK

2M

OD

ULE

_ID

LAS

T_M

OD

IFIE

D

MO

DU

LE

PK

IDU

1N

AM

E

U1

SIZ

E_

U1

OS

_NA

ME

U1

VA

LUE

TY

PE

SC

OP

E

EN

AB

LED

SW

AR

E_D

ES

C

SW

AR

E_V

ER

SLA

ST

_MO

DIF

IED

LIC

EN

SE

PK

ID

U1

RE

F_C

OD

EQ

UA

NT

ITY

TAR

GE

T_T

YP

EA

LL_T

AR

GE

TS

ALL

_US

ER

SF

K1

P_L

ICE

NS

E_I

D

U2

EX

T_I

DF

K2,

U2,

U1

CU

STO

ME

R_I

D

LAS

T_M

OD

IFIE

D

LIC

_TA

RG

ET

_RE

L

PK

,FK

1LI

CE

NS

E_I

DP

KTA

RG

ET

_ID

LAS

T_M

OD

IFIE

D

NO

DE

PK

IDI1

TAG

PLA

TF

OR

MI2

NA

ME

HA

SH

CA

PAC

ITY

OO

CO

D

LOC

ATIO

ND

ES

CR

IPT

ION

PLU

GIN

_TIM

EU

1E

XT

_ID

FK

1,U

1C

US

TOM

ER

_ID

LAS

T_M

OD

IFIE

D

DIV

ISIO

N

PK

,FK

2ID

U1

NA

ME

INV

_STA

RT

_DAT

EIN

V_R

ATE

_TY

PE

INV

_RAT

E_V

ALU

E

DE

SC

RIP

TIO

NS

EC

UR

ITY

_LE

VE

L

U2

EX

T_I

DF

K1,

U2,

U1

CU

STO

ME

R_I

D

LAS

T_M

OD

IFIE

D

AG

EN

T

PK

ID HO

ST

NA

ME

IP_A

DD

RE

SS

VE

RS

ION

OS

_NA

ME

OS

_VE

RS

ION

ME

MO

RY

DIS

KS

STO

RA

GE

PR

OC

SE

SS

OR

SLP

AR

_NA

ME

LPA

R_C

APA

CIT

Y

PO

OL_

NA

ME

PO

OL_

CA

PAC

ITY

SE

CU

RIT

Y_L

EV

EL

PLU

GIN

_TIM

E

LAS

T_S

YN

C_T

IME

SC

AN

_TIM

E

AC

TIV

EF

K4

SE

RV

ER

_ID

FK

3,I2

NO

DE

_ID

FK

2,I1

DIV

ISIO

N_I

D

FK

1C

US

TOM

ER

_ID

LAS

T_M

OD

IFIE

D

EN

DU

SE

R

PK

ID

U1

LOG

ON

_NA

ME

FIR

ST

_NA

ME

MID

DLE

_NA

ME

LAS

T_N

AM

E

EM

PLO

YE

E_N

OE

MA

IL_A

DD

RE

SS

LOC

ATIO

N

PH

ON

EFA

X

U2

EX

T_I

DF

K1,

U2,

U1

CU

STO

ME

R_I

D

LAS

T_M

OD

IFIE

D

PL

ICE

NS

E

PK

IDU

1R

EF

_CO

DE

TR

EE

_LE

VE

L

SO

FT

WA

RE

_NA

ME

OW

NE

R

LIC

EN

SE

_TY

PE

QU

AN

TIT

Y

CA

PAC

ITY

_TY

PE

PU

RC

HA

SE

_TY

PE

CO

ST

CO

ST

_CU

RR

DE

LIV

ER

Y_D

ATE

STA

RT

_DAT

E

EX

PIR

ATIO

N_D

ATE

CO

NT

RA

CT

_RE

FO

RD

ER

_RE

F

LIC

EN

SE

_KE

YT

C

NO

TE

SH

AR

D_S

TOP

MU

LTI_

INS

TAN

CE

TH

RE

SH

OLD

VE

RIF

IED

U2

EX

T_I

D

FK

1,U

1,U

2C

US

TOM

ER

_ID

MO

DIF

IED

_BY

LAS

T_M

OD

IFIE

D

CU

STO

ME

R

PK

ID

U1

NA

ME

AC

CO

UN

T_I

D

CO

UN

TR

Y_C

OD

E

DE

SC

RIP

TIO

NC

HE

CK

_PE

RIO

D

RE

QU

ES

T_S

CO

PE

SE

CU

RIT

Y_L

EV

EL

LAS

T_M

OD

IFIE

D

AD

MIN

IST

RA

TOR

PK

ID

U1

LOG

ON

_NA

ME

FIR

ST

_NA

ME

MID

DLE

_NA

ME

LAS

T_N

AM

EPA

SS

WO

RD

EM

AIL

_AD

DR

ES

SE

VE

NT

_NO

TIF

ICAT

ION

PH

ON

EFA

X

U2

EX

T_I

DLA

ST

_MO

DIF

IED

PR

OF

ILE

PK

ID NA

ME

U1

DE

SC

RIP

TIO

N

PR

OF

ILE

_AC

TIO

N

PK

,FK

1P

RO

FIL

E_I

D

PK

AC

TIO

N_K

EY

AC

TIO

N_V

ALU

E

SE

RV

ER

PK

IDU

1N

AM

E

U2

AD

DR

ES

SPA

SS

WO

RD

VE

RS

ION

PO

RT

_NU

MB

ER

SS

L_P

OR

T_N

UM

BE

R

SS

L_E

NA

BLE

DF

OR

CE

_SE

RV

ICE

DO

WN

LOA

D_P

ER

IOD

UP

LOA

D_P

ER

IOD

UP

DAT

E_P

ER

IOD

WA

RN

ING

_TIM

ELO

CAT

ION

OU

TAG

E_S

TAT

US

FK

2B

AC

KU

P_S

ER

VE

R_I

DF

K1,

U2,

U1

CU

STO

ME

R_I

D

LAS

T_M

OD

IFIE

D

OP

T_F

IEL

D

PK

,FK

1O

PT

_FIE

LD_I

DP

KTA

BLE

_RE

CO

RD

_ID

VA

LUE

OP

T_F

IEL

D_D

EF

PK

ID

U1

TAB

LE_N

AM

EU

1N

AM

E

TY

PE

CU

ST

_OP

T_F

IEL

D

PK

,FK

2O

PT

_FIE

LD_I

DP

K,F

K1

CU

STO

ME

R_I

D

CO

NT

RA

CT

PK

ID

U1

CO

NT

RA

CT

_NU

MT

YP

E

STA

TU

S

SU

PP

LY_V

EN

DO

RP

UR

CH

AS

E_V

EN

DO

R

OW

NE

RS

TAR

T_D

ATE

EN

D_D

ATE

CO

ST

CO

ST

_CU

RR

TE

RM

S

NO

TE

SM

OD

IFIE

D_B

Y

U2

EX

T_I

D

FK

1,U

1,U

2C

US

TOM

ER

_ID

LAS

T_M

OD

IFIE

D

AD

MIN

_CU

ST

_RE

L

PK

,FK

1A

DM

INIS

TR

ATO

R_I

DP

K,F

K2

CU

STO

ME

R_I

D

FK

3P

RO

FIL

E_I

D

HID

E_H

OS

T_I

NV

HID

E_H

OS

T

HID

E_U

SE

RH

IDE

_GR

OU

P

LAS

T_M

OD

IFIE

D

LIC

_US

ER

_RE

L

PK

,FK

2LI

CE

NS

E_I

D

PK

,FK

1E

ND

US

ER

_ID

LAS

T_M

OD

IFIE

D

EN

TIT

LE

ME

NT

PK

ID

FK

1,U

1C

OM

PO

NE

NT

_ID

FK

2,U

1C

US

TOM

ER

_ID

AC

TIV

ELI

CE

NS

E_C

ON

TR

OL

NE

ED

_RE

SP

ON

SE

RU

N_O

FF

LIN

ELA

ST

_MO

DIF

IED

Op

tio

nal

Fie

lds

Ad

min

istr

ato

rs

Cat

alo

gL

icen

sin

gTo

po

log

y

Tab

le r

elat

ion

ship

dia

gra

ms:

Ad

min

istr

atio

n, C

atal

og

, Lic

ensi

ng

,To

po

log

y,an

d O

pti

on

al F

ield

s ta

ble

s


AG

EN

T_I

NV

PK

ID

U1

AG

EN

T_I

DF

K1,

I1,U

1C

OM

PO

NE

NT

_ID

U1

STA

RT

_TIM

EE

ND

_TIM

E

AG

EN

T_I

NV

_LIC

PK

,FK

1A

GE

NT

_IN

V_I

D

I1LI

CE

NS

E_I

D

QU

AN

TIT

YP

KS

TAR

T_T

IME

EN

D_T

IME

INV

_H_C

OM

P

ID

PK

CU

STO

ME

R_I

D

PK

CO

MP

ON

EN

T_I

DP

KD

ATE

_US

AG

E

HW

MU

NLI

CE

NS

ED

_HW

M

RIF

_HW

M

INV

_H_L

IC

ID

PK

LIC

EN

SE

_ID

PK

DAT

E_U

SA

GE

HW

M

INV

_H_P

LIC

ID

PK

PLI

CE

NS

E_I

DP

KD

ATE

_US

AG

E

HW

M

INV

_H_L

IC_C

OM

P

IDP

KLI

CE

NS

E_I

D

PK

CO

MP

ON

EN

T_I

DP

KD

ATE

_US

AG

E

HW

M

INV

_H_P

LIC

_CO

MP

IDP

KP

LIC

EN

SE

_ID

PK

CO

MP

ON

EN

T_I

DP

KD

ATE

_US

AG

E

HW

M

US

AG

E_C

OM

P

PK

ID

I1C

OM

PO

NE

NT

_ID

AG

EN

T_I

D

DIV

ISIO

N_I

DC

US

TOM

ER

_ID

STA

RT

_TIM

EE

ND

_TIM

E

US

AG

E_H

_CO

MP

U1

IDP

KC

US

TOM

ER

_ID

PK

CO

MP

ON

EN

T_I

DP

KD

ATE

_US

AG

E

HW

MH

WM

_TIM

E

AW

MU

NLI

CE

NS

ED

_HW

M

RIF

_HW

M

US

AG

E_L

IC

PK

,FK

1U

SA

GE

_CO

MP

_ID

LIC

EN

SE

_ID

CO

MP

ON

EN

T_I

DQ

UA

NT

ITY

PO

OL_

HA

SH

PO

OL_

CA

PAC

ITY

LPA

R_H

AS

HLP

AR

_CA

PAC

ITY

NO

DE

_HA

SH

NO

DE

_CA

PAC

ITY

PK

STA

RT

_TIM

E

EN

D_T

IME

US

AG

E_C

OM

P_U

SE

R

PK

,FK

1U

SA

GE

_CO

MP

_ID

US

ER

GR

OU

P

US

AG

E_H

_DIV

U1

IDP

KD

IVIS

ION

_ID

PK

CO

MP

ON

EN

T_I

DP

KD

ATE

_US

AG

E

HW

MH

WM

_TIM

E

AW

M

US

AG

E_H

_LIC

U1

ID

PK

LIC

EN

SE

_ID

PK

DAT

E_U

SA

GE

HW

MH

WM

_TIM

E

AW

M

US

AG

E_H

_LIC

_CO

MP

IDP

KLI

CE

NS

E_I

D

PK

CO

MP

ON

EN

T_I

DP

KD

ATE

_US

AG

E

HW

MH

WM

_TIM

E

US

AG

E_H

_PL

IC

IDP

KP

LIC

EN

SE

_ID

PK

DAT

E_U

SA

GE

HW

M

HW

M_T

IME

AW

M

US

AG

E_H

_PL

IC_C

OM

P

ID

PK

PLI

CE

NS

E_I

DP

KC

OM

PO

NE

NT

_ID

PK

DAT

E_U

SA

GE

HW

M

HW

M_T

IME

US

AG

E_H

_OO

CO

D

U1

ID

PK

NO

DE

_ID

CA

PAC

ITY

PK

CO

MP

ON

EN

T_I

DP

KP

LIC

EN

SE

_ID

PK

DAT

E_U

SA

GE

Inve

nto

ry

Ag

gre

gat

ed In

ven

tory

So

ftw

are

use

Ag

gre

gat

ed s

oft

war

e u

se

Tab

le r

elat

ion

ship

dia

gra

ms:

Inve

nto

ry, S

oft

war

e u

se a

nd

Ag

gre

gat

ed t

able

s


ADMIN_CUST_REL

Maps the ADMINISTRATOR table to the CUSTOMER table (many-to-many). It provides a list of the

organizations to which each administrator has access.

Columns Description Type Null

ADMINISTRATOR_ID External key to the ADMINISTRATOR table. bigint no

CUSTOMER_ID External key to the CUSTOMER table. bigint no

PROFILE_ID Administrator profile. (Foreign key to the PROFILE

table).

bigint no

HIDE_HOST_INV Enables or disables the visibility of node information,

for privacy reasons, for nodes to which the

Administrator has access, in inventory scan reports.

The permitted values are:

0 Show (default)

1 Hide

smallint no

HIDE_HOST Enables or disables the visibility of node information,

for privacy reasons, for nodes to which the

Administrator has access, in use reports. The

permitted values are:

0 Show (default)

1 Hide

smallint no

HIDE_USER Enables or disables the visibility of user information,

for privacy reasons, for users to which the

Administrator has access. The permitted values are:

0 Show (default)

1 Hide

smallint no

HIDE_GROUP Enables or disables the visibility of user group

information, for privacy reasons, for user groups to

which the Administrator has access. The permitted

values are:

0 Show (default)

1 Hide

smallint no

LAST_MODIFIED See note 2 on page 2. timestamp no

Index Unique Primary key Columns

ADMIN_CUST_PK yes yes ADMINISTRATOR_ID

CUSTOMER_ID

ADMIN_CUST_REL table


ADMINISTRATOR

Stores details of administrators.


ID Unique identifier bigint no

LOGON_NAME User ID for logging on to Tivoli License Manager. varchar_utf(60) no

FIRST_NAME First name of the administrator. varchar_utf(40) no

MIDDLE_NAME Middle name or names of the administrator. varchar_utf(20) yes

LAST_NAME Surname of the administrator. varchar_utf(40) no

PASSWORD Encrypted password of the administrator. varchar(40) yes

EMAIL_ADDRESS E-mail address of the administrator. varchar_utf(80) yes

EVENT_NOTIFICATION E-mail event notification flag. Default = 1. smallint no

PHONE Telephone number of the administrator. varchar(40) yes

FAX Fax number of the administrator. varchar(40) yes

EXT_ID Unique identifier for importing (dataimp command)

or exporting (dataexp command).

varchar(80) yes


Indexes Unique Primary key Columns

ADMINISTRATOR_PK yes yes ID

ADMINISTRATOR_UI1 yes no LOGON_NAME

ADMINISTRATOR_UI2 yes no EXT_ID

ADMINISTRATOR table


AGENT

Stores details of installed Tivoli License Manager agents.


ID Unique identifier. bigint no

HOSTNAME System host name (for example, server.ibm.com). varchar(60) no

IP_ADDRESS Network IP address. varchar(20) yes

VERSION Version of the agent that is installed. varchar(20) no

OS_NAME Operating system name. The permitted values are:

OS/400

Unix (the value for UNIX is stored in the database

as ″Unix″, as written here).

Windows

varchar(10) no

OS_VERSION Operating system version (for example, 2.1, 2000). varchar(60) yes

MEMORY RAM size in megabytes. Default = 0. integer no

DISKS Number of hard disk drives. Default = 0. integer no

STORAGE Internal use. Default = 0. integer no

PROCESSORS Number of processors installed on the computer.

Default = 0.

integer no

LPAR_NAME Logical partition name varchar_utf(32) yes

LPAR_CAPACITY Logical partition processor capacity, expressed in

hundredths; thus a value of 25 means 25 hundredths,

which is 25%. Default = 0.

integer no

POOL_NAME Shared pool name varchar_utf(16) yes

POOL_CAPACITY Shared pool processor capacity, expressed in


which is 25%. Default = 0.

integer no

SECURITY_LEVEL Permitted values:

1 Insecure: HTTP is used for all communications

(default).

4 Secure: HTTPS is used for all communications.

smallint no

PLUGIN_TIME Date and time of last agent plug-in or update. Default

= current timestamp.

timestamp no

LAST_SYNC_TIME Date and time when offline use data was last sent. timestamp yes

SCAN_TIME Date and time of the last available software scan. timestamp yes

ACTIVE If true, the agent is active. An agent is considered

inactive if it has not contacted the runtime server for a

configurable length of time. Default = 1 (true).

smallint no

SERVER_ID External key to the SERVER table. bigint no

NODE_ID External key to the NODE table. bigint no

DIVISION_ID External key to the DIVISION table. bigint no

CUSTOMER_ID External key to the CUSTOMER table. Redundant

(equates to ADM.DIVISION.CUSTOMER_ID).

bigint no



AGENT_PK yes yes ID

AGENT_I1 no no DIVISION_ID

AGENT_I2 no no NODE_ID

AGENT table


AGENT_EVENT

Stores details of events at agents.


AGENT_ID External key to the AGENT table. bigint no

EVENT_ID The ID of the event. The permitted values are:

1 Inventory scan

integer no

TIME Time when the event occurred. timestamp no


AGENT_EVENT_PK yes yes AGENT_ID

TIME

AGENT_EVENT table


AGENT_H

The history of the AGENT table.


ID Unique identifier of the agent. bigint no

VERSION Version of the agent. varchar(20) no

OS_VERSION Operating system version. varchar(60) yes





START_TIME Date and time of the start action. timestamp no

START_ACTION I Insert a record on the deployment of the agent.

U Update the record on the redeployment of the

agent.

char(1) no

END_TIME Date and time of the end action. timestamp no

END_ACTION D Delete the agent.

U Update the record on redeployment of the agent.

char(1) no


AGENT_H_I1 no no ID

AGENT_H_I2 no no DIVISION_ID

AGENT_H table


AGENT_INV

Stores a historical software inventory of each agent. This table stores information about which products are

installed on the system where the agent runs, and when that information was collected and updated.


ID Unique identifier of the inventory record. bigint no

AGENT_ID Unique identifier of the agent. External key to the

AGENT table.

bigint no

COMPONENT_ID Software product ID. External key to the

COMPONENT table.

bigint no

START_TIME Date and time of the scan that detected the software. timestamp no

END_TIME Date and time of the first scan after the software was

uninstalled or upgraded.

timestamp no


AGENT_INV_PK yes yes ID

AGENT_INV_UI yes no AGENT_ID

COMPONENT_ID

START_TIME

AGENT_INV_I1 no no COMPONENT_ID

AGENT_INV table


AGENT_INV_LIC

Stores a historical license inventory of each agent. This table stores information about which product licenses are

in use on the system where the agent runs, and when that information was collected and updated.


AGENT_INV_ID Unique identifier of the agent. External key to the

AGENT_INV table.

bigint no

LICENSE_ID Unique identifier of the license. External key to the

LICENSE table.

bigint no

QUANTITY The license quantity in use at the agent. integer no

START_TIME Date and time that the license was assigned. timestamp no

END_TIME Date and time that the license assignment was

finished.

timestamp no


AGENT_INV_LIC_PK yes yes AGENT_INV_ID

START_TIME

AGENT_INV_LIC_I1 no no LICENSE_ID

AGENT_INV_LIC table


AGENT_SYNC_CUST

Stores details by organization of the synchronization ratio at the date of each aggregation.


CUSTOMER_ID Unique identifier of the organization. External key to

the CUSTOMER table.

bigint no

SYNC_DATE Date of the aggregation. date no

SYNC_RATIO This indicates the proportion of all computers for the

customer in question for which updated data is

available at the date of the aggregation. This is

particularly applicable when the computers being

monitored are mobile (laptops, for example). The

proportion is expressed in thousandths; for example, a

value of 900 indicates that 90% of the computers were

included in the aggregation.

smallint no


AGENT_SYNC_CUST_PK yes yes CUSTOMER_ID

SYNC_DATE

AGENT_SYNC_CUST table


AGENT_SYNC_DIV

Stores details by division of the synchronization ratio at the date of each aggregation.


DIVISION_ID Unique identifier of the division. External key to the

DIVISION table.

bigint no

SYNC_DATE Date of the aggregation. date no

SYNC_RATIO This indicates the proportion of all computers for the

division in question for which updated data is

available at the date of the aggregation. This is

particularly applicable when the computers being

monitored are mobile (laptops, for example). The

proportion is expressed in thousandths; for example, a

value of 900 indicates that 90% of the computers were

included in the aggregation.

smallint no


AGENT_SYNC_DIV_PK yes yes DIVISION_ID

SYNC_DATE

AGENT_SYNC_DIV table


COMP_HIER

Maps the relationships between products, versions and releases (a product can contain many versions, each of

which can contain many releases).


RELEASE_ID External key to COMPONENT table. bigint no

VERSION_ID External key to COMPONENT table. bigint yes

PRODUCT_ID External key to COMPONENT table. bigint yes


COMP_HIER_PK yes yes RELEASE_ID

COMP_HIER_I1 no no VERSION_ID

COMP_HIER_I2 no no PRODUCT_ID

COMP_HIER table


COMP_MOD_REL

Maps components to modules (many-to-many).


COMPONENT_ID External key to the COMPONENT table. bigint no

MODULE_ID External key to the MODULE table. bigint no



COMP_MOD_REL_PK yes yes COMPONENT_ID

MODULE_ID

COMP_MOD_REL table


COMPONENT

Stores details of software products.In early releases of Tivoli License Manager, software products were called components. Although this terminology

was changed everywhere in the product interfaces, the old terminology is used internally within the product

databases.



NAME Software product name. varchar(240) no

VERSION Software product version. varchar(64) no

TREE_LEVEL Hierarchy level:

1 Product

2 Version

3 Release (default)

smallint no

OS_NAME Operating system name. Permitted values are:

JVM

OS/400



Windows

varchar(12) no

LEVEL_ Relevance of the software product:

1 Licensable commercial product

2 Licensable commercial product (not high cost)

(default)

3 Shareware or demo software

4 Freeware

10 Deactivated product

smallint no

IS_IBM Internal use. smallint no

DESCRIPTION Free format text. varchar(300) yes

VENDOR_ID External key to the VENDOR table. Default = 1. bigint no

COMPONENT_ID External key to the COMPONENT table (used to

represent software hierarchies or suites).

bigint yes

EXT_ID External ID used by the catalog manager. varchar(40) no



COMPONENT_PK yes yes ID

COMPONENT_UI1 yes no NAME

VERSION

OS_NAME

COMPONENT_UI2 yes no EXT_ID

COMPONENT_I1 no no VENDOR_ID

COMPONENT table


CONTRACT

Stores details of contracts.



CONTRACT_NUM Contract number. varchar_utf(40) no

TYPE 1 Warranty

2 Service

3 Lease

4 Loan

5 Purchase

6 Maintenance

integer no

STATUS 1 Active (default)

2 Closed

3 Renewed

4 Past due date

5 Pending

integer no

SUPPLY_VENDOR The name of the vendor that supplied the product to

which the contract relates; normally the software

producer.

varchar_utf(40) yes

PURCHASE_VENDOR The name of the vendor from which the software was

purchased; normally the software retailer.

varchar_utf(40) yes

OWNER Owner of the contract. varchar_utf(40) yes

START_DATE Start date of contract. timestamp no

END_DATE End date of contract. Default is

″9999–12–31–00.00.00.0″

timestamp no

COST Contract cost. Default is zero. decimal(14.2) no

COST_CURR ISO currency code of the currency in the COST

column (for example, EUR, USD). There must be a

corresponding entry for this value in

COUNTRY.CURRENCY_CODE.

char(3) yes

TERMS Contract terms; free format text. text(1000) yes

NOTES Contract notes; free format text. text(1000) yes

MODIFIED_BY The logon name of the administrator that performed

the last update.

varchar(60) yes



varchar(80) yes

CUSTOMER_ID External key to CUSTOMER table. bigint no

LAST_MODIFIED See note 2 on page 2 timestamp no


CONTRACT_PK yes yes ID

CONTRACT_UI1 yes no CONTRACT_NUM

CUSTOMER_ID

CONTRACT_UI2 yes no EXT_ID

CUSTOMER_ID

CONTRACT table


CONTROL

Stores configuration information in key–value format for each schema. Present on both schemas.


NAME The name of a parameter. varchar(40) no

VALUE Value of the parameter. varchar(60) no


CONTROL_PK yes yes NAME

CONTROL table


COUNTRY

Stores country information.


NAME Name of the country. varchar(50) no

ISO_CODE2 ISO-2 standard country code. char(2) no

ISO_CODE3 ISO-3 standard country code. char(3) no

ISO_CODE4 ISO-4 standard country code (numeric). char(3) no

CURRENCY_NAME Name of the currency used in the country. varchar(50) yes

CURRENCY_CODE ISO code of the currency. char(3) yes


COUNTRY_PK yes yes ISO_CODE3

COUNTRY_UI1 yes no NAME

COUNTRY table


CUST_OPT_FIELD

Maps the CUSTOMER table to the OPT_FIELD_DEF table (many-to-many). It provides the list of available

custom fields for each organization.


OPT_FIELD_ID External key to the OPT_FIELD_DEF table. bigint no



CUST_OPT_FIELD_PK yes yes OPT_FIELD_ID

CUSTOMER_ID

CUST_OPT_FIELD table


CUSTOMER

Stores information about each organization.In early releases of the product, the organizations for which the product managed licenses were called customers.

Although this terminology was changed in the product interfaces, ″customer″ is used internally within these

database tables.



NAME Organization name. varchar_utf(40) no

ACCOUNT_ID Organization account unique ID. varchar_utf(21) yes

COUNTRY_CODE External key to the COUNTRY table. char(3) yes

DESCRIPTION Free format text. varchar_utf(200) yes

CHECK_PERIOD Not used. Default = 0. bigint no

REQUEST_SCOPE Not used. Default = 0. integer no



(default).


smallint no



CUSTOMER_PK yes yes ID

CUSTOMER_UI1 yes no NAME

CUSTOMER table


DIVISION

Stores details of the divisions that represent the organization’s primary structural level. Also contains

inventory-scan scheduling information for all agents belonging to the division.



NAME Division name. varchar_utf(40) no

INV_START_DATE The start date for the inventory scan schedule. Default

= current timestamp.

timestamp no

INV_RATE_TYPE The frequency type of inventory scans:

0 Once only

1 Daily

2 Weekly

3 Monthly

smallint no

INV_RATE_VALUE The frequency of inventory scans (how many days,

weeks, or months between each scan).

integer no

DESCRIPTION Free format text varchar_utf(200) yes


0 Inherit from organization (default)


(default).


smallint no



varchar(80) yes

CUSTOMER_ID External key to the CUSTOMER table bigint no



DIVISION_PK yes yes ID

DIVISION_UI1 yes no NAME

CUSTOMER_ID

DIVISION_UI2 yes no EXT_ID

CUSTOMER_ID

DIVISION table


DIVISION_H

The history of the DIVISION table.



NAME Division name. varchar_utf(40) no

INV_START_DATE The start date for the inventory scan schedule. timestamp no

INV_RATE_TYPE The frequency type of inventory scans:

0 Once only

1 Daily

2 Weekly

3 Monthly

smallint no

INV_RATE_VALUE The frequency of inventory scans (how many days,

weeks, or months between each scan).

integer no

DESCRIPTION Free format text varchar_utf(200) yes


0 Inherit from organization (default)


(default).


smallint no



START_ACTION I Insert a record on the creation of a division.

U Update the record on a change to the division

details or the inventory schedule.

char(1) no


END_ACTION D Delete division.

U Update the record on a change to the division

details or the inventory schedule.

char(1) no


DIVISION_H_I1 no no ID

DIVISION_H table


ENDUSER

Stores details of users of the applications that are monitored by Tivoli License Manager.



LOGON_NAME User ID. varchar(120) yes

FIRST_NAME First name of the user. varchar_utf(40) no

MIDDLE_NAME Middle name or names of the user. varchar_utf(20) yes

LAST_NAME Surname of the user. varchar_utf(40) no

EMPLOYEE_NO User’s employee number. varchar(20) yes

EMAIL_ADDRESS User’s e-mail address. varchar_utf(80) yes

LOCATION User’s location. varchar_utf(80) yes

PHONE User’s telephone number. varchar(40) yes

FAX User’s fax number. varchar(40) yes



varchar(80) yes




ENDUSER_PK yes yes ID

ENDUSER_UI1 yes no CUSTOMER_ID

LOGON_NAME

ENDUSER_UI2 yes no EXT_ID

CUSTOMER_ID

ENDUSER table


ENTITLEMENT

Defines the rules for the use of product licenses for which an organization has set up an entitlement.



COMPONENT_ID External key to the COMPONENT table (licensed

product).

bigint no


ACTIVE If true, use tracking is enabled for the licensed

product. Default = 1 (true).

smallint no

LICENSE_CONTROL If true, the licensed product uses user-defined licenses.

If not true, the default license settings are used.

Default = 0 (false).

smallint no

NEED_RESPONSE If true, a response from the server is needed to run the

licensed product. Default = 0 (false).

smallint no

RUN_OFFLINE If true, the licensed product can run when the agent is

disconnected from the network. Default = 1 (true).

smallint no



ENTITLEMENT_PK yes yes ID

ENTITLEMENT_UI1 yes no CUSTOMER_ID

COMPONENT_ID

ENTITLEMENT table


INV_H_COMP

Stores inventory scan data aggregated by product (component).





DATE_USAGE Date to which the aggregation refers. date no

HWM Installation quantity at the end of the day. integer no

UNLICENSED_HWM Unlicensed installation quantity at the end of the day. integer no

RIF_HWM Installation quantity to be used for unlicensed ratio. integer no


INV_H_COMP_PK yes yes CUSTOMER_ID

COMPONENT_ID

DATE_USAGE

INV_H_COMP table


INV_H_LIC

Stores inventory scan data aggregated by license.



LICENSE_ID External key to the LICENSE table. bigint no




INV_H_LIC_PK yes yes LICENSE_ID

DATE_USAGE

INV_H_LIC table


INV_H_LIC_COMP

Stores inventory scan data aggregated by license and product (component).








INV_H_L_CMP_PK yes yes LICENSE_ID

COMPONENT_ID

DATE_USAGE

INV_H_LIC_COMP table


INV_H_PLIC

Stores inventory scan data aggregated by procured license.



PLICENSE_ID External key to the PLICENSE table. bigint no




INV_H_PLIC_PK yes yes PLICENSE_ID

DATE_USAGE

INV_H_PLIC table


INV_H_PLIC_COMP

Stores inventory scan data aggregated by procured license and product (component).








INV_H_PL_CMP_PK yes yes PLICENSE_ID

COMPONENT_ID

DATE_USAGE

INV_H_PLIC_COMP table


LIC_TARGET_HREL

The history of the LIC_TARGET_REL table.



TARGET_ID External key to the NODE, AGENT, DIVISION, or

CUSTOMER table.

bigint no

START_TIME Date and time when the license became available to

the identified target.

timestamp no

END_TIME Date and time when the license stopped being

available to the identified target.

timestamp no

LIC_TARGET_HREL table


LIC_TARGET_REL

Maps license distributions to an organization, or to one or more targets (divisions, nodes, or agents).


LICENSE_ID External key to the LICENSE table bigint no

TARGET_ID External key to the NODE, AGENT, DIVISION, or

CUSTOMER table.

bigint no



LIC_TARGET_PK yes yes LICENSE_ID

TARGET_ID

LIC_TARGET_REL table


LIC_USER_HREL

The history of the LIC_USER_REL table.



ENDUSER_ID External key to the ENDUSER table. bigint no

START_TIME Date and time when the license became available to

the identified user.

timestamp no

END_TIME Date and time when the license stopped being

available to the identified user.

timestamp no

LIC_USER_HREL table


LIC_USER_REL

Maps the relationships between licenses and end-users (many-to-many).



ENDUSER_ID External key to the ENDUSER table. bigint no



LIC_USER_PK yes yes LICENSE_ID

ENDUSER_ID

LIC_USER_REL table


LICENSE

Stores information about licenses.



REF_CODE License reference code (unique). This is automatically

generated when the license is created. It has the

following format:

<yymmdd_licenseType_capacityType_id.id>, where:

yymmdd License creation date

licenseType PLICENSE.LICENSE_TYPE in the

form of an acronym, generated as

follows:

SNHW Simple nodelock; hardware

SNOS Simple nodelock; operating

system

CNHW Concurrent nodelock;

hardware

CNOS Concurrent nodelock;

operating system

CUHW Concurrent users nodelock;

hardware

CUOS Concurrent users nodelock;

operating system

N Concurrent network

UN Users network

UR User reserved

SC IBM subcapacity

FC IBM full capacity

I Installs

capacityType PLICENSE.CAPACITY_TYPE in the

form of a single alpha character,

generated as follows:

U Users

M Memory

P Processors

D Disks

id ID

char(25) no

QUANTITY License quantity; refers to CAPACITY_TYPE of license. integer no

TARGET_TYPE The type of distribution:

1 Organization (default)

2 Divisions

3 Nodes

4 Agents

integer no

ALL_TARGETS Indicates whether the distribution is to be made to all

targets:

0 Distribute to specified targets.

1 Distribute to all targets (default).

smallint no

ALL_USERS Indicates whether the distribution is to be made to all

users:

0 Distribute to specified users.

1 Distribute to all users (default).

smallint no

PLICENSE_ID External key to PLICENSE table. bigint no



varchar(80) yes

LICENSE table



CUSTOMER_ID External key to the CUSTOMER table (redundant) bigint no



LICENSE_PK yes yes ID

LICENSE_UI1 yes no REF_CODE

CUSTOMER_ID

LICENSE_UI2 yes no EXT_ID

CUSTOMER_ID

LICENSE table


LICENSE_DISTRIBUTION

Stores details of licenses distributed to runtime servers.



LICENSE_ID External key to the LICENSE table bigint no

QUANTITY License quantity distributed. integer no



LIC_DISTR_PK yes yes SERVER_ID

LICENSE_ID

LICENSE_DISTRIBUTION table


LICENSE_H

A history of the LICENSE table.



REF_CODE License reference code (unique). char(25) no

QUANTITY Quantity of licenses integer no

TARGET_TYPE The type of distribution:

1 Organization

2 Divisions

3 Nodes

4 Agents

integer no

ALL_TARGETS Indicates whether the distribution is to be made to all

targets:

0 Distribute to specified targets.

1 Distribute to all targets.

smallint no

ALL_USERS Indicates whether the distribution is to be made to all

users:

0 Distribute to specified users.

1 Distribute to all users.

smallint no


CUSTOMER_ID External key to the CUSTOMER table (redundant) bigint no


START_ACTION I Insert a record on license creation.

U Update the license details.

char(1) no


END_ACTION D Delete license.


char(1) no


LICENSE_H_I1 no no ID

LICENSE_H table


MODULE

Stores information about modules used by agents to detect running applications. Currently only executable files

are used. A module must be linked to a component through the COMP_MOD_REL table.



NAME The content depends on the value of TYPE. For

example, if TYPE = 0 (File), NAME is the file name.

varchar(254) no

SIZE_ The content depends on the value of TYPE. For

example, if TYPE = 0 (File), SIZE_ is the file size.

bigint no


JVM

OS/400



Windows

varchar(12) no

VALUE The content depends on the value of TYPE. For

example. if TYPE = 100 (WinString), VALUE contains

the value of the string.

varchar(254) yes

TYPE Module type:

0 File

10 XSLM Id

100 WinString

101 WinMultiString

102 WinExpandString

103 WinDword

104 WinBinary

150 InstANYRegistry

151 InstISMPRegistry

152 InstOSRegistry

200 Application server

300 J2EE application

integer no

SCOPE Indicates how the agent will use the module:

0 Recognition and monitoring

1 For recognition

2 For monitoring

smallint no

ENABLED If true, the entry in the table is reported by the catalog

manager: Default = 1 (true).

smallint no

SWARE_DESC Description of the software. varchar(240) yes

SWARE_VERS Software version. varchar(64) yes



MODULE_PK yes yes ID

MODULE_UI1 yes no NAME

SIZE_

OS_NAME

VALUE

MODULE table


NODE

Stores details of systems on which agents are installed.



TAG Computer label; input or generated at agent

deployment.

varchar_utf(40) no

PLATFORM Hardware platform, for example Intel™, Alpha. varchar(20) yes

NAME Unique node name. varchar_utf(64) yes

HASH Hash of the node name. bigint yes

CAPACITY Node capacity, expressed in hundredths; thus a value

of 25 means 25 hundredths, which is 25%.

integer no

OOCOD On/off capacity on demand flag. The permitted values

are as follows:

0 The ″On/off capacity on demand″ feature cannot

be enabled (default).

1 The ″On/off capacity on demand″ feature can be

enabled.

smallint no

LOCATION Free format text. varchar_utf(80) yes

DESCRIPTION Free format text. varchar_utf(80) yes

PLUGIN_TIME Date and time of the last node plug-in or update. timestamp no



varchar(80) yes




NODE_PK yes yes ID

NODE_UI1 yes no EXT_ID

CUSTOMER_ID

NODE_I1 no no TAG

NODE_I2 no no NAME

NODE table


NODE_H

The history of the NODE table.



TAG System tag. This is used in agent deployment. varchar_utf(40) no

PLATFORM Hardware platform, for example Intel, Alpha. varchar(20) yes

NAME Unique node name. varchar_utf(64) yes

HASH Hash of the node name. bigint yes

CAPACITY Capacity of the processors at the node, expressed in


which is 25%.

integer no

PLUGIN_TIME Date and time of the last node plug-in or update. timestamp no

OOCOD On/off capacity on demand flag. The permitted values

are as follows:

0 The ″On/off capacity on demand″ feature cannot

be enabled.

1 The ″On/off capacity on demand″ feature can be

enabled.

smallint no



START_ACTION I Insert a record on node registration.

U Update the node details.

char(1) no


END_ACTION D Delete node.

U Update the node details.

char(1) no


NODE_H_I1 no no ID

NODE_H_I2 no no OOCOD

ID

PLUGIN_TIME

NODE_H table


OID

Stores the most recent (highest) system-generated number for various tables throughout a schema. Present on both

schemas.


LAST_ID Last assigned ID. bigint no

TABLE_NAME The name of the table to which this ID was assigned. varchar(40) no

BLOCK_SIZE Internal use. integer no


OID_PK yes yes TABLE_NAME

OID table


OPT_FIELD

Stores the values of optional fields. Each line contains the value for one optional field for one line in one table

(the OPT_FIELD_DEF table identifies the name of the optional field and the table it belongs to).


OPT_FIELD_ID External key to OPT_FIELD_DEF table. bigint no

TABLE_RECORD_ID Record ID of the target table. bigint no

VALUE Value of the optional field. varchar(600) no


OPT_FIELD_PK yes yes OPT_FIELD_ID

TABLE_RECORD_ID

OPT_FIELD table


OPT_FIELD_DEF

Defines optional fields. Each line defines one optional field for one table. The table contents are loaded when

Tivoli License Manager is installed.



TABLE_NAME Name of the table. varchar(20) no

NAME Name of the optional field. varchar(20) no

TYPE Type of field:

D Date

I Integer

N Number

S String

char(1) no


OPT_FIELD_PK yes yes ID

OFT_FIELD_DEF_UI1 yes no TABLE_NAME

NAME

OPT_FIELD_DEF table


PLIC_COMP_HREL

The history of the PLIC_COMP_REL table.



COMPONENT_ID External key to COMPONENT table. bigint no



PLIC_COMP_HREL table


PLIC_COMP_REL

Maps the relationships between procured licenses and products (many to many).



COMPONENT_ID External key to COMPONENT table. bigint no


PLIC_COMP_REL_PK yes yes PLICENSE_ID

COMPONENT_ID

PLIC_COMP_REL table


PLICENSE

Stores details of procured software licenses.





following format:



licenseType LICENSE_TYPE in the form of an

acronym, generated as follows:



system


hardware


operating system


hardware


operating system


UN Users network

UR User reserved

SC IBM subcapacity


I Installs

capacityType CAPACITY_TYPE in the form of a

single alpha character, generated as

follows:

U Users

M Memory

P Processors

D Disks

id ID

char(22) no

TREE_LEVEL Hierarchy level of the linked products:

1 Product

2 Version

3 Release

smallint no

SOFTWARE_NAME Software product name. varchar_utf(80) no

OWNER Owner of the license. varchar_utf(80) yes

PLICENSE table



LICENSE_TYPE Type of agreement:

1 Simple nodelock; hardware (default)

2 Simple nodelock; operating system

3 Concurrent nodelock; hardware

4 Concurrent nodelock; operating system

5 Concurrent users nodelock; hardware

6 Concurrent users nodelock; operating system

7 Concurrent Network

8 Users network

9 User reserved

10 IBM subcapacity

11 IBM full capacity

101 Installs

integer no

QUANTITY The quantity procured (in terms of CAPACITY_TYPE) integer no

CAPACITY_TYPE 0 Users

1 Memory

2 Processors

4 Disks

integer no

PURCHASE_TYPE 0 Unknown (default)

1 Retail

2 Volume

3 Upgrade

4 OEM

integer no

COST Cost of the license. Default = 0. decimal(14.2) no

COST_CURR ISO currency code of the currency in the COST

column (for example, EUR, USD). There must be a

corresponding entry for this value in

COUNTRY.CURRENCY_CODE.

char(3) yes

DELIVERY_DATE Procured license delivery date. Default = current

timestamp.

timestamp no

START_DATE Start validity date for the procured license. timestamp no

EXPIRATION_DATE Maximum validity date for the procured license.

Default = ″9999–12–31–00.00.00.0″

timestamp no

CONTRACT_REF Contract reference: points to

CONTRACT.CONTRACT_NUM.

varchar_utf(40) yes

ORDER_REF Order reference. varchar_utf(40) yes

LICENSE_KEY License key (if appropriate). varchar_utf(20) yes

TC Complete text of the license agreement, text yes

NOTES License restrictions and additional comments. text yes

HARD_STOP If true, QUANTITY is an absolute maximum that

cannot be exceeded. Default = 0 (false).

smallint no

MULTI_INSTANCE Indicates how multiple instances of the same product

should be treated:

0 Disabled (default)

1 Same user

2 Same group

3 Same node

smallint no

THRESHOLD Usage threshold for warnings; relates to

CAPACITY_TYPE. Default = 80.

integer no

VERIFIED If false, the distribution of the license must be verified.

Default = 0 (false).

smallint no



varchar(80) yes


MODIFIED_BY The logon name of the administrator that performed

the last update.

varchar(60) yes


PLICENSE table



PLICENSE_PK yes yes ID

PLICENSE_UI1 yes no REF_CODE

CUSTOMER_ID

PLICENSE_UI2 yes no EXT_ID

CUSTOMER_ID

PLICENSE table


PLICENSE_H

The history of the PLICENSE table.





following format:



licenseType PLICENSE.LICENSE_TYPE in the

form of an acronym, generated as

follows:



system


hardware


operating system


hardware


operating system


UN Users network

UR User reserved

SC IBM subcapacity


I Installs

capacityType PLICENSE.CAPACITY_TYPE in the

form of a single alpha character,

generated as follows:

U Users

M Memory

P Processors

D Disks

id ID

char(22) no

TREE_LEVEL Hierarchy level of the linked products:

1 Product

2 Version

3 Release

smallint no

SOFTWARE_NAME Software product name. varchar_utf(80) no

PLICENSE_H table



LICENSE_TYPE Type of agreement:

1 Simple nodelock; hardware

2 Simple nodelock; operating system

3 Concurrent nodelock; hardware

4 Concurrent nodelock; operating system

5 Concurrent users nodelock; hardware

6 Concurrent users nodelock; operating system

7 Network

8 Users network

9 User reserved

10 IBM subcapacity

11 IBM full capacity

101 Installs

integer no

QUANTITY The quantity procured (in terms of CAPACITY_TYPE) integer no

CAPACITY_TYPE 0 Users

1 Memory

2 Processors

4 Disks

integer no

DELIVERY_DATE Procured license delivery date. timestamp no

START_DATE Start validity date for the procured license. timestamp no

EXPIRATION_DATE Maximum validity date for the procured license. timestamp no

HARD_STOP If true, QUANTITY is an absolute maximum that

cannot be exceeded.

smallint no

MULTI_INSTANCE Indicates how multiple instances of the same product

should be treated:

0 Disabled

1 Same user

2 Same group

3 Same node

smallint no

THRESHOLD Usage threshold for warnings; relates to

CAPACITY_TYPE.

integer no



START_ACTION I Insert a record on license creation.


char(1) no


END_ACTION D Delete license.


char(1) no


PLICENSE_H_I1 no no ID

PLICENSE_H table


PROFILE

Defines administrator profiles.



NAME Profile name. varchar(20) no

DESCRIPTION Free format text. varchar(200) no


PROFILE_PK yes yes ID

PROFILE_UI1 yes no DESCRIPTION

PROFILE table


PROFILE_ACTION

Defines actions not allowed for administrator profiles.


PROFILE_ID External key to the PROFILE table. bigint no

ACTION_KEY Inhibited action. varchar(40) no

ACTION_VALUE Free format text. varchar(20) no


PROFILE_ACTION_PK yes yes PROFILE_ID

ACTION_KEY

PROFILE_ACTION table


SERVER

Stores information about the Tivoli License Manager runtime servers.



NAME Name of the runtime server. varchar_utf(60) no

ADDRESS IP address. varchar_utf(60) no

PASSWORD Encrypted password to validate communication

requests.

varchar(40) no

VERSION Runtime server version. varchar(10) yes

PORT_NUMBER Communication port. Default = 80. integer no

SSL_PORT_NUMBER Communication port for SSL. Default = 443. integer no

SSL_ENABLED If true, SSL is enabled between runtime server and

administration server. Default = 0 (false).

smallint no

FORCE_SERVICE Force an entire refresh for incremental services.

Default = ’YNN’.

char(3) no

DOWNLOAD_PERIOD Not used bigint no

UPLOAD_PERIOD Not used bigint no

UPDATE_PERIOD Not used bigint no

WARNING_TIME Date and time of the last inactive server mail

notification. Default = current timestamp.

timestamp no

LOCATION Location of the runtime server. varchar_utf(40) yes

OUTAGE_STATUS Status of planned outages:

0 No outage planned (default).

1 In planned outage.

2 Ready to return from planned outage.

3 Returning from planned outage.

smallint no

BACKUP_SERVER_ID ID of the backup server (key to another entry in this

table).

bigint yes




SERVER_PK yes yes ID

SERVER_UI1 yes no CUSTOMER_ID

NAME

SERVER_UI2 yes no CUSTOMER_ID

ADDRESS

SERVER table


SERVER_H

The history of the SERVER table. An entry is made or updated when a server is added, changed, or removed.


ID Unique identifier of the server. bigint no

NAME Name of the runtime server. varchar_utf(60) no



START_ACTION I Insert a record on server creation.

U Update the server details.

char(1) no


END_ACTION D Insert a record on server deletion.

U Update the server details.

char(1) no


SERVER_H_I1 no no ID

SERVER_H table


SERVICE

Provides a history of the service requests made.


SERVICE_ID 1 Update the agent inventory.

2 Update the agent information.

3 Download the topology.

integer no

SERVER_ID ID of the requesting server (external key to the

SERVER table).

bigint no

INSERTED Date and time when the row was inserted. timestamp no

FORCE_CHECK_TIME Internal use only. timestamp yes

DESCRIPTION Description of the service. varchar(80) yes


SERVICE_PK yes yes SERVICE_ID

SERVER_ID

INSERTED

SERVICE table


UNKNOWN

Stores details of executable files that are installed on nodes running the Tivoli License Manager agent, but which

have not yet been associated with a software component.



NAME File name. varchar(254) no

SIZE_ File size. bigint no

TYPE Module type:

0 Executable file. (default)

10 Non-executable file.

200 Application server

300 J2EE application

integer no

CHECKSUM Not used. bigint no


JVM

OS/400



Windows

varchar(12) no

PATH Location of the file. varchar(400) yes

DESCRIPTION Free format text. varchar(80) yes

VERSION Version of the file. varchar(40) yes

TEXT1 Free format text. varchar(80) yes

TEXT2 Free format text. varchar(80) yes

ENABLED If true, the entry in the table is reported by the catalog

manager: Default = 1 (true).

smallint no



UNKNOWN_PK yes yes ID

UNKNOWN_UI1 yes no NAME

SIZE_

OS_NAME

UNKNOWN table


USAGE_COMP

Stores product use information by product (component).




AGENT_ID External key to the AGENT table. bigint no

DIVISION_ID External key to the DIVISION table bigint no

CUSTOMER_ID External key to the CUSTOMER table. smallint no

START_TIME Date and time when the session started. timestamp no

END_TIME Date and time when the session ended. timestamp no


USAGE_COMP_PK yes yes ID

USAGE_COMP_I1 no no COMPONENT_ID

USAGE_COMP table


USAGE_COMP_USER

Maps software use sessions to users.


USAGE_COMP_ID External key to USAGE_COMP table. bigint no

USER The logon name of the user whose use data is

reported under the given USAGE_COMP_ID.

varchar(60) yes

GROUP The user group of the user whose use data is reported

under the given USAGE_COMP_ID.

varchar(60) yes


USAGE_COMP_USER_PK yes yes USAGE_COMP_ID

USAGE_COMP_USER table


USAGE_H_COMP

Stores aggregated license use information by product (component).






HWM High water mark in the time frame. integer no

HWM_TIME Time of the high water mark. time no

AWM Average use in the time frame. float no

UNLICENSED_HWM Unlicensed high water mark in the time frame. integer no

RIF_HWM High water mark to be used for unlicensed ratio. integer no


USAGE_H_COMP_PK yes yes CUSTOMER_ID

COMPONENT_ID

DATE_USAGE

USAGE_H_COMP_UI1 yes no ID

USAGE_H_COMP table


USAGE_H_DIV

Stores aggregated license use information by division.










USAGE_H_DIV_PK yes yes DIVISION_ID

COMPONENT_ID

DATE_USAGE

USAGE_H_DIV_UI1 yes no ID

USAGE_H_DIV table


USAGE_H_LIC

Stores aggregated license use information by license.









USAGE_H_LIC_PK yes yes LICENSE_ID

DATE_USAGE

USAGE_H_LIC_UI1 yes no ID

USAGE_H_LIC table


USAGE_H_LIC_COMP

Stores aggregated license use information by license and product (component).




COMPONENT_ID External key to the LICENSE table. bigint no





USAGE_H_LI_CMP_PK yes yes LICENSE_ID

COMPONENT_ID

DATE_USAGE

USAGE_H_LIC_COMP table


USAGE_H_OOCOD

Stores license use data related to applications running on nodes that support IBM capacity-based pricing.




CAPACITY Processor capacity at the node on the date indicated in

DATE_USAGE, expressed in hundredths; thus a value

of 25 means 25 hundredths, which is 25%.

integer no



DATE_USAGE Date to which this capacity use refers. date no


USAGE_H_OOCOD_PK yes yes NODE_ID

DATE_USAGE

COMPONENT_ID

PLICENSE_ID

USAGE_H_OOCOD_UI1 yes no ID

USAGE_H_OOCOD table


USAGE_H_PLIC

Stores aggregated license use information by procured license.









USAGE_H_PLIC_PK yes yes PLICENSE_ID

DATE_USAGE

USAGE_H_PLIC table


USAGE_H_PLIC_COMP

Stores aggregated license use information by procured license and product (component).









USAGE_H_PL_CMP_PK yes yes PLICENSE_ID

COMPONENT_ID

DATE_USAGE

USAGE_H_PLIC_COMP table


USAGE_LIC

Stores license use information.


USAGE_COMP_ID External key to USAGE_COMP table (product use

information).

bigint no



QUANTITY The quantity of use granted. integer no

POOL_HASH Hash of the shared pool name. bigint no

POOL_CAPACITY Shared pool processor capacity, expressed in


which is 25%.

integer no

LPAR_HASH Hash of the logical partition name. bigint no

LPAR_CAPACITY Logical partition processor capacity, expressed in


which is 25%.

integer no

NODE_HASH Hash of the node name. bigint no

NODE_CAPACITY Node processor capacity, expressed in hundredths;

thus a value of 25 means 25 hundredths, which is

25%.

integer no

START_TIME Date and time when the license was granted. timestamp no

END_TIME Date and time when the license was released. timestamp no


USAGE_LIC_PK yes yes USAGE_COMP_ID

START_TIME

USAGE_LIC_I1 no no LICENSE_ID

COMPONENT_ID

USAGE_LIC table


VENDOR

Stores information about the software vendors.



NAME Name of the software vendor. varchar(80) no



VENDOR_PK yes yes ID

VENDOR_UI1 yes no NAME

VENDOR table


Notices

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 give you

any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing

IBM Corporation

North Castle Drive

Armonk, NY 10504-178, U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBM

Intellectual Property Department in your country or send inquiries, in writing, to:

IBM World Trade Asia Corporation

Licensing

2-31 Roppongi 3-chome, Minato-ku

Tokyo 106, Japan

The following paragraph does not apply to the United Kingdom or any other

country where such provisions are inconsistent with local law:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS

PUBLICATION ″AS IS″ WITHOUT WARRANTY OF ANY KIND, EITHER

EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED

WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS

FOR A PARTICULAR PURPOSE.

Some states do not allow disclaimer of express or implied warranties in certain

transactions, therefore, this statement might not apply to you.

This information could include technical inaccuracies or typographical errors.

Changes are periodically made to the information herein; these changes will be

incorporated in new editions of the publication. IBM may make improvements

and/or changes in the product(s) and/or the program(s) described in this

publication at any time without notice.

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.


IBM may use or distribute any of the information you supply in any way it

believes appropriate without incurring any obligation to you.

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.

Such information may be available, subject to appropriate terms and conditions,

including in some cases, payment of a fee.

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.

Information concerning non-IBM products was obtained from the suppliers of

those products, their published announcements or other publicly available sources.

IBM has not tested those products and cannot confirm the accuracy of

performance, compatibility or any other claims related to non-IBM products.

Questions on the capabilities of non-IBM products should be addressed to the

suppliers of those products.

Trademarks

The following terms are trademarks of the IBM Corporation in the United States or

other countries or both:

IBM

The IBM logo

DB2

DB2 Universal Database

OS/400

Tivoli

WebSphere

Intel, the Intel Inside logos, MMX, and Pentium are trademarks of Intel

Corporation in the United States, other countries, or both.

Linux is a trademark of Linus Torvalds in the United States, other countries, or

both.

UNIX is a registered trademark of The Open Group in the United States and other

countries.

Microsoft, Windows, Windows NT, and the Windows logo are registered

trademarks, of Microsoft Corporation in the U.S. and other countries.

SSLRef 1.0 is a trademark of Netscape Communications Corporation.


Java and all Java-based trademarks and logos are trademarks or

registered trademarks of Sun Microsystems, Inc. in the U.S., and other

countries.

Other company, product, and service names may be trademarks or service marks

of others.

Notices 75

Index

Aaccessibility vii

ACCOUNT_ID column, CUSTOMER table 25

ACTION_KEY columnPROFILE_ACTION table 57

PROFILE_ACTION_PK index 57

ACTION_VALUE column, PROFILE_ACTION table 57

ACTIVE columnAGENT table 11

ENTITLEMENT table 29

ADDRESS columnSERVER table 58

SERVER_UI2 index 58

ADMIN_CUST_PK index 9

ADMIN_CUST_REL table 9

ADMINISTRATOR table 10

ADMINISTRATOR_ID columnADMIN_CUST_PK index 9


ADMINISTRATOR_PK index 10

ADMINISTRATOR_UI1 index 10


AGENT table 11

AGENT_EVENT table 12

AGENT_EVENT_PK index 12

AGENT_H table 13

AGENT_H_I1 index 13

AGENT_H_I2 index 13

AGENT_I1 index 11

AGENT_I2 index 11

AGENT_ID columnAGENT_EVENT table 12


AGENT_INV table 14

AGENT_INV_UI index 14

USAGE_COMP table 62

AGENT_INV table 14

AGENT_INV_I1 index 14

AGENT_INV_ID columnAGENT_INV_LIC table 15

AGENT_INV_LIC_PK index 15

AGENT_INV_LIC table 15

AGENT_INV_LIC_I1 index 15


AGENT_INV_PK index 14


AGENT_PK index 11

AGENT_SYNC_CUST table 16

AGENT_SYNC_CUST_PK index 16

AGENT_SYNC_DIV table 17

AGENT_SYNC_DIV_PK index 17

ALL_TARGETS columnLICENSE table 39

LICENSE_H table 42

ALL_USERS columnLICENSE table 39

LICENSE_H table 42

allrun.htm file vi

AWM columnUSAGE_H_COMP table 64

USAGE_H_DIV table 65

AWM column (continued)USAGE_H_LIC table 66

USAGE_H_PLIC table 69

BBACKUP_SERVER_ID column, SERVER table 58

BLOCK_SIZE column, OID table 46

booksaccessing online vi

online v, vii

ordering v, vii

CCAPACITY column

NODE table 44

NODE_H table 45

USAGE_H_OOCOD table 68

CAPACITY_TYPE columnPLICENSE table 52

PLICENSE_H table 55

CHECK_PERIOD column, CUSTOMER table 25

CHECKSUM column, UNKNOWN table 61

COMP_HIER table 18

COMP_HIER_I1 index 18


COMP_HIER_PK index 18

COMP_MOD_REL table 19

COMP_MOD_REL_PK index 19

COMPONENT table 20

COMPONENT_I1 index 20

COMPONENT_ID columnAGENT_INV table 14

AGENT_INV_II index 14




COMPONENT table 20


ENTITLEMENT_UI1 index 29

INV_H_COMP table 30

INV_H_COMP_PK index 30

INV_H_L_CMP_PK index 32

INV_H_LIC_COMP table 32

INV_H_PL_CMP_PK index 34

INV_H_PLIC_COMP table 34

PLIC_COMP_HREL table 49

PLIC_COMP_REL table 50

PLIC_COMP_REL_PK index 50

USAGE_COMP table 62

USAGE_COMP_UI1 index 62

USAGE_H_COMP table 64

USAGE_H_COMP_PK index 64


USAGE_H_DIV_PK index 65

USAGE_H_LI_CMP_PK index 67

USAGE_H_LIC_COMP table 67


USAGE_H_OOCOD_PK index 68


COMPONENT_ID column (continued)USAGE_H_PL_CMP_PK index 70

USAGE_H_PLIC_COMP table 70

USAGE_LIC table 71

USAGE_LIC_I1 index 71

COMPONENT_PK index 20

COMPONENT_UI1 index 20


component, prior name for product 1

CONTRACT table 21

CONTRACT_NUM columnCONTRACT table 21

CONTRACT_UI1 index 21

CONTRACT_PK index 21

CONTRACT_REF column, PLICENSE table 52



CONTROL table 22

CONTROL_PK index 22

conventions, typeface xi

COST columnCONTRACT table 21

PLICENSE table 52

COST_CURR column, CONTRACT table 21

COST_CURR column, PLICENSE table 52

COUNTRY table 23

COUNTRY_CODE column, CUSTOMER table 25

COUNTRY_PK index 23

COUNTRY_UI1 index 23

CURRENCY_CODE column, COUNTRY table 23

CURRENCY_NAME column, COUNTRY table 23

CUST_OPT_FIELD table 24

CUST_OPT_FIELD_PK index 24

customer supportsee Software Support vii

CUSTOMER table 25

CUSTOMER_ID columnADMIN_CUST_PK index 9


AGENT table 11

AGENT_H table 13

AGENT_SYNC_CUST table 16


CONTRACT table 21



CUST_OPT_FIELD table 24


DIVISION table 26

DIVISION_H table 27

DIVISION_UI1 index 26


ENDUSER table 28

ENDUSER_UI1 index 28




INV_H_COMP table 30


LICENSE table 40

LICENSE_H table 42

LICENSE_UI1 index 40


NODE table 44

NODE_H table 45

NODE_UI1 index 44

PLICENSE table 52

CUSTOMER_ID column (continued)PLICENSE_H table 55

PLICENSE_UI1 index 53


SERVER table 58

SERVER_H table 59

SERVER_UI1 index 58

SERVER_UI2 index 58

USAGE_COMP table 62



CUSTOMER_PK index 25

CUSTOMER_UI1 index 25

customer, prior name for organization 1

Ddatabase table names 1

DATE_USAGE columnINV_H_COMP table 30



INV_H_LIC table 31


INV_H_LIC_PK index 31


INV_H_PLIC table 33


INV_H_PLIC_PK index 33






USAGE_H_LIC table 66


USAGE_H_LIC_PK index 66



USAGE_H_PL_CMP_PK index 70



USAGE_H_PLIC_PK index 69

DELIVERY_DATE columnPLICENSE table 52

PLICENSE_H table 55

DESCRIPTION columnCOMPONENT table 20

CUSTOMER table 25

DIVISION table 26

DIVISION_H table 27

NODE table 44

PROFILE table 56

PROFILE_UI1 index 56

SERVICE table 60

UNKNOWN table 61

directory names, notation xii

DISKS columnAGENT table 11

DIVISION table 26

DIVISION_H table 27

DIVISION_H_I1 index 27

DIVISION_ID columnAGENT table 11

AGENT_H table 13

AGENT_H_I2 index 13

AGENT_I1 index 11


DIVISION_ID column (continued)AGENT_SYNC_DIV table 17


USAGE_COMP table 62



DIVISION_PK index 26



DOWNLOAD_PERIOD column, SERVER table 58

Eeducation

see Tivoli technical training vii

EMAIL_ADDRESS columnADMINISTRATOR table 10

ENDUSER table 28

EMPLOYEE_NO column, ENDUSER table 28

ENABLED column, MODULE table 43

ENABLED column, UNKNOWN table 61

END_ACTION columnAGENT_H table 13

DIVISION_H table 27

LICENSE_H table 42

NODE_H table 45

PLICENSE_H table 55

SERVER_H table 59

END_DATE column, CONTRACT table 21

END_TIME columnAGENT_H table 13

AGENT_INV table 14


DIVISION_H table 27

LIC_TARGET_HREL table 35

LIC_USER_HREL table 37

LICENSE_H table 42

NODE_H table 45


PLICENSE_H table 55

SERVER_H table 59

USAGE_COMP table 62

USAGE_LIC table 71

ENDUSER table 28

ENDUSER_ID columnLIC_USER_HREL table 37

LIC_USER_PK index 38

LIC_USER_REL table 38

ENDUSER_PK index 28




ENTITLEMENT_PK index 29


environment variables, notation xii

EVENT_ID column, AGENT_EVENT table 12

EVENT_NOTIFICATION column, ADMINISTRATOR

table 10

EXPIRATION_DATE columnPLICENSE table 52

PLICENSE_H table 55

EXT_ID columnADMINISTRATOR table 10


COMPONENT table 20


CONTRACT table 21

EXT_ID column (continued)CONTRACT_UI2 index 21

DIVISION table 26


ENDUSER table 28


LICENSE table 39


NODE table 44

NODE_UI1 index 44

PLICENSE table 52


FFAX column


ENDUSER table 28

fileallpubs.htm vi

FIRST_NAME columnADMINISTRATOR table 10

ENDUSER table 28

fixes, obtaining x

FORCE_CHECK_TIME column, SERVICE table 60

FORCE_SERVICE column, SERVER table 58

GGROUP column, USAGE_COMP_USER table 63

HHARD_STOP column

PLICENSE table 52

PLICENSE_H table 55

HASH columnNODE table 44

NODE_H table 45

HIDE_GROUP column, ADMIN_CUST_REL table 9

HIDE_HOST column, ADMIN_CUST_REL table 9

HIDE_HOST_INV column, ADMIN_CUST_REL table 9

HIDE_USER column, ADMIN_CUST_REL table 9

HOSTNAME columnAGENT table 11

HWM columnINV_H_COMP table 30

INV_H_LIC table 31


INV_H_PLIC table 33








HWM_TIME columnUSAGE_H_COMP table 64






Index 79

IID column


ADMINISTRATOR_PK index 10

AGENT table 11

AGENT_H table 13

AGENT_H_I1 index 13

AGENT_INV table 14

AGENT_INV_PK index 14

AGENT_PK index 11

COMPONENT table 20

COMPONENT_PK index 20

CONTRACT table 21

CONTRACT_PK index 21

CUSTOMER table 25

CUSTOMER_PK index 25

DIVISION table 26

DIVISION_H table 27

DIVISION_H_I1 index 27

DIVISION_PK index 26

END_USER_PK index 28

ENDUSER table 28


ENTITLEMENT_PK index 29

INV_H_COMP table 30

INV_H_LIC table 31


INV_H_PLIC table 33


LICENSE table 39

LICENSE_H table 42

LICENSE_H_I1 index 42

LICENSE_PK index 40

MODULE table 43

MODULE_PK index 43

NODE table 44

NODE_H table 45

NODE_H_I1 index 45

NODE_H_I2 index 45

NODE_PK index 44

OPT_FIELD_DEF table 48

OPT_FIELD_DEF_PK index 48

PLICENSE table 51

PLICENSE_H table 54

PLICENSE_H_I1 index 55

PLICENSE_PK index 53

PROFILE table 56

PROFILE_PK index 56

SERVER table 58

SERVER_H table 59

SERVER_H_I1 index 59

SERVER_PK index 58

UNKNOWN table 61

UNKNOWN_PK index 61

USAGE_COMP table 62

USAGE_COMP_PK index 62


USAGE_H_COMP_UI1 index 64


USAGE_H_DIV_UI1 index 65



USAGE_H_LIC_UI1 index 66


USAGE_H_OOCOD_UI1 index 68



ID column (continued)VENDOR table 72

VENDOR_PK index 72

information centers, searching to find software problem

resolution ix

INSERTED columnSERVICE table 60

SERVICE_PK index 60

Internet, searching to find software problem resolution x

INV_H_COMP table 30



INV_H_LIC table 31




INV_H_PLIC table 33



INV_RATE_TYPE columnDIVISION table 26

DIVISION_H table 27

INV_RATE_VALUE columnDIVISION table 26

DIVISION_H table 27

INV_START_DATE columnDIVISION table 26

DIVISION_H table 27

IP_ADDRESS column, AGENT table 11

IS_IBM, COMPONENT table 20

ISO_CODE2 column, COUNTRY table 23

ISO_CODE3 columnCOUNTRY table 23

COUNTRY_PK index 23

ISO_CODE4 column, COUNTRY table 23

Kknowledge bases, searching to find software problem

resolution ix

LLAST_ID column, OID table 46

LAST_MODIFIED columnADMIN_CUST_REL table 9


AGENT table 11


COMPONENT table 20

CONTRACT table 21

CUSTOMER table 25

DIVISION table 26

ENDUSER table 28


LIC_TARGET_REL table 36


LICENSE table 40

LICENSE_DISTRIBUTION table 41

MODULE table 43

NODE table 44

SERVER table 52, 58

UNKNOWN table 61

VENDOR table 72

LAST_NAME columnADMINISTRATOR table 10


LAST_NAME column (continued)ENDUSER table 28

LAST_SYNC_TIME column, AGENT table 11

LEVEL_ column, COMPONENT table 20

LIC_DISTR_PK index 41


LIC_TARGET_PK index 36





LICENSE table 39

LICENSE_CONTROL column, ENTITLEMENT table 29

LICENSE_DISTRIBUTION tabletable 41

LICENSE_H table 42

LICENSE_H_I1 index 42

LICENSE_ID columnAGENT_INV_LIC table 15

AGENT_INV_LIC_I1 index 15


INV_H_LIC table 31















USAGE_LIC table 71


LICENSE_KEY column, PLICENSE table 52

LICENSE_PK index 40

LICENSE_TYPE columnPLICENSE table 52

PLICENSE_H table 55



LOCATION columnENDUSER table 28

NODE table 44

SERVER table 58

LOGON_NAME columnADMINISTRATOR table 10


ENDUSER table 28


LPAR_CAPACITY columnAGENT table 11

USAGE_LIC table 71

LPAR_HASH columnUSAGE_LIC table 71

LPAR_NAME columnAGENT table 11

Mmanuals

accessing online vi

online v, vii

manuals (continued)ordering v, vii

MEMORY columnAGENT table 11

MIDDLE_NAME columnADMINISTRATOR table 10

ENDUSER table 28

MODIFIED_BY columnCONTRACT table 21

PLICENSE table 52

MODULE table 43

MODULE_ID columnCOMP_MOD_REL table 19


MODULE_PK index 43

MODULE_UI1 index 43

MULTI_INSTANCE columnPLICENSE table 52

PLICENSE_H table 55

NNAME column

COMPONENT table 20


CONTROL table 22

CONTROL_PK index 22

COUNTRY table 23

COUNTRY_UI1 index 23

CUSTOMER table 25

CUSTOMER_UI1 index 25

DIVISION table 26

DIVISION_H table 27


MODULE table 43

MODULE_UI1 index 43

NODE table 44

NODE_H table 45

NODE_I2 index 44

OFT_FIELD_DEF_UI1 index 48


PROFILE table 56

SERVER table 58

SERVER_H table 59

SERVER_UI1 index 58

UNKNOWN table 61

UNKNOWN_UI1 index 61

VENDOR table 72

VENDOR_UI1 index 72

NEED_RESPONSE column, ENTITLEMENT table 29

NODE table 44

NODE_CAPACITY columnUSAGE_LIC table 71

NODE_H table 45

NODE_H_I1 index 45

NODE_H_I2 index 45

NODE_HASH columnUSAGE_LIC table 71

NODE_I1 index 44

NODE_I2 index 44

NODE_ID columnAGENT table 11

AGENT_H table 13

AGENT_I2 index 11



NODE_PK index 44

Index 81

NODE_UI1 index 44

notationenvironment variables xii

path names xii

typeface xi, xii

NOTES columnCONTRACT table 21

PLICENSE table 52

OOFT_FIELD_DEF_UI1 index 48

OID table 46

OID_PK index 46

online publications, accessing vi

OOCOD columnNODE table 44

NODE_H table 45

NODE_H_I2 index 45

OPT_FIELD table 47


OPT_FIELD_DEF_PK index 48

OPT_FIELD_ID columnCUST_OPT_FIELD table 24


OPT_FIELD table 47

OPT_FIELD_PK index 47


ORDER_REF column, PLICENSE table 52

ordering publications vii

organizationtermed as CUSTOMER in CUSTOMER table 25

organization, termed in tables as customer 1

OS_NAME columnAGENT table 11

COMPONENT table 20


MODULE table 43

MODULE_UI1 index 43

UNKNOWN table 61


OS_VERSION columnAGENT_H table 13

OS_VERSION column, AGENT table 11

OUTAGE_STATUS column, SERVER table 58

overview 1

OWNER columnCONTRACT table 21

PLICENSE table 51

PPASSWORD column


SERVER table 58

PATH column, UNKNOWN table 61

path names, notation xii

PHONE columnADMINISTRATOR table 10

ENDUSER table 28

PLATFORM columnNODE table 44

NODE_H table 45




PLICENSE table 51

PLICENSE_H table 54

PLICENSE_H_I1 index 55

PLICENSE_ID columnINV_H_PL_CMP_PK index 34

INV_H_PLIC table 33



LICENSE table 39

LICENSE_H table 42










PLICENSE_PK index 53



PLUGIN_TIME columnNODE table 44

NODE_H table 45

NODE_H_I2 index 45

PLUGIN_TIME column, AGENT table 11

POOL_CAPACITY columnAGENT table 11

USAGE_LIC table 71

POOL_HASH columnUSAGE_LIC table 71

POOL_NAME columnAGENT table 11

PORT_NUMBER column, SERVER table 58

problem determinationdescribing problem for IBM Software Support ix

determining business impact for IBM Software

Support viii

submitting problem to IBM Software Support ix

PROCESSORS columnAGENT table 11

producttermed as COMPONENT in COMPONENT table 20

PRODUCT_ID columnCOMP_HIER table 18


product, termed in tables as component 1

PROFILE table 56

PROFILE_ACTION table 57


PROFILE_ID columnADMIN_CUST_REL table 9

PROFILE_ACTION table 57


PROFILE_PK index 56

PROFILE_UI1 index 56

publicationsaccessing online vi

online v, vii

ordering v, vii

PURCHASE_TYPE column, PLICENSE table 52

PURCHASE_VENDOR column, CONTRACT table 21


QQUANTITY column


LICENSE table 39


LICENSE_H table 42

PLICENSE table 52

PLICENSE_H table 55

USAGE_LIC table 71

RREF_CODE column

LICENSE table 39

LICENSE_H table 42


PLICENSE table 51

PLICENSE_H table 54


relationship diagrams for tables 6

RELEASE_ID columnCOMP_HIER table 18

COMP_HIER_PK index 18

REQUEST_SCOPE column, CUSTOMER table 25

RIF_HWM columnINV_H_COMP table 30


RUN_OFFLINE column, ENTITLEMENT table 29

SSCAN_TIME column, AGENT table 11

SCOPE column, MODULE table 43

SECURITY_LEVEL columnAGENT table 11

CUSTOMER table 25

DIVISION table 26, 27

SERVER table 58

SERVER_H table 59

SERVER_H_I1 index 59

SERVER_IDSERVICE table 60

SERVER_ID columnAGENT table 11

AGENT_H table 13



SERVICE_PK index 60

SERVER_PK index 58

SERVER_UI1 index 58

SERVER_UI2 index 58

SERVICE table 60

SERVICE_ID columnSERVICE table 60

SERVICE_PK index 60

SERVICE_PK index 60

SIZE columnUNKNOWN_UI1 index 61

SIZE_ columnMODULE table 43

MODULE_UI1 index 43

UNKNOWN table 61

software producttermed as COMPONENT in COMPONENT table 20

Software Supportcontacting vii

Software Support (continued)describing problem for IBM Software Support ix

determining business impact for IBM Software

Support viii

submitting problem to IBM Software Support ix

SOFTWARE_NAME columnPLICENSE table 51

PLICENSE_H table 54

SSL_ENABLED column, SERVER table 58

SSL_PORT_NUMBER column, SERVER table 58

START_ACTION columnAGENT_H table 13

DIVISION_H table 27

LICENSE_H table 42

NODE_H table 45

PLICENSE_H table 55

SERVER_H table 59

START_DATE columnCONTRACT table 21

PLICENSE table 52

PLICENSE_H table 55

START_TIME columnAGENT_H table 13

AGENT_INV table 14




DIVISION_H table 27



LICENSE_H table 42

NODE_H table 45


PLICENSE_H table 55

SERVER_H table 59

USAGE_COMP table 62

USAGE_LIC table 71

USAGE_LIC_PK index 71

STATUS columnCONTRACT table 21

STORAGE columnAGENT table 11

SUPPLY_VENDOR column, CONTRACT table 21

support information, updating x

SWARE_DESC columnMODULE table 43

SWARE_VERS columnMODULE table 43

SYNC_DATE columnAGENT_SYNC_CUST table 16




SYNC_RATIO columnAGENT_SYNC_CUST table 16


Ttable

relationship diagrams 6

table names, database 1

TABLE_NAME columnOFT_FIELD_DEF_UI1 index 48

OID_PK index 46


TABLE_NAME column, OID table 46

Index 83

TABLE_RECORD_ID columnOPT_FIELD table 47


TAG columnNODE table 44

NODE_H table 45

NODE_I1 index 44

TARGET_ID columnLIC_TARGET_HREL table 35



TARGET_TYPE columnLICENSE table 39

LICENSE_H table 42

TC column, PLICENSE table 52

terminology, database 1

TERMS column, CONTRACT table 21

TEXT1 column, UNKNOWN table 61

TEXT2 column, UNKNOWN table 61

THRESHOLD columnPLICENSE table 52

PLICENSE_H table 55

TIME columnAGENT_EVENT table 12


Tivoli Software Information Center vi

Tivoli technical training vii

training, Tivoli technical vii

TREE_LEVEL columnCOMPONENT table 20

PLICENSE table 51

PLICENSE_H table 54

TYPE columnCONTRACT table 21

MODULE table 43


UNKNOWN table 61

typeface conventions xi

UUNKNOWN table 61

UNKNOWN_PK index 61


UNLICENSED_HWM columnINV_H_COMP table 30


UPDATE_PERIOD column, SERVER table 58

UPLOAD_PERIOD column, SERVER table 58

USAGE_COMP table 62

USAGE_COMP_I1 index 62

USAGE_COMP_ID columnUSAGE_COMP_USER table 63

USAGE_COMP_USER_PK index 63

USAGE_LIC table 71


USAGE_COMP_PK index 62

USAGE_COMP_USER table 63

USAGE_COMP_USER_PK index 63



USAGE_H_COMP_UI1 index 64



USAGE_H_DIV_UI1 index 65



USAGE_H_LIC_COMP tabletable 67


USAGE_H_LIC_UI1 index 66



USAGE_H_OOCOD_UI1 index 68



USAGE_H_PLIC_COMP tabletable 70


USAGE_LIC table 71



USER columnUSAGE_COMP_USER table 63

VVALUE column

CONTROL table 22

MODULE table 43

MODULE_UI1 index 43

OPT_FIELD table 47

variables, notation xii

VENDOR table 72

VENDOR_ID columnCOMPONENT table 20

COMPONENT_I1 index 20

VENDOR_PK index 72

VENDOR_UI1 index 72

VERIFIED column, PLICENSE table 52

VERSION columnAGENT table 11

AGENT_H table 13

COMPONENT table 20


SERVER table 58

UNKNOWN table 61

VERSION_ID columnCOMP_HIER table 18


WWARNING_TIME column, SERVER table 58


��

Program Number: 5724-D33

SC32-1432-01