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
-
For the appropriate size of the integrated trace logs file, see Note for the hntr2uti2 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 hntr2uti2 command.
-
If you modified the buffer file size or the type of exclusive control, restart all the services that output log data to the integrated trace log. The setting will not take effect if you do not restart them.
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 |