ftp.barnyard.co.uk/2015.02.ftp.barnyard.co.uk.tar/ftp.barnyard.co.uk/cpm/walnut-creek-CDROM/CPM/MEX/MEX16SUM.WS

Text File | 2000-06-30 | 23KB | 597 lines

.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 [<char=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