                             REACHOUT 
                      COMPLETE REMOTE ACCESS
                TERMINAL EMULATOR REFERENCE DOCUMENT
                     COPYRIGHT 1995 STAC, INC.
___________________________________________________________________________

The ReachOut Terminal Emulator works with ReachOut under either
DOS or Windows. The menus and commands are slightly different, but
the procedures and effects are the same.


TERMINAL EMULATOR OVERVIEW

The ReachOut Terminal Emulator lets a Viewer connect to a computer 
running terminal emulator software other than ReachOut Host. You can use 
ReachOut's Terminal Emulator to call Bulletin Board Systems (BBSs), UNIX 
computers, information services such as CompuServe and Delphi, data 
terminals, and other computers running terminal emulation software. 

Terminal emulators use popular error-correcting file transfer protocols 
like ZModem. ReachOut's Terminal Emulator allows file transfers between 
connected computers using XModem, YModem, ZModem, and Kermit. These 
protocols correct transmission errors due to poor phone line 
connections, ensuring the files you send or receive arrive exactly as 
transmitted. 

Terminal emulators also let you automate complicated connection 
sequences through scripting. You can write a script using the editor of 
your choice to automate long connection sequences. Scripts can 
automatically connect to another computer and log in to an information 
service by looking for specific prompt strings and typing responses to 
prompts. Scripts support commands like GET, SEND, IF/ELSE/ENDIF, and 
WAIT. 

The ReachOut Viewer automatically starts the terminal emulator any time 
the Viewer connects to something other than a ReachOut Host. ReachOut 
starts its Terminal Emulator if you use the Link menu to connect to one 
of the following: 

 	a computer running terminal emulation software 
 	a device such as a MUX box 
 	a bulletin board system (BBS) 

You can also start the terminal emulator manually by choosing Terminal 
Emulator from the Viewer's Link menu when ReachOut is configured to use 
a modem. 


STATUS INFORMATION

Connection Status

The status fields in the upper left part of the Terminal Emulator window 
(just below the title bar) display information about the current 
connection or phone book entry.  

To display or suppress these fields, use Status Bar Toggle from the 
Terminal Emulator's Misc menu. 

Status fields

Connect Time            The elapsed time since last connection made, 
                        or "offline" if not connected.

Communications Port     The selected communications port (to change 
                        the port, choose Setup in the File menu).

Phone Book Entry Name   The name of the active phone book entry 
                        (click to change).

Baud Rate               The communications speed between the modem 
                        and computer (click to change).

Communications Settings Data bits/parity/stop bits (click to change).

Terminal Emulation      Current terminal emulation (click to change).

Script Status

The bar at the bottom of the terminal window is always displayed, 
regardless of the Status Bar Toggle setting. It indicates the status of 
the currently executing script. If no script is executing, the line is 
blank. 


TERMINAL WINDOW

The terminal window is the portion of the screen between the status bar 
(or menu bar if the status bar is off) and the script status line. The 
terminal window is where the data received from the communications port 
appears, and where the text you type appears if Local Echo is on. 

If the window is large enough to display the terminal screen (80 columns 
by 25 rows) then no scroll bars appear. Once data has scrolled of the 
top of the screen, the vertical scroll bar appears so you can review old 
data. 

If the window is too small to fit the entire terminal screen, scroll 
bars appear. Use the scroll bars to see the hidden areas of the terminal 
window. 


REVIEWING DATA

RchTerm remembers approximately 380 lines of previously received data. 
To view the data, use the vertical scroll bar. Move the thumb to the top 
to see the oldest data. Move the thumb to the bottom to see the newest 
data. While viewing the newest data, the text scrolls automatically as 
new data comes in. 

RchTerm stores the received data in a circular buffer, which means that 
when the buffer fills, the new data overwrites the oldest data. 

If you want to keep all incoming data, use the Capture or Print 
commands. 


SAVE PHONE BOOK ENTRY

