Note: If you have a Pipeline 25-Fx with the IPX Routing option (for connecting to NetWare networks), see the help file for IPX Routing.
Usage: Click the Help button at any time to get online help for the settings in the current tab.
This opens a World Wide Browser, such as Netscape Navigator or Internet Explorer, and displays information about the settings.
To close the help display, close the browser as you would any other program. For example, in Windows 95, click the X button at the upper right of the window or choose Exit from the File menu.
With some browsers, a new window will open each time you click the Help button. If this happens, simply close each window when you're done with it.
Finding setting descriptions: At the beginning of each help window is a table of contents for the window. To go information about a particular setting, click the hyperlink (the underlined text in most browsers) for that setting in the contents. To return to the contents, use the control in your browser for going back, such as the Back button in Netscape Navigator or Internet Explorer 3.0.
Update
Description: Sends configuration settings to the Pipeline.
Usage: Click this button to send the settings shown in the Java-Based Pipeline Configurator to the Pipeline.
These new settings replace the previous settings in the Pipeline. You can use this button at any time; you do not have to enter values for all settings before updating the Pipeline.
Save
Description: Saves configuration settings in a file.
Usage: Click this to save the settings shown in the Java-Based Pipeline Configurator in a file on your computer.
You then use your operating system's facility for specifying a name and location for the file, such as the Save To dialog box in Windows 95.
You can later open a file in which you've saved settings by clicking the Open a Configuration File button in the first window that appears when you run the Java-Based Pipeline Configurator.
You can use this button at any time; you do not have to enter values for all settings before saving settings.
Usage: Choose one of the following:
Usage: Select the packet filter you want to configure and click the Edit button.
There are three predefined packet filters:
Name
Description:
This setting specifies the name of the filter.
Show
Description:
This setting specifies which filter conditions to display.
Usage: Select a condition to modify from this list. The remaining settings in this window apply to this condition.
Usage: Select a condition and click the button.
Because conditions have numbers, not names, the number of the condition changes when you move it. Its settings, however, remain the same.
Note that if the Link to Next Filter setting for the condition is checked, it remains checked when you move a condition, and the condition becomes linked to different condition.
Usage: Select a condition and click the button.
Because conditions have numbers, not names, the number of the condition changes when you move it. Its settings, however, remain the same.
Note that if the Link to Next Filter setting for the condition is checked, it remains checked when you move a condition, and the condition becomes linked to different condition.
Usage: Check this box to enable the selected filter condition.
Usage: Click one of these buttons:
Usage: Choose one of the following:
Starting at the position specified by the Byte Offset setting, the Pipeline applies the value of the Pre-Comparison Mask setting. A mask hides the part of a number that appears behind the binary zeroes in the mask; for example, if the Pre-Comparison Mask setting is ffff0000 in hexadecimal format, the Pipeline uses only the first 16 binary digits in the comparison, since the f setting is 1111 in binary format. The Pipeline then compares the unmasked portion of the packet specified by the Comparison Length setting with the value specified by the Compare To setting.
Usage: Enter the number of starting bytes in a packet that the Pipeline ignores for comparison and masking purposes.
The default is 0. If you use the default, the Pipeline starts comparing and masking data at byte 1.
Example: Suppose you have a filter that discards packets and has these specifications:
Dependencies:
If Link to Next Filter is checked in the previous filter, Byte Offset starts at the endpoint of the previous segment.
Comparison Length
Description:
This setting indicates the number of bytes in a packet that the Pipeline compares to the setting of the Compare To setting.
Pre-Comparison Mask
Description:
This setting specifies a 16-bit hexadecimal bitmask that the Pipeline applies to the data contained in the specified bytes in a packet. A mask hides the part of a number that appears behind the binary zeroes in the mask; for example, if the Pre-Comparison Mask setting is ffff0000, the Pipeline uses only the first 16 binary digits in the comparison, since the f setting is 1111 in binary format.
Usage: Enter a hexadecimal number. You can enter a number from 00000000000000 to ffffffffffffffff.
The default is 00000000000000. When you use the default, the bytes must contain nothing to match the filter.
Example:
e0e0030000000000Dependencies: Keep this additional information in mind:
After applying the Byte Offset, Pre-Comparison Mask, and Comparison Length values to reach the appropriate location in a packet, the Pipeline compares the packet's contents to the Compare To setting. If Filter If Packets Are is set to Equal (the default), the Pipeline applies the filter if the packet data is identical to the setting of the Compare To setting. If Filter If Packets Are is set to Not Equal, the Pipeline applies the filter if the packet data is not identical to the setting of the Compare To setting.
Usage: Choose one of the following:
Use this setting when you need a filter for all packets that is wider than the 8-byte limit of the Comparison Length setting. For example, suppose a packet is 16 bytes long (128 bits). You can compare only 8 bytes in a filter because the maximum value of the Comparison Length setting is 8. To compare all 16 bytes, you specify two 8-byte filters linked by the Link to Next Filter setting.
Usage:
Dependencies:
The next filter must be a filter condition for all packets (Apply To is All Packets) and must be activated (Enabled setting is checked); otherwise, the Pipeline ignores the filter condition.
Settings for IP Packets
Filter Action
Description:
This setting specifies whether the Pipeline forwards or discards packets that match the selected filter condition. When you use Filter Action in a Call Placement Filter, any forwarded data packet resets the idle timer and can initiate a call.
The Pipeline applies the mask to the address using a logical AND after the mask and address are both translated into binary format.
Usage: Enter the IP mask in dotted decimal format. The value 0 (zero) hides all bits, because the decimal value 0 is the binary value 00000000; the value 255 does not mask any bits, because the decimal value 255 is the binary value 11111111.
The null address 0.0.0.0 is the default; this setting indicates that the Pipeline masks all bits. To specify a single source address, set Source Mask to 255.255.255.255 and set Source Address to the IP address that the Pipeline uses for comparison.
Example: Suppose a packet has the source address 10.2.1.1. If the Source Address setting is 10.2.1.3 and the Dest. Mask setting is 255.255.255.0, the Pipeline masks the last digit and uses only 10.2.1, which matches the packet.
Usage: Enter the source address the Pipeline should use for comparison when filtering a packet. The address consists of four numbers between 0 and 255, separated by periods.
The null address 0.0.0.0 is the default; this setting matches all packets.
Example:
200.62.201.56
The Pipeline applies the mask to the address using a logical AND after the mask and address are both translated into binary format.
Usage: Enter the IP mask in dotted decimal format. The value 0 (zero) hides all bits, because the decimal value 0 is the binary value 00000000; the value 255 does not mask any bits, because the decimal value 255 is the binary value 11111111.
The null address 0.0.0.0 is the default; this setting indicates that the Pipeline masks all bits. To specify a single destination address, set Dest. Mask to 255.255.255.255 and set Dest. Address to the IP address that the Pipeline uses for comparison.
Example: Suppose a packet has the destination address 10.2.1.1. If the Dest. Address setting is 10.2.1.3 and the Dest. Mask setting is 255.255.255.0, the Pipeline masks the last digit and uses only 10.2.1, which matches the packet.
Dest. Address
Description:
This setting specifies the destination address to which the Pipeline compares a packet's destination address.
Usage: Enter the destination address the Pipeline should use for comparison when filtering a packet. The address consists of four numbers between 0 and 255, separated by periods.
The null address 0.0.0.0 is the default. If you accept the default, the Pipeline does not use the destination address as a filtering criterion.
Example:
200.62.201.56
Source Comparison
Description:
This setting specifies the type of comparison the Pipeline makes when filtering for source port numbers using the Source Port # setting.
You must set Source Comparison to None if the Protocol # setting is not set to 6 (TCP) or 17 (UDP).
The Source Comparison criterion determines how the Pipeline carries out the comparison.
Usage: Enter the number of the source port the Pipeline should use for comparison when filtering packets. You can enter a number between 0 and 65535.
The default setting is 0 (zero); this setting means that the Pipeline forwards all packets.
Example:
25Port 25 is reserved for SMTP, so that socket is dedicated to receiving mail messages. Port 20 is reserved for FTP data messages, Port 21 for FTP control sessions, and Port 23 for Telnet sessions.
Usage: Choose one of the following:
You must set Dest. Comparison to None if the Protocol # setting is not set to 6 (TCP) or 17 (UDP).
The Dest. Comparison criterion determines how the Pipeline carries out the comparison.
Usage: Enter the number of the destination port the Pipeline should use for comparison when filtering packets. You can enter a number between 0 and 65535.
The default setting is 0 (zero). If you accept the default, the Pipeline does not use the destination port number as a filtering criterion.
Example:
25
Port 25 is reserved for SMTP; that socket is dedicated to receiving mail messages. Port 20 is reserved for FTP data messages, Port 21 for FTP control sessions, and Port 23 for Telnet sessions.
Protocol #
Description:
This setting specifies the protocol number to which the Pipeline compares a packet's protocol number.
Usage: Enter the number of the protocol. You can enter a number between 0 and 255. The default setting is 0 (zero). When you accept the default, the Pipeline disregards the Protocol # setting when applying the filter.
Protocols and their associated numbers are listed in the following table.
Dependencies:
The Protocol # setting applies only if the filter is of type IP (Apply to: All Packets/IP Packets setting is IP) and is activated (Enabled setting is checked).
Match Only Established TCP Connections
Description:
This checkbox specifies whether the filter should match only established TCP connections.
Dependencies: The Match only established TCP Connections setting does not apply (Match Only Established TCP Connections setting is dimmed) if the Protocol # setting is set to any value other than 6 (TCP).