********************************************************************** ADDITIONAL NOTES ABOUT USING MWAVE IN OS/2 2.11 AND WARP (c) 1996, IBM Corp. 2:21 p.m., July 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. Y Y 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 CID Installing the Audio Features Diskette (VSD) 2.4 Installing MIDI Samples 2.5 Using the LAN Installation Feature 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 an 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. 11. If the message "ThinkPad System Management Device Driver is not installed" appears during installation, run the OS/2 Device Driver Install application. Use ThinkPad Utilities diskette number two and select "ThinkPad System Management Device Driver" from the menu. 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 install 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 and add the /COM3 param- eter to the 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 your 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. ---------------------------------------------------------------------- 2.3 CID Installing the Audio Features Diskette (VSD) ---------------------------------------------------------------------- NOTE: An example VSD.RSP file exists on the Audio Features Diskette 1. On the OS/2 desktop open an OS/2 Window. 2. Copy the contents of the diskette into an empty directory. Example: {x:\CIDVSD}XCOPY A:*.* /S where x = drive letter of VSD CIDVSD = directory from which VSD will be installed 3. Create a response file by performing a VSD install using MINSTALL and answering all the questions during the install. Example: {x:\CIDVSD}MINSTALL /C:VSD.RSP where x = drive letter of VSD CIDVSD = directory from which VSD will be installed /C: = command to create response file VSD.RSP = response file name 4. Perform the VSD CID install. Example: {C:\}x:\CIDVSD\SETUP /R:VSD.RSP where x = drive letter of VSD CIDVSD = directory from which VSD will be installed /R: = command to use response file VSD.RSP = response file name NOTE: Non-US users must run the Country Selection Application AFTER Mwave installation and reboot. Reboot again after running the Country Selection Application. ---------------------------------------------------------------------- 2.4 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. 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.5 Using the LAN Installation Feature ---------------------------------------------------------------------- Use the LAN installation feature to install Mwave from a shared disk con- nected to a local area network (LAN). o Initial Setup: 1. Create a directory structure to hold all the Mwave diskettes. Copy the related diskettes into the directory. One method is to use XCOPY with the /S switch. XCOPY A:\*.* /S C:\MWAV_WIN An example directory structure follows: Example Path What diskettes to XCOPY ============ ======================= x:\CID\MWAV_WIN Mwave Windows Diskettes 1 and 2 x:\CID\SAMP_WIN Mwave Samples Windows Diskette 1 and Common Diskettes 2-6 x:\CID\MWAV_OS2 Mwave OS/2 Diskettes 1 and 2 x:\CID\SAMP_OS2 Mwave Samples OS/2 Diskette 1 and Common Diskettes 2-6 x:\CID\MWAV_VSD Mwave OS/2 VSD Diskette 1 (There is no CID.LST file for this diskette) (Where x is the network drive where you will copy these files.) 2. The CID.LST file is on the first diskette for OS/2, Windows and each Samples diskette. These files contain the automatic instal- lation information needed to use the LAN installation feature. The CID.LST file contains the Mwave installation defaults, but you may modify them to change the destination of the Mwave soft- ware. o Windows Installation Procedure: 1. Go to the workstation where you want to install the Windows Mwave software. Select FILE and RUN from the Program Manager and type: x:\CID\MWAV_WIN\SETUP.EXE y:\CID\MWAV_WIN CID.LST (Where x:\CID\MWAV_WIN\SETUP.EXE is the fully-qualified path to the shared disk where the installation files reside and where y:\CID\MWAV_WIN is the fully-qualified path to the location of the CID.LST file.) 2. After the install is complete, shut down Windows and reboot the computer. NOTE: If Mwave software for OS/2 is not installed, do so before you install Mwave MIDI Samples. NOTE: Install Mwave MIDI samples from either Windows or OS/2, not both. 3. Go to the workstation where you want to install the Mwave MIDI Samples from Windows. From the Program Manager, select FILE, then RUN, and type: x:\CID\SAMP_WIN\SETUP.EXE y:\CID\SAMP_WIN CID.LST (Where x:\CID\SAMP_WIN\SETUP.EXE is the fully-qualified path to the shared disk where the installation files reside and where y:\CID\SAMP_WIN is the fully-qualified path to the location of the CID.LST file.) 4. After the install is complete, shut down Windodo and reboot the computer. o OS/2 Installation Procedure: 1. Go to the workstation where you want to install the OS/2 Mwave software. Open an OS/2 window and type: x:\CID\MWAV_OS2\SETUP.EXE y:\CID\MWAV_OS2 CID.LST (Where x:\CID\MWAV_OS2\SETUP.EXE is the fully-qualified path to the shared disk where the installation files reside and where y:\CID\MWAV_OS2 is the fully-qualified path to the location of the CID.LST file.) 2. After the installation is complete, shut down OS/2 and reboot. 3. To install the VSD software, open an OS/2 window and type: x:\CID\MWAV_VSD\SETUP.CMD (Where x:\CID\MWAV_VSD\SETUP.EXE is the fully-qualified path to the shared disk where the installation files reside.) 4. Follow the displayed installation instruction and, when the installation is complete, shut down OS/2 and reboot. NOTE: If Mwave software for Windows is not installed, do so before you install Mwave MIDI Samples. NOTE: Install Mwave MIDI samples from either Windows or OS/2, not both. 5. Go to the workstation where you want to install the Mwave MIDI Samples for OS/2. Open an OS/2 window and type: x:\CID\SAMP_OS2\SETUP.EXE y:\CID\SAMP_OS2 CID.LST (Where x:\CID\SAMP_OS2\SETUP.EXE is the fully-qualified path to the shared disk where the installation files reside and where y:\CID\SAMP_OS2 is the fully-qualified path to the location of the CID.LST file.) 6. After the install is complete, shut down OS/2 and reboot. ====================================================================== 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 usually 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 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. C-Kermit 3. Ymodem-G 4. TETE 5. ASCII 6. 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: What are Mwave's fax restrictions? A: Mwave supports fax transmissions of monochrome text and images up to 8 1/2 inches wide (A4 width). Mwave does not support B4 width trans- missions. 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: How can I prevent the noise in my 8 bit recordings? A: An 8 bit recording is naturally noisy. To reduce the noise level of your recording, use 16 bit recording. Q: When I connect an external CD player through the "Line In" input and play a CD, I Ion'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". 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. ---------------------------------------------------------------------- 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 a Sound Blaster 1.5 (SB) 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 3.x Lotus Notes 3.x 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 3.x. 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. o Digital Audio Application When using the OS/2 Digital Audio Application make sure that the MONITOR INPUT selection (in the OPTIONS pulldown) is not checked. If it is checked, you may experience unreliable system operation. When the MONITOR INPUT is not checked, the Digital Audio Application no longer monitors recording and the recording function performs reli- ably. ====================================================================== 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. ---------------------------------------------------------------------- 5.2 Notes About the Mwave Speaker Phone ---------------------------------------------------------------------- Some speaker phone volume controls malfunction at maximum output. There- fore, if the volume slider is at maximum volume and you cannot hear the other party, lower the slider to 75% volume.