historyInfo command

historyInfo command

+
Search Tips | Advanced Search

To generate reports by extracting data from XML files in...
APP_ROOT/properties/version
APP_ROOT/properties/version/history

...execute...

historyInfo Use parameters to create a history report.
genHistoryReport Generate report, historyReport.html, in the current working directory.

The historyInfo tool displays

Build version
Build date
List of changed components
History of installed or uninstalled maintenance packages.

To execute...
APP_ROOT/bin/historyInfo.sh

Syntax...
historyInfo.sh [ -format text | html ] [ -file file_name ] [ -maintenancePackageID pkg_id ] [ -component component_name ] historyInfo [ -help | /help | -? | /? | -usage ]

...where

-component component_name Name of a component. When specified, WAS history report displays events for only the named component. When not specified, the report displays events for all components.
-file file_name 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 or /help Displays command syntax.
-maintenancePackageID pkg_id ID of the interim fix, fix pack, or refresh pack.
When specified, WAS history report displays events for only the named maintenance package. When not specified, the report displays events for all maintenance packages.
-usage Displays command syntax.

Report description

The historyInfo command reports...

Installation information

Displays the following general information about the current installation:

Report date and time Date and time that the report was generated. The timestamp is formatted according to the current locale.
Product directory File path to the installation root directory of WAS ND.
Version directory File path of the version directory of the current WAS installation.
DTD directory File path of the DTD directory of the current installation.
Log directory File path of the log directory of the current installation. The maintenance package log files are in the directory.
Backup directory 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 File path of the temporary directory of the current machine.
History directory File path of the history directory of the current installation. The history files are in the directory.
History File File path of the event.history file.

Installation event information

Displays the list of installed maintenance packages (interim fix, fix pack, and refresh pack) and...

Maintenance package ID ID of the maintenance package.
Action Action taken with this maintenance package, which is either install or uninstall.
Package file name File name of the maintenance package that was installed.
Log file name File path of the log file generated during the installation or removal of the maintenance package.
Backup file name File path of the backup file generated during the installation of the maintenance package. This field does not apply for an uninstall action.
Timestamp Time when the maintenance action (install or uninstall) occurs. The time is stated in relation to GMT.
Result Result of the installation or removal action. The result is either success, partial success, or failure.

Component installation event information

Displays the following component-level information of the event for the current maintenance package:

Maintenance package ID ID of the maintenance package to which this particular installation event belongs.
Component name Name of the current component.
Action Action taken on this component due to the action of the current maintenance package, either install or uninstall
Update action Updated action taken on this component. By default, the update action for an installation action is replace.
Timestamp Time at which the action occurs for the maintenance package (GMT offset values).
Result Result of the install or uninstall action. The result is either success, partial success or failure.

Sample historyInfo report

The historyInfo script outputs the information similar to...
WVER0210I: Copyright (c) IBM Corporation 2002, 2005, 2008; All rights reserved. WVER0212I: HistoryInfo Reporter V1.7.1.15, Dated 2/27/07 -------------------------------------------------------------------------------- IBM WAS History Report --------------------------------------------------------------------------------
Report at date and time April 16, 2008 10:27:26 AM EDT
Installation -------------------------------------------------------------------------------- Product Directory C:\WAS70_ND Version Directory C:\WAS70_ND\properties\version DTD Directory C:\WAS70_ND\properties\version\dtd Log Directory C:\WAS70_ND\logs Backup Directory C:\WAS70_ND\properties\version\nif\backup TMP Directory C:\DOCUME~1\ADMINI~1\LOCALS~1\Temp History Directory C:\WAS70_ND\properties\version\history History File C:\WAS70_ND\properties\version\history\event.history
Warning: No events are available. -------------------------------------------------------------------------------- End History Report --------------------------------------------------------------------------------

Related
genHistoryReport

Related information
Use command line tools

historyInfo	Use parameters to create a history report.
genHistoryReport	Generate report, historyReport.html, in the current working directory.

-component component_name	Name of a component. When specified, WAS history report displays events for only the named component. When not specified, the report displays events for all components.
-file file_name	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 or /help	Displays command syntax.
-maintenancePackageID pkg_id	ID of the interim fix, fix pack, or refresh pack. When specified, WAS history report displays events for only the named maintenance package. When not specified, the report displays events for all maintenance packages.
-usage	Displays command syntax.

Report date and time	Date and time that the report was generated. The timestamp is formatted according to the current locale.
Product directory	File path to the installation root directory of WAS ND.
Version directory	File path of the version directory of the current WAS installation.
DTD directory	File path of the DTD directory of the current installation.
Log directory	File path of the log directory of the current installation. The maintenance package log files are in the directory.
Backup directory	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	File path of the temporary directory of the current machine.
History directory	File path of the history directory of the current installation. The history files are in the directory.
History File	File path of the event.history file.

Maintenance package ID	ID of the maintenance package.
Action	Action taken with this maintenance package, which is either install or uninstall.
Package file name	File name of the maintenance package that was installed.
Log file name	File path of the log file generated during the installation or removal of the maintenance package.
Backup file name	File path of the backup file generated during the installation of the maintenance package. This field does not apply for an uninstall action.
Timestamp	Time when the maintenance action (install or uninstall) occurs. The time is stated in relation to GMT.
Result	Result of the installation or removal action. The result is either success, partial success, or failure.

Maintenance package ID	ID of the maintenance package to which this particular installation event belongs.
Component name	Name of the current component.
Action	Action taken on this component due to the action of the current maintenance package, either install or uninstall
Update action	Updated action taken on this component. By default, the update action for an installation action is replace.
Timestamp	Time at which the action occurs for the maintenance package (GMT offset values).
Result	Result of the install or uninstall action. The result is either success, partial success or failure.