**********************************************************************

ADDITIONAL NOTES ABOUT USING MWAVE IN OS/2 2.11 AND WARP

(c) 1996, IBM Corp.
5:24 p.m., May 1, 1996
**********************************************************************

--------------------
INTRODUCTION
--------------------

This document provides information to help you properly run Mwave appli-
cations in IBM's OS/2.  A list of "frequently-asked questions" (FAQs)
presents answers to questions or problems you may encounter while working
with the Mwave product. Other topics include solutions to compatibility
issues and installation problems, as well as additional technical notes.

-----------------------
Printing This Document
-----------------------

To print this document from OS/2, type the following command at the
prompt:

              PRINT README.TXT

------------------------
Other Helpful Documents
------------------------

Use the OS/2 command VIEW to read the following online documents which
provide additional information about Mwave applications:

     OS2MAIN.INF    This help file presents a general overview of all
                    the components in Mwave.


You may also want to refer to the associated Windows ReadMe text file for
additional information. This document is a particularly useful reference
if applications are run under Win-OS/2 or in a DOS Full Screen session.

======================================================================
CONTENTS
======================================================================

    1.0  BEFORE YOU CALL FOR HELP

    2.0  INSTALLATION NOTES

        2.1  Installing Mwave for Windows on a Computer with OS/2
        2.2  Installing Mwave for OS/2
        2.3  Installing MIDI Samples
        2.4  Configuration Conflicts with IBM Network Adapters

    3.0  FREQUENTLY-ASKED QUESTIONS (FAQs)

        3.1  FAQs about the Mwave Modem
        3.2  FAQs about Mwave FAX Capabilities
        3.3  FAQs about Mwave Audio Features
        3.4  FAQs about Mwave's Telephone Country Selection Utility
        3.5  FAQs about Mwave's Sound Blaster Emulation

    4.0  COMPATIBILITY

        4.1  Microsoft Windows 3.x
        4.2  DOS FAX Applications
        4.3  FAX Applications using Win-OS/2
        4.4  Other Applications and Mwave

    5.0  OTHER TECHNICAL NOTES

        5.1  Recommendations for Optimum Mwave Modem Performance

======================================================================
1.0  BEFORE YOU CALL FOR HELP
======================================================================

Before you call the technical support group, please read this entire doc-
ument for any installation, configuration, or compatibility information.
Also, the FAQs provide a good basis for answering most common questions.

If the document does not provide a solution and you need to contact tech-
nical support, please have your computer running. For faster service,
have the following information ready for our technical support personnel:

o   Make and model of your computer
o   Mwave software version number
o   Names and version numbers of application software you are running
o   Contents of your CONFIG.SYS file (You can either print the file, or
    have access to an editor to view it.)

======================================================================
2.0  INSTALLATION NOTES
======================================================================

No installation errors have been reported. Please contact Product Support
if you encounter a problem during installation of the Mwave product.

----------------------------------------------------------------------
2.1  Installing Mwave for Windows on a Computer with OS/2
----------------------------------------------------------------------

To install Mwave for Windows on a computer on which only OS/2 Warp is
installed:

1.  Start a Win-OS/2 full screen session.
2.  Install Mwave according to the instructions that accompany the
    product.

To install Mwave for Windows on a computer on which both OS/2 Warp and
Windows are installed:

1.  Boot your computer from DOS and then start Windows.
2.  On the menu bar, select FILE and RUN.
3.  Place installation diskette #1 in the 3.5-inch diskette drive.
4.  Type a:\setup and select OK or press Enter.
5.  Follow the instructions until the "Installation Successful" dialog
    box appears.
6.  Click OK to return to the Windows desktop.
7.  Reboot your computer to OS/2 Warp and start a Win-OS/2 full screen
    session.

NOTES:

1.  The order in which you install Mwave for Windows is not significant.
    If you prefer, install Mwave in Win-OS/2 and then reboot and install
    Mwave in Windows.
2.  You must install Mwave for Windows in OS/2 and in Windows to update
    the SYSTEM.INI and WIN.INI files for each operating system.  The \MWW
    directory can be shared.

If, after Mwave Windows installation, there is no sound for Win-OS/2
applications, make sure that x:\MWAVEOS2\BIN;x:\MWW\DLL (where x is the
drive where Mwave is installed) is in the PATH statement in the Win-OS/2
version of the AUTOEXEC.BAT.

