Notes about NWCWRT.EXE (8/11/94)
===== ===== ====== =============

In order for Novell software (such as NetWare Connect or LAN Workplace
for DOS) to use your modem it must have a modem description file with
the scripts to control your modem.  The files in NWCWRT.EXE will
enable you to create such files. 

TEST.MDC    Example modem script file
MDMCVT.EXE  Program to convert from ASCII to binary
MDMTXT.EXE  Program to convert from binary to ASCII

Below is a brief description of each software tool.

MDMWIN
A Windows application for creating and editing binary modem description files. This is the software tool to start
creating your modem description files.  MDMWIN has a SETUP program to help your install MDMWIN under Windows easily.  Use the MDMTXT program (described later) to print your script.

MDMCVT
Converts an ASCII Modem Description into a binary format.
 Use :  MDMCVT <options> <source file> <dest file>
  options = ? - help

  source file - file containing ASCII description of a modem.

  dest file - file containing Binary formatted description of a modem

MDMTXT 
Converts an binary Modem Description into ASCII format.
 Use :  MDMTXT <options> <source file> <dest file>
  options = ? - help

  source file - file containing Binary formatted description of a         modem

  dest file   - file to receive ASCII description of modems.

Creating Modem Description Files                             
--------------------------------
The following procedure is recommended for creating a modem description file to enable your modem to be used by NetWare Connect or LAN Workplace for DOS.

Before attempting this process please read the NetWare Modem Description File Specification.

NetWare Connect allows multiple modem files to be present simultaneously.  When a user is configuring the server or client component they will be presented with a list of modems contained in all of the .MDC files.  This allows you to create your own modem description file that contains all of your modems independent of other modem description files.

The user merely puts the file in the appropriate directory and support for your modem is added to the system.

In most cases an existing modem script will be very similar to yours, it is convenient to use that as a starting point for editing.

1. Convert the MDC file containing the selected modem into an ASCII file by using the MDMTXT program.

2. Using your favourite text editor remove all but the relevant modem script.  Duplicate records if you will have multiple modems defined within the same file.  You may desire to have multiple records for the
same modem but with different settings so that the customer can select the one that meets his particular situation.  If you do do this, the modem name string must be unique for each record, and ideally it should be apparent from the modem name string what that particular setting does.

3. Edit the ASCII file to match your modem.  In particular remember to change the modem name, manufacturer, version number and copyright fields.

Much of the editing can be performed using MDMWIN on the binary file directly however it is not currently possible to duplicate records or edit these fields with the windows utility.

4. Convert the ASCII file to binary using the MDMCVT program.  Use a file name that is unique and easily recognizable as pertaining to your company's modems.  I would recommend using a form of your company name that will fit in the DOS file naming convention.  The extension should be .MDC.  The file should contain all of your modems in the one file.
Please contact Novell Labs and register your file name and modem names so that we can ensure uniqueness.

5. Edit the binary directly (if necessary) using the MDMWIN program.

6. Test the script using NetWare Connect.  RNS and NCS in modem independent mode both use the modem scripts.  The RNS client software also uses the scripts.

You should dial into the NetWare Connect server using the Remote Node Service with a variety of modem speeds and verify correct operation.

You should also dial-out from the NetWare Connect using the NCS capability with modem independent mode selected.
(In this mode your script is substituted for the AT command set issued by the workstation)

Again you should try this with a variety of speeds and conditions such as no-answer, busy etc.

Should you have any further questions, please contact us at Novell
Labs in San Jose.
Novell Labs
Novell Inc.
Voice (408) 577-7201
Fax   (408) 577-5507
email kevin@novell.com