CHAPTER 1 INTRODUCTION MODEM MGR is a communications program for the Apple IIGS, //e, //c, and ][+ computers. It supports receiving and transmitting of text or data between your computer and other systems over phone lines with a modem or with a direct-wired connection MODEM MGR is a menu- and command-oriented communications software package. It provides you total communications with only a few command keystrokes. MODEM MGR incorporates built-in control compatibility with most "smart" modems and handles all applicable hardware baud rates up to 19200 baud including 110, 135, 150, 300, 600, 1200, 1800, 2400, 3600, 4800, 7200, 9600, and 19200 baud. MODEM MGR provides easy user access to modem features such as dial. answer, hangup, baud rate changes, and communication parameter changes. FEATURES MODEM MGR provides the following features: 1) Operating system - MODEM MGR will run on the ProDOS or DOS 3.3 operating systems. Both systems are supported in this software package. 2) Peripheral card support - MODEM MGR supports most of the popular peripheral cards and modems used with the Apple computer (see list) 3) Text capture - MODEM MGR has a capture buffer to allow you to save all received text. You can review the contents of the buffer on the video screen send it to a printer, write it to a disk file, transmit it to another system or edit it. 4) Fast speed - MODEM MGR was designed to support all applicable baud rates from 110 baud to 19200 baud. it uses customized fast video routines to avoid loss of received characters at high baud rates. With some video cards, MODEM MGR can receive and display ordinary text at baud rates up to and including 19200 baud continuously without losing any received characters. 5) Split-screen option - In addition to the normal full-screen video display, MODEM MGR also supports a split-screen display option. With the split-screen option, received text is displayed in the upper part of your screen while your typed transmitted text is displayed in the lower part. Both portions will scroll independently. When you use the split-screen display, you can also use a keyboard block mode option. This option allows you to store your typed text in a memory block before it is sent. With the block mode enabled, you can type the next block of text you want to transmit in the lower screen while you are receiving text in the upper screen. 6) Full-screen text editor - MODEM MGR provides a full-screen text editor with many of the editing features of a word processor. you may edit captured text or text from a disk file and save the edited text to disk or re-transmit it. you may use the editor even while you are online. 7) Macro script files - MODEM MGR lets you create and execute macro script files to automatically perform most of the functions of this program in a programmed sequence. You can prepare a single macro file to dial, send a password, log-in, request information, capture text, save to disk, and hangup without requiring any attention on your part. You may chain macro files to obtain an unlimited number of macro commands in a sequence. 8) Function keys - MODEM MGR allows you to program up to nine "function" keys which you can use to send special characters, send frequently-used text strings, or execute complete macro command sequences. 9) Text transmission - You can transmit text from a disk file or the capture buffer to another system with the following throttle options: character pacing, line pacing, echo pacing, XON/XOFF pacing, prompt-string pacing, or no pacing. 10) File transfer - you can transfer any type of ProDOS or DOS 3.3 file including random-access files with a special MODEM MGR error detection and correction protocol. the XMODEM, BINARY II, and AE XMODEM protocols are also supported. 11) Clock support - If you have one of the clock cards listed, MODEM MGR will allow the continuous display of time-of-day or elapsed time in the upper-right corner of the screen. You can time your phone calls or you can program macro commands to start execution at a specific time. 12) Multiple video formats - MODEM MGR supports several video formats depending on the video device you are using. this includes 40 columns by 24 rows, 80 columns by 24 rows, and all eight video formats provided by the Videx Ultraterm video card. You can switch between Ultraterm formats while online and y can use any Ultra term format in the terminal and editor modes. 13) Dialing - If your modem supports dialing, you can dial commonly-used phone numbers with a few keystrokes from a phone number list, a macro file, or by pressing a pre-programmed function key. You can also re-dial the last number dialed or dial a default number with just a few keystrokes. 14) Unattended operation - MODEM MGR provides unattended answer operation with password protection so your system can act as a host ot let others call and leave messages or exchange files with your system. 15) Terminal emulation - MODEM MGR provides emulation of some popular terminals including the DEC VT220/VT100 and the Data General D200. Several emulation files are provided and a program is included to generate your own special emulation files. 16) Printer support - MODEM MGR provides a printer buffer and lets you print while online or print from the capture buffer or a disk file. 17) Screen snapshot - MODEM MGR allows you to save a copy of the present screen display in the capture buffer. This lest you save a disk catalog, status messages, or a time-stamped screen. 18) reverse scroll review - On a IIGS, //c, or 128k //e you may scroll the screen down to view earlier text. 19)Flexibility - The use of customized drivers provides you with maximum flexibility. You can tailor MODEM MGR to utilize the special features of your hardware. the use of individual drivers will also allow you to incorporate easy updates to support future communications devices. The installation program lest you configure most of the program defaults to your preferences. 20) There are many additional features provided by MODEM MGR like support of lower-case devices, XON/XOFF flow control, automatic saving of a full buffer, scroll speed control while viewing buffer text, display of control characters, sending characters not available on a ][ or ][+ keyboard, choice of carrier control, provision for text formatting, Apple-CAT II 202 semi-break-in keying, efficient transfer of random-access files and efficient transfer of DOS 3.3 files having unused sectors. SYSTEM REQUIREMENTS MODEM MGR will run on an Apple IIGS, //c, //e, ][+ or ][ computer. The enclosed program disks are 5-1/4 inch floppy disks so you are required to have at least one 5-1/3 inch disk drive. The ProDOS version can be transferred to any ProDOS-compatible disk drive (3-1/2, RAM, hard disk, etc). Although this program may run on other "compatible" computers, operation on computers other than those listed here is not guaranteed. Some of the devices listed will work on some computer models only. MODEM MGR will support only the following video devices. Apple built-in 40 column Apple 80-column card in auxiliary slot of //e Apple //c or IIGS built-in 80 column. Apple ][, ][+, or //e with one of the following video cards installed in an expansion slot: Applied Engineering Viewmaster-80 Micromax Viewmax-80 (On some ][+, split-screen will not work) Videx Ultraterm Videx Videoterm Some "compatible" 80-column cards may not work in the auxiliary slot of the //e. MODEM MGR will support only the four 80-column cars listed above in the expansion slot. MODEM MGR supports the following serial cards or multi-function cards with a serial function for use either as a communications interface card or a serial printer card. Apple IIGS Serial Port Apple Communications Interface Apple II Super Serial Apricorn Serial Interface Apricorn Super Serial Imager AST Multi I/O Calif. Computer Systems 7710 Serial Interface Calif. Computer Systems 7711 Super Serial Interface Franklin Dual I/O Card Microtek SV-622 Serial Interface Mountain Hardware CPS Multifunction Orange Micro Serial Grappler (printer only) Practical Peripherals SeriALL Prometheus Versacard Quadram Multicore SSM or Transend AIO Interface SSM or Transend ASIO Interface Street Electronics Alphabits Videx PSIO Dual Function Interface MODEM MGR will support the following internal plug-in modems: Applied Engineering Datalink Cermetek AppleMate 1200 Hayes Micromodem II and IIe Hayes Smartmodem 1200A Novation Apple-CAT II Novation Apple-CAT II with 212 Upgrade Card Prometheus Promodem 1200A Transend ModemCard Zoom Modem ][e Zoom Networker MODEM MGR will support the following external modems and communications peripherals: Apple Modem 300 and 1200 Apple Personal Modem E+E Avatex 1200 Hayes Smartmodem 300, 1200, and 2400 Most "Smartmodem-compatible" modems (Anchor Signalman Mark XII, US Robotics Auto Dial 212A, etc.) Novation SMART-CAT Prometheus Promodem 1200 US Robotics Courier 2400 Most Auto modems (Novation Auto-CAT, VADIC 3451, etc) Most Dumb modems (Acoustic, etc)AEA PAKRATT PK-232 Kantronics Universal Terminal Unit TAPR Packet Radio Terminal Mode Controller 1 and 2 TONO Theta-777 Many other units with RS-232 interfaces. The following clock cards or multi-function cards with a clock function are the only clock devices supported by this program. Other clock cards or earlier versions are not supported. Apple IIGS Clock Applied Engineering Serial Pro Clock Applied Engineering Z-Ram Ultra 2 or 3 Clock Applied Engineering Timemaster II H.O. AST Multi I/O Calif. Computer Systems 7424 Calendar/Clock Mountain hardware CPS MultiFunction MSR Clockworks Card Practical Peripherals Proclock Prometheus Versacard Quadram Multicore Quadram ProDOS Clock/Calendar SMT No-Slot Clock Thunderware Proclock Thunderware Thunderclock Plus The following parallel cards or multi-function cards with a parallel printer function are supported for use as a parallel printer card. Many other parallel printer cards not listed here are also supported. Apple II Parallel Interface Apple Parallel Printer Interface Calif. Computer Systems 7728 Epson Apple II Parallel Interface Franklin Dual I/O Card Interactive Structures PKASO/U Microtek Dumpling GX Microtek RV-611C Mountain Hardware CPS MultiFunction Orange Micro Grapple and Grappler + Practical Peripherals GraphiCard Practical Peripherals Microbuffer II Prometheus Versacard Quadram Multicore SSM or Transend AIO Interface Videx PSIO Dual Function Interface Videx UniPrint Wesper Wizard Intelligent Printer Interface DISK PROGRAMS You may run MODEM MGR with either the ProDOS or DOS 3.3 operating system. Use the system you are most familiar with. A separate disk is furnished for each operating system. Use the disk provided for the operating system you prefer. Label your disks so you won't use a disk with the wrong operating system. With the DOS 3.3 version, you can only use 5-1/4 inch floppy disk drives. With ProDOS, you can use any disk drive which is compatible with ProDOS, including RAM drives. You may transfer one or all program files on the ProDOS disk to another disk using a file transfer program like the ProDOS FILER. However, the following programs on the DOS 3.3 disk should never be transferred: MDM1 MDM2 MDM3 MDM4 Do not use a file transfer program (like FID) to move any of these four DOS 3.3 files. The only way to place these four files on a disk is to copy the original DOS 3.3 work disk using a disk copy program like the COPYA program. Any other DOS 3.3 file can be transferred individual using the FID program. COMMON TERMS The following is a list of definitions of some of the terms used in this program manual. The letter X is used in some of the examples to represent any letter which may apply. CR Carriage return character. LF Line feed character. Filename DOS 3.3 file name. Pathname Full or partial ProDOS file pathname. ^X Control-X character. [RETURN] Type the RETURN key. [ESC] Type the ESC key. [SPACE] Type the SPACE key. [CTRL] X Press the control key while you type the X. Control-X Refers to the [CTRL] X entry. S# Disk Slot number (e.g. S6). D# Disk drive number (e.g. D1). oa-X Press the open-apple key while you type the X. ca-X Press the closed-apple key while you type the X. Wait.. Wait (until the cursor appears on the next line) FILENAMES AND PATHNAMES When disk files are read or written, you will have to furnish a pathname (ProDOS or filename (DOS 3.3). You will see one of the following prompts displayed: Pathname? --> Filename? --> Enter the desired name followed by [RETURN]. In most cases (except emulation files), you may add a comma followed by S# and/or D# to specify a slot and/or drive number. For example: MYFILE,S6,D2 Specifies slot 6 and drive 2. You may use the [DELETE] or backspace key to correct any typing mistakes before you type the [RETURN] key. If you enter lower case letters, they will be converted to uppercase. If you enter a question mark (?) followed by [RETURN], a disk catalog will be displayed. After the catalog is displayed, the filename or pathname request will be repeated. In the ProDOS version, a default prefix may also appear if you have defined one with the INSTALL program. You may cancel this default prefix by typing the [DELETE] or left-arrow key once. If you type a [SPACE] immediately after the prompt appears, the last filename or pathname you previously entered will appear. This lets you recall the last filename to minimize re-typing. You may enter no more than the following maximum number of characters: DOS 3.3 filename: 30 characters ProDOS Pathname: 64 characters This maximum includes the comma, S#, and D# characters, if used. When you have entered the maximum allowed, no more characters will be accepted from the keyboard.