Chapter 2

Startup


The MODEM MGR software consists of three 5-1/4 inch floppy disks. Programs are
written on both sides of these disks for a total of six sides.  One disk is the
ProDOS version which has the work program on one side and the install program on
the other side.  The second disk is the DOS 3.3 version which also has the work
program on one side and the install program on the other side.  The third disk
is the utility disk which contains several emulation files and the program which
generates these files.  One side of the utility disk is the ProDOS version and
the other side is the DOS 3.3 version.  The ProDOS side of the utility disk also
as the serial printer drivers used by the ProDOS install program.

If you intend to use only one operating system exclusively (ProDOS or DOS 3.3),
you need only three of the six disk sides.  Two of these three sides are used
initially to install and configure the program.  After installation, you will
use only one disk side.


BACKUP DISKS

Before doing anything else, you should make a backup copy of both sides of the
disks.  Store the originals in a safe place and use the copies instead.  the
disks are not copy protected so the use of a bit copier is not necessary and not
recommended.  The DOS 3.3 COPYA program or the ProDOS FILER program is
recommended.  Be suer to label the disks according to operating system (ProDOS
or DOS 3.3) and type (work, install or utility disk).  Place a write-protect
sticker on the install disks, but not on the work disks.


QUICK STARTUP

You will obtain maximum usefulness out of this program if you read the manual
completely before attempting to run the program. However, if you wish to start
using the program as soon as possible, this chapter will provide the essentials
needed to get started.  If you have already installed a video card and modem in
your system and they are working properly, you may be able to start using this
program without much effort.

However, if you have not cabled some of your communications devices to your
computer or you are not sure everything is functioning properly, you should skip
this chapter and start at Chapter 3 instead.  Chapter 3 and subsequent chapters
provide more complete and detailed information on installing the hardware and
configuring the software.

We have written the brief instructions in this chapter for the user who has had
some experience with an installation or configuration program and does not
require a step-by-step explanation all the way through.  If you find these
instructions are too skimpy to follow, skip this chapter and start at Chapter 3.

We recommend you eventually read the entire manual so you will be aware of all
the capabilities this program provides.  MODEM MGR has many unusual features and
some of them are mentioned only once in this manual.  If you don't read the
entire manual, you may miss a feature which can be helpful to you.  Several
different sections in this manual will provide you descriptions of common
potential problems you may encounter.


PRELIMINARY STEPS

This program will not run initially until you have installed it for your system.
 Since there are several models of Apple // computers and thousands of different
combinations of modems, video cards, serial cards, clock cards, and printer
cards, you will have to tell this program which hardware you have installed
before you can run it.

1) Use the ProDOS or DOS 3.3 disk depending on which operating system you
prefer.  Do not mix the programs from one type of operating system with the
programs associated with the other type of operating system.  Be sure the work
disk and install disk are labelled and the install disk is write-protected.

2)  Boot the install disk and run the INSTALL program.  You must run the install
program on the computer you will be using to run MODEM MGR.  Don't use a
different computer for the installation.

3)  Follow the prompts and answer the queries issued by the INSTALL program. 
Insert the work disk or the install disk into the drive when you are directed to
do so.

4)  When the main installation menu appears, select option 1 to install the
video driver.  Select the video card you are using and specify the normal screen
(not the split-screen) when asked.  If you are using a video card in an
expansion slot, you must specify the slot number when asked.  Answer Y (for Yes)
when the program asks you if you want to use the driver you have selected.

5)  Select option 2 on the main installation menu to install the modem driver. 
If you are using an internal plug-in modem, you will have to specify the type of
plug-in modem card and the slot it is in.  If you are using an internal serial
or communications card and an external modem, you must not only specify the type
of card and the card slot, but also the type of modem.  If you are using a
multi-function card, read the query carefully to determine whether you should
specify the actual physical slot or the phantom mapped slot.  Answer Y (for Yes)
when the program asks you if you want to use the drive you have selected.

6)  You must specify a video driver in order to run the program. You must also
specify a modem driver in order to use the program for communications.  You do
not have to specify a clock or printer driver.  Do not perform the printer
driver installation until you have read Chapter 12.

7)  Do not change any of the defaults (option 7 on the main installation menu).

8)  After you specify the desired drivers, select option 9 on the main
installation menu, insert the work disk into the drive, and save the newly
installed program.

9)  You will now have a work disk which has been configured for your system. 
You do not need the install disk again until you want to re-install or change
some program parameters.


BOOTING THE PROGRAM

If you are using an external modem, apply power to the modem before you boot the
work disk.  If your modem has configuration switches, set the modem carrier
detect signal (DCD) permanently on and set the modem to ignore the DTR signal. 
(DTR always on).  You may use different settings later, but set them as
described for this first-time initial run.  If your modem has a baud rate
switch, set the switch to the desired baud rate.

Boot the work disk.  If you see no message or a message "MUST INSTALL VIDEO
DRIVER", then you have not installed the video driver. Run the INSTALL program
and install a video driver.

If you installed the correct video driver, the screen should clear and the
hardware you specified in the install program should be listed.  After a pause,
the program will load some default files if they are found on the disk.  It does
not matter if those files are not found.

