Hitachi

JP1 Version 12 JP1/Base User's Guide


hntr2conf

Organization of this page

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 hntr2utl2 command, which utilizes a GUI.

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]

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

Command directory

In Windows (x86 environment):

HNTRLib2 for 32bit

system-drive\Program Files\Hitachi\HNTRLib2\bin\

In Windows (x64 environment):

HNTRLib2 for 32bit (If setting an integrated trace for 32-bit processes)

system-drive\Program Files (x86)\Hitachi\HNTRLib2\bin\

HNTRLib2 for 64bit (If setting an integrated trace for 64-bit processes)

system-drive\Program Files\Hitachi\HNTRLib2\bin\

In UNIX:

/opt/hitachi/HNTRLib2/bin/

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. The initial setting is as follows:

For Windows (x86 environment):

system-drive\Program Files\Hitachi\HNTRLib2\spool\hntr2*.log

For Windows (x64 environment):

system-drive\Program Files (x86)\Hitachi\HNTRLib2\spool\hntr2*.log

For UNIX:

/var/opt/hitachi/HNTRLib2/spool/hntr2*.log

-b log-file-size

Specify the size of the integrated trace logs (8 to 8,192 KB). The initial setting is 256 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. The initial setting is 4.

-s buffer-file-size

Specify the buffer file size (8 to 2,048 KB). The initial setting is 64 KB.

-w monitoring-period

Specify the period for monitoring the log file (1 to 300 seconds). The initial setting is 10 seconds.

-i monitoring-interval

Specify the interval for monitoring the log file (0 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.

Notes

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