home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / joyup111.zip / joyup111.ref < prev    next >
Text File  |  2000-02-04  |  8KB  |  181 lines
  1. JoyUp:
  2.  
  3. JoyUp is a package of REXX routines designed to interface with the InJoy
  4. dialer from F/X Communications.  Its functions are:
  5.  
  6. 1.  Start the InJoy dialer if not already started.
  7. 2.  Dial a predetermined host.
  8. 3.  Disconnect from the host.
  9. 4.  Launch an object after connection (ala LINKUP.EXE)
  10. 5.  Create a launch object
  11.  
  12. Joyup is no-charge shareware, copyrighted 1999 by Charles H. McKinnis
  13. and can be registered with an e-mail to mckinnis@attglobal.net.  If you
  14. don't register, don't expect me to reply to any queries.
  15.  
  16. JoyUp Installation:
  17.  
  18. 1.  Install the RxExtras package from Dion Gillard or use the required
  19.     module packaged with JoyUp.  You can find the package on Hobbes
  20.     (ftp://hobbes.nmsu.edu/pub/os2/dev/rexx/rxx1g.zip).  If RXEXTRAS.DLL
  21.     is not in your LIBPATH, the install.exe will unzip the rxextras.zip
  22.     file that contains only the rxextras.dll.
  23.  
  24. 2.  Install the WPTools package from Hank Kelder or use the required
  25.     module packaged with JoyUp.  You can find the package on Hobbes
  26.     (ftp://hobbes.nmsu.edu/pub/os2/util/system/wptool29.zip).  If
  27.     WPTOOLS.DLL is not in your LIBPATH, the install.exe will unzip the
  28.     wptools.zip file that contains only the wptools.dll.
  29.  
  30. 3.  Install the VRexx package from IBM Employee written software or use
  31.     the required modules packaged with JoyUp.  You can find the package
  32.     on Hobbes (ftp://hobbes.nmsu.edu/pub/os2/dev/rexx/vrexx.zip).  If
  33.     VREXX.EXE is not in your PATH, the install.exe will unzip the vrexx.zip
  34.     file that contains the required VRexx modules.
  35.  
  36. 4.  Unzip joyup111.zip to a desired directory.  There is no requirement
  37.     that this directory be referenced in any path definition in config.sys.
  38.     There are no changes required in any system configuration files.
  39.  
  40. 5.  Go to the installation directory and run install.exe.
  41.  
  42.     The install will create a JoyUp folder on your desktop that contains
  43.     JoyUp Utility object, the JoyUp Launch Object folder, and the JoyUp
  44.     Target Object folder.
  45.  
  46.     The VRexx files will be unzipped into the JoyUp directory if required.
  47.     If VREXX.EXE is in your PATH, the install.exe will delete the vrexx.zip
  48.     file.
  49.  
  50.     The wptools.dll will be unzipped into the JoyUp directory if required.
  51.     If WPTools is already installed and wptools.dll is in your LIBPATH, the
  52.     install.exe will delete the wptools.zip file.
  53.  
  54.     The rxextras.dll will be unzipped into the JoyUp directory if required.
  55.     If RxExtras is already installed and rxextras.dll is in your LIBPATH, 
  56.     the install.exe will delete the rxextras.zip.
  57.  
  58.     At the completion of the install, the JoyUp Utility will start.
  59.     Select the "Setup all parameters" option.  You will be asked to 
  60.     navigate to the InJoy object.  You will then be asked to pick the
  61.     configuration file to be used.  You are now ready to set up the InJoy
  62.     exits required to keep track of the status of the InJoy dialer.
  63.  
  64. InJoy Setup:
  65.  
  66. 1.  Now you need to set up InJoy to notify JoyUp of its status.  Open the
  67.     InJoy dialer.  Select "Misc.  opt.".
  68.  
  69.     Select "Autostarting modules".  Set the following:
  70.  
  71.     a.  Path and filename - drive:\path\joyup.exe
  72.     b.  Parameters - /online
  73.     c.  Working directory - drive:\path
  74.     d.  Start at - host connect
  75.     e.  Stop at - InJoy exit
  76.     f.  Start minimized - on
  77.     g.  Select "Add"
  78.     h.  Path and filename - drive:\path\joyup.exe
  79.     i.  Parameters - /offline
  80.     j.  Working directory - drive:\path
  81.     k.  Start at - discon.(after)
  82.     l.  Select "Add"
  83.  
  84.     You should now have joyup.exe set up to be called twice, after 
  85.     connect and after hangup.  Select "Ok".  Select "ESC=Go back".
  86.  
  87. Setting up launch objects:
  88.  
  89. 1.  Now you are ready to set up whatever applications you want to use
  90.     with JoyUp.
  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 "drive:\path\joyup.exe /dial". 
  94.     If your mailer client provides an exit for hanging up, you can set it 
  95.     to "drive:\path\joyup.exe /disc" to trigger an InJoy 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 an
  99.     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.  JoyUp 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.  JoyUp wants the actual object name (in the form
  107.     "<object>").  The object name can also be in the form 
  108.     "/L:object_name" without the <> and quotes.  No parameters or working
  109.     directory are accepted because they wil be the parameters currently
  110.     associated with the object.
  111.  
  112. 3.  You can run the JoyUp Utility and select the 'Create an object to
  113.     connect and launch an object id' parameter to build launch objects. 
  114.     The launch object will always be created in the "JoyUp Launch 
  115.     Objects" sub-folder of the "JoyUp" folder.
  116.  
  117.     Because IBM has managed to completely screw up the Object Rexx WPS
  118.     interface, the process of setting an icon for the JoyUp launch object 
  119.     is rather crude.  URL launch objects will have the standard URL icon.
  120.     If an icon can be extracted for the target, it will be used. 
  121.     Otherwise, the folder containing the target object and the settings 
  122.     for the launch object will be opened so that you can drag and drop 
  123.     the target object icon to the icon page of the launch object.
  124.  
  125.     If the object you select to launch does not have a proper object id, 
  126.     it will be assigned a unique id.  You will find another folder, 
  127.     "JoyUp Target Objects" inside of the "JoyUp" folder.  This is where I
  128.     deposit my real URL objects (see note).
  129.  
  130.     Note:  If you use the AWGet package for retrieving URL files, make 
  131.     sure to stop the AWGet dameon before creating an object of a 
  132.     bookmark. Otherwise, AWGet will grab it and run off and hide.
  133.  
  134. 4.  Changes
  135.     1999.09.02 - JoyUp098.Zip
  136.     1) Initial posting to Hobbes
  137.  
  138.     1999.09.04 - JoyUp099.Zip
  139.     1) Added icon capability for URL objects
  140.  
  141.     1999.09.09 - JoyUp100.Zip
  142.     1) Quit trying to work with the icons for abstract objects. May try
  143.        again when the Object Rexx WPS interface gets fixed.
  144.     2) All objects will now be given proper object ids before JoyUp
  145.        uses them.
  146.     3) Added tests to make sure that RxExtras and WPTools are installed
  147.        and usable.
  148.  
  149.     1999.09.11 - JoyUp101.Zip
  150.     1) Simplified setup and initialization by basing the InJoy
  151.        information on the information in the InJoy object rather than
  152.        storing it in JOYUP.INI.
  153.  
  154.     1999.09.30 - JoyUp110.Zip
  155.     1) The application has been redesigned.
  156.     2) The setup, create, and query functions have been re-written in
  157.        VRexx to provide a graphical interface and moved into a separate
  158.        routine called JoyUpU.Cmd.  The VRexx modules (from IBM Employee
  159.        written software) are included.
  160.     3) The status of the InJoy dialer connection is now maintained via a
  161.        Rexx queue and the logic for setting, deleting and querying the
  162.        queue has been moved into a separate routine called JoyUpQ.Cmd
  163.        (which is why the InJoy dialer autostart functions have been
  164.        changed).
  165.     4) Add a routine called JoyUpK.Cmd to kill the VRexx functions if 
  166.        they should become "stuck".
  167.  
  168.     1999.12.20 - JoyUp111.Zip
  169.     1) The install.exe will selectively install the tools necessary for
  170.        its own operation.
  171.     2) The joyupq.cmd has been incorporated back into joyup.cmd.
  172.     3) The install.cmd, joyup.cmd, and joyupu.cmd are now install.exe,
  173.        joyup.exe, and joyupu.exe.  They were converted using the
  174.        REXX2EXE tool.  There are still 2 routines called joyup.cmd
  175.        and joyupu.cmd that will call the new executables.
  176.  
  177.     2000.02.03 - JoyUp111.Zip
  178.     1) Removed the joyup.cmd and joyupu.cmd routines.  Some mailers, like
  179.        Polarbar, do not handle anything except exe modules.
  180.     2) Updated the documentation.
  181.