Use this command to save the current communications settings to the 
phone book under the current entry. ReachOut Terminal Emulator saves the 
communications settings between sessions, but if you do not save changes 
made to a phone book entry, the entry's settings are lost when you dial 
a new entry. 


SAVE AS PHONE BOOK ENTRY

Use the Save As Phone Book Entry command to save the current 
communications settings to a new phone book entry. RchTerm displays the 
Phone Book Entry dialog box so you can give the new entry a name. The 
new entry appears the next time you dial an entry from the phone book. 

Use the Phone Book Entry dialog box to enter the new name for the phone 
book entry. Type a new name in the edit field and choose OK. 


OPEN CAPTURE FILE

Use the Open Capture File command to specify the capture file. After 
specifying a new capture file, all received data is appended to the 
file. If you choose Open Capture File when a capture file is already 
open, RchTerm closes the previous capture file before opening the new 
one. 

In the Open File dialog box, type the file name in the input box or by 
using the list boxes to find and open the file. 

Dialog Box Fields

File Name input box     Type the name of the file to open or type a 
                        file name mask to use as a filter for the 
                        Files list box.

Files list box          Displays the names of files in the current 
                        directory that match the file name mask in 
                        the File Name input box.

Directories list box    View the contents of different directories by 
                        selecting a directory name in the Directories 
                        list box.


EXIT TERMINAL EMULATOR

Exits ReachOut Terminal Emulator. If the modem is online, RchTerm warns 
you that it will hang up before exiting. 

You can exit the terminal emulator in two ways: 

 	Choose Exit from the File menu. 
 	Double-click the Control menu box in the upper left corner. 


CAPTURE TOGGLE

Capture saves all received data to a file of your choice. The first time 
you turn on capture in a session, RchTerm prompts you for the file name. 
Subsequent captures during the same session are saved in the same file. 
If you want to capture data to a different file during the same session, 
choose Open Capture File from the File menu. 

If capture is on, choosing Capture Toggle from the Terminal Emulator's 
Misc menu turns capture off. The capture file is closed and saved. If 
capture is off, choosing Capture Toggle turns capture on using the same 
file specified earlier in the session.. 


PRINTER TOGGLE

Printer sends all received data to the default printer. Since Windows 
has a print spooler, the data is spooled until you turn printing off. 
This means that none of the received data prints until you turn printing 
off. If there is no valid printer selected, data may be lost. 

If printing is on, choosing Printer Toggle from the Terminal Emulator's 
Misc menu turns printing off. If printing is off, choosing Printer 
Toggle turns printing on. 


SOUND TOGGLE

The Sound Toggle command on the Terminal Emulator's Misc menu toggles 
sound on and off. When sound is on, RchTerm plays a sound when a dialed 
connection is established and when file transfers are complete. No 
sounds are played when sound is off. 


BLANK DISPLAY

The Blank Display command on the Terminal Emulator's Misc menu clears 
the terminal window. Clearing the window is useful after ending one 
session, before beginning a new session. 

This command doesn't reset the terminal. If your terminal gets stuck in 
graphics mode and needs to be reset, choose Comm in the menu bar, then 
choose OK without changing any settings. 


FUNCTION KEY MACROS

The Function Keys dialog box lets you create up to twenty macros. After 
defining a macro in the Function Keys dialog box, you can invoke the 
macro by pressing SHIFT or CTRL and one of the ten function keys (F1 to 
F10).  

Macros may contain any string, including control characters. To include 
a control character, precede the character with a caret (^). For 
example, ^M sends a carriage return. To include a caret character in the 
macro string, use ^^. 

Function key macros are limited to 64 characters each. They do not vary 
by phone book entry and are automatically saved with the Terminal 
Emulator settings when you exit. 


REDIAL OPTIONS DIALOG BOX

Use this dialog box to turn automatic redial on or off or to change the 
delay between redials. By default, RchTerm automatically redials busy 
numbers. It does not redial ReachOut Hosts.  

Dialog Box Options

Redial on Busy   This check box determines whether RchTerm redials a 
                 busy number.

