Use the itmcmd history command to manage the rolloff of history data into delimited text files.

where:

-C

Identifies this as an immediate one time conversion call.

-A [n|0|?ms_name]

Identifies this as a history conversion call. The default is to run the conversion now.

n

Automatically run specified number of times per day. Value must be -A n, where n is 1-24, the number of runs per day, rounded up to the nearest divisor of 24. For example, -A 7 means run every three hours.

0

Cancels all automatic runs for tables specified.

?ms_name

Lists automatic collection status for all tables.

pc

Two-character product code of the agent from which historical data is to be converted. Refer to the appendix on product codes in theIBM Tivoli Monitoring Installation and Setup Guide for more information.

-W days

Day of the week (0=Sunday, 1=Monday, etc.). This can be a comma-delimited list of numbers or ranges. For example, -W 1,3-5 means Monday, Wednesday, Thursday, and Friday. The default is Monday through Saturday (1-6).

-H|+H

Select the type of column headers desired.

-H

Exclude column headers. Default is attribute.

+H

Include group (long table) names in column headers. Format is Group_desc.Attribute. Default is attribute only.

-L nnn[K|Kb|M|Mb]]

Only converts files whose size is over a specified number of Kb/Mb (suffix can be any of none, K, Kb, M, Mb with none defaulting to Kb).

-h install_dir

Override for the value of the $candlehome variable.

-t masks ...

List of tables or mask patterns delimited by commas, colons, or blanks. If the pattern has embedded blanks, it must be surrounded with quotes.

-D delim

Output delimiter to use. Default=tab character. Quote or escape blank: -D ' '

-N n

Keep generation 0-n of output (default 9).

-i instance | -p cms_name

Directs the program to process historical data collected by the specified agent instance or the specified Tivoli Enterprise Monitoring Server instead of the agent.

-i instance

For agent instances (those not using the default queue manager). Directs the program to process historical data collected by the specified agent instance. For example, -i qm1 specifies the instance named qm1

-p cms_name

Directs the program to process historical data collected by the specified Tivoli Enterprise Monitoring Server instead of the agent.

Note:

A product code of ms must be used with this option. The default action is to process data collected by prod_code agent.

Use itmcmd history to schedule automatic conversions by the UNIX® cron facility. To schedule a basic automatic conversion, type the following at the command prompt:

   itmcmd history -A n prod_code

where n is a number from 1-24. This number specifies the number of times per day the data conversion program runs, rounded up to the nearest divisor of 24. The product code is also required.

For example, the following command means to run history conversion every three hours:

   itmcmd history -A 7 ux

An exit status of 0 indicates that the command executed successfully. An exit status of 2 indicates that there was a failure in the process.