Note: In most cases, the drivers can be fully installed using this procedure. In cases where an automatic installation is not possible, you must follow the procedure contained in "Manually Installing ATM Forum-Compliant LAN Emulation OS/2 Drivers".
If your system has one of these programs installed, go to step .
Note: The directions that follow use MPTS as the example installation program. The procedure for LAPS is similar. Refer to your MPTS or LAPS documentation for more information.
When a message appears stating that the driver is installed, select OK again. The Multi-Protocol Transport Services panel reappears.
Note: The defaults are set to maximize performance for most installations; changing them is not required. Change the defaults only if you know that you have a specific need to alter their values.
Use the procedure in this section only if you were unable to install the driver using the procedure in "Installing and Configuring the OS/2 Forum-Compliant LE Driver Automatically Using MPTS or LAPS".
Note: You might need to refer to your operating system's instruction manual if you are not familiar with the commands for copying files and creating directories.
To install the OS/2 LE driver, follow the steps listed below:
copy a:\*.* x:\TW155OS2
where x represents the drive on which you want to install the TURBOWAYS files. Press Enter.
DEVICE=x:\yyyyy\PROTMAN.OS2 /I:x:\yyyyyIf you find the DEVICE= statement, edit it so that it looks like the following statement:
DEVICE=x:\TW155OS2\PROTMAN.OS2 /I:x:\TW155OS2where x represents the drive on which you installed the TURBOWAYS files.
If you do not find the DEVICE= statement, add the following DEVICE= statement before any other DEVICE= statements that you find:
DEVICE=x:\TW155OS2\PROTMAN.OS2 /I:x:\TW155OS2where x represents the drive on which you installed the TURBOWAYS files. The /I instructs the Protocol Manager to search for the PROTOCOL.INI file in the \TW155OS2 directory.
DEVICE=x:\TW155OS2\AT155LE.OS2where x represents the drive on which you installed the TURBOWAYS files.
If you do not find the NETBIND.EXE statement, add the following statement after the DEVICE= statement that starts the NDIS MAC driver:
RUN=x:\TW155OS2\NETBIND.EXEwhere x represents the drive on which you installed the TURBOWAYS files.
Note: The PROTOCOL.INI file is in the path specified after the /I: parameter in the Protocol Manager (PROTMAN.OS2) statement in the CONFIG.SYS file.
If you do not have an existing PROTOCOL.INI file on your computer's hard disk, create one. To create a PROTOCOL.INI file, copy the appropriate sample INI file in the \TW155OS2 directory to a new PROTOCOL.INI file in the \TW155OS2 directory. There are two sample INI files in the \TW155OS2 directory from which to choose:
copy x:\tw155os2\sampleth.ini x:\TW155OS2\protocol.ini
where x represents the drive on which you installed the TURBOWAYS files.
copy x:\tw155os2\sampletr.ini x:\TW155OS2\protocol.ini
where x represents the drive on which you installed the TURBOWAYS files.
Figures 3 and 4 are examples of PROTOCOL.INI files for Ethernet and token-ring networks. Section A in each figure illustrates a protocol driver section that binds the protocol to the adapter specified in Section B in the same figure.
Bindings=AT155LEO_nifNote: If there is already a value for the Bindings= statement, place a comma after the existing value before adding the new Bindings value.
If you had an existing PROTOCOL.INI file, add the ATM NDIS MAC driver section (Section B in the example PROTOCOL.INI files.) to your PROTOCOL.INI file. The easiest way to accomplish this is to use a text editor to copy Section B from the appropriate sample INI file in the \TW155OS2 directory to the PROTOCOL.INI file.
Section B lists many of the parameters supported by the TURBOWAYS 155 Adapter. Alter the parameters as needed for your network. The Ethernet and token-ring parameters supported by the NDIS MAC driver are described in Table 1.
Supply an LES ATM address for the LES_ATM_ADDR parameter. The LES_ATM_ADDR is a required parameter.
If you want to use a locally administered address, enter a 12-character, hexadecimal address in the MAC address (MAC_ADDR) parameter. If you want to use the universally administered address, omit the MAC_ADDR parameter.
Note:
The default values for the remaining parameters, shown in the tables in "ATM Forum-Compliant LAN Emulation Configuration Parameters for OS/2" are set to maximize performance for most installations and, in most instances, are the values that you should use. Use other values only if you know that you have a specific need to alter the default values.If you enter no value for a parameter, the adapter uses the default value, but it is recommended that you type the default values in your PROTOCOL.INI file for documentation and maintenance purposes.
;Section A: Example Protocol Driver
;[PROTOCOL]
; Drivername = OS2NDIS$
; Bindings = AT155LEO_nif
.
.
.
;Section B: NDIS MAC Driver for Adapter
[AT155LEO_nif]
Drivername = AT155LE$
LES_ATM_ADDR = "0000000000000000000000000000000000000000"
LEC LEC_AUTO_CFG = "NO"
LAN_TYPE = "802.3+V2"
MAX_FRAME_SIZE = 1516
ENHANCED_MODE = "NO"
UNI_VERSION = "AUTO"
MAX_CONNECTIONS = 260
MAX_MULTIC_ADDR = 8
BEST_E_PK_RATE = 25600
CNTRL_P_PK_RATE = 25600
AGING_TIMEOUT = 300
CONN_COMP_TIMER = 4
CONTROL_TIMEOUT = 120
LE_ARP_RSP_TIME = 4
FLUSH_TIMEOUT = 4
FRWRD_DELAY_TME = 15
LE_ARP_CACHE_SZ = 260
MAX_CFG_RETRIES = 1
MAX_RETRY_CNT = 1
MAX_UNKN_FR_CNT = 1
PATH_SWTCH_DELY = 6
VCC_TIMEOUT = 1200
ADAPTER_TYPE = 4
Table 1 describes the parameters shown in Figure 3.
;Section A: Example Protocol Driver
;[PROTOCOL]
; Drivername = OS2NDIS$
; Bindings = AT155LEO_nif
.
.
.
;Section B: NDIS MAC Driver for Adapter
[AT155LEO_nif]
Drivername = AT155LE$
LES_ATM_ADDR = "0000000000000000000000000000000000000000"
LEC_AUTO_CFG = "NO"
LAN_TYPE = "802.5"
MAX_FRAME_SIZE = 4544
ENHANCED_MODE = "NO"
UNI_VERSION = "AUTO"
MAX_CONNECTIONS = 260
MAX_MULTIC_ADDR = 8
BEST_E_PK_RATE = 25600
CNTRL_P_PK_RATE = 25600
AGING_TIMEOUT = 300
CONN_COMP_TIMER = 4
CONTROL_TIMEOUT = 120
LE_ARP_RSP_TIME = 4
FLUSH_TIMEOUT = 4
FRWRD_DELAY_TME = 15
LE_ARP_CACHE_SZ = 260
MAX_CFG_RETRIES = 1
MAX_RETRY_CNT = 1
MAX_UNKN_FR_CNT = 1
PATH_SWTCH_DELY = 6
VCC_TIMEOUT = 1200
ADAPTER_TYPE = 4
Table 1 describes the parameters shown in Figure 4.
Table 1. ATM Forum-Compliant OS/2 NDIS MAC Driver Parameters in PROTOCOL.INI
Parameter Explanation Drivername AT155LE$ LES_ATM_ADDR The ATM address of the LES that serves your computer. You must assign a value. Type: Hexadecimal string Value: A 40-character, hexadecimal address MAC_ADDR The MAC address for the adapter. The adapter can be known on the network by its universally administered address (encoded in the adapter memory at the factory) or a locally administered address (a unique, user-assigned address). The universally administered address is the default. The address appears on the TURBOWAYS 155 Adapter bracket. If you use a locally administered address, it should appear with this parameter. Omit this parameter if you use a universally administered address. Type: Hexadecimal string Value: 400000000000 to 7FFFFFFFFFFF LEC_AUTO_CFG The configuration mode for the LES ATM address. The configuration mode determines how the adapter obtains the LES ATM address. Automatic (LEC_AUTO_CFG=YES) indicates that the adapter will try to obtain the LES ATM address from the LAN Emulation Configuration Server (LECS). The LECS address will be obtained from the ILMI MIB table in the attached switch, if available, or the adapter will use the ATM Forum defined Well-Known LECS Address. User-defined (LEC_AUTO_CFG=NO) indicates that the user-specified LES ATM address will be used. Type: Character string Value: "YES" or "NO" (Default="NO") LAN_TYPE The type of LAN Emulation. Type: Character string Value (Ethernet): 802.3+V2 Value (Token-Ring): 802.5 ELAN_NAME The name of the emulated LAN you would like to join. Type: Character string Value: 1 to 32 characters (This parameter is optional.) MAX_FRAME_SIZE The maximum AAL-5 service data unit (SDU) size of a data frame that can be transmitted or received. Type: Decimal number Value: 1516, 4544, 9234, or 18 190 (Default = 1516 for Ethernet, 4544 for Token-Ring) ENHANCED_MODE ATM Forum-compliant LAN Emulation requires that the client drop all connections during certain error conditions, such as in an LES failure or as in the loss of the connection to the LES. IBM's Enhanced Mode will maintain the data connections and will retry the connection to LES. Stations that have Enhanced Mode set can stay up during these failures and continue to communicate with other Enhanced Mode stations. Type: Character string Value: "YES" or "NO" (Default = "NO") UNI_VERSION This parameter can be AUTO, UNI 3.0, or UNI 3.1. This parameter either specifies which version of the ATM Forum User-Network Interface (UNI) Specification should be used by the driver or specifies that the driver should use Integrated Local Management Interface (ILMI) to query the switch to determine the appropriate version. If this parameter is set to UNI 3.0, then the driver will use ATM Forum UNI 3.0. If this parameter is set to UNI 3.1, then the driver will use ATM Forum UNI 3.1. If this parameter is set to AUTO, then the driver will query the switch using ILMI to determine the UNI version according to the procedure described in UNI 3.1. If the switch replies with UNI 3.0 or UNI 3.1, then the driver will use the matching version. If the switch does not reply to the query, then the driver will use UNI 3.0. Type: Character string Value: "AUTO", "UNI 3.0", or "UNI 3.1" (Default = "AUTO") MAX_CONNECTIONS The maximum number of SVC connections that the adapter can support. Type: Decimal number Value: 32 to 1024 (Default = 260) MAX_MULTIC_ADDR The maximum number of multicast addresses that this station supports. Note: In a token-ring network, this keyword sets the number of group addresses. Type: Decimal number Value: 8 to 64 (Default = 8) BEST_E_PK_RATE The peak rate for best-effort (data) connections (Kbps). Type: Decimal number Value: 1000 to 155 500, in increments of 100 (Default = 25 600) CNTRL_P_PK_RATE The peak rate for all control plane (signalling and ILMI) connections (Kbps). Type: Decimal number Value: 1000 to 155 500, in increments of 100 (Default = 25 600) AGING_TIMEOUT The time (in seconds) that ARP table entries (MAC addresses or route descriptors) are maintained without verification of their ATM addresses (work on this). Type: Decimal number Value: 10 to 300 seconds (Default = 300) CONN_COMP_TIMER The time (in seconds) in which data or a READY_IND message is expected from the calling party. Type: Decimal number Value: 1 to 10 (Default = 4) CONTROL_TIMEOUT The timeout period (in seconds) for most request and response control frame interactions. Type: Decimal number Value: 10 to 300 (Default = 120) LE_ARP_RSP_TIME The maximum expected time (in seconds) for the LE_ARP_REQUEST/LE_ARP_RESPONSE cycle to complete. Type: Decimal number Value: 1 to 30 (Default = 4) FLUSH_TIMEOUT The maximum time (in seconds) allowed to receive the LE_FLUSH_RESPONSE after the LE_FLUSH_REQUEST has been sent before recovery action is taken. Type: Decimal number Value: 1 to 4 (Default = 4) FRWRD_DELAY _TME The maximum time (in seconds) that an ARP entry for a non-local MAC address is maintained without verification. Type: Decimal number Value: 4 to 30 (Default = 15) LE_ARP_CACHE_SZ The number of entries in the ARP table that maintains the ATM addresses for LAN destinations. Type: Decimal number Value: 32 to 1500 (Default = 260) MAX_CFG_RETRIES The maximum number of times that a CONFIG_REQUEST is re-sent to the LECS and a JOIN_REQUEST is re-sent to the LES in the absence of a response during the join process. Type: Decimal number Value: 0 to 2 (Default = 1) MAX_RETRY_CNT The number of times that an LE_ARP request is retried. Type: Decimal number Value: 0 to 2 (Default = 1) MAX_UNKN_FR_CNT The maximum number of frames for a given unicast MAC address that can be sent to the Broadcast and Unknown Server (BUS). Type: Decimal number Value: 1 to 10 (Default = 1) PATH_SWTCH_DELY The time (in seconds) allowed from the sending of a frame to the BUS until the LEC assumes that the frame either has been discarded or has been delivered to the recipient. Type: Decimal number Value: 1 to 8 (Default = 6) VCC_TIMEOUT The time (in seconds) that the adapter maintains inactive data connections. Type: Decimal number Value: 30 to 99 999 999 (Default = 1200) ADAPTER_TYPE The type of adapter. Type: Decimal number Value: 4