391 lines
11 KiB
Plaintext
391 lines
11 KiB
Plaintext
|
10/18/89 Undocumented Features in RELAY Gold Version 4.0 Page 1
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
P R E F A C E
|
|||
|
|
- - - - - - -
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
This document describes advanced new features in RELAY Gold
|
|||
|
|
version 4.0 which are NOT present in the current printing of
|
|||
|
|
the RELAY Gold User Manual. Also, certain previously
|
|||
|
|
documented features are described here in more detail.
|
|||
|
|
|
|||
|
|
The majority of this document is intended primarily for users
|
|||
|
|
of RELAY Gold's Script Language. If you do not write scripts
|
|||
|
|
for automating RELAY Gold tasks, you should only need to read
|
|||
|
|
through page 3.
|
|||
|
|
|
|||
|
|
To print this document, simply issue the DOS command:
|
|||
|
|
|
|||
|
|
COPY README LPT1:
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
(c) Copyright 1985,89 by Microcom Software Division
|
|||
|
|
10/18/89 Undocumented Features in RELAY Gold Version 4.0 Page 2
|
|||
|
|
|
|||
|
|
|
|||
|
|
GENERAL RELAY Gold FEATURES
|
|||
|
|
------- ----- ---- --------
|
|||
|
|
|
|||
|
|
|
|||
|
|
1) When using VT240 graphics, you may save a graph using the script
|
|||
|
|
command "SAVEGRAPH fileid" (which is listed in the User Manual
|
|||
|
|
only for 3279 graphics). This graph may be viewed or printed
|
|||
|
|
outside of RELAY Gold using the supplied DOS command
|
|||
|
|
"VIEWG240 fileid".
|
|||
|
|
|
|||
|
|
|
|||
|
|
2) When installing RELAY Gold on either two 360K or a single 720K
|
|||
|
|
floppy disk, the Color, Queue, and Tone managers are not available.
|
|||
|
|
Also, VT240, 3101-20, and 3279 graphics terminal emulations are not
|
|||
|
|
available due to disk space restrictions.
|
|||
|
|
|
|||
|
|
There are no restrictions if you are installing RELAY Gold on a
|
|||
|
|
single 1.2M or 1.4M floppy disk or on a "hard" disk.
|
|||
|
|
|
|||
|
|
|
|||
|
|
3) The COM3 and COM4 ports on a non-PS/2 system are now supported by
|
|||
|
|
RELAY Gold. To use these, use a port number of "13" for COM3 or
|
|||
|
|
"14" for COM4. Ports 3 and 4 are used for PS/2 systems only,
|
|||
|
|
which support up to 8 COM ports.
|
|||
|
|
|
|||
|
|
Advanced users may wish to note that the port names used are
|
|||
|
|
"COM3PC" and "COM4PC". These are specified on the "Advanced
|
|||
|
|
Communication Options" screen, which follows the "Personal
|
|||
|
|
Computer Options" screen.
|
|||
|
|
|
|||
|
|
|
|||
|
|
4) If you wish to have RELAY Gold answer a telephone call on a ring
|
|||
|
|
other than the first, setup the following commands in your Offline
|
|||
|
|
Profile, file "RELAY.OFP":
|
|||
|
|
|
|||
|
|
GLOBAL &$MRINGS
|
|||
|
|
&$MRINGS = n
|
|||
|
|
|
|||
|
|
Where "n" is the ring number to answer on (2 for the second ring,
|
|||
|
|
3 for the third, and so on).
|
|||
|
|
|
|||
|
|
Please note that this feature is only available with modems which
|
|||
|
|
use the "AT" command set, such as the Microcom and Hayes modems.
|
|||
|
|
|
|||
|
|
|
|||
|
|
5) Expanded Memory handling has been dramatically improved in
|
|||
|
|
RELAY Gold 4.0, resulting in a reduction of the required
|
|||
|
|
base DOS memory support to as little as 128K.
|
|||
|
|
|
|||
|
|
RELAY Gold now uses EMS memory for its communication buffers
|
|||
|
|
when there is insufficient system memory available. Normally,
|
|||
|
|
this is handled automatically based on the amount of memory
|
|||
|
|
available or that specified by the "/ST:nnn" startup option.
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
(c) Copyright 1985,89 by Microcom Software Division
|
|||
|
|
10/18/89 Undocumented Features in RELAY Gold Version 4.0 Page 3
|
|||
|
|
|
|||
|
|
If you desire, the selection of EMS memory may also be controlled
|
|||
|
|
manually via the new startup options:
|
|||
|
|
|
|||
|
|
"/COEMS" means "ALWAYS use EMS for communication buffers"
|
|||
|
|
"/NOCOEMS" means "NEVER use EMS for communication buffers"
|
|||
|
|
|
|||
|
|
NOTE: RELAY Gold requires that a contiguous 64KB page frame be
|
|||
|
|
available for EMS use.
|
|||
|
|
|
|||
|
|
|
|||
|
|
6) RELAY Gold's editor may now use EMS memory for its "spill file".
|
|||
|
|
That is, parts of a file being edited which cannot fit into
|
|||
|
|
memory will be temporarily spilled over into EMS memory.
|
|||
|
|
|
|||
|
|
In order to enable this feature, use the startup option "/EDEMS".
|
|||
|
|
That option MUST be specified when starting up RELAY Gold if
|
|||
|
|
you want the editor to use EMS memory. If you want to use the
|
|||
|
|
/EDEMS option always, place it in the DOS environment via the
|
|||
|
|
command "SET RELAYOPT=/EDEMS" (as described in the User Manual).
|
|||
|
|
|
|||
|
|
|
|||
|
|
7) The YMODEM file transfer protocol is now supported by RELAY Gold.
|
|||
|
|
Various new "file protocol" values may be entered on the
|
|||
|
|
communication option screens:
|
|||
|
|
|
|||
|
|
Y = Single-File YMODEM (also called XMODEM-1K)
|
|||
|
|
YB = "Batch" YMODEM
|
|||
|
|
YG = "Streaming" YMODEM for error-correcting modems
|
|||
|
|
YBG = "Streaming" and "Batch" YMODEM
|
|||
|
|
|
|||
|
|
Note: Script programmers may refer to the SET PROTOCOL and YMODEM
|
|||
|
|
script commands described later in this document.
|
|||
|
|
|
|||
|
|
|
|||
|
|
8) 3287 printer emulation has been added to RELAY Gold when used in
|
|||
|
|
conjunction with the RELAY/3270 mainframe software product. Specify
|
|||
|
|
a 3270 model number of "2P", "3P", "4P", or "5P" to create a printer
|
|||
|
|
session with a simulated 3287 buffer size of 1920, 2560, 3440, or 3564
|
|||
|
|
characters, respectively.
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
(c) Copyright 1985,89 by Microcom Software Division
|
|||
|
|
10/18/89 Undocumented Features in RELAY Gold Version 4.0 Page 4
|
|||
|
|
|
|||
|
|
|
|||
|
|
ADVANCED RELAY Gold FEATURES
|
|||
|
|
-------- ----- ---- --------
|
|||
|
|
|
|||
|
|
|
|||
|
|
9) The ability to create new "system" script variables has been added.
|
|||
|
|
As with RELAY Gold's predefined system variables, these user-defined
|
|||
|
|
variables are read-only and common to all sessions.
|
|||
|
|
|
|||
|
|
To define a new system variable, use the command:
|
|||
|
|
|
|||
|
|
DEFINE &variable = "expression"
|
|||
|
|
|
|||
|
|
Usage Notes:
|
|||
|
|
|
|||
|
|
A) The "expression" argument may be either a constant or
|
|||
|
|
contain other script variables. The value of "expression"
|
|||
|
|
is substituted each time the new variable is referenced.
|
|||
|
|
For example, to create a variable containing the date and
|
|||
|
|
time, do:
|
|||
|
|
|
|||
|
|
DEFINE &DATI = "&DATE &TIME"
|
|||
|
|
|
|||
|
|
The current date and time will be substituted each time
|
|||
|
|
that &DATI is referenced (this will NOT be the date and
|
|||
|
|
time that the DEFINE command was issued).
|
|||
|
|
|
|||
|
|
B) A new value may be assigned to a system variable by
|
|||
|
|
reissuing the DEFINE command. Any attempt to assign a
|
|||
|
|
new value by other means (for example, an assignment
|
|||
|
|
statement) results in the creation of a local script
|
|||
|
|
variable having the same name.
|
|||
|
|
|
|||
|
|
|
|||
|
|
10) The editor may now be used to edit binary files which have a
|
|||
|
|
one or two byte record length prefix before each record. For
|
|||
|
|
example, RELAY/VM and RELAY/TSO download variable-length
|
|||
|
|
binary files in this format when the NOCONVERT option is used.
|
|||
|
|
To edit such a file, issue one of the script commands:
|
|||
|
|
|
|||
|
|
"EDIT fileid LENGTH V1" - for a 1-byte prefix
|
|||
|
|
"EDIT fileid LENGTH V2" - for a 2-byte prefix
|
|||
|
|
|
|||
|
|
|
|||
|
|
11) The WAIT.COM file documented in the User Manual is no longer
|
|||
|
|
supplied with RELAY Gold. Use the WAIT script command instead.
|
|||
|
|
WAIT.COM is still available on the RELAY Bulletin Board.
|
|||
|
|
|
|||
|
|
|
|||
|
|
12) The script command "SET 3270COLOR" only accepts the values "ON"
|
|||
|
|
and "OFF". The values "HIGH" and "YELLOW" listed in the User
|
|||
|
|
Manual are not supported.
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
(c) Copyright 1985,89 by Microcom Software Division
|
|||
|
|
10/18/89 Undocumented Features in RELAY Gold Version 4.0 Page 5
|
|||
|
|
|
|||
|
|
13) The "/SL:0" option documented in the User Manual should NOT be
|
|||
|
|
used unless you are developing applications using the RELAY Gold
|
|||
|
|
Toolbox.
|
|||
|
|
|
|||
|
|
|
|||
|
|
14) Certain 3270 emulation boards do not properly respond with screen
|
|||
|
|
changes to RELAY Gold. A new option has been added to account for
|
|||
|
|
these boards. Issue the script command "SET 3270REREAD ON" if you
|
|||
|
|
seem to be missing screen updates for the following 3270 boards:
|
|||
|
|
|
|||
|
|
ITT Courier's "ITT IRMA 7580"
|
|||
|
|
ITT Courier's "ITT IRMA 95437i"
|
|||
|
|
|
|||
|
|
|
|||
|
|
15) The SET FRAMESIZE command now accepts several alternate sizes which
|
|||
|
|
limit the amount of data sent in each block when using RELAY Gold's
|
|||
|
|
proprietary protocol. This may be useful in certain host and network
|
|||
|
|
environments. The additional sizes supported are: 64, 96, 120, and
|
|||
|
|
240 bytes.
|
|||
|
|
|
|||
|
|
|
|||
|
|
16) Certain non-standard "AT" command set modems raise the "Carrier
|
|||
|
|
Detect" signal when answering the telephone even if no modem is on
|
|||
|
|
the calling side. For these modems, RELAY Gold will display the
|
|||
|
|
Terminal Screen even though no connection was actually established.
|
|||
|
|
If you encounter this problem, you may tell RELAY Gold to ignore
|
|||
|
|
the extraneous Carrier Detect signal by placing the following
|
|||
|
|
commands in your Offline Profile, file "RELAY.OFP":
|
|||
|
|
|
|||
|
|
GLOBAL &$MRLSD
|
|||
|
|
&$MRLSD = "OFF"
|
|||
|
|
|
|||
|
|
|
|||
|
|
17) A new option has been added to the script command OPEN: Specifying
|
|||
|
|
the SHARED keyword when opening a file for random access (via the
|
|||
|
|
LENGTH option) allow multiple users to read and write the same file
|
|||
|
|
simultaneously. For example:
|
|||
|
|
|
|||
|
|
OPEN "N:OURFILE" AS #1 LENGTH 16 SHARED
|
|||
|
|
|
|||
|
|
Please remember that actual data written to the file may not be
|
|||
|
|
processed by DOS until the CLOSE command is used. To update the
|
|||
|
|
file contents without actually closing the file, use:
|
|||
|
|
|
|||
|
|
CLOSE #1 TEMP
|
|||
|
|
|
|||
|
|
|
|||
|
|
18) The SET PROTOCOL script command has been enhanced to support the
|
|||
|
|
YMODEM file transfer protocol:
|
|||
|
|
|
|||
|
|
SET PROTOCOL YMODEM
|
|||
|
|
|
|||
|
|
-- Sets file transfer protocol to "Single-File" YMODEM
|
|||
|
|
|
|||
|
|
SET PROTOCOL YMODEM BATCH
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
(c) Copyright 1985,89 by Microcom Software Division
|
|||
|
|
10/18/89 Undocumented Features in RELAY Gold Version 4.0 Page 6
|
|||
|
|
|
|||
|
|
|
|||
|
|
-- Sets file transfer protocol to "Batch" YMODEM
|
|||
|
|
|
|||
|
|
SET PROTOCOL YMODEM G
|
|||
|
|
|
|||
|
|
-- Sets file transfer protocol to "Streaming" YMODEM
|
|||
|
|
|
|||
|
|
SET PROTOCOL YMODEM BATCH G
|
|||
|
|
|
|||
|
|
-- Sets file transfer protocol to "Streaming and "Batch" YMODEM
|
|||
|
|
|
|||
|
|
The YMODEM script command sets various protcol options used during
|
|||
|
|
a file transfer. These have the same functions as the corresponding
|
|||
|
|
options documented for the XMODEM command in the RELAY Gold User Manual:
|
|||
|
|
|
|||
|
|
YMODEM CANCEL ON/OFF
|
|||
|
|
YMODEM CHECK CRC/SUM
|
|||
|
|
YMODEM RETRIES n
|
|||
|
|
YMODEM ITIMEOUT n
|
|||
|
|
YMODEM RTIMEOUT n
|
|||
|
|
|
|||
|
|
|
|||
|
|
19) The SET BREAKLEN option now accepts a value of zero. This value
|
|||
|
|
disables the transmission of all break sequences. It is useful
|
|||
|
|
with some networks and protocol converters which do not properly
|
|||
|
|
handle breaks.
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
(c) Copyright 1985,89 by Microcom Software Division
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
X-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-X
|
|||
|
|
Another file downloaded from: The NIRVANAnet(tm) Seven
|
|||
|
|
|
|||
|
|
& the Temple of the Screaming Electron Taipan Enigma 510/935-5845
|
|||
|
|
Burn This Flag Zardoz 408/363-9766
|
|||
|
|
realitycheck Poindexter Fortran 510/527-1662
|
|||
|
|
Lies Unlimited Mick Freen 801/278-2699
|
|||
|
|
The New Dork Sublime Biffnix 415/864-DORK
|
|||
|
|
The Shrine Rif Raf 206/794-6674
|
|||
|
|
Planet Mirth Simon Jester 510/786-6560
|
|||
|
|
|
|||
|
|
"Raw Data for Raw Nerves"
|
|||
|
|
X-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-X
|