Description
Use the itmcmd history command
to manage the rolloff of history data into delimited text files.
CLI syntax
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]
[-x]
pc
itmcmd history -A ?
itmcmd history -A [n|0|ccms_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]
[-x]
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.
- cms_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.
- -x
- Exclude SAMPLES and INTERVAL attributes in the output file.
- 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.
CLI example
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
Return values
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.
Related commands
Return to Table 1.