home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / shftrn.zip / ShiftRun.Doc < prev    next >
Text File  |  1994-11-01  |  6KB  |  130 lines
  1.  
  2.           ╔═══════════════════════════════════════════════════╗
  3.           ║                                                   ║
  4.           ║                  S H I F T R U N                  ║
  5.           ║                                                   ║
  6.           ║                    Version 1.5                    ║
  7.           ║                 November, 1, 1994                 ║
  8.           ║                                                   ║
  9.           ║           Michael Harris - IBM Cary, NC.          ║
  10.           ║                                                   ║
  11.           ╚═══════════════════════════════════════════════════╝
  12.  
  13. OVERVIEW
  14. ---------------------------------------------------------------------
  15.  
  16.    ShiftRun is a utility that enables a user to optionally start any 
  17.    OS/2 Full Screen or Windowed program within the same OS/2 session.  
  18.    "Optionally" means that the user can choose to start a program by 
  19.    pressing and holding either SHIFT key before the specified timeout 
  20.    expires.  If he/she does not press the SHIFT key before the timeout 
  21.    expires, ShiftRun will cancel itself and allow its calling process 
  22.    to continue.
  23.  
  24.  
  25. REQUIREMENTS
  26. ---------------------------------------------------------------------
  27.  
  28.    ShiftRun requires OS/2 Version 2.0 or higher.  ShiftRun will not 
  29.    function properly if you are running the pre-installed version of 
  30.    OS/2 2.0.1.
  31.  
  32.  
  33. HISTORY
  34. ---------------------------------------------------------------------
  35.  
  36.    Version 1.6 - November 1, 1994
  37.       Bug Fix: On some systems, ShiftRun would always behave
  38.                as if a shift key were pressed at each boot.
  39.                This behavior is most frequently seen on OS/2
  40.                Warp Version 3 (General Availability).
  41.       Added character echo (a *) when password is entered
  42.  
  43.    Version 1.5 - July 26, 1994
  44.       Password protection added
  45.       Added beep option when counting down
  46.  
  47.    Version 1.4 (Only released in beta form)
  48.  
  49.    Version 1.3 - March 24, 1992
  50.       Added new interface and help screen
  51.  
  52.    Version 1.2 - March 9, 1992
  53.       Internal beta test version
  54.  
  55.    Version 1.1
  56.       Initial Release
  57.  
  58.  
  59. USING SHIFTRUN IN CONFIG.SYS
  60. ---------------------------------------------------------------------
  61.  
  62.    One of the most useful ways you can use this utility is to put it 
  63.    in your CONFIG.SYS enabling you to start an OS/2 Full Screen 
  64.    Command Prompt before Presentation Manager loads. When you do this, 
  65.    you will be able to recover from many OS/2 problems without having 
  66.    to boot from diskette.
  67.  
  68.    You can:
  69.         - Edit your CONFIG.SYS file (requires a non-PM text editor)
  70.             (Note that CONFIG.SYS will have already been processed.
  71.              any changes to CONFIG.SYS will not take effect until
  72.              after the user reboots again.)
  73.         - Copy, rename, or delete any files that are not in use
  74.         - Install OS/2 patches
  75.             (Some patches may not install because the DLL's are in use.
  76.              In this case, you must boot from diskette.)
  77.         - Run most full screen programs
  78.  
  79.    You cannot:
  80.         - Run CHKDSK /F to fixup the OS/2 partition of your harddisk
  81.         - Install OS/2 patches which modify files that are in use
  82.         - Run Presentation Manager programs
  83.         - Run Full-Screen programs which require multiple sessions.
  84.             (Such as OS/2 Lan Requester)
  85.  
  86.    To add ShiftRun to your CONFIG.SYS, add the following line:
  87.    (This example assumes that SHIFTRUN.EXE is in D:\TOOLS.)
  88.  
  89.    CALL=D:\TOOLS\SHIFTRUN.EXE Timeout Program [Parameters] [/b] [/p=MyPasswd]
  90.  
  91.    Where:   Timeout     is the timeout in seconds
  92.             Program     is the name of the program to run
  93.             Parameters  (optional) are the program's parameters (If you
  94.                            have more than one parameter, you need to put
  95.                            all the parameters in one set of quotes.)
  96.             /b          tells ShiftRun to beep every second
  97.             /p=passwd   tells Shiftrun to require a password before
  98.                            running the program.  If the user does not
  99.                            enter the correct password within three
  100.                            tries, ShiftRun will exit and whatever
  101.                            process was in progress (such as booting OS/2)
  102.                            will continue.  The password must not be
  103.                            longer than 254 characters however, it is
  104.                            unlikely that you can use a password that
  105.                            long because the entire CALL= line in
  106.                            CONFIG.SYS should be below 254 characters.
  107.  
  108.    You can put the CALL= statement almost anywhere in CONFIG.SYS because
  109.    CALL= statements are not process until after all SET, LIBPATH, and
  110.    DEVICE have been processed.  If, however, you have a problem with
  111.    ShiftRun, try moving the CALL= line to the beginning of CONFIG.SYS or
  112.    the bottom of CONFIG.SYS.
  113.  
  114.  
  115. EXAMPLES
  116. ---------------------------------------------------------------------
  117.  
  118.          ShiftRun 5 CMD.EXE /k /b                                        
  119.          ShiftRun 2 CMD.EXE "/C FOO.CMD"                                 
  120.          ShiftRun 5 CMD.EXE "/C FOO.CMD" /b                              
  121.          ShiftRun 5 T.EXE "" /b
  122.          ShiftRun 5 T.EXE C:\CONFIG.SYS                                  
  123.          ShiftRun 5 T.EXE C:\CONFIG.SYS /b /p=MyPassword
  124.                                                                          
  125.    NOTE: The /K in the first example is necessary to avoid the error:    
  126.          SYS1034: The system cannot find the                             
  127.          command processor in the path specified.                        
  128.  
  129.  
  130.