home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / programming / utilities / task106.lha / Task / Task.DOC < prev    next >
Encoding:
Text File  |  1993-10-04  |  2.6 KB  |  81 lines
  1. TABLE OF CONTENTS
  2.  
  3. Task
  4.  
  5. Task v1.06                            Task v1.05
  6.  
  7.     NAME
  8.     Task - An EXPERT USER Tool for changing any tasks priority or
  9.            signalling a task. This tool requires Kickstart 2.04 or
  10.            greater.
  11.  
  12.    SYNOPSIS
  13.     Task [task address|task name] [PRI priority] [SIG signal(s)]
  14.  
  15.    FUNCTION
  16.     C:ChangeTaskPri cannot change task priorities of non-DOS-processes
  17.     and C:Break cannot signal a non-DOS-process - 'Task' can! Start
  18.     'Task' without parameters to get a list of all waiting tasks on
  19.     your Amiga. If you run 'Task' without giving any task address or
  20.     name, 'Task' changes its own Shell-Process-priority (works like
  21.     C:ChangeTaskPri <priority>) or signals itself.
  22.     You cannot specify address AND name because I think that this
  23.     would be 100% useless.
  24.  
  25.    INPUTS
  26.     ADDRESS - tasks address. This value must be given as an hexadecimal
  27.         address, e.g. $0034B700.
  28.  
  29.     NAME - task name. This is your tasks name if you don't know its
  30.         address (e.g. in script files). This argument is CASE
  31.         SENSITIVE! If you want to changepri/signal a DOS-process
  32.         just specify e.g. "palette" (the process name) instead of
  33.         "Background CLI [palette]"!
  34.  
  35.     PRI/N - new priority for task. This is a value between -128
  36.         and 127. Usual values are between -10 and 10!
  37.  
  38.     SIG - dos signals. That could be C, D, E or F or any combination
  39.         of them. Remember:
  40.         C means 'breaking' a task, F signals 'bring window to front
  41.         and activate it'.
  42.  
  43.    RESULTS
  44.     If the given ADDRESS is a valid waiting tasks address or NAME is
  45.     the name of a waiting task, 'Task' sets the task priority to the
  46.     new value and/or signals the task. If anything is wrong or no
  47.     argument is given, 'Task' shows a list of all waiting tasks in
  48.     the system. Tasks without name that are not waiting for any signals
  49.     are not shown because they should not be modified by ANY user.
  50.  
  51.    EXAMPLES
  52.         Task $0034b700 pri 0
  53.         Task printer.device pri -10
  54.         Task pri 30
  55.     Task palette sig c
  56.     Task font pri=4 sig=ef
  57.  
  58.    NOTES
  59.     This tool is for EXPERT USERS ONLY. I'm not responsible for any
  60.     damage caused by 'Task'. This program may freely be distributed
  61.     without any profit as long as all copyright notices are left intact
  62.     and all 'Task'-files are distributed together:
  63.             Task        2240 bytes
  64.             Task.doc    2695 bytes
  65.  
  66.         Any comments/donations/bug reports/questions... to:
  67.               Tobias Ruland
  68.               St.Johann 6/VIII/124
  69.               D-91056 Erlangen
  70.               Germany
  71.         INTERNET: tsruland@immd8.informatik.uni-erlangen.de
  72.  
  73.     'Task' was coded in assembler for minimum size and minimum bugs :-)
  74.     Source code is available from author.
  75.  
  76.    SEE ALSO
  77.     your AmigaDOS manual, "ChangeTaskPri" and "Break"
  78.  
  79.    BUGS
  80.     None known.
  81.