IBM Tivoli License Manager: Data...

34
IBM Tivoli License Manager Data Dictionary Version 1.1 GC23-4835-00

Transcript of IBM Tivoli License Manager: Data...

Page 1: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

IBM Tivoli License Manager

Data Dictionary

Version 1.1

GC23-4835-00

���

Page 2: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views
Page 3: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

IBM Tivoli License Manager

Data Dictionary

Version 1.1

GC23-4835-00

���

Page 4: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

First Edition (October 2002)

This edition applies to Version 1.1 of IBM Tivoli License Manager and to all subsequent releases and modificationsuntil otherwise indicated in new editions. Make sure that you are using the correct edition for the level of theproduct.

Order publications through your IBM representative or the IBM branch office serving your locality. Publications arenot stocked at the address given below.

IBM welcomes your comments.

Address your comments to:

License Management Information DevelopmentRome Tivoli LabIBM Italia S.p.A.Via Sciangai, 5300144 RomeItaly

Fax Number: (+39) 06 5966 2077

Internet ID: ROMERCF at VNET.IBM.COM

When you send information to IBM, you grant IBM a non-exclusive right to use or distribute the information in anyway it believes appropriate without incurring any obligation to you.

© Copyright International Business Machines Corporation 2001, 2002. All rights reserved.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

Page 5: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Contents

Chapter 1. Overview . . . . . . . . . 1Customer Views . . . . . . . . . . . 1

Chapter 2. Tables . . . . . . . . . . 3

Chapter 3. Indexes . . . . . . . . . 21

© Copyright IBM Corp. 2001 iii

Page 6: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

iv IBM Tivoli License Manager: Data Dictionary

Page 7: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Chapter 1. Overview

This data dictionary describes the tables and application views that make upthe data model for the administration server DB2 database for Tivoli LicenseManager version 1.1.

The database is the repository for all customer information, such as licensepools, runtime servers, divisions, application users, and nodes. It also containsgeneral information, such as the product information of applications that canbe monitored and software vendors.

Figure 1 is an ER diagram showing the relationships between tables within theadministration server database. 1

The subsequent chapters of this data dictionary provide definitions of thetables and indexes that form the Tivoli License Manager administration serverdatabase. See Chapter 2, “Tables” on page 3 and Chapter 3, “Indexes” onpage 21.

Customer Views

The database can hold information relating to many customers. When youaccess data using the Web interface, an administrator only sees theinformation that relates to the customers that he or she has been assigned.You can set up database views that allow a database user to view details for aspecific customer.

Figure 1. Relationships between Tivoli License Manager administration server database tables

© Copyright IBM Corp. 2001 1

Page 8: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

To set up data access for a specific customer, complete the following steps:1. Log on to the DB2 server as administrator.2. Create a Windows 2000 or Windows NT user as follows:

User IDSet this to the name of the customer.

PasswordChoose a password.

Password never expiresSelect Yes.

User must change password at next log onSelect No.

3. From the Start menu, open the DB2 Command window.4. Connect to the administration server database, using the following

command:db2 connect to tlma user db2admin

5. Retrieve the customer ID as follows:db2 select id from tlma.customer where name = ‘<CUSTOMER_NAME>’

6. Change to the folder:<TLM_INSTALL_DIR>\admin\db\db2

7. Create a copy of the customer_views.sql file, for example mycustomer.sql.8. Open your copy in a text editor.9. Search and replace the following values:

CUSTID Replace with the customer ID you retrieved.

CUSTNAME Replace with the name of the customer, which must bethe same as the name you used to create the user ID.

10. Save the file and return to the command line.11. Issue the following command>

db2 f mycustomer.sql

2 IBM Tivoli License Manager: Data Dictionary

Page 9: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Chapter 2. Tables

Note: The definition of the LAST_MODIFIED column that appears in manytables is:

This is a TIMESTAMP used to prevent errors in data transactions. Thedatabase updates the LAST_MODIFIED field each time the data ischanged using internal triggers.

© Copyright IBM Corp. 2001 3

Page 10: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Table Name: ADMIN_CUST_REL

Description Maps ADMINISTRATOR to CUSTOMER (many-to-many)Column Name Description Type Precision NullADMINISTRATOR_ ID Foreign key to the ADMINISTRATOR

tableLONG No

CUSTOMER_ID Foreign key to the CUSTOMER table LONG NoPROFILE_ID Administrator profile (Foreign key to

the PROFILE table)LONG No

LAST_MODIFIED TIMESTAMP No

Table Name: ADMINISTRATOR

