home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: SysTools / SysTools.zip / appman1.zip / READ.ME < prev   
Text File  |  1996-04-29  |  9KB  |  191 lines
  1. -----------------------------------------------------------------------------
  2.  
  3.                   A P P L I C A T I O N    M A N A G E R 
  4.                          v00.03.000 for OS/2 v3.x
  5.  
  6.                                  Joel Pettit
  7.                            JPETTIT@Zeus.Odyssey.net
  8.  
  9. -----------------------------------------------------------------------------
  10.  
  11. I.   INTRODUCTION
  12.  
  13.   For a long time I couldn't stand how the OS/2 startup folder handled the
  14.   launching of programs.  There is no mechanism in place that allows the user
  15.   to determine when and how programs get launched.  I suppose there are some
  16.   ways to do this in STARTUP.CMD but who wants to work with a command file
  17.   when a GUI could do the same and then some.  This is what prompted me to 
  18.   create Application Manager.
  19.  
  20. II.  INSTALL
  21.      If receiving Application Manager via a zipped file simply unzip into
  22.      a directory.  There will be two EXEs:
  23.  
  24.      - APPMAN.EXE
  25.      - APPMANSD.EXE
  26.  
  27.      To edit events just run "APPMAN".  
  28.  
  29.      To process the startup event list run "APPMAN -startup".  After 
  30.      creating the start events list, remove all programs from the OS/2 
  31.      startup folder and put AppMan in it.  This will cause AppMan to start
  32.      when the system starts up.
  33.  
  34.      To Process the shutdown event list run "APPMAN -shutdown".  Selecting
  35.      this program icon will cause the shutdown events list to be processed 
  36.      and the subsequent System Exit Method wil execute.  Selecting OS/2's 
  37.      shutdown will do a normal OS/2 shutdown.  AppMan is NOT linked into 
  38.      OS/2's shutdown.
  39.  
  40.      Application Manager's parameters are NOT case sensitive.
  41.  
  42.      After setting up a startup events list the file STARTUP.DAT is created.
  43.      After setting up a shutdown events list the file SHUTDOWN.DAT is 
  44.      created.
  45.  
  46.      Once preferences have been viewed the file PREF.DAT is created.
  47.  
  48. III. FEATURES
  49.  
  50.   1. STARTUP AND SHUTDOWN EVENTS
  51.      Each of these features are the same except on two points: 
  52.  
  53.        - The SHUTDOWN events option actually shuts down OS/2
  54.        - All SHUTDOWN events will wait for the previous one to end
  55.  
  56.      The following is a list of features while editing STARTUP or SHUTDOWN
  57.      events.
  58.  
  59.      A. CONTEXT MENUS
  60.         When the right mouse button is clicked a context menu appears listing
  61.         all possible options.  When the right mouse button is clicked notice
  62.         that the event in the list that the mouse pointer is over gets 
  63.         highlighted.  This will aid in identifying which event is currently 
  64.         being worked on.  If no event is under the mouse pointer the a much 
  65.         smaller list of options is in the context menu.  The user can do as
  66.         much if an item wasn't selected.
  67.  
  68.      B. ADD EVENTS
  69.         The user can add events to the list two ways:
  70.  
  71.         - By selecting "ADD EVENT..." from the context menu
  72.         - dragging a file from a drive object directory folder
  73.  
  74.         The Application Manager doesn't support objects created by the
  75.         Program Template.  Maybe in a later release.  For now, a file with
  76.         the extension EXE, COM, BAT or CMD are supported.  The interface that
  77.         queries for event informartion looks similar to the interface when
  78.         adding a program to an OS/2 folder.  The event is actually added when
  79.         the event list has been saved (ALT-F4). In addition, no two events
  80.         can have the same title.  This is what Application Manager uses to
  81.         keep track of each event.  If while adding an event the user
  82.         specifies a title that already exists they will be prompted to enter
  83.         a different title.
  84.  
  85.      C. REMOVE EVENTS
  86.         Selecting "REMOVE EVENT" simply removes the currently selected event.
  87.         The event is actually removed when the event list has been saved
  88.         (ALT-F4).
  89.  
  90.      D. EDIT EVENT INFORMATION
  91.         The user can edit specific pieces of information directly or the
  92.         event as a whole.  
  93.  
  94.         1. The Title can be edited by selecting "EDIT TITLE..." from the
  95.            context menu.  The title can also be edited by keeping the ALT key
  96.            pressed while selecting the event with the left mouse button.  An
  97.            edit box will appear where the title is and the user can edit it 
  98.            there. 
  99.  
  100.         2. The Start Protocol can  be edited by selecting "Edit Protocol..."
  101.            from the context menu.  This will edit the protocol in which the
  102.            item will be started with.  The event can start only after the
  103.            previous item ends, or can start on a delay started when the
  104.            previous item started or finished.  
  105.  
  106.         3. The Event Enabled option can be edited by selecting
  107.            "Edit Event Enabled..." from the context menu.  This will keep an
  108.            event in the list but will ignore it when processing the list of
  109.            events.  
  110.  
  111.         4. The entire event can be edited by selecting
  112.            "Edit Entire Event...".  This will allow the user to edit the:
  113.  
  114.            - Title
  115.            - Path and File Name
  116.            - Parameters
  117.            - Working Directory
  118.            - Start Protocol
  119.            - Event Enabled
  120.            - Session Type
  121.  
  122.      E. RUNNING EVENTS
  123.         Selecting "Run Event" from the conetx menu will simply start the 
  124.         selected event.  The Start Protocol isn't used since Application 
  125.         Manager is starting just one event.  This provides the user the 
  126.         ability to test an event to see if it will run proporly before
  127.         testing the event list as a whole.
  128.  
  129.      F. PICKUP AND DROP
  130.         The user can also pickup and subsequently drop an event in the
  131.         event list.  This is most useful when many events are in a list and 
  132.         the user wants to copy or move an event from the bottom of the list
  133.         to the top.  Selecting pickup will tag the selected event for
  134.         dropping.  This tag is identified by the event having the IN USE
  135.         shadowing around the icon.  The user then selects an item in the list
  136.         in which the picked up item will be inserted after.  From the context
  137.         menu, the user then opens the drop submenu.  In the submenu, the user
  138.         can Copy or Move the picked up item or cancel the pickup process.
  139.  
  140.      G. DRAG - DROP
  141.         As mentioned earlier, DragDrop is supported for adding events to the 
  142.         event list.
  143.  
  144.      H. SAVING
  145.         An event list is saved when the event manage dialog is closed.  Using
  146.         ALT-F4 will close the dialog as well as double clicking on the 
  147.         System Menu.  Selecting "Exit" from the context menu will give the
  148.         user the opportunity to exit without saving the event list to file.
  149.  
  150.   2. PREFERENCES
  151.      The Preferences dialog displays different toggles on different features.
  152.      The first toggle is the "Prompt for System Exit Method at Shutdown". 
  153.      This toggles the feature of prompting when the system is ready to
  154.      shutdown as to whether or not to shutdown or run the OS/2 dual boot
  155.      option.  If this option is enabled then selecting a System Exit Method
  156.      in the next section of Preferences is disabled.  Otherwise, the System
  157.      Exit Method section is where the method of choice is identified.
  158.         
  159.      The next toggle is the "Minimize Startup and Shutdown Panels".  This
  160.      controls the state of the startup and shutdown panels while processing
  161.      the events list.
  162.  
  163.      The next toggle is the "Close Startup status panel on exit".  This will 
  164.      control whether or not the startup panel remains or ends when done 
  165.      processing events list.  A user may want to keep it around to determine
  166.      if all went well.
  167.  
  168.      The last toggle is the "Icon Size in Event List".  This will control
  169.      the size of the icons in the event list.  The small icons don't look as
  170.      good as I has wished but I left the feature in anyway.
  171.  
  172. IV.  KNOWN PROBLEMS
  173.      None that I am aware of.
  174.  
  175. V.   FUTURE ENHANCEMENTS
  176.       
  177.      1.  Currently no audit trail exists for the processing of events.  If an
  178.          error occurs the user is notified during execution but a log isn't
  179.          created.  
  180.  
  181.      2.  WIN-OS/2 support.
  182.  
  183.      3.  Integrated with the WorkPlace Shell.  Allow Program Objects to be 
  184.          dragged on to the Event List as shadows.
  185.  
  186.  
  187. VI.  FEEDBACK
  188.      Please EMail me at JPETTIT@Zeus.Odyssey.net if you have any questions or
  189.      ideas concerning Application Manager.
  190.  
  191.