Redial Delay     This field determines the number of seconds between 
                 redial attempts. It's not available if Redial on 
                 Busy is off.


DIALING STATUS DIALOG BOX

The Dialing Status dialog box appears when RchTerm dials a remote 
computer. Before dialing, RchTerm initializes the modem. If the number 
dialed is busy, RchTerm continues to redial until a connection is 
established or you choose Cancel. 


INITIALIZE MODEM

This command sends the initialization string to the modem. It is 
available only when the modem is offline. 

To change the modem initialization string, choose Setup from the File 
menu. 


HANG UP

Choose Hang Up from the Link menu to terminate the connection by hanging 
up the phone. 


SEND BREAK

Some devices may require that you transmit a break signal of a certain 
duration for disconnection or other reasons. Use this command to 
transmit a break. 


CONNECT TO HOST

Use this command to tell a ReachOut Host that you're ready to make a 
ReachOut connection. RchTerm will send "CONNECT", which the ReachOut 
Host recognizes as meaning a Viewer wants to establish a ReachOut 
connection. Note that you must already be communicating with the 
ReachOut Host for this to work. Non-ReachOut hosts will interpret this 
as if you had typed "CONNECT." 

When the ReachOut Host receives the CONNECT string it responds with a 
ReachOut packet. Upon receiving this packet the Terminal Emulator will 
exit and return you to the Viewer. 


SCRIPT TO RUN ON CONNECT

To cause a script to run when a connection is established, choose Dial 
Out Script File from the Terminal Emulator's Script menu.  

In the Script To Run On Connect dialog box, type the name of the script 
in the Script File Name field. The script you name will be run 
automatically when you make a connection using the current phone book 
entry. The script must be located in the ReachOut directory or in the 
current working directory. 

RchTerm adds the extension "SCR" before trying to run the script, so you 
don't need to include the .SCR extension when typing the script's file 
name. 


RUN SCRIPT FILE

To run a script file immediately, choose Run a Script File from the 
Terminal Emulator's Script menu. Use the Run Script File dialog box that 
appears to choose the script to run. 


EDIT SCRIPT

To edit a script file, choose Edit a Script File from the Terminal 
Emulator's Script menu. Use the command to edit scripts. Use the Edit 
Script File dialog box that appears to choose the script to edit. 

ReachOut uses Windows Notepad to edit scripts. 


DOWNLOAD (RECEIVE A FILE)

Use this command to receive one or more files from the remote computer. 
The Download command uses a file transfer protocol to ensure the file is 
received without errors. 

RchTerm lets you choose from several popular transfer protocols. The 
ZModem, YModem, and Kermit protocols let you receive multiple files in 
one transfer session; the XModem protocol receives only one file at a 
time. 


UPLOAD (SEND A FILE)

Use this command to send one or more files to the remote computer. The 
Upload command uses a file transfer protocol to ensure the file is 
received by the remote computer without errors. 

RchTerm lets you choose from several popular transfer protocols. The 
ZModem, YModem, and Kermit protocols let you send multiple files in one 
transfer session; the XModem protocol sends only one file at a time. 


SEND FILES DIALOG BOX

Use the Send Files dialog box to select one or more files to send to a 
remote system. 

Dialog Box Fields

File Name input box     Type the name of the file to open or type a 
                        file name mask to use as a filter for the 
                        Files list box.

Files list box          Displays the names of files in the current 
                        directory that match the file name mask in 
                        the File Name input box. Control-click to 
                        select multiple files.

Directories list box    View the contents of different directories by 
                        selecting a directory name in the Directories 
                        list box.


FILE TRANSFER STATUS DIALOG BOX

The File Transfer Status dialog shows the state of a file transfer in 
progress. 

To cancel a file transfer, choose the Cancel button. Depending on the 
protocol and the remote system, you may have to wait several seconds 
while RchTerm tries to tell the other system to cancel the transfer. 

When the file transfer completes, RchTerm makes a sound and the dialog 
disappears after a few seconds. Choose the OK button to close the dialog 
sooner. 