Description Administration and runtime server administratorsColumn Name Description Type Precision NullID Unique identifier LONG NoLOGON_NAME User ID for logging on to SLM VARCHAR 60 NoFIRST_NAME Name of the administrator VARCHAR 40 NoMIDDLE_NAME Middle name of the administrator VARCHAR 20 YesLAST_NAME Surname of the administrator VARCHAR 40 NoEMAIL_ADDRESS The administrator’s e-mail address VARCHAR 80 YesEVENT_NOTIFICATION E-mail event notification flag SMALLINT NoPHONE Telephone number VARCHAR 40 YesFAX Fax number VARCHAR 40 YesLAST_MODIFIED TIMESTAMP No

Table Name: AGENT

Description Installed Tivoli License Manager agentsColumn Name Description Type Precision NullID Unique identifier LONG NoHOSTNAME Machine hostname (e.g.

omega.ibm.com)VARCHAR 60 No

OS_NAME Operating system name (UNIX,Windows)

VARCHAR 10 No

OS_VERSION Operating system version (e.g 2.1, NT4, 2000)

VARCHAR 40 No

IP_ADDRESS Network IP address VARCHAR 20 NoVERSION Version of the agent that is installed VARCHAR 20 NoMEMORY Ram size in Mbytes INTEGER NoDISKS Number of hard-disks drives INTEGER NoSTORAGE Total hard-disk space in Gbytes INTEGER NoCONFIG_PROCS Number of configured processors

installed on the machineINTEGER No

ONLINE PROCS Number of online processors installedon the machine

INTEGER No

PLUGIN_TIME Last agent plugin or update TIMESTAMP No

4 IBM Tivoli License Manager: Data Dictionary

Page 11: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Table Name: AGENT

Description Installed Tivoli License Manager agentsColumn Name Description Type Precision NullSERVER_ID Foreign key to the SERVER table LONG NoNODE_ID Foreign key to the NODE table LONG YesDIVISION_ID Foreign key to the DIVISION table LONG NoCUSTOMER_ID Foreign key to the CUSTOMER table

Redundant (equal toDIVISION.CUSTOMER_ID)

LONG No

LAST_MODIFIED TIMESTAMP No

Table Name: AGENT_DIV_HREL

Description History of agent to division relationshipsColumn Name Description Type Precision NullAGENT_ID Unique identifier of the agent LONG NoDIVISION_ID Foreign key to the DIVISION table LONG NoSTART_TIME Date and time when the agent was

assigned to the divisionTIMESTAMP No

END_TIME Date and time when the agent wasassigned to a different division

TIMESTAMP No

Table Name: AGENT_EVENT

Description Events on agentsColumn Name Description Type Precision NullAGENT_ID Unique identifier of the agent LONG NoEVENT_ID 1: Inventory INTEGER NoTIME Last agent plugin or update TIMESTAMP NoDESCRIPTION Free format text VARCHAR 80 Yes

Table Name: AGENT_H

Description History of agents. This table maintains a history of changes to agents. Anentry is made or updated when an agent is added, changed, or removed.

Column Name Description Type Precision NullID Unique identifier of the agent LONG NoSERVER_ID Foreign key to the SERVER table LONG NoNODE_ID Foreign key to the NODE table LONG NoDIVISION_ID Foreign key to the DIVISION table LONG NoSTART_TIME Date and time of the start action. TIMESTAMP NoSTART_ACTION I = Insert record on agent deployment

U = Update record on redeploymentCHAR 1 No

END_TIME Date and time of the end action. TIMESTAMP NoEND_ACTION D = Delete agent

U = Update record on redeploymentCHAR 1 No

Chapter 2. Tables 5

Page 12: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Table Name: AGENT_INV

Description Agent historical software inventory. This table stores information aboutthe products installed on machines.

Column Name Description Type Precision NullAGENT_ID Unique identifier of the agent LONG NoCOMPONENT_ID Software product ID Foreign key to the

COMPONENT tableLONG No

START_TIME Date and time of the scan that detectedthe software

TIMESTAMP No

END_TIME Date and of the first scan followinguninstallation of the software

TIMESTAMP No

SCAN_TIME Date and time of the most recent scan TIMESTAMP NoLAST_MODIFIED TIMESTAMP No

Table Name: CATEGORY

Description Software product categoriesColumn Name Description Type Precision NullNAME Name of the category VARCHAR 40 NoID Unique identifier of the category LONG NoLAST_MODIFIED TIMESTAMP No

Table Name: COMMAND

