itmcmd history -h
itmcmd history -C
[-h [install_dir]]
[-L nnn[K|Kb|M|Mb]]
[-t masks ...]
[-D delim]
[-H|+H ]
[-N n]
[-i instance|-p cms_name
pc
itmcmd history -A ?
itmcmd history -A [n|0|?ms_name]
[-h [install_dir]]
[-W days]
[-L nnn[K|Kb|M|Mb]]
[-t masks*,etc ]
[-D delim]
[-H|+H ]
[-N n]
[-i instance|-p cms_name]
pc
where:
- -C
- Identifies this as an immediate one time conversion call.
- -A
- 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.
- -W days
- Day of the week (0=Sunday, 1=Monday, and so on.). 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
- 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
- Override for the value of the $candlehome variable.
- -t
- List of tables or mask patterns delimited by commas, colons,
or blanks. If the pattern has embedded blanks, it must be surrounded
with quotation marks.
- -D
- Output delimiter to use. Default=tab character. Quote or escape
blank: -D ' '
- -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.
- 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.
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