Dialog Box Fields

Caption                 The dialog caption displays the protocol 
                        being used for the file transfer.

Sending or Receiving	The label on this field reflects whether 
                        RchTerm is sending (uploading) or receiving 
                        (downloading) a file. The field displays the 
                        name of the file being transferred.

Size                    The size field displays the size of the file 
                        being transferred. When receiving files using 
                        XModem, Kermit, or ASCII protocols, this 
                        field is blank.

Transferred             The transferred field displays the number of 
                        bytes transferred for the current file.

Errors                  The errors field displays the number of 
                        errors that have occurred during the current 
                        transfer.

CPS                     The CPS field displays the number of 
                        characters per second being transferred. This 
                        varies as data throughput changes.

% Done                  The % done field displays the percentage of 
                        the current file that RchTerm has sent or 
                        received. When receiving files using XModem, 
                        Kermit, or ASCII protocols, this field is 
                        blank.

Last Error              The last error field displays an abbreviated 
                        message for the last error that occurred.

Histogram               The histogram graphically displays the same 
                        information as the % Done field.

Elapsed Time            The elapsed time field displays the time 
                        since the file transfer began.

Time Remaining          The time remaining field displays the 
                        estimated time remaining to finish 
                        transferring the current file.

Message Area            The message area displays various messages 
                        pertaining to the transfer. These include 
                        errors, virus checking messages, and transfer 
                        completion messages.


CHANGE PROTOCOL DIALOG BOX

The Change Protocol dialog box lets you change the file transfer 
protocol used before the file transfer actually begins. The default 
protocol is already chosen; simply choose OK to use it. To choose a 
different protocol, select it and choose OK. The protocol selected here 
will become the new default protocol. 


TRANSFER PATH DIALOG BOX

Use the Transfer Path command to choose a default directory for received 
files. 

Dialog Box Fields

Path            Enter the default path for file transfers in the Path field.

Directories	Choose a different directory by selecting its name in 
                the Directories list box.


OVERWRITE FILES ON DOWNLOAD

This option specifies what to do when a file being downloaded already 
exists. If Overwrite Files is turned on, the existing file is replaced 
by the downloaded file. If Overwrite Files is off, the downloaded file 
is renamed with a numeric extension (000, 001, 002, and so on) and the 
original file is left unchanged. 


VIRUS CHECK DOWNLOADED FILES

When virus checking is on, RchTerm automatically scans all downloaded 
files for viruses. The downloaded file is deleted if a virus is found. 
To keep all downloaded files even if they contain a virus, choose this 
command to turn virus checking off. 


TERMINAL EMULATOR TIMEOUT

You can use the ReachOut Viewer to make a modem connection with any 
computer that is ready to receive calls. If this computer is not set up 
to be a ReachOut Host, then ReachOut will automatically start the 
terminal emulator upon making the connection. 

By default, ReachOut waits two seconds before starting the terminal 
emulator. You can lengthen then time it takes ReachOut to start the 
terminal emulator by adding a line to your REACHOUT.INI file (located in 
the Windows directory). For example, to set the timeout to five seconds, 
type 

	STETimeout=5 

on a line by itself in the [RchExec] section of REACHOUT.INI. 

You may want to do this if you find that ReachOut needs longer than the 
default time to make the Viewer-Host connection. 


HOW TO (TERMINAL EMULATOR)

TO SPECIFY COMMUNICATIONS SETTINGS

1.   Find out the communication and terminal emulation settings of the 
     remote computer with which you want to connect. The system 
     administrator of the remote computer can help you with this.

2.   Choose Comm to display the Communications Configuration dialog box.

3.   Set the Baud Rate, Data Bits, Stop Bits, Parity, and Flow Control 
     settings to those required by the remote computer. If you have a 
     high-speed modem that auto-detects the speed of the remote modem, you 
     can leave the Baud Rate set at the highest speed supported by your 
     modem.