Description Commands issued to agents or serversColumn Name Description Type Precision NullID Unique identifier LONG NoTARGET_TYPE 0 = server

1 = agentINTEGER No

TARGET_ID LONG NoACTION INTEGER NoTYPE 0 = With confirmation

1 = Without confirmationINTEGER No

STATUS 0 = Wait1 = In progress2 = Completed-1 = Error

INTEGER No

SENT_TIME When the command was sent TIMESTAMP YesRESULT_TIME When the result was received TIMESTAMP YesDESCRIPTION Command description VARCHAR 200 YesPARAMETER1 VARCHAR 80 YesPARAMETER2 VARCHAR 80 YesPARAMETER3 VARCHAR 80 YesPARAMETER4 VARCHAR 80 Yes

6 IBM Tivoli License Manager: Data Dictionary

Page 13: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Table Name: COMMAND

Description Commands issued to agents or serversColumn Name Description Type Precision NullPARAMETER5 VARCHAR 80 YesRESULT1 VARCHAR 80 YesRESULT2 VARCHAR 80 YesRESULT3 VARCHAR 80 Yes

Table Name: COMP_MOD_REL

Description Maps COMPONENT to MODULE (many-to-many)Column Name Description Type Precision NullCOMPONENT_ID Foreign key to the COMPONENT table LONG NoMODULE_ID Foreign key to the MODULE table LONG NoLAST_MODIFIED TIMESTAMP No

Table Name: COMPONENT

Description Software productsColumn Name Description Type Precision NullID Unique identifier LONG 0 NoNAME Software product name VARCHAR 80 NoVERSION Software product version VARCHAR 20 NoOS_NAME Platform descriptive field (must be

Windows, Unix, or LinuxS390)VARCHAR 10 No

LEVEL Indicates the level of need for licensecontrol:1 = licensable commerial product2 = licenseable commercial product (not

high cost)3 = shareware or demo software4 = freeware10 = deactivated.

SMALLINT No

TYPE Indicates a type of product:S = suiteP = productF = feature.

CHAR 1 No

CATEGORY Foreign key to the CATEGORY table INTEGER NoDESCRIPTION Free format text VARCHAR 100 NoVENDOR_ID Foreign key to the VENDOR table LONG NoCOMPONENT_ID Foreign key to the COMPONENT table

(used to represent software hierarchiesor suites)

LONG Yes

EXT_ID Used to identify imported rows. VARCHAR 40 NoLAST_MODIFIED TIMESTAMP No

Chapter 2. Tables 7

Page 14: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Table Name: CONTROL

Description Various configuration data in key-value formatColumn Name Description Type Precision NullNAME The name of a parameter VARCHAR 40 NoVALUE The value assigned to the parameter VARCHAR 60 No

Table Name: COUNTRY

Description Country informationColumn Name Description Type Precision NullNAME Name of the country VARCHAR 50 NoISO_CODE2 ISO-2 standard country code CHAR 2 NoISO_CODE3 ISO-3 standard country code CHAR 3 NoISO_CODE4 ISO-4 standard country code (numeric) CHAR 3 NoCURRENCY_NAME Name of the currency used in the

countryVARCHAR 50 Yes

CURRENCY_CODE ISO code of the currency CHAR 3 Yes

Table Name: CUSTOMER

Description Customer informationColumn Name Description Type Precision NullID Unique identifier LONG NoNAME Customer name VARCHAR 40 NoACCOUNT_ID Customer account unique ID CHAR 7 YesCOUNTRY_CODE Foreign key to COUNTRY table CHAR 3 YesDESCRIPTION Free format text VARCHAR 200 YesCHECK_PERIOD Not yet used LONG NoREQUEST_SCOPE Not yet used INTEGER NoLAST_MODIFIED TIMESTAMP No

Table Name: DIVISION

Description Divisions represent the customer logical organizationColumn Name Description Type Precision NullID Unique identifier LONG NoNAME Division name VARCHAR 40 NoINV_START_DATE The start date for the inventory scan

scheduleTIMESTAMP No

INV_RATE_TYPE Indicates the periods in which theinterval between scans is measured:1 = day

2 = week3 = month

SMALLINT No

INV_RATE_VALUE The number of days, weeks, or monthsbetween inventory scans

INTEGER No

8 IBM Tivoli License Manager: Data Dictionary

Page 15: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Table Name: DIVISION

Description Divisions represent the customer logical organizationColumn Name Description Type Precision NullDESCRIPTION Free format text VARCHAR 200 YesEXT_ID Identifier used on imported rows VARCHAR 80 YesCUSTOMER_ID Foreign key to the CUSTOMER table LONG NoLAST_MODIFIED TIMESTAMP No

