home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / sp.zip / sp.doc < prev    next >
Text File  |  1993-09-17  |  3KB  |  97 lines
  1. SetPriority Version 1.0 by Jens Glathe 9-17-1993
  2.  
  3. This is a utility to start a program at a defined priority.  It is also able to
  4. start a VDM (DOS-session) at a defined priority.
  5.  
  6. The initial code used as a base for sp.exe is from Scott Dudley, thanks to him.
  7. The file sp.zip contains:
  8.  
  9.         sp.exe          OS/2 executable
  10.         spdos.exe       DOS executable to start a DOS session with other 
  11.                         priority
  12.         vdosprio.sys    Virtual Device Driver for the DOS sessions (MUST be 
  13.                         loaded to change the priority)
  14.         sp.c, sp.def    source code for sp.exe
  15.         sp.rc, sp.ico   recource file and icon
  16.         spdos.pas       source for spdos.exe
  17.         setprio.pas,
  18.         setprio.tpu,
  19.         prioint.asm,
  20.         prioint.obj     source for the library used by spdos.exe
  21.  
  22.         setprdd.asm,
  23.         setprdd.inc,
  24.         setprdd.def     source code for the VDD vdosprio.sys
  25.  
  26.         asmsetpr.bat    TASM cmdline to assemble the VDD source
  27.         linkprdd.cmd    link386 cmdline to link the VDD
  28.         sp.doc          this file.
  29.  
  30. Usage of sp:
  31.  
  32. SP <class>[delta] <sessiontype> <program> [args...]
  33.  
  34. <class>:  n=no change, i=idle, r=regular, f=foreground, t=time critical
  35. [delta]:  Any number from -31 to 31, 0 to 31 for DOS sessions
  36. <sessiontype>:  o=OS/2 Window or PM App, d=DOS-Window, D=DOS-Fullscreen
  37.  
  38. The driver "VDOSPRIO.SYS" must have been loaded to change the priority
  39. of a DOS session.
  40.  
  41. If a DOS session shall be started, sp invokes spdos.exe, which sets the
  42. priority of the VDM and executes the program.
  43.  
  44. You can use spdos directly:
  45.  
  46. SPDOS <class>[delta] <program> [args...]
  47.  
  48. Requirements:
  49.  
  50.         OS/2 version 2.x (32-bit app, does not run under 1.x)
  51.         sp.exe and spdos.exe must be reachable by PATH or in the same directory.
  52.         DEVICE=(path)vdosprio.sys in your config.sys file.
  53.  
  54. Notes:
  55.  
  56. The VDD hooks the DOS int 45h to get a connection to the VDM. I hope that nobody
  57. uses this int. If there are problems with this int, recompile the VDD and the 
  58. pascal library for another int.
  59.  
  60. If you set a DOS session which has an idle loop consuming full cpu time (such 
  61. as the Turbo IDE) to time critical (highest) priority, the system gets in
  62. trouble. Setting the priority to r31 is enough, f is also allowed.
  63.  
  64. There is another priority class for VDM's: SIMULATED INTERRUPT, but it doesn't 
  65. seem to work. Therefore the sp utility doesn't support it.
  66.  
  67. DISCLAIMER OF WARRANTIES:
  68.  
  69. (I don't write legal stuff in a foreign language, sorry):
  70. ----------------------------------------------------------------------
  71.  
  72. Ich uebernehme keinerlei Gewaehrleistung für korrekte Funktion oder
  73. irgendwelche daraus resultierenden Schaeden oder Folgeschaeden. Es
  74. liegt in der Natur von Geraetettreibern, dass dadurch die Integritaet
  75. des Systems verletzt werden kann.
  76.  
  77. Licence:
  78. --------
  79.  
  80. You are free to use and modify this source, as long as you make your
  81. source available for public according to the usual GNU Copyleft license.
  82.  
  83. Bug reports, hints, suggestions etc.:
  84.  
  85. Send it to me:
  86.  
  87.         Internet:       jensajce@w271zrz.ZRZ.TU-Berlin.de
  88.  
  89.  
  90.         Normal letter:  Jens Glathe
  91.                         Keithstr. 36 Apt. 604
  92.                         D-10787 Berlin
  93.                         Germany
  94.  
  95.         Phone:          (030) 262 75 33
  96.  
  97.