4.   Choose a terminal emulation from the Terminal Emulator drop-down 
     list. Most PC-based Bulletin Board Systems (BBS) use ANSI-BBS or VT-
     100. UNIX hosts typically use VT-100. If you're unsure which emulator 
     to use, contact the system administrator of the remote computer.

5.   If you intend to transfer files with the remote computer, choose a 
     default file transfer protocol from the Protocol drop-down list. 
     ZModem is the most commonly supported protocol.

6.   Choose OK.


TO CREATE A NEW PHONE BOOK ENTRY

1.   Choose New Phone Book Entry from the File menu to display the Add 
     Phone Book Entry dialog box.

2.   Type a description of the remote computer or online service in the 
     Description field.

3.   Type the remote computer's phone number in the Phone Number field.

4.   Leave the User Name and Password fields blank. These fields are used 
     only when connecting to a remote computer running ReachOut Host.

5.   Click the Terminal Emulation Entry check box.

6.   Click the Term Setup button.

7.   Select the communications settings required by the host system.

8.   Click OK to close the Communications Configuration dialog box.

9.   Choose OK.


TO CONNECT TO A REMOTE COMPUTER

1.   Choose Dial by Phone Book from the Link menu.

2.   If the remote computer isn't listed in the Phone Book list, choose 
     Add to add it to the list. See Create a new Phone Book Entry for more 
     information.

3.   Select the remote computer in the Phone Book list.

4.   Choose OK.

     The Dialing Status dialog box appears. 


TO SEND A TEXT FILE

1.   Choose Comm in the menu bar to display the Communications 
     Configuration dialog box.

2.   Choose the ASCII Config button.

3.   Set the appropriate options in the Uploads section of the dialog box.

4.   Choose OK.

5.   Choose Upload from the Transfers menu or press PAGEUP.

6.   In the Change Protocol dialog box, choose ASCII or Raw ASCII.

7.   Choose OK

     The File Transfer Status dialog box shows the progress of the transfer. 


TO RECEIVE A TEXT FILE

1.   Choose Comm in the menu bar to display the Communications 
     Configuration dialog box.

2.   Choose the ASCII Config button.

3.   Set the appropriate options in the Downloads section of the dialog 
     box.

4.   Choose OK.

5.   Choose Download from the Transfers menu or press PAGEDOWN.

6.   In the Change Protocol dialog box, choose ASCII or Raw ASCII.

7.   Choose OK.

     The File Transfer Status dialog box shows the progress of the transfer. 


TO UPLOAD (SEND A FILE)

1.   On the remote computer, specify the protocol you want to use for the 
     transfer (ZModem, XModem, Kermit, and so on).

2.   On the remote computer, issue the command to upload a file. If you're 
     not sure how to do this, contact the system administrator of the 
     remote computer.

3.   In Terminal Emulator, choose Upload from the Transfers menu, choose 
     the Upload button in the status bar, or press PAGEUP.

4.   In the Change Protocol dialog box, choose the file transfer protocol 
     the remote computer is using, then choose OK.

5.   In the Send Files dialog box, select the file you want to transfer. 
     If the protocol you chose earlier lets you send multiple files, you 
     can Control-click additional file names in the list.

6.   Choose OK to begin the transfer.

     The File Transfer dialog box shows the progress of the transfer. 


TO DOWNLOAD (RECEIVE A FILE)

1.   On the remote computer, specify the protocol you want to use for the 
     transfer (ZModem, XModem, Kermit, and so on).

     If you choose Zmodem here, the download will begin immediately when 
     you complete step 2. The file will be downloaded to the current File 
     Transfer path.

2.   On the remote computer, issue the command to download a file. If 
     you're not sure how to do this, contact the system administrator of 
     the remote computer.

3.   In Terminal Emulator, use Transfer Path on the Transfers menu to set 
     the path. Then choose Download from the Transfers menu, choose the 
     Download button in the status bar, or press PAGEDOWN.

4.   In the Change Protocol dialog box, choose the file transfer protocol 
     the remote computer is using, then choose OK. If the protocol you 
     chose earlier lets you receive multiple files (ZModem, YModem, or 
     Kermit), the file transfer progress begins automatically. 

