home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 103.lha / SetPri.doc < prev    next >
Encoding:
Text File  |  1986-11-21  |  8.3 KB  |  171 lines
  1.  
  2.  
  3.  
  4.                 SSSSSS                  PPPPPP                   
  5.                SS                       P    PP                  
  6.                SS                  T    P    PP                  
  7.                SS                  T    P    PP                  
  8.                  SSSS      EEE   TTTTT  PPPPP    R RRRR   I      
  9.                      SS   E   E    T    P        RRR  R          
  10.                      SS   EEEE     T    P        R        I      
  11.                      SS   E        T    P        R        I      
  12.                 SSSSSS     EEE     T    P        R        I      
  13.  
  14.  
  15.  
  16. Documentation for SetPri V2.1 -- the 'Intuitionized' set priority command.
  17.  
  18. Versions 1.0 - 1.2 were NOT Shareware; 2.0 and above ARE, owing to the
  19. increased functionality of the program beyond that offered by version
  20. below V2.0
  21.  
  22. Written By Charles B. Blish, January, 1988 at SoftCircuits, Inc. for the
  23. Shareware Domain. Thanks to Dewi Williams for providing public domain 'c'
  24. code that clearly and concisely detailed how to approach the whole matter
  25. of AmigaDOS priorities.
  26.  
  27. Enhanced to recognize Workbench tasks January, 1988; Thanks to Andy Finkle
  28. of CBM for pointing the way!
  29.  
  30. SetPri is Shareware; If you find it useful (I bet you do!) Please send
  31. $5.00 to SoftCircuits, Inc, at the address at the end of this file. If
  32. you have suggestions, you can send those also.
  33.  
  34. If SetPri Mungs your system, I'm sorry, but you use this program at your
  35. own risk. It seems to be very well behaved, and has caused no problems
  36. here. The configuration of this system is 1.5 mb RAM, four hard drives,
  37. using the C LTD SCSI controller. I typically run 2-3 tasks... I am a
  38. radio amatuer, and I have a program created here called 'PackComm'. This
  39. is essentially a terminal program optimized for use with Amatuer Radio
  40. Packet. It has lots of neat features, like if someone connects to my
  41. system, the window automatically pops to the front (a menu option, but
  42. I leave it on) and the usual function keys and stuff. It's got a neat
  43. option that allows logging to disk or printer only when connected, so
  44. you can monitor whatever's going on and it won't fill up the world with
  45. trash. Anyway, I leave it running... With a nice high priority, now.
  46. That makes it run *very* well... and bothers nobody. I use SetPri to
  47. control the priority mix in the system, and it works quite well for me. 
  48. If it doesn't meet your needs, I'd be interested to hear why... perhaps
  49. I can make it better. Now, for the meat;
  50.  
  51. Docs are for version 2.1; Supercedes versions 1.0, 1.1 and 1.2, which are
  52. compatible subsets of this version. Use this one, please, and toss the
  53. others.
  54.  
  55. SetPri uses the standard Intuition interface to help you adjust task
  56. priority(s). There are no keystroke commands, other than the standard
  57. Intuition string-gadget editing commands. These include the cursor keys,
  58. Amiga-X to clear the string gadget, the delete key, and the backspace key.
  59.  
  60.  
  61.  
  62. This version of SetPri has four menu entries under the 'Projects' menu.
  63.  
  64. New Task List:  This causes the system to be re-examined for active tasks,
  65.                 and dumps the old list (along with any changes).
  66.                 
  67. Set Tasks Now!: This causes any changes you have made in the list to be
  68.                 passed to AmigaDOS; they go into effect at this time.
  69.                 
  70. Information:    Makes a small window with text info in it. Revision, etc.
  71.  
  72. Exit / Quit:    Just what it says, and offers you the opportunity to
  73.                 quit without making changes if you like. If you have not
  74.                 actually *made* any changes, then it just quits.
  75.  
  76.  
  77. In the window that opens when you start the command, there are three
  78. main functional areas; The task list area at the top, the task editing
  79. area, at the center, and a message area, at the bottom.
  80.  
  81. The task list consists of an 8-entry display that is a window into the
  82. list of tasks. The 8 entries can show up to 8 tasks at once, along with
  83. the priorities of those tasks. There is a proportional gadget by this
  84. list that you can use to scroll the list, if there are more than 8
  85. entries in it. If you would like to change the priority of an item in
  86. the list, you 'hit' (point and click) the small gadget to the left of
  87. that entry with a '>' arrow in it pointing to the entry. This causes the
  88. item in the list to be placed in the task editing area.
  89.  
  90. In the task editing area, there are four items of importance. First,
  91. there is a copy of the name of the task, just there so you can verify that
  92. you got the correct task. You cannot edit this name -- if you try, SetPri
  93. will tell you 'you can't do that!' The reason string gadgets were used to
  94. display text data is that if the data is longer than the gadget (a very
  95. real possibility in this program) you can scoll the name to see it all.
  96.  
  97. The next item is a text gadget that shows the priority, and there is also
  98. a proportional gadget that is set to the value of the priority. You can use
  99. either the text gadget, by typing in a new value, which will update the
  100. proportional gadget, or you can use the proportional gadget, which will
  101. update the text gadget. Once you have the item set to the desired priority,
  102. hit the 'SET' button, and the change is made in the list... NOT IN THE
  103. SYSTEM! You can continue changing priorities until you are satisfied that
  104. they are set up as you like, and then you may pass the changes to the
  105. system by either quitting or selecting 'Set Tasks Now!' from the menu.
  106.  
  107. Why change the tasks in the list and not in the system? Well, if you have
  108. a situation where you have two tasks that are CPU hogs, you really should
  109. set them to the same priority, un less you KNOW that the one with the higher
  110. priority is going to relinquish the CPU eventually; Otherwise, the lower
  111. priority job may never run again. In some circumstances, that may lock up
  112. the system By making the changes in the list, you have the opportunity to
  113. create a set of priorities that you can examine as a group, and verify that
  114. they are set as you intended; If not, you can fix it without a lockup. If
  115. they are, then one menu selection will take care of the job for you.
  116.  
  117. If you have had SetPri running for a while, you are well advised to choose
  118. "New Task List" from the menu BEFORE attempting to adjust any priorities;
  119. If one of the tasks in an old list has terminated, SetPri will ATTEMPT to
  120. handle the situation; however, it is possible that it will try to set the
  121. priority of a now-nonexistant task.... not a good deal. GURU time, maybe.
  122.  
  123. The message area can tell you a number of things, here they are:
  124.  
  125. O.K.                       (rough, eh?)
  126. You Can't Do That!         Like it says. Be nice, ok?
  127. Unknown Gadget Event       You should never see this one!
  128. OpenWindow Failed          If it can't open the Info window -- no memory?
  129. Unknown Menu Event         You shouldn't see this, either...
  130. Priority Change Made       in the LIST, not the system
  131. Not A Change!              The value you ended up with is = to the original.
  132.  
  133. You may see the following requesters:
  134.  
  135. _________________________________________________
  136. |                                               |
  137. | You have altered one or more system priorites:|
  138. |    Quit and make changes? Are You Sure?       |
  139. |  -Yes-                               - No-    |
  140. |_______________________________________________|
  141. ________________________________________________
  142. |                                               |
  143. | You have altered one or more system priorites:|
  144. |      Activate changes? Are You Sure?          |
  145. |  -Yes-                             -No-       |
  146. |_______________________________________________|
  147. ___________________________________________
  148. |                                         |
  149. | Would you like to return to the program |
  150. |          instead of quitting?           |
  151. |      -Yes-                  -No-        |
  152. |_________________________________________|
  153.  
  154.  
  155. Overall, I reiterate - this is a VERY powerful utility in the context of
  156. what it can do to/with your system's performance, and your productivity.
  157.  
  158. Misuse it, and it'll nuke you, no problem. Use it well, and you'll be SO
  159. happy you have it, you'll send me money just out of the goodness of your
  160. heart. Well, perhaps you'll think about it, anyway. Maybe not. But you'll
  161. be glad you have it. I think. And if not, delete it. Nyah nyah.
  162.  
  163. And that's about it. Letters should be addressed to:
  164.  
  165.        Charles B. Blish
  166.       SoftCircuits, Inc.
  167.   701 Nw 13th Street, Suite C4
  168.           Boca Raton
  169.             33432
  170.  
  171.         305-368-7024