home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / utils / sysutl / offrun34.lbr / OFFRUN.DQC / OFFRUN.DOC
Text File  |  1986-04-27  |  4KB  |  92 lines
  1. ;;03-04-85
  2.                           OFFRUN.DOC v3.4
  3.  
  4. Eric Gans
  5. French Dep't UCLA
  6. Los Angeles, CA 90024
  7.  
  8.      This  library  contains the files OFFRUN.COM v3.4  (formerly 
  9. RUNOFF.COM  -- I changed the name to avoid confusion with a well-
  10. known printer program) and LUSER.COM v1.1 from EGUTIL.LBR. 
  11.  
  12.                               *****
  13.  
  14. OFFRUN allows you to input just before turning off your  computer 
  15. a  series  of commands to be run when it is next turned  on.   It 
  16. creates for this purpose (on A0:) a $$$.SUB file containing  your 
  17. command line.  Since it was originally written for the Kaypro-10, 
  18. it  first  runs a hard-disk safety program (renamed  to  OFF.COM) 
  19. after  which,  presumably,  the computer is turned off.  The next 
  20. time  it is turned on (or reset),  the command line will be  run. 
  21. Once a command line has been entered it is stored in the file for 
  22. future  use;  the program asks you whether you want to  keep  the 
  23. current  line  or  enter a new one.  
  24.  
  25.      I  find this useful for two purposes.  First,  if there is a 
  26. set  of  startup files you want to run (loading patches  to  your 
  27. operating  system  like SMARTKEY,  etc.),  OFFRUN will  run  them 
  28. automatically.  Second, if like me you use your computer for both 
  29. work and pleasure, and if the temptations of pleasure tend to get 
  30. in  the way of your work,  then before turning the computer  off, 
  31. enter  the commands you need to get to work and  your  conscience 
  32. will  be tweaked when you next turn the switch.   This has helped 
  33. me  finish a few articles that might otherwise never have  gotten 
  34. done.
  35.  
  36.      The  latest version (3.4) allows you to use OFFRUN from  any 
  37. drive with different command lines.   You must put OFFRUN.COM  in 
  38. user 0 of the drive.  This is to avoid confusion where (as on the 
  39. Kaypro-10)  the operating system allows you to run a COM file  in 
  40. user 0 from any user area; because OFFRUN stores its command line 
  41. in an internal buffer, the user area where the file is found must 
  42. be selected for the file to be opened and written to.  The safety 
  43. program OFF.COM must be in A0.
  44.  
  45.  Three formats are allowed: 1. OFFRUN cmd[;cmd1;cmd2;cmd3...]
  46.  
  47.  This will run the series of commands separated by ';' (no spaces 
  48. please!) and save them on disk for future use.
  49.  
  50.  2. OFFRUN =
  51.  
  52. This  will  display and run the command line stored in  the  file 
  53. without  permitting changes.  If the command buffer is empty  you 
  54. will be asked for input. (v3.4)
  55.  
  56. 3. OFFRUN entered alone allows you to inspect the current command 
  57. line  (if there is none,  the program will ask you to enter one). 
  58. You  are  then  asked if you wish to run or  change  the  set  of 
  59. commands, or to abort the program.
  60.  
  61. Note:  If  you  want  to use this program but don't  have/need  a 
  62. safety  program,  you can either patch OFFRUN  or,  more  simply, 
  63. create  a dummy program thus:  ddt (sid etc.) <cr> a100 <cr>  jmp 
  64. 100  <cr><cr>  ^C save 1 off.com This one-line program will  hang 
  65. your  computer,  thereby  giving you time to turn  it  off.   (My 
  66. previous  suggestion of just entering a 'ret' forced you to  turn 
  67. off the switch in the split second before the rest of the command 
  68. line began to run.)
  69.  
  70.                               *****
  71.  
  72. LUSER.COM  (v1.1)  can be used in conjunction with OFFRUN  or  in 
  73.  .SUB  files.  SUBMIT  and  other  related utilities  (EX  is  an 
  74. exception,  since it creates its command "file" in memory) create 
  75. a  disk  file called $$$.SUB to hold their  command  list  during 
  76. processing. Unfortunately these files cannot be accessed once the 
  77. commands in the file leave the original user area.  Since on hard 
  78. disks  most  application programs are located outside of user  0, 
  79. SUBMIT can't get you to them.
  80.  
  81.      LUSER  was  written  to solve this  problem.  It  moves  the 
  82. $$$.SUB file along with the commands from user area to user area. 
  83. Thus  where the series:  blurk;user 4;zap will not work in a  SUB 
  84. file  (or  with OFFRUN) since when you get to user 4 the  command 
  85. "zap" will be left behind,  the series:  blurk;luser 4;zap  works 
  86. just fine; when the command to go to user 4 is issued the $$$.SUB 
  87. file is taken along and can be accessed.
  88.  
  89.      To avoid BDOS R/O errors that may be encountered when A:  is 
  90. a floppy drive, v1.1 resets the disk system in these cases.
  91.  
  92.  Format: LUSER u where u = user number to go to