5.   If you chose XModem, RchTerm prompts you for the name of the file 
     you're receiving. If you want to override your current transfer path, 
     choose a directory and type a name for the received file, then choose 
     OK.

     The File Transfer dialog box shows the progress of the transfer. 


TO WORK WITH TEXT IN THE TERMINAL WINDOW

To review past screens of incoming data, use the scroll bar on the 
right side of the terminal window. 

To clear the data from the terminal window, choose Blank Display 
from the Misc menu or press ALT-Y. 


TO OPEN A CAPTURE FILE

1.   Choose Open Capture File from the File menu.

2.   Choose a name and location for the capture file. For easy opening in 
     a text editor, give the capture file name a .TXT extension.

3.   Choose OK.

     All new information that appears in the terminal window is also saved in 
     the capture file. 


TO TURN CAPTURE ON AND OFF

1.   Choose Capture Toggle from the Misc menu, press ALT+C, or choose the 
     Capture button on the status bar. If you had previously specified a 
     capture file, then you don't need to continue with the following 
     steps.

2.   The Capture File dialog box appears. 

3.   Choose a name and location for the capture file. Give the capture 
     file name a .TXT extension.

4.   Choose OK.


TO CAPTURE TEXT TO A PRINTER

1.   To begin capturing text in the terminal window to the default 
     printer, choose Printer Toggle from the Misc menu, press ALT+P, or 
     choose the Printer button on the status bar. All incoming text is 
     sent to the printer.

2.   To turn off printing, choose Printer Toggle again.


TO ASSIGN COMMANDS TO FUNCTION KEYS

1.   Choose Function Key Macros from the Misc menu.

2.   Select Shift or Control in the Key Set box.

3.   Type the macro text in the field next to the desired function key. To 
     type control characters, type a caret (^) and a letter. For example, 
     ^M sends a carriage return.

4.   Choose OK.


TO CHOOSE A TERMINAL EMULATION

1.   In the Terminal Emulator window, choose Comm to display the 
     Communications Configuration dialog box.

2.   Choose a terminal emulator from the Terminal Emulator drop-down list. 
     Most PC-based Bulletin Board Systems (BBS) use ANSI-BBS or VT-100. 
     UNIX hosts typically use VT-100. If you're unsure which emulator to 
     use, contact the system administrator of the remote computer.

3.   Choose OK.


TERMINAL EMULATOR SCRIPTING

ReachOut provides commands you can use in ReachOut Terminal Emulator 
script files (.SCR files). These files can be used to simplify 
connections to information services, such as CompuServe, and for use in 
negotiating complicated phone systems, such as PBX systems, muxes, and 
modem pools. 

You can write a script using the editor of your choice or you can use 
the Terminal Emulator window. Choose Edit a Script File from the Script 
menu. To run a script, choose Run a Script File from the Script menu. To 
have a script run automatically on connection, use the Dial Out Script 
command. 

"Strings" can contain control characters by preceding them with a caret. 
For example, ^m is a carriage return. All commands are free format; you 
can use spaces, tabs, or commas to separate parameters. 

Comments are preceded by a ; or the REM statement. 


TERMINAL EMULATOR SCRIPT EXAMPLE

The script shown here logs in to CompuServe and joins the Stac 
forum. You'll have to insert your user id and password.

; Terminal Emulator Script
; to log in to Compuserve,
; and join the Stac forumSEND " " CR
GET "Host name: " 10	; wait times may need adjustment
SEND "CIS" CR		; depending on modem used
GET "User ID: " 10
SEND "<User ID>" CR	; replace <User ID> with your ID
GET "Password: " 10
SEND "<Password>" CR	; replace <Password> with your Password
GET "Enter choice !" 10
SEND " " CR
GET "Press <CR> for more !" 10
SEND " " CR
GET "Last page, enter choice !" 10
SEND " " CR
SEND "GO Stac" CR
GET "Press <CR> !" 10
SEND " " CR

