HiCommand Dynamic Link Manager User's Guide (for Windows(R))

3.8 Setting up integrated traces

When HDLM is used, dlnkmgr commands and GUI operation logs are output to the integrated trace information files of Hitachi Network Objectplaza Trace Library (HNTRLib2) (installation-destination-drive:\Program Files^#\HITACHI\HNTRLib2\spool\Hntr2n.log files (n indicates a file number)).

#

In Windows Server 2003(IPF and x64), replace this part with Program Files (x86).

If there is a significant amount of integrated trace information output, information may end up deleted in a short amount of time. Also, if a large amount of integrated trace information is output at once, the integrated trace information that overflowed the buffer might not be saved in integrated trace files. To save as much information as possible, change the settings for Hitachi Network Objectplaza Trace Library, increasing the integrated trace file size and buffer size. Note that specifying the values too large places a heavy load on the system. When determining these values, consider these operational tradeoffs.

Table 3-15 Default and recommended values for the integrated trace file settings shows the default and recommended values for the integrated trace file settings.

Table 3-15 Default and recommended values for the integrated trace file settings

Setting		Default value	Recommended value
Integrated trace file size		256 (KB)	4096 (KB)
Number of integrated trace files		4	8
Buffer size per monitoring interval	Monitoring cycle	10 (seconds)	5 (seconds)
	Buffer size per monitoring interval	64 (KB)	256 (KB)
Number of messages to be output per monitoring interval	Monitoring cycle	0 (seconds)	0 (seconds)
	Number of messages to be output	0	0

If Hitachi Network Objectplaza Trace Library (HNTRLib2) is already installed, the existing settings will be inherited. If you change these settings, keep in mind that they are used by programs other than HDLM. If an earlier Hitachi Network Objectplaza Trace Library (HNTRLib) is already installed, the settings are not inherited.

To change the integrated trace file settings:

1. In Explorer, double-click the following file:
   program-installation-destination-drive:\Program Files\HITACHI\HNTRLib2\bin\hntr2utl2.exe
   The Hitachi Network Objectplaza Trace Utility 2 Release 2.0 dialog box shown in Figure 3-5 Hitachi Network Objectplaza Trace Utility 2 Release 2.0 dialog box. appears.
   

   Figure 3-5 Hitachi Network Objectplaza Trace Utility 2 Release 2.0 dialog box.

   

2. In Number of Files, change the number of integrated trace files.
   The default is 4. You can specify a value from 1 to 16.
   The value you specify here will apply to n in program-installation-destination-drive:\Program Files\HITACHI\HNTRLib2\spool\Hntr2n.log (n indicates a file number).
   
3. In File Size(KB), change the size of a integrated trace file.
   The default is 256 (kilobytes). You can specify a value from 8 to 8192. Specify a value greater than or equal to the setting of Buffer Size(KB).
   
4. In Buffer Size(KB), change the buffer size.
   Change the buffer size for the monitoring cycle.
   The default is 64 (kilobytes). You can specify a value from 8 to 2048. Specify a value smaller than or equal to the setting of File Size(KB).
   
5. In Interval Timer(KB), enter a value to shorten the monitoring cycle.
   The default is 10 (seconds). You can specify a value from 1 to 300.
   
6. In Lookout Span(KB), enter a value to specify the interval for monitoring the number of messages to be output to the integrated trace file.
   The default is 0 (seconds). You can specify a value from 0 to 3600.
   If you specify 0, you cannot adjust the number of messages to be output because the system ignores the setting of Max Messages / Span.
   
7. In Max Messages / Span, enter a value to specify the maximum number of messages to be output to the integrated trace file at the monitoring interval specified in Lookout Span(KB).
   The default is 0. You can specify a value from 0 to 500.
   If you specify 0, you cannot adjust the number of messages to be output.
   If you specify 0 for Lookout Span(KB), you cannot adjust the number of messages to be output because the system ignores the setting of Max Messages / Span.
   
8. After you finish changing the settings, click the OK button.
   The dialog box closes.
   
9. Restart the service of Hitachi Network Objectplaza Trace Library.
   In Control Panel, choose Administrative Tools and then Services to open the Services window. In the list of services, select Hitachi Network Objectplaza Trace Monitor 2. Then, from the Action menu choose Restart to restart the service.
   

[Contents][Back][Next]

All Rights Reserved. Copyright (C) 2003, 2007, Hitachi, Ltd.