Tools forVersion ReportingTechnical Note...DB Database Database DV DataView DataView : Component registration Explains about the registration

IBM Tivoli Netcool Performance Manager 1.4Wireline ComponentDocument Revision R2E2

Tools for Version Reporting TechnicalNote

��

NoteBefore using this information and the product it supports, read the information in “Notices” on page 35.

© Copyright IBM Corporation 2006, 2014.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

Contents

Chapter 1. Version reporting tools forTivoli Netcool Performance Manager –Wireline Component . . . . . . . . . 1Versioning terminology . . . . . . . . . . . 1Component registration. . . . . . . . . . . 2

Chapter 2. Using the Netcool/ProvisoInfotool to view version information . . . . 3Using the showVersion command to view versioninformation . . . . . . . . . . . . . . . 3Using the information command to see versioninformation . . . . . . . . . . . . . . . 5Using the dbMgr tool options for version information 5

Chapter 3. Using the dbMgr commandfrom the command line . . . . . . . . 7dbMgr command examples . . . . . . . . . 7

Displaying summary version information for allactive hosts . . . . . . . . . . . . . . 7Removing unwanted version information for alleligible components . . . . . . . . . . . 8Removing all existing version information for aspecific application . . . . . . . . . . . 8Removing all existing version information for aspecific host . . . . . . . . . . . . . 8Removing all version information present for aspecific component . . . . . . . . . . . 8

Chapter 4. Using the dbMgr commandoptions in menu mode . . . . . . . . 11dbMgr tool reporting functions . . . . . . . . 12

versionRptProvisoSummary . . . . . . . . . 12Active Hosts Summary . . . . . . . . . 13Global Component Summary . . . . . . . 14Global component summary with versions . . . 15

versionRptByProvisoHost. . . . . . . . . . 16Component Summary With Versions . . . . . 16Extended Component Info . . . . . . . . 17

versionRptByProvisoApp . . . . . . . . . . 18Component summary with versions . . . . . 19Extended Component Info . . . . . . . . 20

versionRptByProvisoComponent . . . . . . . 21Extended Component Info . . . . . . . . 22Component Detail Records . . . . . . . . 23

Chapter 5. dbMgr maintenancefunctions. . . . . . . . . . . . . . 27versionDeleteProvisoGlobal . . . . . . . . . 27

All Eligible Components . . . . . . . . . 28All Components for an application . . . . . 28All components for a host . . . . . . . . 29

versionDeleteBySingleProvisoComp . . . . . . 30

Chapter 6. dbMgr support functions . . 33versionSupportLevelDump . . . . . . . . . 33

Notices . . . . . . . . . . . . . . 35

© Copyright IBM Corp. 2006, 2014 iii

iv IBM Tivoli Netcool Performance Manager: Tools for Version Reporting Technical Note

Chapter 1. Version reporting tools for Tivoli NetcoolPerformance Manager – Wireline Component

You can use the following reporting tools to get information about the IBM TivoliNetcool Performance Manager, Version 1.4 Wireline Component applicationsinstalled on your system.

Tivoli Netcool Performance Manager – Wireline Component includes the followingreporting tools:v The Netcool/ProvisoInfo tool provides a summary report.v The showVersion command provides product and build summary information

for the DataLoad, DataChannel, and DataMart components.v The information tool lists the version information for the DataView component,

eWAS, and Java™.v The dbMgr tool has some version information options.

Versioning terminologyVersioning terminology describes Applications that are a straightforward mappingof the major product areas and Components which are discrete items within anapplication.

Application

Applications are a straightforward mapping of the major product areas. Examplesof applications are:

AP – Technology Packs

DB – Database

DC – DataChannel

DL – DataLoad

DV – DataView

DM – DataMart

TOOLS – Miscellaneous tools

Components that are registered under the TOOLS application, for example thedbRep utility, are not displayed by the ProvisoInfo tool.You use the dbMgr tool to see detailed information for the TOOLS application.

Component

Components are discrete items within an application. Examples of componentsinclude:

CME.1.1

© Copyright IBM Corp. 2006, 2014 1

LDR.1

MIBS

Database

Components are identified by two labels; the component name and the componentID. The following examples illustrate applications and components.

Table 1. Applications and Components

Application Component Component Name Component ID

DC CME.1.1 CME 1.1

DC LDR.1 LDR 1

AP MIBS MIBS <None>

DB Database Database <None>

DV DataView DataView <servername>:<port>

Component registrationExplains about the registration of components by a database API.

Components are registered by a database API. The call to the database API occursduring installation of the AP and DB applications and during startup for all othercomponents. The database API stores this information in a set of database tables.This centralized information store can then be used for reporting.

Because the implementation of component registration is delayed, there is a delayof up to one hour between the startup of a component and the registration of itsversion in the database. During this period, the older version of a component isstill displayed.

If a component is removed from the configuration, its registration remains in thedatabase until manually removed by using the dbMgr command.

The delay in component registration is caused by a number of factors:v The component registration processes are low priority processes with specified

initial delays before they run and further specified delays for each repeated run.v Both the CNS and CMGR components must be running before any components

are registered and there can be a delay before they are both running.

2 IBM Tivoli Netcool Performance Manager: Tools for Version Reporting Technical Note

Chapter 2. Using the Netcool/ProvisoInfo tool to view versioninformation

Use the Netcool/ProvisoInfo tool procedure to view the version information. TheNetcool/Proviso Info tool displays only summary level version information. TheNetcool/ProvisoInfo tool obtains its information from the Netcool/ProvisoInfoserver daemon that runs on the DataMart computer.

Before you begin

The Netcool/ProvisoInfo server daemon refreshes from the database once a day. Bydefault, this refresh occurs at 4 AM. If you want to refresh the information you areviewing, select DataBase Refresh from the Options menu.1. Log in as pvuser on the server where DataMart is installed.2. Ensure that your display variable is set.3. Change to the DataMart home directory (by default, /opt/datamart).4. Run the DataMart environment file (dataMart.env).

About this task

To run the Netcool/ProvisoInfo tool, follow these steps:

Procedure1. Enter the provisoinfo command.2. Enter the pvm command to start the DataMart application.3. In DataMart, select the Monitor tab and double-click Database Information.

