home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / CO / CO003A.ZIP / GT1402-1.ARC / GT1400.DOC < prev    next >
Text File  |  1988-06-27  |  188KB  |  5,013 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                  GT POWER 14.00
  8.                  Copyright (c) 1985, 1988: by P & M Software Co.
  9.                               All rights reserved.
  10.  
  11.                                  April 20, 1988
  12.  
  13.  
  14.      GT POWER,  or just  GT for  short, is  a communications  program for IBM
  15.      Personal Computers and compatible units.   P &  M Software  Co. reserves
  16.      the COPYRIGHT  to this  program and  all related materials.  The user is
  17.      granted a license to  use  the  program  and  is  encouraged  to  make a
  18.      donation if the program is found to be useful.  $60 U.S. is recommended.
  19.      Send the donations to:
  20.  
  21.  
  22.                              P & M Software Company
  23.                              9350 Country Creek #30
  24.                              Houston, Texas   77036
  25.                              U.S.A.
  26.  
  27.                              Voice Phone: (713) 728-4313
  28.                              Modem Phone: (713) 772-2090
  29.                              Modem Phone: (713) 778-9471
  30.  
  31.      For further information about the  GT  POWER  registration  plan, please
  32.      read the  file called  REGISTER.DOC, which  comes with this program.  It
  33.      outlines the benefits of full registration.
  34.  
  35.      In addition, the user is granted the right  to make  unlimited copies of
  36.      the program  and to  distribute these  copies as  he/she desires, EXCEPT
  37.      that P & M Software  Co.  reserves  the  SOLE  right  to  distribute the
  38.      program for  PROFIT.   If the user distributes the product, the user may
  39.      collect for a duplication charge, not to exceed $6 per copy.
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                         1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                 Table of Contents
  71.                                 -----------------
  72.  
  73.      Credit Where Credit is Due  . . . . . . . . . . . . . . . . . . . .    4
  74.      Features  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    5
  75.      Functional Overview . . . . . . . . . . . . . . . . . . . . . . . .    8
  76.  
  77.      Installation Notes  . . . . . . . . . . . . . . . . . . . . . . . .   10
  78.           External Protocols . . . . . . . . . . . . . . . . . . . . . .   10
  79.           IMPORTANT  . . . . . . . . . . . . . . . . . . . . . . . . . .   11
  80.           Environment Usage  . . . . . . . . . . . . . . . . . . . . . .   11
  81.           DOS 3.2  . . . . . . . . . . . . . . . . . . . . . . . . . . .   11
  82.           DOS 3.3  . . . . . . . . . . . . . . . . . . . . . . . . . . .   12
  83.           General notes on DOS . . . . . . . . . . . . . . . . . . . . .   12
  84.           Modem Result Codes . . . . . . . . . . . . . . . . . . . . . .   12
  85.           Multiple Result Codes  . . . . . . . . . . . . . . . . . . . .   13
  86.  
  87.      First Time Usage  . . . . . . . . . . . . . . . . . . . . . . . . .   14
  88.           Millisec Loop Count  . . . . . . . . . . . . . . . . . . . . .   14
  89.  
  90.      Command Line Usage  . . . . . . . . . . . . . . . . . . . . . . . .   16
  91.      RAM Disk Usage  . . . . . . . . . . . . . . . . . . . . . . . . . .   18
  92.      Coping With A Floppy Based System . . . . . . . . . . . . . . . . .   19
  93.      Computer To Computer Without Modems . . . . . . . . . . . . . . . .   21
  94.  
  95.      Alt-Command Descriptions  . . . . . . . . . . . . . . . . . . . . .   22
  96.           ASCII transmit . . . . . . . . . . . . . . . . . . . . . . . .   22
  97.           BREAK signal . . . . . . . . . . . . . . . . . . . . . . . . .   22
  98.           Capture mode . . . . . . . . . . . . . . . . . . . . . . . . .   22
  99.                Capture header  . . . . . . . . . . . . . . . . . . . . .   23
  100.           Phone directory  . . . . . . . . . . . . . . . . . . . . . . .   23
  101.           Half Duplex  . . . . . . . . . . . . . . . . . . . . . . . . .   23
  102.           Take a time fix  . . . . . . . . . . . . . . . . . . . . . . .   23
  103.           Re-dial last number  . . . . . . . . . . . . . . . . . . . . .   23
  104.           The HELP screen  . . . . . . . . . . . . . . . . . . . . . . .   23
  105.           Reconfigure the program  . . . . . . . . . . . . . . . . . . .   23
  106.           Program version and serial number  . . . . . . . . . . . . . .   24
  107.           Erase a file . . . . . . . . . . . . . . . . . . . . . . . . .   24
  108.           Display disk directory . . . . . . . . . . . . . . . . . . . .   24
  109.           Macro key management . . . . . . . . . . . . . . . . . . . . .   24
  110.                Keyboard Macros . . . . . . . . . . . . . . . . . . . . .   25
  111.                Execute an external program . . . . . . . . . . . . . . .   25
  112.                Record keystrokes . . . . . . . . . . . . . . . . . . . .   25
  113.                Stop keystroke recording  . . . . . . . . . . . . . . . .   25
  114.                Playback keystrokes . . . . . . . . . . . . . . . . . . .   25
  115.                Toggle status line update . . . . . . . . . . . . . . . .   26
  116.                Extended keys . . . . . . . . . . . . . . . . . . . . . .   26
  117.           Change logged drive  . . . . . . . . . . . . . . . . . . . . .   26
  118.           Sort dialing directory . . . . . . . . . . . . . . . . . . . .   26
  119.           Print a file . . . . . . . . . . . . . . . . . . . . . . . . .   26
  120.           Hang-up the telephone  . . . . . . . . . . . . . . . . . . . .   27
  121.           Download a file  . . . . . . . . . . . . . . . . . . . . . . .   27
  122.           Change communication parameters  . . . . . . . . . . . . . . .   27
  123.           Upload a file  . . . . . . . . . . . . . . . . . . . . . . . .   27
  124.                The Pick List . . . . . . . . . . . . . . . . . . . . . .   27
  125.           Used time display  . . . . . . . . . . . . . . . . . . . . . .   28
  126.           View a file  . . . . . . . . . . . . . . . . . . . . . . . . .   28
  127.           Clear screen . . . . . . . . . . . . . . . . . . . . . . . . .   28
  128.  
  129.                                         2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.           Exit the program . . . . . . . . . . . . . . . . . . . . . . .   28
  137.           Copy a file  . . . . . . . . . . . . . . . . . . . . . . . . .   28
  138.           Toggle monitor mode  . . . . . . . . . . . . . . . . . . . . .   28
  139.           Shell to DOS . . . . . . . . . . . . . . . . . . . . . . . . .   28
  140.           Screen dump  . . . . . . . . . . . . . . . . . . . . . . . . .   29
  141.           Execute a script . . . . . . . . . . . . . . . . . . . . . . .   29
  142.           Suspend capture mode . . . . . . . . . . . . . . . . . . . . .   29
  143.           Checksum Xmodem  . . . . . . . . . . . . . . . . . . . . . . .   29
  144.           Circular dialing . . . . . . . . . . . . . . . . . . . . . . .   29
  145.           Split screen mode  . . . . . . . . . . . . . . . . . . . . . .   29
  146.           Review capture buffer  . . . . . . . . . . . . . . . . . . . .   29
  147.           Quiet mode . . . . . . . . . . . . . . . . . . . . . . . . . .   30
  148.           Manual log entry . . . . . . . . . . . . . . . . . . . . . . .   30
  149.           Start host mode  . . . . . . . . . . . . . . . . . . . . . . .   30
  150.           Toggle the printer . . . . . . . . . . . . . . . . . . . . . .   30
  151.  
  152.      Phone directory commands  . . . . . . . . . . . . . . . . . . . . .   31
  153.      Editing keys  . . . . . . . . . . . . . . . . . . . . . . . . . . .   33
  154.      Host mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   34
  155.           GT netmail system  . . . . . . . . . . . . . . . . . . . . . .   34
  156.  
  157.      Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   35
  158.      Script command summary  . . . . . . . . . . . . . . . . . . . . . .   36
  159.      Script command descriptions . . . . . . . . . . . . . . . . . . . .   38
  160.  
  161.      Appendix  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   57
  162.           25th Line Status Indicators  . . . . . . . . . . . . . . . . .   57
  163.           System Files . . . . . . . . . . . . . . . . . . . . . . . . .   58
  164.           Configuration File Layout  . . . . . . . . . . . . . . . . . .   60
  165.           Configuration File Defaults  . . . . . . . . . . . . . . . . .   64
  166.           Color Number Table . . . . . . . . . . . . . . . . . . . . . .   66
  167.           ANSI Emulation - Received Characters . . . . . . . . . . . . .   67
  168.           ANSI Emulation - Transmitted Characters  . . . . . . . . . . .   69
  169.           Support For USRobotics Courier 2400  . . . . . . . . . . . . .   70
  170.           9600 Baud Modem Support  . . . . . . . . . . . . . . . . . . .   71
  171.                Init String Usage . . . . . . . . . . . . . . . . . . . .   71
  172.                Configuration Setup . . . . . . . . . . . . . . . . . . .   71
  173.                19200 Baud Rate . . . . . . . . . . . . . . . . . . . . .   71
  174.           Hayes 2400 Initialization String . . . . . . . . . . . . . . .   72
  175.           Modem Setting Strings for IBM Modems . . . . . . . . . . . . .   73
  176.  
  177.      Registration message  . . . . . . . . . . . . . . . . . . . . . . .   74
  178.      Registration form . . . . . . . . . . . . . . . . . . . . . . . . .   75
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                         3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      Credit Where Credit is Due.
  203.      ---------------------------
  204.      I want to thank the following for their support and encouragement.
  205.  
  206.          Donald Fletcher       John Perry            Garland Thames
  207.          Tom Lang              Allan Winston         Charles Heineke
  208.          Bob Davis             Mel Douglass          Chris Smith
  209.          Tom Scallorn          Bob Juge              Rick Moore
  210.          Rich Hackney          Chuck Forsberg        Dave Steinman
  211.          Rick Kunz             Randy Arnold          Mike Focke
  212.  
  213.  
  214.                       And all of the users of GT POWER.
  215.  
  216.      If I have missed you, I  apologize.   These people  have each  made very
  217.      significant contributions to the development of GT.  The nature of their
  218.      contributions has been intangible.  Things  like the  feedback of ideas,
  219.      the encouragement to excel, and bug reports.  In some cases, actual work
  220.      has  been  contributed,  for   example  several   people  have  expended
  221.      considerable effort  to design  new screens  for GT and help rewrite the
  222.      documentation.  (Any bad things or  missing things  in the documentation
  223.      are still the author's responsibility!  I write terrible documentation.)
  224.  
  225.      Here is a story for trivia buffs. Donald Fletcher, whose name appears at
  226.      the head of the list above, who is virtually unknown within the GT POWER
  227.      community, continues  to be  a great  supporter of GT POWER.  He was the
  228.      first registered user of GT POWER  and to  this day,  holds S/N 0000001.
  229.      Donald,  who  used  to  be  a  resident  of Houston, often calls me long
  230.      distance from his new  home on  the East  coast.   Hey, Don,  if you are
  231.      reading this, thanks for all the support over the years!
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                         4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      Features:
  269.      ---------
  270.      1.   ANSI Standard  terminal emulation,  compatible with many super-mini
  271.           and super-micro  computers.   The VT-100  terminal, manufactured by
  272.           Digital Equipment  Corporation, is  an example  of an ANSI Standard
  273.           terminal.
  274.  
  275.      2.   ANSI.SYS style color graphics, without the need of ANSI.SYS!
  276.  
  277.      3.   BASIC style PLAY for single voice music.
  278.  
  279.      4.   Multiple telephone directories, with 999 entries each.  Records the
  280.           password  for  each  BBS,  as  well  as  the  date and time of last
  281.           contact.  The total number of calls, accumulated  time, uploads and
  282.           downloads are  also recorded.   The  directory may be perused while
  283.           on-line with a host system.
  284.  
  285.      5.   Circular redialing queue.  Up to 200 numbers may be put into queue.
  286.  
  287.      6.   Capture Mode, limited only by the  amount of  disk space available.
  288.           A spill file is used, when the capture buffer is full.  The capture
  289.           buffer can be reviewed on-line, before saving to disk.   The amount
  290.           of data in the capture buffer is displayed on the status line.
  291.  
  292.      7.   ASCII  file  transmission,  using XON/XOFF protocol and/or line-by-
  293.           line pacing and/or inter-character delays.
  294.  
  295.      8.   Full control of all communication parameters.
  296.  
  297.      9.   40 function  keys,  to  store  logon,  passwords,  etc.    NEW, the
  298.           function keys  have been expanded to keyboard macro status, so that
  299.           automation of the  program  can  be  easily  accomplished, includes
  300.           record and playback features.
  301.  
  302.      10.  Full printer support, using XON/XOFF flow control with the host.
  303.  
  304.      11.  Xmodem/CRC protocol.  Plus optional support for the Xmodem Checksum
  305.           protocol.
  306.  
  307.      12.  WXmodem protocol.  This is  the  full-duplex,  windowed  version of
  308.           Xmodem.
  309.  
  310.      13.  Ymodem/CRC protocol.   Both  the batch  and single  file version of
  311.           this protocol are supported.  Ymodem uses 1024 bytes per packet vs.
  312.           128 bytes per packet in Xmodem.  During transmission of a file with
  313.           Ymodem,  if more  than 5  errors are  encountered, the transmission
  314.           will fallback to normal length blocks.  This saves time, because of
  315.           the high overhead encountered with Ymodem  re-transmission of error
  316.           blocks.
  317.  
  318.      14.  Ymodem-G  batch  protocol  is  supported using DSZ.EXE developed by
  319.           Omen Technology INC.  This protocol  is extremely  useful with high
  320.           speed modems that have hardware error correction built-in.
  321.  
  322.      15.  Telink/CRC batch file transfer protocol.
  323.  
  324.      16.  The  exclusive  GT  POWER  protocol,  1k Telink, which combines the
  325.           batch capabilities of Telink with  the  efficiency  of  Ymodem's 1k
  326.  
  327.                                            5
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.           block length.
  335.  
  336.      17.  Sliding Windows  Kermit file transfer protocol is supported.  Using
  337.           PCKERMIT.EXE developed by Columbia University.
  338.  
  339.      18.  Zmodem transfer  protocol is  supported using  DSZ.EXE developed by
  340.           Omen Technology INC.
  341.  
  342.      19.  The  Compuserve  "B"  protocol  is supported using CISB.COM, by P&M
  343.           Software Co.  This protocol is  used  only  when  connected  to the
  344.           Compuserve Information Service.
  345.  
  346.      20.  The  exclusive  GT  POWER  protocol,  MegaLink,  which combines the
  347.           latest 32 bit CRC technology with a full-flow, PC Pursuit friendly,
  348.           batch  protocol.    This  protocol  is among the most efficient and
  349.           reliable  of  protocols.    PC  Pursuit  is  a  service  of Telenet
  350.           Communications Corporation.
  351.  
  352.      21.  SEAlink transfer protocol is supported.  This protocol is extremely
  353.           efficient and ideal for use with such BBS systems as OPUS.
  354.  
  355.      22.  DOS Shell.  Exit to DOS then return, GT stays in the background.
  356.  
  357.      23.  Interactive script language, to automate many repetitive tasks.
  358.  
  359.      24.  Optional LOG file.  Keeps a complete record of your calls.
  360.  
  361.      25.  Advanced "call progress" detection.  Detects  BUSY, VOICE,  NO DIAL
  362.           TONE,  and  more,  with  modems that support extended result codes,
  363.           such as the USRobotics  Courier 2400  Modem.   Multiple result code
  364.           entries can  be entered  so that  more than  one modem  type can be
  365.           easily supported.  For  example, the  result codes  for Racal-Vadic
  366.           and Hayes  modems could be simultaneously recognized.  This is very
  367.           handy for users of PC Pursuit, allowing them to use the native mode
  368.           of the Racal-Vadic modems in use by that service.
  369.  
  370.      26.  Use of  the environment  variable, GTPATH,  to simplify  use of the
  371.           program on a hard disk.
  372.  
  373.      27.  On-screen clock, so there is no  need for  a memory  resident clock
  374.           program.
  375.  
  376.      28.  Host mode.   Allows  the user  to setup a system to accept incoming
  377.           calls.  File transfers can  be  made  without  the  use  of  a BBS!
  378.           Complete   security is  incorporated into  the host.  The host mode
  379.           also includes a powerful  message  system.    A  flexible ring-back
  380.           procedure if  provided to  enable sharing of a data line with voice
  381.           requirements.
  382.  
  383.      29.  Support for the non-standard COM ports: 3 and  4.   Since these are
  384.           not  standard,   there  are   different  configurations  from  each
  385.           manufacturer - GT supports the Everex configuration as  the default
  386.           for COM3  and COM4, however the port addresses are configurable via
  387.           command line option.
  388.  
  389.      30.  For those with limited disk space, a Terminal Only version of GT is
  390.           distributed.   This version  is referred  to as  GTO, for GTerminal
  391.           Only.  It saves more than 70k of disk space when compared  with the
  392.  
  393.                                            6
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.           full GT version.
  401.  
  402.      31.  With non-batch  protocols, such  as Xmodem,  WXmodem and Ymodem, GT
  403.           will scan the screen for the filename indicated  to the  BBS.  This
  404.           can save  double typing of the filename.  A very handy feature.  To
  405.           make complete use of  this  feature,  you  should  set  the default
  406.           protocol for each BBS to be one of the protocols listed above.
  407.  
  408.      32.  GT NetMail.   This  is a  very inexpensive  way to communicate with
  409.           your fellow GT users.  Most  GT  host  systems  participate  in the
  410.           network, which  stretches from  Australia thru the US and Canada to
  411.           the United Kingdom and  the  Netherlands.    NOTE:  The  GT NetMail
  412.           programs are  not shareware.  They are provided at no extra cost to
  413.           users who register GT.  An extra incentive to register GT!
  414.  
  415.      33.  GT is a shareware product.   This  means  that  it  is  provided at
  416.           little or  no cost  to the end user for an evaluation.  If the user
  417.           decides to continue using GT past  a reasonable  evaluation period,
  418.           then the  user is  expected to  submit the  requested donation.  In
  419.           this spirit, GT has incorporated within  it a  "usage counter", for
  420.           each usage  the program will delay startup for an additional 1/50th
  421.           of a second.  This delay has a maximum value of 60 seconds.  If the
  422.           user  decides  to  register  GT,  then the user will receive a key,
  423.           which bypasses the delay and allows the user  to enter  the program
  424.           much more quickly.
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                                            7
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      Functional Overview
  467.      -------------------
  468.      GT  POWER  is  a  set  of  programs  and  files  that  provide  complete
  469.      capabilities for your system.  It has been designed to  be based  on IBM
  470.      and compatible  micro-computers and it supports a wide variety of modems
  471.      including all Hayes compatibles, USRobotics, and IBM.
  472.  
  473.      As you have seen from the previous three pages which listed many  of the
  474.      features  of  this  program,  there  are  a  large  number of functional
  475.      capabilities provided by GT POWER.   Nevertheless, you  will quickly see
  476.      that these  functions have  been provided in a very friendly environment
  477.      for your use and that the  software is  quite easy  to use.   It  is not
  478.      necessary, for  example, to remember any commands or special features of
  479.      the program as there is a  comprehensive Help  Menu available  to you at
  480.      any time the program is running.
  481.  
  482.      Basically there are three usages of a communications system such as
  483.      GT POWER:
  484.  
  485.      1.   To  call   other  computer   systems  and  engage  in  'telex-like'
  486.           conversations with the person (or computer) called.
  487.  
  488.      2.   To transfer files (programs and data) between computers.
  489.  
  490.      3.   To  establish  an  unattended  host  mode  environment  that  other
  491.           computer users  can call  and interact  with.  For example, to send
  492.           files to  your  system  or  to  leave  messages  for  later review,
  493.           sometimes called 'Electronic Mail'.
  494.  
  495.      GT POWER  provides these three broad categories of functions and a great
  496.      deal more.  A few examples include:
  497.  
  498.           The ability to use any DOS Commands without exiting the program.
  499.  
  500.           Capturing to disk all the  text  that  is  exchanged  while  in the
  501.           'telex-like' terminal mode.
  502.  
  503.           Automatically dialing the telephone for you.
  504.  
  505.           Maintaining a complete log of all telephone activity.
  506.  
  507.           Providing  a  secure  environment  that  protects  your system from
  508.           unwanted invasion by outside callers.
  509.  
  510.      Before you can use GT POWER  you will  need to  install the  software on
  511.      your system.   The  installation process  is relatively easy to perform,
  512.      but it does require  that you  know a  few things  about your  system in
  513.      advance.   For example,  you will  need to know which port your modem is
  514.      connected to (usually #1 if you have a parallel printer or #2 if you are
  515.      using a serial printer).
  516.  
  517.      You will  need to know a few technical things about your modem, as well.
  518.      If you are using a Hayes  or  Hayes  compatible  modem  (1200  baud) the
  519.      system is  already setup  for your  use.   If not, then you will need to
  520.      have a copy of  the technical  reference manual  that was  supplied with
  521.      your modem.
  522.  
  523.      After you  have started  GT POWER, a SHAREWARE notice will appear, and a
  524.  
  525.                                         8
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      delay will commence (1/50th of a second for  each usage  of the program,
  533.      with a  maximum delay  of 60 seconds).  After the delay has expired, the
  534.      program will invite you to 'Press any key to continue'.  Pressing  a key
  535.      results in the display of the 'Copyright' screen, which will explain the
  536.      details of the GT POWER shareware plan, and you will be invited to press
  537.      'Y' to  continue.   Pressing 'Y'  results in GT going directly into it's
  538.      Dialing  Directory  display  (the  method  of  entering  the  program is
  539.      extremely simplified for registered users, who will be able to enter the
  540.      program  automatically  without  any   keystroke,   after   viewing  the
  541.      'Copyright' notice  for a  couple of seconds).  In the Dialing Directory
  542.      you will see a list of names and telephone numbers that you have told GT
  543.      about during  previous usage  and a short menu is shown at the bottom of
  544.      the screen.  If you wish to call another computer at this  time you need
  545.      only move  the cursor  to the  appropriate line and press the Enter key.
  546.      GT will then  automatically  dial  the  requested  telephone  number and
  547.      monitor the  progress of  the call.   That is, it will show you that the
  548.      call is being placed and it will  tell  you  what  is  happening  on the
  549.      telephone line  thereafter.   For example, if the telephone on the other
  550.      end is busy it will show BUSY (if your modem has extended result codes).
  551.      When it gets through to the other computer, GT will show you that it has
  552.      CONNECTED with that system.
  553.  
  554.      There are many ways in which files can be transmitted between computers.
  555.      Text files  are often sent without any elaborate conventions that insure
  556.      the integrity of those transmissions, but program files  are always sent
  557.      utilizing  what  is  called  a  Protocol.   Transmissions that utilize a
  558.      protocol insure that the file received is exactly like the one sent.
  559.  
  560.      GT POWER provides twelve (12) different file transfer protocols for your
  561.      use.  Each one has its own advantages and disadvantages over the others.
  562.      More important than their differences is that many of the computers that
  563.      you will  be calling  can only support a few different protocols and the
  564.      variety provided by GT POWER insures that you can use  the ones provided
  565.      on the other computer.
  566.  
  567.      Subsequent  sections  of  this  document  will  show you the many varied
  568.      functions and features available  with GT  POWER in  great detail.   The
  569.      host mode  capabilities are so extensive,  however, that we have elected
  570.      to provide a separate document to describe them in detail.
  571.  
  572.      Note: GT POWER is a Shareware product that may be obtained directly from
  573.      the  author,  from  any  existing  user  of the product, or through file
  574.      transfer of the program from any of hundreds  of bulletin  board systems
  575.      near you.   In almost all cases you will receive the product as a set of
  576.      five files (GT1400-1, -2, -3, -4, and -5).  These files will  be in what
  577.      is known  as an  ARChive format.  In order to extract the actual program
  578.      and data files from the archive file you  have you  must use  an archive
  579.      extraction program  such as  PKXARC which  is readily  available on most
  580.      bulletin boards.
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.                                         9
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      Installation Notes
  599.      ------------------
  600.      Versions 4.20, 8.00, 9.00, 9.10, 9.20, 11.00 and 14.00 of  GT introduced
  601.      new  formats  for  the  phone  directory.    One  may  ask, "Why so many
  602.      changes?".  The answer  is simple,  we at  P&M Software  (P&M stands for
  603.      Paul and  Mari) believe  in providing  functions requested by our users,
  604.      whenever possible.    Because  of  all  the  improvements  in  the phone
  605.      directory, users of older versions of GT must run the program GT-UTIL to
  606.      convert their old directories to the new format.  I think you  will like
  607.      the newer  format, it  includes the  date and  time that you last called
  608.      each number in the directory, the total number of times  you called each
  609.      number, the  total duration  of your  calls to  each number, a record of
  610.      upload and  download  amounts  to  each  number,  default  file transfer
  611.      protocol, and logon script.  When run, GT-UTIL will rename your original
  612.      directory to _GT.DIR, so that you will retain a copy of it for emergency
  613.      use.
  614.  
  615.      The program  comes packaged as an .EXE.  The program disk may be removed
  616.      after the program has begun (if using the standard un-overlaid version).
  617.      There  are  two  methods  available  to  have  GT  locate  the  required
  618.      configuration and control files.
  619.  
  620.      The 1st, and possibly the simplest, is to start GT in the directory that
  621.      contains  all  of  these  files.    The  program will detect the default
  622.      directory and will refer back to it when needed, even after the user has
  623.      changed directories.
  624.  
  625.      The 2nd  method is  to use  an Environment variable, GTPATH, to point to
  626.      the directory containing GT's files.  This method  is more  difficult to
  627.      setup, but is much more flexible once the program is properly installed.
  628.  
  629.      NOTE: if GTPATH is set, GT will *not* look in the default  directory for
  630.      any of the needed files, instead will look in the directory indicated by
  631.      GTPATH.
  632.  
  633.      The phone directory may be placed on any  drive and  directory, the path
  634.      to the  phone directory is set into the configuration file via the Alt-I
  635.      command.   There  are  also  separate  PATH's  for  upload  and download
  636.      directories.   The phone directory path MUST be correctly set, otherwise
  637.      the program will not be able to use the phone directory, but  the upload
  638.      and download  PATH's are  optional.  A script path is also configurable,
  639.      so that a separate directory may be used  to store  scripts.   A capture
  640.      path can  be configured, so that GT will know where to save your capture
  641.      sessions (it is usually NOT a  good idea  to save  your captures  in the
  642.      current  directory  --  you  would  quickly lose track of them!).  Other
  643.      pathnames may also be configured in GT's setup, refer to  item #13 under
  644.      the "Miscellaneous Options" selection of the Alt-I screen.
  645.  
  646.      External Protocols
  647.      ------------------
  648.      In order  to perform the Kermit file transfer, the PCKERMIT.EXE file may
  649.      be stored in any directory pointed to by DOS's PATH  command.   The same
  650.      is true  if you  want to use the Zmodem or Ymodem-G protocols,  i.e. the
  651.      DSZ.EXE file must be in DOS's PATH.  It is  also important  to note that
  652.      Kermit, Zmodem  and Ymodem-G  use batch  files to run, these batch files
  653.      must be present with DSZ.  The batch files are:
  654.  
  655.                     KRRX.BAT ........ Kermit receive.
  656.  
  657.                                        10
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.                     KRTX.BAT ........ Kermit transmit.
  665.                     ZMRX.BAT ........ Zmodem receive.
  666.                     ZMTX.BAT ........ Zmodem transmit.
  667.                     YGRX.BAT ........ Ymodem-G receive.
  668.                     YGTX.BAT ........ Ymodem-G transmit.
  669.  
  670.  
  671.      IMPORTANT:
  672.      ==========
  673.      There are two methods available  to  have  GT  hang-up  the  phone line.
  674.      First, the  default method,  the "Hang-up  String" is sent to the modem.
  675.      The "Hang-up String" must contain an escape character  - usually "~+++~"
  676.      for  Hayes  type  modems,  so  make  sure  that  the  S2 register is set
  677.      properly.  GT can also control the modem via the DTR signal.  If the DTR
  678.      switch is  set to the "normal" position on the modem, GT can hang-up the
  679.      phone line by dropping the DTR signal.  NOTE: the  "normal" position for
  680.      the DTR  switch is  *not* the factory setting, which is usually to force
  681.      DTR at all times (which is completely useless with GT).   If  you choose
  682.      the DTR  method, you  MUST DELETE  ALL the  characters from the "Hang-up
  683.      String" in the configuration.
  684.  
  685.      It is very important that the modem result codes are properly installed.
  686.      If the  program cannot  connect properly then the codes are not correct.
  687.      There are several things which must agree to enable GT  to recognize the
  688.      modem's result  codes: 1st)  the desired Vn command must be added to the
  689.      modem init strings, 2nd)  the desired  Xn command  must be  added to the
  690.      modem init  strings, 3rd) the result codes corresponding to the selected
  691.      Vn command must be installed in the result code table.   The  Vn command
  692.      controls whether  the modem  returns verbose (V1) or numeric (V0) result
  693.      codes.  The Xn command controls the result code set reported to  GT from
  694.      the modem,  X0 tells  the modem  to use  the basic  result code set (not
  695.      extremely useful), X1 is better  and  is  the  first  of  the "extended"
  696.      result code  sets, however  you should  use one  of the result code sets
  697.      that include the BUSY result  code  --  which  greatly  speeds  the list
  698.      dialing routines.
  699.  
  700.  
  701.      Example of Environment Usage
  702.      ----------------------------
  703.      Assuming that all the GT files have been placed in a directory named \GT
  704.      on drive C.  Then in your AUTOEXEC.BAT file place the following:
  705.  
  706.                              PATH=C:\GT;C:\
  707.                              set GTPATH=C:\GT
  708.  
  709.      Of course, DOS's PATH variable may  have additional  directories listed,
  710.      using the  semi-colon to  separate the  names.  The GTPATH variable must
  711.      have only 1 parameter, the home directory for  all the  GT files, except
  712.      the Phone  Directory, which may be placed anywhere.  NOTE: it is wise to
  713.      include the root directory  in  DOS's  PATH  variable,  as  this enables
  714.      COMMAND.COM to  be executed as any other program -- this is necessary to
  715.      run the DOS Shell mechanism.
  716.  
  717.  
  718.      Notes on DOS 3.2
  719.      ----------------
  720.      It is necessary to place certain entries into  the CONFIG.SYS  file when
  721.      using DOS  3.2 for the proper operation of GT POWER.  The entries are as
  722.  
  723.                                        11
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.      follows:
  731.  
  732.                               STACKS=20,256
  733.                               BUFFERS=30
  734.                               FILES=50
  735.  
  736.      The BUFFERS value can be less if you  are using  a hard  disk with small
  737.      directories,  i.e.  less  than  100  files  per  directory.    The FILES
  738.      parameter can also be less, but DOS doesn't  use the  extra FILES unless
  739.      needed, so it is not critical.
  740.  
  741.      The STACKS value is very important, especially for users that make great
  742.      usage of  scripts.   Random failure  of the  system is  possible, if the
  743.      STACKS command does not have large enough values in it.
  744.  
  745.  
  746.      Notes on DOS 3.3
  747.      ----------------
  748.      It seems  that DOS 3.3 is much better than DOS 3.2.  The BUFFERS setting
  749.      can be allowed to  expand beyond  the DOS  3.2 limit,  but there  is one
  750.      tricky item.   To  avoid the  pitfalls of  the STACKS, one must set them
  751.      equal to 0,0 ---- for example:
  752.  
  753.                               STACKS=0,0
  754.                               BUFFERS=50
  755.                               FILES=50
  756.  
  757.      These statement  should  appear  in  the  CONFIG.SYS  file  in  the Root
  758.      Directory of your boot disk.
  759.  
  760.  
  761.      General notes on DOS
  762.      --------------------
  763.      It  is  very  easy  to  use  all  available  file  handles  within a DOS
  764.      environment.  Especially if you are  using external  processes like DSZ,
  765.      PCKERMIT, the DOS Shell, or multi-tasking software.  So, it is extremely
  766.      important that  adequate FILES  are reserved  in the  CONFIG.SYS file on
  767.      your  DOS  boot  disk.    It  is  recommended  that  no fewer than 50 be
  768.      reserved, as shown above in the notes on DOS 3.2 and 3.3.
  769.  
  770.      When using DOS 3.1, it has been found that a large number  of BUFFERS is
  771.      also beneficial.   On  the GT  support BBS, BUFFERS=95 is routinely used
  772.      with DOS 3.1.  IMPORTANT: the  large number  of buffers  useful with DOS
  773.      3.1 can  cause severe  problems with  DOS 3.2.  For example, never use a
  774.      value for BUFFERS greater than 30 with DOS  3.2.   The variation between
  775.      such closely related operating systems is surprising to this observer.
  776.  
  777.  
  778.      Modem Result Codes
  779.      ------------------
  780.      The proper  setting of the modem result codes is VITAL, if the automatic
  781.      dialing routines are to work properly.   Again,  one must  use the Alt-I
  782.      command, then  select the  modem result  codes option.  The program will
  783.      present a list of possible results and the corresponding codes  that the
  784.      modem uses  to signal  each result.   You  may change  any or all of the
  785.      result codes, each code may  be  any  string  of  characters,  up  to 20
  786.      positions long. The default codes are set to the verbose codes supported
  787.      by the USRobotics Courier HST 9600  baud modem,  if your  modem does not
  788.  
  789.                                        12
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.      signal all  of the possible results, DO NOT DELETE the code.  Especially
  797.      if you use PC Pursuit, the  modems used  by Telenet  send the  BUSY code
  798.      instead of  the NO  CARRIER code, so you should leave these codes in the
  799.      table, even if your modem doesn't support them.
  800.  
  801.      Don't neglect the Modem Init String!    This  string  can  have  a great
  802.      impact on  your modems  result codes.   Especially important, one should
  803.      include the highest possible Xn  command  in  Modem  Init  String.   For
  804.      example, I  use X5  with my USRobotics Courier.  For the Hayes 1200 baud
  805.      modems, I suggest a value of X1 and for the 2400 baud Hayes I  would use
  806.      X4.   Naturally, the  Vn command  is equally important.  For example, if
  807.      you use V1 in the init string, then you MUST  have verbose  codes in the
  808.      modem result code table.
  809.  
  810.  
  811.      Multiple Result Codes
  812.      ---------------------
  813.      GT POWER  supports multiple  result codes to mean the same result.  This
  814.      is extremely handy if you have  a  modem  that  sends  several different
  815.      codes to  indicate one  of the  results in  the table, or if you have an
  816.      application which requires use of different  modems with  the same setup
  817.      (for example,  PC Pursuit  uses Racal-Vadic  modems, but most users have
  818.      Hayes compatible modems).  To indicate multiple result codes, you simply
  819.      enter the  various codes  with a  comma between each code.  Do not enter
  820.      any extra blanks or  other non-essential  characters in  the result code
  821.      table.  For example:
  822.  
  823.                            0,OK,GOOD,READY
  824.                            1,CONNECT,CONNECT 300
  825.  
  826.      Notice  the  first  line  above  defines  4  separate  codes  which will
  827.      correspond to the "OK" response.  The second  line defines  3 codes that
  828.      will correspond to the "CONNECT" response.
  829.  
  830.      Please note,  when using  this feature  to access non-Hayes type modems,
  831.      one must remember to switch the Dialing Pre-string to the required value
  832.      for each  modem --  this can  easily be  done with  one of GT's keyboard
  833.      macros.
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.                                        13
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.      First Time Usage
  863.      ----------------
  864.      Most of the features  of the  program are  self-documenting, however for
  865.      the sake of the novice user, some explanation is necessary.
  866.  
  867.      Before one  goes very far with GT, the "Millisec Loop Count", item #7 on
  868.      the configuration screen (press Alt-I to bring it up) must be configured
  869.      properly for  each system.   To  determine the proper setting, a special
  870.      program is provided called TIMER.EXE.    When  executed,  TIMER.EXE will
  871.      provide the  proper value for the "Millisec Loop Count" for your system.
  872.      A normal IBM PC/XT will use a value of about  50, which  is the default.
  873.      A 10mhz  AT will use a value of about 280.  A 16mhz 386 machine will use
  874.      a much higher value, probably over 500.  In any  case, run  TIMER.EXE on
  875.      your computer  and it  will give  you the  right number to plug into the
  876.      "Millisec Loop  Count".   NOTE: the  program TIMER.EXE  will not produce
  877.      accurate results if you computer does not have an accurate DOS clock.
  878.  
  879.      The GT program is distributed in .EXE, which can be executed immediately
  880.      by placing your disk into drive A, changing the default drive to  A:, if
  881.      not already,  then typing  the name  of the  program, GT1400.  Normally,
  882.      however, the program will  be run  from a  Hard disk  after it  has been
  883.      copied into  its own directory and the DOS PATH has been established, as
  884.      well as definition of the GTPATH=  variable in  the DOS  environment per
  885.      the previous section of this manual.
  886.  
  887.      If you are running from a hard disk system setup as previously described
  888.      then it would be convenient for  you to  create a  batch file  that will
  889.      invoke GT  POWER for  you.   For example,  you might create a batch file
  890.      called GT.BAT which contains only a single line as follows: GT1400
  891.  
  892.      Placing that batch file  anywhere  in  the  PATH  that  DOS  has  at its
  893.      disposal will  allow you  to start GT POWER from any directory by merely
  894.      typing GT.
  895.  
  896.      Once the user has successfully entered the program, the copyright notice
  897.      will appear.   Press  the 'Y' (if you are a registered user, the program
  898.      will auto-start), the phone  directory screen  will   then appear.   The
  899.      phone  directory  is  used  to  store  the  phone numbers of the various
  900.      systems you call.   You  must  enter  these  numbers  before    GT   can
  901.      automate  your  dialing  chores.    Use  the  A)dd  command in the phone
  902.      directory to add numbers, by pressing the <A> key.  The <Esc> key may be
  903.      used to  exit from  the phone   directory to the on-line screen.  At the
  904.      bottom of the on-line screen  appears various status indicators  and the
  905.      reminder  that  Alt-H  is  the  help  key.  A complete list of available
  906.      commands can be obtained by selecting Alt-H.   Commands may  be selected
  907.      while the Help window is still on screen, so that the user does not need
  908.      to open the Help window  repetitively,  however  some  commands  are not
  909.      readily  executable  while  any  "window"  is open - the time management
  910.      commands, Alt-U and Alt-F, are an example.   If they  are executed while
  911.      the Help  window is open, they will cause the screen to scroll!  This is
  912.      not harmful in any way, but renders the Help window less useful.
  913.  
  914.      The 25th line on  your  monitor  provides  important  status information
  915.      about your  system while running GT POWER.  Please refer to the Appendix
  916.      at the end of this document for a  complete listing  of the  contents of
  917.      the 25th line.
  918.  
  919.      Upon initial  execution the  program creates  several files  in its home
  920.  
  921.                                        14
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.      directory.  They are:
  929.  
  930.                            Modify
  931.               Filename     Command       Description
  932.               --------     -------       -----------
  933.                GT.KEY ..... Alt-M ...... Stores the macro key definitions.
  934.                GT.DIR ..... Alt-D ...... Stores the phone directory.
  935.                GT.CNF ..... Alt-I ...... Stores the program configuration.
  936.  
  937.      The keystrokes shown above under "Modify Command" are  the ones required
  938.      to bring  up screens  which will  allow you to customize the program for
  939.      your specific use.
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.                                        15
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.      Command Line Usage
  995.      ------------------
  996.      When you start GT, there are  several  command  line  switches  that are
  997.      available to you:
  998.  
  999.  
  1000.      name      You may indicate a script file to be executed upon start-up of
  1001.                GT.
  1002.  
  1003.      /D        You may indicate whether or not you wish  to have  GT drop the
  1004.                DTR signal to the modem when GT exits back to DOS.
  1005.  
  1006.      /C        You may  indicate whether  you are  connected via cable to the
  1007.                host computer.
  1008.  
  1009.      /K        You may initiate the capture mode from the  very start  of the
  1010.                program.
  1011.  
  1012.      /P        You may enable logging to the system printer.
  1013.  
  1014.      /1        You may  configure the  port addresses  in use  by your serial
  1015.                port.  The actual port number to be configured, 1-4, is placed
  1016.                after the  slash.   The new base address of the indicated port
  1017.                is placed after the  slash number  with an  intervening blank.
  1018.                The address  must be given with a leading $ sign and be in hex
  1019.                notation, for example $3F1 would be a valid address.  Refer to
  1020.                your hardware  documentation for  the correct address to use.
  1021.                GT uses standard addresses  if you  do not  override with this
  1022.                option.
  1023.  
  1024.      /Rn       This option  applies to  the GT  host mode.   It specifies the
  1025.                ring number  upon which  GT will  answer incoming  calls.  For
  1026.                example /R3  would cause  GT to answer on the 3rd ring.  NOTE:
  1027.                that the host mode modem  init  string  must  contain  S0=0 to
  1028.                allow this to work properly.
  1029.  
  1030.      /RBmm:nn  This option applies to the GT host mode.  It specifies that GT
  1031.                should answer the modem after a "ring back".  To  enable this
  1032.                option to work properly, the host mode modem init string must
  1033.                contain S0=0.   Once  installed properly this option makes the
  1034.                GT host mode answer the phone on the 2nd or  3rd ring  after a
  1035.                gap  of  between  'mm'  and  'nn' seconds.  If the gap between
  1036.                rings is less than 'mm' seconds or greater  than 'nn' seconds,
  1037.                GT  will  not  answer  the  phone.   This allows the use of an
  1038.                answering machine on the same phone line as the computer.  The
  1039.                answering machine  should be  programmed to  answer on a later
  1040.                ring, the 4th for example.
  1041.  
  1042.                /rb09:30  This would cause the gap to be 9 - 32 seconds.
  1043.                          The normal ring interval is 5 - 6 seconds.  The
  1044.                          high end of this  range should  *not* be  set higher
  1045.                          than 45 seconds.
  1046.  
  1047.  
  1048.      The options listed above may be placed on the command line in any order,
  1049.      here are some examples:
  1050.  
  1051.  
  1052.  
  1053.                                        16
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.           gt1400                        This command would  start  GT without
  1061.                                         any    script,  GT  would drop DTR on
  1062.                                         exit.
  1063.  
  1064.           gt1400   /D                   Again no  script,  but  this  time GT
  1065.                                         would maintain  the DTR signal to the
  1066.                                         modem after exit to DOS.
  1067.  
  1068.           gt1400   script.scr /d        Now GT would  start  the  script file
  1069.                                         named    automatically    and   would
  1070.                                         maintain the DTR  signal  on  exit to
  1071.                                         DOS.
  1072.  
  1073.           gt1400   script.scr           GT will  now drop DTR on exit to DOS,
  1074.                                         automatically   execute   the   named
  1075.                                         script upon startup.
  1076.  
  1077.  
  1078.           gt1400   /C                   GT will know that it is connected via
  1079.                                         cable  to   the  host  and  will  not
  1080.                                         automatically    enter    the   Phone
  1081.                                         Directory.
  1082.  
  1083.           gt1400  /c /D                 Shows the  combination of  the /C and
  1084.                                         the /D  switches.   Indicates that GT
  1085.                                         is  connected  via  cable to the host
  1086.                                         and that  GT should  maintain the DTR
  1087.                                         signal after exiting to DOS.
  1088.  
  1089.           gt1400  /k /2 $3E8            This  line  would  start  the capture
  1090.                                         mode and  reconfigure COM  port #2 to
  1091.                                         the  base   address  3E8  hex.    The
  1092.                                         address must be given  in hex  with a
  1093.                                         leading $ sign character.
  1094.  
  1095.           gt1400  /p                    This would  start GT  and turn on the
  1096.                                         system  printer  to  record  the log.
  1097.                                         The log  will also  be written to the
  1098.                                         disk file GT.LOG.  This is  handy for
  1099.                                         host  mode  operators, who would like
  1100.                                         to be able to  read  the  log without
  1101.                                         taking their system out-of-service.
  1102.  
  1103.           gt1400 /rb host.scr           This would start GT, enable ring-back
  1104.                                         mode  and   execute   the  'host.scr'
  1105.                                         script file.  (Probably to start a GT
  1106.                                         Host session.)
  1107.  
  1108.      The /D option allows the user to maintain  the DTR  signal to  the modem
  1109.      after  exiting  from  GT  POWER  and  one  might ask, "Why should DTR be
  1110.      maintained after exit to DOS?".  If DTR is maintained,  you may  exit to
  1111.      DOS without  having to  hang-up the  modem,  therefore it is possible to
  1112.      run another comm program,  while  still  connected  to  the  host.   For
  1113.      example, if you wanted to run the PCKERMIT.EXE program manually, instead
  1114.      of through GT, the DTR should not be dropped when exiting from  GT.  You
  1115.      may  wish  to  do  this  if  you  don't have enough memory to run GT and
  1116.      PCKERMIT.EXE at the same time.
  1117.  
  1118.  
  1119.                                        17
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.      RAM Disk Usage
  1127.      --------------
  1128.      Distributed with the program is a  file called  RAMDISK.BAT.   It can be
  1129.      used  to  install  and  run  the  program  from  a  RAM  disk.    To use
  1130.      RAMDISK.BAT, place the program disk in one of the floppy drives and make
  1131.      it the default, then enter the following command:
  1132.  
  1133.           RAMDISK  d: e: [scr]     Where: "d:"  is the drive with the program
  1134.                                    disk, "e:" is the  RAM drive,  and "[scr]"
  1135.                                    is an  optional script file to be executed
  1136.                                    on  start-up.     The   brackets  []  just
  1137.                                    indicate that the script file is optional.
  1138.  
  1139.           Example:  "RAMDISK  A: C:"
  1140.  
  1141.                                    Additional  command  line  argument can be
  1142.                                    placed after the  drive  letters  and they
  1143.                                    will be  passed as command line options to
  1144.                                    GT POWER within the batch run.
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.                                        18
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.      Coping With A Floppy Based System
  1193.      ---------------------------------
  1194.      It is obvious to the most  casual observer  that GT  uses a  LOT OF DISK
  1195.      SPACE.  So how does one cope with a floppy based system?  The first rule
  1196.      is to place the  files that  cannot be  directed via  a path designation
  1197.      onto drive  A:.   Here is my recommendation for the files that should be
  1198.      on drive A:
  1199.  
  1200.  
  1201.                          BULLET1  BBS      336
  1202.                          BULLET2  BBS     3989
  1203.                          DSZ      EXE    45728
  1204.                          GT       CNF      879
  1205.                          GT       DIR    11610
  1206.                          GT       KEY      142
  1207.                          GT       LOG     6735
  1208.                          GT1400   EXE   215587
  1209.                          GTBULLET BBS     3816
  1210.                          GTBYE    BBS     3086
  1211.                          GTDIR    BBS      449
  1212.                          GTHELP   BBS     1539
  1213.                          GTMDIR   BBS      306
  1214.                          GTMENU   BBS     1084
  1215.                          GTNEWUSR BBS     1948
  1216.                          GTPASSWD BBS      134
  1217.                          GTSYSID  BBS      138
  1218.                          GTUSER   BBS       44
  1219.                          GTWELCOM BBS      934
  1220.                          PROTOCOL BBS      206
  1221.                          SYSOP    BBS       22
  1222.                          YGRX     BAT       29
  1223.                          YGTX     BAT       47
  1224.                          ZMRX     BAT       40
  1225.                          ZMTX     BAT       61
  1226.  
  1227.  
  1228.      Now some of these files are optional, for example the  BULLET?.BBS files
  1229.      are  not  normally  required,  and  the  rest  of the *.BBS files can be
  1230.      eliminated if the operator does not use host mode.
  1231.  
  1232.      We have included the DSZ program,  for  its  Zmodem  protocol,  and left
  1233.      PCKERMIT off.   But  you might want both or PCKERMIT instead of DSZ.  In
  1234.      any case, you must have the one you  need.   However, it  is possible to
  1235.      place one  or both of these programs on drive B: if you set you DOS PATH
  1236.      to point at drive B:.
  1237.  
  1238.      Even then, you must be careful that the log file does not grow to exceed
  1239.      the capacity  of the  disk.  The .DIR and .KEY files can also grow, so a
  1240.      careful eye should be kept on the space available on drive A:.
  1241.  
  1242.      It is not advisable for downloads or uploads to be  done with  drive A:,
  1243.      the  configuration  paths  for  downloads  and  uploads should be set to
  1244.      "B:\".  This will keep the rest of drive A: free from these extra files.
  1245.      Once mounted  in drive  A:, this disk should remain until the program is
  1246.      exited.
  1247.  
  1248.      The message base file should be located on drive "B:\".   Use  the setup
  1249.      option to  declare the  path for the message base to be drive "B:\".  It
  1250.  
  1251.                                        19
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.      is under the miscellaneous options selection of the Alt-I screen.
  1259.  
  1260.      Of course, you can save even more disk space by using the GTO version of
  1261.      the program.   The  GTO version  does not include a host mode module and
  1262.      thus saves more than 60k of disk space.
  1263.  
  1264.      If you have only 1 floppy disk, I wish you luck.   You won't  have a lot
  1265.      of space  to play with.  The best advice would be to purchase a 2nd disk
  1266.      at the earliest opportunity.   The  best choice  would be  a 20 megabyte
  1267.      hard disk or bigger if the budget allows.
  1268.  
  1269.      A reasonable  alternative to either a second floppy or a hard disk would
  1270.      be one of the new 1.44 megabyte 3.5" diskette drives.
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.                                        20
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.      Computer To Computer Without Modems
  1325.      -----------------------------------
  1326.      If the program is used without a modem, using a direct cable connection,
  1327.      all  the  dialing  and  modem  control strings in the configuration file
  1328.      should be set to  empty  strings.    Also,  when  using  a  direct cable
  1329.      connection, the  "Carrier is  Forced?" parameter  should be set to TRUE.
  1330.      Also, the command line switch, /C, should be used to indicate the direct
  1331.      connection to GT.
  1332.  
  1333.      When running  a direct connection via cables, with one of the GT systems
  1334.      operating in the host mode, the operator on the terminal mode system can
  1335.      wake up the host system by striking carriage return.  NOTE: in this case
  1336.      both systems must be set to the same baud rate ahead of time.   The host
  1337.      system will  use the default baud rate from the configuration file.  The
  1338.      terminal mode GT must use the same rate,  if not  the default,  then set
  1339.      the required baud rate with the Alt-S command.
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.                                        21
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.      Alt-Command Descriptions
  1391.      ------------------------
  1392.      Alt-A     ASCII  transmission  of  a  file  using the XON/XOFF protocol,
  1393.                where the DC1 character is used for XON and the  DC3 character
  1394.                is  used  for  XOFF.    If  the  Pacing Character is set, then
  1395.                line-by-line pacing is also done, i.e.  the program  will wait
  1396.                for the  pacing character  to echo from the host at the end of
  1397.                each line, thereby insuring that  an  overrun  error  will not
  1398.                occur.   The default  is not to use line-by-line pacing.  Also
  1399.                associated with the ASCII  file  transmit  is  the End-of-Line
  1400.                Mode, it  determines what  characters are  sent to the host at
  1401.                the end of each  line.   The normal  End-of-Line Mode  for IBM
  1402.                compatible  hosts  is  CRLF,  i.e.  a  carriage  return  and a
  1403.                linefeed, however some hosts,  for example  UNIX, require just
  1404.                LF, and  others may  require only  a CR.   These are the three
  1405.                options for End-of-line Mode.  Also,  the user  may specify an
  1406.                inter-character delay,  in milliseconds,  the default delay is
  1407.                set to 0.  The Pacing Character, the End-of-Line Mode  and the
  1408.                inter-character delay,  are options in the configuration file.
  1409.                Use the Alt-I command to alter  the configuration.   The ASCII
  1410.                inter-character   delay   adds   the   indicated   number   of
  1411.                milliseconds delay between each  character transmitted.   When
  1412.                uploading messages  to IBM style BBS systems, blank lines will
  1413.                cause a problem, since they  will  cause  the  host  system to
  1414.                terminate message input mode.  This can be overcome by setting
  1415.                the Pad Blank Line parameter to TRUE.  All of these parameters
  1416.                are located  under the  ASCII Transmit parameters of the Alt-I
  1417.                screen.
  1418.  
  1419.           +---------------------------------------------------------------+
  1420.           |                            NOTE                               |
  1421.           |                                                               |
  1422.           |        For uploading messages to most IBM style BBS's,        |
  1423.           |        you should use an End-of-Line mode of CR.              |
  1424.           |                                                               |
  1425.           +---------------------------------------------------------------+
  1426.  
  1427.      Alt-B     Send BREAK signal to host computer.  The serial port is forced
  1428.                into the spacing state.  This is useful when connected to some
  1429.                minicomputers that require the signal to wake-up and allow you
  1430.                to logon.   It  is not used with most BBS systems.  The length
  1431.                of the BREAK signal, in milliseconds, is configurable  via the
  1432.                Miscellaneous Options of selection of the Alt-I screen.
  1433.  
  1434.      Alt-C     Turn capture  mode ON, if it is OFF, or OFF if it is ON.  When
  1435.                this mode is turned OFF, either  through the  Alt-C command or
  1436.                with the  Alt-X command,  the user will be prompted for a file
  1437.                name wherein to  save  the  contents  of  the  capture buffer.
  1438.                During capture  mode operations,  a number  will appear in the
  1439.                lower left  corner  of  the  screen,  this  is  the  number of
  1440.                characters, in 1000's, in the capture buffer.  Capture mode is
  1441.                useful for  recording complete  sessions for  review later, so
  1442.                you don't read so much on those long distance phone calls.
  1443.  
  1444.                When the  in-memory capture  buffer is  full, the program will
  1445.                dump to a spill file on  disk,  the  file  name  used  will be
  1446.                $$SPILL.  The operation of the spill file is automatic, but if
  1447.                the program is  interrupted  for  some  reason,  the  file may
  1448.  
  1449.                                        22
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.                remain catalogued. Therefore, the user should remove this file
  1457.                when required.  It will be placed in the directory with the
  1458.                overlay files.  The  size of  the in-memory  capture buffer is
  1459.                configurable, in 1,000's of characters, via the Alt-I screen.
  1460.  
  1461.                If  you  press  Alt-C,  accidentally  while capture mode is in
  1462.                progress, you may continue capturing data by pressing the Esc
  1463.                key.
  1464.  
  1465.                Capture Header
  1466.                --------------
  1467.                Text that is saved after a capture session will have  a header
  1468.                appended to  it.   This header  will name the last host system
  1469.                called (if any) and the date  and time  the capture  was done.
  1470.                This will  help you later, especially if you 'append' multiple
  1471.                captures  to  one  large  file.    The  headers  will  act  as
  1472.                separators between various sessions.
  1473.  
  1474.      Alt-D     Modem  dialing  and  phone  directory  management.   The phone
  1475.                directory may have up to 999 entries, if there is  enough disk
  1476.                space.    The  directory  screen  will automatically disappear
  1477.                whenever a CONNECT type result  is  detected  from  the modem.
  1478.                Multiple phone  directories are  supported, to get more than 1
  1479.                phone  directory  use  the  E)xch  command    while  the phone
  1480.                directory is  being displayed,  this will  allow you to switch
  1481.                between directories.  Among other things,  the phone directory
  1482.                support 2 very important items: A) personalized passwords, and
  1483.                B)  default  transfer  protocol.     Using   the  personalized
  1484.                passwords, one  can store  a different  password for each host
  1485.                system listed and then access it automatically via a macro key
  1486.                when  logging  into  each  system.    A  macro  key  should be
  1487.                programmed with %P to  enable it  to send  the proper password
  1488.                for  each  system.    (Please  refer to the description of the
  1489.                Alt-M below for a discussion of  macro  key  setup.)    If you
  1490.                select a default transfer protocol for each entry in the phone
  1491.                directory, then you will be able  to eliminate  several of the
  1492.                keystrokes  required  to  start  a  file  transfer, as GT will
  1493.                anticipate the selection of the protocol type.
  1494.  
  1495.      Alt-E     Turn Half Duplex ON if it is OFF, or OFF  if it  is on.   Half
  1496.                duplex is used when the host does not echo what you type.
  1497.                A Half  Duplex indicator  will show  on the bottom line of the
  1498.                screen, HDX, when in this mode.  Also, the duplex  mode can be
  1499.                set  automatically  by  entering  that  information  into  the
  1500.                Dialing Directory.
  1501.  
  1502.      Alt-F     Fix time.  That  is, mark  the current  time, so  that you can
  1503.                measure time used, with the Alt-U command.
  1504.  
  1505.      Alt-G     Re-dial  the  last  number  dialed.    This  command will loop
  1506.                continuously until a CONNECT is signaled  by the  modem or the
  1507.                user presses <Esc> to quit.  The user may press N)ext to force
  1508.                the program to perform a quick re-dial.
  1509.  
  1510.      Alt-H     Produces the HELP screen for the user.
  1511.  
  1512.      Alt-I     Reconfigure the program defaults.  The parameters listed below
  1513.                for the .CNF file can be changed via this command.
  1514.  
  1515.                                        23
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.      Alt-J     Display version  and serial number of GT in use and the amount
  1524.                of free memory left for GT to use.
  1525.  
  1526.      Alt-K     Kill a file.  Delete a file from the disk.
  1527.  
  1528.      Alt-L     Display disk directory,  under  a  user  supplied  mask.   For
  1529.                example, to  see all  files with a PAS extension on the logged
  1530.                drive and current directory, the  user  would  enter  the mask
  1531.                "*.PAS",  when  prompted.    Or  see  just  the  files with an
  1532.                extension of .C by entering the mask "*.c", when prompted.  By
  1533.                default,  the  program  will  show  all  files,  if no mask is
  1534.                entered by the user.
  1535.  
  1536.      Alt-M     Macro key management.  Allows the user to  define the contents
  1537.                of the  function keys  F1 through F10, and all combinations of
  1538.                the function keys and Shift, Ctrl or Alt.  This gives the user
  1539.                40  different  macro  keys.    The  password,  from  the phone
  1540.                directory, may  be  stored  in  a  macro  key  by  putting the
  1541.                characters %P  into one of the keys, then whenever that key is
  1542.                struck the password for  the currently  connected BBS  will be
  1543.                transmitted.  For example, I put my name into F1, the letter Y
  1544.                into F2 and my password into F3.  Like this:
  1545.  
  1546.                                 F1 = Paul|~Meiners|
  1547.                                 F2 = Y|
  1548.                                 F3 = %P|
  1549.  
  1550.      Note:     These 3 items could  just as  easily have  been placed  into 1
  1551.                macro key, like this:
  1552.  
  1553.                                 F1 = Paul|~Meiners|~Y|~%P|
  1554.  
  1555.                The |  character is  entered into a macro key when you want GT
  1556.                to send a carriage return, a ~  is  used  when  you  want  a 1
  1557.                second  delay,  and  a  ;  is  used when you wish to include a
  1558.                comment in the macro key.  The ; character is configurable, in
  1559.                case you  need to  include it in the macro key.  Use the Alt-I
  1560.                command to setup GT for your requirements.
  1561.  
  1562.                Each  entry  in  the  phone  directory  can  have  a different
  1563.                password  associated  with  it,  so  you  can  customize  your
  1564.                passwords for each BBS you call.    Makes  things  a  lot more
  1565.                secure and easier to manage.
  1566.  
  1567.                Control  characters  can  also  be  placed  into  a macro key.
  1568.                Normally, you can use the Alt key and  the numeric  keypad, if
  1569.                you know  the ASCII  code for the character, however there are
  1570.                some control codes that cannot be placed directly into a macro
  1571.                key, such  as Ctrl-Z.   To  put a Ctrl-Z, or any other control
  1572.                character into a macro,  you enter  a %  character followed by
  1573.                the decimal  value of  its ASCII code.  For example the Ctrl-Z
  1574.                would be %26.  The value following the % may not exceed  255 -
  1575.                the maximum value of any one character.
  1576.  
  1577.                The  transmission  rate  of  characters from the macro keys is
  1578.                configurable.  The "ASCII  inter-character delay"  under Alt-I
  1579.                is used to pace the transmission of these keystrokes.
  1580.  
  1581.                                        24
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.                Keyboard Macros
  1590.                ---------------
  1591.                Beginning with  GT POWER  14.00, the macro keys can be used as
  1592.                full  fledged  'keyboard  macros'.    This  means  that beyond
  1593.                storing logons  and other  simple phases, they can now be used
  1594.                to ease the operation of the program itself!  Any command that
  1595.                you can  give GT  from the  keyboard can  be stored  in one of
  1596.                these keys.  Plus  there are  some commands  that can  only be
  1597.                executed  via   a  macro   key.    Here  are  some  rules  for
  1598.                constructing keyboard macros:
  1599.  
  1600.                The { and }  characters  are  used  to  denote  a  special key
  1601.                sequence to  the macro  processor.   For example: {HOME} would
  1602.                denote a strike of the 'Home' key.  Also, 'Alt' keystrokes can
  1603.                be issued in the same fashion, for example {@-} would indicate
  1604.                the 'Alt -' keystroke.  The  sequence {?}  is used  to solicit
  1605.                input from the user.  For example, {@L}*.doc|  would cause the
  1606.                Alt-L command to list all DOC files in the current directory.
  1607.  
  1608.                There are some commands that can only be accessed via  a macro
  1609.                key (we ran out of other command keys!).  Here is the list:
  1610.  
  1611.                {@=}      Execute a DOS command.  Nifty way to execute any DOS
  1612.                          program or command (such as a text editor)  with one
  1613.                          keystroke.  For example:
  1614.  
  1615.                                    {@=}qed|
  1616.  
  1617.                          This would  execute the  'qed' program and return to
  1618.                          GT when finished.
  1619.  
  1620.                                    {@=}{?}|
  1621.  
  1622.                          This would execute any  program that  the user named
  1623.                          when prompted for input.
  1624.  
  1625.                {@>}      Start  the  recording  of  all  keystrokes for later
  1626.                          playback.  For example:
  1627.  
  1628.                                    {@>}foo.mac|
  1629.  
  1630.                          When executed, this macro would cause  all following
  1631.                          keystrokes to be recorded in the 'foo.mac' file.
  1632.  
  1633.                {@.}      Stop  the  recording  of keystrokes.  Once recording
  1634.                          has  been  started,  this  command  will   stop  the
  1635.                          recording  and  close  the  macro  file  named  when
  1636.                          recording started.
  1637.  
  1638.                {@<}      Start  the  playback  of   the  keystrokes  previous
  1639.                          recorded in a macro file.  For example:
  1640.  
  1641.                                    {@<}{?}|
  1642.  
  1643.                          This  would  execute  any  macro  file that the user
  1644.                          named when prompted for input.
  1645.  
  1646.  
  1647.                                        25
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.                {@;}      This command toggles the update of  the status line.
  1655.                          The command is useful for people who are using "text
  1656.                          to  voice"  equipment,  if   the   status   line  is
  1657.                          continually updated  the voice output can be quite a
  1658.                          nuisance.
  1659.  
  1660.                Extended keys can also be represented via keyboard macros.  We
  1661.                have already  seen how  the Alt keys can be represented, Alt-A
  1662.                is {@A}  for example,  but other  extended keys  can be issued
  1663.                also.  Here is a list of the available symbols for use:
  1664.  
  1665.                          {UP}      Up Arrow key.
  1666.                          {DOWN}    Down Arrow key.
  1667.                          {LEFT}    Left Arrow key.
  1668.                          {RIGHT}   Right Arrow key.
  1669.                          {HOME}    Home key.
  1670.                          {END}     End key.
  1671.                          {^END}    Ctrl-End key combination.
  1672.                          {PGUP}    PgUp key.
  1673.                          {PGDN}    PgDn key.
  1674.                          {INS}     Ins key.
  1675.                          {DEL}     Del key.
  1676.                          {BS}      Backspace key.
  1677.                          {ESC}     Esc key.
  1678.                          {TAB}     Tab key.
  1679.                          {BTAB}    Backward Tab key. (Shift Tab).
  1680.                          {^PRT}    Ctrl-Prt key combination.
  1681.  
  1682.                The F  keys themselves  can be  indicated within a macro.  For
  1683.                example {F1} would be a press of the F1 key.  {^F1} would be a
  1684.                press of  the Ctrl-F1  key.  {@F1} would a press of the Alt-F1
  1685.                key.  And {$F1} would be a Shift-F1 key press.  Including an F
  1686.                key  press  in  a  macro  key  acts  as  a  GOTO for the macro
  1687.                execution, no nesting of macros is done.
  1688.  
  1689.                In addition to the old subtitutions  that  can  be  made  in a
  1690.                macro key,  such as  the %P for the password, the user may now
  1691.                use the following:
  1692.  
  1693.                          %C        COM port number.
  1694.                          %B        Baud rate.
  1695.                          %P        Current BBS password.
  1696.                          |         Carriage return.
  1697.                          ~         Delay for a second.
  1698.                          %nn       Represent  any  ASCII  keystroke   by  its
  1699.                                    decimal value.
  1700.  
  1701.      Alt-N     Allows the  user to  change to  a new  logged drive and/or new
  1702.                working directory.
  1703.  
  1704.      Alt-O     Sort the  dialing directory  into ascending  sequence by name,
  1705.                number, date,  times on,  elapsed time or baud rate.  Performs
  1706.                an IN MEMORY sort, so there must be enough memory  to hold all
  1707.                the phone directory entries.
  1708.  
  1709.      Alt-P     Print a  file.   Configuration options are available to enable
  1710.                pagination of the printed output and  the number  of lines per
  1711.                page.
  1712.  
  1713.                                        26
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.      Alt-Q     Hang-up the  phone line, put the modem "ON HOOK".  If there is
  1722.                a "Hang-up String" defined  in the  configuration file,  it is
  1723.                sent to  the modem,  otherwise the  DTR signal to the modem is
  1724.                dropped for a second and then the  modem initialization string
  1725.                is sent to the modem.
  1726.  
  1727.      Alt-R     Receive a file using either the default protocol listed in the
  1728.                phone directory or one chosen  from  a  menu.   Communications
  1729.                parameters are  automatically changed to/from 8 bit no parity,
  1730.                and the 8th bit stripping is disabled for the duration  of the
  1731.                transfer.    CRC  is  used automatically, if the remote system
  1732.                supports it.  When using a  batch protocol,  the names  of the
  1733.                files will  be supplied  by the  host.   If the carrier signal
  1734.                from the  host is  lost during  file transfer,  the alarm will
  1735.                sound and  the "Carrier   Loss"  window will  open.  The alarm
  1736.                will continue to sound until the user strikes a key.
  1737.  
  1738.      Note:     If VT-100 emulation mode is not being used, the <PgDn> key may
  1739.                be used instead of <Alt-R>.
  1740.  
  1741.      Note:     For  proper   operation  of  the  Kermit  file  transfer,  the
  1742.                PCKERMIT.EXE file must  be  available  in  one  of  the places
  1743.                pointed to  by DOS's  PATH command.   This  is true of DSZ.EXE
  1744.                also, when using the Zmodem or  Ymodem-G protocol.   Also, the
  1745.                batch files  ZMRX.BAT, YGRX.BAT and KRRX.BAT must be along the
  1746.                DOS PATH.  These  batch  files  are  actually  invoked  when a
  1747.                Zmodem,  Ymodem-G  or  Kermit  download is requested, a direct
  1748.                call to  DSZ.EXE or  PCKERMIT.EXE is  not performed.   This is
  1749.                very  helpful  for  a  number  of reasons, most importantly it
  1750.                allows you to customize the interface to either program.
  1751.  
  1752.      Alt-S     Switch communication parameters.  The program  starts with the
  1753.                default  values.    Permissible  values for the baud rate are:
  1754.                300, 1200, 2400, 4800, 9600, or  19200.   Note: the  PCjr does
  1755.                not operate at speeds above 4800 baud.
  1756.  
  1757.      Alt-T     Transmit a  file using  either the  default protocol listed in
  1758.                the phone directory or one chosen from a menu.  Communications
  1759.                parameters are  automatically changed to/from 8 bit no parity,
  1760.                and the 8th bit stripping is disabled for the duration  of the
  1761.                transfer. CRC is used, if the remote system requests it.  When
  1762.                using a batch protocol, it is possible to  transfer many files
  1763.                at one  time (limited  only by  available memory  to store the
  1764.                filenames).  If the user wishes  to perform  a batch transfer,
  1765.                he must  specify the  names of the files to transfer using the
  1766.                DOS wildcard notation; for example, to transfer all files with
  1767.                the .PAS  extension, when asked for the filename, respond with
  1768.                "*.PAS".  A drive  and path  may optionally  be specified with
  1769.                the filename.   The files found matching the criterion will be
  1770.                transmitted.  If the carrier  signal  from  the  host  is lost
  1771.                during file  transfer, the  alarm will  sound and the "Carrier
  1772.                Loss" window will open.   The  alarm  will  continue  to sound
  1773.                until the user strikes a key.
  1774.  
  1775.                The Pick List
  1776.                -------------
  1777.                When the  transmit command  is invoked, the user will have the
  1778.  
  1779.                                        27
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.                opportunity to select a 'pick  list'.    When  prompted  for a
  1787.                filename, the  user may  type a  file select mask, for example
  1788.                *.arc and press  the  <Tab>  key  instead  of  instead  of the
  1789.                carriage return.   This will produce a sorted 'pick list' from
  1790.                which the user can select the  files to  be transmitted.   The
  1791.                arrow and  other direction  keys can  be used  to navigate the
  1792.                list, the carriage return will mark entries, and the <Esc> key
  1793.                will start  the transmission.   Of course, all of this assumes
  1794.                that you are using one of the batch  protocols, like MegaLink.
  1795.                The  marked  entries  will  be  transmitted, if no entries are
  1796.                marked, then  GT will  not perform  a transmission.   Also, it
  1797.                should be  noted, that  the 'pick  list' can only be used with
  1798.                internal protocols, it does  not function  with either Zmodem,
  1799.                Ymodem-G or Kermit.
  1800.  
  1801.  
  1802.      Note:     If VT-100 emulation mode is not being used, the <PgUp> key may
  1803.                be used instead of <Alt-T>.
  1804.  
  1805.      Note:     For  proper  operation  of  the  Kermit   file  transfer,  the
  1806.                PCKERMIT.EXE  file  must  be  available  in  one of the places
  1807.                pointed to by DOS's  PATH command.   This  is true  of DSZ.EXE
  1808.                also, when  using the Zmodem or Ymodem-G protocol.  Also,  the
  1809.                batch files ZMTX.BAT, YGTX.BAT and KRTX.BAT must be  along the
  1810.                DOS  PATH.    These  batch  files  are actually invoked when a
  1811.                Zmodem, Ymodem-G or Kermit upload is requested, a  direct call
  1812.                to DSZ.EXE  or PCKERMIT.EXE  is not  performed.   This is very
  1813.                helpful for a number  of reasons,  most importantly  it allows
  1814.                you to customize the interface to either program.
  1815.  
  1816.      Alt-U     Used time.   Report the time used since the last ALT-F command
  1817.                and the last dial of the  phone or  the start  of the program,
  1818.                whichever occurred  last.  Total elapsed time in hours minutes
  1819.                and seconds, is reported.
  1820.  
  1821.      Alt-V     View the contents of a file, uses the same style  as MORE, the
  1822.                DOS utility.  Use the <Esc> key to stop the command.
  1823.  
  1824.      Alt-W     Clear the screen.
  1825.  
  1826.      Alt-X     Terminate  and  return  to  DOS.   If a script is active, this
  1827.                command will not be effective until all scripts  are finished.
  1828.                If the  script is  currently at  an ONLINE command, then Alt-X
  1829.                will  cause  termination  of  the  ONLINE  command  and return
  1830.                control to  the script.   To  exit the script you should press
  1831.                the <Esc> key after the ONLINE command has been terminated.
  1832.  
  1833.      Alt-Y     Copy a file.  This procedure  will copy  any unprotected file.
  1834.                Filenames must  be fully specified.  No wildcards are allowed,
  1835.                ONLY the current drive and directory need not be specified.
  1836.  
  1837.      Alt-Z     Toggle monitor mode on/off.   In  monitor mode,  all codes are
  1838.                shown so  that the  user may see exactly what is being sent by
  1839.                the host computer.  Control codes are shown with the  ^ symbol
  1840.                preceding,  i.e.  ^[ is the ESC code, ^X is the CAN code, etc.
  1841.                You must refer to an ASCII code chart for a complete list.
  1842.  
  1843.      Alt-1     DOS Shell port.  GT stays in the background, while you exit to
  1844.  
  1845.                                        28
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.                DOS.   When you  want to  return to  GT, just issue the "EXIT"
  1853.                command and you will return to GT.   Note: you  need a  lot of
  1854.                memory to do this, more than 400k is recommended.
  1855.  
  1856.      Alt-2     Dump  screen  to  the  file  "$$SCREEN".   If the file already
  1857.                exists, then the screen is appended to the file, otherwise the
  1858.                file is created and the screen written to it.
  1859.  
  1860.      Alt-3     Execute a script.  Scripts may also be executed by placing the
  1861.                name of the script file on  the DOS  command line  that starts
  1862.                GT.   For example:  "A>GT1400   filename", would  begin GT and
  1863.                cause the  script stored  in filename  to begin automatically.
  1864.                Refer to  the description of the script language at the end of
  1865.                this document.
  1866.  
  1867.                To execute a script  via  a  macro  key,  place  the following
  1868.                string of characters into a macro key.
  1869.  
  1870.                     {@3}foo.scr|
  1871.  
  1872.                Where  'foo.scr'  represents  the  name  of  any valid script.
  1873.                Using this technique, it  is possible  to have  easy access to
  1874.                many of your script files.
  1875.  
  1876.      Alt-4     Suspends capture  mode, if  it is active.  While suspended you
  1877.                may hit Alt-4 again to resume capturing or  Alt-C to terminate
  1878.                capture mode.   Useful  when you wish to append to the capture
  1879.                buffer from selected sources.
  1880.  
  1881.      Alt-5     This option is used to  force  GT  to  use  "checksum"  as the
  1882.                default Xmodem  protocol.   This avoids  the pitfalls of using
  1883.                CRC protocols with  non-standard  systems.    Very  useful for
  1884.                transferring files with older systems or non-IBM systems.
  1885.  
  1886.      Alt-6     Begins  execution  of  the  "circular  dialing"  queue.    All
  1887.                "marked"  entries  in  the  phone  directory  will  be  dialed
  1888.                in-turn,  until  a  connection  is  made or the user stops the
  1889.                execution  by  pressing  <Esc>.    Individual  entries  may be
  1890.                canceled by  pressing <C>,  while the entry is being processed
  1891.                on the screen.  The user may immediately  proceed to  the next
  1892.                entry in  the queue  by pressing the <N>.  The user can repeat
  1893.                the dialing of the current number, if found  busy, by pressing
  1894.                the <R>.  Use the <G> command on the Phone Directory screen to
  1895.                "mark"  entries   for  the   circular  dialing   queue.    See
  1896.                explanation of the Phone Directory commands below.
  1897.  
  1898.      Alt-7     This  key  acts  as  a  toggle to begin/end split screen mode.
  1899.                During split screen operation  whatever  the  user  types will
  1900.                appear at  the bottom of the screen and will be buffered until
  1901.                a carriage return is struck.
  1902.  
  1903.      Alt-8     Review the in-memory  portion  of  the  capture  buffer.   The
  1904.                <PgUp>,  <PgDn>,  <Home>  and  <End>  keys may be used to move
  1905.                around in the buffer.   <PgUp>  and  <PgDn>  move  through the
  1906.                buffer a page at a time, the <Home> and <End> keys move you to
  1907.                the start or end of the  buffer.   Use the  <Esc> key  to quit
  1908.                viewing  the  buffer.    The  L)ocate  command is activated by
  1909.                pressing the <L> key.  It may be  used to  locate text  in the
  1910.  
  1911.                                        29
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.                capture buffer below the current location.  If a find is made,
  1919.                the text will be moved to  the top  of the  screen.   The <Up-
  1920.                Arrow> and <Dn-Arrow> keys may be used to scroll one line at a
  1921.                time.
  1922.  
  1923.      Alt-9     Toggle the beeps on/off.  Go into quiet mode or back to normal
  1924.                mode.    Does  not  change  the playing of music or the window
  1925.                whistle (which are both controlled via configuration options),
  1926.                just  the  bell.    To  control  the  window whistle and music
  1927.                playing refer to the  miscellaneous  section  under  the Alt-I
  1928.                command.
  1929.  
  1930.      Alt-0     Make a  manual entry  in the  Log file.  Log file must be open
  1931.                before you can make entries.  Open the Log file by setting the
  1932.                Log file  flag =  TRUE on  the configuration  screen.  See the
  1933.                Alt-I command.
  1934.  
  1935.      Alt -     The program will enter host mode and await incoming calls.
  1936.  
  1937.      ^PrtSc    Toggle the printer ON/OFF.  Press  the <Ctrl-PrtSc>  key.  Use
  1938.                <Fn-Echo> on the PCjr.
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.                                        30
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.      Phone Directory Commands
  1985.      ------------------------
  1986.           A =  Add an entry to the dialing directory.
  1987.  
  1988.           C =  Change an  entry in  the dialing directory.  Whenever an entry
  1989.                is added or changed in the phone directory,  the user  will be
  1990.                asked to enter a password which can be used by placing a %P in
  1991.                a macro key.
  1992.  
  1993.           K =  Kill  an  entry  in  the  dialing  directory,  sorting  of the
  1994.                directory is recommended after this option or the Add option.
  1995.  
  1996.           L =  Locate a  BBS by  name.  You may specify partial names and the
  1997.                search is not sensitive to capital letters.  The search begins
  1998.                with the  current directory  screen and proceeds to the end of
  1999.                the directory.
  2000.  
  2001.           N =  Find the next occurrence of the last BBS requested in  the <L>
  2002.                command, above.   The  search begins where the previous search
  2003.                left off and finds the next match, if any.
  2004.  
  2005.           M =  Dial a number not in the directory.  The user  is prompted for
  2006.                new communications parameters.
  2007.  
  2008.           Entry number =
  2009.                Dial  one   of  the   entries  in  the  directory.    GT  will
  2010.                automatically  change  the  communications   parameters.    To
  2011.                indicate  that  the  phone  number  needs  to  be  prefixed or
  2012.                suffixed, put one of the prefix characters before or after the
  2013.                number.   The 4 prefix characters are:   -  +  *  and  !.  The
  2014.                actual  prefix  and  suffixes  must  be  setup  via  the Alt-I
  2015.                command.  Usage:
  2016.  
  2017.                -74  would cause the 74th number in the directory to be dialed
  2018.                     with the prefix associated with the -.
  2019.  
  2020.                +81! would cause the 81st number in the directory to be dialed
  2021.                     with the  prefix associated  with the   +  and the suffix
  2022.                     associated with the !.
  2023.  
  2024.           G =  Mark a BBS for entry into  the "circular"  dialing queue.   If
  2025.                already marked,  the mark  will be  removed.  So, this command
  2026.                acts as a toggle between the marked and unmarked state.   When
  2027.                using this  command, if  the user  responds with "CLEAR", when
  2028.                asked for the BBS number, all marks will be cleared.  The user
  2029.                may  enter  a  list  of  BBS's  to  be  marked  or  cleared by
  2030.                separating each number from  the next  with either  a space or
  2031.                comma.     For  example:  "22,30,40"  could  be  entered  when
  2032.                responding to the request  for BBS  No's.   The user  may also
  2033.                respond with the word "ALL", in which case all entries will be
  2034.                marked.  And the lastly the user may enter a range of numbers.
  2035.  
  2036.                For example:
  2037.  
  2038.                     22 30-40 55    would mark 22, the range 30 to 40, & 55.
  2039.  
  2040.           E =  Exchange the current directory with another one.  For example,
  2041.                one could  have two  directories, 1  for local BBS's and 1 for
  2042.  
  2043.                                        31
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.                long distance calls.   Don't give  any path  information, when
  2051.                entering  the  filename  this  option  calls  for  - ALL phone
  2052.                directories are  located using  the "Directory  PATH" from the
  2053.                configuration file.  Use the Alt-I command to set this path as
  2054.                required.
  2055.  
  2056.           T =  Toggle the display, between  the  call  count  and accumulated
  2057.                time display, and the display of the date and time of the last
  2058.                call.  There are  4 different  displays possible  to view with
  2059.                the "T" command.
  2060.  
  2061.                NOTE:  The  Left-Arrow  and  Right-Arrow  keys  serve the same
  2062.                function as the "T" command.
  2063.  
  2064.           Esc = Quit, returns to the online screen.
  2065.  
  2066.           PgDn = Display the next page of the directory.
  2067.  
  2068.           PgUp = Display the previous page of the directory.
  2069.  
  2070.           Home = Go to the first page of the directory.
  2071.  
  2072.           End = Go to the last page of the directory.
  2073.  
  2074.           Up-Arrow = Move highlight  to entry  above the  current highlighted
  2075.                entry.
  2076.  
  2077.           Dn-Arrow =  Move highlight  to entry  below the current highlighted
  2078.                entry.
  2079.  
  2080.           Return = Dial the entry currently highlighted.
  2081.  
  2082.           Spacebar =
  2083.                Marks the entry that is currently  highlighted for  use by the
  2084.                circular dialing routine.
  2085.  
  2086.      Also, one  may execute  several of  the Alt  commands directly while the
  2087.      Phone Directory is still  on  the  screen.    For  example,  you  may go
  2088.      directly to the Circular Dialer by pressing Alt-6.  Ordinarily, the only
  2089.      Alt commands that are  not available  while in  the Phone  Directory are
  2090.      those that   would   be  executed while on-line,  for example the  Alt-T
  2091.      command would make no sense while still in the Phone Directory.
  2092.  
  2093.      The phone directory was expanded in GT 11.00 to include  two new fields:
  2094.      the logon  script and  the default file transfer protocol.  If the logon
  2095.      script is filled, then the indicated script will be executed  whenever a
  2096.      connection is  made with  the associated BBS.  The default file transfer
  2097.      protocol, if specified, will be automatically used whenever doing a file
  2098.      transfer with the associated BBS.
  2099.  
  2100.      The  phone  directory  was  again  expanded  in  GT 14.00.  This time to
  2101.      include three new options: duplex (full or half), emulation mode and 8th
  2102.      bit stripping.   These fields may be in one of three states: TRUE, FALSE
  2103.      or empty.  If they are empty, then GT will leave the default settings in
  2104.      effect.
  2105.  
  2106.  
  2107.  
  2108.  
  2109.                                        32
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.      Editing Keys
  2117.      ------------
  2118.      When   editing   Phone   Directory   entries,   Macro  Key  definitions,
  2119.      configuration setup entries and all other text type entries, the program
  2120.      responds to the following editing keys as indicated:
  2121.  
  2122.           Backspace .... Delete character to the left of cursor.
  2123.  
  2124.           Del .......... Delete character under the cursor.
  2125.  
  2126.           End .......... Move the cursor to the end of the field.
  2127.  
  2128.           Ctrl-End ..... Erase from the current cursor position to the end of
  2129.                          the field.
  2130.  
  2131.           Home ......... Move the cursor to the start of the field.
  2132.  
  2133.           Ctrl-Home .... Erase the current field entirely, no matter what the
  2134.                          current cursor position is within the field.
  2135.  
  2136.           Ins .......... Toggle between  insert and  overwrite mode.  When in
  2137.                          insert mode the cursor becomes fat.
  2138.  
  2139.           Left Arrow ... Move the cursor to the left 1 position.
  2140.  
  2141.           Right Arrow .. Move the cursor to the right 1 position.
  2142.  
  2143.           Return ....... Finish the current field and move to the next.
  2144.  
  2145.           Esc .......... Terminate edit.  Saves the changes made thus far.
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.                                        33
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.      Host Mode
  2183.      ---------
  2184.      The setup for host mode is complicated enough  that a  separate document
  2185.      file has  been written  describing this  procedure.   Rest assured, that
  2186.      once the proper setup has been  achieved, GT  should operate  with ease,
  2187.      both  in  and  out  of  host  mode.   Refer to the file GTHOST.DOC for a
  2188.      complete  description  of  the  host  mode  and  to  NETMAIL.DOC  for  a
  2189.      description of the GT netmail system.
  2190.  
  2191.  
  2192.  
  2193.  
  2194.  
  2195.  
  2196.  
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202.  
  2203.  
  2204.  
  2205.  
  2206.  
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.                                        34
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.      Scripts
  2249.      -------
  2250.      The script  language allows the user to automate most of the features of
  2251.      GT.    Following  is  a  description  of  the  script  syntax.   Several
  2252.      preliminary  comments  about  scripts:  1)  a  script can be canceled by
  2253.      hitting <Esc>, 2) the CYCLE command can be stopped by pressing <Ctrl-K>,
  2254.      3) the  strings and  other literal  information in  the syntax should be
  2255.      enclosed within "..."  if  they  contain  white-space,  blanks,  tabs or
  2256.      commas,  otherwise  they  need  not  be  so  enclosed.    All fields and
  2257.      operators must be separated on the line by the use of white-space.
  2258.  
  2259.      Scripts are interactive, so  that the  user can  modify them on-the-fly.
  2260.      In order  to do  this, 30  variables have been setup, they are called V0
  2261.      through V29.   They  are  referenced  in  either  assignment statements,
  2262.      READLN or  GETLN statements.   In  order to use them, a technique called
  2263.      "variable substitution" is used.  Instead of the V, the  variable number
  2264.      is  prefixed  with  a  %,  thus  V0  through V29, become %0 through %29.
  2265.      Variable substitution may not be done  within "...",  since the contents
  2266.      of a variable is considered to be a field, i.e. you cannot build a field
  2267.      from several concatenated variable  substitutions.   For example:   %1%2
  2268.      would be invalid.  It is not possible to do variable substitution within
  2269.      "...", for example: "%2" is not valid.  If you  use a  variable that has
  2270.      not been  initialized, it  will be a null string.  The data in variables
  2271.      is stored as strings of characters, up to 78 characters long.
  2272.  
  2273.      I used the word "field" in the paragraph above, by  it I  mean that part
  2274.      of a  script command  that either  is enclosed  by "..."  or contains no
  2275.      white space.  Script commands are sequences of fields separated by white
  2276.      space.
  2277.  
  2278.      For example:
  2279.  
  2280.          SET 1200,N,8,1
  2281.  
  2282.      contains 5 fields.
  2283.  
  2284.      In addition  to the  30 user variables provided, there are also built-in
  2285.      system variables  that  provide  information  about  the  status  of the
  2286.      system.  They are as follows:
  2287.  
  2288.                %BAUD     The current baud rate.
  2289.                %COM      The current COM port number.
  2290.                %DCD      The current DCD, Data Carrier Detect, status.
  2291.                               TRUE if present, FALSE otherwise.
  2292.                %FAIL     This  variable  is  set  after a SPAWN, WAIT or file
  2293.                               transfer  command   to   indicate   success  or
  2294.                               failure.  TRUE  if  failure  detected, FALSE if
  2295.                               all is well.
  2296.  
  2297.      You will notice the words TRUE  and FALSE  above, these  are new boolean
  2298.      constants that  are used  to test the %DCD and %FAIL state with the CASE
  2299.      statement.
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.                                        35
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.      Script Command Summary
  2315.      ----------------------
  2316.      ; ............ Any line that begins with a semi-colon is ignored by GT.
  2317.      ADD .......... Adds two integers.
  2318.      ALARM ........ Causes an alarm-like sound, until a key is pressed.
  2319.      ASCII XMIT ... Transmit a file using ASCII transmit protocol.
  2320.      AUTOBAUD ..... Send a whacking carriage return to the host.
  2321.      AWAIT ........ Wait for a specified time.
  2322.      BATCH-YMDM ... File transfer via the Ymodem Batch protocol.
  2323.      BEEP ......... Make a short beep on the system speaker.
  2324.      BREAK ........ Send a "Space Break" to the host.
  2325.      CALL ......... Invoke another script, like subroutines, and return.
  2326.      CAPTURE ...... Toggle capture mode ON/OFF.
  2327.      CASE ......... Test the value of a variable.  Or existence of a file.
  2328.      CD ........... Change disk directories.
  2329.      CHAIN ........ Invoke another script, like subroutines, but NO return.
  2330.      CLEAR ........ Clear the screen.
  2331.      COPY ......... Copy part of one string to another.
  2332.      CYCLE ........ Repeat execution of the current script.
  2333.      DDIAL ........ Dial a host from the phone directory.
  2334.      DIAL ......... Dial the specified phone number.
  2335.      DIV .......... Divides two integers.
  2336.      Drive Change . Change the default disk drive.
  2337.      DUPLEX ....... Toggle duplex between FULL/HALF.
  2338.      ECHO ......... Echo script commands to the screen.
  2339.      EMULATE ...... Set ANSI terminal emulation.
  2340.      END .......... Groups commands with a DDIAL or DIAL command.
  2341.      ESAC ......... Terminates a CASE command.
  2342.      EXCH ......... Change phone directories or keyboard macro files.
  2343.      EXIT ......... Used to exit the program.
  2344.      FLUSH ........ Throw away the contents of the serial buffers.
  2345.      FUNCTION ..... Send a macro key.
  2346.      GETLN ........ Read a line from serial port and store in a variable.
  2347.      GOTOXY ....... Position cursor to the x,y screen coordinates.
  2348.      HANG-UP ...... Hang up the modem.
  2349.      HOST ......... Enter host mode.
  2350.      KERMIT ....... File transfer via the Kermit protocol.
  2351.      LEN .......... Return the length of a string.
  2352.      LOG .......... Make an entry in the log file.
  2353.      LOWER ........ Convert a string to lowercase.
  2354.      MEGALINK ..... File transfer via the MegaLink protocol.
  2355.      MKWIN ........ Make a video window with a label.
  2356.      MUL .......... Multiplies two integers.
  2357.      NAME ......... Used with DIAL command to name the host.
  2358.      ONLINE ....... Allows user to temporarily leave the script.
  2359.      PAD .......... Pads string, either right or left justified.
  2360.      POS .......... Find occurance of one string within another.
  2361.      PRINT ........ Toggles the printer ON/OFF.
  2362.      QUIET ........ Toggles the beeper ON/OFF.
  2363.      QUIT ......... Exit from script, but remain in GT.
  2364.      READLN ....... Reads input from keyboard into a variable.
  2365.      RECV ......... Receive a file via Xmodem protocol.
  2366.      RIGHT ........ Copy the rightmost 'n' characters from string to string.
  2367.      RMWIN ........ Remove a video window.
  2368.      SCREEN ....... Toggle screen output ON/OFF while WAIT is active.
  2369.      SEALINK ...... File transfer via the SEAlink protocol.
  2370.      SEND ......... Send a string to the host.
  2371.      SENDLN ....... Send a string to the host, followed by carriage return.
  2372.  
  2373.                                        36
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.      SET .......... Used with DIAL command to manually set comm parameters.
  2381.      SETCOLOR ..... Set screen colors, both foreground and background.
  2382.      SHELL ........ Execute a program or DOS command.
  2383.      SPAWN ........ Invokes external program, without extra COMMAND.COM.
  2384.      SPLIT ........ Set split screen mode.
  2385.      STR .......... Convert an integer to a string.
  2386.      SUB .......... Subtracts two integers.
  2387.      SWAP ......... Swap the positions of the BackSpace and Del keys.
  2388.      TELINK ....... File transfer via the Telink protocol.
  2389.      1KTELINK ..... File transfer via the 1k Telink protocol.
  2390.      TRIM ......... Remove leading and trailing blanks from string.
  2391.      TWAIT ........ Timed wait in milliseconds, max wait is 32 seconds.
  2392.      UPPER ........ Convert a string to uppercase.
  2393.      VAL .......... Convert a string to an integer.
  2394.      Vn = ......... Assign a value to a variable.
  2395.      WAIT ......... Wait for some string to be received from host.
  2396.      WHEN ......... Trap a string sent from host, during a WAIT and respond.
  2397.      WRITE ........ Write a string to the screen.
  2398.      WRITELN ...... Write a string to the screen, followed by carriage return
  2399.      XMIT ......... Transmit a file via Xmodem protocols.
  2400.      YMODEM ....... File transfer via Ymodem protocol.
  2401.      YMODEM-G ..... File transfer via Ymodem-G protocol.
  2402.      ZMODEM ....... File transfer via Zmodem protocol.
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.                                        37
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.      Script Command Descriptions
  2447.      ---------------------------
  2448.  
  2449.      Command   Description and Example
  2450.      -------   -----------------------
  2451.      1KTELINK  Transfer a batch of files using the 1k Telink protocol.  Works
  2452.                the same  as TELINK,  described below,  but uses the 1k packet
  2453.                size for increased efficiency.
  2454.  
  2455.      ADD       Adds two integers  and  stores  the  result  in  the requested
  2456.                variable.
  2457.  
  2458.                Example:
  2459.  
  2460.                     V6  ADD  3  7
  2461.                     WRITELN %6
  2462.  
  2463.                This would  print 000010  on the  screen.  The integer that is
  2464.                the sum of 3 and 7.
  2465.  
  2466.      ALARM     Causes a continuous ringing  sound  to  be  made  until  a key
  2467.                stroke is made by the operator.
  2468.  
  2469.                Example:
  2470.  
  2471.                     ALARM
  2472.                          Alarm is continuous until a key is pressed.
  2473.  
  2474.                     ALARM 5
  2475.                          Alarm continues for the indicated number of seconds,
  2476.                          5 in this example, or until a key is pressed.
  2477.  
  2478.      ASCII XMIT
  2479.                Transmit a file using the ASCII protocol.  Refer to  the Alt-A
  2480.                command above under the explanation of command keys.  The same
  2481.                routine that executes the Alt-A command key performs the ASCII
  2482.                XMIT.
  2483.  
  2484.                Example:
  2485.  
  2486.                     ASCII XMIT filename
  2487.                          The filename given is transmitted.  No wildcards may
  2488.                          be used.  Only 1 file at a time may be transmitted.
  2489.  
  2490.      AUTOBAUD  Used after the DIAL  or DDIAL  command to  set the  hosts baud
  2491.                rate  to  the  caller's.    The  AUTOBAUD  command can use the
  2492.                carriage return or the blank to  set the  rate.   Usually, the
  2493.                carriage return  is used  and it  is the default, however some
  2494.                systems require the blank.
  2495.  
  2496.                Examples:
  2497.  
  2498.                     AUTOBAUD
  2499.                          For carriage return use.
  2500.  
  2501.                     AUTOBAUD  BLANK
  2502.                          For blank use.
  2503.  
  2504.  
  2505.                                        38
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.      AWAIT     Used to delay execution of  the  script  until  the designated
  2513.                time.   GT uses  24:00:00 convention  for midnight.   The hour
  2514.                field does not roll over until 1 A.M.   Therefore  there is no
  2515.                zero hour, it jumps from 24 to 1.  For example: 24:30:00 would
  2516.                be 12:30 in the morning.
  2517.  
  2518.                Examples:
  2519.  
  2520.                     AWAIT hh:mm:ss
  2521.  
  2522.                     AWAIT 9:45:00
  2523.  
  2524.                The time is formatted hours, minutes  and seconds,  all fields
  2525.                must be  entered.   Note: midnight  is 24:00:00, the hour does
  2526.                not role over until 1 AM.
  2527.  
  2528.      BATCH-YMDM
  2529.                Transfer a batch of files via the Ymodem Batch protocol.
  2530.  
  2531.                Examples:
  2532.  
  2533.                     BATCH-YMDM RECV *
  2534.                          The filenames are supplied by the host.
  2535.  
  2536.                     BATCH-YMDM XMIT filename
  2537.                          The  filename  listed  is   transmitted.    Wildcard
  2538.                          characters may be used to send a batch of files.
  2539.  
  2540.      BEEP      Causes the speaker to emit a beep.
  2541.  
  2542.                Example:
  2543.  
  2544.                     BEEP
  2545.  
  2546.      BREAK     Used to  send a  Space Break to the host.  Some hosts will use
  2547.                this to wake-up and  logon the  user, mostly  UNIX systems and
  2548.                other mini-computers.
  2549.  
  2550.                Example:
  2551.  
  2552.                     BREAK
  2553.  
  2554.      CALL      Causes a  branch in  the flow  of execution  to the scriptname
  2555.                specified and automatic  return  to  the  calling  script when
  2556.                finished.    Upon  return  to the calling script, execution is
  2557.                started at the next statement following the CALL statement.
  2558.  
  2559.                Example:
  2560.  
  2561.                     CALL scriptname
  2562.  
  2563.      CAPTURE   Used to turn-on Capture Mode from within a script.   There are
  2564.                two forms:  "CAPTURE" and  "CAPTURE filename".  The first form
  2565.                is used to begin  capturing data,  the second  form terminates
  2566.                Capture Mode and names the file to receive the captured data.
  2567.  
  2568.                Example:
  2569.  
  2570.  
  2571.                                        39
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.                     CAPTURE               { Begin capturing here }
  2579.                          .
  2580.                          .
  2581.                          .
  2582.                     CAPTURE filename      { Finish capturing here }
  2583.  
  2584.      CASE & ESAC
  2585.                Those of  you familiar  with UNIX  should recognize the use of
  2586.                ESAC, case spelled backward.  For the others, ESAC is  used to
  2587.                mark the  end of  the CASE  statement.   The CASE statement is
  2588.                used to test for the truth or falsity  of some  condition, for
  2589.                example it could be used to implement a menu.  The syntax is:
  2590.  
  2591.                     CASE target_value OF
  2592.                          op1 test_value1
  2593.                               statement-1
  2594.                               statement-2
  2595.                                    .
  2596.                                    .
  2597.                                    .
  2598.                          op2 test_value2
  2599.                               statement-1a
  2600.                               statement-2a
  2601.                                    .
  2602.                                    .
  2603.                                    .
  2604.                     ESAC
  2605.  
  2606.                Where there  may be any number of "op" tests and any number of
  2607.                statements  between  "op"  tests.    The  CASE  statement will
  2608.                perform the  following tests until it reaches the 1st one that
  2609.                is TRUE, (target_value  op  test_value), when  a TRUE  test is
  2610.                found,  then  the  statements  associated  with  that test are
  2611.                executed.  ONLY one set of statements is selected, as  soon as
  2612.                they have  been completed the remainder are skipped, until the
  2613.                ESAC is encountered.  Execution continues after the  ESAC.  If
  2614.                no test  evaluates to TRUE, then all are skipped and execution
  2615.                begins after the ESAC.  Possible "op" codes are:
  2616.  
  2617.                     =    Test for equality.
  2618.  
  2619.                     >    Test if target_value greater than test_value.
  2620.  
  2621.                     <    Test if target_value less than test_value.
  2622.  
  2623.                     >=   Test  if   target_value   greater   than   or  equal
  2624.                          test_value.
  2625.  
  2626.                     <=   Test if target_value less than or equal test_value.
  2627.  
  2628.                     ~    Test  if  the  test_value  is  contained  within the
  2629.                          target_value.
  2630.  
  2631.                     ?    If no other test prior to this evaluated to be TRUE,
  2632.                          then this  will be TRUE.  Usually placed just before
  2633.                          the ESAC.  There  is no  need for  a test_value with
  2634.                          this "op"  code.   This is a default operator and is
  2635.                          equivalent to the ELSE in Pascal's CASE statement.
  2636.  
  2637.                                                  40
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.                     EXIST and !EXIST
  2646.                     ----------------
  2647.                          These  two  operators  are  used  to  test  for  the
  2648.                          existence of a file.  The "target_value" of the CASE
  2649.                          statement is the name of a file and  EXIST evaluates
  2650.                          "true" if  that file  exists, while !EXIST evaluates
  2651.                          "true" if that file does not exist.  See example.
  2652.  
  2653.                     Boolean values
  2654.                     --------------
  2655.                          You can treat the "target_value" of a CASE statement
  2656.                          as if  it was  a boolen  value.   A value of zero is
  2657.                          considered "false" and non-zero is "true".  Further,
  2658.                          the "op"  code field  may contain  the words TRUE or
  2659.                          FALSE, so that a boolean  test  is  performed.   For
  2660.                          example:
  2661.  
  2662.                          CASE %DCD OF
  2663.                               TRUE
  2664.                                    writeln "Carrier is present"
  2665.                               FALSE
  2666.                                    writeln "Carrier is not present"
  2667.                          ESAC
  2668.  
  2669.                          In this case, if the variable %DCD was TRUE then the
  2670.                          first case would execute, if it  was FALSE  then the
  2671.                          second would execute.
  2672.  
  2673.                For example:
  2674.  
  2675.                     GETLN V2
  2676.                     CASE %2 OF
  2677.                          ~ BUSY
  2678.                               WRITELN "BUSY found in target!"
  2679.                          ~ CONNECT
  2680.                               WRITELN "CONNECT found in target!"
  2681.                          ?
  2682.                               WRITELN "Neither found in the target!"
  2683.                     ESAC
  2684.  
  2685.                In this example, the V2 variable is read from the serial port,
  2686.                then tested to see whether it  contains the  word BUSY  or the
  2687.                word CONNECT.  The match is not exact, but the test_value must
  2688.                be wholly contained somewhere in the target.
  2689.  
  2690.                     CLEAR
  2691.                     WRITELN
  2692.                     WRITELN "Communications Menu"
  2693.                     WRITELN "-------------------"
  2694.                     WRITELN "1.  Call the PC Interconnection BBS"
  2695.                     WRITELN "2.  Call the Fido's Partner BBS"
  2696.                     WRITELN "3.  Call the Dow-Jones Retrieval Service"
  2697.                     WRITELN "4.  Call the Compuserve BBS"
  2698.                     WRITELN "5.  Exit to DOS"
  2699.                     WRITELN
  2700.                     WRITE   "Enter your choice. "
  2701.                     READLN V1
  2702.  
  2703.                                        41
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.                     CASE %1 OF
  2711.                          = 1
  2712.                               CHAIN PCINSCRP
  2713.                          = 2
  2714.                               CHAIN FIDOSCRP
  2715.                          = 3
  2716.                               CHAIN DOWJSCRP
  2717.                          = 4
  2718.                               CHAIN COMPSCRP
  2719.                          = 5
  2720.                               WRITELN "Goodbye, and thanks for the call."
  2721.                               TWAIT 3000
  2722.                               EXIT
  2723.                          ?
  2724.                               WRITELN
  2725.                               BEEP
  2726.                               BEEP
  2727.                               WRITELN "Your only choices are 1 through 5."
  2728.                               WAIT 10000
  2729.                               CYCLE
  2730.                     ESAC
  2731.  
  2732.                In this next example, the use of EXIST will be demonstrated:
  2733.  
  2734.                     V2 = "foo.bar"
  2735.                     CASE %2 OF
  2736.                          EXIST
  2737.                               XMIT %2
  2738.                          ?
  2739.                               WRITE "Skipping "
  2740.                               WRITE %2
  2741.                               WRITELN ", cannot locate file."
  2742.                     ESAC
  2743.  
  2744.  
  2745.                Notice how all fields are entered  with "white  space" between
  2746.                them.    This  is  required,  as  "=5"  is wrong, and "= 5" is
  2747.                correct.
  2748.  
  2749.  
  2750.      CD        Change directories.
  2751.  
  2752.                Example:
  2753.  
  2754.                     CD directory
  2755.  
  2756.                Works like the DOS equivalent, except  that it  has no display
  2757.                function.
  2758.  
  2759.      CHAIN     Causes a  branch in the flow of execution of the script to the
  2760.                scriptname designated.   No  automatic return  to the invoking
  2761.                script is made.
  2762.  
  2763.                Example:
  2764.  
  2765.                     CHAIN scriptname
  2766.  
  2767.      CLEAR     Used  to  clear  the  screen  and place the cursor in the home
  2768.  
  2769.                                        42
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.                position.
  2777.  
  2778.                Example:
  2779.  
  2780.                     CLEAR
  2781.  
  2782.      COPY      Copies a sub-string from  the  input  argument  and  saves the
  2783.                result in the indicated variable.
  2784.  
  2785.                Example:
  2786.  
  2787.                     V4  COPY  "abcdxxxefgh"  5  3
  2788.                     WRITELN %4
  2789.  
  2790.                This command extracts the string starting the 5th postion with
  2791.                a length of 3 characters.   Therefore the  information written
  2792.                to the screen would be the string "xxx".
  2793.  
  2794.      CYCLE     When found, it causes the script processor to repeat execution
  2795.                of the script from the beginning.  For example, when  you wish
  2796.                to make  a script  to dial  a list  of BBS's,  then repeat the
  2797.                script when finished it would look like this:
  2798.  
  2799.                     NAME "xxxxxxxxxxxx"
  2800.                     DIAL "123-4567"
  2801.                          AUTOBAUD
  2802.                          ONLINE
  2803.                     END
  2804.                     NAME "yyyyyyyyyyyy"
  2805.                     DIAL "123-4567"
  2806.                          AUTOBAUD
  2807.                          ONLINE
  2808.                     END
  2809.                     .
  2810.                     .  etc., etc...
  2811.                     .
  2812.                     CYCLE 5 TIMES
  2813.  
  2814.                The CYCLE command in the example above would  cause the script
  2815.                to repeat  5 times.  If the cycle count is not specified, then
  2816.                10 times is the default.  Note: it is not good practice to put
  2817.                script commands  that toggle between on/off states in a cycled
  2818.                script, unless you  cycle  them  back  to  the  original state
  2819.                before  the  CYCLE  command  is issued.  Otherwise the command
  2820.                will cycle on/off from execution to execution.   An example of
  2821.                a toggle  command is DUPLEX or QUIET, you should put them into
  2822.                initialization scripts and NOT  in a  script that  is CYCLEed.
  2823.                The CYCLE command can be manually terminated from the keyboard
  2824.                by pressing Ctrl-K.
  2825.  
  2826.                For example:
  2827.  
  2828.                     Script-a
  2829.                     --------
  2830.                     QUIET                    Toggle beeps off.
  2831.                     ECHO                     Toggle command echoing on.
  2832.                     AWAIT 1:30:00            Wait for 1:30 am.
  2833.                     CHAIN script-b           Execute script-b.
  2834.  
  2835.                                        43
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.                     Script-b
  2844.                     --------
  2845.                     NAME "xxxxxxxxxx"        Name who we are calling.
  2846.                     DIAL "123-4567"          Dial the modem.
  2847.                          .
  2848.                          .                   etc., etc...
  2849.                          .
  2850.                     CYCLE 5 TIMES            Execute script-b 5 times.
  2851.  
  2852.      Drive Change
  2853.  
  2854.                Change default disk drive.  Works like the DOS equivalent.
  2855.  
  2856.                Example:
  2857.  
  2858.                     C:
  2859.  
  2860.      DIAL      Used to dial the modem.
  2861.  
  2862.                Examples:
  2863.  
  2864.                     DIAL phone# WITH REDIAL
  2865.  
  2866.                     DDIAL name WITH REDIAL
  2867.  
  2868.                The phrase WITH REDIAL is optional.
  2869.  
  2870.                In the second form, DDIAL, the "name" is  found in  the user's
  2871.                dialing directory  and the parameters for baud rate, and phone
  2872.                number are set automatically.  If  the "name"  cannot be found
  2873.                in the  directory, then the script will resume execution after
  2874.                the next END statement, as if the host  was unavailable.   The
  2875.                "name" does not have to be complete, it searches for the first
  2876.                BBS name in the  directory  that  contains  "name"  within it.
  2877.                Upper and lower case letters are treated the same.
  2878.  
  2879.                The  commands,  following  the  DIAL  or DDIAL command, may be
  2880.                grouped together to form the  commands  required  to  access a
  2881.                particular host.   The  END command is used to mark the end of
  2882.                such a group.  If a connection cannot  be made  with the host,
  2883.                then the  commands between  the DIAL  and the END are skipped.
  2884.                If no END is found, the rest of the commands in the script are
  2885.                skipped.   Please refer  to the  sample script that comes with
  2886.                the documentation.
  2887.  
  2888.      DUPLEX    Toggle between full and half duplex.   The  starting condition
  2889.                is FULL  duplex.   You may  also specify the state you wish by
  2890.                using the words ON or OFF.  For example:
  2891.  
  2892.                     DUPLEX
  2893.                          Toggle duplex to the opposite state.
  2894.  
  2895.                     DUPLEX ON
  2896.                          Turns half duplex on.
  2897.  
  2898.                     DUPLEX OFF
  2899.                          Turns half duplex off.
  2900.  
  2901.                                        44
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.  
  2909.      ECHO      Causes script commands to be displayed  on the  screen as they
  2910.                are executed.  Useful for debugging new scripts.
  2911.  
  2912.      EMULATE   Starts or stops ANSI standard terminal emulation.
  2913.  
  2914.                Examples:
  2915.  
  2916.                     EMULATE ON
  2917.                          Begins VT-100 emulation.
  2918.  
  2919.                     EMULATE OFF
  2920.                          Ends VT-100 emulation.
  2921.  
  2922.      END       Used with DIAL to group commands for a particular host.
  2923.  
  2924.      EXCH      Causes the  program to  exchange phone directories or keyboard
  2925.                macro files.  So  that more  than 1  phone directory  or macro
  2926.                file may be used.
  2927.  
  2928.                Example:
  2929.  
  2930.                     EXCH DIRECTORY filename
  2931.                          The filename is the name of the new phone directory.
  2932.                          Note, there is  one  difference  between  the script
  2933.                          command and  the manual,  Alt-D, method  to do this:
  2934.                          this file must exist or an  error will  occur.  With
  2935.                          the manual  method, the  file will be created, if it
  2936.                          does not already exist.
  2937.  
  2938.                     EXCH MACROS filename
  2939.                          The filename is the name of  the new  keyboard macro
  2940.                          file.   If it  can be  located, its contents will be
  2941.                          loaded into the function keys.
  2942.  
  2943.                The filename  on the  EXCH command  must not  contain any path
  2944.                information.    The  program  looks  for all phone directories
  2945.                under the "Directory PATH" from the configuration file and all
  2946.                macro files  in the  GT home directory.  Use the Alt-I command
  2947.                to  set  the  "Directory  PATH"  and  the  GTPATH  environment
  2948.                variable to set the GT home directory.
  2949.  
  2950.      EXIT      Used to exit the program from within a script.
  2951.  
  2952.                Example:
  2953.  
  2954.                     EXIT
  2955.  
  2956.      FLUSH     Flushes the contents of the serial input buffer.  Useful prior
  2957.                to an ONLINE or before dialing a new host.
  2958.  
  2959.                Example:
  2960.  
  2961.                     FLUSH
  2962.  
  2963.      FUNCTION  Execute one of the macro keys.
  2964.  
  2965.                Examples:
  2966.  
  2967.                                        45
  2968.  
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974.  
  2975.                     FUNCTION KEY 2
  2976.                          This example would execute the string stored in F2.
  2977.  
  2978.                     FUNCTION KEY ALT 2
  2979.                          Executes the contents of Alt-F2.   You can  also use
  2980.                          SHIFT and CTRL in addition to ALT.
  2981.  
  2982.      GETLN     Get a  line of data from the host.  Leading blanks and control
  2983.                characters are stripped off.  The  command will  timeout after
  2984.                40  seconds  waiting  for  the  terminating carriage return or
  2985.                linefeed.
  2986.  
  2987.                Note: carriage returns and  linefeeds  are  stripped  from the
  2988.                beginning of  the input.  One of these control characters will
  2989.                terminate input ONLY after some data has been accumulated.
  2990.  
  2991.                Example:
  2992.  
  2993.                     GETLN V4
  2994.  
  2995.                A variable  must  be  specified  to  receive  the  data.   The
  2996.                variables have pre-assigned names: V0 through V29.
  2997.  
  2998.      GOTOXY    Used to  position the cursor at a x,y screen coordinate.  This
  2999.                position is always calculated relative to  the current window,
  3000.                see MKWIN and RMWIN, if any is active.
  3001.  
  3002.                Example:
  3003.  
  3004.                     GOTOXY 10 4
  3005.  
  3006.                          Postion the cursor to column 10, row 4.  Column 1,
  3007.                          row 1  is the  upper left  position of the screen or
  3008.                          window.
  3009.  
  3010.      HANG-UP   Used to hang-up the modem.
  3011.  
  3012.      HOST      Used to enter host mode automatically from a  script.  Nothing
  3013.                else should be in the script following the HOST command.  This
  3014.                command should  not be  contained in  a script  that is called
  3015.                from another script.
  3016.  
  3017.                Examples:
  3018.  
  3019.                     HOST
  3020.  
  3021.                     HOST MODE
  3022.  
  3023.                The word MODE is optional and is used for documentation of the
  3024.                script only.
  3025.  
  3026.      KERMIT    Transfer a batch of files using the Kermit protocol.
  3027.  
  3028.                Examples:
  3029.  
  3030.                     KERMIT RECV *
  3031.                          The file names are supplied by the host.
  3032.  
  3033.                                        46
  3034.  
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  
  3041.                     KERMIT XMIT filename
  3042.                          The filename listed is transmitted to the host.
  3043.                          Wildcards are allowed, to do a batch transfer.
  3044.  
  3045.      LEN       Measures the length of  a  string  and  stores  the  result as
  3046.                indicated.
  3047.  
  3048.                Example:
  3049.  
  3050.                     V6  LEN  "1234567890"
  3051.                     WRITELN %6
  3052.  
  3053.                This would  print 000010  on the screen, because the string is
  3054.                10 characters in length.
  3055.  
  3056.      LOG       Make an entry in the log file.
  3057.  
  3058.                Example:
  3059.  
  3060.                     LOG "This is an entry in the log file, or whatever!"
  3061.  
  3062.      LOWER     Convert  a  string  to  lowercase  and  store  in  the request
  3063.                variable.
  3064.  
  3065.                Example:
  3066.  
  3067.                     V4  LOWER  "ABCD"
  3068.                     WRITELN  %4
  3069.  
  3070.                This would print the string "abcd" on the screen.
  3071.  
  3072.      MEGALINK  Transfer a batch of files using the MegaLink protocol.
  3073.  
  3074.                Examples:
  3075.  
  3076.                     MEGALINK RECV *
  3077.                          The file names are supplied by the host.
  3078.  
  3079.                     MEGALINK XMIT filename
  3080.                          The filename listed is transmitted to the host.
  3081.                          Wildcards are allowed, to do a batch transfer.
  3082.  
  3083.      MKWIN     Makes a  window on  the video  screen.  All cursor positioning
  3084.                and WRITEs will take  place  within  the  window  until  it is
  3085.                removed  (see  RMWIN  below)  or  overlaid  with another MKWIN
  3086.                window.
  3087.  
  3088.                Example:
  3089.  
  3090.                     MKWIN x1 y1 x2 y2 "label"
  3091.                          x1 is the x coordinate of the upper left corner.
  3092.                          y1 is the y coordinate of the upper left corner.
  3093.                          x2 is the x coordinate of the lower right corner.
  3094.                          y2 is the y coordinate of the lower right corner.
  3095.                          "label" is a text string that  will be  displayed as
  3096.                          the title of the window.
  3097.  
  3098.  
  3099.                                        47
  3100.  
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.                     MKWIN 3 10 78 15 "Text input window"
  3107.  
  3108.      MUL       Multiplies two integers and stores the product as requested.
  3109.  
  3110.                Example:
  3111.  
  3112.                     V3  MUL  2  12
  3113.                     WRITELN  %3
  3114.  
  3115.                This produces  000024 on the screen, which is the product of 2
  3116.                times 12.
  3117.  
  3118.      NAME      Used to name the host that the user is calling.   Shows  up on
  3119.                the Redial window.  Used with the DIAL command.  Not used with
  3120.                the DDIAL command,  because  the  BBS  name  from  the dialing
  3121.                directory is used.
  3122.  
  3123.                Example:
  3124.  
  3125.                     NAME string
  3126.  
  3127.      ONLINE    Used to exit, temporarily, from script to manual mode.  Useful
  3128.                when using a script  to call  a host  and then  go into manual
  3129.                operation once connected.
  3130.  
  3131.                Example:
  3132.  
  3133.                     ONLINE
  3134.  
  3135.           +----------------------------------------------------------------+
  3136.           |                            NOTE                                |
  3137.           |                                                                |
  3138.           |        When you press Alt-X, you exit back to the script       |
  3139.           |        and script execution begins where it left-off.          |
  3140.           |                                                                |
  3141.           +----------------------------------------------------------------+
  3142.  
  3143.      PAD       Pads  a  string  with  a  pad character, on the right or left,
  3144.                until the specified width is reached,  then stores  the result
  3145.                as requested.
  3146.  
  3147.                Example:
  3148.  
  3149.                     V12  PAD  "foo"  10  " "
  3150.                     WRITELN  %12
  3151.  
  3152.                The string "foo       " would be printed on the screen.
  3153.  
  3154.                     V5   PAD  "bar"  -7  "."
  3155.  
  3156.                The  string  "....bar"  would  be  printed on the screen.  The
  3157.                negative  width  indicates  the  right  justification  and the
  3158.                indicated pad character is the ".".
  3159.  
  3160.      POS       Finds the occurence of one string within another.  Returns the
  3161.                position of the found string or 0 (FALSE) if not found.
  3162.  
  3163.                Example:
  3164.  
  3165.                                        48
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  
  3173.                     V1 POS "xxx" "abcdxxxefghi"
  3174.                     WRITELN %1
  3175.  
  3176.                This would print 000005 on the  screen, since  the "xxx"   was
  3177.                found at the 5th character of the mask string.
  3178.  
  3179.                     V10 POS "xxx" "abcde"
  3180.                     WRITELN %10
  3181.  
  3182.                This would  print 000000 on the screen, since the "xxx" cannot
  3183.                be found within the 2nd string.
  3184.  
  3185.      PRINT     Toggle the printer on and off.  The  printer will  run as data
  3186.                is received from the host.  Equivalent to Ctrl-PrtSc.
  3187.  
  3188.                Example:
  3189.  
  3190.                     PRINT
  3191.                          Toggle the PRINT on and off.
  3192.  
  3193.                     PRINT ON
  3194.                          Toggle  commands  may  specify  the requested state.
  3195.                          This would turn the printer ON.
  3196.  
  3197.                     PRINT OFF
  3198.                          Turn the printer OFF.
  3199.  
  3200.      QUIET     Toggle the beeps on  and off.   The  starting condition  is to
  3201.                have beeps ON.
  3202.  
  3203.                Example:
  3204.  
  3205.                     QUIET
  3206.                          Toggles from existing state to the opposite state.
  3207.  
  3208.                     QUIET ON
  3209.                          Turns off the beeps and other noise.
  3210.  
  3211.                     QUIET OFF
  3212.                          Turns on the noise.
  3213.  
  3214.      READLN    This command  is used  to read data from the operator into one
  3215.                of the 10 variables.  The  variables have  pre-assigned names:
  3216.                V0 - V29.  The syntax is:
  3217.  
  3218.                     READLN variable_name
  3219.  
  3220.                For example:
  3221.  
  3222.                     WRITE "Enter desired time to start. (hh:mm:ss): "
  3223.                     READLN V2
  3224.                     AWAIT %2
  3225.  
  3226.                Notice the  %2 in the 3rd line of the example, the % tells the
  3227.                script processor to do a variable substitution at  this point,
  3228.                so the  value input  for variable 2 is inserted into the AWAIT
  3229.                command.  Thus causing the script  to pause  until the desired
  3230.  
  3231.                                        49
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.                time.
  3239.  
  3240.                Note:  When  responding  to  a  READLN  the user must type the
  3241.                response followed by a carriage return.  If the user  wants to
  3242.                terminate the  script at the READLN command, enter ^K followed
  3243.                by a carriage return.
  3244.  
  3245.      RECV      Receive a file using the Xmodem protocol.
  3246.  
  3247.                Example:
  3248.  
  3249.                     RECV filename
  3250.                          Receives a single file from the host.
  3251.  
  3252.      RIGHT     Extracts the rightmost part of a string.
  3253.  
  3254.                Example:
  3255.  
  3256.                     V3  RIGHT  "....xyz"  3
  3257.                     WRITELN %3
  3258.  
  3259.                This command would  print  the  string  "xyz"  on  the screen,
  3260.                because the right 3 characters of the source string are stored
  3261.                in V3.
  3262.  
  3263.      RMWIN     Remove window made with  prior MKWIN.   All  windows made with
  3264.                MKWIN should be removed before final exit from the script.
  3265.  
  3266.      SCREEN    Used to  turn-off the  screen display, i.e. stop incoming data
  3267.                from appearing during the WAIT command.
  3268.  
  3269.                Examples:
  3270.  
  3271.                     SCREEN OFF
  3272.                          Turns screen off.
  3273.  
  3274.                     SCREEN ON
  3275.                          Turns screen on.
  3276.  
  3277.      SEALINK   Transfers a batch of files using the SEAlink protocol.
  3278.  
  3279.                Examples:
  3280.  
  3281.                     SEALINK RECV *
  3282.                          Receives a group of files sent by the host.
  3283.  
  3284.                     SEALINK XMIT filename
  3285.                          Transmits the filename given to the  host.   A batch
  3286.                          of files may be sent by using wildcard characters.
  3287.  
  3288.      SEND      Used to send a string to the host.  The string may contain the
  3289.                | character, which will be changed to a  carriage return.   Up
  3290.                to 10 strings can be sent to the host with one command.
  3291.  
  3292.                Example:
  3293.  
  3294.                     SEND string1 string2
  3295.  
  3296.  
  3297.                                        50
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.                The two  strings would  be sent  to the  host without any gaps
  3305.                between them.
  3306.  
  3307.                The strings may be in "...",  if embedded blanks are required.
  3308.  
  3309.      SENDLN    Same as SEND above, but sends a carriage return at  the end of
  3310.                the transmission.
  3311.  
  3312.                Example:
  3313.  
  3314.                     SENDLN string1 string2
  3315.  
  3316.                Up to 10 strings can be sent to the host with one command, the
  3317.                carriage return is sent following the last string.
  3318.  
  3319.      SET       Used to set the serial port  parameters: COM  port, baud rate,
  3320.                parity, data bits and stop bits.
  3321.  
  3322.                Examples:
  3323.  
  3324.                     SET 1200,N,8,1
  3325.                          This would set 1200 baud, no parity, 8 data bits and
  3326.                          one stop bit. Legal baud rate values are: 300, 1200,
  3327.                          2400, 4800,  9600, and  19200.   Legal parity values
  3328.                          are N=none, E=even and O=odd.  Legal data bits are 7
  3329.                          or 8. Legal stop bits are 1 or 2.
  3330.  
  3331.                     SET COM2 2400 E 7 1
  3332.                          This SET  command would work in a similar fashion to
  3333.                          the first example, however it would  also switch the
  3334.                          COM port to number 2.
  3335.  
  3336.      SETCOLOR  Set  the  screen  colors  to  be  used  with the next WRITE or
  3337.                WRITELN command.
  3338.  
  3339.                Example:
  3340.  
  3341.                     SETCOLOR 11 0
  3342.                          Set  the  foreground  to  11  (Light  Cyan)  and the
  3343.                          background to 0 (Black).
  3344.  
  3345.                     Dark Colors         Light Colors
  3346.                     -----------         ------------
  3347.                     0 : Black           8  : Dark Gray
  3348.                     1 : Blue            9  : Light Blue
  3349.                     2 : Green           10 : Light Green
  3350.                     3 : Cyan            11 : Light Cyan
  3351.                     4 : Red             12 : Light Red
  3352.                     5 : Magenta         13 : Light Magenta
  3353.                     6 : Brown           14 : Yellow
  3354.                     7 : Light Gray      15 : White
  3355.  
  3356.  
  3357.      SHELL     This command allows you to execute any program or DOS command,
  3358.                if there is enough memory available.
  3359.  
  3360.                Example:
  3361.  
  3362.  
  3363.                                        51
  3364.  
  3365.  
  3366.  
  3367.  
  3368.  
  3369.  
  3370.                     SHELL "copy file1 file2"
  3371.  
  3372.                This would cause the COPY command to be executed and the files
  3373.                named to be copied.
  3374.  
  3375.      SPAWN     Invokes  an  external  program  as  a child process.  Does not
  3376.                execute a second copy of COMMAND.COM.  Sets the %FAIL  flag if
  3377.                the external  program returns  an error code on "exit()".  The
  3378.                SPAWN command supports arguments that are passed to  the child
  3379.                process as  command line paramters, up to 10 can be specified,
  3380.                arg0 through  arg9,  where  arg0  is  the  name  of  the child
  3381.                process.
  3382.  
  3383.                Example:
  3384.  
  3385.                     SPAWN c:\gt\dsz.exe port %COM speed %BAUD rz
  3386.  
  3387.                This example would cause the DSZ.EXE program to be executed to
  3388.                receive files.  Upon return from the SPAWN, the %FAIL variable
  3389.                will  be  set  according  to  the  success  or  failure of the
  3390.                transfer.
  3391.  
  3392.      SPLIT     Starts or stops Split-Screen operation.
  3393.  
  3394.                Examples:
  3395.  
  3396.                     SPLIT SCREEN ON
  3397.                          Begins Split-Screen.
  3398.  
  3399.                     SPLIT SCREEN OFF
  3400.                          Ends Split-Screen.
  3401.  
  3402.      STR       Converts an integer  argument  to  a  string  result  with the
  3403.                requested width.
  3404.  
  3405.                Example:
  3406.  
  3407.                     V5 STR 234 6
  3408.                     WRITELN %5
  3409.  
  3410.                The  above  code  would  write  a  string  to  the screen that
  3411.                consisted of 3 leading blanks and the numbers  234.   In other
  3412.                words, the string in V5 would be "   234".
  3413.  
  3414.      SUB       Subtracts two integers and stores the result as requested.
  3415.  
  3416.                Example:
  3417.  
  3418.                     V21  SUB  10  3
  3419.                     WRITELN %21
  3420.  
  3421.                This would  print 000007  on the  screen, which is the integer
  3422.                that is the result of 10 minus 3.
  3423.  
  3424.      SWAP      This command swaps the position of  the <Backspace>  and <Del>
  3425.                keys.    This  is  needed  by  many  people who use the VT-100
  3426.                emulation mode.
  3427.  
  3428.  
  3429.                                        52
  3430.  
  3431.  
  3432.  
  3433.  
  3434.  
  3435.  
  3436.                Examples:
  3437.  
  3438.                     SWAP KEYS ON
  3439.                          This would swap the two keys, <Backspace> and <Del>.
  3440.  
  3441.                     SWAP KEYS OFF
  3442.                          This would reverse a previous swapping of the keys.
  3443.                          Note: Key swaps made with this command are  not made
  3444.                          a permanent  part of the .CNF file.  They go back to
  3445.                          the default value at the start of the  program.  Use
  3446.                          the Alt-I command to make the swap permanent.
  3447.  
  3448.      TELINK    Transfer a batch of files using the Telink protocol.
  3449.  
  3450.                Examples:
  3451.  
  3452.                     TELINK XMIT *.pas
  3453.                          Transmits all files with the .PAS extension.
  3454.  
  3455.                     TELINK RECV *
  3456.                          Receive a group of files from the host.
  3457.  
  3458.      TRIM      Removes leading  and trailing  blanks from a string and stores
  3459.                the result as indicated.
  3460.  
  3461.                Example:
  3462.  
  3463.                     V7  TRIM  "   qed   "
  3464.                     WRITELN %7
  3465.  
  3466.                The command would strip the  spaces  and  store  "qed"  in V7.
  3467.                Then the WRITELN would print the "qed" on the screen.
  3468.  
  3469.      TWAIT     Timed wait, in milliseconds.  The maximum wait period is 32767
  3470.                milliseconds.
  3471.  
  3472.                Example:
  3473.  
  3474.                     TWAIT number
  3475.                          The "number" is the number of  milliseconds to delay
  3476.                          the execution of the script.
  3477.  
  3478.      UPPER     Convert  a  string  to  uppercase  and  store  in  the request
  3479.                variable.
  3480.  
  3481.                Example:
  3482.  
  3483.                     V4  UPPER  "abcd"
  3484.                     WRITELN  %4
  3485.  
  3486.                This would print the string "ABCD" on the screen.
  3487.  
  3488.      Vn =      Variables can be assigned values in 2 ways, through the READLN
  3489.                command  above,  or  within  the  script  itself,  they can be
  3490.                assigned values, much the same way it is  done in  FORTRAN and
  3491.                other high-level languages.  The syntax is:
  3492.  
  3493.                     Vn = value
  3494.  
  3495.                                        53
  3496.  
  3497.  
  3498.  
  3499.  
  3500.  
  3501.  
  3502.  
  3503.                For example:
  3504.  
  3505.                     V0 = "the PC Interconnection"
  3506.                     V7 = "555-1234"
  3507.                     V2 = "Johnny Jones"
  3508.  
  3509.                Note:  the  use  of  blanks  to isolate the "=" from the other
  3510.                fields, this is REQUIRED.
  3511.  
  3512.      VAL       Converts a string argument to an integer value.
  3513.  
  3514.                Example:
  3515.  
  3516.                     V1 VAL "23"
  3517.                     WRITE %1
  3518.  
  3519.                This would produce 000023 on the screen for  the user  to see.
  3520.                The  string  might  have  contained  leading  white-space  and
  3521.                trailing non-numerics (the conversion ends with the first non-
  3522.                numeric.  If no characters are found to be numeric, the result
  3523.                would be 000000.
  3524.  
  3525.      WAIT      Used to make the execution of the script wait for a particular
  3526.                string to be sent from the host.
  3527.  
  3528.                Examples:
  3529.  
  3530.                     WAIT FOR string
  3531.  
  3532.                     WAIT n FOR string
  3533.  
  3534.                The string  may be  in "...", if embedded blanks are required.
  3535.                In the 2nd form, the "n" represents the  number of  seconds to
  3536.                wait before timing-out the host.  Note, the timeout clock only
  3537.                counts down when no data is being sent by the  host.    If the
  3538.                first form is used, the default time-out period is 40 seconds.
  3539.  
  3540.                If  the  WAIT  command  times  out  waiting  for the string to
  3541.                arrive, the %FAIL variable  will  be  set  TRUE,  so  that the
  3542.                script can test for the failure and take action based upon the
  3543.                failure.
  3544.  
  3545.      WHEN      Sets up a string to trap  out,  while  waiting  with  the WAIT
  3546.                command.   Whenever the  indicated string is trapped, then the
  3547.                response shown will be sent to  the  host.    This  feature is
  3548.                mostly used to trap the "More" string and send a Y or N to the
  3549.                host.  If required by  the  host,  a  carriage  return  may be
  3550.                inserted in  the response string by using a | character.  Both
  3551.                the string trapped and the response  are limited  to a maximum
  3552.                of 30 characters each.
  3553.  
  3554.                Example:
  3555.  
  3556.                     WHEN "More" THEN "N"
  3557.  
  3558.                This  will  keep  the  WAIT  command from getting stuck at the
  3559.                "More" prompt.  Note: up to 6 WHEN commands remain  in effect.
  3560.  
  3561.                                        54
  3562.  
  3563.  
  3564.  
  3565.  
  3566.  
  3567.  
  3568.                Individual WHEN's may be disabled by omitting the THEN clause.
  3569.  
  3570.                For example:
  3571.  
  3572.                     WHEN "More" THEN "N"     Setup the trap.
  3573.                     WHEN "More"              Turns off the trap.
  3574.  
  3575.      WRITE     Used to  write a  string to  the screen,  does not send to the
  3576.                host.  Up  to  ten  strings  can  be  written  with  one WRITE
  3577.                command.  Each string should have white-space surrouding it.
  3578.  
  3579.                Example:
  3580.  
  3581.                     WRITE string1 string2 string3
  3582.                          Would write  the 3 strings to the screen without any
  3583.                          space between them.
  3584.  
  3585.                     WRITE "foo." "bar"
  3586.                          Would write "foo.bar"  to  the  screen  (without the
  3587.                          "..." of course).
  3588.  
  3589.      WRITELN   Used to  write a  string to the screen with a carriage return,
  3590.                linefeed combination at the end of the line, does not  send to
  3591.                the host.
  3592.  
  3593.                Example:
  3594.  
  3595.                     WRITELN string
  3596.  
  3597.                Please note  that WRITELN  behaves the  same way  as the WRITE
  3598.                above, that it can write up to 10  strings to  the screen with
  3599.                one WRITELN command.
  3600.  
  3601.      WXMODEM   Transfer a file using the WXmodem protocol.
  3602.  
  3603.                Examples:
  3604.  
  3605.                     WXMODEM XMIT filename
  3606.                          Transmits a file to the host.
  3607.  
  3608.                     WXMODEM RECV filename
  3609.                          Receives a file from the host.
  3610.  
  3611.      XMIT      Transmit a file using the Xmodem protocol.
  3612.  
  3613.                Example:
  3614.  
  3615.                     XMIT filename
  3616.                          Transmits a file to the host.
  3617.  
  3618.      YMODEM    Transfer a file using the Ymodem protocol.
  3619.  
  3620.                Examples:
  3621.  
  3622.                     YMODEM XMIT filename
  3623.                          Transmits a file to the host.
  3624.  
  3625.                     YMODEM RECV filename
  3626.  
  3627.                                        55
  3628.  
  3629.  
  3630.  
  3631.  
  3632.  
  3633.  
  3634.                          Receives a file from the host.
  3635.  
  3636.      YMODEM-G  Transfer a group of files using the Ymodem-G Batch protocol.
  3637.  
  3638.                Examples:
  3639.  
  3640.                     YMODEM-G XMIT "*.PAS FOO.BAR TENNIS.TXT"
  3641.                          Transmits the group of files within the "...".
  3642.  
  3643.                     YMODEM-G RECV *
  3644.                          Receive a group of files from the host.
  3645.  
  3646.      ZMODEM    Transfer a group of files using the Zmodem Batch protocol.
  3647.  
  3648.                Examples:
  3649.  
  3650.                     ZMODEM XMIT "*.PAS FOO.BAR TENNIS.TXT"
  3651.                          Transmits the group of files within the "...".
  3652.  
  3653.                     ZMODEM RECV *
  3654.                          Receive a group of files from the host.
  3655.  
  3656.  
  3657.  
  3658.  
  3659.  
  3660.  
  3661.  
  3662.  
  3663.  
  3664.  
  3665.  
  3666.  
  3667.  
  3668.  
  3669.  
  3670.  
  3671.  
  3672.  
  3673.  
  3674.  
  3675.  
  3676.  
  3677.  
  3678.  
  3679.  
  3680.  
  3681.  
  3682.  
  3683.  
  3684.  
  3685.  
  3686.  
  3687.  
  3688.  
  3689.  
  3690.  
  3691.  
  3692.  
  3693.                                        56
  3694.  
  3695.  
  3696.  
  3697.  
  3698.  
  3699.  
  3700.                                      Appendix
  3701.                                      --------
  3702.  
  3703.      25th Line Status Indicators
  3704.      ---------------------------
  3705.      CAPTURE: 999   Capture  mode  is  on,  and  the  number displayed is the
  3706.                     amount of data, in 1000's of  characters, in  the capture
  3707.                     buffer.
  3708.  
  3709.      Suspend: 999   Capture mode  is on, but suspended currently.  The number
  3710.                     displayed is the amount of data  in 1000's  of characters
  3711.                     in the capture buffer.
  3712.  
  3713.      BBS Name       If no  capture is  currently active, the name of the BBS,
  3714.                     you are currently communicating with, will be displayed.
  3715.  
  3716.      Caller Name    In host mode, the name  of  the  current  caller  to your
  3717.                     system will be displayed.
  3718.  
  3719.      CONNECT 99:99  Time CONNECTed to a BBS in hours and minutes.
  3720.  
  3721.      OFF LINE       Indicates you are currently not connected to a BBS.
  3722.  
  3723.      CABLE CONNECT  Indicates that you are currently using a cable connection
  3724.                     to your host system.
  3725.  
  3726.      ^              The Caps Lock is on.
  3727.  
  3728.      #              The Num Lock is on.
  3729.  
  3730.      Q              Beeps are turned off.
  3731.  
  3732.      CD             Carrier Detected (is present).  When carrier is  lost, an
  3733.                     alarm sounds.
  3734.  
  3735.      PR             The printer is on.
  3736.  
  3737.      VT             VT-100 terminal emulation is enabled.
  3738.  
  3739.      HDX            Half Duplex is true, the default in host mode.
  3740.  
  3741.      Ck             Checksum Xmodem is true, the default is CRC Xmodem.
  3742.  
  3743.      baud rate      The  current  baud  rate  in  use: 300, 1200, 2400, 4800,
  3744.                     9600, or 19200.
  3745.  
  3746.      99:99          The current time.
  3747.  
  3748.  
  3749.  
  3750.  
  3751.  
  3752.  
  3753.  
  3754.  
  3755.  
  3756.  
  3757.  
  3758.  
  3759.                                        57
  3760.  
  3761.  
  3762.  
  3763.  
  3764.  
  3765.  
  3766.      System Files
  3767.      ------------
  3768.  
  3769.      Here is a list and short description of each of the many  files provided
  3770.      with the GT POWER system:
  3771.  
  3772.           GT1400.EXE .... Absolute program.  The one to execute.
  3773.           GTO1400.EXE ... The GTerminal Only version of GT.  Called GTO.
  3774.           GT1400.DOC .... This file.  The documentation.
  3775.           PCKERMIT.EXE .. The program which performs Kermit file transfers.
  3776.           PCKERMIT.TXT .. Documentation for PCKERMIT.EXE.
  3777.           DSZ.EXE ....... Performs Zmodem and Ymodem-G file transfers.
  3778.           DSZ.TXT ....... Documentation for DSZ.EXE.
  3779.         * GT.DIR ........ The phone directory, data file.
  3780.         * GT.KEY ........ Macro key definitions, data file.
  3781.         * GT.CNF ........ The configuration, data file.
  3782.           RAMDISK.BAT ... Sample runstream to execute GT from ramdisk.
  3783.         * GT.LOG ........ Log file.  Note: don't edit the log file with an
  3784.                           editor which places a CPM EOF (Hex 1A) at the end
  3785.                           of a file.  GT is unable to append log entries to a
  3786.                           file which ends with the CPM EOF - a quirk of Turbo
  3787.                           PASCAL.
  3788.           GT-UTIL.COM ... Program to convert old directories to newer format,
  3789.                           produce printed listing of phone directory, import
  3790.                           text list of BBS's to GT format directory.  Also,
  3791.                           converts some Qmodem formats to the GT format.
  3792.           GT-UTIL.DOC ... Short doc file for GT-UTIL.
  3793.           PURSUIT.SCR ... Script to be used to access the PC Pursuit network.
  3794.           PCPMENU.SCR ... Script called by PURSUIT.SCR, used to access PC
  3795.                           Pursuit.
  3796.           SCRIPT.SCR .... A sample script for use with GT.
  3797.           REGISTER.DOC .. Description of the registration plan.
  3798.           FORM.DOC ...... A registration form, ready to be filled in and
  3799.                           printed.
  3800.           GTHOST.DOC .... Documentation for host mode.
  3801.           GTDOOR.BAT .... Executed when host mode caller requests "Shell to
  3802.                           DOS".
  3803.           GTDOOR1.BAT ... Sample DOOR batch file.
  3804.           GTDOORS.BBS ... DOOR menu text file.
  3805.           KEYBOARD.MAC .. Keyboard macros to use with ANSI.SYS and the DOS
  3806.                           Door.
  3807.         x GTMESSAG.CTL .. The message control file for host mode operation.
  3808.         x GTMAIL.CTL .... The user mail control file for host mode operation.
  3809.         x GTMSGS ........ Sub-directory where host mode stores the messages.
  3810.         x MAILOUT ....... Sub-directory where GT netmail puts outgoing mail.
  3811.         x MAILIN ........ Sub-directory where GT netmail puts incoming mail.
  3812.           GTWELCOM.BBS .. Welcome screen for host mode.  }******
  3813.           GTUSER.BBS .... Record of last user's name.    }
  3814.           PROTOCOL.BBS .. Protocol menu text file.       }
  3815.           PREQUEST.BBS .. Pre-questionnaire text file.   }
  3816.           QUESTION.BBS .. Questionnaire template file.   }
  3817.           GTBULLET.BBS .. Bulletin file for host mode.   }
  3818.           BULLET1.BBS ... Custom bulletin file #1.       } Example files used
  3819.           BULLET2.BBS ... Custom bulletin file #2.       } in GT host mode.
  3820.           GTMENU.BBS .... Main menu file for host mode.  } These are ordinary
  3821.           GTPASSWD.BBS .. Password file for host mode.   } text files and may
  3822.           GTHELP.BBS .... Help file for host mode.       } be changed with an
  3823.           GTDIR.BBS ..... Directory control list.        } ASCII text editor.
  3824.  
  3825.                                        58
  3826.  
  3827.  
  3828.  
  3829.  
  3830.  
  3831.  
  3832.           GTMDIR.BBS .... Message area control list.     }
  3833.           GTDDIR.BBS .... DOOR control list.             }
  3834.           GTSYSID.BBS ... Initial system ID for callers. }
  3835.           WELCOME.BBS ... Message area welcome file.     }
  3836.           MBULLET1.BBS .. Message area bulletin file.    }
  3837.           GTBYE.BBS ..... Goodbye file for host mode.    }******
  3838.           MBAGGER.COM ... The netmail bagger program.       } Refer to
  3839.           MDRIVER.COM ... The netmail driver program.       } netmail
  3840.           MDRIV031.000 .. The overlay file for MDRIVER.     } documentation
  3841.           MDIST.COM ..... The netmail distribution program. } for explanation
  3842.           NETMAIL.DOC ... The netmail documentation file.
  3843.           TIMER.EXE ..... Program to calculate the Millisec Loop Count.
  3844.  
  3845.         * The  files  marked  with an "*" above  are  created   automatically
  3846.           whenever GT cannot locate them.
  3847.  
  3848.         x The files marked with an "x" above are created,  as needed,  by the
  3849.           GT host mode or the GT netmail system.
  3850.  
  3851.  
  3852.  
  3853.  
  3854.  
  3855.  
  3856.  
  3857.  
  3858.  
  3859.  
  3860.  
  3861.  
  3862.  
  3863.  
  3864.  
  3865.  
  3866.  
  3867.  
  3868.  
  3869.  
  3870.  
  3871.  
  3872.  
  3873.  
  3874.  
  3875.  
  3876.  
  3877.  
  3878.  
  3879.  
  3880.  
  3881.  
  3882.  
  3883.  
  3884.  
  3885.  
  3886.  
  3887.  
  3888.  
  3889.  
  3890.  
  3891.                                        59
  3892.  
  3893.  
  3894.  
  3895.  
  3896.  
  3897.  
  3898.      Configuration File Layout
  3899.      ------------------------
  3900.      In position  1-3 of  each record  in the configuration file is a code to
  3901.      identify a parameter.    After  the  "=",  the  value  of  the parameter
  3902.      appears.
  3903.  
  3904.         CM= COM port number, 1,2,3 or 4.
  3905.         ST= Number of Stopbits.
  3906.         DA= Number of Databits.
  3907.         PA= Parity. 0=None,1=Even,2=Odd
  3908.         SR= Stripping option.  Strip parity bit from serial port input.
  3909.         BA= Default Baud Rate. 300,1200,2400,4800,9600 or 19200.
  3910.         MB= Maximum Baud Rate.  Restricts values found in Phone Directory.
  3911.         CS= Honor CTS from modem option.
  3912.         S2= String to set modem to 300 baud.            }******
  3913.         S4= String to set modem to 1200 baud.           }
  3914.         S5= String to set modem to 2400 baud.           }
  3915.         S6= String to set modem to 4800 baud.           }
  3916.         S7= String to set modem to 9600 baud.           }
  3917.         S8= String to set modem to 19200 baud.          } For non-Hayes
  3918.         P0= String to set modem to 7 bits, no parity.   } modems only.  See
  3919.         P1= String to set modem to 7 bits, even parity. } table on page 56.
  3920.         P2= String to set modem to 7 bits, odd parity.  }
  3921.         P3= String to set modem to 8 bits, no parity.   }
  3922.         P4= String to set modem to 8 bits, even parity. }
  3923.         P5= String to set modem to 8 bits, odd parity.  }
  3924.         P6= String to set modem to 7 bits, mark parity. }
  3925.         P7= String to set modem to 8 bits, mark parity. }******
  3926.         ML= The "Millisec Loop Count".  Use TIMER.COM program to calculate.
  3927.                Normal value is about 50 for standard PC's.
  3928.         PR= Dialing Pre String.
  3929.         PO=  Dialing  Post  String,  use  the  |  character where a Return is
  3930.                required.
  3931.         HU= The modem hang-up string.
  3932.         PF= Phone number prefix/suffix.  Associated with the  -  character.
  3933.         P+= Phone number prefix/suffix.  Associated with the  +  character.
  3934.         P*= Phone number prefix/suffix.  Associated with the  *  character.
  3935.         P!= Phone number prefix/suffix.  Associated with the  !  character.
  3936.         MI= Modem initialization string.  Use the | character where a Return
  3937.                is needed.
  3938.         HO= Host mode, modem initialization string.
  3939.         AS= Answer string.  When issued, this string  should cause  the modem
  3940.                to answer an incoming call.
  3941.         SY= Modem command string to turn the speaker ON.
  3942.         SN= Modem command string to turn the speaker OFF.
  3943.         RT= After carrier timeout has occurred, this is the time between
  3944.                redial, in seconds.
  3945.         FC= Forced  Carrier.   Some modems  force carrier even when a call is
  3946.                not in progress, if this is  the case,  set this  parameter to
  3947.                TRUE.
  3948.         CT= Timeout time for carrier to appear, in seconds.
  3949.         DP= Directory  PATH.   This variable  tells the program where to look
  3950.                for the phone directory.   This  parameter is  provided mainly
  3951.                for  people  who  wish  to  put  the  dialing  directory  on a
  3952.                RAM-disk.
  3953.         TP= Download PATH.  All files received by GT are placed, by default,
  3954.                in  this  directory.    User  may  override,  by  typing  full
  3955.                pathnames  when   entering  filenames.     Effects  host  mode
  3956.  
  3957.                                        60
  3958.  
  3959.  
  3960.  
  3961.  
  3962.  
  3963.  
  3964.                operation also!
  3965.         UP= Upload PATH.  Does not apply to host mode operation.
  3966.         SP= Script PATH.  Scripts are stored in this directory.
  3967.         CP= Capture PATH.  Capture saves are done to this directory.
  3968.         MP= Message base PATH.  Controls where GT will place the *.CTL  files
  3969.                and the GTMSGS sub-directory.
  3970.         XO= The decimal value  of the  XON character.   Used  to control data
  3971.                flow Starts data flow after XOFF has been issued.
  3972.         XF= The  decimal value  of the  XOFF character.  Used to control data
  3973.                flow Stops  data flow when issued.   Helps insure  that buffer
  3974.                overflow does not occur.
  3975.         VT= If TRUE, turns on VT100 emulation,  using ANSI escape codes.  If
  3976.                VT100 emulation  is requested,  music will  not be played, and
  3977.                will show on the screen as  text.   This happens  because of a
  3978.                conflict  between  the  full  ANSI  definition and the musical
  3979.                notes.  This does not  pose  a  problem  for  most  BBS users,
  3980.                because they  do not need the full ANSI emulation.  BBS's that
  3981.                send music and graphics  use IBM  ANSI graphics,  which can be
  3982.                processed  without   setting  VT=TRUE.  For  BBS  use,    this
  3983.                parameter should be set FALSE, and the IBM  ANSI graphics will
  3984.                be processed.
  3985.         WN= Suppress window noise.  Do you want video game whistling windows?
  3986.         AW= Auto line wrap mode.  If FALSE, characters received while the
  3987.                cursor is in column 80 of the screen will not wrap to the next
  3988.                line.
  3989.         LF= Auto Linefeed mode.  If TRUE, then a linefeed will be
  3990.                automatically supplied whenever a carriage return is received.
  3991.         FG= The default foreground color number.  Any one of the 16 values in
  3992.                the table below.
  3993.         BG= The default background color number.  Any one of the DARK shades,
  3994.                0-7, from the table below.
  3995.         CC= The comment character used with the macro keys.
  3996.         MX= Number of Xmodem buffers to allocate.  4 - 255 are the legal
  3997.                values.  A smaller number should be used on systems with only
  3998.                128k, larger  values can  be used if more memory is available.
  3999.                Each buffer takes 128 bytes.
  4000.         DM= DMA mode.  Some computers have no DMA chip, some have defective
  4001.                DMA chips.  If you have one of these computer, you will obtain
  4002.                better results with file transfers, if  this parameter  is set
  4003.                to SLOW.   If you have a normal IBM PC with good DMA chip, set
  4004.                this parameter to FAST.
  4005.         PC= The Pacing Character.  This is the  character echoed  by the host
  4006.                at  the  end  of  each  line.   If you set this character, the
  4007.                program will wait for it to be echoed by the  host at  the end
  4008.                of each  line during  an ASCII file transmission.  The default
  4009.                is no Pacing Character.  The  abbreviations CR  and LF  may be
  4010.                used  in  this  field  to  indicate  the  carriage  return and
  4011.                linefeed characters,  as well as the |  character for carriage
  4012.                return.
  4013.         EL=  End-of-Line   Mode.     This  determines  the  line  terminating
  4014.                characters sent to the  host, during  ASCII file  transmit, to
  4015.                delimit the  end-of-line.    Defaults to CRLF, carriage return
  4016.                and linefeed.  The  other options  are LF,  only linefeed, and
  4017.                CR, only carriage return.
  4018.         AD= ASCII inter-character delay.  Specified in milliseconds.  The
  4019.                default value is 0.
  4020.         WF= Window foreground color number.  Anyone of the 16 values from the
  4021.                table below.
  4022.  
  4023.                                        61
  4024.  
  4025.  
  4026.  
  4027.  
  4028.  
  4029.  
  4030.         WB= Window background color number.  Anyone of the DARK shades, 0-7,
  4031.                from the table below.
  4032.         WR= Window-frame foreground color number.  Anyone of the 16 values
  4033.                from the table below.
  4034.         WS= Window-frame background color number.  Anyone of the DARK shades
  4035.                from the table below.
  4036.         HF= Option hi-lite color, foreground.
  4037.         HB= Option hi-lite color, background.
  4038.         OF= Option lo-lite color, foreground.
  4039.         OB= Option lo-lite color, background.
  4040.         TF= Status line color, foreground.
  4041.         TB= Status line color, background.
  4042.         WU= Window Title color, foreground.
  4043.         WV= Window Title color, background.
  4044.         DU= Phone directory hi-lite color, foreground.
  4045.         DV= Phone directory hi-lite color, background.
  4046.         LG= If TRUE, GT will keep a log of all BBS's called and files
  4047.                transferred.  Default is FALSE.
  4048.         PD= Current phone directory name.  Default is 'GT'.
  4049.         SB= Minutes of inactivity until the screen is blanked.  A value of 0
  4050.                disables the screen blanker.
  4051.         CK= If  TRUE,   GT will automatically check diskspace available prior
  4052.                to  downloading  any  file.    If  FALSE,  GT  will  not check
  4053.                diskspace before downloads.
  4054.         MM= If FALSE, GT will not play music received from the host system.
  4055.                If TRUE, the music will be played.  If emulation mode is TRUE,
  4056.                this switch is forced to be FALSE.
  4057.         RC= Result codes.  The code is defined by the numeric code and the
  4058.                code actually  returned by  the modem.   There are 17 possible
  4059.                codes, only 15 of which are used.  Example: RC=1,CONNECT
  4060.         SO= Bios video routines.  If TRUE, the Bios video routines will be
  4061.                used my the window handler, instead  of direct  memory access.
  4062.                The Bios routines are much slower, but have the benefit of
  4063.                compatibility with multi-tasking operating systems.
  4064.         PG= Pagination of printer output.  If TRUE, the output on the printer
  4065.                will  be   paginated,  so   that  it   doesn't  print  on  the
  4066.                perforations.
  4067.         LP= Lines per page.  Works with the pagination option.
  4068.         KY= Name of the current macro key file.  Default is 'GT'.
  4069.         BS= Swap position of BackSpace and Del keys, used with VT-100
  4070.                emulation.
  4071.  
  4072.         NEW in GT POWER 14.00
  4073.         ---------------------
  4074.         BL= BREAK length in milliseconds.
  4075.         TL= Tilde length.  The tilde ~ is used to add delay to various string
  4076.                sent to the modem.
  4077.         HN= Off-hook string.  Sent to modem to make it go off-hook.
  4078.         HY= On-hook string.  Sent to modem to make it go on-hook.
  4079.         NK= Option to make NO KILL the default message security.
  4080.         SM= Message path for M)essages to the SYSOP.
  4081.         DD= The  default file directory.  The one callers first see when they
  4082.                connect.
  4083.         LO= Log file path.  The log will be stored in this directory.
  4084.         CL= Capture memory buffer limit in 1,000s of characters.
  4085.         BP= Blank pad mode.  Used to control the sending  of blanks  lines in
  4086.                ASCII  transmit  mode.    If  TRUE,  then  blank lines will be
  4087.                padded with blanks.  Helps with message upload to BBSs.
  4088.  
  4089.                                        62
  4090.  
  4091.  
  4092.  
  4093.  
  4094.  
  4095.  
  4096.         EW= Exploding windows  option.    If  TRUE,  then  GT's  windows will
  4097.                explode when they open.
  4098.         AR=  Auto  redial  on  BUSY  result  from  modem.  If TRUE, GT's will
  4099.                automatically redial a number  that is  BUSY when  dialed from
  4100.                the phone directory.
  4101.  
  4102.        * = Comment lines.
  4103.  
  4104.      Note: these entries may either be changed via the Alt-I command, or with
  4105.            any text editor that produces standard ASCII files, such as EDLIN.
  4106.  
  4107.  
  4108.  
  4109.  
  4110.  
  4111.  
  4112.  
  4113.  
  4114.  
  4115.  
  4116.  
  4117.  
  4118.  
  4119.  
  4120.  
  4121.  
  4122.  
  4123.  
  4124.  
  4125.  
  4126.  
  4127.  
  4128.  
  4129.  
  4130.  
  4131.  
  4132.  
  4133.  
  4134.  
  4135.  
  4136.  
  4137.  
  4138.  
  4139.  
  4140.  
  4141.  
  4142.  
  4143.  
  4144.  
  4145.  
  4146.  
  4147.  
  4148.  
  4149.  
  4150.  
  4151.  
  4152.  
  4153.  
  4154.  
  4155.                                        63
  4156.  
  4157.  
  4158.  
  4159.  
  4160.  
  4161.  
  4162.      Configuration File Defaults
  4163.      ---------------------------
  4164.      CM=1
  4165.      ST=1
  4166.      DA=8
  4167.      PA=0
  4168.      SR=FALSE
  4169.      BA=1200
  4170.      MB=19200
  4171.      CS=FALSE
  4172.      CL=16
  4173.      P0=
  4174.      P1=
  4175.      P2=
  4176.      P3=
  4177.      P4=
  4178.      P5=
  4179.      P6=
  4180.      P7=
  4181.      S2=
  4182.      S3=
  4183.      S4=
  4184.      S5=
  4185.      S6=
  4186.      S7=
  4187.      S8=
  4188.      ML=50
  4189.      PR=ATDT
  4190.      HU=~+++~ATH|
  4191.      PF=
  4192.      P+=
  4193.      P*=
  4194.      P!=
  4195.      PO=|
  4196.      MI=AT V1 Q0 E0 X1 S0=0 S2=43|
  4197.      SY=ATM1|
  4198.      SN=ATM0|
  4199.      RT=90
  4200.      HY=ATH0|
  4201.      HN=ATH1|
  4202.      FC=FALSE
  4203.      AR=TRUE
  4204.      CT=60
  4205.      DP=
  4206.      TP=
  4207.      UP=
  4208.      SP=
  4209.      LF=FALSE
  4210.      LO=
  4211.      TL=1000
  4212.      BL=250
  4213.      CP=
  4214.      XO=17
  4215.      XF=19
  4216.      VT=FALSE
  4217.      EW=FALSE
  4218.      WN=FALSE
  4219.      SO=FALSE
  4220.  
  4221.                                        64
  4222.  
  4223.  
  4224.  
  4225.  
  4226.  
  4227.  
  4228.      FG=7
  4229.      BG=0
  4230.      CC=;
  4231.      MX=8
  4232.      PC=
  4233.      EL=CR
  4234.      BP=FALSE
  4235.      WF=15
  4236.      WB=0
  4237.      WR=7
  4238.      WS=0
  4239.      WU=0
  4240.      WV=7
  4241.      DU=0
  4242.      DV=7
  4243.      HF=15
  4244.      HB=0
  4245.      OF=7
  4246.      OB=0
  4247.      TF=0
  4248.      TB=7
  4249.      LG=FALSE
  4250.      AD=0
  4251.      PD=GT
  4252.      DM=FAST
  4253.      MM=TRUE
  4254.      LP=60
  4255.      KY=GT
  4256.      BS=FALSE
  4257.      AW=TRUE
  4258.      CK=TRUE
  4259.      SB=0
  4260.      AS=ATA|
  4261.      PG=FALSE
  4262.      MP=
  4263.      DD=
  4264.      HO=AT V1 Q0 E0 M0 X1 S0=1 S2=255|
  4265.      NK=TRUE
  4266.      SM=
  4267.      RC=0,0,OK
  4268.      RC=1,1,CONNECT
  4269.      RC=2,2,RING
  4270.      RC=3,3,NO CARRIER
  4271.      RC=4,4,ERROR
  4272.      RC=5,5,CONNECT 1200
  4273.      RC=6,6,NO DIAL TONE
  4274.      RC=7,7,BUSY
  4275.      RC=8,8,NO ANSWER
  4276.      RC=9,9,CONNECT 4800
  4277.      RC=10,10,CONNECT 2400
  4278.      RC=11,11,RINGING
  4279.      RC=12,12,VOICE
  4280.      RC=13,13,CONNECT 9600
  4281.      RC=14,14,CONNECT 4800/ARQ
  4282.      RC=15,15,CONNECT 1200/ARQ
  4283.      RC=16,16,CONNECT 2400/ARQ
  4284.      RC=17,17,CONNECT 9600/ARQ
  4285.  
  4286.  
  4287.                                        65
  4288.  
  4289.  
  4290.  
  4291.  
  4292.  
  4293.  
  4294.                          Color Number Table:
  4295.                          -------------------
  4296.  
  4297.                     Dark Colors         Light Colors
  4298.                     -----------         ------------
  4299.                     0 : Black           8  : Dark Gray
  4300.                     1 : Blue            9  : Light Blue
  4301.                     2 : Green           10 : Light Green
  4302.                     3 : Cyan            11 : Light Cyan
  4303.                     4 : Red             12 : Light Red
  4304.                     5 : Magenta         13 : Light Magenta
  4305.                     6 : Brown           14 : Yellow
  4306.                     7 : Light Gray      15 : White
  4307.  
  4308.  
  4309.  
  4310.  
  4311.  
  4312.  
  4313.  
  4314.  
  4315.  
  4316.  
  4317.  
  4318.  
  4319.  
  4320.  
  4321.  
  4322.  
  4323.  
  4324.  
  4325.  
  4326.  
  4327.  
  4328.  
  4329.  
  4330.  
  4331.  
  4332.  
  4333.  
  4334.  
  4335.  
  4336.  
  4337.  
  4338.  
  4339.  
  4340.  
  4341.  
  4342.  
  4343.  
  4344.  
  4345.  
  4346.  
  4347.  
  4348.  
  4349.  
  4350.  
  4351.  
  4352.  
  4353.                                        66
  4354.  
  4355.  
  4356.  
  4357.  
  4358.  
  4359.  
  4360.      ANSI Emulation - Received Characters
  4361.      ------------------------------------
  4362.      Cursor Up .................................. ESC [ Pn A
  4363.      Cursor Down ................................ ESC [ Pn B
  4364.      Cursor Forward ............................. ESC [ Pn C
  4365.      Cursor Backward ............................ ESC [ Pn D
  4366.      Cursor Position ............................ ESC [ Pl ; Pc H
  4367.      Cursor Position (Home) ..................... ESC [ H
  4368.      Horizontal and Vertical Position ........... ESC [ Pl ; Pc f
  4369.      Horizontal and Vertical Position (Home) .... ESC [ f
  4370.      Set Scrolling Region ....................... ESC [ Pt ; Pb r
  4371.      Set Origin Mode ......see notes below....... ESC [ ? 6 h
  4372.      Reset Origin Mode .......................... ESC [ ? 6 l
  4373.      Index ...................................... ESC D
  4374.      Reverse Index .............................. ESC M
  4375.      Reverse Linefeed ........................... ESC I
  4376.      Next Line .................................. ESC E
  4377.      Save Cursor ................................ ESC 7
  4378.                                                or ESC [ s
  4379.      Restore Cursor ............................. ESC 8
  4380.                                                or ESC [ u
  4381.      Cursor Key Mode Set ........................ ESC [ ? 1 h
  4382.      Application Keypad Mode .................... ESC =
  4383.      Cursor Key Mode Reset ...................... ESC [ ? 1 l
  4384.      Numeric Keypad Mode ........................ ESC >
  4385.      Select US Character Set .................... ESC ( B
  4386.      Select Line Drawing Character Set .......... ESC ( 0
  4387.      Turn Off Character Attributes .............. ESC [ m
  4388.      Selects Bold Characters .................... ESC [ 1 m
  4389.      Selects Underlined Characters .............. ESC [ 4 m
  4390.      Selects Blinking Characters ................ ESC [ 5 m
  4391.      Selects Reverse Video Characters ........... ESC [ 7 m
  4392.      Set Horizontal Tab Stop .................... ESC H
  4393.      Clear A Horizontal Tab Stop ................ ESC [ g
  4394.      Clear All Horizontal Tab Stops ............. ESC [ 3 g
  4395.      Erase From Cursor To End Of Line ........... ESC [ K
  4396.      Erase From Beginning Of Line To Cursor ..... ESC [ 1 K
  4397.      Erase Complete Line ........................ ESC [ 2 K
  4398.      Erase From Cursor To End Of Screen ......... ESC [ J
  4399.      Erase From Beginning Of Screen To Cursor ... ESC [ 1 J
  4400.      Erase Complete Display ..................... ESC [ 2 J
  4401.      Delete Character At Cursor ................. ESC [ Pn P
  4402.      Insert Line At Cursor ...................... ESC [ Pn L
  4403.      Delete Line At Cursor ...................... ESC [ Pn M
  4404.      Select Insert Mode ......................... ESC [ 4 h
  4405.      Reset Insert Mode .......................... ESC [ 4 l
  4406.      Select Newline Mode ........................ ESC [ 20 h
  4407.      Reset Newline Mode ......................... ESC [ 20 l
  4408.      Select Auto Line Wrap Mode ................. ESC [ ? 7 h
  4409.      Reset Auto Line Wrap Mode .................. ESC [ ? 7 l
  4410.      Turn Printer On ............................ ESC [ ? 5 i
  4411.      Turn Printer Off ........................... ESC [ ? 4 i
  4412.      Turn Printer Controller On ................. ESC [ 5 i
  4413.      Turn Printer Controller Off ................ ESC [ 4 i
  4414.      Print Screen ............................... ESC [ i
  4415.      Request Cursor Position Report ............. ESC [ 6 n
  4416.             Response: Cursor Position Report .... ESC [ Pl ; Pc R
  4417.      Request ID ................................. ESC [ c
  4418.  
  4419.                                        67
  4420.  
  4421.  
  4422.  
  4423.  
  4424.  
  4425.  
  4426.             Response: VT102 ..................... ESC [ ? 6 c
  4427.  
  4428.      Notes:
  4429.  
  4430.           ESC  is  used  to  represent  the escape character, decimal 27.  Pn
  4431.           represents a variable numeric parameter, the parameter is a decimal
  4432.           number transmitted  to the  program by  using ASCII characters.  Pl
  4433.           represents the  LINE,  and  Pc  represents  the  COLUMN,  these are
  4434.           numeric parameters  sent using ASCII characters.  Pt represents the
  4435.           TOP LINE of a scrolling region, and Pb  represents the  BOTTOM LINE
  4436.           of  a  scrolling  region,  these  are numeric parameters sent using
  4437.           ASCII characters.  The spaces shown  are for  readability, they are
  4438.           not sent by the host.
  4439.  
  4440.           When "Origin  Mode" is set, the cursor is confined to the scrolling
  4441.           region.  Whenever a change takes  place in  the "Origin  Mode", the
  4442.           cursor is  moved to the home position.  The cursor is also moved to
  4443.           the home position  whenever  a  change  is  made  in  the scrolling
  4444.           region.
  4445.  
  4446.  
  4447.  
  4448.  
  4449.  
  4450.  
  4451.  
  4452.  
  4453.  
  4454.  
  4455.  
  4456.  
  4457.  
  4458.  
  4459.  
  4460.  
  4461.  
  4462.  
  4463.  
  4464.  
  4465.  
  4466.  
  4467.  
  4468.  
  4469.  
  4470.  
  4471.  
  4472.  
  4473.  
  4474.  
  4475.  
  4476.  
  4477.  
  4478.  
  4479.  
  4480.  
  4481.  
  4482.  
  4483.  
  4484.  
  4485.                                        68
  4486.  
  4487.  
  4488.  
  4489.  
  4490.  
  4491.  
  4492.      ANSI Emulation - Transmitted Characters
  4493.      ---------------------------------------
  4494.      Function Keys .............................. User Programmable.
  4495.      End ........................................ ESC O R
  4496.      Ctrl-End ................................... ESC O S
  4497.      Del ........................................ DEL
  4498.      Ins ........................................ ESC O n
  4499.      Home ....................................... ESC [ H
  4500.      PgUp ....................................... ESC [ O r
  4501.      PgDn ....................................... ESC [ O q
  4502.      Shift-Tab .................................. ESC [ O x
  4503.      Left Arrow ................Normal........... ESC [ C
  4504.                                 Keypad Mode...... ESC O C
  4505.      Right Arrow ...............Normal........... ESC [ D
  4506.                                 Keypad Mode...... ESC O D
  4507.      Up Arrow ..................Normal........... ESC [ A
  4508.                                 Keypad Mode...... ESC O A
  4509.      Down Arrow ................Normal........... ESC [ B
  4510.                                 Keypad Mode...... ESC O B
  4511.      Others ..................................... Standard Values.
  4512.  
  4513.      Note: The blanks are included for readability only.
  4514.  
  4515.  
  4516.  
  4517.  
  4518.  
  4519.  
  4520.  
  4521.  
  4522.  
  4523.  
  4524.  
  4525.  
  4526.  
  4527.  
  4528.  
  4529.  
  4530.  
  4531.  
  4532.  
  4533.  
  4534.  
  4535.  
  4536.  
  4537.  
  4538.  
  4539.  
  4540.  
  4541.  
  4542.  
  4543.  
  4544.  
  4545.  
  4546.  
  4547.  
  4548.  
  4549.  
  4550.  
  4551.                                        69
  4552.  
  4553.  
  4554.  
  4555.  
  4556.  
  4557.  
  4558.      Support For USRobotics Courier 2400
  4559.      -----------------------------------
  4560.      Here are the proper switch settings for the Courier modem:
  4561.  
  4562.      Switch    Setting
  4563.      ------    -------
  4564.        1       UP, Normal DTR.  This is not the factory setting, so it should
  4565.                be changed by the user.  GT requires  this setting  for proper
  4566.                operation of  the host  mode.   In terminal  mode, GT does not
  4567.                require this switch  setting.    Instead,  you  can  specify a
  4568.                hang-up string in the configuration area.
  4569.  
  4570.        2       Doesn't matter  to GT.   Use  the Vn command in the modem init
  4571.                strings to get proper setting.
  4572.  
  4573.        3       DOWN, Result Codes are displayed.
  4574.  
  4575.        4       DOWN, No Command Echo.   Again,  this  is  preferred,  but not
  4576.                required.
  4577.  
  4578.        5       Doesn't matter to GT.
  4579.  
  4580.        6       UP, carrier  detect signal is present only when on-line.  This
  4581.                is not the factory setting and should be changed by the user.
  4582.  
  4583.        7       Doesn't matter to GT.
  4584.  
  4585.        8       DOWN, Use Normal AT commands.
  4586.  
  4587.        9       Doesn't matter to GT.
  4588.  
  4589.        10      Doesn't matter to GT.
  4590.  
  4591.      Quad Switch
  4592.                UP, Use Normal Pin Assignments.
  4593.  
  4594.  
  4595.  
  4596.  
  4597.  
  4598.  
  4599.  
  4600.  
  4601.  
  4602.  
  4603.  
  4604.  
  4605.  
  4606.  
  4607.  
  4608.  
  4609.  
  4610.  
  4611.  
  4612.  
  4613.  
  4614.  
  4615.  
  4616.  
  4617.                                        70
  4618.  
  4619.  
  4620.  
  4621.  
  4622.  
  4623.  
  4624.      USRobotics Courier HST, 9600 Baud Modem Support.
  4625.      ------------------------------------------------
  4626.      The switch settings for the HST modem are much the  same as  the Courier
  4627.      2400 baud  modem above, so I will not discuss them.  The main difference
  4628.      between these two modems falls into three catagories:
  4629.  
  4630.      1.   Init String Usage.
  4631.  
  4632.           The HST modem supports a variety of '&' commands that can be placed
  4633.           into the init string.  The standard values for use with GT are &M4,
  4634.           &H1, and &B0.  These values  should be  added both  to the terminal
  4635.           and host mode init strings.
  4636.  
  4637.      2.   Configuration Setup.
  4638.  
  4639.           When  used  with  any  modem  that uses MNP or ARQ error correction
  4640.           technology, GT should have the "Honor CTS from modem" parameter set
  4641.           = TRUE.   In  this way, GT will stop sending data to the modem when
  4642.           the CTS signal is lowered.
  4643.  
  4644.      3.   19200 Baud Rate.
  4645.  
  4646.           When using the 19200  baud rate,  GT will  not fallback  to a lower
  4647.           rate at  CONNECT time.   This  means that  the init strings must be
  4648.           changed to include &B1,  which signals  the modem  that the cpu-to-
  4649.           modem rate  is being  held constant.  This is extremely useful when
  4650.           optimum thru-put is required.    However,  take  note  that  GT may
  4651.           overrun  the  receiving  computer  at  9600 baud.  GT is capable of
  4652.           sending at the very highest rates your computer  is capable  of and
  4653.           if the  remote computer  cannot accept the data at the higher rate,
  4654.           an overrun condition may arise.   GT  will  try  to  avoid  this by
  4655.           respecting  any  XON/XOFF  signal  sent by remote during a MegaLink
  4656.           file transfer (when the danger of overrun is the highest).
  4657.  
  4658.  
  4659.  
  4660.  
  4661.  
  4662.  
  4663.  
  4664.  
  4665.  
  4666.  
  4667.  
  4668.  
  4669.  
  4670.  
  4671.  
  4672.  
  4673.  
  4674.  
  4675.  
  4676.  
  4677.  
  4678.  
  4679.  
  4680.  
  4681.  
  4682.  
  4683.                                        71
  4684.  
  4685.  
  4686.  
  4687.  
  4688.  
  4689.  
  4690.      Hayes 2400 Initialization String
  4691.      --------------------------------
  4692.      The Hayes 2400 baud modems do not have any switches that need  to be set
  4693.      on  the  board  with  the  exception  of the port select switch which is
  4694.      accessible on the end plate itself.  All settings that would normally be
  4695.      set by switches are program selectable and, once set, they may be stored
  4696.      into a writable ROM on the card itself for further use.
  4697.  
  4698.      Following are the Modem  Initialization string  contents that  have been
  4699.      found to work satisfactorily when using GT POWER:
  4700.  
  4701.           ATE0V0X4S0=0L2S2=43&C1&D2M1&W|
  4702.  
  4703.      Note, that  though it  is undocumented, it has been found that including
  4704.      the following will dramatically increase dialing speed of the modem:
  4705.  
  4706.           S11=55
  4707.  
  4708.      Also, the above string may have embedded blanks without affect.
  4709.  
  4710.      Following are the Host Mode initialization settings that have been found
  4711.      to work in GT POWER:
  4712.  
  4713.           AT V0 Q0 E0 X4 S0=1 S2=255 M0|
  4714.  
  4715.      The above  settings show the use of 'TERSE' result codes from the modem.
  4716.      As was pointed out in an earlier part  of this  documentation, 'VERBOSE'
  4717.      result codes  are preferable.   The  use of  TERSE mode  (as selected by
  4718.      setting V0 rather than V1) was shown here to give you a complete picture
  4719.      of both  ways of  setting up your system.  The standard (default) result
  4720.      code table distributed with GT POWER  assumes VERBOSE  mode.  Therefore,
  4721.      if you select TERSE mode you will have to change that table as follows:
  4722.  
  4723.                        Description          Code
  4724.                     =================    ==========
  4725.                      1. OK ................. 0
  4726.                      2. CONNECT ............ 1
  4727.                      3. RING ............... 2
  4728.                      4. NO CARRIER ......... 3
  4729.                      5. ERROR .............. 4
  4730.                      6. CONNECT 1200 ....... 5
  4731.                      7. NO DIAL TONE ....... 6
  4732.                      8. BUSY ............... 7
  4733.                      9. NO ANSWER .......... 8
  4734.                     10. CONNECT 2400 ....... 10
  4735.                     11. RINGING ............ N/A
  4736.                     12. VOICE .............. N/A
  4737.                     13. CONNECT 9600 ....... N/A
  4738.                     14. CONNECT 1200/ECC ... N/A  These are the MNP & ARQ
  4739.                     15. CONNECT 2400/ECC ... N/A  result   codes,   sometimes
  4740.                     16. CONNECT 9600/ECC ... N/A  known as RELIABLE.
  4741.  
  4742.  
  4743.  
  4744.  
  4745.  
  4746.  
  4747.  
  4748.  
  4749.                                        72
  4750.  
  4751.  
  4752.  
  4753.  
  4754.  
  4755.  
  4756.      Modem Setting Strings for IBM Modems
  4757.      ------------------------------------
  4758.  
  4759.                   Baud           String
  4760.                   ----           ------
  4761.                    300           <Ctrl-N>SP 2|
  4762.                   1200           <Ctrl-N>SP 4|
  4763.  
  4764.      I do not know what the  string should  be for  people who  have IBM 2400
  4765.      baud modem, but I suspect it would be: <Ctrl-N>SP 5
  4766.  
  4767.               Data Format        String
  4768.               -----------        ------
  4769.                  7-N-1           <Ctrl-N>FO 0|
  4770.                  7-M-1           <Ctrl-N>FO 1|
  4771.                  7-E-1           <Ctrl-N>FO 4|
  4772.                  7-O-1           <Ctrl-N>FO 3|
  4773.                  8-N-1           <Ctrl-N>FO 5|
  4774.                  8-M-1           <Ctrl-N>FO 6|
  4775.                  8-E-1           <Ctrl-N>FO 9|
  4776.                  8-O-1           <Ctrl-N>FO 8|
  4777.  
  4778.  
  4779.  
  4780.  
  4781.  
  4782.  
  4783.  
  4784.  
  4785.  
  4786.  
  4787.  
  4788.  
  4789.  
  4790.  
  4791.  
  4792.  
  4793.  
  4794.  
  4795.  
  4796.  
  4797.  
  4798.  
  4799.  
  4800.  
  4801.  
  4802.  
  4803.  
  4804.  
  4805.  
  4806.  
  4807.  
  4808.  
  4809.  
  4810.  
  4811.  
  4812.  
  4813.  
  4814.  
  4815.                                        73
  4816.  
  4817.  
  4818.  
  4819.  
  4820.  
  4821.  
  4822.      Registration Message
  4823.      --------------------
  4824.      Dear GT User:                                               4-20-88
  4825.  
  4826.      I  know you are asking yourself,  "Why should I send a contribution
  4827.      for GT"?   Here are a few answers.
  4828.  
  4829.      1.   The shareware copy of GT has a delay at the start of the program.
  4830.           When you register you will receive a key that will allow an you
  4831.           to enter the program quickly.
  4832.  
  4833.      2.   You will receive a registered copy of GT, with your own serial
  4834.           number.   If  you distribute GT,  and someone  registers  your
  4835.           serial number,  you will get a split of the contribution.  For
  4836.           every  copy  registered  with your  serial  number,  you  will
  4837.           receive 25% of the amount tendered.
  4838.  
  4839.      3.   You will receive a copy of the latest version of the companion
  4840.           program, Sysop Tools.
  4841.  
  4842.      4.   You will receive a copy of "Turbo CALC".  This is the powerful
  4843.           spreadsheet program from P & M Software Co.
  4844.  
  4845.      5.   You will receive copies of the latest GT netmail programs, which
  4846.           will allow you to pass electronic mail along the GT netmail system.
  4847.           NOTE: the GT netmail programs are not shareware and can only be
  4848.           obtained thru registration of GT.
  4849.  
  4850.      6.   Registered users can upgrade to the latest version for $15.
  4851.  
  4852.      5.   Phone  support  is available to registered  users,  have  your
  4853.           serial  # handy when you call.   The number is 713-728-4313
  4854.           voice, 713-772-2090 & 713-778-9471 modem.  The modem lines are
  4855.           open 24 hours a day, the voice line is available during normal
  4856.           office hours, 8 - 5 pm Central Time.
  4857.  
  4858.      6.   A key will be provided to registered users,  so that the
  4859.           opening  copyright screen will remove itself automatically.
  4860.           In the spirit of shareware,  we ask that the key not be disclosed
  4861.           to  non-registered users.
  4862.  
  4863.      7.   You  will  receive a live program,  supported by  its  author.
  4864.           Continued support of GT or any other "User Supported"  program
  4865.           depends on the financial support of its users.   Pure survival
  4866.           of the best and fittest.
  4867.  
  4868.      To show our intention to support our products, we are proud to offer
  4869.      our new customers a 30 day money back guarantee.
  4870.  
  4871.      If you wish to register,  or if you are already registered and wish
  4872.      to upgrade to the latest version of GT,  please fill out and return
  4873.      he following form:
  4874.  
  4875.  
  4876.  
  4877.  
  4878.  
  4879.  
  4880.  
  4881.                                        74
  4882.  
  4883.  
  4884.  
  4885.  
  4886.  
  4887.  
  4888.    -------------------------------------------------------------------------
  4889.    :                                                                       :
  4890.    :                             GT POWER                                  :
  4891.    :                         Registration Form                             :
  4892.    :                                                                       :
  4893.    :                                                                       :
  4894.    :   Date: __________                    TO:  P & M Software Co.         :
  4895.    :                                            9350 Country Creek #30     :
  4896.    :                                            Houston, Tx  77036         :
  4897.    :                                            U.S.A.                     :
  4898.    :                                                                       :
  4899.    :                                                                       :
  4900.    :   FROM:     Name: ________________________________________            :
  4901.    :                                                                       :
  4902.    :          Address: ________________________________________            :
  4903.    :                                                                       :
  4904.    :                   ________________________________________            :
  4905.    :                                                                       :
  4906.    :                   ________________________________________            :
  4907.    :                                                                       :
  4908.    :          Work Phone # (_____)_______________________                  :
  4909.    :                                                                       :
  4910.    :          Home Phone # (_____)_______________________                  :
  4911.    :                                                                       :
  4912.    :                                                                       :
  4913.    :   CHECK VERSION(S) OF GT POWER WANTED:                                :
  4914.    :       1 selection no extra charge, additional selections, $6 each.    :
  4915.    :                                                                       :
  4916.    :          ____ PC, XT and close compatibles (non-overlaid).            :
  4917.    :                                                                       :
  4918.    :          ____ PC, XT and close compatibles (overlaid).                :
  4919.    :                                                                       :
  4920.    :          ____ AT (80286) and close compatibles (non-overlaid).        :
  4921.    :                                                                       :
  4922.    :          ____ FOSSIL version, for T2k and others (non-overlaid).      :
  4923.    :                                                                       :
  4924.    :   NOTE: Each selection above includes copies of GT and GTO.           :
  4925.    :                                                                       :
  4926.    :                                                                       :
  4927.    :   CHECK DESIRED SELECTION(S):                                         :
  4928.    :                                                                       :
  4929.    :   ____ Initial registration of GT POWER.  $60 U.S. suggested price.   :
  4930.    :           Includes an upgrade to latest version.                      :
  4931.    :                                                                       :
  4932.    :   ____ Upgrade to current version of GT POWER.  $15 U.S.              :
  4933.    :           For registered users to upgrade to latest version.          :
  4934.    :                                                                       :
  4935.    :   ____ Enter standing order.  Available to credit card customers.     :
  4936.    :           All upgrades sent automatically.  Bug fixes free.           :
  4937.    :           Feature releases will be charged to customer at $15 each.   :
  4938.    :                                                                       :
  4939.    :                           Page 1 of 2                                 :
  4940.    -------------------------------------------------------------------------
  4941.  
  4942.  
  4943.  
  4944.  
  4945.  
  4946.  
  4947.                                      75
  4948.  
  4949.  
  4950.  
  4951.  
  4952.  
  4953.  
  4954.    -------------------------------------------------------------------------
  4955.    :                                                                       :
  4956.    :   PLEASE INDICATE SERIAL # AND VERSION OF PROGRAM YOU HAVE:           :
  4957.    :            (Press ALT-J to display serial number.)                    :
  4958.    :                                                                       :
  4959.    :            Serial # _____________        Version #  14.02             :
  4960.    :                                                                       :
  4961.    :                                                                       :
  4962.    :   PLEASE INDICATE AMOUNT ENCLOSED:                                    :
  4963.    :                                                                       :
  4964.    :            Base contribution amount .......... __________             :
  4965.    :                                                                       :
  4966.    :            Extra versions, add $6 per copy ... __________             :
  4967.    :               From check-list above.                                  :
  4968.    :                                                                       :
  4969.    :            For 3.5" diskettes, add $5 ........ __________             :
  4970.    :                                                                       :
  4971.    :            TEXAS residents, 8% sales tax ..... __________             :
  4972.    :                                                                       :
  4973.    :            Outside NORTH AMERICA, add $4                              :
  4974.    :               for AIR MAIL postage ........... __________             :
  4975.    :                                                                       :
  4976.    :            Total Enclosed (U.S. DOLLARS) .....                        :
  4977.    :                                                ==========             :
  4978.    :                                                                       :
  4979.    :   PLEASE INDICATE METHOD OF PAYMENT:                                  :
  4980.    :                                                                       :
  4981.    :      If using credit card, please indicate your card no. and          :
  4982.    :      expiration date.  On MasterCard(r) include the Interbank No.     :
  4983.    :                                                                       :
  4984.    :   ___ MasterCard(r)    Interbank No.   _____________                  :
  4985.    :   ___ Visa                                                            :
  4986.    :   ___ Check            Credit Card No. ___________________________    :
  4987.    :   ___ Money Order                                                     :
  4988.    :                        Expiration Date _____________                  :
  4989.    :                                                                       :
  4990.    :                                                                       :
  4991.    :   Please DO NOT send cash.  Send check, money order, or credit card   :
  4992.    :   information.  Your request will be filled promptly upon receipt.    :
  4993.    :                                                                       :
  4994.    :   Customers residing outside the United States of America should      :
  4995.    :   send payment in the form of a check drawn in U.S. DOLLARS on a      :
  4996.    :   New York City bank or use one of the credit cards listed above.     :
  4997.    :                                                                       :
  4998.    :                            Page 2 of 2                                :
  4999.    -------------------------------------------------------------------------
  5000.  
  5001.                                 - THE END -
  5002.  
  5003.  
  5004.  
  5005.  
  5006.  
  5007.  
  5008.  
  5009.  
  5010.  
  5011.  
  5012.                                      76
  5013.