home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 27 Fixes20 / 27-Fixes20.zip / pj12214.zip / readme.doc < prev   
Text File  |  1994-07-06  |  11KB  |  208 lines
  1.  
  2. APAR= PJ12214
  3. DATA IS CORRUPTED ON A: FLOPPY DRIVE ON RETURN FROM DOSDEVIOCTL
  4. CALL TO LOCK FLOPPY DEVICE.
  5.  
  6. ******************************************************************************
  7. INSTALLK.EXE --
  8.  
  9. Please read the following information about the fix installation program BEFORE
  10. you attempt to install the fixes provided. The ABSTRACT explains how the fixes
  11. are applied to your system, and how they are managed so that additional fixes
  12. can be applied in the future. Following the ABSTRACT are the installation
  13. instructions, complete with examples of how to invoke the installation program.
  14. Following the installation instructions are the descriptions of the fixes you
  15. have received and the OS/2 system module being fixed.
  16.  
  17. ABSTRACT:
  18. ---------
  19.  
  20. The fix diskette you received contains the following files:
  21.  
  22. INSTALLK.EXE -- the fix installation program.
  23.  
  24. MODULE.LOG   -- input file that tells the installation program which OS/2 system
  25.                 modules are being fixed, the file containing the fix for each
  26.                 module, and the location of the modules following an OS/2 2.1
  27.                 installation.
  28.  
  29. *.*          -- the modules containing the fix for each APAR described above.
  30.  
  31. README.1ST   -- Fix installation instructions.
  32.  
  33. README.DOC   -- this file, which contains the description of each APAR fixed in
  34.                 the modules provided, an explanation of the files contained on
  35.                 the diskette, an explanation of how fixes are applied to your
  36.                 system, and instructions on how to invoke INSTALLF.EXE.
  37.  
  38. Presently, the fixes provided are new full-sized system modules, which will
  39. replace the corresponding OS/2 2.1 GA-level system modules. Eventually, fixes
  40. will be applied to your system modules using "patches" instead of replacing them
  41. with new full-sized system modules. A patch can ONLY be applied to an OS/2 2.1
  42. GA-level system module, so it's important that you follow the instructions
  43. provided so that fixes can be applied in the future to both system modules that
  44. have already been fixed and those that haven't. INSTALLF.EXE will "archive" the
  45. system module being fixed to either your disk or a diskette. One of the
  46. parameters you specify when invoking INSTALLF.EXE allows you to choose the drive
  47. where you want the files archived, but whatever you choose, it is absolutely
  48. necessary that you maintain these files as they will be needed each time you
  49. want to apply fixes to your system. For example, if you specified D:, the
  50. modules would be archived in D:\ARCHIVE.
  51.  
  52. When a fixed system module replaces the corresponding OS/2 2.1 GA-level system
  53. module for the first time, the OS/2 2.1 GA-level system module is saved in the
  54. \ARCHIVE directory of the drive you specified when invoking INSTALLF.EXE. This
  55. is considered the "current" fix. If the same system module needs to be replaced
  56. again, the current fixed system module is backed-up on the same drive you
  57. specified to archive files to, and the new fixed system module is copied to the
  58. directory where the current system module had been. For example, if you
  59. specified D:, the current system module would be saved in D:\BACKUP.
  60.  
  61. **** NOTE 1 ********************************************************************
  62. Presently, "true" Backout is not supported in INSTALLF.EXE. If you have a need
  63. to return your system to the OS/2 2.1 GA-level (ie. you need to reinstall a fix
  64. due to some failure), you will be required to copy the OS/2 2.1 GA-level module
  65. you need from the \ARCHIVE directory into the directory where the corresponding
  66. system module exists. If you have a need to return your system to a previous fix
  67. level, you will be required to copy the system module you need from the \BACKUP
  68. directory into the directory where the corresponding system module exists.
  69. **** END NOTE 1 ****************************************************************
  70.  
  71. INSTALLF.EXE maintains a record of all fixes applied to your system in the log
  72. file LOGU001.OS2. This log file is maintained on the same drive where you have
  73. OS/2 2.1 installed, and in the directory \OS2\INSTALL. Another parameter you
  74. specify when invoking INSTALLF.EXE is the drive where OS/2 2.1 is installed. For
  75. example, if OS/2 2.1 is installed on the C: drive, the log file would be
  76. maintained in C:\OS2\INSTALL.
  77.  
  78. **** NOTE 2 ********************************************************************
  79. IT IS ABSOLUTELY NECESSARY that you maintain the location of the 2 items just
  80. described to you: 1.) the archived OS/2 2.1 GA-level system modules, and 2.) the
  81. log file LOGU001.OS2. The archived system modules and the log file are REQUIRED
  82. each time you want to apply fixes to your system. If you specified the disk
  83. drive on which you want to store the system modules, DO NOT delete the directory
  84. \ARCHIVE, AND, DO NOT delete the directory \OS2\INSTALL where the log file is
  85. stored. If you specified a diskette drive on which you want to store these
  86. files, DO NOT erase the contents or lose the diskettes. If these files are not
  87. available, you will have to re-install the OS/2 2.1 GA-level diskettes if you
  88. want to apply new fixes.
  89. **** END NOTE 2 ****************************************************************
  90.  
  91.  
  92. KEY PROCEDURES PERFORMED BY INSTALLF.EXE:
  93. -----------------------------------------
  94.  
  95. 1.) ARCHIVING -- This is the process of storing an OS/2 2.1 GA-level system
  96.                  module in the directory \ARCHIVE on the specified logical
  97.                  drive.
  98.  
  99. 2.) BACKING-UP -- This is the process of saving current fixed system modules
  100.                   that exist from previous fixes in the directory \BACKUP on the
  101.                   specified logical drive. If there is ever a need to return the
  102.                   system to a previous fix level, then you can copy the system
  103.                   module you need from this directory into the directory where
  104.                   the corresponding system module exists.
  105.  
  106. 3.) SERVICE LOGGING -- INSTALLF.EXE maintains a record of all service activity
  107.                        performed on your system in the file LOGU001.OS2.
  108.                        INSTALLF.EXE requires this file to determine if fixes
  109.                        have ever been applied to your system, and if so, where
  110.                        to locate the files that have been stored. If you are
  111.                        installing multiple fixes from a pervasive 'pak',
  112.                        INSTALLF.EXE will record the service information to the
  113.                        temporary file LOGU001.BAK. When all fixes have been
  114.                        applied, LOGU001.BAK will be written to LOGU001.OS2. If
  115.                        you interrupt INSTALLF.EXE while it is applying fixes, do
  116.                        not erase LOGU001.BAK. INSTALLF.EXE needs this file to
  117.                        continue applying fixes when you re-run INSTALLF.EXE.
  118.  
  119.  
  120.  
  121. INSTALLATION INSTRUCTIONS:
  122. --------------------------
  123.  
  124. **** NOTE 3 ********************************************************************
  125. INSTALLF.EXE will attempt to copy the fixed system module into the path where it
  126. was installed during the installation of OS/2 2.1. If the file does not exist in
  127. the assumed path, you will be prompted for its location. For example, if the
  128. file being replaced is actually located in \OS2\DLL_BAK, you would enter that
  129. path-name when prompted.
  130. **** END NOTE 3 ****************************************************************
  131.  
  132.  
  133.  
  134. 1.) If the system module being fixed is being used by the operating system, it
  135.     will be necessary to do the following so that a patch can be applied:
  136.  
  137.     a.) Start your system using the OS/2 2.1 Installation Diskette.
  138.  
  139.     b.) When prompted, insert Diskette 1.
  140.  
  141.     c.) When prompted to continue or escape, press the ESC key to get to a
  142.         command prompt. Continue to step 2.
  143.  
  144. 2.) To install the fixes, type the following at the command prompt and then
  145.     press enter:
  146.  
  147.       INSTALLF source dest arch-back
  148.  
  149.         where:
  150.  
  151.         source  is the source drive where the files from the fix diskette can be
  152.                 found. INSTALLF.EXE can apply the fixes from either your disk
  153.                 drive or diskette drive. If you choose to apply the fixes from
  154.                 your disk drive, make sure you copy ALL files from the fix
  155.                 diskette to the disk drive. For example, if you copied the files
  156.                 from the fix diskette to C:\FIX, then source would be C:\FIX. If
  157.                 you want to apply fixes from the diskette drive, then source
  158.                 would be A:.
  159.  
  160.           dest  is the drive letter of the system partition where OS/2 2.1 is
  161.                 installed. For example, if OS/2 2.1 is installed on C:, then
  162.                 dest would be C:.
  163.  
  164.      arch-back  is the logical drive where you want the OS/2 2.1 GA-level
  165.                 modules that are being fixed stored, AND, where fixed modules
  166.                 from previous fixes are backed-up. The directories \ARCHIVE and
  167.                 \BACKUP will be created. For example, if you want these files
  168.                 stored on your D: drive, then arch-back would be D:. If you want
  169.                 these files stored on a diskette in your A: drive, then
  170.                 arch-back would be A:.
  171.  
  172.     EXAMPLE:  If you choose to install the fixes from your A: diskette drive,
  173.               and OS/2 2.1 is installed on C:, and you want \ARCHIVE and \BACKUP
  174.               on your D: drive, then you would enter the following:
  175.  
  176.                 INSTALLF A: C: D:
  177.  
  178. As soon as INSTALLF.EXE has been started, it is important that you allow it to
  179. finish installing all of the fixes that you have received. The message "Fix
  180. successfully installed" will be displayed when the installation is complete. If
  181. this message does not appear, or INSTALLF.EXE ended for some other reason,
  182. please follow the error message and re-run INSTALLF.EXE if necessary.
  183.  
  184. 3.) The service log maintained in \OS2\INSTALL\LOGU001.OS2 is stored in an
  185.     unreadable format. If there is a service requirement to view the service
  186.     log, you can view the log file by entering the following:
  187.  
  188.       INSTALLF drive
  189.  
  190.         where:
  191.  
  192.          drive  is the drive where OS/2 2.1 is installed.
  193.  
  194.     EXAMPLE:  If OS/2 2.1 is installed on the C: drive, you would enter the
  195.               following:
  196.  
  197.                 INSTALLF C:
  198.  
  199.     If you would like to print the log file, simply redirect the output of the
  200.     previous command to a print device attached to your system. For example:
  201.  
  202.       INSTALLF C: > lpt1:
  203.  
  204. **** NOTE 4 ********************************************************************
  205. We suggest that you store INSTALLF.EXE on your disk drive so that if you ever
  206. need to view the service log, the program is available to do so.
  207. **** END NOTE 4 ****************************************************************
  208.