home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / sysutils / shiftrun / shiftrun.doc < prev    next >
Text File  |  1994-02-04  |  8KB  |  149 lines
  1.  
  2.           ╔═══════════════════════════════════════════════════╗
  3.           ║                                                   ║
  4.           ║                  S H I F T R U N                  ║
  5.           ║                                                   ║
  6.           ║                    Version 1.3                    ║
  7.           ║                  March 24, 1992                   ║
  8.           ║                                                   ║
  9.           ║           Michael Harris - IBM Cary, NC.          ║
  10.           ║                                                   ║
  11.           ╚═══════════════════════════════════════════════════╝
  12.  
  13.  
  14. -----------------------------/ Overview /--------------------------------
  15.  
  16. ShiftRun is a utility that enables a user to optionally start any OS/2 Full
  17. Screen or Windowed program within the same OS/2 session.  "Optionally"
  18. means that the user can choose to start a program by pressing and holding
  19. either SHIFT key before the specified timeout expires.  If he/she does not
  20. press the SHIFT key before the timeout expires, ShiftRun will cancel itself
  21. and allow its calling process to continue.
  22.  
  23.  
  24. ---------------------------/ Requirements /------------------------------
  25.  
  26. ShiftRun requires OS/2 Version 2.0 or higher.  ShiftRun will not function
  27. properly if you are running the pre-installed version of OS/2 2.0.1.  
  28.  
  29.  
  30. -------------------/ Using ShiftRun in CONFIG.SYS /----------------------
  31.  
  32. One of the most useful ways you can use this utility is to put it in your
  33. CONFIG.SYS enabling you to start an OS/2 Full Screen Command Prompt before
  34. Presentation Manager loads. When you do this, you will be able to recover
  35. from many OS/2 problems without having to boot from diskette.
  36.  
  37. You can:
  38.  
  39.         - Edit your CONFIG.SYS file (requires a non-PM text editor)
  40.             (Note that CONFIG.SYS will have already been processed.
  41.              any changes to CONFIG.SYS will not take effect until
  42.              after the user reboots again.)
  43.         - Copy, rename, or delete any files that are not in use
  44.         - Install OS/2 patches
  45.             (Some patches may not install because the DLL's are in use.
  46.              In this case, you must boot from diskette.)
  47.         - Run most full screen programs
  48.  
  49. You cannot:
  50.  
  51.         - Run CHKDSK /F to fixup the OS/2 partition of your harddisk
  52.         - Install OS/2 patches which modify files that are in use
  53.         - Run Presentation Manager programs
  54.         - Run Full-Screen programs which require multiple sessions.
  55.             (Such as OS/2 Lan Requester)
  56.  
  57. To add ShiftRun to your CONFIG.SYS, add the following line:
  58. (This example assumes that SHIFTRUN.EXE is in D:\TOOLS.)
  59.  
  60.     CALL=D:\TOOLS\SHIFTRUN.EXE Timeout ProgramName "Program Parameters"
  61.  
  62. Where:    Timeout               is the timeout in seconds
  63.           ProgramName           is the name of the program to run
  64.           "Program Parameters"  are the program parameters (If you only have
  65.                                   one, the quotes are not necessary.)
  66.  
  67. You can put the CALL= statement almost anywhere in CONFIG.SYS because CALL=
  68. statements are not process until after all SET, LIBPATH, and DEVICE have
  69. been processed.  If, however, you have a problem with ShiftRun, try moving
  70. the CALL= line to the beginning of CONFIG.SYS.
  71.  
  72.  
  73. -----------------------------/ Examples /--------------------------------
  74.  
  75. If you type SHIFTRUN without any parameters, you will get the help screen:
  76.  
  77.   ┌──────────────────────────────────────────────────────────────────────┐
  78.   │ ShiftRun - Version 1.3                                               │
  79.   │ (c) Copyright IBM Corporation 1992, 1993 - All rights reserved.      │
  80.   │                                                                      │
  81.   │ Syntax: ShiftRun Timeout Program.Exe "Program Parameters"            │
  82.   │                                                                      │
  83.   │ Examples:                                                            │
  84.   │       ShiftRun 5 CMD.EXE /k                                          │
  85.   │       ShiftRun 2 CMD.EXE "/C FOO.CMD"                                │
  86.   │       ShiftRun 5 T.EXE C:\CONFIG.SYS                                 │
  87.   │                                                                      │
  88.   │ NOTE: The /K in the first example is necessary to avoid the error:   │
  89.   │       SYS1034: The system cannot find the                            │
  90.   │       command processor in the path specified.                       │
  91.   └──────────────────────────────────────────────────────────────────────┘
  92.  
  93. Here is what you will see if you use the line: SHIFTRUN 5 CMD.EXE /K
  94.  
  95.   ┌──────────────────────────────────────────────────────────────────────┐
  96.   │ ShiftRun - Version 1.3                                               │
  97.   │ (c) Copyright IBM Corporation 1992, 1993 - All rights reserved.      │
  98.   │                                                                      │
  99.   │ Before the timer reaches 0, press and hold:                          │
  100.   │   SHIFT  -  to start CMD.EXE /K                                      │
  101.   │   ESC    -  to cancel ShiftRun                                       │
  102.   └──────────────────────────────────────────────────────────────────────┘
  103.   Seconds left: 5
  104.  
  105. The number to the right of "Seconds left:" will count down to 0 beginning
  106. with the timeout you specify on the command line.  If the you do not press
  107. a key before the timeout, you will see this:
  108.  
  109.   ┌──────────────────────────────────────────────────────────────────────┐
  110.   │ ShiftRun - Version 1.3                                               │
  111.   │ (c) Copyright IBM Corporation 1992, 1993 - All rights reserved.      │
  112.   │                                                                      │
  113.   │ Before the timer reaches 0, press and hold:                          │
  114.   │   SHIFT  -  to start CMD.EXE /K                                      │
  115.   │   ESC    -  to cancel ShiftRun                                       │
  116.   └──────────────────────────────────────────────────────────────────────┘
  117.   Seconds left: 0
  118.   Shift key was not pressed.
  119.  
  120. and the calling process will continue.  The calling process will most
  121. likely be CONFIG.SYS, but it could also be an OS/2 or REXX batch file.
  122.  
  123. If you press the ESC key before the timeout, you will see this:
  124.  
  125.   ┌──────────────────────────────────────────────────────────────────────┐
  126.   │ ShiftRun - Version 1.3                                               │
  127.   │ (c) Copyright IBM Corporation 1992, 1993 - All rights reserved.      │
  128.   │                                                                      │
  129.   │ Before the timer reaches 0, press and hold:                          │
  130.   │   SHIFT  -  to start CMD.EXE /K                                      │
  131.   │   ESC    -  to cancel ShiftRun                                       │
  132.   └──────────────────────────────────────────────────────────────────────┘
  133.   Seconds left: 2
  134.   ShiftRun cancelled.
  135.  
  136. If you press and hold a SHIFT key before the timeout, you will see this:
  137.  
  138.   ┌──────────────────────────────────────────────────────────────────────┐
  139.   │ ShiftRun - Version 1.3                                               │
  140.   │ (c) Copyright IBM Corporation 1992, 1993 - All rights reserved.      │
  141.   │                                                                      │
  142.   │ Before the timer reaches 0, press and hold:                          │
  143.   │   SHIFT  -  to start CMD.EXE /K                                      │
  144.   │   ESC    -  to cancel ShiftRun                                       │
  145.   └──────────────────────────────────────────────────────────────────────┘
  146.   When you exit CMD.EXE,
  147.   the process that called ShiftRun will continue.
  148.  
  149.