home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The World of Computer Software
/
World_Of_Computer_Software-02-386-Vol-2of3.iso
/
c
/
commo541.zip
/
ADDENDUM.DOC
next >
Wrap
Text File
|
1993-02-13
|
12KB
|
358 lines
{COMMO} 5.41 Addendum
_____________________
This Addendum contains the major additions and/or changes to the
{COMMO} 5.4 documentation. Print out this file and keep it with
your printed manual. There is a complete list of changes (major
and minor) in the file HISTORY.
===============================
In the User Guide and Reference
===============================
Setup File changes/additions
----------------------------
______________________________________________________________
{set z_prog,DSZC} Zmodem driver program (DSZC/DSZE/GSZ/TXZM)
______________________________________________________________
This variable is used in macros that require a Zmodem
protocol driver program. Just enter one of the four choices
shown and the macros (including the MOSTHOST) will use the
appropriate driver. You must have the program file in your
DOS path as follows:
DSZC DSZ.COM
DSZE DSZ.EXE
GSZ GSZ.EXE
TXZM TXZM.EXE
_________________________________________________
{sfi=no} Speech Friendly Interface (yes/no)
_________________________________________________
If this is "yes" {COMMO} will be much friendlier to users
with speech synthesizer boards (these enable blind users to
read the computer display). Major differences are:
o Terminal Screen data and many error and information
messages will be displayed using the BIOS.
o The up and down arrow keys move the cursor instead of
scrolling the screen in windows such as Online Help,
Scrollback and View String Variable Space.
o In the Dialing Directory window, {COMMO} will make
distinctive sounds when entries are marked or unmarked
for dialing. The [T] and [R] keys will mark and unmark
entries without moving the Selector Bar. If the entry
is already in the desired state, a special sound will
be made.
Under "Uploading and Downloading"
---------------------------------
Zmodem with DSZ or GSZ
======================
NOTE: DSZ and GSZ are Shareware programs from Omen Technology.
Like {COMMO}, they must be registered for continued use (be aware
that some features are not enabled in the unregistered versions).
DSZ may almost always be found where you obtained {COMMO} and is
usually archived as DSZmmdd.ZIP (mmdd is a release date). DSZ
will transfer files using the popular Zmodem protocol.
The executable file to install is DSZ.COM. There is also a
DSZ.EXE version that works better on some systems. Look for the
archive DSZmmddX.ZIP.
GSZ is functionally equivalent to DSZ. In addition GSZ provides
an attractive graphic display of the file transfer in progress.
The executable file to install is GSZ.EXE.
To use any of the Omen drivers, you need only change one item in
the Setup File:
{set z_prog,DSZC} for DSZ.COM
{set z_prog,DSZE} for DSZ.EXE
{set z_prog,GSZ} for GSZ.EXE
Zmodem with TXZM
================
TXZM, Texas Zmodem, is an excellent Zmodem driver. It combines
very fast execution speed with a good graphic display -- and TXZM
is free for personal use.
The executable file to install is TXZM.EXE.
To use Texas Zmodem, change the "set z_prog" item in the Setup
File:
{set z_prog,TXZM} for TXZM.EXE
==============================
In the Macro Programming Guide
==============================
------------------------------------
New or changed function descriptions
------------------------------------
[The description of the MENU function has been re-written for
better clarity.]
____
MENU
____
Default key: none
Description: Create a pop-up macro menu.
General form:
{SETV _menu1,text1}
{SETV _menu2,text2}
...
{SETV _menuN,textN}
text1 Text to be placed on first information
line in the pop-up window (third line
down, counting from the top border).
NOTE: These text strings are simply
information and have no effect on which
macros will be executed.
text2 Text to be placed on second information
line.
... ...
textN Text to be placed on Nth information
line.
{SETV _mlabel,label1,label2,...}
label1 Label to GOTO if F1, A or 1 is pressed.
Any of the three keys will activate the
macro at the first label.
label2 Label to GOTO if F2, B or 2 is pressed.
NOTE: Labels are positional and may be
omitted using null arguments for keys
that aren't used. See example 2 below.
... ...
{SETV _mcolor,text,border}
text Colors for the text area of the pop-up
window.
NOTE: The attributes are specified in
the same manner as the colors in the
Setup File (press F7 in the Internal
Editor to display the Color Chart).
border Colors for the window border.
{MENU height,width,string}
height Total number of rows from top to bottom
of pop-up window, including borders.
Minimum is 5.
width Total number of columns from left side
to right side, including borders.
Minimum is 23.
string Title string that will appear in the top
border.
Example 1:
{setv _menu1, F1 Call computer at work}
{setv _menu3, F2 Call E-mail service}
{setv _menu5, F3 Run offline mail reader}
{setv _mlabel,work,mail,reader}
{setv _mcolor,17,30}
{menu 9,32,Daily Activity Menu} {}
{:work} ... macro to call work computer.
{:mail} ... macro to call E-mail service.
{:reader} ... macro to run offline reader.
This menu specifies that function keys be pressed to
activate the macros. You could also press A or 1 instead of
F1, B or 2 instead of F2, etc. The macros may be as simple
or as complex as desired to complete the task.
Example 2:
{setv _menu1, D - Dialing Directory}
{setv _menu2, M - Macro File}
{setv _menu3, S - Shell to DOS (with swap)}
{setv _menu4, E - Edit a file}
{setv _mlabel,,,,ddir,edit,,,,,,,,mfile,,,,,,dos}
{setv _mcolor,03,47}
{menu 8,33,Common Commands} {}
{:ddir} {dial} {}
{:edit} {input efile,Filename to Edit} {edit %efile} {}
{:mfile} {macro}
{:dos} {shell-s} {}
This menu uses "mnemonic" key labeling -- D for (D)ialing
Directory, etc. Notice that there are three empty positions
in the "_mlabel" list prior to "ddir" and "edit". These
correspond to A, B and C, which are not used in this menu.
Then there are empty positions up to M and then up to S.
TIPS on using MENU:
> The dimensions of the window are limited by the current size
of the Terminal Screen.
> The total number of displayable lines is "height" less 4.
Lines in the window for which no "_menux" variable has been
defined will be left blank.
> Up to 26 labels can be specified in each menu. These
correspond to pressing the letters A through Z. The first
12 labels also correspond to pressing F1 through F12, while
the first 9 labels correspond to pressing 1 through 9.
> All variables used to create the menu are automatically
deleted from Variable Space after the menu is displayed.
> The last colors used to display a menu will persist until
they are changed by setting the "_mcolor" variable.
> If Esc is pressed to exit the menu, macro processing
continues in sequence following the MENU function.
See also MACRo.
[The actions of the READ function, when reading the end-of-file,
are now defined more precisely.]
____
READ
____
Default key: none
Description: Read a line from the read file to a variable.
Example:
{read nextline} Read the next line in the file into
the variable "nextline."
TIPS on reading files:
> A file must be open for reading or a macro error will
result.
> Each READ will get the next line in the file (lines are
terminated by carriage return and linefeed).
> When an attempt is made to read past the end of file,
control will GOTO the label specified in the ROPEn. If no
label was specified or if the label was invalid, control
will continue in sequence. In either case the file is
automatically closed and the variable is set to null.
> READ will set the Exit Code to 0 unless the end of file was
encountered, in which case it will be set to 1. The Exit
Code is stored in the built-in variable "_err" and can be
tested with the IFERrorlevel function.
> ALL control characters (below ASCII 28) will be discarded,
including the carriage return/linefeed that terminates the
line.
> Lines longer than 240 characters will be truncated to a
length of 240.
See also ROPEn, RCLOse
[The SSLOok function now has a switch "R" to append a carriage
return to the transmitted string.]
______
SSLOok
______
Default key: none
Description: Set up an additional string to look for during a
subsequent LOOKfor function.
General form:
{SSLOok name,target}
name The name of a string variable (MUST be a
variable).
target The ASCII string to look for. The string
begins following the "," and is terminated by
the "}".
Switches:
R or R1 Send a carriage return after sending the
variable string to the serial port.
R0 Do not send a carriage return (default).
Example:
{setv ss_r,|} {setv ss_nr,n|}
...
{sslo-r _pas,password:}
{sslo ss_r,Press enter to continue}
{sslo ss_nr,Do you want to log off?}
{look command?} ...
SSLOok is used in conjunction with LOOKfor. When the target
string appears, the string in the variable is sent to the serial
port. The LOOKfor continues to look for all specified strings.
See LOOKfor for details, examples and tips on using SSLOok.
See also: CALOok, GOLOok, SETLook.
- end -