Table Name: DIVISION_H

Description History of changes to divisions and their inventory schedulesColumn Name Description Type Precision NullID Unique identifier LONG NoNAME Division name VARCHAR 40 NoINV_START_DATE The start date for the inventory scan

scheduleTIMESTAMP No

INV_RATE_TYPE Indicates the periods in which theinterval between scans is measured:1 = day2 = week3 = month

SMALLINT No

INV_RATE_VALUE The number of days, weeks, or monthsbetween inventory scans

INTEGER No

DESCRIPTION Free format text VARCHAR 200 YesCUSTOMER_ID Foreign key to the CUSTOMER table LONG NoSTART_TIME Date and time of the start action. TIMESTAMP NoSTART_ACTION I = Insert record on creation of division.

U = Update record on change to division details or inventory schedule.CHAR 1 No

END_TIME Date and time of the end action. TIMESTAMP NoEND_ACTION D = Delete division.

U =Update record on change to division details or inventory schedule.CHAR 1 No

Table Name: ENDUSER

Description Users of the applications that are monitored by SLMColumn Name Description Type Precision NullID Unique identifier LONG NoLOGON_NAME User ID VARCHAR 60 YesFIRST_NAME Name of the user VARCHAR 40 NoMIDDLE_NAME Middle name of the user VARCHAR 20 YesLAST_NAME Surname of the user VARCHAR 40 NoEMPLOYEE_NO Employee number VARCHAR 20 YesEMAIL_ADDRESS E-mail address VARCHAR 80 YesLOCATION Descriptive field VARCHAR 80 YesPHONE Telephone number VARCHAR 40 YesFAX Fax number VARCHAR 40 Yes

Chapter 2. Tables 9

Page 16: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Table Name: ENDUSER

Description Users of the applications that are monitored by SLMColumn Name Description Type Precision NullEXT_ID Identifier used on imported rows VARCHAR 80 YesCUSTOMER_ID Foriegn key to the CUSTOMER table LONG NoLAST_MODIFIED TIMESTAMP No

10 IBM Tivoli License Manager: Data Dictionary

Page 17: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Table Name: ENTITLEMENT

Description Components-Customer association (Entitlement)Column Name Description Type Precision NullID Unique identifier LONG NoCOMPONENT_ID Foreign key to the COMPONENT table LONG NoCUSTOMER_ID Foreign key to the CUSTOMER table LONG NoACTIVE Indicates whether or not inventory and

usage tracking is enabled for thecomponent.

SMALLINT No

LICENSE_CONTROL Indicates whether the component usesuser-defined licenses. If not true,default license settings are used.

SMALLINT No

NEED_RESPONSE Indicates whether or not a responsefrom the server is needed to run thecomponent.

SMALLINT No

RUN_OFFLINE Indicates whether the component canrun when the agent is disconnectedfrom the network.

SMALLINT No

LAST_MODIFIED TIMESTAMP No

Table Name: LIC_TARGET_H

Description History of availability of licenses to targetsColumn Name Description Type Precision NullLICENSE_ID Foreign key to the LICENSE table LONG NoTARGET_ID Foreign key to the NODE, AGENT,

DIVISION, or CUSTOMER tableLONG No

START_TIME Date and time when the license becameavailable to the identified target

TIMESTAMP No

END_TIME Date and time when the licensestopped being available to theidentified target

TIMESTAMP No

LAST_MODIFIED TIMESTAMP No

Table Name: LIC_TARGET_REL

Description License enrollments. A license can be enrolled for a customer enterpriseor for one or more targets (divisions, nodes, or agents).

Column Name Description Type Precision NullLICENSE_ID Foreign key to the LICENSE table LONG NoTARGET_ID Foreign key to the NODE, AGENT,

DIVISION, or CUSTOMER tableLONG No

LAST_MODIFIED TIMESTAMP No

Chapter 2. Tables 11

Page 18: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Table Name: LIC_USER_HREL

Description History of availability of licenses to usersColumn Name Description Type Precision NullLICENSE_ID Foreign key to the LICENSE table LONG NoENDUSER_ID Foreign key to the ENDUSER table LONG NoSTART_TIME Date and time when the license became

available to the identified userTIMESTAMP No

END_TIME Date and time when the licensestopped being available to theidentified user

TIMESTAMP No

Table Name: LIC_USER_REL

