home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / dialp132.zip / dialup132.doc < prev    next >
Text File  |  2000-06-18  |  10KB  |  215 lines
  1. DialUp: v1.32
  2.  
  3. DialUp is a package of REXX routines designed to interface with the InJoy
  4. dialer from F/X Communications and/or the AT&T Global Network TCP/IP
  5. Dialer.  Its functions are:
  6.  
  7. 1.  Start the dialer if not already started.
  8. 2.  Dial a predetermined host.
  9. 3.  Disconnect from the host.
  10. 4.  Launch an object after connection (ala LINKUP.EXE)
  11. 5.  Create a launch object
  12.  
  13. DialUp is no-charge shareware, copyrighted 1999, 2000 by Charles H.
  14. McKinnis and can be registered with an e-mail to mckinnis@attglobal.net.
  15. If you don't register, don't expect me to reply to any queries.
  16.  
  17. DialUp Installation:
  18.  
  19. 1.  Install the WPTools package from Hank Kelder or use the required
  20.     module packaged with DialUp.  You can find the package on Hobbes
  21.     (ftp://hobbes.nmsu.edu/pub/os2/util/system/wptool29.zip).  If
  22.     wptools.dll is not in your LIBPATH, the install.exe will unzip the
  23.     wptools.zip file that contains only the wptools.dll.
  24.  
  25. 2.  Install the VRexx package from IBM Employee written software or use
  26.     the required modules packaged with DialUp.  You can find the package
  27.     on Hobbes (ftp://hobbes.nmsu.edu/pub/os2/dev/rexx/vrexx.zip).  If
  28.     vrexx.exe is not in your PATH, or if vrexx.dll or devbase.dll are
  29.     not in your LIBPATH, the install.exe will unzip the missing modules
  30.     from the vrexx.zip file that contains the required VRexx modules.
  31.  
  32. 3.  Install the FM/2 Utilities package from Mark Kimes or use the
  33.     required module (killpid.exe) packaged with DialUp.  You can find the
  34.     package on Hobbes (ftp://hobbes.nmsu.edu/pub/os2/util/browser/fm2utils.zip).
  35.  
  36. 4.  Unzip dialup132.zip to a desired directory (recomment x:\dialup).
  37.     There is no requirement that this directory be referenced in any
  38.     path definition in config.sys.  There are no changes required to
  39.     any system configuration files.
  40.  
  41. 5.  Go to the installation directory and run install.exe.
  42.  
  43.     The install will create a DialUp folder on your desktop that contains
  44.     DialUp Utility object, the DialUp Launch Object folder, and the DialUp
  45.     Target Object folder.
  46.  
  47.     The VRexx files will be unzipped into the DialUp directory if
  48.     required.  If all of the VRexx modules are already present, the
  49.     install.exe will delete the vrexx.zip file.
  50.  
  51.     The wptools.dll will be unzipped into the DialUp directory if
  52.     required.  If WPTools is already installed and wptools.dll is in
  53.     your LIBPATH, the install.exe will delete the wptools.zip file.
  54.  
  55.     At the completion of the install, the DialUp Utility will start.
  56.     Select the "Setup all parameters" option.  You will be asked to 
  57.     navigate to the InJoy object.  You will then be asked to pick the
  58.     configuration file to be used.  You are now ready to set up the
  59.     InJoy exits required to keep track of the status of the InJoy dialer.
  60.  
  61. InJoy Setup:
  62.  
  63. 1.  Now you need to set up InJoy to notify DialUp of its status.  Open
  64.     the InJoy dialer.  Select "Misc.  opt.".
  65.  
  66.     Select "Autostarting modules".  Set the following:
  67.  
  68.     a.  Path and filename - drive:\path\dialup.exe
  69.     b.  Parameters - /online
  70.     c.  Working directory - drive:\path
  71.     d.  Start at - host connect
  72.     e.  Stop at - discon.(after) and InJoy exit
  73.     f.  Start minimized - on
  74.     g.  Select "Add"
  75.     h.  Path and filename - drive:\path\dialup.exe
  76.     i.  Parameters - /offline
  77.     j.  Working directory - drive:\path
  78.     k.  Start at - discon.(after) and InJoy exit
  79.     l.  Select "Add"
  80.  
  81.     You should now have dialup.exe set up to be called twice, after
  82.     connect and after hangup.  Select "Ok".  Select "ESC=Go back".
  83.  
  84. 2.  Using the AT&T Global Network TCP/IP Dialer requires no special
  85.     setup procedures in the dialer properties.
  86.  
  87. Setting up launch objects:
  88.  
  89. 1.  Now you are ready to set up whatever applications you want to use
  90.     with DialUp.
  91.  
  92.     Some e-mail clients have a dialer exit that can be used.  If this is
  93.     your case, you can set that exit to "x:\path\dialup.exe /dial".  If
  94.     your mailer client provides an exit for hanging up, you can set it
  95.     to "x:\path\dialup.exe /disc" to trigger a disconnect.
  96.  
  97.     I have found that some e-mail clients, even though they provide a 
  98.     dialer exit, do not wait for the connection properly and will post
  99.     an error message concerning a bad POP server connection.  If that is 
  100.     your case, I suggest that you use the /CREATE function described
  101.     below to get the connection made before invoking the e-mail client.
  102.  
  103. 2.  DialUp can be used in a similar manner to that of the "LINKUP.EXE"
  104.     furnished with Warp 4. However, LINKUP.EXE always expected to be 
  105.     passed the program name to be started and the working directory for 
  106.     that program.  DialUp wants the actual object name (in the form
  107.     "<object>").  No parameters or working directory are accepted
  108.     because they wil be the parameters currently associated with the
  109.     object.
  110.  
  111. 3.  You can run the DialUp Utility and select the 'Create an object to
  112.     connect and launch an object id' parameter to build launch objects.
  113.     The launch object will always be created in the "DialUp Launch
  114.     Objects" sub-folder of the "DialUp" folder.
  115.  
  116.     Because IBM has managed to completely screw up the Object Rexx WPS
  117.     interface, the process of setting an icon for the DialUp launch
  118.     object is rather crude.  URL launch objects will have the standard
  119.     URL icon.  If an icon can be extracted for the target, it will be
  120.     used.  Otherwise, the folder containing the target object and the
  121.     settings for the launch object will be opened so that you can drag
  122.     and drop the target object icon to the icon page of the launch object.
  123.  
  124.     If the object you select to launch does not have a proper object id,
  125.     it will be assigned a unique id.  You will find another folder,
  126.     "DialUp Target Objects" inside of the "DialUp" folder.  This is where
  127.     I deposit my real URL objects (see note).
  128.  
  129.     Note:  If you use the AWGet package for retrieving URL files, make
  130.     sure to stop the AWGet dameon before creating an object of a
  131.     bookmark. Otherwise, AWGet will grab it and run off and hide.
  132.  
  133. 4.  Changes
  134.     1999.09.02 - JoyUp098.Zip
  135.     1) Initial posting to Hobbes
  136.  
  137.     1999.09.04 - JoyUp099.Zip
  138.     1) Added icon capability for URL objects
  139.  
  140.     1999.09.09 - JoyUp100.Zip
  141.     1) Quit trying to work with the icons for abstract objects. May try
  142.        again when the Object Rexx WPS interface gets fixed.
  143.     2) All objects will now be given proper object ids before JoyUp
  144.        uses them.
  145.     3) Added tests to make sure that RxExtras and WPTools are installed
  146.        and usable.
  147.  
  148.     1999.09.11 - JoyUp101.Zip
  149.     1) Simplified setup and initialization by basing the InJoy
  150.        information on the information in the InJoy object rather than
  151.        storing it in JOYUP.INI.
  152.  
  153.     1999.09.30 - JoyUp110.Zip
  154.     1) The application has been redesigned.
  155.     2) The setup, create, and query functions have been re-written in
  156.        VRexx to provide a graphical interface and moved into a separate
  157.        routine called JoyUpU.Cmd.  The VRexx modules (from IBM Employee
  158.        written software) are included.
  159.     3) The status of the InJoy dialer connection is now maintained via a
  160.        Rexx queue and the logic for setting, deleting and querying the
  161.        queue has been moved into a separate routine called JoyUpQ.Cmd
  162.        (which is why the InJoy dialer autostart functions have been
  163.        changed).
  164.     4) Added a routine called JoyUpK.Cmd to kill the VRexx functions if 
  165.        they should become "stuck".
  166.  
  167.     1999.12.20 - JoyUp111.Zip
  168.     1) The install.exe will selectively install the tools necessary for
  169.        its own operation.
  170.     2) The joyupq.cmd has been incorporated back into joyup.cmd.
  171.     3) The install.cmd, joyup.cmd, and joyupu.cmd are now install.exe,
  172.        joyup.exe, and joyupu.exe.  They were converted using the
  173.        REXX2EXE tool.  There are still 2 routines called joyup.cmd
  174.        and joyupu.cmd that will call the new executables.
  175.  
  176.     2000.02.03 - JoyUp111.Zip
  177.     1) Removed the joyup.cmd and joyupu.cmd routines.  Some mailers,
  178.        like Polarbar, do not handle anything except exe modules.
  179.     2) Updated the documentation.
  180.  
  181.     2000.02.11 - JoyUp12.Zip
  182.     1) Removed the generated exe files.  All code now runs as Rexx
  183.        command routines.  See "Setting up launch objects:" if your
  184.        application only supports exe files.
  185.     2) Added the optional "/Wait" parameter to the joyup.exe.  This will
  186.        cause joyup.cmd to wait for the InJoy dialer to connect before
  187.        launching the application object.  Useful when an application is
  188.        set up to communicate with the Internet when it is opened.
  189.     3) Modified code to eliminate the propagation of queues.  Moved the
  190.        InJoy interface code to get quicker response to InJoy calls made
  191.        to JoyUp.
  192.     4) Removed the usage of RxExtras.
  193.     5) Added killpid.exe from FM/2 Utilities package.
  194.  
  195.     2000.03.16 - JoyUp121.Zip
  196.     1) All routines have been converted to exe files using REXX2EXE.
  197.     2) Add the /H:injoy_host parameter to eliminate retaining the InJoy
  198.        host name in the joyup.ini file.
  199.     3) Fixed a minor bug that prevented object ids with spaces or
  200.        forward slashes from processing properly.
  201.     4) Added the rxslibp.cmd routine to the package.  This Rexx routine
  202.        will determine if a module is in your libpath and return the fully
  203.        qualified name of the module if found or a blank if not.
  204.  
  205.     2000.05.01 - DialUp13.Zip
  206.     1) JoyUp became DialUp and now supports the AT&T Global Network
  207.        TCP/IP Dialer as well as the InJoy Dialer.
  208.  
  209.     2000.06.03 - DialUp131.Zip
  210.     1) Corrected an error in assigning object ids to objects in dialupu.
  211.  
  212.     2000.06.21 - DialUp132.Zip
  213.     1) The /WAIT parameter is now the standard behavior.  A target object
  214.        will not be launched until the dialer has connected.
  215.