home *** CD-ROM | disk | FTP | other *** search
/ Jason Aller Floppy Collection / 158.img / RELAY2.ZIP / README < prev    next >
Text File  |  1989-10-18  |  10KB  |  373 lines
  1.   10/18/89     Undocumented Features in RELAY Gold Version 4.0      Page 1
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                  P R E F A C E
  8.                  - - - - - - -
  9.  
  10.  
  11.  
  12.        This document describes advanced new features in RELAY Gold
  13.        version 4.0 which are NOT present in the current printing of
  14.        the RELAY Gold User Manual. Also, certain previously
  15.        documented features are described here in more detail.
  16.  
  17.        The majority of this document is intended primarily for users
  18.        of RELAY Gold's Script Language. If you do not write scripts
  19.        for automating RELAY Gold tasks, you should only need to read
  20.        through page 3.
  21.  
  22.        To print this document, simply issue the DOS command:
  23.  
  24.                COPY README LPT1:
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.           (c) Copyright 1985,89 by Microcom Software Division
  63.   10/18/89     Undocumented Features in RELAY Gold Version 4.0      Page 2
  64.  
  65.  
  66.               GENERAL RELAY Gold FEATURES
  67.               ------- ----- ---- --------
  68.  
  69.  
  70. 1) When using VT240 graphics, you may save a graph using the script
  71.    command "SAVEGRAPH fileid" (which is listed in the User Manual
  72.    only for 3279 graphics). This graph may be viewed or printed
  73.    outside of RELAY Gold using the supplied DOS command
  74.    "VIEWG240 fileid".
  75.  
  76.  
  77. 2) When installing RELAY Gold on either two 360K or a single 720K
  78.    floppy disk, the Color, Queue, and Tone managers are not available.
  79.    Also, VT240, 3101-20, and 3279 graphics terminal emulations are not
  80.    available due to disk space restrictions.
  81.  
  82.    There are no restrictions if you are installing RELAY Gold on a
  83.    single 1.2M or 1.4M floppy disk or on a "hard" disk.
  84.  
  85.  
  86. 3) The COM3 and COM4 ports on a non-PS/2 system are now supported by
  87.    RELAY Gold. To use these, use a port number of "13" for COM3 or
  88.    "14" for COM4. Ports 3 and 4 are used for PS/2 systems only,
  89.    which support up to 8 COM ports.
  90.  
  91.    Advanced users may wish to note that the port names used are
  92.    "COM3PC" and "COM4PC". These are specified on the "Advanced
  93.    Communication Options" screen, which follows the "Personal
  94.    Computer Options" screen.
  95.  
  96.  
  97. 4) If you wish to have RELAY Gold answer a telephone call on a ring
  98.    other than the first, setup the following commands in your Offline
  99.    Profile, file "RELAY.OFP":
  100.  
  101.      GLOBAL &$MRINGS
  102.      &$MRINGS = n
  103.  
  104.    Where "n" is the ring number to answer on (2 for the second ring,
  105.    3 for the third, and so on).
  106.  
  107.    Please note that this feature is only available with modems which
  108.    use the "AT" command set, such as the Microcom and Hayes modems.
  109.  
  110.  
  111. 5) Expanded Memory handling has been dramatically improved in
  112.    RELAY Gold 4.0, resulting in a reduction of the required
  113.    base DOS memory support to as little as 128K.
  114.  
  115.    RELAY Gold now uses EMS memory for its communication buffers
  116.    when there is insufficient system memory available. Normally,
  117.    this is handled automatically based on the amount of memory
  118.    available or that specified by the "/ST:nnn" startup option.
  119.  
  120.  
  121.  
  122.  
  123.  
  124.           (c) Copyright 1985,89 by Microcom Software Division
  125.   10/18/89     Undocumented Features in RELAY Gold Version 4.0      Page 3
  126.  
  127.    If you desire, the selection of EMS memory may also be controlled
  128.    manually via the new startup options:
  129.  
  130.      "/COEMS"   means "ALWAYS use EMS for communication buffers"
  131.      "/NOCOEMS" means "NEVER use EMS for communication buffers"
  132.  
  133.    NOTE: RELAY Gold requires that a contiguous 64KB page frame be
  134.    available for EMS use.
  135.  
  136.  
  137. 6) RELAY Gold's editor may now use EMS memory for its "spill file".
  138.    That is, parts of a file being edited which cannot fit into
  139.    memory will be temporarily spilled over into EMS memory.
  140.  
  141.    In order to enable this feature, use the startup option "/EDEMS".
  142.    That option MUST be specified when starting up RELAY Gold if
  143.    you want the editor to use EMS memory. If you want to use the
  144.    /EDEMS option always, place it in the DOS environment via the
  145.    command "SET RELAYOPT=/EDEMS" (as described in the User Manual).
  146.  
  147.  
  148. 7) The YMODEM file transfer protocol is now supported by RELAY Gold.
  149.    Various new "file protocol" values may be entered on the
  150.    communication option screens:
  151.  
  152.      Y   = Single-File YMODEM (also called XMODEM-1K)
  153.      YB  = "Batch" YMODEM
  154.      YG  = "Streaming" YMODEM for error-correcting modems
  155.      YBG = "Streaming" and "Batch" YMODEM
  156.  
  157.    Note: Script programmers may refer to the SET PROTOCOL and YMODEM
  158.    script commands described later in this document.
  159.  
  160.  
  161. 8) 3287 printer emulation has been added to RELAY Gold when used in
  162.    conjunction with the RELAY/3270 mainframe software product. Specify
  163.    a 3270 model number of "2P", "3P", "4P", or "5P" to create a printer
  164.    session with a simulated 3287 buffer size of 1920, 2560, 3440, or 3564
  165.    characters, respectively.
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.           (c) Copyright 1985,89 by Microcom Software Division
  187.   10/18/89     Undocumented Features in RELAY Gold Version 4.0      Page 4
  188.  
  189.  
  190.              ADVANCED RELAY Gold FEATURES
  191.              -------- ----- ---- --------
  192.  
  193.  
  194. 9) The ability to create new "system" script variables has been added.
  195.    As with RELAY Gold's predefined system variables, these user-defined
  196.    variables are read-only and common to all sessions.
  197.  
  198.    To define a new system variable, use the command:
  199.  
  200.      DEFINE &variable = "expression"
  201.  
  202.    Usage Notes:
  203.  
  204.      A) The "expression" argument may be either a constant or
  205.         contain other script variables. The value of "expression"
  206.         is substituted each time the new variable is referenced.
  207.         For example, to create a variable containing the date and
  208.         time, do:
  209.  
  210.           DEFINE &DATI = "&DATE &TIME"
  211.  
  212.         The current date and time will be substituted each time
  213.         that &DATI is referenced (this will NOT be the date and
  214.         time that the DEFINE command was issued).
  215.  
  216.      B) A new value may be assigned to a system variable by
  217.         reissuing the DEFINE command. Any attempt to assign a
  218.         new value by other means (for example, an assignment
  219.         statement) results in the creation of a local script
  220.         variable having the same name.
  221.  
  222.  
  223. 10) The editor may now be used to edit binary files which have a
  224.     one or two byte record length prefix before each record. For
  225.     example, RELAY/VM and RELAY/TSO download variable-length
  226.     binary files in this format when the NOCONVERT option is used.
  227.     To edit such a file, issue one of the script commands:
  228.  
  229.      "EDIT fileid LENGTH V1" - for a 1-byte prefix
  230.      "EDIT fileid LENGTH V2" - for a 2-byte prefix
  231.  
  232.  
  233. 11) The WAIT.COM file documented in the User Manual is no longer
  234.     supplied with RELAY Gold. Use the WAIT script command instead.
  235.     WAIT.COM is still available on the RELAY Bulletin Board.
  236.  
  237.  
  238. 12) The script command "SET 3270COLOR" only accepts the values "ON"
  239.     and "OFF". The values "HIGH" and "YELLOW" listed in the User
  240.     Manual are not supported.
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.           (c) Copyright 1985,89 by Microcom Software Division
  249.   10/18/89     Undocumented Features in RELAY Gold Version 4.0      Page 5
  250.  
  251. 13) The "/SL:0" option documented in the User Manual should NOT be
  252.     used unless you are developing applications using the RELAY Gold
  253.     Toolbox.
  254.  
  255.  
  256. 14) Certain 3270 emulation boards do not properly respond with screen
  257.     changes to RELAY Gold. A new option has been added to account for
  258.     these boards. Issue the script command "SET 3270REREAD ON" if you
  259.     seem to be missing screen updates for the following 3270 boards:
  260.  
  261.      ITT Courier's "ITT IRMA 7580"
  262.      ITT Courier's "ITT IRMA 95437i"
  263.  
  264.  
  265. 15) The SET FRAMESIZE command now accepts several alternate sizes which
  266.     limit the amount of data sent in each block when using RELAY Gold's
  267.     proprietary protocol. This may be useful in certain host and network
  268.     environments. The additional sizes supported are: 64, 96, 120, and
  269.     240 bytes.
  270.  
  271.  
  272. 16) Certain non-standard "AT" command set modems raise the "Carrier
  273.     Detect" signal when answering the telephone even if no modem is on
  274.     the calling side. For these modems, RELAY Gold will display the
  275.     Terminal Screen even though no connection was actually established.
  276.     If you encounter this problem, you may tell RELAY Gold to ignore
  277.     the extraneous Carrier Detect signal by placing the following
  278.     commands in your Offline Profile, file "RELAY.OFP":
  279.  
  280.      GLOBAL &$MRLSD
  281.      &$MRLSD = "OFF"
  282.  
  283.  
  284. 17) A new option has been added to the script command OPEN: Specifying
  285.     the SHARED keyword when opening a file for random access (via the
  286.     LENGTH option) allow multiple users to read and write the same file
  287.     simultaneously. For example:
  288.  
  289.      OPEN "N:OURFILE" AS #1 LENGTH 16 SHARED
  290.  
  291.     Please remember that actual data written to the file may not be
  292.     processed by DOS until the CLOSE command is used. To update the
  293.     file contents without actually closing the file, use:
  294.  
  295.      CLOSE #1 TEMP
  296.  
  297.  
  298. 18) The SET PROTOCOL script command has been enhanced to support the
  299.     YMODEM file transfer protocol:
  300.  
  301.      SET PROTOCOL YMODEM
  302.  
  303.      -- Sets file transfer protocol to "Single-File" YMODEM
  304.  
  305.      SET PROTOCOL YMODEM BATCH
  306.  
  307.  
  308.  
  309.  
  310.           (c) Copyright 1985,89 by Microcom Software Division
  311.   10/18/89     Undocumented Features in RELAY Gold Version 4.0      Page 6
  312.  
  313.  
  314.      -- Sets file transfer protocol to "Batch" YMODEM
  315.  
  316.      SET PROTOCOL YMODEM G
  317.  
  318.      -- Sets file transfer protocol to "Streaming" YMODEM
  319.  
  320.      SET PROTOCOL YMODEM BATCH G
  321.  
  322.      -- Sets file transfer protocol to "Streaming and "Batch" YMODEM
  323.  
  324.      The YMODEM script command sets various protcol options used during
  325.      a file transfer. These have the same functions as the corresponding
  326.      options documented for the XMODEM command in the RELAY Gold User Manual:
  327.  
  328.      YMODEM CANCEL ON/OFF
  329.      YMODEM CHECK CRC/SUM
  330.      YMODEM RETRIES n
  331.      YMODEM ITIMEOUT n
  332.      YMODEM RTIMEOUT n
  333.  
  334.  
  335. 19) The SET BREAKLEN option now accepts a value of zero. This value
  336.     disables the transmission of all break sequences. It is useful
  337.     with some networks and protocol converters which do not properly
  338.     handle breaks.
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.           (c) Copyright 1985,89 by Microcom Software Division
  373.