The ProvisoInfo Browser window opens.4. In the left pane, select the Proviso Version folder. Summary version

information for all the registered components displays in the right pane.5. Scroll through the list in the right pane to see the registered components. The

information is grouped and summarized by application. Within eachapplication group, the left column displays the name of the component and theright column displays the version that is registered for that component. Anumber in parentheses means that there is more than one component that isregistered with that version.

Using the showVersion command to view version informationThe showVersion command displays the version information for the DataLoad,DataChannel, and DataMart components that are installed on your system.

Before you begin

The commands for DataLoad (/opt/dataload/bin) and DataChannel(opt/proviso/datachannel/bin) are supported on the AIX, Linux, and Solarisoperating systems.The showVersion command for DataMart (/opt/datamart/bin) is supported on theSolaris operating system only.


About this task

To run the showVersion command:

Procedure1. Log in as pvuser on the server where the DataLoad, DataChannel, or DataMart

is installed.2. Ensure that your display variable is set.3. To run the environment file for the component, enter the command:

. /opt/component_name/environment_filename

v component_name is DataLoad, DataChannel, or DataMart.v env_filename is DataLoad.env, DataChannel.env, or DataMart.env

4. Enter the showVersion command. The product and build versioning informationfor the component displays.Example output for DataLoad:PRODUCT VERSION : 1.4.0.0COMPILATION NUMBER : 1373

Binaries :/opt/dataload/bin/pvmd_3002 1.4.0.0-33.1/opt/dataload/bin/confReload 1.4.0.0-33/opt/dataload/bin/dbRep 1.4.0.0-33/opt/dataload/bin/formGet 1.4.0.0-33/opt/dataload/bin/pvCrypt 1.4.0.0-33/opt/dataload/bin/pvmdctrl 1.4.0.0-33/opt/dataload/bin/pvIpDisc 1.4.0.0-33/opt/dataload/bin/qPing 1.4.0.0-33/opt/dataload/bin/snmpGet 1.4.0.0-33/opt/dataload/bin/snmpSet 1.4.0.0-33/opt/dataload/bin/statGet 1.4.0.0-33/opt/dataload/bin/watchd 1.4.0.0-33

Libraries :/opt/dataload/lib/libpvmd.so 1.4.0.0-33

Example output for DataLoad:Binaries :/opt/datamart/bin/arcget: PV_20140320/opt/datamart/bin/dbMgr: PV_20140320/opt/datamart/bin/frozen2oid: PV_20140320/opt/datamart/bin/snmptrap: PV_20140320

Libraries :/opt/datamart/lib/Tktable.so: PV_20140320/opt/datamart/lib/bofFileLib.so: PV_20140320/opt/datamart/lib/libBLT24.so: PV_20140320/opt/datamart/lib/libBLTlite24.so: PV_20140320/opt/datamart/lib/libSnmpStack.so: PV_20140320/opt/datamart/lib/libbsdnls1.0.so: PV_20140320/opt/datamart/lib/libcOracle.so: PV_20140320/opt/datamart/lib/libcmu.so: PV_20140320/opt/datamart/lib/libcontainers.so: PV_20140320/opt/datamart/lib/libitcl3.2.so: PV_20140320/opt/datamart/lib/libmultiTask.so: PV_20140320/opt/datamart/lib/libpcre.so: PV_20140320/opt/datamart/lib/libtcl8.3.so: PV_20140320/opt/datamart/lib/libtclOracle.so: PV_20140320/opt/datamart/lib/libtclx8.3.so: PV_20140320/opt/datamart/lib/libtk8.3.so: PV_20140320/opt/datamart/lib/noteBook.so: PV_20140320


Using the information command to see version informationThe information command displays the versions of the DataView component, theDashboard Application Services Hub, the WebSphere Application Server, and theJava Runtime Environment (JRE).

About this task

To run the information command, follow these steps:

Procedure1. Log in to the server where Jazz for Service Management is installed.2. Change to the <JazzSM_HOME>/products/tnpm/dataview/bin directory.3. Enter the information command:

UNIX or Linuxinformation.sh -dashuser <DASH_admin_user> -dashpassword <DASH_admin_password>

Windowsinformation.bat –dashuser <DASH_admin_user>-dashpassword <DASH_admin_password>

Where:v <DASH_admin_user> is the name of a Dashboard Application Services Hub

user.v <DASH_admin_password> is the password for the Dashboard Application

Services Hub user.Version information similar to the following output is displayed:GYMVC0024I: DataView Version: 1.4.0.0GYMVC0026I: DataView Build Number: 102GYMVC0025I: DataView Build Date: 2010_08_19 06:44:39

GYMVC0027I: JazzSM Version: 1.1.0.3GYMVC0028I: eWAS Version: 7.0.0.11GYMVC0029I: Java Version: 1.6.0_17

4. Optional: If you need more detailed version information for the TivoliIntegrated Portal, use the tipcli command with the Version and SystemInfooptions. For information about the tipcli command, refer to the TivoliIntegrated Portal customer documentation.

Using the dbMgr tool options for version informationYou can run the dbMgr tool from the command line or in menu mode. The dbMgrcommand reporting, maintenance, and support options provide versioninformation.v Reporting options display summary and detailed version information. The dbMgr

command reporting options are:– versionRptByProvisoApp

– versionRptByProvisoComponent

– versionRptByProvisoHost

– versionRptProvisoSummary

v Maintenance options clean up information about orphaned components. Thesystem depends on each component to complete a delete call duringuninstallation. However, if a component is manually removed withoutperforming the uninstallation function, it can create an orphaned component.The dbMgr command maintenance options are:

Chapter 2. Using the Netcool/ProvisoInfo tool to view version information 5

– versionDeleteBySingle-ProvisoComp

– versionDeleteProvisoGlobal

v The support option can save version information into a file on the databaseserver. Typically, you use this function at the request of IBM support. The dbMgrcommand support option is:– versionSupportLevelDump


Chapter 3. Using the dbMgr command from the command line

Describes how to run a dbMgr command from the command line.

Before you begin