Description Maps the relationships between licenses and end-users (many to many).Column Name Description Type Precision NullLICENSE_ID Foreign key to the LICENSE table LONG NoENDUSER_ID Foreign key to the ENDUSER table LONG NoLAST_MODIFIED TIMESTAMP No

Table Name: LICENSE

Description Stores license informationColumn Name Description Type Precision NullID Unique identifier LONG NoDESCRIPTION Free text VARCHAR 80 NoCAPACITY_TYPE 0 = Users

1 = Memory2 = Online processors3 = Configured processors4 = Disks

INTEGER No

HARD_STOP Indicates whether the quantity oflicenses is an absolute maximum.

SMALLINT No

MULTI_INSTANCE 0 = No multi-instance licenses1 = Allowed for the same user2 = Allowed for the same user group3 = Allowed for the same node

SMALLINT No

START_DATE Start date of the license pool TIMESTAMP NoEXPIRATION_DATE End date of the license pool TIMESTAMP NoQUANTITY Volume of licenses in the pool INTEGER NoTHRESHOLD Usage threshold for warnings INTEGER NoTARGET_TYPE Indicates the type of enrollment:

1 = Customer enterprise2 = Divisions3 = Nodes4 = Agents

INTEGER No

EXT_ID Identifier used on imported rows VARCHAR 80 Yes

12 IBM Tivoli License Manager: Data Dictionary

Page 19: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Table Name: LICENSE

Description Stores license informationColumn Name Description Type Precision NullENTITLEMENT_ID Foreign key to the ENTITLEMENT

tableLONG No

COMPONENT_ID Foreign key to the COMPONENT table LONG NoCUSTOMER_ID Foreign key to the CUSTOMER

table(redundant)LONG No

LAST_MODIFIED TIMESTAMP No

Chapter 2. Tables 13

Page 20: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Table Name: LICENSE_DISTRIBUTIONDescription Licenses distributed to runtime serversColumn Name Description Type Precision NullSERVER_ID Foreign key to the SERVER table LONG NoLICENSE_ID Foreign key to the LICENSE table LONG NoQUANTITY Volume of licenses INTEGER No

Table Name: LICENSE_H

Description Stores license history informationColumn Name Description Type Precision NullID Unique identifier LONG NoDESCRIPTION Free text VARCHAR 80 NoCAPACITY_TYPE 0 = Users

1 = Memory2 = Online processors3 = Configured processors4 = Disks

INTEGER No

HARD_STOP Indicates whether the quantity oflicenses is an absolute maximum.

SMALLINT No

MULTI_INSTANCE 0 = No multi-instance licenses1 = Allowed for the same user2 = Allowed for the same user group3 = Allowed for the same node

SMALLINT No

START_DATE Start date of the license pool TIMESTAMP NoEXPIRATION_DATE End date of the license pool TIMESTAMP NoQUANTITY Volume of licenses in the pool INTEGER NoTHRESHOLD Usage threshold for warnings INTEGER NoTARGET_ID Indicates the type of enrollment:

1 = Customer enterprise2 = Divisions3 = Nodes4 = Agents

INTEGER No

ENTITLEMENT_ID Foreign key to the ENTITLEMENTtable

LONG No

COMPONENT_ID Foreign key to the COMPONENT table LONG NoCUSTOMER_ID Foreign key to the CUSTOMER

table(redundant)LONG No

START_TIME Date and time when these parametersbecame effective for the license pool

TIMESTAMP No

END_TIME Date and time when these parametersstopped being effective

TIMESTAMP No

14 IBM Tivoli License Manager: Data Dictionary

Page 21: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Table Name: MODULE

Description Stores information about modules used by agents to detect runningapplications. Currently onlyexecutable files are used. A module must belinked to a component through the COMP_MOD_REL table.

Column Name Description Type Precision NullID Unique identifier LONG NoNAME File name VARCHAR 60 NoSIZE File size LONG NoCHECKSUM Not yet used LONG NoOS_NAME Name of the platform (must be

Windows, Unix, or LinuxS390)VARCHAR 10 No

LAST_MODIFIED TIMESTAMP No

Table Name: NODE

Description Machines on which agents are installedColumn Name Description Type Precision NullID Unique identifier LONG NoTYPE Not used IN TEGER YesSERIAL_NUMBER Serial number of the machine VARCHAR 40 YesTAG Machine tag. This is used in agent

deployment.VARCHAR 40 No

PLATFORM Hardware platform VARCHAR 20 YesMEMORY Ram size in Mbytes INTEGER YesDISKS Number of hard-disks drives INTEGER YesSTORAGE Total hard-disk space in Gbytes INTEGER YesCONFIG_PROCS Number of configured processors

