  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