The component name is listed first in a component label. Read the part of the labelbefore the first dot (.) as the component name. The component ID can havemultiple parts. For example, in DataView .<server_name>:<port_number>, thecomponent name is DataView and the component ID is.<server_name>:<port_number>. In SNMP.1.1, the component name is SNMP andthe component ID is 1.1.

About this task

Enter the dbMgr command together with the function and any options on a singlecommand line.

To run the dbMgr command, follow these steps:

Procedure1. Log in as pvuser on the server where the DataMart component is running.2. Source the environment file for the DataMart by using the following command:

. /opt/datamart/dataMart.env

3. Run dbMgr functions by using the following command:dbMgr <function> <options>

4. Get the usage information for any of the functions by entering the followingcommand:dbMgr usage <function>

dbMgr command examplesIllustrates the dbMgr command examples.

These examples illustrate the usage of the dbMgr command. For detailedinformation about using dbMgr from the command line, see the IBM Tivoli NetcoolPerformance Manager: Database Administration.

Displaying summary version information for all active hostsUse the versionRptProvisoSummary to display summary version information for allthe active hosts.

You can use the versionRptProvisoSummary report with the Active Hosts Summaryoption.

From the command line, enter this command:$ dbMgr versionRptProvisoSummary H


Removing unwanted version information for all eligiblecomponents

Remove unwanted version information for all eligible components by usingversionDeleteProvisoGlobal with the Delete All Components option.

You can use versionDeleteProvisoGlobal with the Delete All Components option.This command must be used at the direction of IBM Support.

From the command line, enter this command:$ dbMgr versionDeleteProvisoGlobal C----------------------------------------------result : 0All system components have been marked as deleted----------------------------------------------$Remove all version information present for a specific application

Removing all existing version information for a specificapplication

Remove all existing version information for a specific application by usingversionDeleteProvisoGlobal with the All Components For An Application option.

You can use versionDeleteProvisoGlobal with the All Components For AnApplication option. This command must be used at the direction of IBM Support.

From the command line, enter this command:$ dbMgr versionDeleteProvisoGlobal A {AP|DB|DC|DL|DM|DV|TOOLS}

Removing all existing version information for a specific hostRemove all existing version information for a specific host by usingversionDeleteProvisoGlobal with All Components For A (H)ost option.

You can use versionDeleteProvisoGlobal with All Components For A (H)ostoption. This command must be used at the direction of IBM Support.

The only allowed characters for <hostname> are 'A'-'Z,' 'a'-'z,' '0'-'9,' '. ', , '-', and '_'.

From the command line, enter this command:dbMgr versionDeleteProvisoGlobal H <hostname>

Removing all version information present for a specificcomponent

Remove all version information present for a specific component by usingversionDeleteBySingleComp and by specifying the component.

You can use versionDeleteBySingleComp and specify the component. Thiscommand must be used at the direction of IBM Support.

The component name is a single value. Always read the part of the string beforethe first dot as the component name. The component ID can have multiple parts.For example, in DataView.<server_name>:<port_number> the component name isDataView and the component ID is .<server_name>:<port_number>.


The only allowed characters for <componentname> are 'A'-'Z,' 'a'-'z,' '0'-'9,' '. ', , '-',and '_'.

From the command line, enter this command:dbMgr versionDeleteBySingleComp DataView <servername>:<port>

Chapter 3. Using the dbMgr command from the command line 9


Chapter 4. Using the dbMgr command options in menu mode

Use the dbMgr command options in the menu mode to launch dbMgr tool.

About this task

To launch the dbMgr tool, follow these steps:

Procedure1. Log in to the DataMart server as the DataMart software owner (default pvuser).2. Change directory to the DataMart software home (default /opt/datamart).3. Run the DataMart environment file (dataMart.env)4. Enter dbMgr. The dbMgr menu displays.

Netcool/Proviso DataMart (1.2.1)Licensed Materials - Property of IBM5724-T61, 5724-P55, 5724-P57, 5724-P58, 5724-P59© Copyright IBM Corporation 2000, 2007. All Rights Reserved.US Government Users Restricted Rights - Use, duplication or disclosurerestricted by GSA ADP Schedule Contract with IBM Corp.

List of Procedures

1. adjustDataloadsTempTablespace2. alterTablespaceReadOnly3. analyzeMetaDataTables4. deleteOffHoursPeriod5. generateFilesColdBackup6. insertOffHoursPeriod7. monitorFileSystem8. monitorTablespaces9. purgePartitions10. resizeTablespaceFile11. selectOffHoursPeriod12. showDBPackageVersions13. showPurgeablePartitions14. showTablespaceFiles15. versionDeleteBySingleProvisoComp16. versionDeleteProvisoGlobal17. versionRptByProvisoApp18. versionRptByProvisoComponent

Q. Quit P. Previous N. Next

Choice:

5. To see the options on the Next menu, enter N.


Netcool/Proviso DataMart (1.2.1)Licensed Materials - Property of IBM5724-T61, 5724-P55, 5724-P57, 5724-P58, 5724-P59© Copyright IBM Corporation 2000, 2007. All Rights Reserved.US Government Users Restricted Rights - Use, duplication or disclosurerestricted by GSA ADP Schedule Contract with IBM Corp.

List of Procedures

1. generateFilesColdBackup2. insertOffHoursPeriod3. monitorFileSystem4. monitorTablespaces5. purgePartitions6. resizeTablespaceFile7. selectOffHoursPeriod8. showDBPackageVersions9. showPurgeablePartitions10. showTablespaceFiles11. versionDeleteBySingleProvisoComp12. versionDeleteProvisoGlobal13. versionRptByProvisoApp14. versionRptByProvisoComponent15. versionRptByProvisoHost16. versionRptProvisoSummary17. versionSupportLevelDump

Q. Quit P. Previous N. Next

Choice :

6. Enter a number to access the associated function.

dbMgr tool reporting functionsVarious dbManager tool reporting options.

The dbMgr reporting options are as follows:v versionRptProvisoSummary

v versionRptByProvisoHost

v versionRptByProvisoApp

v versionRptByProvisoComponent

versionRptProvisoSummaryversionRptProvisoSummary command produces the global summary level reportsfor the system.

