SetIntPri V1.0 DOCS
              ===================

        (c) 1994 by SiliconSurfer/Phantasm
           SiliconSurfer@Dame.sh.sub.de

      SetIntPri V1.0 is freely distributable



   SetIntPri  is  used  to  change the priority of any interrupt server.
   OS2.04+  ist required.  It DOES need to be given the full name of the
   interrupt  server  to  change.   This  was  written as a simple shell
   command  that  does not need a GUI and can be used in scripts or from
   the shell.

   This program was written to help a well-known sysop in Hamurg/Germany
   with his 8 nodz Amiga BBS.


USAGE

   Although  SetIntPri  will run from the Workbench, it will only really
   make  sense  to  run  it  from  the  shell or a script.  It takes the
   ReadArgs template :

   NAME/A,PRIORITY/A/N,Q=QUIET/S

   NAME  is  the name of the interrupt server to change.  This parameter
   is compulsory and must be an ascii string.

   PRIORITY  is  the new priority you wish to give the interrupt server.
   It  must  be  a  number  between  -128  and  +127.  This parameter is
   compulsory.

   Q=QUIET  .   Specifying  Q  or  QUIET as the last parameter will stop
   SetIntPri  from  issuing  any  messages.   Useful  for scripts.  This
   parameter is optional.


EXAMPLES

   SetIntPri ciab.resource 50 Q

      Sets the priority of the interrupt server ciab.resource (if installed).
      No messages are output.

   SetIntPri z3scsi.device 100

      Sets the priority of the interrupt server z3scsi.device to 100 and
      reports what it has done to the shell.

   SetIntPri NAME AT-IDE PRIORITY 10 QUIET

      Changes the priority of the interrupt server AT-IDE to 10 with no
      message reporting. The Keywords are NOT compulsory.


RETURN CODES

   0  :  All was OK, and the interrupt priority was changed
   5  :  There was an error in the ReadArgs parameters
   10 :  The requested priority was out of the range -28 to +127
   20 :  The named interrupt could not be found. Either it was not installed
         or you spelt it wrong.


COPYRIGHT

   I  retain  full  copyright  over  this  program.   It  may  be freely
   distributed  electronically  or  by  reasonable cost PD floppy disks.
   Magazines are specifically forbidden from publishing SetIntPri on any
   coverdisk  without  my  express  written  permission.   Any  magazine
   failing  to  abide  by  this  condition  will  be  held  in breach of
   copyright.

DISCLAIMER

   Use  this program at your own risk.  I make no claims of it's fitness
   for  purpose and will not be held responsible for any loss, damage or
   injury,  consequential  or  otherwise,  resulting  from  it's  use or
   distribution.