installed on the machineINTEGER Yes

ONLINE PROCS Number of online processors installedon the machine

INTEGER Yes

OS390_NODEID Not used CHAR 29 YesLOCATION Free format text VARCHAR 80 YesDESCRIPTION Free format text VARCHAR 80 YesCUSTOMER_ID Foreign key to the CUSTOMER

table(redundant)LONG No

EXT_ID Identifier used on imported rows. VARCHAR 80 YesLAST_MODIFIED TIMESTAMP No

Table Name: OIDDescription Stores the most recent (highest) system-generated number for various

tables throughout the databaseColumn Name Description Type Precision NullLAST_ID Last assigned ID LONG NoTABLE_NAME The name of the table VARCHAR 40 No

Chapter 2. Tables 15

Page 22: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Table Name: PROFILE

Description Administrator profileColumn Name Description Type Precision NullID Unique identifier LONG NoNAME Profile name VARCHAR 20 NoDESCRIPTION Free format text VARCHAR 200 No

Table Name: PROFILE_ACTION

Description Actions not allowed for administrator profileColumn Name Description Type Precision NullPROFILE_ID Foreign key to the PROFILE table LONG NoACTION_KEY Inhibited action VARCHAR 40 NoACTION_VALUE Free format text VARCHAR 20 No

Table Name: SERVER

Description Runtime server informationColumn Name Description Type Precision NullID Unique identifier LONG NoNAME Host name VARCHAR 60 NoADDRESS IP address VARCHAR 60 NoPORT_NUMBER Communication port INTEGER NoPASSWORD Encrypted password to validate

communication requests (encrypted)VARCHAR 40 No

FORCE_SERVICE Force an entire refresh for incrementalservices

CHAR 3 No

DOWNLOAD_PERIOD Milliseconds between data downloadrequests

LONG No

UPLOAD_PERIOD Milliseconds between data uploadrequests

LONG No

UPDATE_PERIOD Milliseconds between server parametersupdate

LONG No

CUSTOMER_ID Foreign key to the CUSTOMER table LONG NoLAST_MODIFIED TIMESTAMP No

Table Name: SERVER_H

Description History of servers. This table maintains a history of changes to servers.An entry is made or updated when a server is added, changed, orremoved.

Column Name Description Type Precision NullID Unique identifier of the server LONG NoNAME Host name VARCHAR 60 NoCUSTOMER_ID Foreign key to the CUSTOMER table LONG NoSTART_TIME Date and time of the start action. TIMESTAMP No

16 IBM Tivoli License Manager: Data Dictionary

Page 23: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Table Name: SERVER_H

Description History of servers. This table maintains a history of changes to servers.An entry is made or updated when a server is added, changed, orremoved.

Column Name Description Type Precision NullSTART_ACTION I = Insert record on server creation.

U = Update server details.CHAR 1 No

END_TIME Date and time of the end action. TIMESTAMP NoEND_ACTION D = Delete server

U = Update server details.CHAR 1 No

Table Name: SERVICE

Description Service requests historyColumn Name Description Type Precision NullSERVICE_ID 1 = Update agent inventor

2 = Update agent information3 = Download topology

LONG No

SERVER_ID ID of the requesting server LONG NoINSERTED Date and time when the row was

insertedTIMESTAMP No

DESCRIPTION Description of the service VARCHAR 80 Yes

Table Name: UNKNOWN

Description Executable files on controlled machines that are not yet recognized byagents.

Column Name Description Type Precision NullID Unique identifier LONG NoNAME File name VARCHAR 60 NoSIZE File size LONG NoCHECKSUM Not yet used LONG NoOS_NAME The name of the operating system on

which the file runsVARCHAR 10 No

PATH Location of the file VARCHAR 200 YesDESCRIPTION Free format text VARCHAR 80 YesVERSION Version of the file VARCHAR 40 YesTEXT1 Free format text VARCHAR 80 YesTEXT2 Free format text VARCHAR 80 YesLAST_MODIFIED TIMESTAMP No

Chapter 2. Tables 17

Page 24: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Table Name: USAGE

Description License usage information. A row is inserted each time a monitoredapplication is launched on a monitored node

Column Name Description Type Precision NullID Unique identifier LONG NoTRAN SACTION_ID An ID is assigned by the runtime

server each time a license is assignedLONG No

