IBM OS/2 WARP V3.0, NETBIOS + IEEE 802.2 + NETWARE REQUESTER (ODI2NDI)
Support Bulletin: 4040 Rev: D
ABSTRACT This document contains the instructions on how to add the network protocols NetBios, IEEE 802.2, and IPX (ODI) to OS/2 WARP v3.0 for all Racore Token Ring adapters and 100VG ISA and EISA adapters (PCI not currently supported). This procedure begins with a WARP installation where no network protocols are loaded. IBM LAPS and the NetWare Requester Installation for OS/2 are needed. It requires that you first temporarily modify the system's CONFIG.SYS file for use with any NetWare Requester driver, IBM's TOKEN.SYS is convenient because it's already present. Then, you will run LAPS and select NETBEUI, IBM IEEE 802.2, and IBM NetWare Requester Support to create the final CONFIG.SYS and PROTOCOL.INI files.
MATERIALS NEEDED:
1. Racore OS/2 NDIS driver from the Racore distribution diskette. Check manual for the correct driver name for your particular Racore adapter.
2. Novell NetWare Requester Installation program for OS/2 (v2.01 or higher), supplied by Novel on CD ROM or diskette.
3. IBM LAPS program (9-1-92 or later).
STARTING POINT:
Load IBM OS/2 WARP on your system's hard drive. The FAT file system is recommended because it allows you to easily edit configuration files from DOS; however, the HPFS file system is supported. No network connections or PCMCIA support is to be selected at this time. Install the NetWare Requester Installation program for OS/2 (to the \NETWARE directory) and IBM LAPS (to the IBMCOM directory) of your system's hard drive.
PROCEDURE:
1. From the \NETWARE directory of your system's hard drive, begin the NetWare Requester program.
Select "INSTALLATION"
Select "Requester on Workstation"
Select "Only Edit CONFIG.SYS"
From the "Choose ODI LAN Driver" window:
Enter the driver name TOKEN.SYS
From the "Choose NetWare Support for DOS and Windows Applications" window:
Select "OFF"
From the "Choose Optional
Protocols" window:
Don't make any selections
Press "SAVE"
The program will update your CONFIG.SYS and insert the command line for TOKEN.SYS (remember, TOKEN.SYS is only temporary and will be automatically replaced in a later step).
You may now exit the NetWare Requester Installation program. If your particular application requires a NET.CFG file (see Novell DOS ODI manual), you may remain in the program and select "CONFIGURE"
NOTE: Although you will eventually alter the CONFIG.SYS file to utilize a Racore OS/2 NDIS driver in a later step, it is necessary to first modify the CONFIG.SYS file for use with a NetWare Requester driver, otherwise LAPS will not correctly re-modify the CONFIG.SYS file in a later step.
2. From the \IBMCOM dircetory, run LAPS.
- Select "INSTALL"
You will be asked to enter the path
to the directory for the NIF files for your adapter. Insert the Racore distribution diskette
in drive A and type the path A:\IBMCOM.OS2.
You will be notified that the files have successfully been
copied. Return to LAPS main menu.
- Select "CONFIGURE"
- Select "Configure LAN Transports"
- From the "Configure Workstation" window:
add "Racore *** Adapter" (*** select particular Racore adapter)
add "IBM NETWARE REQUESTER SUPPORT"
add "IBM OS/2 NETBIOS" (optional)
add "IBM IEEE 802.2 (optional)
NOTE: Highlight "IBM NETWARE REQUESTER SUPPORT", select EDIT and enter a network address. You may enter the address printed on the adapter or any valid 12 digit address. For 100VG adapters, you must also change the TOKEN RING HEADER SUPPORT field to say "NO" and change the
ETHERNET 802.2 HEADER SUPPORT field to say "YES".
NOTE: You must also give IBM IEEE 802.2 an address via the EDIT utility as above.
FOR 100VG Adapters: Requires a PORT value in PROTOCOL.INI. One easy way to do this while inside LAPS: highlight "Racore *** Adapter", select EDIT and enter the PORT value reported by the adapter’s diagnostic utility VGDIAG. DO NOT ENTER ANY OTHER VALUES AS THIS WILL CAUSE THE NDIS DRIVER TO NOT LOAD: "Unable to find module configuration in PROTOCOL.INI"
Remember, for 100VG adapters, you must highlight "IBM NETWARE REQUESTER SUPPORT" and change the frame fields as mentioned above. press [OK]
Save the configuration and exit LAPS. This will have modified your CONFIG.SYS to load the selected Racore OS/2 NDIS driver and the ODI2NDI shim. It will also create the appropriate PROTOCOL.INI file. Examples of both are shown below.
NOTE: LAPS should REM out the lline DEVICE=TOKEN.SYS
in the CONFIG.SYS file (Netware
Requester section). Before re-starting your computer, check the
CONFIG.SYS file; if this
line has not been remarked out (REM), do so at this time and
save the file.
This completes the installation
for ISA and 100VG adapters. You may now shut down your
system and re-boot. If you are using
a PCMCIA in a notebook computer, continue the steps below.
For PCMCIA adapters
In addition to step 2 and 3 above, you must also:
- Copy the PCMCIA enabler file PCMDRI.OS2 from the Racore distribution diskette to the \NETWARE directory of your system's hard drive.
- Insert the PCMCIA enabler command line in the CONFIG.SYS file immediately preceding the command line which loads your particular Racore OS/2 NDIS driver. This will typically be near the bottom of the CONFIG.SYS file. An example is shown below:
DEVICE=C:\NETWARE\PCMDRI.OS2 (see manual for any needed switches)
DEVICE=C:\NETWARE\RCPTRNDS.OS2
- It may also be necessary for you to select PCMCIA support for your particular notebook computer using the "Selective Install" window. It is not currenctly recommended to select PCMCIA Hard Drive or PCMCIA Flash in this utility.
SAMPLE CONFIG.SYS (for RCPTRNDS.OS2)
IFS=C:\OS2\HPFS.IFS /CACHE:64 /CRECL:4
PROTSHELL=C:\OS2\PMSHELL.EXE
SET USER_INI=C:\OS2\OS2.INI
SET SYSTEM_INI=C:\OS2\OS2SYS.INI
SET OS2_SHELL=C:\OS2\CMD.EXE
SET AUTOSTART=PROGRAMS,TASKLIST,FOLDERS,CONNECTIONS,LAUNCHPAD
SET RUNWORKPLACE=C:\OS2\PMSHELL.EXE
SET COMSPEC=C:\OS2\CMD.EXE
LIBPATH=C:\IBMCOM\DLL;.;C:\OS2\DLL;C:\OS2\MDOS;C:\;C:\OS2\APPS\DLL;
C:\MMOS2;C:\NETWARE;L:\OS2;P:\OS2;L:\NLS;P:\NL
S;
SET
DPATH=C:\IBMCOM;C:\OS2;C:\OS2\SYSTEM;C:\OS2\INSTALL;C:\;C:\OS2\BITMAP;C:\OS2\MDOS;C:
\OS2\APPS;C:\MMOS2;C:\MMOS2\I
NSTALL;C:\NETWARE;L:\OS2;P:\OS2;L:\NLS;P:\NLS;
SET PROMPT=$i[$p]
SET HELP=C:\OS2\HELP;C:\OS2\HELP\TUTORIAL;C:\MMOS2\HELP;
SET GLOSSARY=C:\OS2\HELP\GLOSS;
SET IPF_KEYS=SBCS
PRIORITY_DISK_IO=YES
FILES=20
BASEDEV=IBMKBD.SYS
DEVICE=C:\IBMCOM\LANMSGDD.OS2 /I:C:\IBMCOM
DEVICE=C:\IBMCOM\PROTMAN.OS2 /I:C:\IBMCOM
DEVICE=C:\OS2\BOOT\TESTCFG.SYS
DEVICE=C:\OS2\BOOT\DOS.SYS
DEVICE=C:\OS2\BOOT\PMDD.SYS
BUFFERS=90
IOPL=YES
DISKCACHE=D,LW,AC:C
MAXWAIT=3
MEMMAN=SWAP,PROTECT
SWAPPATH=C:\OS2\SYSTEM 2048 2048
BREAK=OFF
THREADS=256
PRINTMONBUFSIZE=134,134,134
COUNTRY=001,C:\OS2\SYSTEM\COUNTRY.SYS
SET KEYS=ON
SET BOOKSHELF=C:\OS2\BOOK;C:\MMOS2;
SET SOMIR=C:\OS2\ETC\SOM.IR;C:\OS2\ETC\WPSH.IR;C:\OS2\ETC\WPDSERV.IR
SET SOMDDIR=C:\OS2\ETC\DSOM
REM SET DELDIR=C:\DELETE,512;E:\DELETE,512;
BASEDEV=PRINT01.SYS
BASEDEV=IBM1FLPY.ADD
BASEDEV=IBM2FLPY.ADD
BASEDEV=IBM1S506.ADD
BASEDEV=XDFLOPPY.FLT
BASEDEV=OS2DASD.DMD
SET EPMPATH=C:\OS2\APPS;
PROTECTONLY=NO
SHELL=C:\OS2\MDOS\COMMAND.COM C:\OS2\MDOS
FCBS=16,8
RMSIZE=640
DEVICE=C:\OS2\MDOS\VEMM.SYS
DOS=LOW,NOUMB
DEVICE=C:\OS2\MDOS\VXMS.SYS /UMB
DEVICE=C:\OS2\MDOS\VDPMI.SYS
DEVICE=C:\OS2\MDOS\VDPX.SYS
DEVICE=C:\OS2\BOOT\OS2CDROM.DMD /Q
IFS=C:\OS2\BOOT\CDFS.IFS /Q
DEVICE=C:\OS2\MDOS\VCDROM.SYS
BASEDEV=OS2SCSI.DMD
BASEDEV=AHA154X.ADD
DEVICE=C:\OS2\MDOS\VMOUSE.SYS
DEVICE=C:\OS2\BOOT\POINTDD.SYS
DEVICE=C:\OS2\BOOT\MOUSE.SYS SERIAL=COM1
DEVICE=C:\OS2\BOOT\COM.SYS
DEVICE=C:\OS2\MDOS\VCOM.SY
SAMPLE CONFIG.SYS (continued)
CODEPAGE=437,850
DEVINFO=KBD,US,C:\OS2\KEYBOARD.DCP
DEVINFO=SCR,VGA,C:\OS2\BOOT\VIOTBL.DCP
SET VIDEO_DEVICES=VIO_VGA
SET VIO_VGA=DEVICE(BVHVGA)
DEVICE=C:\OS2\MDOS\VVGA.SYS
SET MMBASE=C:\MMOS2;
SET DSPPATH=C:\MMOS2\DSP;
SET NCDEBUG=4000
DEVICE=C:\MMOS2\SSMDD.SYS
DEVICE=C:\MMOS2\R0STUB.SYS
REM --- NetWare Requester statements BEGIN ---
SET NWLANGUAGE=ENGLISH
DEVICE=C:\NETWARE\LSL.SYS
RUN=C:\NETWARE\DDAEMON.EXE
DEVICE=C:\IBMCOM\PROTOCOL\ODI2NDI.OS2
REM -- ODI-Driver Files BEGIN --
REM DEVICE=C:\NETWARE\TOKEN.SYS
REM DEVICE=C:\NETWARE\ROUTE.SYS
REM -- ODI-Driver Files END --
DEVICE=C:\NETWARE\IPX.SYS
rem DEVICE=C:\NETWARE\SPX.SYS
rem RUN=C:\NETWARE\SPDAEMON.EXE
rem DEVICE=C:\NETWARE\NMPIPE.SYS
rem DEVICE=C:\NETWARE\NPSERVER.SYS
rem RUN=C:\NETWARE\NPDAEMON.EXE
DEVICE=C:\NETWARE\NWREQ.SYS
IFS=C:\NETWARE\NWIFS.IFS
RUN=C:\NETWARE\NWDAEMON.EXE
rem DEVICE=C:\NETWARE\NETBIOS.SYS
rem RUN=C:\NETWARE\NBDAEMON.EXE
rem DEVICE=C:\NETWARE\VIPX.SYS
rem DEVICE=C:\NETWARE\VSHELL.SYS PRIVATE
REM --- NetWare Requester statements END ---
RUN=C:\IBMCOM\PROTOCOL\NETBIND.EXE
RUN=C:\IBMCOM\LANMSGEX.EXE
DEVICE=C:\IBMCOM\PROTOCOL\NETBEUI.OS2
DEVICE=C:\IBMCOM\PROTOCOL\NETBIOS.OS2
DEVICE=C:\NETWARE\PCMDRI.OS2 (ENABLER, FOR PCMCIA ADAPTERS ONLY)
DEVICE=C:\IBMCOM\MACS\RCPTRNDS.OS2 (Loads RCP type OS/2 NDIS driver)
SAMPLE PROTOCOL.INI
[PROT_MAN]
DRIVERNAME = PROTMAN$
[IBMLXCFG]
RCPTRNDS_nif = RCPTRNDS.nif
NETBEUI_nif = NETBEUI.nif
ODI2NDI_nif = ODI2NDI.nif
[NETBEUI_nif]
DriverName = netbeui$
Bindings = RCPTRNDS_nif
ETHERAND_TYPE = "I"
USEADDRREV = "YES"
OS2TRACEMASK = 0x0
SESSIONS = 40
NCBS = 95
NAMES = 21
SELECTORS = 5
USEMAXDATAGRAM = "NO"
ADAPTRATE = 1000
WINDOWERRORS =
MAXDATARCV = 4168
TI = 30000
T1 = 500
T2 = 200
MAXIN = 1
MAXOUT = 1
NETBIOSTIMEOUT = 500
NETBIOSRETRIES = 8
NAMECACHE = 0
PIGGYBACKACKS = 1
DATAGRAMPACKETS = 2
PACKETS = 350
LOOPPACKETS = 1
PIPELINE = 5
MAXTRANSMITS = 6
MINTRANSMITS = 2
DLCRETRIES = 5
[ODI2NDI_nif]
DriverName = odi2ndi$
Bindings = RCPTRNDS_nif
NETADDRESS = "00001a001234"
TOKEN-RING = "yes"
TOKEN-RING_SNAP = "no"
ETHERNET_802.3 = "no"
ETHERNET_802.2 = "no"
ETHERNET_II = "no"
ETHERNET_SNAP = "no"
TRACE = 0x0
[RCPTRNDS_nif]
DriverName = RCPNDS$
MAXTRANSMITS = 6
NUMRXBUFFERS = 6
RXBUFFERSIZE = 2048