This function provides global summary level reports for the system that gives thefollowing information:v Host And IP Summary - lists the host names in the system that currently are

registered componentsv Component Summary - provides a complete component summary for the entire

systemv Component Version Summary - provides a complete component version

summary for the entire system

Examples of these reports are as follows:


When you select the versionRptProvisoSummary function, the following menu isdisplayed:(c) Netcool/Proviso DataMart(1.2.1)Procedure : versionRptProvisoSummary

argument value-------- -----1. Report Type

B. Back P. Previous N. Next E. ExecuteChoice :

Enter 1 to view the three available report types.(c) Netcool/Proviso DataMart(1.2.1)Procedure : versionRptProvisoSummaryParameter : Report Type : Active (H)osts Summary, Global Component (S)ummary,Global Component Summary With (V)ersionsCurrent value :

Value :

Select a report option:v H for the “Active (H)osts Summaryv S for the “Global Component (S)ummaryv V for the “Global Component Summary With (V)ersions

Active Hosts SummaryExplains how to use the Active Hosts Summary report.

When you select the Active (H)osts Summary report, this menu is displayed:(c) Netcool/Proviso DataMart(1.2.1)Procedure : versionRptProvisoSummary

argument value-------- -----1. Report Type H

B. Back P. Previous N. Next E. Execute

Choice :

Enter E to run the report. When prompted, enter y to confirm your choice and thereport is displayed:(c) Netcool/Proviso DataMart(1.2.1)----------------------------------------------result : 0Host Name Host IP----------------------------------------------MACHINE_1 192.168.1.100MACHINE_2 192.168.1.101MACHINE_3 192.168.1.102

----------------------------------------------

[Enter] to quit:

This report provides a global summary of each active host and its IP address (ifavailable).

Chapter 4. Using the dbMgr command options in menu mode 13

Global Component SummaryExplains how to use the Global Component Summary report.

