he MEXPLUS 1.65 Summary                                  page #
              MEXPLUS 1.65 Documentation Summary

0) Authors          Nite-Owl and George M. Sipe

1) Precepts

<filespec�     �    [<drv><usr>:][<filename>][.<ext>]
<sring>        �    zero or more characters surrounded by double
                      quotes (e.g. "Testing")
                   care� ('^'� may prefix � contro� character
<string-var>   =    A B C D E or F (may contain up to 32 chars)
<string-expr>  =    <string> or <string-var>
<ascii-value�  �    zero to tw� character� surrounde� b� singl�
                      quotes (e.g. 'x')
<number-var>   =    %A, %B, ... %Z (from 0 to 65,535)
<number>       =    number, <number-var>, <ascii-value>, VALUE,
                      or STACK
                   numbe� prefixes are $=hex� #=decimal
<number-expr>  =    infix numeric expression with opt. parens
                   operator� are � - � � � <� � <� =� � >� =>
';�            �    multipl� comman� separato� (se� STA� SEP)

/�    specifie� � return (carriag�-retur� only�  sam� a� ^M)
/�    specifie� a newline (carriage-return and line-feed)
/�    specifie� � tab
/�    specifie� th� '/� character
/Onn� specifie� an� binar� valu� (excep� 0)� nn� i� th� decima�
     valu� (al� thre� digit� mus� b� present)

2� Termina� control (escape) sequences

<ESC>�         print� � men� o� escap� sequences
<ESC>@         sends BREAK to remote system
<ESC>�         exit� bac� t� comman� level
<ESC>N         disconnects modem
<ESC>�         toggl�s copy-to-printe� on/of�
<ESC>�         star�s copyin� incomin� tex� int� fil� buffe�
<ESC>�         transmi�s � fil� t� th� remot� (prompts for name)
<ESC>�         en�s (un-starts� copyin� tex� int� fil� buffe�
<ESC><ESC>     sends one <ESC> to remote system

3� Single-characte� command� (Primar� options)

E�  ente� termina� mod� wit� Echo
L�  ente� termina� mod� wit� Local-ech� only
R�  Receiv� � fil� o� grou� o� file� usin� error check protocol
S�  Sen� � fil� o� grou� o� file� usin� error check protocol
T�  ente� Termina� mod�

4) Single-character command prefixes

K:  use Kermit protocol
M:  use standard christensen Modem7 protocol (default)
Y:  use Ymodem modified christensen protocol
�5� Secondar� command� (Secondar� options)

                       COMMANDS
OP�       NAM�          USE� WIT�       ACTION
---     --------        ---------       ------
�       Appen�          E, L, and T     Appen� t� � file
�       Batc�           � an� �         Batch fil� transfers
�       Disconnec�      � an� �         Disconnect� afte� transfer
E       Echo            E, L, and T     enter term mode with Echo
�       K-packet        S               sen� 1� blk�, accept any
�       Loca�           E and T         Local-characte� echo
�       Quie�           � an� �         "Quie� mode� fil� transfer
�       Recv-vie�       � an� �         show� Received-char� only
�       Send-vie�       � an� �         show� Sent char� only
�       Terminal-mod�   � an� �         ente� Ter� afte� fil� xfer
V       Vie�            � an� �         View� th� fil� transfe�
�       Exi�            � an� �         disc/eXi� afte� transfer




                 MEXPLUS 1.65 Command Summary

.                   - comment follows

?                   - lists avaliable commands

=                   - assignment operator for <string-var> and
                        <number-var� (e.g� %a=%b=1� wher� th�
                        second = compares %b to 1, and the
                        result, 0 or 1, is assigned to %a)

@ <row>,<column> [SAY <string-expr> | <numeric-expr> [, ...] ]
                   - positions cursor to <row> and <col>
                     SAY displays expression(s)

ACCEPT <string-var>[,<length>]
                   - sets A B C D E or F from operator input
                     optional maximum length (up to 32)

AL� [<drv>][<usr>�] - driv� � use� t� searc� fo� ME� LOA� file�
                        (.MEX, .KEY, .PHN, .LIB, .MOD, .OVR)
                        default disk is 'A', default user is '0'
                        uses search strategy specified by SEARCH
                     if no argument, displays current setting

BEL� <number�       - rin�s th� bel� once/se� fo� <number� secs

BOX R1,C1,R2,C2     - draws a box between specified corners
                        (',' are all optional)

cp 7 �CAL[L� [<numblist� � � � <retries� � � ]
                   - dial� <numblist� an� stop� afte� <retries�
                     goe� int� 'T'ermina� mod� whe� � compute�
                        i� reached
                     i� n� argument� phon� li�rary is liste�
                        an� prompt� fo� num�er t� call
                     VALUE set to 0 if no connect, else list #

CLON� <filespec�    - save� ME� wit� define� phon� number�,
                        keystrings, overlays, environment
                     default filename = '        .COM'

CLS                 - clears the terminal screen

COL�                - restart� MEX and clear� define� phon�
                        numbers an� keystrings

COMP <string-expr-1> <string-expr-2>
                   - compare two string expressions for equality
                     result is left in VALUE, honors CASE switch

CSET                - control clock overlay functions

DEL [<filespec� [ V � ]
                   - deletes file, [V] will ask for verification
                        before erasin� eac� file
                     i� n� argument� deletes open capture file

DIA� [<numblist� � � � <retries� � ] ]
                   - sam� a� CAL� excep� return� t� COMMAN� mode

DI� <filespec�      - displa�s directory, default� t� du:*.*
                     sets VALUE to number of entries found

DRAW <number>       - displays symbol <number> (0 to 13)
                     displays ASCII character <number> (14 up)

DS�                 - disconnects mode�

EMUL [ON | OFF]     - controls emulation module (if INSTALLed)

END REV | BRITE | BLINK | ULINE
                   - turns off specified video attribute

EXIT                - exi�s t� system� mode� no� disconnected

GLOBA� [<2ndopt�]   - caus�s secondar� optio� <2ndopt� t� b� o�
                        fo� al� primar� options (default: none)
                     <2ndopt>='?' will list available settings
                     <2ndopt>='-' will erase current setting
                     if no argument, displays current setting

GLOBAL READ <string-expr>
                   - causes <string-expr> to be run in place of
                        returning to MEX command mode �
GOTO <label>        - transfer control to <label> in batch file
                        (note:  <label> must not be in different
                        IF block)

GOSUB <proc>        - invoke subroutine <proc> in batch file

HEL� [<topic�]      - provide� hel� informatio� o� <topic>
                     <topic>='?� wil� lis� th� availabl� topics

HLINE <row>[,]<column>[,]<length>
                   - draws line to right of specified length

I� <string-expr>    - se�s <string-expr> fo� MEX'� prompt
                        default is "[MEX] " (max 28 char)

IF <number-expr> [THEN] <statement> [; <statement>]
                   - executes <statement> if <number-expr> non-0

I� <number-expr�    - execute� statement� o� followin� line� if
                        <number-expr> is non-zero, up to ENDIF
                     ELSE may be used to reverse the condition

INPUT               - sets VALUE from operator input

INSTALL <filespec�  - installs optional modules:
                     REMOTE is the REO Remote Command Module
                     EMTDG  is DG D100/D200 emulation
                     EMTVT  is VT52/VT100 emulation
                     EMT925 is TeleVideo 925 emulation
                     EMTADM is LSI ADM-3a emulation

KBY�                - terminat� remot� Kermi� server� lo� ou�
                        from remote system, and break connection

KE�[S] � <key>=� <string-expr> � ]
                   - defin�s <key� (� char� t� <string-expr>
                     i� <string-expr> omitted� <key� i� erased
                     i� al� argument� omitted� <keys>� listed
                     invoke� wit� '<esc><key>' or function key
                     honors WECHO and WTECHO

KFIN                - terminate remote Kermit server (only)

KGET <filenames>    - request <filenames> from remote Kermit
                        server (may include wildcards)

KLOG                - terminate remote Kermit server, and log out
                        from remote system, but keep connection

KPU� <filenames>    - tramsmit� <filenames� t� remot� Kermi�
                        server, equivalent to KS command (may
                        also include wildcards in <filenames>)

cp 4 �KSET [<keyword� [<newvalue>� ]
                   - se�s <keyword� variabl� t� <newvalue>
                     i� <newvalue� omitted� presen� valu� shown
                     i� <keyword>='?'� variable� ar� listed

LABEL <label>       - up to 16 alphabetic characters for GOTO

LOA� <filespec�     - loa�s MEX'� LOA� file� (.KEY, .PHN, .OVR)

LO� [<drv>][<usr>:] - rese� an� optionally lo� t� drive and user

PHON� [<name>[=[<number�[/<comment> [<bps>]]]]
                   - se� <name� equivalen� t� <number� wit� bau�
                        rat� se� t� <bps� wheneve� used
                     i� only <name>= then <name� is erased
                     i� al� argmt� omitted� phon� <name>� listed

PREFI� <string-expr> - se�s <string-expr> t� send befor� SENDOU�
                        default is ""

PROC <label>        - up to 16 alphabetic characters for GOSUB,
                        defines start of subroutine up to ENDP

PROTO <protocol>    - specify <protocol> as default, protocol may
                        be M for Modem7 (default), Y for Ymodem,
                        or K for Kermit

REA� <filespec� [parmlist]
                   - execut�s batc� fil� <filespec>
                     <filespec� ma� contai� an� vali� commands
                     chaining of READ commands is permitted
                     default ext = '.MEX' (ext='.   ' illegal)
                     ^� from keyboard or STOP command aborts
                     executio� stop� whil� i� 'T'ermina� mode
                     brace� ({}� ma� b� use� around comman� lin�
                        para� t� includ� imbedde� spaces

    {<string-var>} - reference to <string-var>

    {<parmno> [: <defaul� parm� ]}
                   - reference to <parm>� i� READ'� [parmlist]
                     <defaul� parm� provides a default parm for
                        <parmno> if absent in [parmlist]

RE�[AME] <newfile>[=]<oldfile>
                   - rename� <oldfile� t� <newfile>
                     bot� name� mus� b� o� sam� <drv><usr>

SAV� <filespec�     - sav�s MEX'� LOA� file� (.KEY and .PHN)

SAY <string-expr> | <numeric-expr> [, ...]
                   - displays expression(s) at cursor position

SCREEN ON | OFF     - turns screen output on or off
                     automatically goes on when READ terminates �
SENDOU� <string-expr> - sends <string-expr> to remote
                     VALUE set to 0 if ok, 1 if failed

SET                 - control hardware overlay functions

SLEE� <num-secs>    - invoke� delay, ^� will abort

SSET                - control modem overlay functions

START REV | BRITE | BLINK | ULINE
                   - turns on specified video attribute

STA� [<keyword� [<newvalue>� ]
                   - se�s <keyword� variabl� t� <newvalue>
                     i� <newvalue� omitted� presen� valu� shown
                     i� <keyword>='?'� variable� ar� listed

STAT DISP <keyword> ON | OFF
                   - contro�s listin� o� keywor� i� STA� display
                     STAT ? always displays all keywords

STOP                - terminates currently active READ file

SUFFI� <string-expr> - se�s <string-expr> t� send afte� SENDOU�
                        default is "^M"

TERM                - open capture file toggled by CAPTURE switch

TERMA               - same as TERM but will append to file

TIME                - displays the date and time
                     sets VALUE to hh:mm

TRANSMIT <filespec> [S] - transmits <filespec> to remote system
                        if XON is on, xon/xoff will be honored
                        if [S], time delays will be used

TSET [<parameter> [<value>] ]
                   - terminal control parameters:

    ?              - displays all parameter settings

    BRIGHT [ON|OFF] - display bright text only

    LOWER [ON|OFF] - display lower case text

    MSG [ON|OFF]   - display terminal mode signon message

    WRAP [ON|OFF]  - terminal automatically wraps at end-of-line

TYP� <filespec� [P� - displa�s content� o� <filespec� o� screen
                     i� [P], paginate by STA� PAG� variabl�

cp 2 �VALUE [<number>]    - sets VALUE to <number>
                     or displays VALUE and STACK in decimal/hex

VER                 - prints the MEX version number and places it
                        into VALUE

VIEW                - displa�s content� o� the ASCII capture
                        buffer on the screen

VLINE <row>[,]<column>[,]<length>
                   - draws line down of specified length

WAIT {DATE mm/dd | TIME hh:mm}
                   - waits for the specified date or time
                     VALUE set to hh:mm or unchanged if aborted

WAIT SILENCE [<time>] - waits until no more modem characters
                     <time> is required idle time (default is
                        REPLY variable value) in seconds
                     max characters received of WLIM variable
                     VALUE set to 0 if ok, 1 if > WLIM chars

WAI� STRIN� [<time>] <string-expr� [<string-expr>...]
                   - waits until any of up to 4 strings are
                        received from modem
                     <time> is maximum wait time (default is
                        REPLY variable value) in seconds
                     honors CASE switch and WLIM variable
                     VALUE set to 0 if time-out, else 1-4

WR�                 - writes� close� ope� captur� fil� t� disk




       MEXPLUS 1.65 Backward Compatible Command Summary

ADD <number>        - adds <number> to VALUE

BYE                 - (same as REO LOGOUT)

CP�                 - (sam� a� EXIT)

DATE                - (same as TIME)

DO                  - (same as READ)

DOS                 - (same as EXIT)

ER�[SE] <filespec� [V� - same as DEL except requires <filespec>

POP                 - sets VALUE from STACK variable

PUSH                - sets STACK from VALUE variable
�QUIT                - (same as EXIT)

SKIPIF (operator)<number>
                   - skips next command if condition is true
                   - compares <number> to VALUE using (operator)
                   - operators:  "=", "!", ">", and "<"

STORE <string-expr> to <string-var>
                   - sets A B C D E or F from <string-expr>
                     equivalent t� <string-var>=<string-expr>

SUB <number>        - subtracts <number> from VALUE

SYSTE�              - (same as EXIT)

XCHG                - exchanges VALUE and STACK variables

XOR <number>        - exclusive ors <number> to VALUE




                  MEXPLUS 1.65 KSET variables

CHECK [1 | 2 | 3]   - Kermit error-check type

MODE [ASCII | BINARY | DEFAULT]
                   - Kermit transfer mode

PARITY [EVEN | MARK | NONE | ODD | SPACE]
                   - Parity setting (including non-protocol)

QUOTE [ON | OFF]    - Kermit 8th-bit quoting switch

RECV [<parameter> [<value>] ]
                   - Kermit receive parameters:

    EOL [<char="/R">]
                   - end-of-line character

    PAD [<ch
ar=0>] - padding character

    PADDING [ON | OFF]
                   - enables or disables padding

    PACKET [<size=94>]
                   - sets maximum packet size (up to 94 bytes)

    QUOTE [<char="#">]
                   - specifies quoting character

    SOH [<char=1>] - specifies start of packet character

cp 3 �SEND [<parameter> [<value>] ]
                   - Kermit send parameters (see RECV, but send
                        packet size default is 32 bytes)



              MEXPLUS 1.65 Remote Command Summary

ANSWER              - monitor modem for incomming call

DOW� <filespec�     - remote REO download� <filespec� usin� CI�
                        hos� protocol

DUAL [ON | OFF]     - leave local console on when in ANSWER or
                        REMOTE mode

LOCAL               - terminates REMOTE mode

LOGOUT              - disconnect current caller, perform ANSWER

PASS [<password>]   - sets the ANSWER password to <password>
                     maximum allowable password is 8 characters
                     <password> - (hyphen) removes password

REMOTE              - turn control of MEXPLUS over to the serial
                     port immediately

UP <filespec�       - remote REO upload� <filespec� usin� CI�
                        hos� protocol




                  MEXPLUS 1.65 STAT variables

ALER� [<val=255>]   - se�s � o� beep� mad� whe� � connectio� wit�
                        � remot� syste� i� mad� resultin� fro� �
                        repeatin� CAL� o� DIA�

BAK [on|off]        - chang�s fil� t� backu� else prompt erase

BEL� [on|off]       - enables console bell

BUFFER[S]           - display� captur� buf stat� (sz� usd� spc)
                     display� key buffer stat� (sz� usd� spc)

CANCE� [<char="^U">] - set� <char� t� continu� SENDOU� until

CAPTURE [on|off]    - controls (TERM{A}) capture activity

CASE [on|off]       - enables case independence during WAIT

CHA�                - list� statu� o� al� CHARacte� variables

cp 2 �CHECKSU� [on|off]   - se�s fil� transfe� verificatio� method
                     mutuall� exclusiv� wit� CRC

CI� [on|off]        - specia� fil� transfe� protoco� use� b�
                        Compuserv� i� terminal mode

CLOC� [<val=40>]    - se�s cloc� spee� i� Mhz*10
                     <val� � � t� 25� =� .� t� 25.� Mhz

COMMENT [<char="/">] - sets <char> as PHONE library comment char

CR� [on|off]        - se�s fil� transfe� verificatio� method

DEBU� [on|off]      - incomin� dat� i� Termina� mode
                     displaye� i� DDT'� Dum� format.
                     disable� FILTE� an� CI� whe� 'on'

DECIMA� [on|off]    - se�s defaul� radi� fo� MEX

DIAL [<char="T">]   - sets smartmodem dialing type (T or P)

ES� [<char="^J">]   - defin�s ter�inal mod� escap� character

EXCLUD� [on|off]    - ignor�s SY� file� whe� <filespec� i� ambig

EXITFILE [on|off]   - searches for EXI.MEX when exiting MEX

EXTEN� [on|off]     - caus�s illega� ME� command� t� b�
                        interprete� a� REA� commands

FILTE� [on|off]     - ignor�s uncommo� contro� char�
                     (othe� tha� CR� LF� BS� TAB)

HE� [on|off]        - se�s defaul� radi� fo� MEX
                     includin� block number during fil� transfer
                     mutuall� exclusiv� wit� DECIMAL

ID [on|off]         - includes MEX ID in error messages

IDD [<val=15>]      - delays between calls (in 100s of ms)

INITFIL� [on|off]   - searc�es fo� INI.ME� whe� bootin� MEX

L� [on|off]         - ad�s L� t� al� C� i� Ter� fil� transfers

LIS� [on|off]       - enabl�s LS� device

PAG� [<val=24>]     - screen size for TYPE pagination (0 = none)

PRECHO [on|off]     - enables logging to printer

QUEUE [on|off]      - queues modem characters after X-OFF

cp 3 �REPL� [<val=8>]     - se�s tim� (0-25� secs� fo� SENDOU� t� wai�
                        fo� � repl� fro� remot� system (0 will
                        wait forever)

RETR� [<val=6>]     - se� SENDOUT retrie� (1-255� befor� aborting
                     WTECHO must be on

RTIM� [<val=1>]     - se�s receiver timeout wait time (1-3� secs�

RU� [on|off]        - backspace� sen� converte� t� rubs

SEARC� [<val=2>]    - se�s searc� patter� use� fo� REA� files�
                        phon� libraries� keystrin� files� an�
                        captur� file� (wit� Appen� option)
                     � - logge� D�     � - logge� DU� ALT
                     � - AL�           � - ALT� logge� DU

SE� [<char=";">]    - se�s comman� separato� fo� mult� cm� lines

SILEN� [on|off]     - suppres�es ech� o� REA� fil� comman� lines

SMDISC [on|off]     - controls software modem disconnect

SOAK [on|off]       - flushes terminal mode buffer

SODELAY [on|off]    - honors WCHAR and WLINE during SENDOUTs

SPLI� [on|off]      - lists phone library � pe� lin� wit� bps
                     els� liste� � pe� lin� withou� bps

SWITC�              - lis�s al� '{on|off}� variables

TAB [on|off]        - expands tabs to multiple spaces

TERM                - lists terminal control sequences

TRIGGE� [<char=">">] - set� <char� t� wai� fo� befor� SENDOUT

TSTAMP [on|off]     - logs time in terminal mode log files

VA�                 - lis�s al� <val� variables

WCHA� [<val=5>]     - dela�s afte� eac� cha� (0-� i� 10� o� ms)
                     may be suspende by WTECHO

WECHO [<val=4>]     - sets echo-wait time for SENDOUT

WLIM [<val=16>]     - maximum WAIT STRING character count in kb

WLIN� [<val=5>]     - dela�s afte� eac� lin� (0-� i� 100� o� ms)
                     may be suspended by WTECHO

WTECH� [on|off]     - verifies command� sen� wit� thei� echo
                     halve� transmissio� time
                     takes precedence over WCHAR and WLINE �
XLIN� [on|off]      - fo� ter�inal mod� fil� transfers
                     wait� fo� XO� afte� eac� lin� (uncommon)

XO� [on|off]        - fo� ter�inal mod� fil� transfers
                     send� unti� XOFF� continue� a� XON