SERVER_ID Foreign key to the SERVER table LONG NoLICENSE_ID Foreign key to the LICENSE table LONG NoCOMPONENT_ID Foreign key to the COMPONENT table LONG YesCUSTOMER_ID Foreign key to the CUSTOMER

table(redundant)LONG No

CAPACITY_TYPE 0 = Users1 = Memory2 = Online processors3 = Configured processors4 = Disks

INTEGER Yes

QUANTITY_GRANTED The quantity of licenses assigned INTEGER NoAGENT_ID Foreign key to the AGENT table LONG NoAGENT_HOSTNAME The host name of the machine where

the agent is installedVARCHAR 60 Yes

NODE_ID Foreign key to the NODE table LONG YesDIVISION_ID Foreign key to the DIVISION table LONG YesLOGON_NAME The user ID of the user who started the

applicationVARCHAR 60 No

GROUP_NAME The user group of the user VARCHAR 60 NoSTART_TIME Date and time when the license was

grantedTIMESTAMP No

END_TIME Date and time when the license wasreleased

TIMESTAMP No

Table Name: USAGE_H

Description Aggregated license usage information. The individual transactions storedin the USAGE table are periodically aggregated and moved to this tableto save space.

Column Name Description Type Precision NullLICENSE_ID Foreign key to the LICENSE table LONG NoCOMPONENT_ID Foreign key to the COMPONENT table LONG YesDIVISION_ID Foreign key to the DIVISION table LONG NoCUSTOMER_ID Foreign key to the CUSTOMER table LONG NoDATE Foreign key to the USAGE_H_TIME

tableDATE No

18 IBM Tivoli License Manager: Data Dictionary

Page 25: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Table Name: USAGE_H

Description Aggregated license usage information. The individual transactions storedin the USAGE table are periodically aggregated and moved to this tableto save space.

Column Name Description Type Precision NullCAPACITY_TYPE 0 = Users

1 = Memory2 = Online processors3 = Configured processors4 = Disks

INTEGER Yes

MAX_QUANTITY The maximum quantity of licensesassigned in the transactions that areaggregated

INTEGER No

Table Name: USAGE_H_TIME

Description Available usage snapshots in the USAGE_H tableColumn Name Description Type Precision NullDATE DATE NoWEEKDAY INTEGER NoWEEK INTEGER NoMONTH INTEGER NoQUARTER INTEGER NoYEAR INTEGER No

Table Name: VENDORS

Description Software vendorsColumn Name Description Type Precision NullID Unique identifier LONG NoNAME Name of the software vendor VARCHAR 80 NoWEB_SITE Name of the software vendor VARCHAR 60 NoLAST_MODIFIED TIMESTAMP No

Chapter 2. Tables 19

Page 26: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

20 IBM Tivoli License Manager: Data Dictionary

Page 27: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Chapter 3. IndexesTable Name: ADMIN_CUST_REL

Index Name Unique PrimaryKey

Fields

ADMIN_CUST_PK Yes Yes CUSTOMER_IDADMINISTRATOR

Table Name: ADMINISTRATOR

Index Name Unique PrimaryKey

Fields

ADMINISTRATOR_PK Yes Yes IDADMINISTRATOR_UI Yes No LOGON_NAME

Table Name: AGENT

Index Name Unique PrimaryKey

Fields

AGENT_PK Yes Yes IDAGENT_I1 No No DIVISION_ID

HOSTNAMECUSTOMER_ID

© Copyright IBM Corp. 2001 21

Page 28: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Table Name: AGENT_EVENT

Index Name Unique PrimaryKey

Fields

AGENT_EVENT_PK Yes Yes TIMEAGENT_ID

Table Name: AGENT_INV

Index Name Unique PrimaryKey

Fields

AGENT_INV_PK Yes Yes COMPONENT_IDSTART_TIMEAGENT_ID

Table Name: CATEGORY

Index Name Unique PrimaryKey

Fields

NAME_PK Yes Yes NAME

Table Name: COMMAND

Index Name Unique PrimaryKey

Fields

COMMAND_PK Yes Yes ID

Table Name: COMP_MOD_REL

Index Name Unique PrimaryKey

Fields

COMP_MOD_PK Yes Yes COMPONENT_IDMODULE_ID

Table Name: COMPONENT

Index Name Unique PrimaryKey

Fields

COMPONENT_PK Yes Yes IDCOMPONENT_I1 No No VENDOR_IDCOMPONENT_UI Yes No OS_NAME

VERSIONNAME

22 IBM Tivoli License Manager: Data Dictionary

Page 29: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Table Name: CONTROL

