******************
** INSTRUCTIONS **
******************

The following are instrucions for setting up WAVPlayer for WebEx.
Please make sure you have read and agree to the license agreement
before using this program.


INSTALLATION
============


<SELECT LOCATION FOR PROGRAM FILES>

To install this program, simply create a directory (eg.: "C:\WebWAV"),
copy all files contained in this package into that directory.


<EDIT SYSTEM FILES>

Once you have copied the files into the directory of your choice, you
must make sure the following references are added to your PATH and
DPATH statements in your config.sys file:

        x:\WebWAV       <---- or whatever the drive and directory are named
                                        that you installed the application in.


<SET UP WEB EXPLORER TO USE THE BROWSER>

Start WebExplorer, select "Setup" then "Viewers". Choose .WAV file
and type WAVPLAY.EXE for the viewer name. You may do the same
thing with .MID and any other audio file OS/2 and MMPM/2 support
on your system (inotherwords, if you have an OS/2 plug-in for .au files
that allows you to use any of the IBM OS/2 players or system
commands to play it, this program will take advantage of it and play
that type of audio file). Close WebExplorer to allow the changes to be
saved. Make sure you did not have multiple copies of WebExplorer
running when you changed your WebExplorer settings and exited.


<SHUTDOWN AND RESTART OS/2 FOR CHANGES TO TAKE EFFECT>

Once you have shut down OS/2 and reloaded it, you are ready to go.
Wherever there is a link to a supported audio file, simply clicking
on it will launch the Player.


<ABOUT THE PROGRAM>

The program, through the use of OS/2 system services and APIs,
plays any MMPM/2 supported audio file. Thus, by adding support
for a new audio file, our player will be capable of playing
it. It does not launch the WAV Player that comes with OS/2,
nor take as long to work.

When you select a supported link, WebExplorer will load the file,
pass it to the player (as a temp file in a format like "09x90900.WAV"
or something similar. The player will launch and size itself to the
top left of the screen, giving you 4 options:

        SAVE:           Saves the file where specified and exits
                        back to WebExplorer.

        PLAY:           Plays the file and exits back to WebExplorer.

        SAVE n PLAY:    Launches a separate thread to play the
                        audio file and simultaneously asks where you
                        want it stored and named.

        EXIT:           Exit's with no action taken. The file will
                        not be stored or played.


<STOPPING THE FILE FROM PLAYING>

The play action may be stopped one of two different methods
depending on the choice you pick to initiate play. If you
choose "PLAY", you can stop play by closing the player window
by double-clicking the close button on the top left of the player window.

If you choose "SAVE n PLAY", you must pull up your window
list and shut down the player thread from there. "SAVE n PLAY"
spawns a separate thread which we have named and added
to the task list for this purpose. This method also works for
the "PLAY" choice by selecting and stopping the main app
from the window list.

<FILES DO NOT PLAY>

If a file does not play, generally the cause is the file is not
supported by MMPM/2. If you have a third party player that supports
the selected file, it does NOT make MMPM/2 enabled to support it.
You need to have a plug-in codec either with it's own installation
routine, or installed through the MMPM/2 installer to allow
formats that were not supported with the base OS/2 product to be
supported by our player.

Another cause is another process that is locking the sound card.
Usually, in this case, the player will wait till the card is avaiable and
play the file then. Usually, it is a WinApp or FastLoad or such.


<ABOUT THE PROGRAM>

The program is re-entrant multitasking, multithreaded code
(though part of the second thread is in an EXE file, it and it's
shared code in the main process are spawned and maintained as a
separate thread making calls to the same shared code in the DLL's).
You may launch as many copies of it as you have resources to handle.
The program does not share the sound card with other apps, though
it is a simple change we are considering. It does work fine when other OS/2
programs are using the sound card, though it will take over use to play
the file and return use when finished. If more than one copy of the program
are trying to play the file at the same time, whichever one has focus
will play and the other will stop and wait.

The program will automatically exit when it has finished it's task. If
you selected "PLAY" you will notice this as the program shuts down
and returns focus to WebExplorer or whatever app called it. If you
selected "SAVE n PLAY", it will close the main window and let
the thread close itself when playing is complete. The thread was
dependent on the main process that called it, but we preferred this
way, allowing a thread to be spawned to request, initiate and start
the multimedia controls required, load the secondary player and
pass the file info to it. The main process is calling the file dialog
box and waits for an entry to save the file. This does not affect
the player thread or secondary program.

While the program is playing the audio file, you have full usage
of the WebExplorer and may continue to browse through the web
or even start other audio files loading. So far, we havent hit
on a limit to the number of open players you may have.


<REASON FOR THIS PROGRAM>

We wrote this program for internal use and initially had it set
up to load minimized (we created and registered a window and
it's classes to allow an errant process to be shut down
from the task list) and play the file and exit. One of the
employees (Matt), in his enthusiam to make this difficult
for what was supposed to be a ten minute app, suggested
(annoyed the heck out of till I agreed??) that I add a SAVE
capability and a PLAY button, hence it's current format.

This program was written for internal use only as we were
quite tired of waiting for OS/2's Audio Player to load, load
the file, and then play it, wait for us to select exit, wait
for it to shut down, etc, etc...

Eventually (within 10 minutes of completion) we figured if
this might be of interest to someone else and of any use,
we might as well make it available for everyone. So, here
it is!


<ABOUT CYBERCOM>

CYBERCOM is an OS/2 and computer (hardware and software)
consulting company. We write custom OS/2 apps, do OS/2
networking, installations and upgrades. We also are staffed with
A+ Certified Service Technicians (certified for/by Compaq,
HP, IBM, Toshiba, Acer, CompUSA/Compudyne and many others).
Most of our employees are TeamOS/2 members and
CYBERCOM is a pending IBM BESTeam member.

Our current main programming project (non-Web related) is
an accounting package designed from the ground up for OS/2,
fully exploiting the following OS/2 technologies:

        Top tabs (Lotus infobox style)
        VoiceType Dictation and control
        Multiple threads
        Multiple printer usage and network printer support
        Multimedia usage for various parts of the application
                (such as "walk-through" help)
        Full integration with the WPS and fully object
                oriented interface

The application will also provide many of the features found
in it's WinXX counterparts, along with other features (some mentioned
above) that cannot be easily or usably implemented
on their 16bit OS platforms.



CYBERCOM is located in Virginia and can be reached by email at:

        cybercom@erols.com


Please drop us a line and let us know whether the WAV program
is of any use to you - also feel free to comment on our other projects
or any other programs you would like to see us write.


This document (c) 1996 CYBERCOM

WAVPlayer for WebEx     (c) 1996 CYBERCOM and
                        (c) 1995-1996 OnLine Data. All rights reserved.