When you run the Global Component (S)ummary report, theversionRptProvisoSummary menu is displayed:(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptProvisoSummary

argument value-------- -----1. Report Type S


Choice:

Enter E to run the report. When prompted, enter y to confirm your choice and thereport is displayed:(c) Netcool/Proviso DataMart(1.2.1)----------------------------------------------result: 0Application Component Count----------------------------------------------------AP BASE 1AP FRAME 1AP METRICS 1AP MIB2 1AP MIBS 1AP THRESHOLDS 1DB Database 1DC AMGR 3DC AMGRW 3DC CME 3DC CMGR 1DC CMGRW 1DC CNS 1DC CNSW 1DC DG 1DC DISC 1DC DLDR 1DC FTE 3DC LDR 1DC LOG 1DC LOGW 1DL BCOL 1DL SNMP 2DM FED 1DM PVM 1DV DataView 1DV exteNd Application Server 1

----------------------------------------------[Enter] to quit:

This report provides a global summary of each component name with a count ofthe number of component IDs for that name.


Global component summary with versionsUse the Global Component Summary with Versions report to display theversionRptProvisoSummary menu.

When you run the Global Component Summary With (V)ersions report, theversionRptProvisoSummary menu is displayed:(c) Netcool/Proviso DataMart(1.2.1)Procedure : versionRptProvisoSummary

argument value-------- -----1. Report Type V


Choice :

Enter E to run the report. When prompted, enter y to confirm your choice and thereport is displayed:

(c)Netcool/Proviso DataMart(1.2.1)

---------------------------------------------------------------------result : 0Application Component Version Count----------------------------------------------------------------------AP BASE 4.2-A 1AP FRAME 4.2-A 1AP METRICS 4.2-A 1AP MIB2 4.2-A 1AP THRESHOLDS 4.2-A 1DB Database 4.2 R2E1 1DC AMGR 4.2 R2E2 3DC CME 4.2 R2E2 3DC CMGR 4.2 R2E2 1DC CNS 4.2 R2E2 1DC DG 4.2 R2E2 1DC DISC 4.2 R2E2 1DC DLDR 4.2 R2E2 1DC FTE 4.2 R2E2 3DC LDR 4.2 R2E2 1DC LOG 4.2 R2E2 1DL BCOL 4.2 R2E2 1DL SNMP 4.2 R2E1 2DM FED 4.2 R2E2 1DM PVM 4.2 R2E1 1DV DataView 4.2 R0E11 1DV exteNd Application Server 4.0.0f 1

----------------------------------------------[Enter] to quit

This report provides a global summary of each component name and version witha count of the number of component IDs for that name and version.


versionRptByProvisoHostThe versionRptByProvisoHost command explains the version information for aparticular host.

This function provides version information reports for a particular host that hasthe following information:v Component Version Summary Information - provides component summary for

the host you specifyv Detailed Component Information - provides a detailed list of the current

versions for all components on the host you specify

Examples of these reports are contained in the following information.

When you select the versionRptByProvisoHost function, theversionRptByProvisoHost menu is displayed:

(c) Netcool/Proviso DataMart(1.2.1)

(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoHost

argument value-------- -----1. Report Type2. Host Name


Choice:

Enter 1 to see the available report types.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoHostParameter: Report Type: Component Summary With (V)ersions or (E)xtendedComponent InfoCurrent value:

Value:

Select a report type:v Enter V for the Component Summary With (V)ersionsv Enter E for the (E)xtended Component Info

Component Summary With VersionsUse the Component Summary with Versions report to displayversionRptByProvisoHost menu.1. Select the Component Summary With (V)ersions report. The

versionRptByProvisoHost menu is displayed:(c) Netcool/Proviso DataMart(1.2.1)Procedure : versionRptByProvisoHost

argument value-------- -----1. Report Type V2. Host Name



Choice :

2. Enter 2 for the host name.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoHostParameter: Host Name: The host name you wish to run the report forCurrent value:

Value:

3. Enter the host name.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoHost

argument value-------- -----1. Report Type V2. Host Name MACHINE_1


Choice:

4. Enter E to run the report. When prompted, enter y to confirm your choice andthe report is displayed:(c) Netcool/Proviso DataMart(1.2.1)----------------------------------------------result:0Host Name: MACHINE_1

Application Component Version Count----------------------------------------------------------AP BASE 4.2-A 1AP FRAME 4.2-A 1AP METRICS 4.2-A 1AP MIB2 4.2-A 1AP THRESHOLDS 4.2-A 1DB Database 4.2 R2E1 1DC AMGR 4.2 R2E2 1DC DISC 4.2 R2E2 1DM PVM 4.2 R2E1 1

---------------------------------------------------------

[Enter] to quit:

This report provides a summary of each component name and version on the hostthat you specified, with a count of the number of component IDs for that nameand version.

Extended Component InfoUse the Extended Component Info to display versionRptByProvisoHost menu.1. Select the “(E)xtended Component Info” report. The versionRptByProvisoHost

menu is displayed:(c) Netcool/Proviso DataMart(1.2.1)

Procedure : versionRptByProvisoHost

argument value-------- -----1. Report Type E2. Host Name



Choice :

2. Enter 2 for the host name.(c) Netcool/Proviso DataMart(1.2.1)

Procedure : versionRptByProvisoHostParameter : Host Name : The host name you wish to run the report forCurrent value :

Value :

3. Enter the host name. The versionRptByProvisoHost menu is displayed:(c) Netcool/Proviso DataMart(1.2.1)

Procedure : versionRptByProvisoHost

argument value-------- -----1. Report Type E2. Host Name MACHINE_1


Choice :

4. Enter E to run the report. When prompted, enter y to confirm your choice andthe report is displayed:(c) Netcool/Proviso DataMart(1.2.1)

----------------------------------------------result : 0Host Name: MACHINE_1

Application Component Version Build Registration Date--------------------------------------------------------------------------------------AP BASE 4.2-A 4.2-A 2004.05.11 13:35:34AP FRAME 4.2-A 4.2-A 2004.05.11 13:37:07AP METRICS 4.2-A 4.2-A 2004.05.11 13:36:27AP MIB2 4.2-A 4.2-A 2004.05.11 13:36:54AP THRESHOLDS 4.2-A 4.2-A 2004.05.11 13:36:35DB Database 4.2 R2E1 1270 2004.05.10 22:06:37DC AMGR.MACHINE_1 4.2 R2E2 Devon.78 2004.05.18 19:38:02DC DISC. MACHINE_1.1 4.2 R2E2 Devon.78 2004.05.18 19:38:02DM PVM.MACHINE_1 4.2 R2E1 1270 2004.05.10 23:00:04

----------------------------------------------

[Enter] to quit :

This report gives you a detailed listing of each component, version, build numberand registration date for the host that you specified.

versionRptByProvisoAppThe versionRptByProvisoApp command provides either a summary or detailedreport on the version of a particular application.

This function reports the following version information for a particular application:v Component Version Summary Information - provides a component summary for

the application you specifyv Detailed Component Information - provides a detailed list of the current

versions for all components for the application you specify


Examples of these reports are provided. When you select theversionRptByProvisoApp function, versionRptByProvisoApp menu is displayed:(c) Netcool/Proviso DataMart(1.2.1)Procedure : versionRptByProvisoApp

argument value-------- -----1. Report Type2. Application


Choice :

Enter 1 to view the list of available report types.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoAppParameter: Report Type: Component Summary With (V)ersions or (E)xtended Component InfoCurrent value:

Value:

There are two available report types. Enter V for the Component Summary With(V)ersions report. Enter E for the (E)xtended Component Info report.

Component summary with versions1. Select the Component Summary With (V)ersions report. The

versionRptByProvisoApp menu is displayed:(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoApp

argument value-------- -----1. Report Type V2. Application


Choice:

2. Enter 2 for the application name.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoAppParameter: Application: The application you wish to run the report for( AP, DB, DC, DL, DM, DV or TOOLS )Current value:

Value:

3. Enter the application name.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoApp

argument value-------- -----1. Report Type V2. Application DC


Choice:

4. Enter E to run the report. When prompted, enter y to confirm your choice andthe report is displayed:


(c) Netcool/Proviso DataMart(1.2.1)----------------------------------------------result: 0Application: DC

Component Version Count--------------------------------------AMGR 4.2 R2E2 3CME 4.2 R2E2 3CMGR 4.2 R2E2 1CNS 4.2 R2E2 1DISC 4.2 R2E2 1DLDR 4.2 R2E2 1FTE 4.2 R2E2 3LDR 4.2 R2E2 1LOG 4.2 R2E2 1----------------------------------------[Enter] to quit:

This report provides a summary of each component name and version for theapplication that you specified, with a count of the number of component IDs forthat name and version,

Extended Component InfoUse the Extended Component Info report to display versionRptByProvisoAppmenu.1. Select the “(E)xtended Component Info” report. The versionRptByProvisoApp

menu is displayed:(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoApp

argument value-------- -----1. Report Type E2. Application


Choice:

2. Enter 2 for the application name.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoAppParameter: Application: The application you wish to run the report for( AP, DB, DC, DL, DM, DV or TOOLS )Current value:

Value:

3. Enter the application name.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoApp

argument value-------- -----1. Report Type E2. Application DC


Choice:

4. Enter E to run the report. When prompted, enter y to confirm your choice andthe report is displayed:


(c) Netcool/Proviso DataMart(1.2.1)----------------------------------------------result: 0Application: DC

Component Version Build Registration Date------------------------------------------------------------------------------AMGR.MACHINE_1 4.2 R2E2 Devon.78 2004.05.18 19:38:02AMGR.MACHINE_2 4.2 R2E2 Devon.78 2004.05.18 19:38:02AMGR.MACHINE_3 4.2 R2E2 Devon.78 2004.05.18 19:38:02CME.1.2 4.2 R2E2 Devon.78 2004.05.18 19:38:01CME.1.1 4.2 R2E2 Devon.78 2004.05.18 19:38:01CME.1.100 4.2 R2E2 Devon.78 2004.05.18 19:38:02CMGR.MACHINE_3 4.2 R2E2 Devon.78 2004.05.18 19:38:01CNS.MACHINE_3 4.2 R2E2 Devon.78 2004.05.18 19:38:02DISC.MACHINE_1.1 4.2 R2E2 Devon.78 2004.05.18 19:38:02DLDR.1 4.2 R2E2 Devon.78 2004.05.18 19:38:02FTE.1.1 4.2 R2E2 Devon.78 2004.05.18 19:38:01FTE.1.100 4.2 R2E2 Devon.78 2004.05.18 19:38:01FTE.1.2 4.2 R2E2 Devon.78 2004.05.18 19:38:02LDR.1 4.2 R2E2 Devon.78 2004.05.18 19:38:02LOG.MACHINE_3 4.2 R2E2 Devon.78 2004.05.18 19:38:02-------------------------------------------------------------------------------[Enter] to quit:

This report provides a detailed listing of each component, version, build numberand registration date for the application that you specified.

versionRptByProvisoComponentThe versionRptByProvisoComponent command reports the version information for aparticular component.

This function reports the following version information for a particular component:v Detailed Component Information - provides the version for a specific componentv Component Details - provides the detail records associated to a specific

component

Examples of these reports are provided. When you select theversionRptByProvisoComponent function, the versionRptByProvisoComponent menuis displayed:(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoComponent

argument value-------- -----1. Report Type2. Application3. Component Name4. Component Id Null


Choice:

Enter 1 to view the list of available report types.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoComponentParameter: Report Type: (E)xtended Component Info or Component (D)etail RecordsCurrent value:

Value:


Select options from the two available reports:v Enter E for (E)xtended Component Infov Enter D for Component (D)etail Records

Extended Component InfoUse the Extended Component Info to display the versionRptByProvisoComponentmenu.1. Select the “(E)xtended Component Info” report. The

versionRptByProvisoComponent menu is displayed:(c) Netcool/Proviso DataMart(1.2.1)Procedure : versionRptByProvisoComponent

argument value-------- -----1. Report Type E2. Application3. Component Name4. Component Id Null


Choice:

2. Enter 2 for the application name.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoComponentParameter: Application: The application for which you wish to run the report( AP, DB, DC, DL, DM, DV or TOOLS )Current value:

Value:

3. Enter the application name.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoComponent

argument value-------- ------1. Report Type E2. Application DC3. Component Name4. Component Id Null


Choice :

4. Enter 3 for the component name.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoComponentParameter: Component Name: Name of the component (e.g. CME)Current value:

Value:

5. Enter the component name.(c) Netcool/Proviso DataMart(1.2.1)

(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoComponent

argument value-------- -----1. Report Type E2. Application DC


3. Component Name LDR4. Component Id Null


Choice:

If the component has an ID, enter 4. If not, leave the component ID as Null.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoComponentParameter: Component Id: Id of the component (e.g. 1.2) -For a component that does not have an id, use the word "Null"Current value: Null

Value:

6. Enter the component ID.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoComponent

argument value-------- -----1. Report Type E2. Application DC3. Component Name LDR4. Component Id 1


Choice:

Enter E to run the report. When prompted, enter y to confirm your choice andthe report is displayed:(c) Netcool/Proviso DataMart(1.2.1)----------------------------------------------result: 0Application: DCComponent: LDR.1

Version Build Registration Date---------------------------------------------------------4.2 R2E2 Devon.78 2004.05.18 19:38:02

-----------------------------------------------------[Enter] to quit:

This report provides the version, build number and registration date for thecomponent you specified.

Component Detail RecordsUse Component Detail Records to display the versionRptByProvisoComponentmenu.1. Select the Component (D)etail Records report. The

versionRptByProvisoComponent menu is displayed:(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoComponent

argument value-------- -----1. Report Type D2. Application3. Component Name4. Component Id Null



Choice:

2. Enter 2 for the application name.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoComponentParameter: Application: The application for which you wish to run the report( AP, DB, DC, DL, DM, DV or TOOLS )Current value:

Value:

Enter the application name.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoComponent

argument value-------- -----1. Report Type D2. Application DC3. Component Name Nul4. Component Id l

B. Back P. Previous N. Next E. ExecuteChoice:

3. Enter 3 for the component name.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoComponentParameter: Component Name : Name of the component (e.g. CME)Current value:

Value:

4. Enter the component name.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoComponent

argument value-------- -----1. Report Type D2. Application DC3. Component Name LDR4. Component Id Null


Choice:

If the component has an ID, enter 4. If not, leave the component ID as Null.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoComponentParameter: Component Id : Id of the component (e.g. 1.2) -For a component that does not have an id, use the word "Null"Current value: Null

Value:

5. Enter the component ID.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionRptByProvisoComponent

argument value-------- -----1. Report Type D2. Application DC


3. Component Name LDR4. Component Id 1


Choice:

6. Enter E to run the report. When prompted, enter y to confirm your choice andthe report is displayed:(c) Netcool/Proviso DataMart(1.2.1)----------------------------------------------result: 0No details for this component

----------------------------------------------[Enter] to quit:

For this release, most applications are not yet registering detail information. Infuture release, applications will provide details through this report. Forexample, the Database application is registering patches to the database in thismanner.



Chapter 5. dbMgr maintenance functions

The dbManager maintenance functions help the management of versioninformation in case an orphaned component is created.

Orphaned components can sometimes exist. The system depends on eachcomponent to complete a delete call on uninstall. However, if a component ismanually removed without performing the uninstall function, an orphanedcomponent is created. To help the management of version information in thesecases, there are several management functions available.

versionDeleteProvisoGlobalThe versionDeleteProvisoGlobal command explains about the global deletemethods.

This function provides three global delete methods:v Delete All Components - marks all components as deletedv Delete All Components For Application - marks all components for a specific

application type as deletedv Delete All Components For Host - marks all components for a specific host

name as deleted

Examples of these functions follow. When you select theversionDeleteProvisoGlobal function, the versionDeleteProvisoGlobal menu isdisplayed:(c) Netcool/Proviso DataMart(1.2.1)Procedure : versionDeleteProvisoGlobal

argument value-------- -----1. Delete Type2. Delete Information


Choice :

1. Enter 1 to view the list of available delete types.(c) Netcool/Proviso DataMart(1.2.1)Procedure : versionDeleteProvisoGlobalParameter : Delete Type : All Eligible (C)omponents,All Components For An (A)pplication, All Components For A (H)ostCurrent value :

Value :

2. Select from among the three available delete types:v C for the All Eligible (C)omponentsv A for the All Components For An (A)pplicationv H for the All Components For A (H)ost


All Eligible ComponentsUse All Eligible Components to display the versionDeleteProvisoGlobal menu.1. Select All Eligible (C)omponents. The versionDeleteProvisoGlobal menu is

displayed:(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionDeleteProvisoGlobal

argument value-------- -----1. Delete Type C2. Delete Information


Choice:

When you perform a delete of this type, no further information is needed. Ifany information is supplied in item 2, it is ignored. When you execute thisdelete type, every component in the system that registers versions at run timeis marked as Deleted. That means that every component in the DC, DM, DV,DL, and TOOLS applications are marked as Deleted. However, the next timeyou start those components, they will be reregistered with their current version.

2. Enter E to run the delete. When prompted, enter y to confirm your choice andthe results are displayed:(c) Netcool/Proviso DataMart(1.2.1)----------------------------------------------result: 0All system components have been marked as deleted

----------------------------------------------[Enter] to quit:

All Components for an applicationAll Components for an Application helps you to perform aversionDeleteProvisoGlobal delete for an application.1. Select All Components For An (A)pplication:

(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionDeleteProvisoGlobal

argument value-------- -----1. Delete Type A2. Delete Information


Choice:

When you perform a delete of this type, you must supply the name of theapplication in item 2. When you are executing this delete type, everycomponent in the system that registers versions at run time and is a member ofthe application you specify is marked as deleted. The next time that you startthose components, they will register with their current version. When youselect item 2, a menu like this is displayed:(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionDeleteProvisoGlobalParameter: Delete Information: Either the host name or application


( AP, DB, DC, DL, DM, DV or TOOLS ).This argument is ignored for a "Delete Type" of"All Eligible (C)omponents"Current value:

Value:

2. Enter the application name.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionDeleteProvisoGlobal

argument value-------- -----1. Delete Type A2. Delete Information DM


Choice:

3. Enter E to run the delete function. When prompted, enter y to confirm yourchoice and the results are displayed:(c) Netcool/Proviso DataMart(1.2.1)----------------------------------------------result: 0All components for application DM have been marked as deleted

----------------------------------------------[Enter] to quit:

All components for a host1. Select All Components For A (H)ost function and press Enter. The

versionDeleteProvisoGlobal menu is displayed:(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionDeleteProvisoGlobal

argument value-------- -----1. Delete Type H2. Delete Information


Choice:

When you perform a delete of this type, you must supply the name of the hostin item 2. When you run this delete type, every component in the system thatregisters versions at run time and is on the host you specify is marked asDeleted. The next time that you start those components, they will register withtheir current version. When you select item 2, the following menu is displayed:(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionDeleteProvisoGlobalParameter: Delete Information : Either the host name or application( AP, DB, DC, DL, DM, DV or TOOLS ).This argument is ignored for a "Delete Type" of"All Eligible (C)omponents"Current value:

Value:

2. Enter the host name. The only allowed characters for the host name are: 'A'-'Z,''a'-'z,' '0'-'9,' '. ', , '-', and '_'(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionDeleteProvisoGlobal

argument value-------- -----

Chapter 5. dbMgr maintenance functions 29

1. Delete Type H2. Delete Information MACHINE_1


Choice:

3. Enter E to run the delete function. When prompted, enter y to confirm yourchoice and the results are displayed:(c) Netcool/Proviso DataMart(1.2.1)----------------------------------------------result: 0All components for host MACHINE_1 have been marked as deleted

----------------------------------------------[Enter] to quit:

versionDeleteBySingleProvisoCompThe versionDeleteBySingleProvisoComp command deletes the version informationfor a specific component.

This function deletes the version information for a specific component. Thisfunction performs the following actions:v Delete Specific Component - marks a specific component as deleted

For example, when you select the versionDeleteBySingleProvisoComp function, theversionDeleteBySingleProvisoComp menu is displayed:(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionDeleteBySingleProvisoComp

argument value-------- -----1. Application2. Component Name3. Component Id Null


Choice:

1. Enter 1 for the application name.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionDeleteBySingleProvisoCompParameter: Application: The application ( AP, DB, DC, DL, DM, DV or TOOLS )Current value:

Value:

2. Enter the application name.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionDeleteBySingleProvisoComp

argument value-------- -----1. Application DC2. Component Name3. Component Id Null


Choice:

3. Enter 2 for the component name.


(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionDeleteBySingleProvisoCompParameter: Component Name: Name of the component (e.g. CME)Current value:

Value:

4. Enter the component name. The component name is a single value. Alwaysread the part of the string before the first dot as the component name. The onlyallowed characters for the component name are 'A'-'Z,' 'a'-'z,' '0'-'9,' '. ', , '-', and'_'.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionDeleteBySingleProvisoComp

argument value-------- -----1. Application DC2. Component Name CME3. Component Id Null


Choice:

If the component has an ID, enter 3. If not, leave the component ID as Null.The component ID can have multiple parts. For example, inDataView.<server_name>:<port_number> the component name is DataView andthe component ID is <server_name>:<port_number>.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionDeleteBySingleProvisoCompParameter: Component Id : Id of the component (e.g. 1.2) -For a component that does not have an id, use the word "Null"Current value: Null

Value:

5. Enter the component ID.(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionDeleteBySingleProvisoComp

argument value-------- -----1. Application DC2. Component Name CME3. Component Id 1.1


Choice:

Enter E to run the delete function. When prompted, enter y to confirm yourchoice and the results are displayed:(c) Netcool/Proviso DataMart(1.2.1)----------------------------------------------result: 0Component has been marked as deleted

----------------------------------------------[Enter] to quit:

Chapter 5. dbMgr maintenance functions 31


Chapter 6. dbMgr support functions

dbMgr Support Functions provide you the version information by using theversionSupportLevelDump function.

If you provide version information to IBM support, use theversionSupportLevelDump function. This command must be used at the direction ofIBM Support.

versionSupportLevelDumpThe versionSupportLevelDump command writes all the version information into afile on the database server in the $ORACLE_BASE/diag/rdbms/pv/PV/trace directory.

This function saves version information into a file on the database server. Typically,you use this function at the request of IBM support:v Support Dump - produces a support level version file

For example, when you select the versionSupportLevelDump function, the followingmenu is displayed:(c) Netcool/Proviso DataMart(1.2.1)Procedure: versionSupportLevelDump

argument value-------- -----


Choice:

1. Enter E to run the information dump. Enter y to confirm your choice and theresults are displayed:(c) Netcool/Proviso DataMart(1.2.1)----------------------------------------------result: 0The version information file is available on the DB server at the following location:

/opt/oracle/admin/PV/udump/detailed_version_rpt_2004_05_20_18.log

----------------------------------------------[Enter] to quit:

2. Log in to the database server and view the report in the specified file. Ifnecessary, provide the file to IBM support.



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 inother countries. Consult your local IBM representative for information on theproducts and services currently available in your area. Any reference to an IBMproduct, program, or service is not intended to state or imply that only that IBMproduct, program, or service may be used. Any functionally equivalent product,program, or service that does not infringe any IBM intellectual property right maybe used instead. However, it is the user's responsibility to evaluate and verify theoperation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matterdescribed in this document. The furnishing of this document does not give youany license to these patents. You can send license inquiries, in writing, to:

IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785 U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBMIntellectual Property Department in your country or send inquiries, in writing, to:

Intellectual Property LicensingLegal and Intellectual Property LawIBM Japan, Ltd.19-21, Nihonbashi-Hakozakicho, Chuo-kuTokyo 103-8510, Japan

The following paragraph does not apply to the United Kingdom or any othercountry where such provisions are inconsistent with local law :

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THISPUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHEREXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESSFOR A PARTICULAR PURPOSE.

Some states do not allow disclaimer of express or implied warranties in certaintransactions, 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 beincorporated in new editions of the publication. IBM may make improvementsand/or changes in the product(s) and/or the program(s) described in thispublication at any time without notice.

Any references in this information to non-IBM Web sites are provided forconvenience only and do not in any manner serve as an endorsement of those Websites. The materials at those Web sites are not part of the materials for this IBMproduct 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 itbelieves appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purposeof enabling: (i) the exchange of information between independently createdprograms and other programs (including this one) and (ii) the mutual use of theinformation which has been exchanged, should contact:

IBM Corporation2Z4A/10111400 Burnet RoadAustin, 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 materialavailable for it are provided by IBM under terms of the IBM Customer Agreement,IBM International Program License Agreement or any equivalent agreementbetween us.

Any performance data contained herein was determined in a controlledenvironment. Therefore, the results obtained in other operating environments mayvary significantly. Some measurements may have been made on development-levelsystems and there is no guarantee that these measurements will be the same ongenerally available systems. Furthermore, some measurement may have beenestimated through extrapolation. Actual results may vary. Users of this documentshould verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers ofthose products, their published announcements or other publicly available sources.IBM has not tested those products and cannot confirm the accuracy ofperformance, compatibility or any other claims related to non-IBM products.Questions on the capabilities of non-IBM products should be addressed to thesuppliers of those products.

All statements regarding IBM's future direction or intent are subject to change orwithdrawal without notice, and represent goals and objectives only.

All IBM prices shown are IBM's suggested retail prices, are current and are subjectto change without notice. Dealer prices may vary.

This information is for planning purposes only. The information herein is subject tochange before the products described become available.

This information contains examples of data and reports used in daily businessoperations. To illustrate them as completely as possible, the examples include thenames of individuals, companies, brands, and products. All of these names arefictitious and any similarity to the names and addresses used by an actual businessenterprise is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, whichillustrate programming techniques on various operating platforms. You may copy,modify, and distribute these sample programs in any form without payment to


IBM, for the purposes of developing, using, marketing or distributing applicationprograms conforming to the application programming interface for the operatingplatform for which the sample programs are written. These examples have notbeen thoroughly tested under all conditions. IBM, therefore, cannot guarantee orimply reliability, serviceability, or function of these programs. You may copy,modify, and distribute these sample programs in any form without payment toIBM for the purposes of developing, using, marketing, or distributing applicationprograms conforming to IBM's application programming interfaces.

Each copy or any portion of these sample programs or any derivative work, mustinclude a copyright notice as follows:

© (your company name) (year). Portions of this code are derived from IBM Corp.Sample Programs. © Copyright IBM Corp. _enter the year or years_. All rightsreserved.

If you are viewing this information in softcopy form, the photographs and colorillustrations might not be displayed.

Trademarks

IBM, the IBM logo, and ibm.com are trademarks or registered trademarks ofInternational Business Machines Corp., registered in many jurisdictions worldwide.Other product and service names might be trademarks of IBM or other companies.A current list of IBM trademarks is available on the web at “Copyright andtrademark information” at www.ibm.com/legal/copytrade.shtml.

Adobe, Acrobat, PostScript and all Adobe-based trademarks are either registeredtrademarks or trademarks of Adobe Systems Incorporated in the United States,other countries, or both.

IT Infrastructure Library is a registered trademark of the Central Computer andTelecommunications Agency which is now part of the Office of GovernmentCommerce.

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo,Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks orregistered trademarks of Intel Corporation or its subsidiaries in the United Statesand other countries.

Linux is a registered trademark of Linus Torvalds in the United States, othercountries, or both

Microsoft and Windows are trademarks of Microsoft Corporation in the UnitedStates, other countries, or both.

ITIL is a registered trademark, and a registered community trademark of TheMinister for the Cabinet Office, and is registered in the U.S. Patent and TrademarkOffice.

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

Notices 37

Java and all Java-based trademarks and logos are trademarks orregistered trademarks of Oracle and/or its affiliates.

Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in theUnited States, other countries, or both and is used under license therefrom.

Linear Tape-Open, LTO, the LTO Logo, Ultrium, and the Ultrium logo aretrademarks of HP, IBM Corp. and Quantum in the U.S. and other countries.


��

Printed in USA

Documents

Tools forVersion ReportingTechnical Note...DB Database Database DV DataView DataView : Component registration Explains about the registration