Finisar Surveyor User Manual

4-21

directory and will use that file for its diagnostic information. If no EXPERT-
MSG.INI

 file is found in the directory, Surveyor will not provide diagnostic infor-

mation.
You can change the diagnostic information if you want. Changing the diagnostic 

information may be a useful way to customize Surveyor for your environment. For 

example, if you have a known problem area to check when certain conditions occur 

you can include this information directly in the diagnostic information.

Surveyor assigns names to protocols that have been detected, providing users with 

an easy way to view what protocols have been discovered on the network. In most 

cases, protocol names are well known; they are defined by the protocol’s creator, or 

defined by a standards organization. However, you may want explicit information 

about a protocol that does not have a well known name or is counted in Surveyor 

monitor screens as a “TCP OTHER” or “UDP OTHER” protocol. 
Surveyor includes a MONITOR.INI file to assign names to protocols. Entries in 

the MONITOR.INI file allow you to:
•

Rename the protocols that are currently being detected. For protocols that use 
TCP or UDP as their transport protocol, the protocol can be assigned a name to 
override it’s default name.

•

Extend the list of protocols that are monitored by Surveyor. You can extend the 
monitoring of protocols that use TCP or UDP as their transport protocol.

See the section on How Surveyor Assigns Protocol Names to learn how Surveyor 

names protocols by default. Understanding how Surveyor assigns names to proto-

cols by default is important for understanding how protocol names can be altered 

and how protocols can be added using MONITOR.INI.
The assigning of protocol names does not effect protocol decodes. See Assigning 

TCP or UDP Ports to Protocol Parsers for information on assigning protocol parsers 

to specific ports.
The MONITOR.INI file is located in your Surveyor installation directory. Exam-

ples of usage are included in the file.
Settings in the MONITOR.INI file will override any other configuration settings 

you have made for the display of protocols.

MONITOR.INI Format

MONITOR.INI

 contains two sections, TCP and UPD. Each section may have zero 

or more entries beginning with the keyword “mapping”. Each “mapping” entry is 

followed by an equal sign and three variables: 

mapping= <port num>,<short name>,<long name>