12.2.9  
HiPath Manager PCM Trace Monitor for HiPath 5000 
 

12.2.9.1  
HiPath Manager PCM Trace Monitor Applications 
Communication between the different HiPath 5000 applications is organized using various buffer tables and messages. You can monitor the individual entries in the different buffer tables, exchanged immediate messages, program and communication messages for the relevant component in a separate trace window, in other words, a separate window is opened for each component (application).
The trace windows can be viewed using the Trace Monitor and swapped out for further processing.
This documentation does not cover interpretation of the trace window contents by the Trace Monitor. Trace files are used for problem analysis and are interpreted by Service Support during servicing.  
The description below can be used to determine the work steps required for Trace Monitor navigation and control and for swapping out the trace contents to a file.  
Trace messages can be displayed for the following HiPath 5000 applications:
 •   Feature Server
Two trace files are available:
   -   \winnt\system32\carlogfile.txt
provides details on which HG 1500 boards have logged on to the network and when.
   -   \winnt\system32\rgtracefile.txt
provides details on when the individual HG 1500 boards were assigned a station number.
 •   Presence Manager
Two trace files are available:
   -   \winnt\system32\dssdiagnosefile.txt
   -   \winnt\system32\dsslogfile.txt
 •   HiPath Manager PCM Administration
Administration of the configuration parameters for component control by the user, for general parameters, for call charge evaluation and analysis.
 •   HiPath GetAccount
Internal component that is responsible for evaluating and saving call charges and for immediate printing.

12.2.9.2  
Starting and Exiting the Trace Monitor 
The HiPath Manager PCM program group was created when installing the HiPath Manager PCM server. Administration and the trace monitor were integrated here.
To start the Trace Monitor, select Start - Programs - HiPath - HiPath Manager PCM Trace Monitor for HiPath Applications.
 Figure 12-1   Trace Monitor
 
The Trace Monitor can be closed with Exit in the File menu, with the key combination + or with the Trace Monitor system menu.

12.2.9.3  
The Screen Layout of the Trace Monitor 
When you start the Trace Monitor, an application window with the following layout appears:
 Figure 12-2   The Screen Layout of the Trace Monitor
 
The Trace Monitor menu bar lists the available menus/menu items.

 Table 12-5   Trace Monitor Menu Functions
 Menu name  
 Menu item  
 Function  
File  
Print Setup  
Setup of the printer for the output of trace messages to the printer.  
Exit  
Closes the Trace Monitor  
Trace  
Use Hex font  
The output of special trace messages with non-displaying characters is displayed in a hex font (option active) or in ANSI font (option not active). Default messages are always displayed in ANSI format.  
Colored Text  
Toggles between color (option active) and black-and-white display (option not active) for trace messages.  
Add Date/Timestamp  
Inserts a timestamp in each new trace message when the option is active.  
Show Window for new Application  
If this option is active, one of the applications that writes trace messages is immediately displayed in a separate trace window when it is activated.  
If the option is not active, trace windows for active applications can be opened or closed manually by selecting the entry Trace - <Name of Application>.  
Window  
Cascade  
Displays the trace windows in a cascade.  
Tile Vertically  
Displays the trace windows side by side.  
Tile Horizontally  
Displays the trace windows one above the other.  
Arrange Icons  
Arranges the trace windows reduced to an icon.  
?  
About...  
Activates Trace Monitor program information.  

12.2.9.4  
General Functions 

Opening and closing a trace window  
The following options are available for opening and closing trace windows:
 •   Automatic
Select the option Show New Logon Immediately (checkmark visible next to menu item) in the Trace menu to activate the automatic opening/closure of trace windows when the relevant application is started/exited. To disable this option, select the entry again. The checkmark is removed.
 •   Manual
If this option is not set, you can open and close the trace windows for the active applications manually. The Trace menu should be activated for this purpose. The first entries displayed are the available trace windows. Open trace windows are checkmarked.
   -   To open a closed window you must activate the entry. The checkmark is set and the trace window is opened.
   -   To close an open window you must reactivate the entry. The checkmark disappears and the trace window is closed.

Print trace window content  
You also have an option that allows you to output the current status of a trace window to the configured Trace Monitor printer for documentation purposes. For this, select the Print Messages entry via the System menu or, alternatively, the Context menu (right click in the Trace window) of the relevant Trace window. The current contents of the trace window are then sent to the configured printer.

Deleting the contents of the trace window  
To delete the contents of a trace window, select the Delete Messages entry via the system menu or, alternatively, the Context menu (right click in the Trace window) of the relevant Trace window. The contents are deleted and the window is empty.

Freezing the contents of a trace window  
To stop messages scrolling, you can freeze the current status of the trace window display. For this, select the Stop Window Scrolling entry via the system menu or, alternatively, the Context menu (right-click in the Trace window) of the relevant Trace window. The contents of the trace window are frozen. New trace messages are loaded to the buffer, but are no longer displayed.
To disable this option, select the menu item Stop Window Scrolling again. The option is removed and recent messages are displayed.

Arranging trace windows  
The active Trace Monitor trace windows can be arranged as follows:
 •   Cascade
Using the key combination + or via the Cascade entry in the menu window.
 •   Tile Horizontally
Using the key combination + or via the Tile Horizontally entry in the menu window.
 •   Tile Vertically
Using the key combination + or via the Tile Vertically entry in the menu window.
If the Trace windows are minimized as symbols, these can be arranged using the status bar. For this, select the Arrange Icons entry in the menu window.

12.2.9.5  
Exporting Trace Windows 
Each trace window has a capacity of 1,000 (for the Server PC under Windows 95/98) or 5,000 entries (for the Server PC under Windows NT or Windows 2000). When this capacity is reached, the oldest entry is deleted from the trace window for each new entry.
To document a current situation from a trace window, you can save the current status of a trace window to a swap file.

Procedure  
 1.   The Write Messages to File entry should be selected via the system menu or, alternatively, the context menu (right-click in the Trace window) of the relevant Trace window.
    A message box containing the path and file name of the swap file for the trace window appears:
   
 2.   Confirm the message with OK.
The default destination directory for swap files is the Windows 2000 shell user directory:
    C:\Documents and Settings
    \[Windows User]
      \My Documents
        \[Application ID]
          \[Trace File Name]
The following naming conventions apply to swap files:
    <Application ID><Time>.trc
The time is stored in YYYYMMDDhhmm format.

Example of a file name for a swapped-out trace file  
Windows User: Meier
Application: GetAccount
Exported on: 06.09.2004
at: 16:57:
    C:\Documents and Settings
    \Meier
      \My Documents
        \WACLIENT          \WACLIENT200409061657.trc

HiPath 3000/5000 V8, Service Documentation, Issue 10   up Top
Disclaimer & Copyright   ID: P31003H3580S100017620   2011-01-24