hntr2conf

Organization of this page

Function
Format
Required execution permission
Command directory
Arguments
Notes
Return values

Function

The hntr2conf command changes the size, number, and output path of the integrated trace logs output by the Hitachi Network Objectplaza Trace Library (HNTRLib2).

This command allows you to set the same settings (the size, number of, and output path of the integrated trace logs) as can be set by using the hntr2util command, which utilizes a GUI.

To Page Top

Format

hntr2conf [-f log-file-name]
          [-b log-file-size]
          [-n number-of-log-files]
          [-s buffer-file-size]
          [-w monitoring-period]
          [-i monitoring-interval]
          [-m number-of-messages]
          [-t type-of-exclusive-control]
          [-l command-log-file-name]
          [-h]

To Page Top

Required execution permission

In Windows: Administrators (If User Account Control (UAC) for Windows is enabled, you must execute the command from the administrator console.)

In UNIX: Superuser

To Page Top

Command directory

In Windows:: system-drive\Program Files\Hitachi\HNTRLib2\bin\
In UNIX:: /opt/hitachi/HNTRLib2/bin/

To Page Top

Arguments

`-f` `log-file-name`

Specify the output path and name prefix of the integrated trace log file. A file name of the integrated trace log will consist of the specified prefix and [1-16].log.

`-b` `log-file-size`

Specify the size of the integrated trace logs (8 to 8,192 KB).

`-n` `number-of-log-files`

Specify the number of integrated trace logs (1 to 16). The specified number of integrated trace logs are created in the output directory that is specified by using the -f option.

`-s` `buffer-file-size`

Specify the buffer file size (8 to 2,048 KB). Do not change this value from the default.

`-w` `monitoring-period`

Specify the period for monitoring the log file (1 to 300 seconds). Do not change this value from the default.

`-i` `monitoring-interval`

Specify the interval for monitoring the log file (1 to 3,600 seconds). Do not change this value from the default.

`-m` `number-of-messages`

Specify the maximum number of messages output by the command (0 to 500). Do not change this value from the default.

`-t` `type-of-exclusive-control`

Specify the type of exclusive control for the integrated trace log. Specify 0 to disable exclusive control and specify 2 to enable exclusive control. If you omit this parameter, 0 is assumed.

`-l` `command-log-file-name`

If you want to save the command outputs to a log file, specify the destination file name.

`-h`

This argument enables you to display online Help.

To Page Top

Notes

For the appropriate size of the integrated trace logs file, see Note for the hntr2util command.
If you modified the settings for the Hitachi Network Objectplaza Trace Library (HNTRLib2), you must restart it. For details on restarting the Hitachi Network Objectplaza Trace Library (HNTRLib2), see Note for the hntr2util command.
If you modified the type of exclusive control, restart all the services that output an integrated trace log. The setting will not take effect if you do not restart them.

To Page Top

Return values

`0`	Normal end
`1`	Wrong arguments
`2`	The user who executed the command does not have the administrative privilege (in Windows).
`10`	The log output file specified by the `-f` option does not exist.
`11`	The log file size specified by the `-b` option is too small.
`12`	The buffer file size specified by the `-s` option is bigger than the log file size.
`13` to `17`	Internal error
`99`	System error

To Page Top