During the installation of the Network Trace, the following statement should be added to the CONFIG.SYS:DEVICE=C:\IBMCOM\PROTOCOL\NTRACE.OS2 [driver-instance-name]
The driver-instance-name parameter is optional. When omitted, it defaults to NTRACE$. This name represents this instance of the driver for the OS/2 system. At boot time, when the device driver loads, it will look for its section of the PROTOCOL.INI file. The driver's instance name must appear in one of the sections in the DriverName statement.
In protocol mode, the position of this statement is of critical importance. Please see section 7 of manual installation for more details. In service mode, the position of the NTRACE.OS2 statement is not of importance.
It's possible to load manually more than one instance of the driver assigning different instance names in CONFIG.SYS and PROTOCOL.INI. Remember, however, that only the last (or the only) instance of the driver may have a default instance name, NTRACE$.
During the driver's initialization (at boot time when the driver loads), it has to identify its configuration section of the PROTOCOL.INI. The driver looks for a matching instance name in DriverName statement. Once found, the appropriate section of the PROTOCOL.INI is read to provide the driver with its parameters.The section may have an arbitrarily assigned bracketed name, like this:
[NTRACE_nif]
This name is also referred to as the "module name". In service mode it is used by protocol drivers in the "Bindings" statement, to specify the instance of NTRACE which they are bound to. Each instance of NTRACE MUST have its own, uniquely named section in PROTOCOL.INI.
A minimal section has to contain at least these two statements:
DriverName = driver's-instance-nameThe following are optional statements:This name must match the name given to the driver's instance. Valid names contain no more than 8 characters. This name MUST match the instance name specified in CONFIG.SYS OR it can be set to NTRACE$ to match the default instance name.Bindings = MAC-name[...,MAC-name]Bindings statement reports the intention to bind the capture driver specified to one or more MAC drivers, in the order listed. The list may contain from 1 to 8 MAC driver names.ModuleType = "Service" or "Protocol"The following obsolete statement is no longer supported:This specifies the mode of operation for the NTRACE device driver. It defaults to "Protocol" for compatibility with Network Trace v1.0 which only supported protocol mode.RejectFrames = decimal-reject-filter-valueIf specified, this value initializes a default value for filtering of frames the Network Trace makes available to the rest of the system. Its primary use is compensation for the LAN adapter promiscuity introduced by the Network Trace driver itself. This value may be overridden at any time by using the -rf option when starting NTRACE.Decimal-reject-filter-value is calculated as sum of the following:
A destination address is considered foreign if it does not match neither the current MAC address nor any of the multicast addresses defined by the time of the frame reception. A functional address is considered foreign if it has no common bits with the current MAC functional address.1 to deny frames with foreign destination address; 2 to deny broadcast frames; 4 to deny NULL-addressed frames; 16 to deny frames with foreign functional address (token ring only); 32 to deny MAC broadcast frames (token ring only); 64 to deny pure MAC frames (token ring only). To compensate for the MAC promiscuity, use a reject filter of 5 for Ethernet and 21 for Token Ring. This is VERY IMPORTANT when using LAN Server, WorkSpace On-Demand and other NetBIOS and 802.2 applications. It has been found that these applications do NOT expect promiscuous frames and will fail or ABEND if these frames are seen. Other applications and subsystems may also have sensitivity to these frames. In most circumstances, this statement should be included in the NTRACE configuration.
By default, there is no reject filter value. It is highly recommended to set a default value, otherwise when using the products listed above, the user will always be required to remember to use the -rf option when starting NTRACE.EXE.
PacketFilter = decimal-packet-filter-valueThe NTRACE.OS2 driver now calculates a value for this filter. See the command line syntax section on -pf option for a runtime override of this value.