ibm tivoli license manager: data...
TRANSCRIPT
IBM Tivoli License Manager
Data Dictionary
Version 1.1
GC23-4835-00
���
IBM Tivoli License Manager
Data Dictionary
Version 1.1
GC23-4835-00
���
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.
Contents
Chapter 1. Overview . . . . . . . . . 1Customer Views . . . . . . . . . . . 1
Chapter 2. Tables . . . . . . . . . . 3
Chapter 3. Indexes . . . . . . . . . 21
© Copyright IBM Corp. 2001 iii
iv IBM Tivoli License Manager: Data Dictionary
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
20 IBM Tivoli License Manager: Data Dictionary
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
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
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
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
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
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
����
Program Number: 5724-D33
Printed in U.S.A.
GC23-4835-00