home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / COMM / MISC / BGFT211.ZIP / BGFT.DOC < prev    next >
Encoding:
Text File  |  1991-05-02  |  173.0 KB  |  4,053 lines

  1.  
  2.  
  3.  
  4.  
  5.         ORDERING INFORMATION: BGFT (BackGround File Transfer)
  6.  
  7.              The  programs run on IBM compatible PCs, XTs, and  ATs  with
  8.         DOS  version 2.2 or higher. They are distributed on a  5.25  inch
  9.         DOS floppy disk which is sent by first class mail in a protective
  10.         mailer.  All  shipping  and handling costs are  included  in  the
  11.         purchase price.
  12.              Purchasing the software entitles the registrant to fair  use
  13.         of  BGFT (TM) and associated files. Copying the  registered  pro-
  14.         grams for the purpose of giving or selling the program to  others
  15.         violates Dirac Systems' copyright.
  16.              Please  allow  sufficient time for checks to clear  and  the
  17.         mail to get through.
  18.              We  hope that you will find BGFT very useful and will  enjoy
  19.         using it. Thank you!
  20.              Send  $29.50 Canadian (Ontario residents add the  Provincial
  21.         sales tax) by check or by money order payable to 'Dirac Systems':
  22.                                   Dirac Systems
  23.                                   P. O. Box 476
  24.                                   West Hill, ON
  25.                                   CANADA M1E4Y9
  26.         You  can also use Visa [ ] or MasterCard [ ] (check one);  please
  27.         print the following account information:
  28.  
  29.         Card Number: ____________________________________________________
  30.  
  31.         Expiry Date: ___/___  Signature:_________________________________
  32.  
  33.         Authorized User's Name: _________________________________________
  34.  
  35.         Area Code: (______)  Phone Number: ______________________________
  36.  
  37.         Please provide the following mailing information:
  38.  
  39.         Name:    ________________________________________________________
  40.  
  41.         Address: ________________________________________________________
  42.  
  43.                  ________________________________________________________
  44.  
  45.         City:    ________________________________________________________
  46.  
  47.         Province/State: _________________________________________________
  48.  
  49.         Country: _______________________  Postal/Zip Code: ______________
  50.  
  51.         Quantity ordered ___________ @ CAN $29.50 = Cost $ ______________
  52.  
  53.              Province of Ontario residents add sales tax $ ______________
  54.  
  55.                                           Total Enclosed $ ______________
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.                                     BGFT (TM)
  73.  
  74.                                   Version 2.11
  75.  
  76.  
  77.  
  78.  
  79.  
  80.                         A BackGround File Transfer System
  81.  
  82.  
  83.  
  84.                                Rick MacDonald, MSc
  85.  
  86.                                 Rafael Moya, PhD
  87.  
  88.                                 Tim Chapman, PhD
  89.  
  90.  
  91.                                   Dirac Systems
  92.                                   P. O. Box 476
  93.                                   West Hill, ON
  94.                                   CANADA M1E4Y9
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.                       Copyright (c) 1990-1991 Dirac Systems  \ /
  104.                       ------------------------------------- - o -
  105.                                                              / \
  106.  
  107.         TABLE OF CONTENTS
  108.         -----------------
  109.  
  110.         1. Introduction . . . . . . . . . . . . . . . . . . . . 1
  111.            1.1 Concept. . . . . . . . . . . . . . . . . . . . . 2
  112.            1.2 Registered User Support. . . . . . . . . . . . . 3
  113.            1.3 Why Register?. . . . . . . . . . . . . . . . . . 4
  114.         2. Red Tape . . . . . . . . . . . . . . . . . . . . . . 6
  115.            2.1 Disclaimer of Warranty . . . . . . . . . . . . . 6
  116.            2.2 Copyright Notice . . . . . . . . . . . . . . . . 6
  117.         3. Getting Started. . . . . . . . . . . . . . . . . . . 8
  118.            3.1 Files in the Distribution. . . . . . . . . . . . 8
  119.            3.2 Trying it Out. . . . . . . . . . . . . . . . . . 11
  120.         4. Installation . . . . . . . . . . . . . . . . . . . . 17
  121.            4.1 The Resident Programs                            17
  122.            4.2 The User Interface: BGFT.EXE . . . . . . . . . . 18
  123.               4.2.1 Organizing the Files. . . . . . . . . . . . 18
  124.               4.2.2 Setting Up the Environment. . . . . . . . . 19
  125.               4.2.3 Setting Up Your Modem . . . . . . . . . . . 20
  126.         5. Operation. . . . . . . . . . . . . . . . . . . . . . 21
  127.            5.1 Starting BGFT. . . . . . . . . . . . . . . . . . 21
  128.            5.2 The Menu System and Mouse Support. . . . . . . . 22
  129.            5.3 Data Entry Forms . . . . . . . . . . . . . . . . 24
  130.            5.4 The Help System. . . . . . . . . . . . . . . . . 25
  131.            5.5 Configuring BGFT . . . . . . . . . . . . . . . . 25
  132.               5.5.1 Colors. . . . . . . . . . . . . . . . . . . 25
  133.               5.5.2 Modem Parameters. . . . . . . . . . . . . . 26
  134.               5.5.3 Communication Port Settings . . . . . . . . 28
  135.               5.5.4 Options . . . . . . . . . . . . . . . . . . 30
  136.               5.5.5 More Options. . . . . . . . . . . . . . . . 32
  137.            5.6 Terminal Mode. . . . . . . . . . . . . . . . . . 32
  138.            5.7 Background Dialing . . . . . . . . . . . . . . . 33
  139.            5.8 Background File Transfer . . . . . . . . . . . . 38
  140.               5.8.1 The File Buffer . . . . . . . . . . . . . . 38
  141.               5.8.2 Downloading . . . . . . . . . . . . . . . . 39
  142.               5.8.3 Manually Moving Downloaded Files. . . . . . 39
  143.               5.8.4 Preparing Files For Uploading . . . . . . . 40
  144.               5.8.5 Uploading . . . . . . . . . . . . . . . . . 41
  145.            5.9 Utility Functions. . . . . . . . . . . . . . . . 42
  146.            5.10 Exiting BGFT. . . . . . . . . . . . . . . . . . 45
  147.            5.11 External Protocols. . . . . . . . . . . . . . . 45
  148.         6. Appendices . . . . . . . . . . . . . . . . . . . . . 50
  149.            6.1 Error Messages . . . . . . . . . . . . . . . . . 50
  150.            6.2 Alt_Key Summary. . . . . . . . . . . . . . . . . 51
  151.            6.3 Multitasking and Communications. . . . . . . . . 52
  152.            6.4 BGFT and DESQview. . . . . . . . . . . . . . . . 53
  153.            6.5 BGFT and Microsoft Windows . . . . . . . . . . . 54
  154.            6.6 Systems Without a Hard Drive . . . . . . . . . . 55
  155.            6.7 Problem Solving. . . . . . . . . . . . . . . . . 55
  156.            6.8 Operating Limitations. . . . . . . . . . . . . . 56
  157.            6.9 Nomenclature . . . . . . . . . . . . . . . . . . 56
  158.            6.10 Command Mode Options Using BGFTOPT.EXE. . . . . 57
  159.         Index . . . . . . . . . . . . . . . . . . . . . . . . . 64
  160.  
  161.  
  162.  
  163.         1. Introduction
  164.         ---------------
  165.  
  166.         BGFT  is  an  extraordinary  file transfer  system  for  the  IBM
  167.         PC/XT/AT. It allows files to be transferred over a serial  commu-
  168.         nications  link, in the 'background', while the PC is being  used
  169.         for  other purposes. Files can be transferred by downloading,  or
  170.         uploading,  using  either the Xmodem-CRC, Xmodem-1K,  or  Ymodem-
  171.         Batch file transfer protocol. This means, that when you  transfer
  172.         files  by modem, to or from your favorite Bulletin Board  Service
  173.         (BBS),  you  can be writing a letter with  your  word  processor,
  174.         updating  your  financial statement with a spreadsheet  or  doing
  175.         most of the other things that are possible with your computer.
  176.  
  177.         What  makes BGFT special? BGFT works in the background. It  over-
  178.         comes  traditional background conflicts with the  Disk  Operating
  179.         System  (DOS). Drive A:, or B:, is used as a special download  or
  180.         upload  'file buffer' for BGFT; meanwhile, DOS is freed up to  be
  181.         used by other application programs.
  182.  
  183.         A  convenient background dialer also makes the package ideal  for
  184.         accessing busy BBSs.
  185.  
  186.         The  background features of BGFT can be used with other  suitable
  187.         telecommunication packages like Qmodem, PROCOMM PLUS, and  Telix.
  188.         Script files are provided for them. BGFT is versatile.
  189.  
  190.         BGFT is also Windows 3 compatible. It is usually not possible  to
  191.         run  a background DOS program while running a Windows program  in
  192.         the foreground on a 286 computer. BGFT can do it, even with  8086
  193.         computers;  this cannot be said for most telecommunication  pack-
  194.         ages. A Windows program is provided to show BGFT's file  transfer
  195.         progress while running Windows applications.
  196.  
  197.         BGFT  also  works well with multitasking systems  like  DESQview,
  198.         particularly on computers with limited memory. BGFT is compact.
  199.  
  200.         BGFT  comes  as a standalone telecommunications system and  in  a
  201.         form for specialized uses; it requires only MS DOS Version 2.2 or
  202.         greater to operate.
  203.  
  204.         BGFT  is being marketed as Shareware with a registration  fee  of
  205.         $29.50  Canadian (Ontario residents add sales tax,  the  Canadian
  206.         Federal  Government's  Goods and Services Tax is  not  required).
  207.         Check, Visa or MasterCard are accepted.
  208.  
  209.         BGFT  is available from Dirac Systems directly. It is sent  in  a
  210.         protective mailer by first class mail and all delivery costs  are
  211.         included. Dirac Systems' address is:
  212.  
  213.  
  214.  
  215.  
  216.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 1
  217.         -------------------------------------------- - o -
  218.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  219.  
  220.  
  221.  
  222.                                   Dirac Systems
  223.                                   P. O. Box 476
  224.                                   West Hill, ON
  225.                                   CANADA M1E4Y9
  226.  
  227.         The  registered and unregistered package for BGFT share  all  the
  228.         same features described above. The only difference is that  there
  229.         is no initial screen on the registered executable files, BGFT.EXE
  230.         and BGFTOPT.EXE. Otherwise, all files are identical.
  231.  
  232.         1.1 Concept
  233.         -----------
  234.  
  235.         BGFT started as a program written by one of the authors who could
  236.         not  stand waiting to use his computer while it  was  downloading
  237.         files.  That  prototype  was in use for over two  years  and  did
  238.         thousands  of background file transfers with a slow 4.77 MHz  IBM
  239.         PC  clone and a 1200 baud modem. That program was developed  into
  240.         the BGFT presented here which was first released commercially  in
  241.         January 1990.
  242.  
  243.         BGFT  is intended to provide efficient background file  transfers
  244.         on  ordinary personal computers. It works well on IBM  PCs,  XTs,
  245.         ATs and compatibles. A 1200 or 2400 baud modem is ideal  although
  246.         baud rates up to 9600 are supported.
  247.  
  248.         The  emphasis of BGFT is on performing background file  transfers
  249.         and  not on being a full featured telecommunications program.  In
  250.         most  cases, however, BGFT will serve as complete  communications
  251.         program.  It  has  many of the important  features  like  config-
  252.         urability, dialing directory maintenance, menuing system,  color,
  253.         context sensitive help, mouse control, connectivity to communica-
  254.         tion  ports  1  to  4, terminal  emulations  and  so  on.  BGFT's
  255.         background  dialer will be a superior choice for  accessing  busy
  256.         BBSs since the user can do something else with the computer while
  257.         waiting for a connection.
  258.  
  259.         BGFT  is a communications environment that actually  consists  of
  260.         two  programs;  one  operates in the background and  one  in  the
  261.         foreground. The first, a small terminate and stay resident  (TSR)
  262.         program,  BGFT360K.COM or BGFT720K.COM, acts as a  file  transfer
  263.         'driver'  which  is  capable  of  carrying  out  background  file
  264.         transfers independently once it has been commanded to do so by  a
  265.         foreground  program. The main foreground program, BGFT.EXE,  acts
  266.         as a stand alone user interface to control the resident program's
  267.         operation.  Another  foreground program,  BGFTOPT.EXE,  interacts
  268.         with  the resident in terms of command line options; it  is  used
  269.         for   specialized   applications  such  as   providing   external
  270.         background protocols for other telecommunication programs.
  271.  
  272.         BGFT is a robust background program. BGFT360K.COM or BGFT720K.COM
  273.  
  274.  
  275.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 2
  276.         -------------------------------------------- - o -
  277.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  278.  
  279.  
  280.  
  281.         has  a  special way of avoiding DOS conflicts that  have  plagued
  282.         other   background  utilities.  In  the  technical   sense,   the
  283.         background driver for BGFT is unusual because it does not use DOS
  284.         calls;  therefore,  it does not have to wait until  a  foreground
  285.         program finishes using DOS. This enables BGFT to run concurrently
  286.         with other programs that use DOS.
  287.  
  288.         The  advantages of this approach are easily demonstrated.  Simply
  289.         print  out  a text file using the DOS PRINT command, which  is  a
  290.         background  driver that uses DOS. Then use the DOS TYPE  command,
  291.         which is a foreground program that uses DOS, to view a long  text
  292.         file.  After a few seconds, the printing will stop due to  a  DOS
  293.         conflict,  and  will remain stopped until the  type  command  has
  294.         finished. This type of operation obviously is not suitable for  a
  295.         file  transfer  program since the file transfer  would  time  out
  296.         under these conditions.
  297.  
  298.         The present design of BGFT uses the concept of a file buffer. The
  299.         file buffer is on a DOS formatted diskette, specially initialized
  300.         by BGFT, in the floppy drive A: or B:. It is written to, and read
  301.         from,  by  BGFT360K.COM  or BGFT720K.COM.  Downloaded  files  are
  302.         stored  temporarily in the file buffer and moved to DOS files  on
  303.         the  hard  disk or second floppy drive under user  control,  with
  304.         BGFT.EXE or BGFTOPT.EXE. Files to be uploaded are first moved  to
  305.         the  file  buffer with the foreground program, then  accessed  by
  306.         BGFT360K.COM  or BGFT720K.COM while uploading. The design of  the
  307.         user interface is such that the use of the file buffer is  nearly
  308.         transparent to the user.
  309.  
  310.         1.2 Registered User Support
  311.         ---------------------------
  312.  
  313.         Registered user support is available via Dirac Systems' BBS;  the
  314.         telephone number is modem (416) 283-7157.
  315.  
  316.         You may also write to us at:
  317.  
  318.                                   Dirac Systems
  319.                                   P. O. Box 476
  320.                                   West Hill, ON
  321.                                   CANADA M1E4Y9
  322.  
  323.         Dirac  Systems  will answer your questions, to help you  get  the
  324.         most  out of BGFT; registered users will get preferential  atten-
  325.         tion.  Also, Dirac Systems will consider making changes  to  suit
  326.         your needs. Try giving us a call.
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 3
  335.         -------------------------------------------- - o -
  336.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  337.  
  338.  
  339.  
  340.         We  support BGFT on CompuServe; there are two membership  numbers
  341.         that you can contact:
  342.  
  343.              72570,2633 (Tim Chapman)
  344.              73670,2424 (Rick MacDonald)
  345.  
  346.         Dirac  Systems is also pleased to join, with the good  graces  of
  347.         Canada  Remote Systems (CRS), to offer unparalleled  BBS  support
  348.         throughout North America. Users of our products can send Email to
  349.         the "Shareware Authors" or "Vendors" conferences on NorthAmeriNet
  350.         (NANET).  Address inquiries to Rick MacDonald or Tim  Chapman  on
  351.         CRS  in  the Toronto, Ontario area. You can also  contact  Rafael
  352.         Moya on the Rose Media BBS in Toronto.
  353.  
  354.         We can also be reached through the UUCP mail network via CRS. Our
  355.         Email addresses are:
  356.  
  357.              canrem!rick.macdonald
  358.              canrem!tim.chapman
  359.  
  360.         or as:
  361.  
  362.              rick.macdonald@canrem.uucp
  363.              tim.chapman@canrem.uucp
  364.  
  365.  
  366.         Use the second format when sending UUCP mail from non-UUCP  sites
  367.         (eg. from BITNET or from Internet); it is more likely to succeed.
  368.  
  369.         Rick MacDonald also has the Email address:
  370.  
  371.              macdon@ists.ists.ca
  372.  
  373.         1.3 Why Register?
  374.         -----------------
  375.  
  376.         There are a number of reasons you should register.
  377.  
  378.         As  you  can see from the last Section, there will  be  extensive
  379.         user support.
  380.  
  381.         The  registered  version  of  BGFT360K.COM  or  BGFT720K.COM  are
  382.         uniquely serialized and replace the unregistered ones. This  will
  383.         get  rid  of  the opening screens  advertising  the  registration
  384.         request on the foreground programs.
  385.  
  386.         We  are marketing BGFT through the Shareware method. You  get  to
  387.         evaluate  its  full capabilities on a fair trial basis.  This  is
  388.         beneficial to the customer because he or she can determine wheth-
  389.         er the software product fulfills a need on their own hardware.
  390.  
  391.  
  392.  
  393.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 4
  394.         -------------------------------------------- - o -
  395.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  396.  
  397.  
  398.  
  399.         We  expect you to register the software if you are going to  con-
  400.         tinue to use it after the trial. This shows that the product  has
  401.         value.  It is the moral and financial responsibility of the  user
  402.         to then pay for registration.
  403.  
  404.         We  are  able to offer a superior product at a low  cost  due  to
  405.         Shareware.  Many hours of labor are spent in its  production  and
  406.         continuing  support.  A  fair return is our  measure  of  product
  407.         value.
  408.  
  409.         The  authors want to support you and BGFT in the future but  must
  410.         have user patronage to do it.
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  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.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 5
  453.         -------------------------------------------- - o -
  454.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  455.  
  456.  
  457.  
  458.         2. Red Tape
  459.         -----------
  460.         2.1 Disclaimer of Warranty
  461.         --------------------------
  462.  
  463.         This  software  and documentation are sold 'as  is'  and  without
  464.         warranties  as  to performance of merchantability  or  any  other
  465.         warranties  whether expressed or implied. Because of the  various
  466.         hardware and software environments into which these programs  may
  467.         be  put, no warranty of fitness for a particular purpose  is  of-
  468.         fered.
  469.  
  470.         Good data processing procedure dictates that any program be thor-
  471.         oughly  tested with non-critical data before relying on  it.  The
  472.         user  must assume the entire risk of using the program.  Any  li-
  473.         ability  of  the seller will be limited  exclusively  to  product
  474.         replacement or refund of purchase price.
  475.  
  476.         2.2 Copyright Notice
  477.         --------------------
  478.  
  479.         The BGFT package includes the following executable programs:
  480.  
  481.         BGFT360K.COM   Resident program for use with a 360K file buffer.
  482.         BGFT720K.COM   Resident program for use with a 720K file buffer.
  483.         BGFT.EXE       Main foreground program to control residents.
  484.         BGFTOPT.EXE    Command line foreground program for residents.
  485.         BGFTSPY.EXE    Windows 3 application to monitor file transfers.
  486.         BGFTFLPY.EXE   Puts BGFT initialized floppy back to DOS floppy.
  487.         BGFTDIR.COM    Directory lister for BGFT or DOS floppies.
  488.         BGFTXDLG.EXE   PROCOMM/Telix/Qmodem phone directories to BGFT.
  489.  
  490.         Other support files are:
  491.  
  492.         BGFTREAD.ME    Latest BGFT notes and revision histories.
  493.         BGFTORDR.FRM   Order form for registering BGFT package.
  494.         BGFT.DOC       BGFT full documentation; this file.
  495.         BGFT.HLP       BGFT.EXE help screens.
  496.         BGFT.SCR       Other BGFT.EXE screens.
  497.         BGFT.DLG       Sample BGFT dialing directory.
  498.         BGFTINIT.BAT   Initialize resident's baud rate and COM port.
  499.  
  500.         PROCOMM PLUS Specific:
  501.  
  502.         BGFTDXPC.ASP   PROCOMM PLUS script for Xmodem-CRC/1K download.
  503.         BGFTDYPC.ASP   PROCOMM PLUS script for Ymodem-Batch download.
  504.         BGFTUXPC.ASP   PROCOMM PLUS script for Xmodem-CRC upload.
  505.         BGFTUIPC.ASP   PROCOMM PLUS script for Xmodem-1K upload.
  506.         BGFTUYPC.ASP   PROCOMM PLUS script for Ymodem-Batch upload.
  507.  
  508.  
  509.  
  510.  
  511.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 6
  512.         -------------------------------------------- - o -
  513.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  514.  
  515.  
  516.  
  517.         Qmodem Specific:
  518.  
  519.         BGFTDXQM.SCR   Qmodem script for Xmodem-CRC/1K download.
  520.         BGFTDYQM.SCR   Qmodem script for Ymodem-Batch download.
  521.         BGFTUXQM.SCR   Qmodem script for Xmodem-CRC upload.
  522.         BGFTUIQM.SCR   Qmodem script for Xmodem-1K upload.
  523.         BGFTUYQM.SCR   Qmodem script for Ymodem-Batch upload.
  524.  
  525.         Telix Specific:
  526.  
  527.         BGFTADD.BAT    Batch file adds BGFT external protocols to Telix.
  528.         BGFTTELX.DAT   Data file for BGFTADD.BAT; modifies TELIX.CNF.
  529.         BGFTSLC.BAT    Batch file to compile all Telix support scripts.
  530.  
  531.         BGFTDXTL.SLT   Telix script for Xmodem-CRC/1K download.
  532.         BGFTDYTL.SLT   Telix script for Ymodem-Batch download.
  533.         BGFTUXTL.SLT   Telix script for Xmodem-CRC upload.
  534.         BGFTUITL.SLT   Telix script for Xmodem-1K upload.
  535.         BGFTUYTL.SLT   Telix script for Ymodem-Batch upload.
  536.  
  537.         Windows 3 Icon:
  538.  
  539.         BGFTSPY.ICO    Windows 3 icon for BGFTSPY.EXE.
  540.  
  541.         These  files are Copyright (c) 1990-1991 Dirac Systems, with  all
  542.         rights  reserved. These products are commercial software and  are
  543.         licensed to the registered user, and are not to be distributed in
  544.         any way, electronically or otherwise.
  545.  
  546.         The  shareware evaluation package includes all the  files  listed
  547.         above except that BGFT.EXE and BGFTOPT.EXE have special momentary
  548.         screens which inform the user about registration.
  549.  
  550.         See Section 3.1 for some fuller descriptions of the files.
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 7
  571.         -------------------------------------------- - o -
  572.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  573.  
  574.  
  575.  
  576.         3. Getting Started
  577.         ------------------
  578.  
  579.         The best way to find out about BGFT is to try it. Its online menu
  580.         and help systems make an operating manual virtually  unnecessary.
  581.         There are only a few simple setup steps and then you will be  off
  582.         and running.
  583.  
  584.         On  installing BGFT360K.COM or BGFT720K.COM, about 33K of  memory
  585.         is  used up for the resident part. This is relatively small  when
  586.         it  is  considered  that this controls the  download  and  upload
  587.         functions   in  background.  BGFT360K.COM  or  BGFT720K.COM   was
  588.         deliberately  kept small to leave you plenty of memory  for  your
  589.         foreground applications.
  590.  
  591.         Even  on  expensive multitasking systems there is  only  one  CPU
  592.         doing  all the work, so it must be shared between all  processes.
  593.         BGFT360K.COM  or  BGFT720K.COM must use some CPU time to  do  its
  594.         work; this means that your foreground programs may appear to  run
  595.         slightly  slower than their usual speed. This will depend on  the
  596.         speed of your computer and the baud rate of the file transfer.
  597.  
  598.         3.1 Files in the Distribution
  599.         -----------------------------
  600.  
  601.         The  BGFT package is distributed on a 360K floppy  diskette.  All
  602.         the  necessary files have been archived to save space;  to  unar-
  603.         chive  them see Section 4.2.1. The following files will  be  pro-
  604.         duced by the self unarchiving file, BGFT211.EXE:
  605.  
  606.         BGFT.DOC - This is the documentation file.
  607.  
  608.         BGFT360K.COM  and  BGFT720K.COM - The 'resident' portion  of  the
  609.         system.  You run one of these programs to install the  communica-
  610.         tions driver for BGFT, for the file buffer of size 360K or  720K,
  611.         as appropriate. The 720K buffer requires a 1.2 Megabyte 5.25 inch
  612.         or any 3.5 inch floppy drive, on an AT class computer. The  resi-
  613.         dent  program  uses the floppy drive A: or B:, as  selected;  see
  614.         Section 4.1.
  615.  
  616.         BGFT.EXE  - The main foreground 'interface' portion of  the  pro-
  617.         gram. It provides user control over the background file transfers
  618.         and facilitates moving files to and from the file buffer.
  619.  
  620.         BGFTFLPY.EXE  - You can fix a floppy diskette, that has  acciden-
  621.         tally  been initialized for use as a BGFT file buffer, back to  a
  622.         DOS floppy.
  623.  
  624.         BGFTDIR.COM - Indicates whether a floppy diskette in drive A:, or
  625.         B:,  is  a 'BGFT floppy' or a 'DOS floppy', and  prints  out  its
  626.         directory to the screen.
  627.  
  628.  
  629.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 8
  630.         -------------------------------------------- - o -
  631.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  632.  
  633.  
  634.  
  635.  
  636.         BGFTOPT.EXE  - Command line processor which does foreground  con-
  637.         trol  of the resident programs, similar to BGFT.EXE. BGFTOPT  can
  638.         be used as an external transfer protocol option for other  commu-
  639.         nication programs such as Qmodem, PROCOMM PLUS, and Telix. It  is
  640.         explained  in detail in Section 6.10. To see the help listing  on
  641.         how it is used, enter,
  642.  
  643.                   BGFTOPT
  644.  
  645.         or,
  646.  
  647.                   BGFTOPT /?
  648.  
  649.         For  example,  if  you want to terminate  (Kill)  the  background
  650.         dialer you would enter,
  651.  
  652.                   BGFTOPT /K
  653.  
  654.         BGFTOPT.EXE is meant for use by the expert user who has  special-
  655.         ized  applications,  such as for external  communication  program
  656.         protocols as explained in Section 5.11. It is necessary that  the
  657.         user  realize  that  the resident must be  communicated  with  in
  658.         particular  ways; for example, it should be told  the  communica-
  659.         tions  port  that is being used and the baud rate before  it  can
  660.         communicate  to the outside world (use an edited version  of  the
  661.         following batch file to do this).
  662.  
  663.         BGFTINIT.BAT - Initialize resident's baud rate and COM port.  The
  664.         file should be edited to the user's preference.
  665.  
  666.         The  main  foreground program, BGFT.EXE, protects the  user  from
  667.         most inadvertent errors by means of the configuration file. It is
  668.         also  easier to use. BGFTINIT.BAT is not required if BGFT.EXE  is
  669.         used.
  670.  
  671.         Below  is  a  list  of Telix  SALT  language  scripts  which  use
  672.         BGFTOPT.EXE  as  means to use external  BGFT  transfer  protocols
  673.         using the resident background system. Each script has comments to
  674.         indicate  its installation as an external protocol and  operation
  675.         (see  Section  5.11).  The  example ideas can  be  used  for  any
  676.         script-like  language that has adequate capability (eg,  able  to
  677.         exit without hanging up).
  678.  
  679.         BGFTDXTL.SLT   Telix script for Xmodem-CRC/1K download.
  680.         BGFTDYTL.SLT   Telix script for Ymodem-Batch download.
  681.         BGFTUXTL.SLT   Telix script for Xmodem-CRC upload.
  682.         BGFTUITL.SLT   Telix script for Xmodem-1K upload.
  683.         BGFTUYTL.SLT   Telix script for Ymodem-Batch upload.
  684.  
  685.  
  686.  
  687.  
  688.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 9
  689.         -------------------------------------------- - o -
  690.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  691.  
  692.  
  693.  
  694.         There  are a number of Telix support files; see Section  5.11  on
  695.         their use:
  696.  
  697.         BGFTADD.BAT    Batch file adds BGFT external protocols to Telix.
  698.         BGFTTELX.DAT   Data file for BGFTADD.BAT; modifies TELIX.CNF.
  699.         BGFTSLC.BAT    Batch file to compile all Telix support scripts.
  700.  
  701.         There  is also a support package for PROCOMM PLUS; it is made  up
  702.         of the following files:
  703.  
  704.         BGFTDXPC.ASP   PROCOMM PLUS script for Xmodem-CRC/1K download.
  705.         BGFTDYPC.ASP   PROCOMM PLUS script for Ymodem-Batch download.
  706.         BGFTUXPC.ASP   PROCOMM PLUS script for Xmodem-CRC upload.
  707.         BGFTUIPC.ASP   PROCOMM PLUS script for Xmodem-1K upload.
  708.         BGFTUYPC.ASP   PROCOMM PLUS script for Ymodem-Batch upload.
  709.  
  710.         There is also a support package for Qmodem; it is made up of  the
  711.         following files:
  712.  
  713.         BGFTDXQM.SCR   Qmodem script for Xmodem-CRC/1K download.
  714.         BGFTDYQM.SCR   Qmodem script for Ymodem-Batch download.
  715.         BGFTUXQM.SCR   Qmodem script for Xmodem-CRC upload.
  716.         BGFTUIQM.SCR   Qmodem script for Xmodem-1K upload.
  717.         BGFTUYQM.SCR   Qmodem script for Ymodem-Batch upload.
  718.  
  719.         BGFTXDLG.EXE - Automatically translates a Qmodem, PROCOMM PLUS or
  720.         Telix  telephone  list  to  the  BGFT  format.  The   QMODEM.FON,
  721.         PCPLUS.DIR or TELIX.FON file must be present in the directory  in
  722.         which  the BGFT.DLG file will be produced. Just run BGFTXDLG  and
  723.         choose  the  translation you want. It will inform  you  that  any
  724.         BGFT.DLG  file  in  the directory will be  overwritten;  you  can
  725.         escape  the  process, if required. A number of warnings  will  be
  726.         produced where items are found that are not appropriate for  BGFT
  727.         operation.  For example, the maximum baud rate is 9600,  so  that
  728.         higher ones are set to 9600. You can use your printer and issue a
  729.         'Ctrl_P'  to  capture the warning list; you could also  use  file
  730.         redirection  (see your DOS manual for information). Fatal  errors
  731.         occur  only  for gross file problems  or  incompatibilities  that
  732.         preclude further useful processing.
  733.  
  734.         BGFTSPY.EXE - A Windows 3 program to display information  regard-
  735.         ing  the background file transfer packet count and BGFT  resident
  736.         status.  Its  display may be used in minimized  (recommended)  or
  737.         maximized mode. An icon is provided, BGFTSPY.ICO.
  738.  
  739.         BGFT.DLG - Dialing directory file.
  740.  
  741.         BGFT.HLP - BGFT's online help file.
  742.  
  743.         BGFT.SCR - BGFT's screens.
  744.  
  745.  
  746.  
  747.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 10
  748.         -------------------------------------------- - o -
  749.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  750.  
  751.  
  752.  
  753.         BGFTORDR.FRM - The order form for purchasing BGFT.
  754.  
  755.         BGFTREAD.ME - Release notes.
  756.  
  757.         For users with a hard disk, it is recommended that these files be
  758.         located in a separate subdirectory such as '\BGFT'. This directo-
  759.         ry can be created using the DOS Make Directory command; see  your
  760.         DOS  documentation for further information on how to do  this  or
  761.         see  Section  4.2.1 below. BGFT.EXE can be told  where  its  data
  762.         files  are by means of an environment variable; see also  Section
  763.         4.2.2.
  764.  
  765.         3.2 Trying it Out
  766.         -----------------
  767.  
  768.         The  following assumes that this is the first time that  you  are
  769.         using BGFT.
  770.  
  771.         You  should  have, as a minimum, set up a '\BGFT'  directory  and
  772.         unarchived  all  the files, in that directory,  as  described  in
  773.         Section  4.2.1. The following example will show you how to  down-
  774.         load a file from a BBS using a modem. As you get more experienced
  775.         you  can set up a configuration file, an environment, and so  on.
  776.         These  conveniences will allow some of the  operations  described
  777.         next to be bypassed.
  778.  
  779.         1) Place a new floppy diskette in drive A: and format it with the
  780.         DOS FORMAT command for 360K. Part of the procedure below will  be
  781.         to  initialize  this diskette so that it can be used  as  a  file
  782.         buffer for BGFT360K.COM or BGFT720K.COM.
  783.  
  784.         It  is important that the floppy diskettes must not have any  bad
  785.         sectors; use the 'CHKDSK' program that came with your version  of
  786.         DOS to make sure. It is not a good idea, anyway, to keep  damaged
  787.         or suspect floppies.
  788.  
  789.         Consider  this  floppy to be a 'scratch' diskette  for  use  with
  790.         BGFT.  We  emphasize  that  ALL DATA  ON  THE  DISKETTE  WILL  BE
  791.         DESTROYED WHEN BGFT USES THE FLOPPY. However, one of the supplied
  792.         programs,  BGFTFLPY.EXE, will recover data lost by  inadvertently
  793.         initializing a DOS diskette containing good data.
  794.  
  795.         2) At the DOS prompt, type BGFT360K or BGFT720K, followed by  the
  796.         'ENTER'  key; this installs the resident part and makes drive  A:
  797.         the default file buffer. A Copyright message displayed at the top
  798.         of  the screen is an indication that the resident part  has  been
  799.         successfully installed.
  800.  
  801.         3) At the DOS prompt, type 'BGFT', followed by 'ENTER'; this runs
  802.         the user interface.
  803.  
  804.  
  805.  
  806.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 11
  807.         -------------------------------------------- - o -
  808.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  809.  
  810.  
  811.  
  812.         4) If you have a color system, BGFT will prompt you to see if you
  813.         wish to override the default colors with black and white.
  814.  
  815.         5) A data entry form appears to enable you to set the  communica-
  816.         tion port settings to suit your hardware configuration.
  817.  
  818.         Make  sure that your modem is on the desired  communication  port
  819.         and operating. Then
  820.  
  821.            - Enter the communication port number ('Comm Port #') to which
  822.              your modem is connected. Valid entries are: 1 (default),  2,
  823.              3, or 4.
  824.  
  825.            - The information window at the bottom of the screen tells you
  826.              to  use the up or down cursor keys to get to various  items.
  827.              Go  to  'Baud Rate' to choose the normal baud rate  of  your
  828.              modem;  valid choices are: 300, 1200 (default), 2400,  4800,
  829.              or 9600.
  830.  
  831.            - Enter  the number of 'Data Bits' [7 or 8  (default)],  'Stop
  832.              Bits' [1 (default) or 2], and the 'Parity' [N (default)  for
  833.              None,  E for Even, O for Odd, M for Mark, or S  for  Space].
  834.              Use the defaults if you are unsure; most BBSs use them.
  835.  
  836.            - When you have made your choices, press the F10 key. You will
  837.              be  asked to "Type Y to save changes to disk, N  otherwise".
  838.              Choose  'Y'  (or 'y'); the choices can be  overridden  later
  839.              using the 'Set_Up' menu if required.
  840.  
  841.         6) The standard opening BGFT screen will then appear.
  842.  
  843.         Running  BGFT automatically activates the resident part; this  is
  844.         evidenced by the appearance of the resident part's status display
  845.         'RDY' (ready with no errors), shown in the upper right corner  of
  846.         the screen.
  847.  
  848.         7)  As  prompted, press any key to continue. The  opening  screen
  849.         disappears.
  850.  
  851.         For unregistered users, BGFT should then show a screen to  remind
  852.         you  to register the program for your own use. Read  this  screen
  853.         and then press any key to continue.
  854.  
  855.         8) A window message informs you that the modem is being  initial-
  856.         ized.  On completion of the modem initialization, you will be  in
  857.         Terminal  Mode.  Typing  Alt_Z (see Section 6.9)  will  show  the
  858.         Terminal  Mode  Options  and the 'ESC' key will  clear  the  help
  859.         screen and return you to Terminal Mode.
  860.  
  861.         The Alt_Z key sequence provides context sensitive help throughout
  862.         the program; use it when needed.
  863.  
  864.  
  865.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 12
  866.         -------------------------------------------- - o -
  867.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  868.  
  869.  
  870.  
  871.  
  872.         Alt_O provides a convenient overview help to assist you in  navi-
  873.         gating around BGFT's features.
  874.  
  875.         Alt_M will get you the Main Menus and, by following the prompt at
  876.         the  bottom of the screen, a little bit of exploration will  show
  877.         you the layout of the system.
  878.  
  879.         9)  From  the Main Menu, use the Arrow keys, '<--' or  '-->',  to
  880.         highlight the 'Utility' option. Hit 'ENTER' to go to the  Utility
  881.         sub-menu.  Use the arrow keys to highlight the  'Initialize'  op-
  882.         tion.  On hitting 'ENTER', a window will warn you that the  disk-
  883.         ette  has  not previously been used by BGFT. Type 'Y' or  'y'  to
  884.         proceed with the initialization. A window will indicate that  the
  885.         initialization is in progress as shown by the floppy drive light.
  886.  
  887.         The floppy diskette is ready for use as a BGFT file buffer.  This
  888.         needs only to be done only once; a floppy initialized in this way
  889.         can be reused again and again for file transfers.
  890.  
  891.         At  this  point, BGFT is set up and ready to  go.  On  subsequent
  892.         running  of BGFT, your setup requirements will be read  from  the
  893.         configuration file, BGFT.CNF, and so the above setup steps do not
  894.         need to be repeated.
  895.  
  896.         In the following you will return to terminal mode where you  will
  897.         use  the  background  dialer to dial a BBS and  then  initiate  a
  898.         background download.
  899.  
  900.         10) Type Alt_T to get to the Terminal Mode (the screen in  termi-
  901.         nal  mode will say 'BGFT Terminal Mode: type Alt_Z for help.'  at
  902.         the bottom).
  903.  
  904.         Using  Alt_T is a short cut to bypass the menu system; you  could
  905.         have used the menu to select 'Previous State', or hit 'P' or 'p',
  906.         or hit 'ESC', all which would have returned you to the Main Menu,
  907.         then chosen 'Term_mode' to get to the Terminal Mode).
  908.  
  909.         11) From Terminal Mode you can check your modem's readiness by:
  910.  
  911.            - Typing  'AT', followed by 'ENTER'. The modem should  respond
  912.              'OK'.  Some modems will also accept 'at' for  the  attention
  913.              prompt. When BGFT initialized the modem in step 5 above,  it
  914.              sent the command 'ATE1' to cause the modem to echo responses
  915.              in  terminal  mode.  If you do not get an  'OK'  you  should
  916.              consult  Section 5.5.2 and your modem documentation.  It  is
  917.              assumed  that your modem's attention commands are  nominally
  918.              Hayes compatible; see Section 4.2.3.
  919.  
  920.            - To dial a number type 'Alt_D' to display the dialing  direc-
  921.              tory.  The  dialing directory provided has been  set  up  to
  922.  
  923.  
  924.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 13
  925.         -------------------------------------------- - o -
  926.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  927.  
  928.  
  929.  
  930.              contain  two entries for Dirac Systems' BBS; one  for  local
  931.              dialing  and one for long distance dialing. The first  entry
  932.              is 'selected' as shown by the highlighted bar.
  933.  
  934.            - Type 'Alt_A' to add a dialing entry between entries 1 and 2.
  935.              Follow the prompts to add the number of the BBS you want  to
  936.              dial.  The  new entry will be a new entry  2;  the  previous
  937.              entry  2 will be renumbered to entry 3. Remember that  Alt_Z
  938.              will give help as required.
  939.  
  940.              Once the dialing data entry form has been completed,  accept
  941.              your  input  using the F10 key or hit 'ESC' if you  wish  to
  942.              abandon  your input. Assuming you hit the F10 key, a  window
  943.              will pop up to ask if you want to save the changes to  disk.
  944.              Type  'Y'  to make the change permanent in  the  disk  file,
  945.              BGFT.DLG, for future use; typing 'N' keeps the entry only as
  946.              long as the dialing directory is on screen.
  947.  
  948.            - The new number will be shown as 'selected' by the  highlight
  949.              bar  and is ready for dialing. By simply hitting 'ENTER'  an
  950.              information window appears displaying the number dialed;  at
  951.              this  point 'ESC' will abort dialing. Typing any  other  key
  952.              puts you into Terminal Mode.
  953.  
  954.              BGFT defaults to tone dialing. If you have pulse dialing you
  955.              must use the 'Set_Up' menu as described in Section 5.5.2(2).
  956.  
  957.              It  is recommended that you set up a configuration  file  at
  958.              some  point  to customize BGFT to suit your needs;  it  will
  959.              make operation much more easy. See Sections 4 and 5.
  960.  
  961.              You  should  be  able to hear the modem  dial  the  selected
  962.              number. The dialing that takes place is actually done in the
  963.              background. This means that you can actually exit BGFT, done
  964.              by typing Alt_X, and dialing will continue. Indeed, you  can
  965.              run  any of your normal software as dialing  continues.  See
  966.              Section 5.7(6). For this example, we assume that the connec-
  967.              tion is made soon.
  968.  
  969.            - When a connection is made, BGFT360K.COM or BGFT720K.COM will
  970.              'beep'  and  the  status display in the top  corner  of  the
  971.              screen will indicate 'RDY'.
  972.  
  973.            - Hit  'ENTER' a couple of times from BGFT until the  BBS  re-
  974.              sponds; then logon normally and give the commands  necessary
  975.              to  tell the BBS to start downloading a file  using  Xmodem-
  976.              CRC, for example. The BBS will ask you to start your receiv-
  977.              er.
  978.  
  979.            - Take care not to confuse Xmodem-CRC and Xmodem-1K; they  are
  980.              different. See Section 5.8. Some BBSs refer to Xmodem-CRC as
  981.  
  982.  
  983.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 14
  984.         -------------------------------------------- - o -
  985.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  986.  
  987.  
  988.  
  989.              Xmodem and Xmodem-1K as Ymodem.
  990.  
  991.            - Press  the  'PgDn' (page down) key to pop  up  the  download
  992.              protocol selection menu, and then select 'Xmodem-CRC'. It is
  993.              important  that you select the same protocol that  you  told
  994.              the BBS. Be sure that the 'Num Lock' key is not active.
  995.  
  996.            - Check  that the file name displayed in the pop up window  is
  997.              the  one you requested from the BBS, if is not then  correct
  998.              it, and then hit 'ENTER' to accept the file name.
  999.  
  1000.            - An  information window will pop up to inform you  that  file
  1001.              transfer  is in progress. Also, file transfer will be  indi-
  1002.              cated  by the data block count being shown in  the  resident
  1003.              part's  status display (upper right corner of your  screen).
  1004.              Occasionally you will see the floppy drive light come on  as
  1005.              data is written to the floppy diskette.
  1006.  
  1007.            - Now you can exit BGFT by typing Alt_X and use your  computer
  1008.              for  whatever  purposes you want while the  background  file
  1009.              transfer  is occurring. You will be prompted from a  pop  up
  1010.              window  whether you really want to exit or not. Type 'Y'  to
  1011.              exit.
  1012.  
  1013.              Unregistered users will see another screen. Press any key to
  1014.              continue.
  1015.  
  1016.              Alt_X  is  an example of a 'hot' key; see Section  5.10  and
  1017.              Section 6.2(1). You can configure BGFT using the Setup  menu
  1018.              to exit without confirmation; this is much quicker.
  1019.  
  1020.         12)  On exiting BGFT you will be back to the DOS prompt  but  the
  1021.         file  transfer will be occurring in background. Now you  can  run
  1022.         one of your frequently used programs.
  1023.  
  1024.            - When the downloading is completed, BGFT360K or BGFT720K will
  1025.              beep a few times to let you know it has finished.
  1026.  
  1027.            - To retrieve the downloaded file you must run BGFT again.  To
  1028.              do  this, exit the program you were running and type  'BGFT'
  1029.              at  the  DOS  prompt. As before, you must  get  through  the
  1030.              opening screens; there is not a reprompting for any communi-
  1031.              cation parameters or reinitializing of the modem.
  1032.  
  1033.            - BGFT will 'beep' to tell you that there is a downloaded file
  1034.              in the file buffer.
  1035.  
  1036.            - A  window will prompt you for the directory into  which  you
  1037.              wish  to move the downloaded file. The default directory  is
  1038.              the current one that you were in when you ran BGFT; however,
  1039.              you  can  configure  BGFT to a download  directory  of  your
  1040.  
  1041.  
  1042.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 15
  1043.         -------------------------------------------- - o -
  1044.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  1045.  
  1046.  
  1047.  
  1048.              choice (see Section 5.5.4(5)).
  1049.  
  1050.            - Type  'Y' to accept. A window will pop up to  indicate  that
  1051.              BGFT is moving file to the desired directory.
  1052.  
  1053.            - On completion of the file move you will then be in  Terminal
  1054.              Mode. Continue to communicate with the BBS in an interactive
  1055.              mode  or  log off. Type Alt_X to leave  BGFT.  The  download
  1056.              demonstration is now complete.
  1057.  
  1058.         You  can try other downloads such as Xmodem-1K  or  Ymodem-Batch;
  1059.         see Section 5.8.2. You can also try uploads; see Section 5.8.4-5.
  1060.  
  1061.         Unfortunately, some programs interfere with multitasking environ-
  1062.         ments,  in  particular,  BGFT's background  file  transfers.  For
  1063.         example,  some misbehaved games have been found to be a  problem.
  1064.         In  most cases, the interference will be of the form  of  retries
  1065.         during transfer; however, in some cases, it may be impossible for
  1066.         BGFT to function correctly.
  1067.  
  1068.         It is best to experiment with your application programs to see if
  1069.         they  cause any problems. BGFT has been tested with a wide  range
  1070.         of commercially available business software and has been found to
  1071.         function  well.  Some  improperly  written  programs  may   cause
  1072.         interference  when  run  in  a multitasking  mode;  if  you  have
  1073.         problems  with  one of your applications we would be  pleased  to
  1074.         know so we can add it to a list to watch out for. See Section 6.9
  1075.         for BGFT limitations.
  1076.  
  1077.         Dirac  Systems  has used DESQview 386 and a  standard  foreground
  1078.         communications  program, running on a 22 MHz IBM PC 386  compati-
  1079.         ble,  for  testing communication capabilities in  a  multitasking
  1080.         environment.  BGFT works as well, or better, than that  expensive
  1081.         system  on ordinary computers such as a 4.77 MHz XT with  limited
  1082.         memory. That's what we call 'value'.
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 16
  1102.         -------------------------------------------- - o -
  1103.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  1104.  
  1105.  
  1106.  
  1107.         4. Installation
  1108.         ---------------
  1109.  
  1110.         The  BGFT environment is set up by installing the resident  part,
  1111.         BGFT360K.COM  or  BGFT720K.COM, and then  running  the  interface
  1112.         part,  BGFT.EXE. BGFT360K.COM or BGFT720K.COM exists as a TSR  to
  1113.         do  the  dialing  and  file transfers in  background  and  to  be
  1114.         accessed by BGFT.EXE on demand.
  1115.  
  1116.         BGFT360K.COM  or  BGFT720K.COM can easily be installed  from  any
  1117.         directory. The user makes the decision which floppy drive will be
  1118.         used  as the file buffer. When BGFT.EXE is first run, it  informs
  1119.         the resident part which communications port and baud rate to use.
  1120.  
  1121.         It  is recommended that BGFT.EXE be installed so that it  can  be
  1122.         used from any directory on the user's system. This can be done by
  1123.         putting  your BGFT directory in your DOS PATH statement and  set-
  1124.         ting the BGFT environment variable; BGFT.EXE can then access  its
  1125.         configuration file, dialing directory, help files, and so on from
  1126.         anywhere.
  1127.  
  1128.         A hard disk is highly preferable since operation on a two  floppy
  1129.         system will be extremely limited.
  1130.  
  1131.         Further details on configuring BGFT are presented in Section 5.5.
  1132.  
  1133.         4.1 The Resident Programs
  1134.         -------------------------
  1135.  
  1136.         The resident program, BGFT360K.COM or BGFT720K.COM, accepts  some
  1137.         command  line options. However, for normal operation, it is  only
  1138.         necessary to invoke the program with the command:
  1139.  
  1140.                   BGFT360K
  1141.  
  1142.         to use drive A: as the default file 360K buffer, or,
  1143.  
  1144.                   BGFT720K
  1145.  
  1146.         to use drive A: as the default file 720K buffer.
  1147.  
  1148.         Or, you may find it convenient to use:
  1149.  
  1150.                   BGFT360K /B
  1151.  
  1152.         or,
  1153.  
  1154.                   BGFT720K /B
  1155.  
  1156.         to use floppy drive B: instead for the respective file buffer.
  1157.  
  1158.  
  1159.  
  1160.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 17
  1161.         -------------------------------------------- - o -
  1162.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  1163.  
  1164.  
  1165.  
  1166.         The   command   line  options  recognized  by   BGFT360K.COM   or
  1167.         BGFT720K.COM are:
  1168.  
  1169.              /1 - use COM port 1 (only if BGFT.CNF does not exist).
  1170.              /2 - use COM port 2 (only if BGFT.CNF does not exist).
  1171.              /3 - use COM port 3 (only if BGFT.CNF does not exist).
  1172.              /4 - use COM port 4 (only if BGFT.CNF does not exist).
  1173.              /B - uses drive B: as the file buffer.
  1174.              /C - chain interrupts. Use if COM 1 has a mouse and if
  1175.                   COM 3 has a modem, similarly for the COM 2,4 pair.
  1176.                   Otherwise, do not use (eg, COM 1 and COM 4 are OK.)
  1177.              /E - 'spawn' the resident program (do not run as a TSR).
  1178.              /I - initialize the diskette to BGFT format on startup.
  1179.                   (not normally recommended)
  1180.              /L - loopback mode (echo's characters on given port).
  1181.                   (not normally used)
  1182.  
  1183.         4.2 The User Interface: BGFT.EXE
  1184.         --------------------------------
  1185.         4.2.1 Organizing the Files
  1186.         --------------------------
  1187.  
  1188.         It  is  recommended that you keep all the files  associated  with
  1189.         BGFT  in one directory. Specifically, use the DOS make  directory
  1190.         command to make a directory from the root directory, eg.:
  1191.  
  1192.                   MD BGFT
  1193.  
  1194.         BGFT  is  distributed via BBSs in an archived  format  as  either
  1195.         BGFT211.ZIP or BGFT211.ARC. Copy the archive file BGFT211.ARC  or
  1196.         BGFT211.ZIP into the directory '\BGFT', eg.:
  1197.  
  1198.                   COPY BGFT211.ZIP \BGFT
  1199.  
  1200.         Then use the change directory command to enter the new directory:
  1201.  
  1202.                   CD \BGFT
  1203.  
  1204.         To unarchive BGFT211.ARC you will require an unarchiving  utility
  1205.         such as PKXARC by PKWARE Inc. To do this, type the following:
  1206.  
  1207.                   PKXARC BGFT211
  1208.  
  1209.         To  unarchive  BGFT211.ZIP  you will  require  PKWARE's  PKUNZIP,
  1210.         Version 1.02 or greater. Type the following:
  1211.  
  1212.                   PKUNZIP BGFT211.ZIP
  1213.  
  1214.         and the files will be unpacked.
  1215.  
  1216.         When  you register BGFT we send you a package; copy all the  dis-
  1217.  
  1218.  
  1219.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 18
  1220.         -------------------------------------------- - o -
  1221.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  1222.  
  1223.  
  1224.  
  1225.         tribution files on the floppy we send you into the new directory.
  1226.         Supposing that the distribution diskette is in drive A: and  that
  1227.         your '\BGFT' directory is on hard drive C:, you would enter:
  1228.  
  1229.                   COPY A:*.* C:\BGFT
  1230.  
  1231.         The  file  BGFT211.EXE contains all the  registered  distribution
  1232.         files  for  BGFT. It will automatically unarchive  the  necessary
  1233.         files. Simply enter
  1234.  
  1235.                   BGFT211
  1236.  
  1237.         You should be careful about overwriting your dialing directory.
  1238.  
  1239.         4.2.2 Setting Up the Environment
  1240.         --------------------------------
  1241.  
  1242.         If  you  wish  to run BGFT from any  directory  then  you  should
  1243.         include the '\BGFT' directory in a PATH statement in your AUTOEX-
  1244.         EC.BAT  file.  For  example, if you have installed  BGFT  in  the
  1245.         directory '\BGFT' on drive C:, then the following PATH  statement
  1246.         would suffice:
  1247.  
  1248.                   PATH = C:\BGFT
  1249.  
  1250.         BGFT uses a number of support files. In particular:
  1251.  
  1252.              BGFT.HLP  - used for context sensitive help,
  1253.              BGFT.CNF  - used to store the user configuration,
  1254.              BGFT.DLG  - used to store the dialing directory,
  1255.              BGFT.SCR  - used for program screens.
  1256.  
  1257.         Although BGFT will function without BGFT.HLP, it will inform  you
  1258.         that the help file is not available. You are strongly recommended
  1259.         not  to modify the help file in any way because this will  almost
  1260.         certainly upset the correct functioning of the help system.
  1261.  
  1262.         BGFT  will work happily without the files BGFT.CNF and  BGFT.DLG;
  1263.         it  will  create  these files the first time you  save  the  user
  1264.         configuration and the first time you save the dialing  directory,
  1265.         respectively.  Again,  if you modify these files, by  some  means
  1266.         other  than  by using BGFT, the functioning of  BGFT  may  become
  1267.         unpredictable. Updated versions of BGFT may change the format  of
  1268.         the  files  so  that it is recommended that old  ones  should  be
  1269.         deleted.
  1270.  
  1271.         BGFT  is designed to look for these four support files in one  of
  1272.         two  possible  locations.  First,  BGFT  looks  in  the   current
  1273.         directory;  if it cannot find the files there, it will look in  a
  1274.         user directory specified by the environment variable 'BGFT'.  The
  1275.         environment  variable can be set, in your AUTOEXEC.BAT  file,  as
  1276.  
  1277.  
  1278.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 19
  1279.         -------------------------------------------- - o -
  1280.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  1281.  
  1282.  
  1283.  
  1284.         given in the following example:
  1285.  
  1286.                   SET BGFT=C:\BGFT
  1287.  
  1288.         In  this example, the environment variable 'BGFT' is set  to  the
  1289.         directory '\BGFT' on drive C:; that is, to the directory contain-
  1290.         ing all the BGFT system files. This is highly recommended.
  1291.  
  1292.         If  the environment variable method is used then BGFT will  place
  1293.         the files BGFT.CNF and BGFT.DLG in the directory specified by the
  1294.         environment variable the first time it creates them. If you  wish
  1295.         to   set  up  independent  versions  of  these  files  in   other
  1296.         directories,  but  still set the environment variable,  then  you
  1297.         should  copy a version of these files, from the directory  speci-
  1298.         fied by the environment variable, into the desired directory, and
  1299.         then use BGFT to modify these files to suit your needs.
  1300.  
  1301.         For  example, if you require to use more telephone  numbers  than
  1302.         BGFT allows (256), simply set up another DOS directory and  place
  1303.         in it a copy of the file BGFT.DLG. With this new DOS directory as
  1304.         the current directory, run BGFT, and use it to modify the copy of
  1305.         BGFT.DLG to suit your needs.
  1306.  
  1307.         4.2.3 Setting Up Your Modem
  1308.         ---------------------------
  1309.  
  1310.         Your modem must be 'nominally' Hayes compatible. This means  that
  1311.         it  must respond to the normal 'ATxx' command set;  for  example,
  1312.         'ATDT  555-6789' will dial the number 555-6789,  with  touch-tone
  1313.         dialing. The initialization string and the dialing command can be
  1314.         changed  via the 'Modem_params' option in the 'Set_up'  menu.  If
  1315.         your  modem can detect a BUSY connection, then the dialer can  be
  1316.         configured to redial immediately.
  1317.  
  1318.         It is important to note that your modem must be set up such  that
  1319.         the  carrier  detect line is active when a  connection  is  made.
  1320.         BGFT  assumes  that  the carrier detect line  will  indicate  the
  1321.         status of the connection, ie. connected or disconnected. If  this
  1322.         is not the case then there are several consequences. First,  BGFT
  1323.         must  be  set  up to be in 'direct  connect'  mode  (see  Section
  1324.         5.5.2). Second, the background dialer will be inoperable but file
  1325.         transfer  will  still  be  possible.  In  most  cases,  a   Hayes
  1326.         compatible  modem can be easily set up to manipulate the  carrier
  1327.         detect line, so this should not be a problem; refer to your modem
  1328.         setup  documentation for further information (see  also  Appendix
  1329.         6.7, Problem Solving).
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 20
  1338.         -------------------------------------------- - o -
  1339.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  1340.  
  1341.  
  1342.  
  1343.         5. Operation
  1344.         ------------
  1345.  
  1346.         Section 3.2 described how to operate BGFT in a basic step by step
  1347.         way.  Experienced users will demand more, so this  Section  gives
  1348.         the details that will be needed.
  1349.  
  1350.         This Section describes the operation of BGFT from a  'functional'
  1351.         point  of  view. This means that the menus are not  described  in
  1352.         order of appearance or in detail, except where deemed  necessary;
  1353.         most of the menus are self explanatory.
  1354.  
  1355.         After  a  little  bit of experimentation with  the  menu  system,
  1356.         BGFT  will be found to be easy to use. 'Hot' and 'warm' keys  are
  1357.         also provided if you wish to bypass the menu system; see  Section
  1358.         6.2 for the Alt_Key summary.
  1359.  
  1360.         5.1 Starting BGFT
  1361.         -----------------
  1362.  
  1363.         BGFT  is  normally  invoked with no arguments  specified  on  the
  1364.         command line:
  1365.  
  1366.                   BGFT
  1367.  
  1368.         In  this case BGFT runs in its normal interactive mode.  However,
  1369.         it  will accept the following command line 'switches' which  will
  1370.         cause it to carry out specific operations:
  1371.  
  1372.         1) BGFT /H
  1373.  
  1374.         The command line help switch, /H, or any unsupported switch, will
  1375.         activate a help screen.
  1376.  
  1377.         2) BGFT /K
  1378.  
  1379.         BGFT terminates (kills) background dialing and then exits.
  1380.  
  1381.         3) BGFT /M
  1382.  
  1383.         This forces BGFT to read the file buffer, and if downloaded files
  1384.         are detected, to initiate the sequence that moves the  downloaded
  1385.         files,  from  the  file buffer, to your  chosen  downloaded  file
  1386.         directory  and then proceed to terminal mode. This is  useful  if
  1387.         you  switched your computer off after downloading files into  the
  1388.         file  buffer but did not move them from the file buffer  to  hard
  1389.         disk first. Some manual operations will be required.
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 21
  1397.         -------------------------------------------- - o -
  1398.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  1399.  
  1400.  
  1401.  
  1402.         4) BGFT /N
  1403.  
  1404.         When  BGFT  is first run, it will initialize the modem  with  the
  1405.         modem  command string from the configuration file. There  may  be
  1406.         times when you are already connected by some other means and want
  1407.         to  use BGFT for the first time but do not want to send  out  the
  1408.         modem  string.  To avoid send the string, use  the  command  line
  1409.         switch, /N.
  1410.  
  1411.         5) BGFT /R
  1412.  
  1413.         BGFT suspends the resident part and then exits. This is useful to
  1414.         gain  quick access to the floppy drive when the resident part  is
  1415.         active.  You cannot use the selected drive A: (or B:),  for  non-
  1416.         BGFT purposes, while the resident part is active.
  1417.  
  1418.         5.2 The Menu System and Mouse Support
  1419.         -------------------------------------
  1420.  
  1421.         Choices in the menus are selected as described in the next  para-
  1422.         graph  when  not using a mouse. If your system has a  mouse,  see
  1423.         Section  5.5.3(1)  for configuring it.  BGFT  will  automatically
  1424.         detect it and enable it to used to select items in 'bar' or 'pull
  1425.         down'  menus.  In  the following  description  appropriate  mouse
  1426.         movement may be used instead of the arrow keys. Also pressing the
  1427.         left mouse button corresponds to 'ENTER' and simultaneous  press-
  1428.         ing  of  the  left and right buttons corresponds  to  'ESC'.  The
  1429.         function of the right button is context sensitive.
  1430.  
  1431.         The  main  menu  system for BGFT, which is  activated  by  typing
  1432.         'Alt_M'  (or pressing the right mouse button) while  in  terminal
  1433.         mode,  is a two line display at the top of the screen. This  dis-
  1434.         play  is in the form of a 'sliding' menu with the top line  as  a
  1435.         list  of  sub-menus or options that can be  activated  by  either
  1436.         typing the first letter of the option/sub-menu name, or using the
  1437.         left  and  right  arrow keys to select it,  followed  by  hitting
  1438.         'ENTER'.  When a given option/sub-menu item is  highlighted,  the
  1439.         second  line  shows a list of the items that will appear  in  the
  1440.         sub-menu or a description of the action resulting from the  given
  1441.         selection.
  1442.  
  1443.         Hitting  'ESC' returns you to terminal mode. Typically,  the  ESC
  1444.         key  exits a BGFT menu or window without any action  being  taken
  1445.         and returns you to your previous state or menu.
  1446.  
  1447.         Selecting  an option may cause a pop up menu to  appear,  showing
  1448.         the next level of choices available. If such a menu pops up,  you
  1449.         can  either  select an option by using the first  letter  of  the
  1450.         option  or by using the vertical arrow keys to select an  option,
  1451.         followed  by hitting 'ENTER' to accept, or 'ESC' to exit with  no
  1452.         action.
  1453.  
  1454.  
  1455.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 22
  1456.         -------------------------------------------- - o -
  1457.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  1458.  
  1459.  
  1460.  
  1461.  
  1462.         The main menu entries are briefly described as follows:
  1463.  
  1464.         1) Clear
  1465.  
  1466.         This option clears the terminal mode screen.
  1467.  
  1468.         2) File
  1469.  
  1470.         Selecting  this item gives a sub-menu that lists operations  that
  1471.         can  be performed on the file buffer: start download,  start  up-
  1472.         load,  move files into or out of the file buffer, and list  files
  1473.         in the file buffer.
  1474.  
  1475.         3) Utility
  1476.  
  1477.         The  utility sub-menu specifies utility type operations that  can
  1478.         be  carried out: acknowledge transmission errors,  end  transmis-
  1479.         sion, initialize the file buffer, suspend the resident program to
  1480.         access  floppy, toggle on/off the status display ('RDY'  window),
  1481.         send  the  modem initialization command and display data  on  the
  1482.         status of BGFT.
  1483.  
  1484.         4) Dial
  1485.  
  1486.         This gives the dialing directory sub-menu and pop up window  from
  1487.         which  background  dialing can be initiated. You  can  select  an
  1488.         entry,  edit  it, add another, remove one, dial it, or  kill  the
  1489.         background dialing.
  1490.  
  1491.         5) Setup
  1492.  
  1493.         The  'Set_up'  sub-menu allows changing, and saving to  disk,  of
  1494.         BGFT's  configuration options. You can alter the colors  (if  you
  1495.         have a color system), change modem parameters, change  communica-
  1496.         tion  port settings, define user options, move the  'RDY'  status
  1497.         window and 'Save_setup' to disk.
  1498.  
  1499.         6) Run_shell
  1500.  
  1501.         This  will run a DOS shell. This allows you to suspend  execution
  1502.         of BGFT.EXE and run other applications from the DOS prompt.
  1503.  
  1504.         When  you  get to the DOS shell, the DOS prompt  will  issue  the
  1505.         additional  message: "Type 'EXIT' to return to BGFT" so that  you
  1506.         will be reminded that you are in the shell and that, to return to
  1507.         BGFT, you must enter 'EXIT' at the DOS prompt.
  1508.  
  1509.         When  you are in the shell, BGFT is still in memory. If  you  DOS
  1510.         PRINT a file but, if the PRINT driver was not loaded into  memory
  1511.         before  BGFT, then the driver will 'lock' BGFT into memory.  When
  1512.  
  1513.  
  1514.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 23
  1515.         -------------------------------------------- - o -
  1516.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  1517.  
  1518.  
  1519.  
  1520.         you  return  to BGFT, do a file transfer in the  background,  and
  1521.         then  exit, BGFT will still be locked into memory and about  200K
  1522.         of  space will be unavailable to do foreground tasks.  Therefore,
  1523.         if  you  expect to use TSRs like PRINT while in the  shell,  then
  1524.         load them before running BGFT.
  1525.  
  1526.         7) Term_mode
  1527.  
  1528.         Selecting  this  option exits the menu subsystem and  returns  to
  1529.         terminal  mode.  Typing 'Alt_T' at any location in BGFT  has  the
  1530.         same  effect.  Hitting 'ESC' will also get you to  terminal  mode
  1531.         from the main menu.
  1532.  
  1533.         8) Emulation
  1534.  
  1535.         This option pops up a menu with a list of the terminal emulations
  1536.         that  can  be selected to suit the computer system that  you  are
  1537.         connected  to. The available emulations are: None,  ANSI,  VT100,
  1538.         and  VT52.  BGFT has a limited set of basic  terminal  emulations
  1539.         because  these  are  normally  sufficient  for  background   file
  1540.         transfer.
  1541.  
  1542.         The VT100 keypad is mapped to the PC Function keys as follows:
  1543.  
  1544.         PF1 > F1       PF2 > F2       PF3 > Shift_F1      PF4 > Shift_F2
  1545.  
  1546.         7   > F3       8   > F4       9   > Shift_F3      -   > Shift_F4
  1547.  
  1548.         4   > F5       5   > F6       6   > Shift_F5      ,   > Shift_F6
  1549.  
  1550.         1   > F7       2   > F8       3   > Shift_F7      Enter>Shift_F8
  1551.  
  1552.         0   > F9       0   > F10      .   > Shift_F9      Enter>Shift_F10
  1553.  
  1554.         'Shift_F10'  indicates  that the Shift key and then the  F10  key
  1555.         should be held down together momentarily.
  1556.  
  1557.         9) Quit
  1558.  
  1559.         This exits BGFT.EXE. Typing 'Alt_X' at any time has the same  ef-
  1560.         fect.
  1561.  
  1562.  
  1563.         All other menus are accessible from the main menu.
  1564.  
  1565.         5.3 Data Entry Forms
  1566.         --------------------
  1567.  
  1568.         All BGFT input data forms have the following features:
  1569.  
  1570.            - Complete  all entries with the ENTER key or  vertical  arrow
  1571.  
  1572.  
  1573.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 24
  1574.         -------------------------------------------- - o -
  1575.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  1576.  
  1577.  
  1578.  
  1579.              keys.
  1580.  
  1581.            - Alt_Z provides on-line help,
  1582.  
  1583.            - Hitting key F10 signifies that the screen is OK and  accepts
  1584.              any  changes; you will then be prompted to confirm that  the
  1585.              changes are acceptable and also be asked if you wish to save
  1586.              them to disk (whether changes were made or not),
  1587.  
  1588.            - Hitting  'ESC' abandons any changes, returning to  the  menu
  1589.              bar or previous state.
  1590.  
  1591.         5.4 The Help System
  1592.         -------------------
  1593.  
  1594.         BGFT  provides  the following three types  of  context  sensitive
  1595.         help:
  1596.  
  1597.         1)  A message line, at the bottom of the screen, is provided  for
  1598.         practically all functions of BGFT, to indicate current status  of
  1599.         the  given  function or to give brief guidance on  the  available
  1600.         options. For example, a reminder that typing 'Alt_T' will  return
  1601.         you to terminal mode.
  1602.  
  1603.         2) The second line of the bar menu system, described above, gives
  1604.         a brief description of a highlighted menu option.
  1605.  
  1606.         3) A help key for more detailed help information. BGFT uses Alt_Z
  1607.         as the help key.
  1608.  
  1609.         The  help  key is active practically anytime  keyboard  input  is
  1610.         required, such as when using the dialing directory. Pressing  the
  1611.         help  key in terminal mode gives a list of 'hot' and 'warm'  keys
  1612.         used to speed up selected BGFT operations from terminal mode.
  1613.  
  1614.         5.5 Configuring BGFT
  1615.         --------------------
  1616.  
  1617.         BGFT  allows you to change its appearance to suit your needs  and
  1618.         preferences. In particular, a setup menu is provided that  allows
  1619.         you  to  customize BGFT. The setup menu can be accessed  via  the
  1620.         main  menu or directly from terminal mode using the Alt_S  'warm'
  1621.         key.
  1622.  
  1623.         5.5.1 Colors
  1624.         ------------
  1625.  
  1626.         If  you have a black and white system then the screen  appearance
  1627.         can be changed only to toggle a white or black background. If you
  1628.         configure  BGFT  to be black and white but then move to  a  color
  1629.         system, you will have to delete the configuration file, BGFT.CNF,
  1630.  
  1631.  
  1632.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 25
  1633.         -------------------------------------------- - o -
  1634.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  1635.  
  1636.  
  1637.  
  1638.         and reconfigure to get colors.
  1639.  
  1640.         The  following Section is only applicable if you have a CGA,  EGA
  1641.         or  VGA  color system. If you have a monochrome  monitor  with  a
  1642.         color type video card then the options in this Section will  have
  1643.         limited affect on the display.
  1644.  
  1645.         The  'colors option' allows you to change the colors of the  var-
  1646.         ious  BGFT  screens.  The method of changing color  is  first  to
  1647.         select the screen feature that you wish to modify using the  menu
  1648.         bar.  At this point a window pops up showing the  current  colors
  1649.         for  the  given screen feature. Simply  follow  the  instructions
  1650.         listed in the pop up window to change the colors. For example, if
  1651.         you wish to change the colors of the terminal mode screen then:
  1652.  
  1653.            - Select the terminal mode option, 'Term_Mode', from the  menu
  1654.              bar.
  1655.  
  1656.            - Type  'f'  or 'F' to step through the  available  foreground
  1657.              colors.
  1658.  
  1659.            - Type  'b'  or 'B' to step through the  available  background
  1660.              colors.
  1661.  
  1662.         WYSIWYG  stands  for 'What You See Is What You Get' so  that  the
  1663.         color changes that you make by following 1) to 3) above are those
  1664.         that  you will actually see when you return to the terminal  mode
  1665.         screen.
  1666.  
  1667.         Once you are happy with your color scheme, hit 'ENTER' to  accept
  1668.         the colors and return to the menu bar. If, on the other hand, you
  1669.         decide  that you would rather keep the old color  scheme,  simply
  1670.         hit 'ESC' instead of 'ENTER'.
  1671.  
  1672.         As  usual, type 'Alt_T' to return directly to terminal  mode  or,
  1673.         alternatively, follow the menu bar.
  1674.  
  1675.         5.5.2 Modem Parameters
  1676.         ----------------------
  1677.  
  1678.         On selecting the modem parameter option, 'Modem_params', from the
  1679.         menu  bar, a data entry form pops up allowing you to select  var-
  1680.         ious modem setup commands.
  1681.  
  1682.         The following are the possible parameters that can be modified:
  1683.  
  1684.         1) Modem Initialization String
  1685.  
  1686.         This entry should be used to set the initialization string to  be
  1687.         sent  to your modem on starting BGFT. BGFT was designed  to  work
  1688.         with  Hayes  compatible modems, so you should  check  your  modem
  1689.  
  1690.  
  1691.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 26
  1692.         -------------------------------------------- - o -
  1693.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  1694.  
  1695.  
  1696.  
  1697.         documentation to decide appropriate setup commands. BGFT does not
  1698.         automatically send the modem attention string 'AT', so you should
  1699.         include that at the start of the command.
  1700.  
  1701.         If you start BGFT without a configuration file then it uses
  1702.  
  1703.              ATE1 S7=255 S0=0 V1
  1704.  
  1705.         as the default string. The S7 modem register is used by the modem
  1706.         to wait the indicated number of seconds for a connection.  Howev-
  1707.         er, BGFT configures its own wait time (see 4) and 5) below) which
  1708.         will  override it. Change this with care to suit your  needs  and
  1709.         your modem.
  1710.  
  1711.         2) Dialing Command
  1712.  
  1713.         The following commands instruct the modem to auto-dial:
  1714.  
  1715.              ATDT instructs the modem to use Tone dialing,
  1716.              ATDP instructs the modem to use rotary-Pulse dialing.
  1717.  
  1718.         BGFT  defaults  to tone dialing if you are not  using  a  config-
  1719.         uration file. You must use one of these commands if  auto-dialing
  1720.         is to work.
  1721.  
  1722.         3) Hang Up Command
  1723.  
  1724.         BGFT  uses two methods to hang up the line. The quickest, and  so
  1725.         probably the most desirable, is by inhibiting 'DTR'. However, you
  1726.         will  have  to check your modem documentation to make  sure  that
  1727.         this  feature  is supported by your particular  modem  model.  On
  1728.         earlier,  and consequently slower modems, this would be  done  by
  1729.         means of the appropriate 'dip' switch settings. On later  modems,
  1730.         for  example,  the Hayes Smartmodem 2400, this can be  done  with
  1731.         software through a suitable modem command.
  1732.  
  1733.         The second method, which is somewhat slower than the DTR  method,
  1734.         is to send the modem hangup string, for example:
  1735.  
  1736.                   ATH0
  1737.  
  1738.         See  your  modem documentation for further  information  on  this
  1739.         command.  BGFT  handles the appropriate time delays so  that  you
  1740.         should not include any time delay instructions.
  1741.  
  1742.         4) Time Between Dialing
  1743.  
  1744.         This  command  sets the number of seconds BGFT will  wait  for  a
  1745.         carrier before it gives up, assuming that the line was not  busy.
  1746.         The 'Time Between Dialing' allows you to set the interval between
  1747.         dialing  cycles from 1 to 999 seconds. If you run BGFT without  a
  1748.  
  1749.  
  1750.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 27
  1751.         -------------------------------------------- - o -
  1752.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  1753.  
  1754.  
  1755.  
  1756.         configuration  file  it  defaults to  55  seconds.  International
  1757.         connect times can take over a minute; local calls typically  take
  1758.         30 seconds or less.
  1759.  
  1760.         5) Test for 'BUSY'
  1761.  
  1762.         BGFT  is  able  to use modem information,  if  available,  as  to
  1763.         whether  the line is busy when dialed. If the line is busy,  BGFT
  1764.         will  drop the line without waiting for the connection and  back-
  1765.         ground  redialing will recommence. Default is 'Y' to enable  this
  1766.         feature.
  1767.  
  1768.         6) Direct Connection
  1769.  
  1770.         If  you  are using a null modem connection, to  communicate  with
  1771.         another computer, rather than a modem then you should enter  'Y'.
  1772.         In  that case, the above modem commands are ignored. If  you  are
  1773.         using a modem then you should select 'N'.
  1774.  
  1775.         If you run BGFT without a configuration file then it will default
  1776.         to 'N'; it assumes that you are using a modem.
  1777.  
  1778.         5.5.3 Communication Port Settings
  1779.         ---------------------------------
  1780.  
  1781.         Selecting the communications port option, 'Comm_port', pops up  a
  1782.         data entry form that allows you to make the following  communica-
  1783.         tion port selections:
  1784.  
  1785.         1) Communication Port Number
  1786.  
  1787.         BGFT  is designed to work with one of the communication  ports  1
  1788.         (default),  2,  3, or 4; you must have the  appropriate  hardware
  1789.         installed.  You cannot set up background communications  on  more
  1790.         than one port at one time.
  1791.  
  1792.         It  is recommended that your modem be connected to  communication
  1793.         port 2 and, if you have a mouse, that it be connected to port  1.
  1794.         Port  2 has a higher priority when dealing with  hardware  inter-
  1795.         rupts; having your modem there will aid in communications.
  1796.  
  1797.         There  are general hardware limitations on the PC for  users  who
  1798.         wish  to  use a combination of odd or even  serial  communication
  1799.         port pairs. This is due to the physical construction and the  way
  1800.         hardware  interrupts were designed to be handled on the  PC.  For
  1801.         example, some users may want to have COM 1 for the mouse and  COM
  1802.         3 for the modem since some internal modems use COM 3. This is not
  1803.         recommended (the mouse on COM 1 and modem on COM 4 is all right).
  1804.         Under BGFT, there is a 'work around' solution provided. The mouse
  1805.         driver  should  be  loaded  in before  BGFT360K  or  BGFT720K  is
  1806.         activated  and the resident part should be loaded with  the  '/C'
  1807.  
  1808.  
  1809.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 28
  1810.         -------------------------------------------- - o -
  1811.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  1812.  
  1813.  
  1814.  
  1815.         command line option. For example,
  1816.  
  1817.              BGFT360K /C
  1818.  
  1819.         This  will  inform the resident part about the existence  of  the
  1820.         mouse on the other paired port and allow for a proper  'chaining'
  1821.         of interrupts between the modem and the mouse. This option should
  1822.         not be used if they are on an odd and even COM port as recommend-
  1823.         ed.
  1824.  
  1825.         If  you attempt to run BGFT without a configuration file then  it
  1826.         will  check to see whether or not a communication port  has  been
  1827.         specified  earlier via the BGFT360K or BGFT720K command line.  If
  1828.         not,  it will prompt you to specify an appropriate  communication
  1829.         port number.
  1830.  
  1831.         2) Baud Rate
  1832.  
  1833.         BGFT allows you to specify the following baud rates:
  1834.  
  1835.              300, 1200 (default), 2400, 4800, and 9600
  1836.  
  1837.         If  you run BGFT without a configuration file it prompts  you  to
  1838.         specify a value.
  1839.  
  1840.         When  using  the automatic dialer, baud rate must  be  specified.
  1841.         This  is done by setting the baud rate in the  dialing  directory
  1842.         which will override any value set previously set up.
  1843.  
  1844.         3) Data Bits
  1845.  
  1846.         Serial communications come in data formats, usually of two forms:
  1847.  
  1848.         8 data bits, 1 stop bit, and No parity (8 1 N) or,
  1849.         7 data bits, 1 stop bit, and Even parity (7 1 E).
  1850.  
  1851.         Most  BBSs use (8 1 N) but some mainframe computer  networks  may
  1852.         use (7 1 E). With BGFT you may chose several formats.
  1853.  
  1854.         Valid entries for data bits are: 7 or 8 (default).
  1855.  
  1856.         4) Stop Bits
  1857.  
  1858.         Valid entries for stop bits are: 1 (default) or 2.
  1859.  
  1860.         5) Parity
  1861.  
  1862.         Valid  entries for parity are: N for No (default), E for Even,  O
  1863.         for Odd, M for Mark, or S for Space.
  1864.  
  1865.  
  1866.  
  1867.  
  1868.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 29
  1869.         -------------------------------------------- - o -
  1870.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  1871.  
  1872.  
  1873.  
  1874.         5.5.4 Options
  1875.         -------------
  1876.  
  1877.         The user option menu pops up a data entry form to allow selection
  1878.         of user options, to suit your needs. The following are the avail-
  1879.         able options:
  1880.  
  1881.         1) Confirm Exit
  1882.  
  1883.         As  BGFT  is a background utility, it is highly desirable  to  be
  1884.         able  to  get  into and out of it as  quickly  as  possible.  For
  1885.         example, you might want to initiate the upload of a collection of
  1886.         unrelated  files using Ymodem-Batch and then quit out to  DOS  to
  1887.         run  your favorite spread sheet package. To this end, BGFT has  a
  1888.         'hot' key, Alt_X, that allows you to exit BGFT from any location.
  1889.         When  using  the program for the first time it can  be  a  little
  1890.         disconcerting  to  discover  just how easy it is  to  exit  BGFT.
  1891.         Consequently,   this  user  option  allows  you  to   request   a
  1892.         confirmation prompt before exiting.
  1893.  
  1894.         After frequent use of BGFT you will almost certainly want to turn
  1895.         confirmation off.
  1896.  
  1897.         If you run BGFT without a configuration file it defaults to  'Y',
  1898.         for confirmation.
  1899.  
  1900.         2) Make Backups
  1901.  
  1902.         BGFT has a number of supporting files, in particular, the dialing
  1903.         directory  file, BGFT.DLG, and the configuration file,  BGFT.CNF.
  1904.         When  you run BGFT and make changes that modify these  files  you
  1905.         have the option of keeping a backup file. If, for example, you do
  1906.         not like the changes you made to the configuration file, then, if
  1907.         you  have selected the make backups option, you can recover  your
  1908.         previous  configuration  file simply by renaming  (see  your  DOS
  1909.         manual):
  1910.  
  1911.                   RENAME BGFTBAK.CNF BGFT.CNF
  1912.  
  1913.         after deleting the unwanted BGFT.CNF.
  1914.  
  1915.         Similarly, for the dialing directory files:
  1916.  
  1917.                   RENAME BGFTBAK.DLG to BGFT.DLG
  1918.  
  1919.         If  you  run BGFT without a configuration file then  the  backups
  1920.         'on' option is chosen.
  1921.  
  1922.  
  1923.  
  1924.  
  1925.  
  1926.  
  1927.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 30
  1928.         -------------------------------------------- - o -
  1929.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  1930.  
  1931.  
  1932.  
  1933.         3) Sound On
  1934.  
  1935.         This option allows you turn off all sound effects related to  the
  1936.         operation of BGFT, for example, the sound that you hear when BGFT
  1937.         has  established a connection or has completed a  file  transfer.
  1938.         This can be useful if you are running BGFT late at night and  you
  1939.         do not wish to disturb others.
  1940.  
  1941.         Turning sound off for BGFT will not turn sound off for any  other
  1942.         application  program  that  you might be running  while  BGFT  is
  1943.         performing its background activities.
  1944.  
  1945.         If you run BGFT without a configuration file then it defaults  to
  1946.         sound 'on'.
  1947.  
  1948.         4) Confirm Data
  1949.  
  1950.         BGFT  uses a number of data entry forms similar to the  one  used
  1951.         here  to  select  user options.  After  having  made  appropriate
  1952.         selections,  the  pop up data entry form is  removed,  either  by
  1953.         hitting  the key F10 to signal that the changes are OK, or  'ESC'
  1954.         to  abandon changes. If the confirm data option is selected  then
  1955.         you  are given another chance to confirm the changes before  they
  1956.         become permanent. This helps prevent inadvertently spoiling data.
  1957.  
  1958.         If  you  run  BGFT without a configuration file  then  the  'yes'
  1959.         default of 'Confirm data' is used.
  1960.  
  1961.         5) Auto Save File Directory
  1962.  
  1963.         When  BGFT  downloads a file it first of all downloads  the  file
  1964.         onto  the  floppy diskette located in drive A:, if that  was  the
  1965.         file buffer chosen. Indeed, dedicating a floppy drive to BGFT  is
  1966.         the price that is currently paid for BGFT's superior  performance
  1967.         and  trouble free operation. The files that are transferred  onto
  1968.         the  floppy diskette are in a format that cannot be  accessed  by
  1969.         DOS and so have to converted to a DOS readable form and moved  to
  1970.         another drive before they can be used.
  1971.  
  1972.         When  file  transfer  is complete, and you return  to  BGFT  from
  1973.         whatever  you  were doing while transfer took  place,  BGFT  will
  1974.         semi-automatically  transfer the files that had  been  downloaded
  1975.         into  the file buffer, to the hard drive directory  specified  by
  1976.         'Auto  Save  File  Directory'. They will be converted  to  a  DOS
  1977.         readable format in the process.
  1978.  
  1979.         If  you do not wish to have this process done  semi-automatically
  1980.         then  simply enter 'MANUAL' instead of a path specification.  You
  1981.         may  manually  move files from the file buffer to  another  drive
  1982.         using the 'File' menu.
  1983.  
  1984.  
  1985.  
  1986.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 31
  1987.         -------------------------------------------- - o -
  1988.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  1989.  
  1990.  
  1991.  
  1992.         If  you run BGFT without a configuration file it will default  to
  1993.         'MANUAL'  mode because it has no way of knowing  which  directory
  1994.         you want the files to be moved to.
  1995.  
  1996.         Each time you run BGFT it checks with the resident part to see if
  1997.         any  files have been downloaded, that is, assuming that  you  had
  1998.         specified a 'Auto File Save Directory' name. It does this, rather
  1999.         than reading the file buffer directly, to save time and to enable
  2000.         you  to  get into the program quickly in the case that  no  files
  2001.         have  been downloaded, for example, after an upload. However,  if
  2002.         you switch your machine off, or reboot it after a download,  then
  2003.         BGFT  will  not initiate an auto-move of files until  after  your
  2004.         next download. In that case you may wish to use the manual method
  2005.         from  the 'File' directory to move your downloaded files  or  use
  2006.         the '/M' command line option.
  2007.  
  2008.         6) Tab Width
  2009.  
  2010.         When  using terminal emulation you may need to set the tab  width
  2011.         as  required. Note, however, that some computer systems you  con-
  2012.         nect to, may change the tab width to suit their needs.
  2013.  
  2014.         If  you  run BGFT without a configuration file, the  default  tab
  2015.         width is 8.
  2016.  
  2017.         5.5.5 More Options
  2018.         ------------------
  2019.  
  2020.         Selecting 'Next' from the 'Set_up' menu presents a sub-menu  that
  2021.         has  one effective entry, 'Move_wind'. This is used  to  relocate
  2022.         the  status  RDY window along the top line. This can be  used  so
  2023.         that  both  the RDY window and some  other  concurrently  running
  2024.         software  will not conflict with the top right hand corner  which
  2025.         is  the default RDY position. The RDY display can be  turned  off
  2026.         with Alt_W from the terminal mode; also see the 'Utilities' menu.
  2027.  
  2028.         After  selecting  'Next', use the left and right arrow  keys,  or
  2029.         mouse,  to drag the RDY display along the top of the screen.  Hit
  2030.         'ENTER'  when you have reached the spot you want, or ESC to  keep
  2031.         the old position.
  2032.  
  2033.         5.6 Terminal Mode
  2034.         -----------------
  2035.  
  2036.         When  you  first run BGFT, after turning on  your  computer,  you
  2037.         arrive  in  terminal mode after you have negotiated  the  opening
  2038.         screens. At this stage you will be either connected to your modem
  2039.         or you will be in direct contact with another computer via a null
  2040.         modem  connection  (a  direct connection). These  two  cases  are
  2041.         described separately below:
  2042.  
  2043.  
  2044.  
  2045.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 32
  2046.         -------------------------------------------- - o -
  2047.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  2048.  
  2049.  
  2050.  
  2051.         1) Using a Modem
  2052.  
  2053.         If  you are using a modem, assuming you have set your modem  con-
  2054.         figuration switches appropriately and/or have set the modem  ini-
  2055.         tialization  string to suit (including the 'ATE1' command),  then
  2056.         characters  typed at the keyboard will be echoed on  the  screen.
  2057.         For example, typing 'AT' followed by hitting 'ENTER' will produce
  2058.         the familiar 'OK' response from the modem. In fact, you can  type
  2059.         any valid modem command string and the modem will respond accord-
  2060.         ingly.  For example, you can manually type the  appropriate  com-
  2061.         mands to dial a given telephone number; normally you would not do
  2062.         that  because  it is so much more convenient to use  the  dialing
  2063.         directory and so get the benefits of background dialing.
  2064.  
  2065.         If you are an occasional user of your modem, you are  recommended
  2066.         not  to  send  manual commands to your modem  via  terminal  mode
  2067.         because BGFT makes certain reasonable assumptions about how  your
  2068.         modem  is  set  up. If you somehow get your modem  into  a  weird
  2069.         state, inadvertently via manual terminal mode commands, then  the
  2070.         response  of  BGFT may become unpredictable. Just in  case,  BGFT
  2071.         allows  you  to  reinitialize the modem; this  is  done  via  the
  2072.         'Modem'  option  from the utility menu. To do  this,  BGFT  first
  2073.         sends  the 'ATZ' command which, for earlier modems, such  as  the
  2074.         Hayes Smartmodem 300, resets the modem to its power up condition,
  2075.         initializes   its  variables,  reads  the  configuration   switch
  2076.         settings  and does the power up test. For later modems,  such  as
  2077.         the  Hayes  Smartmodem 2400, the 'ATZ' command  resets  the  user
  2078.         configuration.
  2079.  
  2080.         2) Direct Connection
  2081.  
  2082.         Any  characters  you type are transmitted directly to  the  other
  2083.         computer  and  what you see on the screen depends  upon  how  the
  2084.         other computer is set up.
  2085.  
  2086.         5.7 Background Dialing
  2087.         ----------------------
  2088.  
  2089.         An  important feature of BGFT is that it handles dialing  in  the
  2090.         background. That means that if you initiate dialing and then exit
  2091.         BGFT, dialing will continue even though you may use your computer
  2092.         for  other activities. When dialing is complete and a  connection
  2093.         is  made,  an  audible  beeping sound will  be  heard,  that  is,
  2094.         assuming that you are using the default option of 'sound' on.  If
  2095.         you wish to terminate dialing before a connection has been  made,
  2096.         then  this can be done by using the Alt_K 'warm' key if  you  are
  2097.         running  BGFT in terminal mode, or by typing 'BGFT /K'  from  the
  2098.         DOS prompt assuming that you left BGFT earlier.
  2099.  
  2100.         To  assist  you with the process of dialing, BGFT has  a  dialing
  2101.         directory.  The dialing directory can be accessed  from  terminal
  2102.  
  2103.  
  2104.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 33
  2105.         -------------------------------------------- - o -
  2106.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  2107.  
  2108.  
  2109.  
  2110.         mode  via the main menu or the Alt_D 'warm' key. You  can  select
  2111.         any  number as described in 1) below. Hitting 'ENTER'  will  dial
  2112.         the number if you are connected to a modem.
  2113.  
  2114.         The  process  of adding, deleting and  editing  and  manipulating
  2115.         dialing entries can be done either using the menu or using 'warm'
  2116.         keys.
  2117.  
  2118.         The  following operations are possible for the dialing  directory
  2119.         when it is accessed from the Main Menu with the 'dial' choice:
  2120.  
  2121.         1) Selecting a Dialing Entry
  2122.  
  2123.         Choose 'select' and hit 'ENTER'. The currently selected entry  is
  2124.         shown by the highlighted cursor bar. To select another entry:
  2125.  
  2126.            - Use the up and down arrow keys to move one entry at a time.
  2127.  
  2128.            - Use the 'PgUp' and 'PgDn' keys, on the key pad, to move  one
  2129.              page up and down one page at a time.
  2130.  
  2131.            - Use  the  'Home' key, on the key pad, to move to  the  first
  2132.              entry in the directory.
  2133.  
  2134.            - Use the 'End' key, on the key pad, to move to the last entry
  2135.              in the directory.
  2136.  
  2137.            - Move the mouse up or down.
  2138.  
  2139.            - By  typing the first digit of the dialing entry number  (not
  2140.              to  be confused with the actual telephone number), a  window
  2141.              pops  up showing the digit typed. By completing  the  number
  2142.              and  hitting  'ENTER', the entry with the  given  number  is
  2143.              selected.  If you enter a number out of range, a message  to
  2144.              this  effect will be displayed and you will have  to  repeat
  2145.              the process using a valid number.
  2146.  
  2147.            - Typing  'f' or 'F' will display a pop up window that  allows
  2148.              you  to  specify  a character string to search  for  in  the
  2149.              forward  direction;  the search is sensitive  to  case.  The
  2150.              dialing  entry  which contains the first occurrence  of  the
  2151.              given string will be selected. Wildcards are not supported.
  2152.  
  2153.            - Typing  'b' or 'B' will display a pop up window that  allows
  2154.              you  to  specify  a character string to search  for  in  the
  2155.              backward  direction;  the search is sensitive to  case.  The
  2156.              dialing  entry  which contains the first occurrence  of  the
  2157.              given string will be selected. Wildcards are not supported.
  2158.  
  2159.            - If you are not using menus and if after having highlighted a
  2160.              selection, you hit 'ENTER', then the selected number will be
  2161.  
  2162.  
  2163.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 34
  2164.         -------------------------------------------- - o -
  2165.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  2166.  
  2167.  
  2168.  
  2169.              dialed. If you are using menus, Alt_M will return you to the
  2170.              menu bar from which you can select the 'dial' option.
  2171.  
  2172.         Use  the right arrow key to display additional  information  con-
  2173.         tained  in the dialing directory. The password for  the  computer
  2174.         that  you are going to logon to can be seen in this way. Use  the
  2175.         left arrow key to return to the original display. The actions can
  2176.         also be achieved with horizontal mouse movement.
  2177.  
  2178.         Hit 'ESC' to get back to the menu.
  2179.  
  2180.         2) Editing Dialing Entries
  2181.  
  2182.         You can edit the selected (highlighted) dialing entry by choosing
  2183.         the  'edit'  option from the menu bar or, if you  are  not  using
  2184.         menus,  by  means of the Alt_E 'warm' key. A pop  up  data  entry
  2185.         form,  identical to that used when creating new  entries,  allows
  2186.         you to edit all the fields of the highlighted dialing entry.  You
  2187.         will  be prompted to determine if you wish to make these  changes
  2188.         permanent by writing the modified dialing directory to disk.
  2189.  
  2190.         3) Adding Entries
  2191.  
  2192.         You can add a dialing entry by choosing the 'Add' option from the
  2193.         menu  bar or, if you are not using menus, by means of  the  Alt_A
  2194.         'warm' key. The new dialing entry is added immediately after  the
  2195.         selected (highlighted) dialing directory entry. On initiating the
  2196.         'Add' option, a data entry form pops up requesting the  following
  2197.         information:
  2198.  
  2199.         Name: Choose this name to make it easy to identify the  telephone
  2200.         number.  Keywords that you may include can facilitate the  search
  2201.         feature.
  2202.  
  2203.         Number: The telephone number may include the characters: '(', ')'
  2204.         and '-' to assist with readability. The characters, 'W' and  'R',
  2205.         are also allowed by some modem manufacturers and are permissible.
  2206.  
  2207.         Password:  This is optional since it is not used except for  your
  2208.         own information. It should be the password that you will have  to
  2209.         use when you logon to the remote computer system.
  2210.  
  2211.         Baud: BGFT allows 300, 1200, 2400, 4800, and 9600 baud rates.
  2212.  
  2213.         Terminal: This allows you to store, in the dialing directory, the
  2214.         type of terminal emulation you require. This means when you  dial
  2215.         a  particular  number, BGFT will automatically set  the  terminal
  2216.         emulation  to the one specified by this field. The valid  choices
  2217.         are: NONE, ANSI, VT100, and VT52.
  2218.  
  2219.         Data bits: Choose '7' or '8' (default).
  2220.  
  2221.  
  2222.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 35
  2223.         -------------------------------------------- - o -
  2224.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  2225.  
  2226.  
  2227.  
  2228.  
  2229.         Stop bits: Choose '1' (default) or '2'.
  2230.  
  2231.         Parity: Choose 'N' for None (default), 'E' for Even, 'O' for Odd,
  2232.         'M' for Mark, or 'S' for Space.
  2233.  
  2234.         After completing the data entry form (F10), you will be  prompted
  2235.         to see if you wish to make these changes permanent by writing the
  2236.         modified dialing directory to disk.
  2237.  
  2238.         4) Removing Entries
  2239.  
  2240.         You  can delete the dialing entry under the  highlighted  dialing
  2241.         directory  cursor bar by selecting the 'Remove' option  from  the
  2242.         menu  bar or, if you are not using menus, by means of  the  Alt_B
  2243.         'warm' key. You will be prompted to see if you wish to make  this
  2244.         change  permanent  by writing the modified dialing  directory  to
  2245.         disk.
  2246.  
  2247.         5) Dialing an Entry
  2248.  
  2249.         An  entry  can be selected as described in 1) above. If  you  are
  2250.         using menus you can choose the 'Dial' option and dialing will  be
  2251.         initiated. If you are not using menus simply hit 'ENTER'.
  2252.  
  2253.         On initiating dialing an information window pops up to allow  you
  2254.         to confirm that you have dialed the desired number. Assuming that
  2255.         your  modem  is correctly set up then you will hear it  start  to
  2256.         dial. At this time you may do one of the following:
  2257.  
  2258.            - Wait  until  you hear the resident part beep to  inform  you
  2259.              that  a  connection  has been made. You may  also  hear  the
  2260.              familiar sound that the modem makes, if the modem speaker is
  2261.              enabled,  also telling you that a connection has been  made.
  2262.              The  information  window automatically clears  and  terminal
  2263.              mode  is entered. You would normally hit 'ENTER'  until  the
  2264.              remote  computer  issues  you with  a  logon  identification
  2265.              prompt.
  2266.  
  2267.            - Hit any key (except 'ESC') to clear the information  window;
  2268.              this  takes you to the terminal mode screen.  Terminal  mode
  2269.              will  be disabled but it will automatically enable once  the
  2270.              connection has been made.
  2271.  
  2272.              The  advantage  of going straight to terminal mode,  as  de-
  2273.              scribed  above,  is  that you can now make use  of  some  of
  2274.              BGFT's  features (via the Alt_Keys or menus)  while  dialing
  2275.              continues  in background. For example, you could select  the
  2276.              files  menu and prepare some files for uploading and so  not
  2277.              waste time waiting for the connection to be made.
  2278.  
  2279.  
  2280.  
  2281.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 36
  2282.         -------------------------------------------- - o -
  2283.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  2284.  
  2285.  
  2286.  
  2287.            - Type  'Alt_X'  and  leave  BGFT  and  then  run  some  other
  2288.              application  program while dialing continues in  background.
  2289.              This  background ability is what makes BGFT significant.  It
  2290.              is  very convenient to have a background dialing  capability
  2291.              if you are trying to connect to a busy BBS.
  2292.  
  2293.              Most application programs these days allow you to temporari-
  2294.              ly return to DOS without quitting the application. When  you
  2295.              hear the resident part beep, to tell you that the connection
  2296.              has been made, you can, if your system has sufficient  spare
  2297.              memory,  temporarily leave your application and  then  rerun
  2298.              BGFT from the DOS prompt. By so doing, you can logon to  the
  2299.              remote  computer  and initiate the desired  file  transfers,
  2300.              then  leave  BGFT  and  'EXIT'  back  to  your  applications
  2301.              program, carrying on from where you left off. BGFT will take
  2302.              care of your file transfers in background.
  2303.  
  2304.            - Type 'Alt_R' and suspend BGFT.EXE to run other  applications
  2305.              from  the  DOS prompt. You can EXIT back to  BGFT  when  the
  2306.              connection is made.
  2307.  
  2308.            - Hitting  'ESC' will cause dialing to be terminated. This  is
  2309.              useful if you have inadvertently dialed the wrong number.
  2310.  
  2311.         6) Kill Background Dialing
  2312.  
  2313.         Termination of background dialing can be done in three ways:
  2314.  
  2315.         Background dialing may be terminated at any time using the  Alt_K
  2316.         'hot' key while running BGFT.
  2317.  
  2318.         It may also be terminated by selecting the 'Kill' option from the
  2319.         dialing menu bar.
  2320.  
  2321.         If  you  have exited BGFT and you wish to  terminated  background
  2322.         dialing, simply run BGFT with the '/K' command line option, eg.:
  2323.  
  2324.                   BGFT /K
  2325.  
  2326.         This  will  instruct the resident part to terminate  dialing  and
  2327.         will automatically exit BGFT.
  2328.  
  2329.         7) Resident's Status Window
  2330.  
  2331.         The  resident part displays specific dialing information  in  the
  2332.         upper right hand corner while it performs the task of  background
  2333.         dialing. The following is a explanation of the displayed codes:
  2334.  
  2335.              WAIT: dialing is in progress,
  2336.  
  2337.              PAUS:  dialing  has timed out, the resident part  will  wait
  2338.  
  2339.  
  2340.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 37
  2341.         -------------------------------------------- - o -
  2342.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  2343.  
  2344.  
  2345.  
  2346.              'time between calls' seconds and then redial,
  2347.  
  2348.              DIAL: dialing is being reinitiated,
  2349.  
  2350.              STOP: dialing was terminated using one of the following, ESC
  2351.              from the dialing information window, the Alt_K 'hot' key, or
  2352.              the '/K' command line option.
  2353.  
  2354.         5.8 Background File Transfer
  2355.         ----------------------------
  2356.  
  2357.         BGFT supports uploads and downloads for:
  2358.  
  2359.         -  Xmodem-CRC:  This  is the classic CRC version  of  the  Xmodem
  2360.         protocol  which  sends 128 byte packets. No checksum is  done  by
  2361.         BGFT as it is much less reliable than CRC checking, so it was not
  2362.         included. Xmodem-CRC is sometimes known as just Xmodem.
  2363.  
  2364.         - Xmodem-1K: This is the one Kilobyte (1024) byte packet  version
  2365.         of Xmodem-CRC. Xmodem-1K was sometimes known as Ymodem.
  2366.  
  2367.         -  Ymodem-Batch: This is also known as DSZ-Ymodem. This  protocol
  2368.         allows for multiple file transfers and its implementation in BGFT
  2369.         is excellent.
  2370.  
  2371.         Since  the  resident  part of BGFT uses a file  buffer  to  avoid
  2372.         having  to  do DOS calls while running in the background,  it  is
  2373.         occasionally  necessary  to do some file  buffer  'housekeeping'.
  2374.         This  means  that before uploading, the DOS files must  be  moved
  2375.         into  the file buffer and, after downloading, the files  must  be
  2376.         moved from the file buffer to DOS files.
  2377.  
  2378.         5.8.1 The File Buffer
  2379.         ---------------------
  2380.  
  2381.         BGFT uses the concept of a file buffer to avoid having to  access
  2382.         DOS during file transfer (see Section 1.1). When downloading, the
  2383.         data  received is copied into the file buffer. After  downloading
  2384.         is  completed, the file in the file buffer may be copied  into  a
  2385.         regular  DOS  file,  on another drive, through  the  use  of  the
  2386.         'File_move'  command  from the 'File Menu'.  For  uploading,  the
  2387.         files  must  first  be  copied  to  the  file  buffer,  with  the
  2388.         'File_move' command, before the upload is initiated.
  2389.  
  2390.         When  using a given floppy drive as the file buffer,  that  drive
  2391.         becomes unavailable for use by other programs.
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 38
  2400.         -------------------------------------------- - o -
  2401.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  2402.  
  2403.  
  2404.  
  2405.         5.8.2 Downloading
  2406.         -----------------
  2407.  
  2408.         There  are three file transfer protocols available for  download-
  2409.         ing: Xmodem-CRC, Xmodem-1K, and Ymodem-Batch.
  2410.  
  2411.         Section 3.2 described the basic operations to enable your comput-
  2412.         er to accept downloads with BGFT. When the host computer is ready
  2413.         to download to your computer you choose the corresponding  proto-
  2414.         col set up on the host by hitting the 'PgDn' key. You may use the
  2415.         up  or down arrow keys to highlight which choice you want.  Mouse
  2416.         users can move their mouse for the same effect. A window presents
  2417.         the available download protocols.
  2418.  
  2419.         Be  sure that your floppy drive door is shut when you want to  do
  2420.         file transfers.
  2421.  
  2422.         If Xmodem-CRC or Xmodem-1K is selected, then BGFT will prompt for
  2423.         the  file name to be used; if BGFT's 'guess' at the file name  is
  2424.         OK,  which it is if the file name was the last token typed,  just
  2425.         hit 'ENTER' to accept it. If the file name was not the last token
  2426.         typed,  simply use the up arrow key to show the previous  tokens.
  2427.         Continue  until  you find the file name. You may  also  edit  the
  2428.         displayed  token  if  desired;  use Alt_Z  to  show  the  editing
  2429.         details.
  2430.  
  2431.         If  Ymodem-Batch is selected, the file name is received from  the
  2432.         sending  computer  system as part of the  Ymodem-Batch  protocol.
  2433.         When using Ymodem-Batch it is important to keep in mind the  size
  2434.         of  your file buffer (360 or 720 Kilobytes). If BGFT  receives  a
  2435.         file  that will overflow the file buffer, it halts  the  transfer
  2436.         and shows an error in the status display.
  2437.  
  2438.         If  attempting to download with Ymodem-Batch a file that  already
  2439.         exists in the file buffer, the file will be saved with a modified
  2440.         name. The modified name is formed by using punctuation to replace
  2441.         the  first  character  of the file name. Thus the  name  used  is
  2442.         recognizable  and the original file is not overwritten.  The  se-
  2443.         quence  of characters used to replace the first character of  the
  2444.         file  name  is: '$', '#', '&', '@', '!', '{', '}',  '~'.  Only  8
  2445.         levels  of renaming are available; however, this should  be  more
  2446.         than enough in most cases.
  2447.  
  2448.         5.8.3 Manually Moving Downloaded Files
  2449.         --------------------------------------
  2450.  
  2451.         To  move downloaded files manually from the file buffer to a  DOS
  2452.         file, select the 'File' option from the main menu or type 'Alt_F'
  2453.         from  terminal mode. Then select the 'Move' file option  followed
  2454.         by the 'Save File After Download' option from the pop up menu.  A
  2455.         window  pops up and displays the name of your preferred  download
  2456.  
  2457.  
  2458.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 39
  2459.         -------------------------------------------- - o -
  2460.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  2461.  
  2462.  
  2463.  
  2464.         directory,  that is, if you have specified one  previously  using
  2465.         the  'Set_up'  menu. If on the other hand you did not  specify  a
  2466.         download  directory, then BGFT assumes that you wish to  use  the
  2467.         current  directory. You may edit the directory name to suit;  hit
  2468.         'ENTER'  to initiate the moving of all downloaded files from  the
  2469.         file buffer to the specified directory. BGFT displays the name of
  2470.         the file that it is currently moving (saving).
  2471.  
  2472.         5.8.4 Preparing Files For Uploading
  2473.         -----------------------------------
  2474.  
  2475.         There are three file transfer protocols available for  uploading:
  2476.         Xmodem-CRC, Xmodem-1K, and Ymodem-Batch.
  2477.  
  2478.         Uploads  from your computer are initiated by hitting  the  'PgUp'
  2479.         key and transmission protocols are chosen in a similar fashion to
  2480.         downloading. The receiving computer should have been prepared  to
  2481.         receive  the files with the same protocol which is used  to  send
  2482.         files.
  2483.  
  2484.         To  prepare  files for uploading, first go to the  'File'  option
  2485.         either  using  the menu bar or by means of the Alt_F  'warm'  key
  2486.         from terminal mode. In both cases a menu bar appears, select  the
  2487.         'Move'  option. At this point a pop up menu appears,  select  the
  2488.         'Prepare Files For Upload' option. A window appears to allow  you
  2489.         to  select  the directory containing the files that you  wish  to
  2490.         upload. You may do one of the following:
  2491.  
  2492.         1)  Hit 'ENTER' to accept the displayed directory which  will  be
  2493.         the  current directory. There is no provision to have  a  default
  2494.         upload  directory, as was done for the download directory,  since
  2495.         the file buffer is already a holding area for files to be upload-
  2496.         ed.
  2497.  
  2498.         2)  If the current directory does not contain the files that  you
  2499.         wish to upload, then you may edit the directory name and then hit
  2500.         'ENTER' to accept.
  2501.  
  2502.         3) Hitting 'ESC' will return to the 'File' menu bar with out fur-
  2503.         ther action.
  2504.  
  2505.         Having  done 1) above, the files in the chosen directory will  be
  2506.         displayed.  Move  the vertical arrow keys, or use the  mouse,  to
  2507.         highlight the file that you wish to upload. Then hit 'SPACE',  or
  2508.         the  right  mouse  button, to tag the file (note  the  '*'  tag).
  2509.         Repeat  this  for all the files you wish to upload and  then  hit
  2510.         'ENTER',  or the left mouse button, to instruct BGFT to copy  the
  2511.         tagged files into the file buffer. Up to 31 files may be  tagged.
  2512.         There  will be a short delay while the tagged files  are  copied;
  2513.         BGFT then returns you to the 'File' menu bar.
  2514.  
  2515.  
  2516.  
  2517.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 40
  2518.         -------------------------------------------- - o -
  2519.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  2520.  
  2521.  
  2522.  
  2523.         The moved files may have different file sizes than the originals;
  2524.         this is merely a result of transferring files in 512 byte packets
  2525.         and will have no impact on the files themselves.
  2526.  
  2527.         There is also a search facility on the list of files that can  be
  2528.         prepared  for  moving. See Section 5.7(4) for the  basic  method;
  2529.         typing Alt_Z in the 'Prepare Files For Upload' will also  provide
  2530.         help.
  2531.  
  2532.         To  check that you have copied all the files that  you  intended,
  2533.         select the 'List' option. The files contained in the file  buffer
  2534.         will then be displayed. Files tagged ready for upload are  marked
  2535.         with  a 'u'. If, for some reason, the file buffer contains  files
  2536.         that were previously downloaded, then they will be tagged with  a
  2537.         'd'.
  2538.  
  2539.         Ymodem-Batch  upload will upload all the files marked 'u' in  the
  2540.         file buffer. If you decide that you do not need to upload all the
  2541.         files that you placed in the file buffer, after all, then you may
  2542.         delete files as described below:
  2543.  
  2544.         1) Select the 'List' option to list the files.
  2545.  
  2546.         2) Move the cursor bar to highlight the file you wish to delete.
  2547.  
  2548.         3) Hit 'SPACE', or the right mouse button, to tag the file.
  2549.  
  2550.         4) Repeat 3) to tag all files you wish to delete.
  2551.  
  2552.         5) Type 'Alt_D' to initiate the deletion. BGFT responds by asking
  2553.         you  if  you are sure that you wish to delete the  tagged  files,
  2554.         type  'Y'.  After  a brief pause, the files are  deleted  and  an
  2555.         examination  of the file buffer list confirms that  the  unwanted
  2556.         files have been removed.
  2557.  
  2558.         6)  Hit  'ESC' to return to the 'File' menu bar. If  you  deleted
  2559.         files  then an information window will appear to inform you  that
  2560.         the file buffer is being reorganized. This reorganization is done
  2561.         so that the file buffer is optimized for file transfer. This  may
  2562.         take some time if the file buffer contains many large files.
  2563.  
  2564.         5.8.5 Uploading
  2565.         ---------------
  2566.  
  2567.         There are three file transfer protocols available for  uploading:
  2568.         Xmodem-CRC,  Xmodem-1K, and Ymodem-Batch. Before  negotiating  an
  2569.         upload  with the host, use the file menu to copy the files to  be
  2570.         uploaded into the file buffer; see Section 5.8.4. If Ymodem-Batch
  2571.         is  used, then all files marked for upload will be  uploaded.  If
  2572.         one  of the Xmodem upload protocols is used, then the files  must
  2573.         be  specified  individually. You will be prompted  for  the  file
  2574.  
  2575.  
  2576.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 41
  2577.         -------------------------------------------- - o -
  2578.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  2579.  
  2580.  
  2581.  
  2582.         names at the appropriate time.
  2583.  
  2584.         5.9 Utility Functions
  2585.         ---------------------
  2586.  
  2587.         Utility functions can be accessed via the utility menu, which can
  2588.         be  selected  from the main menu or directly from  terminal  mode
  2589.         using  the Alt_U 'warm' key. The utility functions enable you  to
  2590.         perform  such tasks as initializing the floppy diskette that  you
  2591.         intend  to  use for file buffering. The following  functions  are
  2592.         available:
  2593.  
  2594.         1) Acknowledge Communication Errors
  2595.  
  2596.         Occasionally, transmission errors will occur that will  terminate
  2597.         transfer  or prevent transfer from being successfully  initiated.
  2598.         These  errors could, for example, be due to a poor quality  tele-
  2599.         phone line connection or due to running a poorly behaved applica-
  2600.         tions  program  while you are running background  file  transfers
  2601.         (see Appendix 6.7).
  2602.  
  2603.         Errors  are identified by the error codes displayed in the  resi-
  2604.         dent  part's  status window; these codes are listed  in  Appendix
  2605.         6.1.  The errors appear in the form '!!n' where 'n' is some  num-
  2606.         ber.  To  acknowledge an error, select the  'Acknowledge'  option
  2607.         from the menu bar. The resident part's status display is  cleared
  2608.         and shows the familiar 'RDY'. If you reenter terminal mode  after
  2609.         an  error  condition has occurred, then BGFT  will  automatically
  2610.         acknowledge errors.
  2611.  
  2612.         In  the  event  of a Ymodem-Batch upload abort, you  will  get  a
  2613.         timeout condition which may last for an extended period (approxi-
  2614.         mately  one  minute); you will not be able  to  acknowledge  this
  2615.         error  during this period, since it is not yet a hard  error.  If
  2616.         you  are  in a rush, then you will have to  'Kill'  (see  Section
  2617.         5.7(7))  the  transfer  to get the 'hard'  error  condition.  The
  2618.         'Kill'  transfer function automatically acknowledges  the  'hard'
  2619.         error condition that generates it.
  2620.  
  2621.         You  will not be able to access the file buffer until any  errors
  2622.         have been acknowledged.
  2623.  
  2624.         2) Ending Transmission
  2625.  
  2626.         If you are uploading or downloading files and you wish to  'Kill'
  2627.         the transfer, then select the 'End_trans' option.
  2628.  
  2629.         3) Initialize the Floppy Diskette
  2630.  
  2631.         BGFT  uses  a  floppy  diskette as  a  file  buffer  when  either
  2632.         uploading  or  downloading files. Furthermore, BGFT uses  a  non-
  2633.  
  2634.  
  2635.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 42
  2636.         -------------------------------------------- - o -
  2637.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  2638.  
  2639.  
  2640.  
  2641.         standard  format  for  the files that it buffers  on  the  floppy
  2642.         diskette,  so that it is necessary to use BGFT to initialize  the
  2643.         floppy diskette before use. This needs to be done only once. BGFT
  2644.         has  a  number of features designed to reduce the  likelihood  of
  2645.         accidentally initializing a regular DOS formatted diskette. If by
  2646.         chance  you  do  manage to initialize a  DOS  formatted  diskette
  2647.         containing  files  that you wish to keep, all is  not  lost.  The
  2648.         BGFTFLPY.EXE  utility  allows  you to  recover  an  inadvertently
  2649.         initialized diskette.
  2650.  
  2651.         BGFT must only use error free diskettes.
  2652.  
  2653.         To initialize a diskette, simply place a error free DOS formatted
  2654.         diskette  into  the selected floppy disk drive, then  select  the
  2655.         'Initialize'  option.  If the diskette has  not  previously  been
  2656.         initialized  you  will be prompted to confirm that  you  wish  to
  2657.         continue.  If the diskette has previously been  initialized  then
  2658.         initialization  will  occur without further  prompting  providing
  2659.         that it does not contain any files.
  2660.  
  2661.         If  BGFT is, for some reason, unable to initialize the  diskette,
  2662.         then an information window will appear instructing you on how  to
  2663.         proceed.  This  happens  if the floppy drive is  left  open,  for
  2664.         example.
  2665.  
  2666.         4) Turning the Resident Part Off
  2667.  
  2668.         When  the  resident part is active it takes full control  of  the
  2669.         chosen  floppy  drive, even if you have exited BGFT and  are  not
  2670.         transferring  files. This means that if you try to use the  drive
  2671.         for  any other purpose, such as using the DOS format command,  it
  2672.         will  be unavailable and DOS will report an error. To enable  you
  2673.         to  use the drive, you can turn the resident part off  using  the
  2674.         'Resident' option. Normal functioning of BGFT cannot be  achieved
  2675.         unless  the resident part is reenabled. Reenabling  the  resident
  2676.         part  can  be done by selecting the 'Resident' option  again,  or
  2677.         simply  by  rerunning  BGFT, as BGFT  automatically  enables  the
  2678.         resident part when ever you run it.
  2679.  
  2680.         Frequently it will be necessary to disable the resident part when
  2681.         you  are  not running BGFT. For example, suppose  that  you  were
  2682.         using BGFT for file transfers earlier in the day and now you have
  2683.         a  need  to use the floppy drive for some other  purpose.  Rather
  2684.         than  run BGFT, and go to the utility menu to turn  the  resident
  2685.         off, you can toggle the resident part from the command line using
  2686.         the '/R' option. Use:
  2687.  
  2688.                   BGFT /R
  2689.  
  2690.         The resident part may also be activated/suspended using the Alt_A
  2691.         'warm' key from terminal mode.
  2692.  
  2693.  
  2694.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 43
  2695.         -------------------------------------------- - o -
  2696.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  2697.  
  2698.  
  2699.  
  2700.  
  2701.         5) Status
  2702.  
  2703.         Occasionally,  you may find that the resident part's status  win-
  2704.         dow,  which normally displays the 'RDY' code, is not desired  and
  2705.         that you would like to turn it off. A good example is if you  are
  2706.         using  a screen capture program, in that case you  would  capture
  2707.         the 'RDY' as well. To toggle the resident status display  on/off,
  2708.         select the 'Status' option.
  2709.  
  2710.         You can also toggle the status display, from terminal mode, using
  2711.         the Alt_W 'warm' key.
  2712.  
  2713.         6) Modem Initialization
  2714.  
  2715.         By selecting the 'Modem' option, the modem initialization  string
  2716.         is  sent to the modem. This option is only available if  you  are
  2717.         not  using the direct connection option and the line is not  con-
  2718.         nected.
  2719.  
  2720.         This  option is useful for resetting the modem in the  case  that
  2721.         you  have  changed the modem settings (possibly by  running  some
  2722.         other  communications  software which may have some  other  modem
  2723.         setup  requirements). The same modem commands are used  when  you
  2724.         run BGFT for the first time after turning your computer on.
  2725.  
  2726.         7) Data
  2727.  
  2728.         On  selecting the 'Data' information option, BGFT will display  a
  2729.         window  that  shows  the status of a number  of  key  parameters,
  2730.         including the current state of the resident part. In particular,
  2731.  
  2732.         DORMANT       denotes  that  the resident part  is  'idling'  and
  2733.                       ready to accept any commands from BGFT.
  2734.  
  2735.         RECEIVE       denotes that the resident part is downloading  into
  2736.                       the file buffer.
  2737.  
  2738.         TRANSMIT      denotes  that  the resident is uploading  from  the
  2739.                       file buffer.
  2740.  
  2741.         SYNCHRONIZING is  an intermediate state associated  with  RECEIVE
  2742.                       and TRANSMIT.
  2743.  
  2744.         ERROR         denotes that the resident part is in an error state
  2745.                       associated  with a 'hard' error condition.  On  ac-
  2746.                       knowledging this error state the resident part will
  2747.                       return to the DORMANT state.
  2748.  
  2749.         WAIT          denotes  that  the resident part is waiting  for  a
  2750.                       retry condition to clear.
  2751.  
  2752.  
  2753.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 44
  2754.         -------------------------------------------- - o -
  2755.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  2756.  
  2757.  
  2758.  
  2759.  
  2760.         You can also activate this option using the Alt_I 'hot' key  from
  2761.         any location in BGFT.
  2762.  
  2763.         5.10 Exiting BGFT
  2764.         -----------------
  2765.  
  2766.         You may exit BGFT by selecting the quit option from the main menu
  2767.         or by means of the 'hot' key, Alt_X.
  2768.  
  2769.         If  you set 'Confirm Exit' to on, as per Section 5.5.4(1)  above,
  2770.         then a window pops up to ask you if you are sure; typing 'y' will
  2771.         exit from BGFT, typing 'n', or any other key, will return you  to
  2772.         where you were before you requested exit.
  2773.  
  2774.         If you chose not to set 'Confirm Exit', as per Section  5.5.4(1),
  2775.         then BGFT will cleanly and swiftly exit to DOS. Exiting BGFT will
  2776.         not  affect the resident part, particularly if the resident  part
  2777.         is  transferring files. Also, you can reenter BGFT at  any  time;
  2778.         however,  if  you  enter BGFT while  background  transfer  is  in
  2779.         progress, then you will be prevented from entering terminal  mode
  2780.         until the transfer is completed.
  2781.  
  2782.         BGFT also provides an Alt_R key to enable you to run a DOS shell.
  2783.         This means that when you have initiated a file transfer you could
  2784.         run  a  shell so that you can run a DOS  application  while  file
  2785.         transfer  continues in the background. However, this is  not  the
  2786.         recommended  way  because BGFT.EXE uses a substantial  amount  of
  2787.         memory. The recommended way is to exit BGFT with Alt_X. This  way
  2788.         enables  you to maximize the amount of memory available for  your
  2789.         DOS  applications. BGFT was carefully designed to allow quick  in
  2790.         and out access. It remembers your configuration so that you would
  2791.         reenter into the same state that you were in when you left.
  2792.  
  2793.         When you are running the unregistered package you will always see
  2794.         a screen that provides you with registration information. Hit any
  2795.         key to clear this screen and so complete the exit operation.
  2796.  
  2797.         5.11 External Protocols
  2798.         -----------------------
  2799.  
  2800.         The background capabilities of BGFT can be used with most popular
  2801.         telecommunications  programs  such as Telix,  PROCOMM  PLUS,  and
  2802.         Qmodem,  as  an external protocol. BGFT's supported  download  or
  2803.         upload  protocols  are Xmodem-CRC, Xmodem-1K,  and  Ymodem-Batch.
  2804.         BGFT.EXE  is not used to do this; the program BGFTOPT.EXE  allows
  2805.         the installation of BGFT as an external protocol.
  2806.  
  2807.         Users  of BGFTOPT.EXE will think of many other uses for  it.  For
  2808.         example, background dialers can easily be set up. BGFTOPT.EXE  is
  2809.         explained in detail in Section 6.10.
  2810.  
  2811.  
  2812.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 45
  2813.         -------------------------------------------- - o -
  2814.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  2815.  
  2816.  
  2817.  
  2818.  
  2819.         The  basic  idea to using BGFT as an external protocol  to  other
  2820.         telecommunication  programs is to use the script capabilities  of
  2821.         those  programs. One of the main requirements to do this is  that
  2822.         the  script  be capable of exiting  the  host  telecommunications
  2823.         program without hanging up the telephone.
  2824.  
  2825.         While  receiving files in the background, it is  not  recommended
  2826.         that  the telecommunication programs be reentered  into  terminal
  2827.         mode;  file transfers may be disrupted. BGFT.EXE is aware of  the
  2828.         resident  so that it will not go into terminal mode  while  back-
  2829.         ground file transfers take place.
  2830.  
  2831.         Files downloaded via the BGFT file buffer can be moved to any de-
  2832.         sired DOS path by using BGFTOPT.EXE. Use
  2833.  
  2834.              BGFTOPT /3.
  2835.  
  2836.         to  move all the downloaded files, stored in the file buffer,  to
  2837.         the present DOS directory (be sure the '.' is used). Use a  path-
  2838.         name to move them to a different path, for example, use
  2839.  
  2840.              BGFTOPT /3C:\BGFT
  2841.  
  2842.         to  move the files to the BGFT directory. BGFTOPT.EXE will  over-
  2843.         write any files that are duplicates with ones in the file buffer.
  2844.         If  you do not want duplicate files to be overwritten,  then  use
  2845.         BGFT.EXE  which gives you full control, in particular, it  allows
  2846.         you to rename duplicate file names.
  2847.  
  2848.         To  move files from the DOS directory to the file buffer for  up-
  2849.         loading use BGFTOPT.EXE. For example, to move the file, TEST.TXT,
  2850.         to the file buffer for uploading use
  2851.  
  2852.         BGFTOPT /mTEXT.TXT
  2853.  
  2854.         1) Using BGFT as an External Protocol for Telix
  2855.  
  2856.         Background file transfer using BGFT with Telix is accomplished by
  2857.         means  of the provided Telix SALT scripts. These scripts  provide
  2858.         for the selection of a BGFT file transfer protocol and initiation
  2859.         of BGFTOPT.EXE to start the background file transfer. Having done
  2860.         this, the scripts will then make Telix automatically exit to  DOS
  2861.         without  hanging up the telephone line. The file  transfers  will
  2862.         occur just as if they were started with BGFT.EXE.
  2863.  
  2864.         To set yourself up for Telix background file transfers using BGFT
  2865.         move the following files to your Telix directory:
  2866.  
  2867.         BGFTDXTL.SLT   Telix script for Xmodem-CRC/1K download.
  2868.         BGFTDYTL.SLT   Telix script for Ymodem-Batch download.
  2869.  
  2870.  
  2871.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 46
  2872.         -------------------------------------------- - o -
  2873.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  2874.  
  2875.  
  2876.  
  2877.         BGFTUXTL.SLT   Telix script for Xmodem-CRC upload.
  2878.         BGFTUITL.SLT   Telix script for Xmodem-1K upload.
  2879.         BGFTUYTL.SLT   Telix script for Ymodem-Batch upload.
  2880.  
  2881.         BGFTSLC.BAT    Batch file to compile scripts.
  2882.  
  2883.         BGFTTELX.DAT   Data file to append to TELIX.CNF.
  2884.         BGFTADD.BAT    Batch file to update TELIX.CNF.
  2885.  
  2886.         BGFTINIT.BAT   Batch file to initialize BGFT for Telix.
  2887.  
  2888.         BGFTOPT.EXE    Interface program to the resident part of BGFT.
  2889.  
  2890.         The Telix SALT compiler, CS.EXE, must exist in your Telix  direc-
  2891.         tory.
  2892.  
  2893.         In  your  Telix directory, run BGFTSLC.BAT to  compile  the  SALT
  2894.         scripts  for  the external protocol interface between  Telix  and
  2895.         BGFTOPT.
  2896.  
  2897.         To  add the protocols to Telix, you can either follow the  direc-
  2898.         tions in the scripts (manual installation), or run the batch file
  2899.         BGFTADD.BAT. This appends the protocol information to TELIX.CNF.
  2900.  
  2901.         BGFTADD.BAT will install the external protocols as 'A', 'B',  and
  2902.         'C' under the names:
  2903.  
  2904.         BGFTXmdm  - install BGFTDXTL as Xmodem-CRC download.
  2905.                   - install BGFTUXTL as Xmodem-CRC upload.
  2906.  
  2907.         BGFTImdm  - install BGFTDXTL as Xmodem-1K download.
  2908.                   - install BGFTUITL as Xmodem-1K upload.
  2909.  
  2910.         BGFTYmdm  - install BGFTDYTL as Ymodem Batch download.
  2911.                   - install BGFTUYTL as Ymodem Batch upload.
  2912.  
  2913.         If  this is not desirable, for example, if you already use  other
  2914.         external  protocols  as 'A', 'B', or 'C', then you  must  do  the
  2915.         installation manually by following the directions in the scripts.
  2916.  
  2917.         When  you do Alt_O and choose Protocols in Telix you  should  see
  2918.         the following external protocols:
  2919.  
  2920.              Key   Protocol     Upload    Download   BAT or    DL
  2921.                      Name      Filename   Filename   Script   Name
  2922.  
  2923.         A..   B   BGFTXmdm     bgftuxtl   bgftdxtl   Script    Y
  2924.         B..   I   BGFTImdm     bgftuitl   bgftdxtl   Script    Y
  2925.         C..   F   BGFTYmdm     bgftuytl   bgftdytl   Script    N
  2926.  
  2927.         Do the following when you want to use the external protocols. In-
  2928.  
  2929.  
  2930.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 47
  2931.         -------------------------------------------- - o -
  2932.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  2933.  
  2934.  
  2935.  
  2936.         stall  BGFT360K.COM  or BGFT720K.COM for  the  particular  floppy
  2937.         drive  you  wish to use as the file buffer; put a  suitable  BGFT
  2938.         initialized floppy into the drive. Recall that the floppy can  be
  2939.         initialized either by BGFT.EXE or BGFTOPT by using
  2940.  
  2941.         BGFTOPT /i
  2942.  
  2943.         The  batch file BGFTINIT.BAT is used to initialize BGFT prior  to
  2944.         running  Telix. This file must be edited to contain  the  desired
  2945.         information about your modem's communication port number and baud
  2946.         rate  prior  to use (default is 1200 baud,  serial  communication
  2947.         port  1). You must run the batch file BGFTINIT.BAT to  make  sure
  2948.         that BGFT is set up properly. THIS MUST BE DONE before using BGFT
  2949.         as an external protocol for any communications package.
  2950.  
  2951.         When  you are ready to start a file transfer, select the  correct
  2952.         BGFT protocol from the list given by Telix when 'PgDn' or  'PgUp'
  2953.         is pressed. Not all Telix prompts are valid in the BGFT  context;
  2954.         see the SLT files for further information.
  2955.  
  2956.         When  the file transfer has been completed, you may  enter  Telix
  2957.         again without disturbing the connection by using:
  2958.  
  2959.              TELIX O
  2960.  
  2961.         (the  'O'  tells  Telix  not to  send  the  modem  initialization
  2962.         string).
  2963.  
  2964.         Notes on use:
  2965.  
  2966.         -  Some  modems respond to a 'break' character  by  switching  to
  2967.         command mode. This will prevent BGFT from carrying out background
  2968.         file  transfers.  Telix  appears to generate a  'break'  when  it
  2969.         exits; therefore, the modem should be set to ignore 'break' (this
  2970.         is usually possible, consult your modem manual).
  2971.  
  2972.         -  BGFT360K.COM, or BGFT720K.COM, must be loaded first, that  is,
  2973.         before  the  communication program that is to call  the  external
  2974.         background  protocol. If the BGFT resident part is loaded  after,
  2975.         then  the communication program will be locked into memory.  This
  2976.         takes  up  unnecessary memory when you want to  end  its  calling
  2977.         duties and work in the foreground while background transfers take
  2978.         place. (In fact, when you use BGFT often, you will probably  want
  2979.         to  install the resident part from your AUTOEXEC.BAT  file,  just
  2980.         like your other favorite TSRs).
  2981.  
  2982.         -  It is important not to enter Telix again while a  transfer  is
  2983.         proceeding.  Unlike BGFT, Telix is unable to detect that a  back-
  2984.         ground  file  transfer is occurring, and will  go  into  terminal
  2985.         mode, thereby interfering with the file transfer.
  2986.  
  2987.  
  2988.  
  2989.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 48
  2990.         -------------------------------------------- - o -
  2991.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  2992.  
  2993.  
  2994.  
  2995.         - Uploads are done with files that are in the file buffer and not
  2996.         with  those in the Telix default upload directory.  Nevertheless,
  2997.         Telix will search the upload directory and will report no  match-
  2998.         ing  files  if  the  named file is not found.  Telix  has  to  be
  2999.         tricked; the same files on the file buffer should be in the Telix
  3000.         upload  directory,  to keep both BGFT and Telix  happy.  See  the
  3001.         file, BGFTUXTL.SLT, for an explanation.
  3002.  
  3003.         -  Xmodem-CRC and Xmodem-1K downloads are treated the  same  when
  3004.         using  BGFTOPT.EXE;  that is, they use the same  BGFTOPT  command
  3005.         line  switch, '/=1'. The resident part is able to select  between
  3006.         the two automatically on download.
  3007.  
  3008.         - Xmodem-CRC also uses the '/=1' switch for upload. In this case,
  3009.         the  file  for  upload switch, '/u', and the  file  for  download
  3010.         switch,  '/e', differentiate the uploading and downloading  func-
  3011.         tions.
  3012.  
  3013.         2) Using BGFT as an External Protocol for PROCOMM PLUS
  3014.  
  3015.         PROCOMM PLUS also has a good script language to allow BGFT to  be
  3016.         used as an external protocol. The manner in which this is done is
  3017.         explained  in detail in the file, BGFTDYPC.ASP. Essentially,  the
  3018.         PROCOMM PLUS ASPECT scripts are run with the PROCOMM PLUS  Alt_F5
  3019.         command and not as installed external protocols. When BGFTOPT.EXE
  3020.         is  run, the resident part of BGFT will do the file transfer  and
  3021.         PROCOMM PLUS will be exited with the connection kept on-line.  As
  3022.         with  Telix,  you  will be able to use your  computer  for  other
  3023.         things  while the files are being transferred in the  background.
  3024.         The  user  should  not reenter PROCOMM PLUS  when  transfers  are
  3025.         occurring. The ASPECT language scripts should be in the directory
  3026.         used by PROCOMM PLUS.
  3027.  
  3028.         A  list of available script files is found in Section  3.1;  they
  3029.         have a file extension, ASP.
  3030.  
  3031.         3) Using BGFT as an External Protocol for Qmodem
  3032.  
  3033.         Qmodem  is a very simple program to interface to  BGFT  capabili-
  3034.         ties.  Qmodem has similar usage as PROCOMM PLUS and the  detailed
  3035.         instructions are to be found in BGFTDYQM.SCR, which is the Qmodem
  3036.         script to download with BGFT's Ymodem-Batch.
  3037.  
  3038.         A  list of available script files is found in Section  3.1;  they
  3039.         have a file extension, SCR.
  3040.  
  3041.         The version of Qmodem considered for script operation is 4.2E.
  3042.  
  3043.         Qmodem  scripts are run by typing 'Alt_F' and providing the  file
  3044.         name to execute.
  3045.  
  3046.  
  3047.  
  3048.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 49
  3049.         -------------------------------------------- - o -
  3050.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  3051.  
  3052.  
  3053.  
  3054.         6. Appendices
  3055.         --------------
  3056.         6.1 Error Messages
  3057.         ------------------
  3058.  
  3059.         The  resident part displays error messages in its  status  window
  3060.         when it is turned on. The status window is a small four character
  3061.         'window'  normally  located  at the upper  right  corner  of  the
  3062.         screen.  The error messages are displayed in the form:  '**n'  or
  3063.         '!!n' (where n is a number). The '**' messages are 'soft'  errors
  3064.         which  do  not cause file transfer to stop; the '!!'  errors  are
  3065.         'hard' which will cause the file transfer to terminate.
  3066.  
  3067.         All hard errors must be acknowledged. You should use the  Utility
  3068.         menu to acknowledge hard errors or enter terminal mode where  the
  3069.         acknowledgement is done automatically.
  3070.  
  3071.         The following is a list of the error messages:
  3072.  
  3073.         **0   In download or upload this is a timeout while synchronizing
  3074.               to  the host. It is normal to receive one of these  at  the
  3075.               beginning of a transfer.
  3076.  
  3077.         **1   In  download  (only), this is a timeout while  receiving  a
  3078.               block.  The usual cause of this is that something has  hap-
  3079.               pened  to lose a character; for example, running a  program
  3080.               during background transfers that disables interrupts for an
  3081.               excessive  period  of  time, which is common  of  some  CGA
  3082.               programs.
  3083.  
  3084.         **2   This is a block check error during transfer. The block will
  3085.               be  present  according  to the  Xmodem-CRC,  Xmodem-1K,  or
  3086.               Ymodem-Batch protocols.
  3087.  
  3088.         **3   This is a CRC error, meaning the block had bad data in  it.
  3089.               This may be experienced if the telephone line is noisy.
  3090.  
  3091.         **4   This is a duplicate block error, meaning the host sent  the
  3092.               same block twice for some reason. This is highly unusual.
  3093.  
  3094.         !!0   This  is a fatal timeout that would occur if the  host  was
  3095.               not responding.
  3096.  
  3097.         !!1   This error means that the host canceled the transfer.
  3098.  
  3099.         !!2   This  is a fatal block error that occurs if the host  sends
  3100.               the wrong block.
  3101.  
  3102.         !!3   This occurs when the user requests to halt the transfer.
  3103.  
  3104.  
  3105.  
  3106.  
  3107.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 50
  3108.         -------------------------------------------- - o -
  3109.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  3110.  
  3111.  
  3112.  
  3113.         !!4   This occurs when a floppy I/O error occurs, thereby  abort-
  3114.               ing the transfer.
  3115.  
  3116.         !!5   This occurs during download (Ymodem-Batch only) if the file
  3117.               being received is too large to fit into the space remaining
  3118.               in the file buffer.
  3119.  
  3120.         !!6   This  occurs  when the Ymodem-Batch upload  header  is  not
  3121.               acknowledged.
  3122.  
  3123.         6.2 Alt_Key Summary
  3124.         -------------------
  3125.  
  3126.         An  'Alt_Key'  combination, Alt_X, is performed by  pressing  the
  3127.         'Alt' key and then the given key 'X' (or 'x') together momentari-
  3128.         ly.
  3129.  
  3130.         BGFT  provides  both menus and Alt_Key  combination  to  navigate
  3131.         through the program. The Alt_Key combinations are used to provide
  3132.         a fast alternative to the menu system and can be viewed as 'acce-
  3133.         lerator' keys. There are two kinds of these 'accelerator' keys:
  3134.  
  3135.         1) 'Hot' Keys
  3136.  
  3137.         In particular, BGFT provides the following 'hot' keys, which have
  3138.         the same function wherever they are applied:
  3139.  
  3140.              Alt_I     gives Information on BGFT360K or BGFT720K status.
  3141.              Alt_K     Kills background dialing.
  3142.              Alt_R     Runs a DOS shell.
  3143.              Alt_X     Exits BGFT.
  3144.  
  3145.         To  avoid  the possibility of spoiling input data, Alt_X  is  not
  3146.         active  if  in the process of entering data via one of  the  data
  3147.         entry forms.
  3148.  
  3149.         2) 'Warm' Keys
  3150.  
  3151.         Warm  keys are keys that are active only within a given  context.
  3152.         BGFT  provides  online  help to give  the  following  'warm'  key
  3153.         information on-line.
  3154.  
  3155.         Terminal Mode:
  3156.  
  3157.              Alt_A    to suspend/Activate the resident part.
  3158.              Alt_C    to Clear the screen.
  3159.              Alt_D    for Dialing directory.
  3160.              Alt_F    for File options.
  3161.              Alt_H    to Hang up the line.
  3162.              Alt_M    to show Menus.
  3163.              Alt_O    for an Overview of BGFT operation.
  3164.  
  3165.  
  3166.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 51
  3167.         -------------------------------------------- - o -
  3168.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  3169.  
  3170.  
  3171.  
  3172.              Alt_S    to Set up configuration.
  3173.              Alt_U    for Utility options.
  3174.              Alt_W    to toggle the status Window.
  3175.  
  3176.         Dialing Directory:
  3177.  
  3178.              Alt_A    to Add a new entry after the current entry.
  3179.              Alt_B    to delete (Banish) the current entry.
  3180.              Alt_E    to Edit the current entry.
  3181.              Alt_H    to provide Help for selecting entries.
  3182.              Alt_M    to show Menus.
  3183.              Alt_T    to return to Terminal mode.
  3184.  
  3185.         Prepare Files for Uploading:
  3186.  
  3187.              Alt_M    to show Menus.
  3188.              Alt_T    to return to Terminal mode.
  3189.  
  3190.         Floppy Diskette Directory Listing:
  3191.  
  3192.              Alt_D    to Delete the tagged files.
  3193.              Alt_M    to show Menus.
  3194.              Alt_T    to return to Terminal mode.
  3195.  
  3196.         6.3 Multitasking and Communications
  3197.         -----------------------------------
  3198.  
  3199.         Multitasking with DOS is one of those ideas that is much  simpler
  3200.         in theory than in practice. DOS just was not designed to do  more
  3201.         than one job at a time. Even the common exceptions to this,  such
  3202.         as the DOS print spooler or 'pop up' type programs, are  specific
  3203.         to the application at hand and the techniques used to achieve the
  3204.         multitasking are not generally applicable.
  3205.  
  3206.         The 'lifeline' of a multitasking system is interrupts. Even  more
  3207.         importantly,  a  communications program relies on  interrupts  to
  3208.         process characters when they are received. If the characters  are
  3209.         not 'taken away', then they will be lost. If an application  pro-
  3210.         gram can easily disable interrupts then multitasking, and  there-
  3211.         fore communications, is going to be unreliable at best.  Unfortu-
  3212.         nately with DOS on a PC, this is the case.
  3213.  
  3214.         Another  major problem with DOS, as far as multitasking  is  con-
  3215.         cerned, is that DOS is non-reentrant. This means that DOS  cannot
  3216.         be  easily shared by applications running at the same time.  This
  3217.         is because its data areas are not protected from simultaneous ac-
  3218.         cess.
  3219.  
  3220.         Most  TSRs,  eg. pop ups, work around the reentrant  problems  by
  3221.         trying to determine when DOS is busy; however, many DOS  internal
  3222.         routines,  such as the 'TYPE' command for example, keep DOS  busy
  3223.  
  3224.  
  3225.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 52
  3226.         -------------------------------------------- - o -
  3227.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  3228.  
  3229.  
  3230.  
  3231.         for  as long as they execute. This again is a problem for  multi-
  3232.         taskers.
  3233.  
  3234.         OK, that is the bad news. The good news is that it is possible to
  3235.         circumvent DOS, or in some cases to ignore it.
  3236.  
  3237.         BGFT uses the latter approach. It does not use DOS in any part of
  3238.         the file transfer operation; therefore, it cannot be affected  by
  3239.         DOS being busy.
  3240.  
  3241.         Disabling  interrupts  is another story. With a  PC  running  DOS
  3242.         there is just no way to prevent disabling interrupts from happen-
  3243.         ing  if  a running piece of software does it. This is  true  even
  3244.         with  sophisticated multitaskers like Microsoft Windows  386  and
  3245.         DESQview 386.
  3246.  
  3247.         BGFT  performs  as well as running  a  'standard'  communications
  3248.         program  under one of those multitaskers but does not require  an
  3249.         Intel 80386 CPU and does not use anywhere near as much memory.
  3250.  
  3251.         The  consequence  of  the interrupt disabling  problem  for  file
  3252.         transfer  is that retries will occur during downloading. If  this
  3253.         is  considered to be a serious problem in your application,  then
  3254.         there are some possible hardware solutions such as the  NS16550AS
  3255.         chip  for  your COM port; if you are a registered  user,  contact
  3256.         Dirac Systems for assistance in this area.
  3257.  
  3258.         BGFT will automatically detect the presence of the NS16550AS chip
  3259.         and take advantage of its capabilities.
  3260.  
  3261.         6.4 BGFT and DESQview
  3262.         ---------------------
  3263.  
  3264.         BGFT  works  exceptionally well with  DESQview,  particularly  on
  3265.         computers  that have expanded memory or with DESQview  386  which
  3266.         emulates  EEMS by using extended memory. This is because  of  the
  3267.         following two reasons:
  3268.  
  3269.         1)  On  the  Intel  80386  CPU,  the  'LOADHI'  program  can  run
  3270.         BGFT360K.COM or BGFT720K.COM outside the 640K DOS address  range.
  3271.         This  means  that the resident part of BGFT does not use  up  any
  3272.         conventional memory.
  3273.  
  3274.         When  installing  QEMM.SYS it is necessary to specify  the  'ram'
  3275.         option. This is configuration dependent; see your DESQview user's
  3276.         manual or give us a call as we may be able to help.
  3277.  
  3278.         2) BGFT does not need to be made non-swappable. Thus DESQview can
  3279.         swap BGFT.EXE to disk or to expanded memory without affecting the
  3280.         communications.
  3281.  
  3282.  
  3283.  
  3284.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 53
  3285.         -------------------------------------------- - o -
  3286.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  3287.  
  3288.  
  3289.  
  3290.         If  you use DESQview then give BGFT a try. That is the  advantage
  3291.         of Shareware.
  3292.  
  3293.         6.5 BGFT and Microsoft Windows
  3294.         ------------------------------
  3295.  
  3296.         BGFT is Microsoft Windows 3 compatible. Many DOS based telecommu-
  3297.         nications  programs  cannot even run under Windows.  Others  will
  3298.         have  problems  when trying to run Windows applications  and  DOS
  3299.         programs; this is especially true for 286 or 8086 based machines.
  3300.  
  3301.         BGFT allows the user to engage in DOS as well as Windows 3 activ-
  3302.         ities while doing background transfers. Even Windows based  tele-
  3303.         communication programs will generally not let you do that if  not
  3304.         running in 386 protected mode.
  3305.  
  3306.         You must install the BGFT resident, BGFT360K.COM or BGFT720K.COM,
  3307.         before  running  Windows. You must also initialize  the  resident
  3308.         with the communications port and baud rate by using a variant  of
  3309.         the supplied batch file, BGFTINIT.BAT. Alternatively, you can run
  3310.         BGFT.EXE briefly to automatically do the initialization. You  may
  3311.         then run Windows and use BGFT as you would normally.
  3312.  
  3313.         Your Windows documentation will show you how to install  BGFT.EXE
  3314.         as a non-Windows application. The basic procedure is as  follows.
  3315.         In  the  Program Manager of Windows choose the  DOS  applications
  3316.         group  that you may have. Choose 'File' from the Program  Manager
  3317.         and  then choose 'New' to install BGFT as an item of  the  group.
  3318.         Where is asks for a 'Description' put in 'BGFT'. Click with  your
  3319.         mouse  onto  the 'Command line' prompt and enter  the  path  name
  3320.         where BGFT can be found; for example,
  3321.  
  3322.              C:\BGFT\BGFT.EXE
  3323.  
  3324.         You  can activate BGFT by clicking twice on the icon  you  choose
  3325.         from the Program Manager.
  3326.  
  3327.         A Windows 3 program, BGFTSPY.EXE, is included with BGFT to  allow
  3328.         you  to  monitor background file transfers while  you  use  other
  3329.         Windows  programs.  Install  BGFTSPY.EXE as  above  and  call  it
  3330.         BGFTSPY;  the  supplied icon, BGFTSPY.ICO, will also  be  loaded.
  3331.         This program is most useful in minimized mode as it will show, in
  3332.         a compact form, the file packet number during file transfers  and
  3333.         other  status messages from the BGFT resident program.  In  maxi-
  3334.         mized mode it will show more information. It is loaded in  iconic
  3335.         form  which is minimized mode; click twice on the icon for  maxi-
  3336.         mized mode.
  3337.  
  3338.         You should only run BGFTSPY.EXE if the BGFT resident program  has
  3339.         been installed.
  3340.  
  3341.  
  3342.  
  3343.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 54
  3344.         -------------------------------------------- - o -
  3345.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  3346.  
  3347.  
  3348.  
  3349.         To  use BGFT.EXE with older versions of Microsoft Windows  it  is
  3350.         again  necessary  to load BGFT360K.COM or BGFT720K.COM  prior  to
  3351.         running   Windows;  this  is  true  for  both   Windows/286   and
  3352.         Windows/386.   BGFT  may  then  be  executed  as   a   'standard'
  3353.         application under Windows. Windows will complain about a conflict
  3354.         with the COM port; select BGFT.EXE in the dialogue box and OK.
  3355.  
  3356.         For  Windows/386 it is important that the  parameter  'windowmem-
  3357.         size' in the WIN.INI file is left at the default of 640.
  3358.  
  3359.         The primary advantage to using BGFT.EXE under Windows, instead of
  3360.         a  standard DOS communications package, is that BGFT.EXE  can  be
  3361.         'swapped'  out of memory whereas the standard DOS  communications
  3362.         package  would have to remain 'locked' in memory, using up  valu-
  3363.         able  address space. This may be of importance in  some  applica-
  3364.         tions such as Windows 2.X with expanded memory.
  3365.  
  3366.         If you use both DOS and Windows on an AT compatible computer then
  3367.         BGFT may be your best bet. Try it out.
  3368.  
  3369.         6.6 Systems Without a Hard Drive
  3370.         --------------------------------
  3371.  
  3372.         Even  though BGFT360K.COM or BGFT720K.COM makes exclusive use  of
  3373.         drive  A: or B: floppy, it is possible to use the system  with  a
  3374.         computer  having only two floppy drives. Of course, the range  of
  3375.         operation will be limited, but it is possible.
  3376.  
  3377.         In  order to run your application from drive B:, it is  necessary
  3378.         to  set the COMSPEC environment variable to point to  COMMAND.COM
  3379.         on drive B:. Use a command like:
  3380.  
  3381.                   SET COMSPEC=B:COMMAND.COM
  3382.  
  3383.         which  may be placed in your AUTOEXEC.BAT file. Of  course,  COM-
  3384.         MAND.COM must be present on drive B: in order for DOS to  operate
  3385.         correctly.
  3386.  
  3387.         6.7 Problem Solving
  3388.         -------------------
  3389.  
  3390.         Some  programs, usually games, are not compatible with  BGFT.  In
  3391.         most  cases,  the  conflict will be  evident  as  retries  during
  3392.         download.  The  retries are caused by the  application  disabling
  3393.         interrupts  and,  therefore, causing characters to be  lost.  The
  3394.         best  thing to do is to experiment; in some cases,  reducing  the
  3395.         baud rate may help.
  3396.  
  3397.  
  3398.  
  3399.  
  3400.  
  3401.  
  3402.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 55
  3403.         -------------------------------------------- - o -
  3404.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  3405.  
  3406.  
  3407.  
  3408.         6.8 Operating Limitations
  3409.         -------------------------
  3410.  
  3411.         Users should be aware of the following limitations:
  3412.  
  3413.         1) Maximum baud rate is 9600. Higher baud rates will tie up  your
  3414.         CPU too much for effective foreground use by other programs.
  3415.  
  3416.         2) Floppy diskette file buffers should not have any bad sectors.
  3417.  
  3418.         3) The floppy drive used for the file buffers is unavailable  for
  3419.         DOS while under the control of BGFT360K or BGFT720K.
  3420.  
  3421.         4)  The  file buffer can have a total maximum of  31  files.  The
  3422.         files can be downloads or uploads.
  3423.  
  3424.         5) When running graphics applications with a monochrome  graphics
  3425.         card,  BGFT360K  or BGFT720K does not automatically  disable  its
  3426.         status  display  as it does with color systems.  This  is  easily
  3427.         overcome  by  the user manually disabling the  display  from  the
  3428.         Utility menu before running the application. Even if this is  not
  3429.         done,  there  will usually only be a remnant of the  BGFT360K  or
  3430.         BGFT720K  display  window appearing  during  monochrome  graphics
  3431.         applications.
  3432.  
  3433.         6.9 Nomenclature
  3434.         ----------------
  3435.  
  3436.         Alt_X:  An 'Alt_Key' combination, performed by pressing  the  Alt
  3437.         key and then the given key 'X' (or 'x') together momentarily.
  3438.         ASPECT: Trademark of Datastorm Technologies Inc.
  3439.         AT:  Advanced  Technology  computer based on an  Intel  80286  or
  3440.         higher central processing unit.
  3441.         BBS: Bulletin Board Service.
  3442.         BGFT:  BackGround File Transfer System, trademark of  Dirac  Sys-
  3443.         tems.
  3444.         BIOS: Basic Input/Output System.
  3445.         CompuServe: Registered trademark of CompuServe Incorporated.
  3446.         CRC: Cyclic Redundancy Check.
  3447.         CRS: Canada Remote Systems.
  3448.         DESQview: Trademark of Quarterdeck Office Systems.
  3449.         DOS: Disk Operating System.
  3450.         ENTER: The Enter or Return key.
  3451.         ESC: The Escape key.
  3452.         Fxx: A function key, for example, F10 to accept data from a  data
  3453.         entry form.
  3454.         IBM:  Registered  trademark of  International  Business  Machines
  3455.         Corporation.
  3456.         Microsoft Windows: Registered trademark of Microsoft Corporation.
  3457.         MS DOS: Registered trademark of Microsoft Corporation.
  3458.         PROCOMM: Registered trademark of Datastorm Technologies Inc.
  3459.  
  3460.  
  3461.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 56
  3462.         -------------------------------------------- - o -
  3463.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  3464.  
  3465.  
  3466.  
  3467.         PROCOMM PLUS: Trademark of Datastorm Technologies Inc.
  3468.         PgDn: Page Down key, for requesting a download.
  3469.         PgUp: Page Up key, for requesting an upload.
  3470.         Qmodem: Trademark of The Forbin Project.
  3471.         SALT: Trademark of Exis Inc.
  3472.         Smartmodem: Registered trademark of Hayes Microcomputer Products.
  3473.         SPACE: The Space bar.
  3474.         Telix: Trademark of Exis Inc.
  3475.         TSR: Terminate and Stay Resident.
  3476.  
  3477.         6.10 Command Mode Options Using BGFTOPT.EXE
  3478.         -------------------------------------------
  3479.  
  3480.         BGFTOPT.EXE can be used in place of BGFT.EXE where a simple  user
  3481.         interface  is needed. For example, BGFTOPT.EXE would be used  for
  3482.         installing  BGFT  external  file transfer  protocols  in  another
  3483.         communications  package.  BGFTOPT.EXE  is used  to  send  certain
  3484.         pertinent  messages to the resident about the file transfer  such
  3485.         as the chosen communication port, baud rate, and file name.
  3486.  
  3487.         The  supplied  files with file extension SCR, SLT  and  ASP  give
  3488.         examples on how BGFTOPT is used to support background file trans-
  3489.         fers  for external protocols in Qmodem, Telix and  PROCOMM  PLUS.
  3490.         See  the files for further explanations, in particular, the  Ymo-
  3491.         dem-Batch download scripts.
  3492.  
  3493.         BGFTOPT.EXE is able to send and receive a number of messages from
  3494.         the  resident  part of BGFT. This is accomplished  by  using  the
  3495.         command line switches that are provided. For example, suppose you
  3496.         are  in  the DOS shell and the 'RDY' window  indicated  an  error
  3497.         condition  such as '!!1' due to the host canceling the  transfer.
  3498.         This 'hard' error condition can be acknowledged by entering:
  3499.  
  3500.              BGFTOPT /A
  3501.  
  3502.         The  '/A'  is referred to as a switch and is a DOS  command  line
  3503.         argument  (input) to BGFTOPT.EXE. The case of the switch  is  not
  3504.         significant,  so  that '/a' would produce the  same  result.  The
  3505.         space is not required between BGFTOPT and the switch '/'  symbol.
  3506.         However, there should not be a space between the '/' and the 'a';
  3507.         for example, '/ a', would be incorrect.
  3508.  
  3509.         Some of the switches can be chained, such as:
  3510.  
  3511.              BGFTOPT /a1
  3512.  
  3513.         which would acknowledge any error and then hang up the phone. The
  3514.         chain  is parsed from left to right. A chain starts with the  '/'
  3515.         symbol.
  3516.  
  3517.         If quiet mode, '/q', is not switched on, then most switches  will
  3518.  
  3519.  
  3520.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 57
  3521.         -------------------------------------------- - o -
  3522.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  3523.  
  3524.  
  3525.  
  3526.         give a little message. For example, the '/a' switch will announce
  3527.         "Acknowledging  error" plus an internal BGFTOPT reporting  number
  3528.         which can be used to test for an error exit (in general,  BGFTOPT
  3529.         will  return  with a '0' if no error occurs). The  switch  chain,
  3530.         '/qa', will not produce a message, for example.
  3531.  
  3532.         The chains can be broken with no effect such as in the case:
  3533.  
  3534.              BGFTOPT /a /a
  3535.  
  3536.         This is the same as if there was one switch chain, '/aa'. If  the
  3537.         chain is broken then there must be at least one space  separating
  3538.         each chain.
  3539.  
  3540.         Continuous chains can be used for the following set of symbols:
  3541.  
  3542.         ? a h i k q s t 1 4 5 6 9
  3543.  
  3544.         This is shown in the usage prototype which appears when the  help
  3545.         screen is produced by using the '/?' switch. The first part of it
  3546.         looks like:
  3547.  
  3548.         BGFTOPT[/?ahikqst14569 ]
  3549.  
  3550.         The  square brackets indicate the any one of the symbols  can  be
  3551.         chained together in any logical fashion; they may be repeated.
  3552.  
  3553.         Sometimes  broken  chains must be used so that the  command  line
  3554.         parser can determine the correct instructions for BGFTOPT. Notice
  3555.         that  the prototype above ends with a space just before the  ']';
  3556.         this  indicates  that the other command line switches  should  be
  3557.         switches that are separated by at least one space. The  prototype
  3558.         for these switches could be shown as:
  3559.  
  3560.         BGFTOPT[ /~<#>][ /b<#>][ /d<filename>][ /m<filename>][ /r<#>]
  3561.                [ /u<filename>][ /3<pathname>][ /7<parity>][ /8<parity>]
  3562.                [ /0<P|T><#>]
  3563.  
  3564.         For example, one could manage the switches like:
  3565.  
  3566.              BGFTOPT /5a /r2 /b1200 /~1 /dtest.txt /s
  3567.  
  3568.         which  would activate the resident part of BGFT, acknowledge  any
  3569.         errors, reconnect the second serial communications port, set  the
  3570.         port's baud rate to 1200 baud, choose Xmodem download, tell  BGFT
  3571.         to  expect  a file called 'test.txt', and send a  signal  to  the
  3572.         remote host to start sending the file.
  3573.  
  3574.         The  following  notes describe all the  available  switches.  See
  3575.         above for examples on their usage.
  3576.  
  3577.  
  3578.  
  3579.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 58
  3580.         -------------------------------------------- - o -
  3581.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  3582.  
  3583.  
  3584.  
  3585.         1) /~<Protocol>
  3586.              1 for XMODEM-CRC or XMODEM-1K download or XMODEM-CRC upload
  3587.              2 for YMODEM-Batch download
  3588.              3 for YMODEM-Batch upload
  3589.              4 for XMODEM-1K upload
  3590.  
  3591.         One  of  the  four values (1, 2, 3, or 4) is to  be  entered  for
  3592.         <Protocol>  depending on the desired transmission  protocol.  The
  3593.         number should be right next to the '~'. The resident part of BGFT
  3594.         will  automatically distinguish whether a downloaded  packet  for
  3595.         Xmodem is of the 128 byte (CRC) or 1024 (1K) byte size. Also, for
  3596.         Xmodem,  selecting upload or download is done when  entering  the
  3597.         file name. When using Ymodem upload or download, there is no need
  3598.         to give a command line entry for the file names since the  proto-
  3599.         col provides them. YMODEM stands for Ymodem-Batch.
  3600.  
  3601.         Summary:
  3602.  
  3603.              Xmodem-CRC download needs the switch, '/~1'.
  3604.              Xmodem-1K download needs the switch, '/~1'.
  3605.              Ymodem-Batch download needs the switch, '/~2'.
  3606.              Xmodem-CRC upload needs the switch, '/~1'.
  3607.              Ymodem-Batch download needs the switch, '/~3'.
  3608.              Xmodem-1K upload needs the switch, '/~4'.
  3609.  
  3610.         2) /? Display this help screen
  3611.  
  3612.         This  displays a help screen which shows the  Copyright  informa-
  3613.         tion, the prototypes for BGFTOPT, and a short reminder what  each
  3614.         switch  does. The reminder is stated in a similar fashion  as  to
  3615.         what  is seen in this list of switches. The screen  is  displayed
  3616.         when an unknown or illegal command is entered.
  3617.  
  3618.         The help screen is also displayed when only 'BGFTOPT' is entered,
  3619.         that  is, without any switches. BGFTOPT will return '0'  if  both
  3620.         the port and the baud rate are set, and '1' otherwise.
  3621.  
  3622.         3) /a Acknowledge error
  3623.  
  3624.         Hard errors must be acknowledged.
  3625.  
  3626.         4) /b<Baud> 300,1200,2400,4800,9600
  3627.  
  3628.         One  of the five indicated values is to be used for <Baud  rate>.
  3629.         The  number  should be right next to the 'b.  The  communications
  3630.         port must have its baud rate set appropriately.
  3631.  
  3632.         5) /d<filename> Download file entry
  3633.  
  3634.         The  name of the file being downloaded should be  inserted  right
  3635.         next  to  the 'd'. The Xmodem download protocols require  that  a
  3636.  
  3637.  
  3638.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 59
  3639.         -------------------------------------------- - o -
  3640.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  3641.  
  3642.  
  3643.  
  3644.         file name be supplied; Ymodem-Batch does not.
  3645.  
  3646.         6) /h Halt background file transfer
  3647.  
  3648.         A file transfer, either upload or download, which is in  progress
  3649.         may  be  terminated with this switch. This will  produce  a  hard
  3650.         error condition '!!3' which must be acknowledged. The remote sys-
  3651.         tem,  that  was communicating, will time out due to  not  hearing
  3652.         from the halted system.
  3653.  
  3654.         7) /i Initialize file buffer
  3655.  
  3656.         The  file  buffer  is initialized for use by  BGFT.  The  correct
  3657.         floppy  drive will be accessed since it is known by the  resident
  3658.         program, which should be loaded and active. Any DOS floppies used
  3659.         as the file buffer must have been formatted by DOS and checked by
  3660.         CHKDSK for error free condition.
  3661.  
  3662.         Using this function on BGFT initialized file buffers will  delete
  3663.         BGFT directory information. This effectively 'erases' the buffer.
  3664.  
  3665.         8) /k Kill background dialer
  3666.  
  3667.         Background dialing is terminated with this switch.
  3668.  
  3669.         9) /m<filename> Move file to buffer
  3670.  
  3671.         One file at a time may be moved to the file buffer for uploading.
  3672.         The resident part must be loaded and active to move the files; it
  3673.         knows where the file buffer is. More files may be moved up to the
  3674.         limit of 31 total files on the file buffer. The filename, includ-
  3675.         ing paths, should be right next to the 'm'. For example, to  move
  3676.         the file TEST.TXT from the present directory, the active directo-
  3677.         ry  on another drive F:, or the path D:\BGFT to the  file  buffer
  3678.         use, respectively:
  3679.  
  3680.         BGFTOPT /mTEST.TXT
  3681.  
  3682.         BGFTOPT /mF:TEST.TXT
  3683.  
  3684.         BGFTOPT /mD:\BGFT\TEST.TXT
  3685.  
  3686.         10) /q Quiet message mode
  3687.  
  3688.         Subsequent  command line switches to the right of the  first  'q'
  3689.         will have their switch messages to the standard output  disabled.
  3690.         Another  'q'  will  not turn the  messages  back  on.  Subsequent
  3691.         BGFTOPT command line entries will not be quiet.
  3692.  
  3693.         If  '/q' is used as the only command line argument there will  be
  3694.         no help listing.
  3695.  
  3696.  
  3697.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 60
  3698.         -------------------------------------------- - o -
  3699.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  3700.  
  3701.  
  3702.  
  3703.  
  3704.         11) /r<Reconnect COM port> 1,2,3,4
  3705.  
  3706.         This switch indicates that one of the four indicated values is to
  3707.         be  substituted  for <Reconnect COM port>. The number  should  be
  3708.         right  next to the 'r'. The number corresponds to the  number  of
  3709.         the communication port which is to be reconnected. The communica-
  3710.         tions port must be set.
  3711.  
  3712.         12) /s Start background file transfer
  3713.  
  3714.         Uploads  and downloads must be initiated with this  switch  after
  3715.         setting up the transmission.
  3716.  
  3717.         13) /t Terminal emulator
  3718.  
  3719.         A  basic terminal emulator is invoked which enables sending  key-
  3720.         board  instructions  to  the remote host. This can  be  used  for
  3721.         logging  in  to  a BBS, for example. The terminal  is  exited  by
  3722.         typing 'Ctrl_E' or 'Alt_X'.
  3723.  
  3724.         14) /u<filename> Upload file entry
  3725.  
  3726.         Xmodem-CRC  and  Xmodem-1K require that a file name  be  provided
  3727.         when  uploading a file from the file buffer. It should be  placed
  3728.         right next to the 'u'. Ymodem-Batch does not require a file name.
  3729.  
  3730.         15) /1 Hang up phone
  3731.  
  3732.         This will hang up the telephone line just as if 'Alt_H' was  used
  3733.         in BGFT.
  3734.  
  3735.         16) /3<pathname> Dump files to pathname
  3736.  
  3737.         After  a download, the files are in the file buffer. They may  be
  3738.         dumped  to the indicated path with this command. For example,  to
  3739.         dump to the present DOS directory use (include the '.')
  3740.  
  3741.         BGFTOPT /3.
  3742.  
  3743.         As a further example, you can dump to the BGFT directory on drive
  3744.         C: by using
  3745.  
  3746.         BGFTOPT /3C:\BGFT
  3747.  
  3748.         17) /4 Wait for end of transfer
  3749.  
  3750.         This  switch will not allow a normal exit of BGFTOPT after  being
  3751.         parsed.  BGFTOPT will wait until the transmission is over  before
  3752.         continuing.
  3753.  
  3754.  
  3755.  
  3756.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 61
  3757.         -------------------------------------------- - o -
  3758.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  3759.  
  3760.  
  3761.  
  3762.         18) /5 Turn resident program on
  3763.  
  3764.         The resident part is turned on with this switch; the file  buffer
  3765.         is  taken over and is made inaccessible from DOS. The  switch  is
  3766.         'one way'; turning the resident off requires the '/6' switch.
  3767.  
  3768.         19) /6 Turn resident program off
  3769.  
  3770.         The resident part of BGFT will be turned off. This allows  access
  3771.         to the file buffer. This should only be done when the resident is
  3772.         not otherwise busy with the file buffer. The switch is 'one way';
  3773.         turning the resident on requires the '/5' switch.
  3774.  
  3775.         20) /7<parity> 7 bit & parity N,E,O,S,M
  3776.  
  3777.         One  of  the  five indicated choices is  to  be  substituted  for
  3778.         <Parity>. The letter should be right next to the '7'. The  letter
  3779.         corresponds to the required parity: N for None, E for Even, O for
  3780.         Odd, S for Space, or M for Mark. Only one stop bit is  supported.
  3781.         The  resident part of BGFT will automatically revert to the  cor-
  3782.         rect settings for file transfer (normally 8 data bits, no parity,
  3783.         and one stop bit).
  3784.  
  3785.         21) /8<parity> 8 bit & parity N,E,O,S,M
  3786.  
  3787.         One of the five indicated choices is to be substituted for <Pari-
  3788.         ty>.  The  letter  should be right next to the  '8'.  The  letter
  3789.         corresponds to the required parity: N for None, E for Even, O for
  3790.         Odd, S for Space, or M for Mark. Only one stop bit is  supported.
  3791.         The  resident part of BGFT will automatically revert to the  cor-
  3792.         rect settings for file transfer (normally 8 data bits, no parity,
  3793.         and one stop bit).
  3794.  
  3795.         22) /9 Start background dialer
  3796.  
  3797.         The  resident's internal dialing string is set up with  the  '/0'
  3798.         switch and the actual dialing is commenced with this one.
  3799.  
  3800.         23) /0<P|T><#> Pulse or Tone & number
  3801.  
  3802.         This  command  needs  two inputs. The first is for  the  type  of
  3803.         dialing  that  your phone line supports. The  <Tone|Pulse>  means
  3804.         that  you have a choice of tone or pulse dialing; use 'T' or  'P'
  3805.         respectively.
  3806.  
  3807.         The  desired  phone number must be entered for  <#>.  The  number
  3808.         should  be  entered in a form suitable to the  modem.  Generally,
  3809.         this is a combination of numbers and certain specific punctuation
  3810.         characters (for example, the ',' is a pause and '-' is a  separa-
  3811.         tor).  (If you plan to use this in a batch file you will have  to
  3812.         use  '.' instead of ',' since the batch file processor  considers
  3813.  
  3814.  
  3815.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 62
  3816.         -------------------------------------------- - o -
  3817.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  3818.  
  3819.  
  3820.  
  3821.         ',' to be a separator. BGFTOPT will convert and understand it.)
  3822.  
  3823.         For example, to start tone dial to Dirac Systems' local BBS use:
  3824.  
  3825.         BGFTOPT /0T283-7157 /9
  3826.  
  3827.  
  3828.  
  3829.  
  3830.  
  3831.  
  3832.  
  3833.  
  3834.  
  3835.  
  3836.  
  3837.  
  3838.  
  3839.  
  3840.  
  3841.  
  3842.  
  3843.  
  3844.  
  3845.  
  3846.  
  3847.  
  3848.  
  3849.  
  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.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 63
  3875.         -------------------------------------------- - o -
  3876.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  3877.  
  3878.  
  3879.  
  3880.                                       INDEX
  3881.                                       -----
  3882.  
  3883.         Acknowledge, 23, 42, 50,  57,   BGFTTELX, 7, 10, 47
  3884.         58, 59                          BGFTUIPC, 6, 10
  3885.         ANSI, 24, 35                    BGFTUIQM, 7, 10
  3886.         ARC, 18                         BGFTUITL, 7, 9, 47
  3887.         ASP, 6, 10, 49, 57              BGFTUXPC, 6, 10
  3888.         ASPECT, 49, 56                  BGFTUXQM, 7, 10
  3889.         ATDP, 27                        BGFTUXTL, 7, 9, 47, 49
  3890.         ATDT, 20, 27                    BGFTUYPC, 6, 10
  3891.         ATE, 13, 27, 33                 BGFTUYQM, 7, 10
  3892.         ATH, 27                         BGFTUYTL, 7, 9, 47
  3893.         ATxx, 20                        BGFTXDLG, 6, 10
  3894.         ATZ, 33                         BGFTXmdm, 47
  3895.         AUTOEXEC, 19, 48, 55            BGFTYmdm, 47
  3896.                                         BIOS, 56
  3897.         Background,  1, 2, 3,  8,  9,   BITNET, 4
  3898.         10,  13, 14, 15, 16, 17,  20,   Break, 48
  3899.         21,  23, 24, 25, 26, 28,  30,   Buffer,  1, 3, 6, 8, 11,  13,
  3900.         31,  33, 36, 37, 38, 42,  45,   15,  17, 18, 21, 23, 31,  32,
  3901.         46,  48, 49, 50, 51, 54,  56,   38,  39, 40, 41, 42, 44,  46,
  3902.         57, 60, 61, 62                  48, 49, 51, 56, 60, 61, 62
  3903.         Banish, 52
  3904.         Batch, 7, 9, 10, 47, 48,  54,   Carrier, 20, 27
  3905.         62                              CGA, 26, 50
  3906.         Baud, 2, 6, 8, 9, 10, 12, 17,   Checksum, 38
  3907.         29,  35, 48, 54, 55, 56,  57,   CHKDSK, 11, 60
  3908.         58, 59                          CNF,  7, 10, 13, 18, 19,  20,
  3909.         BBS, 1, 3, 4, 11, 13, 14, 15,   25, 30, 47
  3910.         16, 37, 56, 61, 63              Color, 2, 12, 23, 25, 26, 56
  3911.         Beep, 14, 15, 36, 37            COM,  2, 3, 4, 6, 8,  9,  11,
  3912.         BGFTADD, 7, 10, 47              14,  17, 18, 28, 29, 48,  53,
  3913.         BGFTBAK, 30                     54, 55, 61
  3914.         BGFTDIR, 6, 8                   CompuServe, 4, 56
  3915.         BGFTDXPC, 6, 10                 COMSPEC, 55
  3916.         BGFTDXQM, 7, 10                 CRC, 14, 38, 50, 56, 59
  3917.         BGFTDXTL, 7, 9, 46, 47          CRS, 4, 56
  3918.         BGFTDYPC, 6, 10, 49             CS, 47
  3919.         BGFTDYQM, 7, 10, 49
  3920.         BGFTDYTL, 7, 9, 46, 47          Datastorm, 56, 57
  3921.         BGFTFLPY, 6, 8, 11, 43          DESQview, 1, 16, 53, 54, 56
  3922.         BGFTImdm, 47                    Dialer, 1, 2, 9, 13, 20,  29,
  3923.         BGFTINIT, 6, 9, 47, 48, 54      60, 62
  3924.         BGFTOPT,  2, 3, 6, 7, 9,  45,   Diskette,  3, 8, 11, 13,  15,
  3925.         46,  47, 48, 49, 57, 58,  59,   18, 19, 31, 42, 43, 52, 56
  3926.         60, 61, 63                      Documentation, 6, 8, 11,  13,
  3927.         BGFTORDR, 6, 11                 20, 27, 54
  3928.         BGFTREAD, 6, 11                 DORMANT, 44
  3929.         BGFTSLC, 7, 10, 47              Download, 1, 6, 7, 8, 9,  10,
  3930.         BGFTSPY, 6, 7, 10, 54           11,  13, 15, 16, 23, 32,  39,
  3931.  
  3932.  
  3933.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 64
  3934.         -------------------------------------------- - o -
  3935.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  3936.  
  3937.  
  3938.  
  3939.         40,  45, 46, 47, 49, 50,  51,   61
  3940.         55, 57, 58, 59, 60, 61          PCPLUS, 10
  3941.         DSZ-Ymodem, 38                  PgDn, 15, 34, 39, 48, 57
  3942.         DTR, 27                         PgUp, 34, 40, 48, 57
  3943.                                         PKUNZIP, 18
  3944.         EEMS, 53                        PKWARE, 18
  3945.         EGA, 26                         PKXARC, 18
  3946.         Email, 4                        Port,  6, 9, 12, 17, 18,  23,
  3947.         Emulation, 24, 32, 35           28,  29, 48, 53, 54, 55,  57,
  3948.         Error,  39, 42, 43,  44,  50,   58, 59, 61
  3949.         51, 57, 58, 59, 60              Printer, 10
  3950.         ESC, 12, 13, 14, 22, 24,  25,   PROCOMM, 1, 6, 9, 10, 45, 49,
  3951.         26,  31, 32, 35, 36, 37,  38,   56, 57
  3952.         40, 41,  56
  3953.         Exis, 57                        QEMM, 53
  3954.         Expanded, 53, 55                Qmodem,  1, 6, 7, 9, 10,  45,
  3955.         Extended, 42, 53                49, 57
  3956.                                         Quarterdeck, 56
  3957.         Forbin, 57
  3958.         Format,  4, 10, 11,  18,  19,   Redirection, 10
  3959.         31, 43                          Registration, 1, 4, 5, 7, 45
  3960.         Fxx, 56                         Rotary-Pulse, 27
  3961.  
  3962.         Games, 16, 55                   SALT, 9, 46, 47, 57
  3963.         Graphics, 56                    Script,  1, 6, 7, 9, 10,  46,
  3964.                                         47, 49
  3965.         Hangup, 27                      Setup, 8, 13, 15, 20, 23, 25,
  3966.         Hayes, 13, 20, 26, 27, 33, 57   26, 27, 44
  3967.         HLP, 6, 10, 19                  Smartmodem, 27, 33, 57
  3968.                                         Sound, 31, 33, 36
  3969.         IBM, 1, 2, 16, 56               Space, 8, 12, 24, 29, 36, 40,
  3970.         ICO, 7, 10, 54                  41, 51, 55, 57, 58, 62
  3971.         Initialization,  12, 13,  20,   SYNCHRONIZING, 44, 50
  3972.         23, 26, 33, 43, 44, 48, 54
  3973.         Internet, 4                     Telecommunications, 1, 2, 45,
  3974.         Interrupt, 53                   46, 54
  3975.                                         Telephone, 3, 10, 20, 33, 34,
  3976.         Limitations, 16, 28, 56         35, 42, 46, 50, 61
  3977.         LOADHI, 53                      Telix,  1, 6, 7, 9,  10,  45,
  3978.                                         46, 47, 48, 49, 57
  3979.         Microsoft, 53, 54, 55, 56       Timeout, 42, 50
  3980.         Monochrome, 26, 56              Transfers,  2, 6, 8, 13,  16,
  3981.         Mouse, 2, 18, 22, 28, 29, 32,   17,  37, 38, 39, 42, 43,  46,
  3982.         34, 35, 39, 40, 41, 54          48, 49, 50, 54, 57
  3983.         Multitasking, 1, 8, 16, 52      Translation, 10
  3984.                                         TRANSMIT, 44
  3985.         NANET, 4                        TSR, 2, 17, 18, 57
  3986.         NorthAmeriNet, 4
  3987.                                         Upload,  1, 6, 7, 8,  9,  10,
  3988.         Parity, 12, 29, 36, 58, 62      23,  30, 32, 38, 40, 41,  42,
  3989.         PATH, 17, 19, 31, 46, 54, 60,   45,  47, 49, 50, 51, 57,  59,
  3990.  
  3991.  
  3992.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 65
  3993.         -------------------------------------------- - o -
  3994.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  3995.  
  3996.  
  3997.  
  3998.         60, 61
  3999.         Utility, 13, 18, 23, 30,  33,
  4000.         42, 43, 50, 52, 56
  4001.  
  4002.         VGA, 26
  4003.         VT, 24, 35
  4004.  
  4005.         Warranty, 6
  4006.         Wildcards, 34
  4007.         Windows, 1, 6, 7, 10, 53, 54,
  4008.         55, 56
  4009.  
  4010.         Xmodem-CRC,  1, 6, 7, 9,  10,
  4011.         14,  15, 38, 39, 40, 41,  45,
  4012.         46, 47, 49, 50, 59, 61
  4013.  
  4014.         Ymodem-Batch, 1, 6, 7, 9, 10,
  4015.         16,  30, 38, 39, 40, 41,  42,
  4016.         45,  46, 47, 49, 50, 51,  57,
  4017.         59, 60, 61
  4018.  
  4019.         ZIP, 18
  4020.  
  4021.  
  4022.  
  4023.  
  4024.  
  4025.  
  4026.  
  4027.  
  4028.  
  4029.  
  4030.  
  4031.  
  4032.  
  4033.  
  4034.  
  4035.  
  4036.  
  4037.  
  4038.  
  4039.  
  4040.  
  4041.  
  4042.  
  4043.  
  4044.  
  4045.  
  4046.  
  4047.  
  4048.  
  4049.  
  4050.  
  4051.         BGFT, Copyright (c) 1990-1991 Dirac Systems   \ /         Page 66
  4052.         -------------------------------------------- - o -
  4053.         P.O. Box 476, West Hill, ON, M1E 4Y9, CANADA  / \
  4054.  
  4055.