The Cisco Unity
Port Status Monitor (PSM) allows you to monitor Cisco Unity voice port activity
in real time.
Requires Cisco Unity 3.1.0(1) or greater.
Must run on the Cisco Unity server being monitored.
The Cisco Unity Port Status Monitor allows you to view activity, in the form of port activity messages, on one of more of Cisco Unity’s voice ports in real time.
Figure 1
Activity on each port is displayed in a separate window. Each window can display any or all of three different traces:
Icon |
Trace |
Information |
Application |
High-level application state
information |
|
|
Display |
Information used for the web-based
Status Monitor |
|
Conversation |
Detailed conversation state
information |
Traces are displayed in status monitor windows in the order in which they are received from Cisco Unity.
Toolbar icon:
Starts the status monitor window for the port highlighted in the Ports Bar. If the status monitor window is already started, has no effect.
Toolbar icon:
Stops the status monitor window for the port highlighted in the Ports Bar. If the status monitor window is already stopped, has no effect.
Toolbar icon:
Clears all traces from the status monitor window for the port highlighted in the Ports Bar, then captures the current status for each active trace.
Toolbar icon:
Starts status monitor windows for all ports. If some ports already have status monitor windows started, will only start status monitor windows for those ports that have no currently active window.
Toolbar icon:
Stops all active status monitor windows.
Toolbar icon:
Clears all traces from all active status monitor windows, then captures the current status for each active trace.
Toolbar icon:
Turns on and off the auto-scroll feature for all active status monitor windows. By default, the auto-scroll feature causes status monitor window information to scroll so that the most recent trace information is always visible. If you turn off the auto-scroll feature, all status monitor windows will stop scrolling and must be manually scrolled.
Toolbar icon:
Turns on and off file logging for all active port status monitors. When you turn on file logging, the Ports Status Monitor will capture all port status traces to a log file, identified when you activate the feature, as in Figure 2:
Figure 2
The output file will be saved in the directory where the Ports Status Monitor is installed, and will be formatted as a comma-seperated value (CSV) file. An example file is shown in Figure 3.
Figure 3
The columns in the log output file are:
Port |
The voice port being logged. |
Date |
The date the trace was received |
Time |
The time the trace was received |
Trace |
The trace received, either Application, Display, or
Conversation |
Info |
The actual text of the trace received |
Toolbar icon: None
Toggles display of the Ports Bar.
Toolbar icon: None
Toggles display of the Tool Bar.
Toolbar icon: None
Toggles display of the Status Bar.
Toolbar icon: None
Toggles the application trace on and off
Toolbar icon: None
Toggles the display trace on and off
Toolbar icon: None
Toggles the conversation trace on and off
Toolbar icon:
Toggles the one-line real time status display on and off. The one-line real time status display adds a column to the ports bar that displays the most recent Display Trace for each port, as shown in Figure 4.
Figure 4
Toolbar icon: None
Figure 5
Maximum traces in trace window: Each port status monitor window will continue to accumulate traces up to a limit you can specify in the Trace Properties dialog, shown in Figure 5. You may enter a value between 1 and 1,000,000. As traces in a status monitor window reach the limit specified, the oldest traces will be removed from the window to make room for new traces. This has no effect at all on file logging of status monitor traces.
Maximum traces in log file: When you choose to log trace information to a file, the file will continue to grow until a maximum number of lines have been added to the file. You may enter a value between 1 and 10,000,000. When the currently open trace file becomes full, a new trace file will be opened for further trace logging.
Toolbar icon:
Cascades all open status monitor windows.
Toolbar icon:
Tiles all open status monitor windows horizontally.
Toolbar icon:
Tiles all open status monitor windows vertically.
The Cisco Unity Port Status Monitor supports some command line options. You may run PSM from the command line uing the following syntax:
PortStatusMonitor
[/a][/c][/d]
The command line options have the following meanings:
/a – monitor all ports for application traces and log traces to a file while the PSM is open.
/c – monitor all ports for conversation traces and log traces to a file while the PSM is open.
/d – monitor all ports for display traces and log traces to a file while the PSM is open.
All three command line options cause the PSM to open a file called PSM_STEALTH_<DATE>_<TIME>.csv, with the date and time the file was opened as part of the file name. This file will contain all of the specified traces for all ports on the Cisco Unity system for the entire time the PSM is open and active. There is no way to turn off these traces without shutting down the PSM.
Version 1.0.0.1
Initial version.
Version 1.0.0.3
Added help, fixed defects, modified icons.
Version 1.0.0.4
Added command line options for trace capture.
Version 1.0.0.5
Expanded year in log file time stamps to 4 digits.
Version 1.0.0.6
Added log file limits.
Version 1.0.0.7
Fixed version display in about box.
Version 1.0.0.8,
Added updated version check.
© 2002 Cisco Systems, Inc. -- Company Confidential