Tivoli Monitoring, Version 6.2

itmcmd audit

Description

Use itmcmd audit command to manage the size and number log files. These logs are located in /staging2/candle-m8//logs/.

Depending on the number of products you install and the amount of activity on your system, managing the size and number of log files in your install_dir directory can be critical. The itmcmd audit -l command enables you to remove or truncate log files.

The itmcmd audit -l command only takes action on those log files that are stored in the install_dir/logs subdirectory for the install_dir directory in which it is run.

The itmcmd audit command can consume time and resource. For best results, run this command during off hours. Run the itmcmd audit command to trim or delete files only when the agent is not running.

Note:
This command does not audit the installation log file.

CLI syntax

itmcmd audit -l age [logdays]
               [-h $install_dir]
               [-c]

itmcmd audit -l size [logsize]
               [-h $install_dir]
               [-c]

/itmcmd audit -l both [logdays logsize]
               [-h $install_dir]
               [-c]

where:

-l
(required) Runs the log management function. Use one of the following arguments:
age [logdays]
Removes all log files that are older than a specified number of days. The age is determined by the last modification date. The default age is 30 days.
size [logsize]
Trims log files to a specified number of kilobytes. The oldest entries are removed first. The default size is 1024 KB.
both [logdays logsize]
First removes log files older than the specified number of days, then trims the remaining files to the specified size.
-h $install_dir
(optional) Specifies the $install_dir, if it is not defined for the current environment.
-c
(optional) Displays diagnostic messages from the command to the screen.

CLI example

The following example removes all log files older than 20 days:

   itmcmd audit -l age 20

Return values

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




Feedback

[ Top of Page | Previous Page | Next Page | Contents | Index ]