Index Name Unique PrimaryKey

Fields

CONTROL_PK Yes Yes NAME

Table Name: COMPONENT

Index Name Unique PrimaryKey

Fields

COUNTRY_PK Yes Yes ISO_CODE3COUNTRY_UI Yes No NAME

Table Name: CUSTOMER

Index Name Unique PrimaryKey

Fields

CUSTOMER_PK Yes Yes IDCUSTOMER_UI Yes No NAME

Table Name: DIVISION

Index Name Unique PrimaryKey

Fields

DIVISION_PK Yes Yes IDDIVISION_UI Yes No CUSTOMER_ID

NAME

Table Name: ENDUSER

Index Name Unique PrimaryKey

Fields

END_USER_PK Yes Yes IDENDUSER_I No No CUSTOMER_ID

LOGON_NAME

Table Name: ENTITLEMENT

Index Name Unique PrimaryKey

Fields

ENTITLEMENT_PK Yes Yes IDENTITLEMENT_UI Yes No COMPONENT_ID

CUSTOMER_ID

Chapter 3. Indexes 23

Page 30: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Table Name: LIC_TARGET_REL

Index Name Unique PrimaryKey

Fields

LIC_TARGET_PK Yes Yes LICENSE_IDTARGET_ID

Table Name: LIC_USER_REL

Index Name Unique PrimaryKey

Fields

LIC_USER_PK Yes Yes ENDUSER_IDLICENSE_ID

Table Name: LICENSE

Index Name Unique PrimaryKey

Fields

LICENSE_PK Yes Yes IDLICENSE_I No No COMPONENT_ID

CUSTOMER_ID

Table Name: LICENSE_DISTRIBUTION

Index Name Unique PrimaryKey

Fields

LIC_DISTR_PK Yes Yes SERVER_IDLICENSE_ID

Table Name: MODULE

Index Name Unique PrimaryKey

Fields

MODULE_PK Yes Yes IDMODULE_UI Yes No NAME

OS_NAMESIZE

Table Name: NODE

Index Name Unique PrimaryKey

Fields

NODE_PK Yes Yes IDNODE_UI Yes No TAG

CUSTOMER_ID

24 IBM Tivoli License Manager: Data Dictionary

Page 31: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Table Name: OID

Index Name Unique PrimaryKey

Fields

OID_PK Yes Yes TABLE_NAME

Table Name: PROFILE

Index Name Unique PrimaryKey

Fields

PROFILE_PK Yes Yes IDPROFILE_UI Yes No DESCRIPTION

Table Name: PROFILE_ACTION

Index Name Unique PrimaryKey

Fields

PROFILE_ACTION_UI Yes Yes PROFILE_IDACTION_KEY

Table Name: SERVER

Index Name Unique PrimaryKey

Fields

SERVER_PK Yes Yes IDSERVER_UI1 Yes No CUSTOMER_ID

NAMESERVER_UI2 Yes No ADDRESS

CUSTOMER_ID

Table Name: SERVICE

Index Name Unique PrimaryKey

Fields

SERVICE_PK Yes Yes INSERTEDSERVICE_IDSERVER_ID

Table Name: UNKNOWN

Index Name Unique PrimaryKey

Fields

UNKNOWN_PK Yes Yes IDUNKNOWN_UI Yes No NAME

OS_NAMESIZE

Chapter 3. Indexes 25

Page 32: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

Table Name: USAGE

Index Name Unique PrimaryKey

Fields

USAGE_PK Yes Yes IDUSAGE_I1 No No LICENSE_ID

END_TIMEUSAGE_I2 No No CUSTOMER_ID

COMPONENT_IDEND_TIME

USAGE_UI Yes No TRANSACTION_IDSERVER_IDLICENSE_ID

Table Name: USAGE_H

Index Name Unique PrimaryKey

Fields

USAGE_H_PK Yes Yes IDUSAGE_H_UI Yes No HOUR_USAGE

CUSTOMER_IDLICENSE_IDDATE_USAGE

Table Name: VENDOR

Index Name Unique PrimaryKey

Fields

VENDOR_PK Yes Yes IDVENDOR_UI Yes No NAME

26 IBM Tivoli License Manager: Data Dictionary

Page 33: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views
Page 34: IBM Tivoli License Manager: Data Dictionarypublib.boulder.ibm.com/tividd/td/ITLM/GC23-4835-00/en_US/PDF/TLMDDmst.pdf · This data dictionary describes the tables and application views

����

Program Number: 5724-D33

Printed in U.S.A.

GC23-4835-00