home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 5 / ctrom5b.zip / ctrom5b / CT / CT9402 / DB152LNK / DBLINK.DOC < prev    next >
Text File  |  1993-02-23  |  19KB  |  603 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                   D'Bridge LINK
  12.  
  13.                       User's Guide and Technical Reference
  14.  
  15.             Version 1.52 - 22 February 1993
  16.  
  17.  
  18.  
  19.  
  20.                          Copyright 1993 by Chris Irwin
  21.  
  22.                               ALL RIGHTS RESERVED
  23.  
  24.  
  25.  
  26.                                  MOSAIC PRESS
  27.                                358 OLIVER ROAD
  28.                             CINCINNATI, OHIO 45215
  29.                                  513-821-1270
  30.  
  31.                             1:108/68@fidonet.org
  32.  
  33.  
  34.  
  35.         "This manual may be freely copied and distributed in its original
  36.          form only.  Distribution of modified copies shall be considered
  37.          copyright infringement.  This document is the complete User's Guide
  38.          and Technical Reference for D'Bridge LINK.  ALL RIGHTS RESERVED.
  39.          We distribute this material on an "as-is" basis only."
  40.  
  41.  
  42.      "This is a SHAREWARE product.  After a 30 day demonstration period,
  43.      you are either asked to register the software or quit using it."
  44.  
  45.  
  46. D'Bridge LINK                                                 TABLE OF CONTENTS
  47. -------------------------------------------------------------------------------
  48.  
  49.  
  50.  
  51.  
  52.             Table of Contents
  53.             -----------------
  54.  
  55.             1.0   Hardware/software requirements                1
  56.             1.1   D'Bridge LINK - an overview                   2
  57.             1.2   Installation/Configuration                    3
  58.  
  59.         2.0   Command-line operation            7
  60.         2.1   Control file operation            8
  61.  
  62.         3.0   Acknowledgements                9
  63.  
  64.  
  65. D'Bridge LINK                              Hardware/Software requirements   1.0
  66. -------------------------------------------------------------------------------
  67.  
  68.  
  69.  
  70.  
  71.  
  72.       1.0  HARDWARE/SOFTWARE REQUIREMENTS
  73.       -----------------------------------
  74.  
  75.  
  76.       HARDWARE
  77.  
  78.             COMPUTER
  79.  
  80.                 - IBM PC, XT, AT, PS/2 or compatible
  81.         - 512K RAM
  82.                 - Monochrome, CGA, EGA, VGA, PGA adaptor and monitor
  83.                 - Serial port  (if an external modem is used)
  84.  
  85.  
  86.             MODEM
  87.  
  88.                 - Hayes-compatible modem
  89.                   The modem used MUST be capable of using both the
  90.                   DTR (Data Terminal Ready) and the CD (Carrier Detect)
  91.                   signals.  (Check Appendix "E" for a list of modems
  92.                   already known to be compatible)
  93.                 - Modem cable  (if external)
  94.  
  95.  
  96.             TELEPHONE LINE
  97.  
  98.                 - A normal telephone line
  99.                 - A "cellular" phone  (with a compatible modem)
  100.                 - Most PBX systems  (check with your vendor)
  101.  
  102.  
  103.       SOFTWARE
  104.  
  105.             OPERATING SYSTEM
  106.  
  107.                 - D'Bridge LINK requires DOS 2.1 or higher
  108.                 - A FOSSIL communications driver such as X00 by Ray Gwinn.
  109.                   The X00 driver is provided with D'Bridge LINK and is the
  110.                   ONLY driver officially supported.
  111.  
  112.             OPTIONS
  113.  
  114.                 - A Multi-tasking program or windowing program such as
  115.                   DESQview, Windows or TopView
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123. -------------------------------------------------------------------------------
  124. Version 1.52, Copyright 1993 by Chris Irwin - ALL RIGHTS RESERVED             1
  125. D'Bridge LINK                                 D'Bridge LINK - an overview   1.1
  126. -------------------------------------------------------------------------------
  127.  
  128.  
  129.  
  130.  
  131.  
  132.       1.1  D'BRIDGE LINK - AN OVERVIEW
  133.       --------------------------------
  134.  
  135.  
  136.       D'Bridge LINK is a simple command-line utility that allows you to send
  137.       and receive files using a remote PC connected via modem.  D'Bridge LINK
  138.       is a WaZOO-based mailer capable of sending and receiving files using the
  139.       ZMODEM protocol.  This software is compatible with D'Bridge, FrontDoor,
  140.       InterMail, BinkleyTerm, Opus, Fido and many other WaZOO-based EMAIL
  141.       systems.
  142.  
  143.       D'Bridge LINK is not a full-blown EMAIL system; it is a small utility
  144.       that allows computers to transmit files, request files or poll a remote
  145.       system from a batch file.  D'Bridge link is small; just around 60K on
  146.       disk makes it small enough for even floppy-based systems and laptops to
  147.       use.
  148.  
  149.       The software only dials out.  Given the phone number and the list of
  150.       files to send or request, D'Bridge LINK calls the remote system multiple
  151.       times until a connection is made.  Once connected, the computers exchange
  152.       information then quickly hang up, resulting in low-cost communications.
  153.  
  154.       D'Bridge LINK can be used to retrieve "demo" software such as D'Bridge.
  155.       To file-request the "demo" version of D'Bridge EMAIL System, simply type:
  156.  
  157.  
  158.            DBLINK REQUEST 1-513-821-1270 DBRIDGE
  159.  
  160.            This would cause your computer to dial the main D'Bridge
  161.            Support system in Cincinnati, Ohio and request the "demo"
  162.            version of our software.  This would take about an hour
  163.            of long-distance time at 2400 baud, returning about 830K.
  164.  
  165.  
  166.  
  167.  
  168.  
  169.       D'Bridge LINK:
  170.  
  171.       - Sends and receives files completely unattended
  172.       - Fully compatible with UltraTek<tm> and WaZOO<tm> EMAIL
  173.       - Supports most Hayes-compatible 300-38400 baud modems
  174.       - 32-bit CRCs and interruption-recovery are used in ZMODEM transfers
  175.       - Supports WaZOO-style file and update requests
  176.       - Uses the new EMSI handshaking standard
  177.       - Compatible with most multi-taskers such as DESQview and DoubleDOS
  178.       - FREE software updates available electronically
  179.       - Support systems located worldwide
  180.  
  181.  
  182.  
  183. -------------------------------------------------------------------------------
  184. Version 1.52, Copyright 1993 by Chris Irwin - ALL RIGHTS RESERVED             2
  185. D'Bridge LINK                                  Installation/Configuration   1.2
  186. -------------------------------------------------------------------------------
  187.  
  188.  
  189.  
  190.  
  191.  
  192.       1.2  INSTALLATION/CONFIGURATION
  193.       -------------------------------
  194.  
  195.  
  196.       D'Bridge LINK is a simple program to install, but requires some knowledge
  197.       of DOS.  A standard text editor such as EDLIN or EDIT is needed to alter
  198.       CONFIG.SYS, AUTOEXEC.BAT and DBLINK.CTL for your particular installation.
  199.  
  200.  
  201.  
  202.       There are just three files required for D'Bridge LINK:
  203.  
  204.         DBLINK.EXE      D'Bridge LINK executable
  205.         DBLINK.CTL      Control file (made with standard text editor)
  206.     X00.EXE     Communications device driver
  207.  
  208.  
  209.       Follow these simple steps to install and configure DBLINK for your
  210.       particular configuration.  In this particular example, we are installing
  211.       the software on a hard disk system in the subdirectory C:\DOS.  If you
  212.       want to use another directory, just substitute the desired directory.
  213.  
  214.  
  215.       1) Copy the release files (listed above) into a subdirectory where you
  216.          want to store them.  (Floppy-based systems, use the "A:" root
  217.          directory.)
  218.  
  219.  
  220.       2) Edit the DBLINK.CTL file to contain specific information about your
  221.          modem.  D'Bridge LINK comes with a "default" configuration file that
  222.          should work correctly for most 2400 baud modems, but you may need to
  223.          make some changes.  Following is the configuration that comes as a
  224.          default with the "demo" copy:
  225.  
  226.      * D'Bridge LINK 1.52 - Default control file (demo copy)
  227.          Address 1:9999/9999
  228.          System (Your system name here)
  229.          Operator (Your name here)
  230.          Files FILES\
  231.          Modem port COM1
  232.          Modem baud 2400
  233.          * Modem locked
  234.          Modem init ATM1X1Q0V1H0S0=0S7=50
  235.          Modem dial ATDT
  236.          Modem timeout 60
  237.          Max tries 30
  238.          Max connects 2
  239.          Verbose log DBLINK.LOG
  240.  
  241.  
  242.  
  243. -------------------------------------------------------------------------------
  244. Version 1.52, Copyright 1993 by Chris Irwin - ALL RIGHTS RESERVED             3
  245. D'Bridge LINK                                  Installation/Configuration   1.2
  246. -------------------------------------------------------------------------------
  247.  
  248.  
  249.  
  250.  
  251.  
  252.          The following directives are supported inside a DBLINK control file:
  253.  
  254.  
  255.          ADDRESS <zone:net/node.point>
  256.  
  257.          This defines the Fidonet address that DBLINK will use when dialing
  258.          a remote system.  If there is mail waiting for this address, it will
  259.          be picked-up when the system is called.
  260.  
  261.  
  262.          ALIAS <zone:net/node.point>
  263.  
  264.          This defines the alternate Fidonet addresses that DBLINK will use when
  265.          connecting to a remote UZAP-capable system.  If there is mail waiting
  266.          for this address, it will be picked-up when the system is called.
  267.  
  268.  
  269.          SYSTEM <system name>
  270.  
  271.          This designates the name of your system; this will appear in the log
  272.          file of the remote system as an identifier.
  273.  
  274.  
  275.          OPERATOR <operator name>
  276.  
  277.          This designates the name of the primary operator. (your name)
  278.  
  279.  
  280.          FILES <directory path>
  281.  
  282.          This defines the subdirectory where ALL received files will be stored.
  283.          Make sure that this is a valid directory path.  If the directory does
  284.          not exist, it will be automatically created if possible.
  285.  
  286.  
  287.          MODEM PORT <port name>
  288.  
  289.          This defines the serial communication port that D'Bridge LINK will
  290.          use.  Valid ports are COM1 through COM7.
  291.  
  292.  
  293.          MODEM BAUD <baud rate>
  294.  
  295.          This specifies the maximum speed of your modem.  Valid rates are 300,
  296.          1200, 2400, 4800, 9600, 19200 and 38400.
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303. -------------------------------------------------------------------------------
  304. Version 1.52, Copyright 1993 by Chris Irwin - ALL RIGHTS RESERVED             4
  305. D'Bridge LINK                                  Installation/Configuration   1.2
  306. -------------------------------------------------------------------------------
  307.  
  308.  
  309.  
  310.  
  311.  
  312.          MODEM LOCKED
  313.  
  314.          If you specify MODEM LOCKED, then DBLINK will always communicate with
  315.          your modem at the maximum specified speed.  Make sure that you have
  316.          the corresponding MODEM INIT string defined telling your modem that
  317.          the DTE rate is locked.
  318.  
  319.  
  320.          MODEM INIT <initialization string>
  321.  
  322.          Before D'Bridge LINK dials out, it first sends the initialization
  323.          string to the modem.  This "init" string should tell your HAYES-
  324.          compatible modem to use verbose response codes.  The default that
  325.          comes with D'Bridge LINK is "ATM1X1Q0V1S0=0S7=65."
  326.  
  327.  
  328.          MODEM DIAL <dial string>
  329.  
  330.          This is the command sent to your modem before the phone number that
  331.          actually dials the phone.  This is normally "ATDT" for touch-tone
  332.          lines or "ATDP" for dial service.
  333.  
  334.  
  335.          MODEM TIMEOUT <seconds>
  336.  
  337.          The modem timeout specifies how many seconds to wait for a response
  338.          from the modem after issuing a dial command.  This should normally be
  339.          set for 5 seconds greater than the "S7" register value.  (Default 70)
  340.  
  341.  
  342.          MAX TRIES <count>
  343.  
  344.          This specifies the maximum number of times that dialing should be
  345.          attempted before terminating the program without success.  This value
  346.          is normally 30, but may be changed to suit your installation.
  347.  
  348.  
  349.          MAX CONNECTS <count>
  350.  
  351.          This defines the maximum number of unsuccessful connects that are
  352.          allowed before terminating without success.  If a session fails,
  353.          DBLINK will call back up to this many times.
  354.  
  355.  
  356.          PASSWORD <session password>
  357.  
  358.          If you need to use a session password for a given connection, you may
  359.          specify it here.  Passwords may be from 1 to 8 characters and are not
  360.          case-sensitive.
  361.  
  362.  
  363. -------------------------------------------------------------------------------
  364. Version 1.52, Copyright 1993 by Chris Irwin - ALL RIGHTS RESERVED             5
  365. D'Bridge LINK                                  Installation/Configuration   1.2
  366. -------------------------------------------------------------------------------
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.          VERBOSE LOG <filename>
  376.  
  377.          This designates that a verbose log file should be written to the
  378.          specified file.  "Verbose" means that all log entries written to the
  379.          screen will be in the file.
  380.  
  381.  
  382.          TERSE LOG <filename>
  383.  
  384.          This designates that a terse log file should be written to the
  385.          specified file.  "Terse" means that only important log entries will
  386.          be written; this saves disk space, but still provides all important
  387.          information.
  388.  
  389.  
  390.       5) If you are using a "demo" copy, you will need to select the support
  391.          system that you would like to use to aquire your 15-day "demo" key.
  392.          The DBLINK.CTL file supplied has all of our support sites listed as
  393.          commented lines.  Simply un-comment the desired support system and
  394.          edit the phone number so that it will be dialed correctly for your
  395.          location.
  396.  
  397.  
  398.       6) At this point, re-boot your computer so that the X00.SYS device driver
  399.          will be installed.
  400.  
  401.  
  402.       7) If you are installing a "demo" copy, follow the next few steps to
  403.          obtain your 15-day "demo" key from the selected support system:
  404.  
  405.          a) Type DBLINK and press ENTER.
  406.  
  407.          b) Read the license agreement and type the word "AGREE" if you want
  408.             D'Bridge LINK to dial your support system for the "demo" key.
  409.  
  410.          c) DBLINK should then start dialing the support system selected.  It
  411.             will keep trying until it has connected or given up because of too
  412.             many retries.  If you aren't able to get a key quickly, you might
  413.             try selecting a different support system.
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423. -------------------------------------------------------------------------------
  424. Version 1.52, Copyright 1993 by Chris Irwin - ALL RIGHTS RESERVED             6
  425. D'Bridge LINK                                      Command-line operation   2.0
  426. -------------------------------------------------------------------------------
  427.  
  428.  
  429.  
  430.  
  431.  
  432.       2.0  COMMAND-LINE OPERATION
  433.       ---------------------------
  434.  
  435.       D'Bridge LINK provides three basic functions from the command-line:
  436.  
  437.  
  438.          FILE-TRANSMISSION
  439.  
  440.          D'Bridge LINK can transmit files to a remote system by using the
  441.          "SEND" option from the command-line.  The format of this command is:
  442.  
  443.          DBLINK SEND <phone number> <filespec> <filespec> ... <filespec>
  444.          <phone number> is the actual phone number to be dialed and <filespec>
  445.          designates the filename(s) to be sent; this may include wildcard
  446.          characters to designate more than one file at once.
  447.  
  448.          i.e. DBLINK SEND 232-9365 \FILES\*.ZIP
  449.  
  450.  
  451.          FILE-REQUEST
  452.  
  453.          D'Bridge LINK can request that the remote system send files by using
  454.          the "REQUEST" option from the command line.  The format is:
  455.  
  456.          DBLINK REQUEST <phone number> <filespec> <filespec> ... <filespec>
  457.  
  458.          <phone number> is the actual phone number to be dialed and <filespec>
  459.          designates the filename(s) to be requested.  If a request password is
  460.          needed, the format for the <filespec> is <filename>,<password>.
  461.  
  462.          ie. DBLINK REQUEST 1-503-555-2919 FILES HISTORY.TXT
  463.              DBLINK REQUEST 232-9365 MYFILE,SECRET
  464.  
  465.  
  466.          POLL
  467.  
  468.          D'Bridge LINK can be instructed to simply call the remote system to
  469.          pickup any mail waiting.  The format for this is simply:
  470.  
  471.          DBLINK POLL <phone number>
  472.  
  473.          <phone number> is the actual phone number to be dialed.  DBLINK will
  474.          call the remote system without actually transmitting any files.  If
  475.          there are any files on hold, they will be picked-up when connected.
  476.  
  477.          ie. DBLINK POLL 232-9365
  478.  
  479.  
  480.  
  481.  
  482.  
  483. -------------------------------------------------------------------------------
  484. Version 1.52, Copyright 1993 by Chris Irwin - ALL RIGHTS RESERVED             7
  485. D'Bridge LINK                                      Control file operation   2.1
  486. -------------------------------------------------------------------------------
  487.  
  488.  
  489.  
  490.  
  491.  
  492.       2.1  CONTROL FILE OPERATION
  493.       ---------------------------
  494.  
  495.       D'Bridge LINK provides the ability to combine the SEND and FILE-REQUEST
  496.       options by using a control file.  When DBLINK is run, it first reads the
  497.       DBLINK.CTL file for parameters, but an additional control file may be
  498.       specified that includes commands for either file transsmision or request:
  499.  
  500.  
  501.          DBLINK USE <control file name>
  502.  
  503.          This specifies that the designated control file will be read after
  504.          DBLINK.CTL to list additional parameters or file-transmisstion queues
  505.          as defaults.  If you use this method, the phone number and filenames
  506.          must be listed in the control file.
  507.  
  508.  
  509.  
  510.       There are three additional directives that may be included in a DBLINK
  511.       control file:
  512.  
  513.  
  514.          DIAL <phone number>
  515.  
  516.          This specifies the actual phone number to dial.
  517.  
  518.  
  519.  
  520.          SEND <filespec>
  521.  
  522.          This designates a filename to send.  This may include wildcard
  523.          characters.  Any number of SEND lines may be in a control file
  524.          allowing for transmission of a large number of files in one batch.
  525.  
  526.  
  527.  
  528.          REQUEST <filespec>
  529.  
  530.          This designates a filename to request.  This may include wildcard
  531.          characters and an option password (seperated by a comma.)  Any number
  532.          of REQUEST lines may be in a control file.
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543. -------------------------------------------------------------------------------
  544. Version 1.52, Copyright 1993 by Chris Irwin - ALL RIGHTS RESERVED             8
  545. D'Bridge LINK                                            Acknowledgements   3.1
  546. -------------------------------------------------------------------------------
  547.  
  548.  
  549.  
  550.  
  551.  
  552.       3.0  ACKNOWLEDGEMENTS
  553.       ---------------------
  554.  
  555.  
  556.       RAY GWINN
  557.  
  558.       We wish to greatly thank Ray Gwinn for allowing us to include his
  559.       excellent FOSSIL driver, X00, with the D'Bridge LINK package.  Ray has
  560.       worked many years to bring the X00 driver through many hardware and
  561.       specification changes.  We thank him greatly for being kind enough to
  562.       license his software for use with D'Bridge LINK.
  563.  
  564.  
  565.  
  566.         - Airmail is a trademark of Joaquim Homrighausen
  567.         - BinkleyTerm was written by Bob Hartman and Vince Perriello
  568.         - Fido and Fidonet are trademarks of Tom Jennings (Fido Software)
  569.         - FrontDoor is a trademark of Joaquim Homrighausen
  570.         - Opus, WaZOO and YOOHOO are trademarks of Wynn Wagner III
  571.         - UltraTEK is a trademark of Joaquim Homrighausen and Chris Irwin
  572.         - ZIP was created by Phil Katz of PKware
  573.         - ZMODEM was documented by Chuck Forsberg
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602. -------------------------------------------------------------------------------
  603. Version 1.52, Copyright 1993 by Chris Irwin - ALL RIGHTS RESERVED            9