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