----------------------------------------------------------------------
2.2  Installing Mwave for OS/2
----------------------------------------------------------------------

NOTE:  Before proceeding with the software installation, save and close
all open applications.  If you do not save and close all applications,
you may lose data.

To install Mwave for OS/2:

1.  Insert installation diskette #1 into the 3.5-inch diskette drive.
2.  Open an OS/2 window.
3.  At the OS/2 command prompt, type a:\setup and press Enter (where a is
    the drive that contains installation diskette #1).
4.  After an introductory screen briefly displays, the Mwave OS/2 Install
    window appears.  Type the drive and directory path where you want to
    install the Mwave OS/2 files (the default is C:\MWAVEOS2).  Click OK
    or press Enter.
5.  As the installation continues, the program displays progress informa-
    tion and prompts you to insert each installation diskette.  Click OK
    to continue.
6.  The "Installation Successful" dialog box appears.  Click OK to return
    to the OS/2 Desktop, which now contains a Mwave for OS/2 icon.
7.  Remove the last diskette from your disk drive, then shutdown and
    restart your system.
8.  Insert the VSD Warp Audio installation diskette.
9.  Open an OS/2 window and type a:setup to install the VSD Audio compo-
    nents.
10. Remove any diskettes from your disk drive, then shutdown and restart
    your system before you use Mwave or applications which make use of
    Mwave functions.

If you have installed Mwave under all environments with which you intend
to use it (such as Windows, OS/2, and DOS), you can now inst all Mwave's
MIDI Samples. Refer to "Installing MIDI Samples" for more information.

If you install Mwave for OS/2 and the Mwave Modem does not start, you may
have a COM port conflict.  If you have a serial mouse and a serial port
in your personal computer, edit the CONFIG.SYS to the /COM3 parameter to
COM.SYS statement.  By default, COM.SYS is set to COM1 or COM2; adding
the COM3 parameter enables the Mwave Modem to use COM3.

If you personal computer includes a CD-ROM player that is attached to the
Mwave adapter and, after Mwave for OS/2 installation, that CD-ROM player
produces no sound, make sure that the Auxiliary Control program is
started.

NOTE:  Non US users must run the Country Selection Application AFTER
Mwave installation and reboot.  Reboot again after running the Country
Selection Application.

----------------------------------------------------------------------
2.3  Installing MIDI Samples
----------------------------------------------------------------------

(NOTE:  MIDI Sample installation is not required if you are upgrading
from a previous Mwave installation.)

To install the Mwave MIDI Samples:

1.  Complete the installation of Mwave on those operating systems you
    intend to use (e.g. DOS, OS/2, WIN-OS/2 and/or Windows) BEFORE you
    install Mwave's MIDI Samples. Reboot your computer.

    The MIDI Samples installation procedure checks to see which operating
    systems you've installed Mwave on.
2.  Choose the environment in which you want to install MIDI Samples.
3.  Insert Disk 1 of the MIDI Full Samples in your floppy drive.
4.  Respond "Yes" or "No" as appropriate to the prompts asking if you
    want to install the selected type of MIDI sample under each environ-
    ment.
5.  When the installation is complete, reboot your computer.

----------------------------------------------------------------------
2.4  Configuration Conflicts with IBM Network Adapters
----------------------------------------------------------------------

When you install the Reference Adapter in a personal computer (PC) that
contains an IBM Token-Ring Network Adapter, an IBM Ethernet Adapter, or
both, system resource conflicts may occur.  System resource conflicts may
prevent you from booting the PC and will result in error messages and/or
a black screen.

To correct this problem:

1.  Power off the PC and insert a DOS boot diskette in the diskette
    drive.  Then power on the PC.

2.  Change the directory for OS2 to:

        -   CD X:\MWAVE0S2\BIN

        (Where X is the drive where Mwave is installed.)

3.  Type MWCONFIG and press Enter.  The Hardware Configuration Utility
    appears.

4.  Configure the IRQs such that no IRQ is set to 10, and click Update to
    save the changes.

5.  Power down the PC and remove the DOS boot diskette.  Then power on
    again.

======================================================================
3.0  FREQUENTLY-ASKED QUESTIONS (FAQs)
======================================================================

This section contains answers to questions about certain features and
capabilities provided by Mwave applications.

----------------------------------------------------------------------
3.1  FAQs about the Mwave Modem
----------------------------------------------------------------------

Q: What should I do if I answer an incoming phone call with the handset
   and then discover that the call is a fax or modem transmission?

A: Fax machines and modems are set up to call back several times if they
   fail to make a connection.  Therefore, hang up and, when the fax
   machine or modem calls back, allow the PC to answer the call.  Mwave
   enables the PC to discriminate (determine the call type) and either
   pass the call to the open fax or modem application, or take a message
   for a voice call.

Q: What settings do I need to use when I install a communications appli-
   cation (such as ProComm or CrossTalk)?

A: Your communications software requires that you provide a modem type, a
   baud rate (i.e, the speed of your modem), and the COM port to which
   the modem is attached.

   The chart below describes settings required by Mwave:

       To set this...        Select highest ranking available setting...
       -------------------------------------------------------------------
       The Modem type        1. Mwave modem
                             2. Generic Hayes-type modem
                             3. User-defined modem
                             4. Hayes SmartModem 2400
                             5. Hayes modem
                             6. Hayes compatible modem
                             7. Other (Note: If you select a modem of
                                   type "Other," you must include the
                                   proper modem initialization string.
                                   For most applications, the
                                   initialization string "AT&F" will
                                   work. See the Mwave Modem online
                                   help for more information.)

       Baud Rate             57,600 bps, or the maximum setting offered
                             by your communications software.

       COM Port              COM 1 or 2

Q: Do I need to change any configuration information if I replace COM.SYS
   in Warp?

A: If you replace COM.SYS, the standard communications device driver in
   Warp, you must modify the CONFIG.SYS file. Make sure the DEVICE state-
   ment for the Mwave Board Driver (see below) immediately precedes the
   identification of the new communications driver. For example, if you
   were to add the new driver SIO.SYS, your CONFIG.SYS should include:

           .
           .
           DEVICE=MWAVEOS2\BIN\MWBD0400.SYS
           DEVICE=SIO.SYS
           .
           .

Q: What can I do if my 300 baud modem connections are unreliable?

A: Use the next higher setting (or baud rate) and try again. It is recom-
   mended that you use the highest possible setting of your Mwave Modem.

Q: What port speed should I use when I connect my modem at 2400 bps?

A: If you attempt to force the modem to connect at 2400 bps by setting
   the port speed to that value, the connection may not be made or it may
   fall back to 2400 nECL or 1200.  To avoid this problem, set the port
   speed to a higher value.

Q: What host application transfer protocol is recommended for best Mwave
   Modem performance?

A: For best throughput when sending or receiving data, select the
   highest-ranking available transfer protocol listed here.

   1.  ZMODEM
   2.  Ymodem-G
   3.  TEXT
   4.  ASCII
   5.  XMODEM (only as a last resort)

   For more information, see Section 5.1  Recommendations for Optimum
   Mwave Modem Performance.

----------------------------------------------------------------------
3.2  FAQs about Mwave FAX Capabilities
----------------------------------------------------------------------

Q: What setting should I use for the "fax/modem type" when I set up my
   Class 2 FAX software to work with Mwave if "Mwave Modem" isn't listed
   as an option?

A: For all FAX applications, if "Mwave Modem" is not listed, select
   "Generic Class 2" or some comparable label from the application's list
   of supported fax/modems.

Q: What should I do if I answer an incoming phone call with the handset
   and then discover that the call is a fax or modem transmission?

A: See first Q & A in the above section, FAQs About the Mwave Modem.

Q: Why do I receive a Windows General Protection Fault (GPF) when I try
   to start FaxWorks under Win-OS/2?

A: The GPF occurs when you try to open FaxWorks under Win-OS/2 and the
   Mwave Modem is open in OS/2. Close the Mwave Modem for OS/2 and re-
   start the FaxWorks application in Win-OS/2.

----------------------------------------------------------------------
3.3  FAQs about Mwave Audio Features
----------------------------------------------------------------------

Q: What should I do when I receive the message "MIDI is not available"
   after starting a MIDI application following Digital Audio?

A: Ignore the error message and click "OK" to continue.

Q: When I play a MIDI file in OS/2 and then perform a suspend/resume,
   what do I need to do to return the MIDI sounds to normal volume?

A: You should close the MIDI application before you perform the
   suspend/resume. However, if the volume of MIDI sounds decreases fol-
   lowing a suspend/resume, you should close the MIDI application and
   then restart it.

Q: What should I do when I receive a message indicating that the "DSP
   module was not found" after starting Digital Audio while the MIDI
   application is active?

A: Ignore the error message and click "OK" to continue.

Q: When I connect an external CD player through the "Line In" input and
   play a CD, I don't hear any sound. How do I fix this?

A: To play sound from an external CD player, you must make sure that the
   Mwave recognizes the attached device. To do this:

   1.  Open the Mwave Auxiliary Control Panel.
   2.  Enable "Line + CD".

You can change the Country Selection by clicking on the icon in the Mwave
folder in OS/2.

Q: What should I do if the country I need is not listed?

A: Contact your IBM representative for information and support for that
   country.

Q: How do I stop feedback from occurring when I use my microphone?  A:
Lower the peak levels for playback and record for your microphone.

1.  Open Mwave Audio Control from the Mwave program group.
2.  Click on the MIC button.
3.  Click and drag the microphone (MIC) slide controls to a lower level.
4.  Resume using the microphone.

(Note:  When the play pushbutton is selected, make sure that the micro-
phone check box is not selected.)

----------------------------------------------------------------------
3.4  FAQs about Mwave's Telephone Country Selection Utility
----------------------------------------------------------------------

Q: What is Country Selection?

A: The Mwave Telephone Country Selection program is used to set country
   specific parameters for Mwave telephony functions including Modem,
   FAX, speakerphone, and Telephone Answering Machine.  The Mwave tele-
   phony drivers use the Country selection information to permit reliable
   and safe connection to the appropriate telephone network.

      **********
       WARNING:    Improper selection of the telephone network may cause
      **********   unreliable operation.

You can change the Country Selection by clicking on the icon in the Mwave
folder in OS/2.

Q: What should I do if the country I need is not listed?

A: Contact your IBM representative for information and support for that
   country.

----------------------------------------------------------------------
3.5  FAQs about Mwave's Sound Blaster Emulation
----------------------------------------------------------------------

Q: What sound card does Mwave emulate?

A: Mwave emulates both a Sound Blaster 1.5 (SB) card and a Sound Blaster
   Pro (SB Pro) card.

Q: Can I run DOS games in an OS/2 DOS box?

A: Yes. But be careful: when using Mwave Games support in an OS/2 DOS
   box, only the first DOS box can actually use MWGAMES. Any other DOS
   boxes you may have open will not give you the proper SoundBlaster emu-
   lation you need to play DOS-based games.

----------------------------------------------------------------------
3.6  FAQs about Mwave Power Management
----------------------------------------------------------------------

Q: Why doesn't the Suspend/Resume operation work properly after I change
   MIDI voices in Win-OS/2 using the Mwave MIDI Select Synthesizer?

A: Win-OS/2 needs to load the new MIDI voice driver, which it can do only
   after restarting. To ensure reliable Suspend/Resume operation when
   changing MIDI voices in Win-OS/2:

   1.  Select "Restart Windows". Windows reboots.
   2.  Close and re-open the Win-OS/2 session.

Q: If I try to do a Suspend/Resume with multiple Win-OS/2 sessions open,
   my system responds with errors. Is this normal?

A: Yes. Restart the Win-OS/2 sessions to fix the problem(s).

======================================================================
4.0  COMPATIBILITY
======================================================================

Read through this section if you have any problems with a specific appli-
cation working with Mwave.

----------------------------------------------------------------------
4.1  Microsoft Windows 3.x
----------------------------------------------------------------------

If you first start Mwave functions (such as the Modem or Discriminator)
in OS/2, you can run most Windows-based applications in either a Win-OS/2
Full Screen session or a Win-OS/2 Seamless session.

However, some Windows applications (specifically those designed to use
the Mwave MCI API) require that you install Mwave for the Windows envi-
ronment. These applications include:

o   Smith Micro QuickLink II Message Center

o   SofNet FaxWorks for Windows

o   Trio DataFax (if using the Mwave compatibility mode)

----------------------------------------------------------------------
4.2  DOS FAX Applications
----------------------------------------------------------------------

o   BIT Software's BitFax v. 4.05A

    Send and MANUAL receive functions work reliably. Automatic receive
    does not work reliably with the Mwave Class 2 upgrade at this time.
    To get past this problem, transmit a fax (of any kind) before
    attempting to automatically answer and receive a fax. Once a fax has
    been set, BitFax works properly.

----------------------------------------------------------------------
4.3  FAX Applications using Win-OS/2
----------------------------------------------------------------------

o   General Notice

    Windows Class 2 FAX applications may not work reliably if run under a
    Win-OS/2 Full Screen or Win-OS/2 Seamless session. You may notice
    this problem only occurs at specific transmission speeds, partic-
    ularly 9600 and 14400 bps. Tests have revealed that Ray Gwinn's SIO
    COM drivers (available on Compuserve in the "OS/2 B Vendor+" forum)
    eliminate this problem.

----------------------------------------------------------------------
4.4  Other Applications and Mwave
----------------------------------------------------------------------

o   Lotus Notes

    Lotus Notes does not properly recognize the Mwave modem. Lotus does
    not include an .MDM file that describes the Mwave commands and
    responses.

    To fix this problem, obtain a copy of the MWAVE.MDM file from the PCC
    BBS and add it to the \NOTES directory. Follow these steps:

    1.  Start Lotus Notes.
    2.  Select the modem configuration. The list of choices should now
        include the Mwave modem.
    3.  Choose the Mwave modem from the list.
    4.  Return to Notes and use as you usually would.

======================================================================
5.0  OTHER TECHNICAL NOTES
======================================================================

This section provides additional technical information and support for
specific uses of Mwave functions and/or applications.

----------------------------------------------------------------------
5.1  Recommendations for Optimum Mwave Modem Performance
----------------------------------------------------------------------

IBM recommends the following settings or conditions for best performance
from your Mwave Modem:

o   For best throughput when sending or receiving data, select the
    highest-ranking available transfer protocol listed here.

    1.  ZMODEM
    2.  Ymodem-G
    3.  TEXT
    4.  ASCII
    5.  XMODEM (only as a last resort)

o   Try to ensure that your communication application fully utilizes the
    First In--First Out (FIFO) capabilities provided by Mwave.  Specif-
    ically, the application should fill the FIFO six (6) or more charac-
    ters per interrupt during transmit.  For OS/2 2.1 and 2.11, you can
    use an enhanced COM driver, such as Ray Gwinn's SIO COM drivers, to
    fully utilize the FIFO.

o   You should enable Hardware Flow Control. Use the Hayes command AT\Q3.

o   Select a modem protocol from this list, with (1) providing the best
    performance, and (6) giving the worst.

        Protocol                   AT Commands use to get protocol
       ------------------------------------------------------------
               1. V.42 / V.42bis              AT\n7"H3
               2. MNP 1-4 / V.42bis           AT\n3"H3
               3. MNP 1-4 / MNP5              AT\n3"H0
               4. V42                         AT\n7"H0
               5. MNP1-4                      AT\n3%C0"H0
               6. non-error corrected         AT\n0

    Refer to the online help available in Mwave Modem for explanation of
    the AT commands required to use one of the above modem protocols.

o   Trouble Connecting at 28.8 kbps

    If you experience difficulties connecting at a modem speed of 28.8
    kbps to a particular number, or if you have trouble connecting to a
    particular modem rotary, try the following.

    -   If the connection is not made and the speaker is OFF:

        1.  Disable V.42 bis and MNP 5 using AT"H%C
        2.  Disable V.42 (AT\N3) or MNP 1-4 (AT\N5). You could also
            disable both with AT\N.

    -   If the connection is not made and the speaker remains on:

        1.  Reduce the maximum modem throughput using the AT commands
            ATs28=18 (for 26400 bps), ATS28=17 (24000 bps), ATS28=16
            (21600 bps), or ATS28=15 (19200 bps).
        2.  If you've tried step 1 and it still does not connect, use
            AT*TH8 to control the speed.

            Once you connect using the AT*TH8 command, remember to reset
            your modem using either AT&F (for factory defaults) or
            AT*TH4. If you forget to reset, your next calls will transmit
            at lower V.34 connection rates.
