home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / duc10.zip / readme.txt < prev    next >
Text File  |  2003-01-03  |  5KB  |  151 lines
  1.  
  2.  
  3.     DUC - Dial-Up Connection, Version 1.0
  4.  
  5.     Copyright (c) 2002 - 2003 Magnus Olsson. All rights reserved.
  6.  
  7.     Parts of DUC.CMD are copyright (c) 1998 Walt Shekrota.
  8.  
  9.     PPP Dial-Up Connections as desktop objects
  10.  
  11.     Mail address: magnus@cosmicledger.com
  12.  
  13.     Web page: www.cosmicledger.com/software/utilities/duc
  14.     _____________________________________________________
  15.  
  16.  
  17.     Description
  18.     -----------
  19.  
  20.     DUC circumvents the ugly, clunky and unnecessary GUI front end of
  21.     DOIP/SLIPPM for making and breaking PPP internet connections. DUC
  22.     creates program objects with slick icons. Click once to connect and
  23.     another to disconnect.
  24.  
  25.     DUC does not entirely dispense of SLIPPM. You still need to enter
  26.     your connection settings through it. Any changes you make will
  27.     be automatically picked up by your DUC objects.
  28.  
  29.     With DUC you do not have to open a window to select your connection
  30.     and press enter to connect. You will not be asked to click OK to
  31.     disconnect and you can specify a secondary nameserver in addition
  32.     to the one and only specified through DOIP.
  33.  
  34.     DUC is based on the proven PPP Connection Utility (PPPCNT) by
  35.     Walt Shekrota. Both DUC and PPPCNT are free to use and completely
  36.     configurable and extendable by the end user as both utilities are
  37.     provided in REXX source.
  38.  
  39.     Special DUC features:
  40.        - DUC icons (40x40).
  41.        - Kills PPP if already running (no need for CTRL-C).
  42.        - Object icon automatically synchronized if out-of-sync.
  43.        - Secondary name server may be specified.
  44.        - Inactivity timeout (hanging up).
  45.        - Sleep icon (indicating no activity).
  46.        - Total connect time updated.
  47.     To come:
  48.        - Redial on busy and no carrier.
  49.     Maybe:
  50.        - Logging
  51.  
  52.  
  53.     Requirements
  54.     ------------
  55.  
  56.     OS/2 Warp (developed and tested on Warp 4 only).
  57.     The REXX interpreter shipped with OS/2 Warp.
  58.     PPP along with SLIPPM (installed with TCP/IP for OS/2).
  59.  
  60.  
  61.     Installation/Removal
  62.     --------------------
  63.  
  64.     Move all the files in the archive to a folder of your choice,
  65.     preferrably one in your PATH, but this is not necessary. The
  66.     next step is to create at least one connection object.
  67.  
  68.     DUC makes no changes to your environment or system configuration.
  69.     To remove DUC just delete the files listed in the file duc.lst and
  70.     any connection objects you have created.
  71.  
  72.  
  73.     Object creation
  74.     ---------------
  75.  
  76.     Assuming you already have a connection set up through DOIP/SLIPPM
  77.     you are now ready to use DUC to create connection objects. Follow
  78.     these steps for a simple object:
  79.  
  80.     1. Open DUC.CMD for interactive creation.
  81.  
  82.     2. Enter the name of the connection as listed in DOIP.
  83.  
  84.        Note that the name is case-sensitive and must be entered
  85.        exactly as it appears.
  86.  
  87.     3. If things turned out right you should now have a DUC program
  88.        object on your desktop, customized for your connection. Move
  89.        the object anywhere you like and why not make a shadow for it
  90.        on your LaunchPad?
  91.  
  92.     OK, that is all there is to it for simple uses. Repeat the steps
  93.     for additional connections. If you want to specify a secondary name
  94.     server or something else, see below for options.
  95.  
  96.  
  97.     Object use
  98.     ----------
  99.  
  100.     When you want to establish a connection simply open its object by
  101.     clicking the DIALUP icon. When the script starts it will show the
  102.     PROGRESS icon, leaving it on until the connection is up and running.
  103.     While connected the DUC object will show the HANGUP icon. Opening
  104.     the connection object in this state will end the connection, which
  105.     in turn will automatically revert the object back to showing the
  106.     DIALUP icon.
  107.  
  108.     If you hear a long beep while trying to establish a connection this
  109.     indicates an error. Open the object to view the script output. The
  110.     connection window shows the steps taken by the script and a line
  111.     indicating the kind of error experienced. Press enter to close the
  112.     connection window and clean up.
  113.  
  114.  
  115.     Options
  116.     -------
  117.  
  118.     Command syntax:
  119.        duc [ /create | /ns <server> | /beep ] <connection> [ <runthis> ]
  120.  
  121.     Where the switches:
  122.        /create creates a connection object on the desktop.
  123.        /ns <server> uses an additional name server as specified.
  124.        /beep beeps on connection, disconnection and buzzes on sleep.
  125.  
  126.     Where the values:
  127.        <connection> is the name (case-sensitive) of the connection.
  128.        <runthis> is passed to the start command.
  129.  
  130.  
  131.     Licensing
  132.     ---------
  133.  
  134.     DUC is e-mailware. This means that you do not have to pay for
  135.     using it except for sending an e-mail to the developer if you like
  136.     the stuff and use it regularly. If you make any changes to the
  137.     REXX scripts you are kindly asked to inform the developer, so that
  138.     those changes may benefit everyone.
  139.  
  140.  
  141.     Copyright
  142.     ---------
  143.  
  144.     DUC is copyrighted and not in the public domain. Permission is
  145.     given to any individual or institution to use, copy, or redistribute
  146.     this software so long as all files included are left unmodified with
  147.     regard to copyright. The software may not be sold for profit. This
  148.     copyright notice must be retained and accompany the software
  149.     wherever it goes.
  150.  
  151.