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