Finally, the screen will clear and you will see a menu of the terminal commands.
 This menu is shown in figure 6-1.  If you see a dashed line across the screen
about three-fourths down from the top, you have installed the split-screen video
driver by mistake.  Run the INSTALL program again and specify the normal screen.

If the program does not load as described, read Chapters 3 and 4. Check your
hardware connections and proceed through the installation described in those
chapters.


TERMINAL MODE

If the menu of the terminal commands appears, you are in the terminal mode.  In
this mode you can communicate with another system.  However, you must first make
a connection with that system. To make a connection, you must issue certain
commands.  To enter a command, you must be in the terminal COMMAND mode.  Type
the [ESC] key until a "Command? -->" prompt appears.  Enter a question mark (?)
and observe the command menu is displayed again.  When you typed the [ESC]
character, you placed the program in the terminal COMMAND mode and when you
typed the ? character, you entered the command which displays the command menu.

If you have a IIGS, //c, or //e, you may also execute this command in the
terminal mode by holding down the oa- key while you type the ? key.  the
"Command -->" prompt will not appear if you use this method.

Look at each command listed on the menu and observe that each command is a
single letter, number, or punctuation character.  (The ? command is not shown on
the menu).  You may execute a command by typing [ESC] followed by the command
letter or by holding down the oa- key while you type the command letter (on a
IIGS, //c, or //e).

Enter the following commands and observe what happens:

B    The B command toggles the capture buffer on or off.
C    The C command clears the buffer.
S    The S command displays the number of characters in the buffer
     and the amount of space left.

Enter the D command and observe the disk functions menu appears. Now enter a C
to see a disk catalog.  Note that this C command is a disk functions command and
is not the same as the C command issued as a terminal command.  You may think of
this as being a DC command since that is the sequence of characters you typed to
get the disk catalog.

If you don't want to enter a command, enter [RETURN] instead and you will return
to the terminal mode.

Enter the M command and select the baud rate corresponding to the baud rate your
modem supports.  Enter the J command and select the number of data bits, parity,
and number of stop bits.  If you don't have a preference, use 8 date bits, no
parity, and one stop bit. This combination may be shone as "8+1+none" or "8+1+n"
or "8n1"/

If you have a modem which can dial a number under program control, enter the T
command.  When the "enter -->" message appears, enter the telephone number of
your favorite system followed by [RETURN]. If your modem supports tone dialing,
enter the letter T before the first number.  To exit without dialing, type [ESC]
(not [RETURN]). If your modem does not support dialing, dial the number manually
on a telephone set connected to the same phone line.

If your modem has a speaker which allows you to hear the call in progress or if
you have a telephone set on the same phone line, you can hear the other system
answer your call.  After that system answers, it should transmit a carrier tone.
 Your modem should respond by turning on its carrier.  (Some modems require you
to manually set a switch to enable the carrier).  You are now connected to the
other system.  If you used a telephone set on the same phone line to dial, hang
that phone up.

You can now communicate with the other system.  Any characters transmitted to
you from the other system will be displayed on your video screen.  Any
characters you type on your keyboard will be transmitted to the other system. 
You may type [ESC] followed by a B or you may type oa-B together at the same
time to toggle the capture buffer on or off.  IF the capture buffer is on, all
characters received will be saved in the buffer.

When you are finished, type [ESC] followed by H (or type oa-H together) to hang
up your modem.  Some modems will not respond to a hangup command, but will
perform a hang-up when the other system disconnects or when a switch on the
modem is set to off.

If you captured some text to the buffer and you wish to view the text, enter the
V command.  If you wish to save what you have captured to a disk file, enter the
following disk-write command sequence.  Don't type the spaces which are included
for clarity.

[ESC] D W filename [RETURN]        (if DOS.3.3)
[ESC] D W pathname [RETURN]        (if ProDOS)

In other words, type [ESC] followed by D (or type oa-D together)m then type W
followed by a "filename" or "pathname" of your choice followed by [RETURN]. 
Several prompts and menus will be displayed while you are typing through this
sequence.  You can pause to read the prompts or type the sequence as fast as you
can.  With both ProDOS and DOS 3.3 you may use the S# and D# options to specify
another slot or drive.  For example:

[ESC]DWMYFILE,S6,D2[RETURN]

This will save the buffer to a file called MYFILE on the disk associated with
slot 6 and drive 2.


OTHER CHAPTERS

Although you may have managed to use the brief instructions in this chapter to
conduct communications with another system, you have just barely exercised the
total capabilities of this program.  It is recommended you proceed to Chapter 3
and verify you have properly installed your hardware.  Although this may seem
unnecessary after you have used the system ot communicate successfully, there
are several equipment connections you must make properly in order to utilize
some of the more advanced features of this program.  you must also avoid some
common equipment connections which can cause problems.

Next, read chapter 4 and perform the INSTALL program again to incorporate any
additional features you need and to set the defaults to match your custom
requirements.

Read Chapter 5 for a full description of the operational features of the
terminal program.  The remaining chapters provide additional information on some
of the major terminal mode capabilities.