CLEAR
Syntax
     CLEAR
Description
     Clears the screen.

DISPLAY
Syntax
     DISPLAY [ @x,y ] "string" [ STRING ] [ CR | LF | TAB ]
Description
     Displays "string" on user's screen. @x,y specifies the x and y 
     screen coordinates where "string" begins. The coordinates are based 
     on a screen 80 characters by 25 lines. To place a string in the 
     upper left corner, use @0,0. To center a 20-character string on the 
     screen, use @40,20. You can substitute a string variable such as 
     RESULT in place of "string".

     The tokens CR, LF, and TAB may be used to display carriage returns, 
     line feeds, and tab characters.

ECHO
Syntax
     ECHO [ ON | OFF ]
Description
     Turns ON or OFF display of script commands as they are executed.

EXEC
Syntax
     EXEC "string"
Description
     Executes a DOS command. Control returns to the script when the 
     executed program completes.

EXIT
Syntax
     EXIT
Description
     Exits the script and returns to terminal mode.

GET
Syntax
     GET "string1" [ ,"string2" ... ,"string9" ] [ss | mm:ss | hh:mm:ss ] 
     [ FLUSH ]
Description
     Waits [ ss | mm:ss | hh:mm:ss ] for one of the strings to arrive 
     through the COM port. FLUSH automatically flushes the receive 
     buffers before trapping for a string.
Return Value
     RESULT is set to the number of the string matched, or zero if no 
     match was found before the time limit expired or was canceled by 
     operator pressing the ESC key.

GETSTRING
Syntax
     GETSTRING [ "prompt" ] [ YN ] [ maxlen ]
Description
     Gets a string from the local console. "prompt" specifies an optional 
     string to be displayed in the prompt dialog box. YN forces user 
     input to be either Y or N (uppercase). Maxlen specifies the maximum 
     number of characters allowed in the input string.
Return Values
     RESULT is set to TRUE if the string is of non-zero length (CRs don't 
     count), else FALSE.
     STRING is set to the string typed in the GETSTRING dialog box.

GOTO
Syntax
     GOTO :label
Description
     Passes control to the line following :label. Labels begin with a 
     colon, for example, :START.

IF
Syntax
     IF [ NOT ] CONDITION [ AND ] [ OR ] [EQ | GE | GT | LT | LE | ! | & 
     | | | = | != | >= | <= | > | < ]
     COMMAND(s) 
     [ ELSE COMMAND(s) ] 
     ENDIF
Description
     The IF command evaluates CONDITION(s) and conditionally executes 
     COMMAND(s).

     CONDITION may be one of the following:

     ONLINE         TRUE if the carrier detect signal is high (when the 
                    modem is connected to a remote computer).

     RESULT=n       TRUE if the value of the RESULT variable equals n. 
                    This comparison is valid for integers.

     COMMAND may be any script command, including another IF. IFs may be 
     nested up to five levels deep.

     ELSE specifies a COMMAND to be performed when the IF condition is 
     false.

     ENDIF marks the end of the IF statement.

ONLINE
Syntax
     ONLINE
Description
     Reserved variable which holds the value of the modem's carrier 
     detect signal. TRUE indicates that carrier detect is true/high/on, 
     indicating that the modem is connected to a remote computer.

RESULT
Syntax
     RESULT
Description
     Reserved variable for status from the GET or GETSTRING command.

SEND
Syntax
     SEND [ "string" | STRING | CR | LF | BREAK ]
Description
     Send "string" to the remote system. Use BREAK to send a break 
     sequence to the host. STRING is a variable which holds the value of 
     the string received from the most recent GETSTRING command.

STRING
Syntax
     STRING
Description
     Reserved variable which holds the value of the string received from 
     the most recent GETSTRING command.

WAIT
Syntax
     WAIT [QUIET] [ss|mm:ss|hh:mm:ss]
Description
     Halts script processing until the specified time has elapsed or the 
     ESC key is pressed. The QUIET flag specifies to wait until no data is 
     received for the specified amount of time.
