versionInfo command

The versionInfo command generates a report from data extracted from XML files in the properties/version folder. The report includes a list of changed components and installed or uninstalled maintenance packages.

Product version information

The versionInfo tool displays important data about the product and its installed components, such as the build version and build date. History information for installation and removal of maintenance packages also displays in the report. This tool is particularly useful when working with support personnel to determine the cause of any problem.

Product version reports The following report generation scripts extract data from XML data files in the properties/version folder:

• versionInfo script

  Lets you use parameters to create a version report.

• genVersionReport script

  Generates the versionReport.html report file in the current working directory.

Location of the command file

The command file is named versionInfo in the install_root/bin directory, where install_root is /QIBM/ProdData/WebSphere/AppServer/V6/Base for WebSphere Application Server and WebSphere Application Server - Express, and /QIBM/ProdData/WebSphere/AppServer/V6/ND for WebSphere Application Server Network Deployment.

Syntax

The versionInfo command is a script.

Syntax for the versionInfo command

The command syntax is:

versionInfo [ -format text | html]
               [ -file output file]
               [ -long ]
               [ -maintenancePackages ]
               [ -maintenancePackageDetail ]
               [ -components ]
               [ -componentDetail ]


versionInfo [ -help | -? | -usage ]

Parameters

-?

Displays command syntax.

-components

Adds a list of installed components to the report.

-componentDetail

Adds details about installed components to the report.

-file

fileName

The output file name. The report goes to standard output (stdout) by default.

-format

text | html

Selects the format of the report. The default is "text".

-help

Displays command syntax.

-long

Creates the long version of the report.

-maintenancePackages

Adds a list of applied maintenance packages to the report.

-maintenancePackageDetail

Adds details about an applied maintenance package to the report.

-usage

Displays command syntax.

Report description

The versionInfo command reports the following information:

Installation information

• Report date and time - The date and time that the report was generated. The timestamp uses GMT offset values.

• Product directory - The file path to the installation root directory defined by the WAS_HOME environment variable.

• Version directory - The file path of the version directory of the current WAS installation.

• DTD directory - The file path of the DTD directory of the current WAS installation.

• Log directory - The file path of the log directory of the current WAS installation. The maintenance package log files are in the directory.

• Backup directory - The file path of the backup directory of the current WAS installation. The backup files generated during the installation of maintenance packages are in this directory.

• TMP directory - The file path of the temporary directory of the current machine.

Installation platform information

• Name - IBM WebSphere Application Server

• Version - 6.0

Product list information

• Product ID - The product ID of the installed product.

• Status - The status of the product, either installed or uninstalled.

Installed product information

This information and the other information topic descriptions are hierarchal for each installed product, component, component update, installed maintenance package, included APARs, and component updates. This section of the report displays the following information:

• Name - The name of the installed product.

• Version - The current version of the product. Installing or uninstalling fix packs or refresh packs modifies this version.

• ID - The product ID of the product installed, such as BASE, ND, EXPRESS, IHS, XD, or CLIENT.

• Build level - The build level of the installed product.

• Build date - The build date of the installed product.

Installed component information

• Component name - The name of the installed component

• Spec version - The spec version of the current component

• Build level - The build level of the current component

• Build date - The build date of the current component

Installed component update information

• Component name - the name of the installed component

• Update type - All interim fixes, fix packs and refresh packs are maintenance packages. The update type field is always set to maintenance package.

• Maintenance package ID - The ID of the maintenance package that is responsible for the current maintenance level of the product.

• Update effect - The updated action taken on a particular component. The default effect is replace.

• Log file name - The file path of the log file that records the maintenance actions for the current maintenance level.

• Backup file name - The file path of the backup file generated during the installation of the maintenance package. Not applicable if the component is restored as a result of an uninstall of a maintenance package.

• Timestamp - The time at which the component is updated. The timestamp is stated in GMT offset values.

Installed maintenance package information

• Maintenance Package ID - the maintenance package ID

• Description - the description of the maintenance package

• Build Date - the build date of this maintenance package

Included APARs information

Displays the list of APARs fixed by this maintenance package.

Component updates information

• Component name - The name of the installed component.

• Updated effect - The update action taken on the component by the maintenance package. The default action is replace.

• Timestamp - The time at which the component update is installed (GMT offset).

Related reference
genVersionReport command