home *** CD-ROM | disk | FTP | other *** search
/ IBM Presents OS/2 Software Hits 1995 / OS-2_SW_HITS_2ND_EDITION_1995.ISO / i17 / bootdisk.1dk / unc.dsk / README.INF (.txt) < prev    next >
OS/2 Help File  |  1994-03-18  |  23KB  |  801 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Corrective Service Facility (CSF) Overview ΓòÉΓòÉΓòÉ
  3.  
  4. CSF is a utility program that is used to apply service updates to the OS/2* 
  5. operating system and to OS/2-based subsystems and applications.  In addition, 
  6. CSF installs service updates in such a manner that the updates can be tracked 
  7. and, if necessary, backed out. 
  8.  
  9. CSF supports two classes of service update packages (ServicePaks): 
  10.  
  11. Full ServicePak  The full ServicePak SYSLEVEL is always higher than the 
  12.                  SYSLEVEL that is being refreshed, and will alter the SYSLEVEL 
  13.                  to the level of service being applied. 
  14.  
  15. Fix ServicePak   The fix ServicePak SYSLEVEL is always increasing for fixes 
  16.                  within a given SYSLEVEL, but will not change the existing 
  17.                  SYSLEVEL. 
  18.  
  19. The CSF utility program does the following: 
  20.  
  21. o Provides SERVICE and FSERVICE (CSF components) for ServicePak application. 
  22.  
  23. o Supports the following function for SERVICE and FSERVICE for all ServicePaks: 
  24.   c. 
  25.  
  26.    - ARCHIVE 
  27.  
  28.    - BACKUP 
  29.  
  30.    - BACKOUT c. 
  31.  
  32.       o BACKOUT to ARCHIVE 
  33.  
  34.       o BACKOUT to BACKUP 
  35.  
  36.    - COMMIT 
  37.  
  38.      COMMIT provides the following: c. 
  39.  
  40.       o DELETE ARCHIVE (references) and BACKUP files (full ServicePak) 
  41.  
  42.       o DELETE BACKUP files (fix ServicePak) 
  43.  
  44.       o REDIRECT ARCHIVE 
  45.  
  46.         REDIRECT must be to another existing ARCHIVE location.  REDIRECT does 
  47.         not copy or move ARCHIVE files. 
  48.  
  49. o Provides two levels of BACKUP: c. 
  50.  
  51.    - ARCHIVE level: c. 
  52.  
  53.       o Original product version (installed) 
  54.  
  55.       o Original product current-version (installed) 
  56.  
  57.       o Full ServicePak (committed) 
  58.  
  59.    - BACKUP level: c. 
  60.  
  61.       o Original product version (installed) 
  62.  
  63.       o Original product current-version (installed) 
  64.  
  65.       o Fix ServicePak (previous fix level) 
  66.  
  67. o Supports ARCHIVE and BACKUP on a product instance basis.  If multiple copies 
  68.   of a product exist on the same drive, archiving and backup are performed for 
  69.   each instance of the product installed. c. 
  70.  
  71.    - Supports file archives saved on diskette and on local and remote hard 
  72.      disks. 
  73.  
  74.    - Supports file backups saved to diskette or a local hard disk. 
  75.  
  76. o Supports ARCHIVE sharing among multiple matching product instances.  This is 
  77.   a valuable benefit to users who can share an ARCHIVE on a LAN server, thus 
  78.   saving disk space on numerous local drives. 
  79.  
  80. o Supports packed file and patch file formats in a single ServicePak.  ARCHIVE 
  81.   versions of full ServicePak files are always saved as whole files.  BACKUP 
  82.   versions of fix ServicePak files are saved either as whole files or as patch 
  83.   files.  Patch files contained within a fix package are built relative to the 
  84.   most recent version of the product.  This means that patch files are built to 
  85.   be applied on top of full ServicePaks, original, or current product versions. 
  86.  
  87. o Supports BACKOUT of a fix ServicePak version, provided that the BACKOUT is 
  88.   performed before the next fix or full ServicePak version is applied. 
  89.  
  90.   Backing out of a full ServicePak restores your system to one of two possible 
  91.   states: c. 
  92.  
  93.    - If BACKUP was made during the application of the full ServicePak, then you 
  94.      can restore your system to the previous level BACKUP. 
  95.  
  96.    - If no BACKUP was made, then you can restore your system to the previous 
  97.      ARCHIVE level only. 
  98.  
  99. o Generates service log files and an ARCHIVE layout file, which contain updated 
  100.   system and product information.  CSF uses this information when applying 
  101.   SERVICE. 
  102.  
  103. o Supports the application of service to a specific SYSLEVEL of the OS/2 
  104.   operating system, subsystems, or products. 
  105.  
  106.  
  107. ΓòÉΓòÉΓòÉ 2. Using the Corrective Service Facility ΓòÉΓòÉΓòÉ
  108.  
  109. SERVICE and FSERVICE are the CSF components that you use to apply your 
  110. ServicePak.  SERVICE runs under control of the OS/2 Presentation Manager 
  111. [Trademark of the IBM Corporation]  (PM), which provides a graphical user 
  112. interface (GUI) that will assist and prompt you during the application of your 
  113. ServicePak.  FSERVICE is command-oriented and does not use the graphical 
  114. environment provided by the OS/2 Presentation Manager. 
  115.  
  116. Note:  You should read the README files to determine what method of service is 
  117.        correct for your application of the ServicePak (SERVICE, FSERVICE, or 
  118.        both).  The README files are located on CSF Diskette 1. 
  119.  
  120. Service is applied only if the following criteria are met: 
  121.  
  122. o System edition, product identification, and versions match. 
  123.  
  124. o Modification level matches: c. 
  125.  
  126.    - A full ServicePak is identified by a modification level that is higher 
  127.      than the modification level existing on the system. 
  128.  
  129.    - A fix ServicePak has the same modification level as the one existing on 
  130.      the system. 
  131.  
  132. o SYSLEVEL matches: c. 
  133.  
  134.    - A full ServicePak is identified by a SYSLEVEL that is higher than the 
  135.      SYSLEVEL existing on the system. 
  136.  
  137.    - A fix ServicePak has the same SYSLEVEL as the one existing on the system. 
  138.  
  139. o FSERVICE c. 
  140.  
  141.    - Uses the default response file, or the response file created by SERVICE, 
  142.      but allows response file modification. 
  143.  
  144.  
  145. ΓòÉΓòÉΓòÉ 2.1. SERVICE ΓòÉΓòÉΓòÉ
  146.  
  147. SERVICE automatically evaluates your system to determine if FSERVICE is 
  148. required to apply the ServicePak.  If FSERVICE is required, you will be 
  149. notified by a system message.  Use the HELP facility to answer questions on 
  150. errors, window prompts, or CSF function.  In the event of an error, you are 
  151. prompted to open the Service Log files. 
  152.  
  153. Things to know before you begin this SERVICE: c. 
  154.  
  155. o SERVICE c. 
  156.  
  157.    - Automatically: c. 
  158.  
  159.       o Determines if the ServicePak can be applied 
  160.  
  161.       o What the serviceable products are 
  162.  
  163.       o What files are to be backed up 
  164.  
  165.       o If FSERVICE is required for this ServicePak application. 
  166.  
  167.       o Creates a response file to be used by FSERVICE. 
  168.  
  169.  
  170. ΓòÉΓòÉΓòÉ 2.1.1. Starting SERVICE ΓòÉΓòÉΓòÉ
  171.  
  172.  1. Open an OS/2 session. 
  173.  
  174.  2. Change the current drive to drive A. 
  175.  
  176.  3. Insert CSF Diskette 1 into drive A. 
  177.  
  178.  4. Type SERVICE at the command prompt, and press Enter. 
  179.  
  180.     The OS/2 Corrective Service Facility window appears. 
  181.  
  182.  5. Select OK. 
  183.  
  184.     The Serviceable Products window appears, which contains a list of products 
  185.     found on your system that are eligible for SERVICE.  All eligible products 
  186.     are initially selected and are highlighted. 
  187.  
  188.  6. Accept the highlighted products or modify the list (by removing the 
  189.     highlighting). 
  190.  
  191.  7. Select Service after you have made your selections. 
  192.  
  193.     The SERVICE window is displayed and contains a list of the products you 
  194.     selected.  The list is displayed in the Product field: 
  195.  
  196.  8. Enter the required ARCHIVE path in the ARCHIVE field. c. 
  197.  
  198.    o When applying SERVICE to your system the first time, the ARCHIVE path 
  199.      specification requested is mandatory.  The next time you want to apply 
  200.      service, the ARCHIVE path that was previously used is automatically 
  201.      assumed by CSF. 
  202.  
  203.    o If the product has previously been serviced, the ARCHIVE path cannot be 
  204.      modified. 
  205.  
  206.    o You are expected to provide space for an ARCHIVE.  The space can be on a 
  207.      LAN, a local or remote hard disk, or on a diskette. 
  208.  
  209.    o You can change the ARCHIVE path by using the REDIRECT facility of SERVICE 
  210.      or through the REDIRECT command line in the FSERVICE response file. 
  211.  
  212.    o If you are archiving to diskette, the path must be to the root of the 
  213.      target drive. 
  214.  
  215.  9. Enter the optional BACKUP fix path in the BACKUP field. c. 
  216.  
  217.    o BACKUP is optional. 
  218.  
  219.    o You are expected to provide space for a BACKUP on a local hard disk or on 
  220.      a diskette. 
  221.  
  222.    o Specifying a BACKUP path for a previously serviced product results in the 
  223.      deletion of the previous BACKUP, if one exists. 
  224.  
  225.    o The system files changed or the patches necessary to rebuild the previous 
  226.      version of the system are stored in a BACKUP directory until the SERVICE 
  227.      has been committed or the next ServicePak is applied. 
  228.  
  229.    o If BACKUP is not enabled during the last application of a ServicePak, 
  230.      BACKOUT can only be used to restore the ARCHIVE level. 
  231.  
  232.    o BACKUP cannot be performed onto a LAN drive. 
  233.  
  234.    o BACKUP and ARCHIVE directory paths must be different. 
  235.  
  236.    o BACKUP and ARCHIVE to diskette must be performed on different diskettes. 
  237.  
  238.    o Deletion of a BACKUP fix level is handled by the COMMIT function. 
  239.  
  240.    o When service is applied to your system, any previous BACKUP files are 
  241.      deleted.  BACKUP files are also deleted when a BACKOUT is performed. 
  242.  
  243.    o If you are backing up to diskette, the path must be to the root of the 
  244.      target drive. 
  245.  
  246. 10. Select OK to perform the SERVICE or select Cancel to return to the 
  247.     Serviceable Products window. 
  248.  
  249.     SERVICE is successfully applied when you see the message Corrective Service 
  250.     has been successfully applied. 
  251.  
  252. 11. When you are prompted by the CSF message Do you want to re-display the 
  253.     Product List?, do one of the following: c. 
  254.  
  255.    o Select NO to exit the Corrective Service Facility 
  256.  
  257.    o Select YES to view the refreshed Product List window. 
  258.  
  259.      Note:  You can use the Change Product List window to view the following 
  260.             SERVICE windows: c. 
  261.  
  262.       - Serviceable Products (Default Window) 
  263.  
  264.       - Backed up Products 
  265.  
  266.       - Archived Products 
  267.  
  268.       - Uncommitted Products 
  269.  
  270.  
  271. For detailed information about Service Windows, see Service Windows 
  272. Descriptions later in this section. 
  273.  
  274.  
  275. ΓòÉΓòÉΓòÉ 2.2. FSERVICE ΓòÉΓòÉΓòÉ
  276.  
  277. FSERVICE automatically evaluates your system.  FSERVICE runs from 
  278. initialization when using CSF Diskette 1.  Use the HELP facility to answer 
  279. questions on errors, window prompts, or CSF function.  In the event of an 
  280. error, you are prompted to open the Service Log files. 
  281.  
  282. Note:  You should read the README files to determine what method of service is 
  283.        correct for your application of the ServicePak (SERVICE, FSERVICE, or 
  284.        both).  FSERVICE is command-oriented and does not use the graphical 
  285.        environment provided by the OS/2 Presentation Manager.  The README files 
  286.        are located on CSF Diskette 1. 
  287.  
  288. Things to know before you begin this SERVICE: c. 
  289.  
  290. o FSERVICE c. 
  291.  
  292.    - Automatically: c. 
  293.  
  294.       o Determines if the ServicePak can be applied 
  295.  
  296.       o What the serviceable products are 
  297.  
  298.       o What files are to be backed up 
  299.  
  300.       o If FSERVICE is required for this ServicePak application. 
  301.  
  302.       o Creates a response file to be used by FSERVICE. 
  303.  
  304. You should modify your response files only if you need to control the 
  305. ServicePak application manually, otherwise it automatically services all 
  306. partitions.  See "Response File Syntax" for more information. 
  307.  
  308. To modify your response files: c. 
  309.  
  310.  1. Edit response files (to control the service application manually). c. 
  311.  
  312.    o RESPONSE.FIL samples are located on: c. 
  313.  
  314.       - CSF Diskette 2 if you have 3.5-inch diskettes. 
  315.  
  316.       - CSF Diskette 3 if you have 5.25-inch diskettes. 
  317.  
  318.  2. Shut down your system before starting FSERVICE. 
  319.  
  320.  
  321. ΓòÉΓòÉΓòÉ 2.2.1. Starting FSERVICE ΓòÉΓòÉΓòÉ
  322.  
  323. Use FSERVICE when: c. 
  324.  
  325.  1. Insert CSF Diskette 1 into drive A. 
  326.  
  327.  2. Restart the system to start FSERVICE. 
  328.  
  329.     FSERVICE runs automatically. 
  330.  
  331.  3. Follow the instructions on your screen. 
  332.  
  333.  
  334. ΓòÉΓòÉΓòÉ 2.3. Service Windows Descriptions ΓòÉΓòÉΓòÉ
  335.  
  336. o SERVICE (Start SERVICE from Serviceable Products window) 
  337.  
  338.   CSF determines if SERVICE can be applied, by a comparison of the version, 
  339.   ServicePak level, and other information in the CSF_PROD file in the 
  340.   ServicePak and the SYSLEVEL file on the system.  Once it is determined that 
  341.   service can be applied, CSF determines the files that need to be backed up 
  342.   (if BACKUP has been enabled) and the files that need to be archived.  Backups 
  343.   and archives are always kept separately.  If locked files are encountered, 
  344.   you will be prompted to insert Diskette 1, and restart your system.  FSERVICE 
  345.   will automatically be invoked. 
  346.  
  347.   Description of the Product, Archive, and Backup Level fields to perform your 
  348.   system SERVICE. 
  349.  
  350.    Product        This field lists the product name, level, and the path on 
  351.                   which the product is located.  If SERVICE has been applied, 
  352.                   then the SERVICE level is listed to the right of the ARCHIVE 
  353.                   level and is enclosed in parentheses. 
  354.  
  355.    Archive        Use this field to enter the required ARCHIVE path if the 
  356.                   product is being serviced for the first time. If the product 
  357.                   has been previously serviced, the ARCHIVE path cannot be 
  358.                   modified.  The ARCHIVE path can be altered only by using 
  359.                   REDIRECT. 
  360.  
  361.    Backup         Use this field to enter the BACKUP path for each product 
  362.                   listed. If the product is being serviced for the first time, 
  363.                   you are not able to enter a BACKUP path.  This is because the 
  364.                   ARCHIVE and BACKUP are the same thing at this point.  If the 
  365.                   product has previously been serviced, the BACKUP path is 
  366.                   optional. Specifying a backup path for a previously serviced 
  367.                   product results in the deletion of the previous BACKUP, if 
  368.                   one exists. 
  369.  
  370. o ARCHIVE (Access ARCHIVE from SERVICE window) c. 
  371.  
  372.    - When applying SERVICE to your system the first time, the ARCHIVE path 
  373.      specification requested is mandatory.  The next time you want to apply 
  374.      service, the ARCHIVE path that was previously used is automatically 
  375.      assumed by CSF. 
  376.  
  377.    - If the product has previously been serviced, the ARCHIVE path cannot be 
  378.      modified. 
  379.  
  380.    - You are expected to provide space for an ARCHIVE.  The space can be on a 
  381.      LAN, a local or remote hard disk, or on a diskette. 
  382.  
  383.    - You can change the ARCHIVE path by using the REDIRECT facility of SERVICE 
  384.      or through the REDIRECT command line in the FSERVICE response file. 
  385.  
  386.    - If you are archiving to diskette, the path must be to the root of the 
  387.      target drive. 
  388.  
  389. o BACKUP (Access BACKUP from SERVICE window) c. 
  390.  
  391.    - BACKUP is optional. 
  392.  
  393.    - You are expected to provide space for a BACKUP on a local hard disk or on 
  394.      a diskette. 
  395.  
  396.    - Specifying a BACKUP path for a previously serviced product results in the 
  397.      deletion of the previous BACKUP, if one exists. 
  398.  
  399.    - The system files changed or the patches necessary to rebuild the previous 
  400.      version of the system are stored in a BACKUP directory until the SERVICE 
  401.      has been committed or the next ServicePak is applied. 
  402.  
  403.    - If BACKUP is not enabled during the last application of a ServicePak, 
  404.      BACKOUT can only be used to restore the ARCHIVE level. 
  405.  
  406.    - BACKUP cannot be performed onto a LAN drive. 
  407.  
  408.    - BACKUP and ARCHIVE directory paths must be different. 
  409.  
  410.    - BACKUP and ARCHIVE to diskette are performed on different diskettes. 
  411.  
  412.    - Deletion of a BACKUP fix level is handled by the COMMIT function. 
  413.  
  414.    - When service is applied to your system, any previous BACKUP files are 
  415.      deleted.  BACKUP files are also deleted when a BACKOUT is performed. 
  416.  
  417.    - If you are backing up to diskette, the path must be to the root of the 
  418.      target drive. 
  419.  
  420. o BACKOUT (Access BACKOUT from Backed Up Products and Archived Products 
  421.   windows) 
  422.  
  423.   When you back out a ServicePak, you return to either the previous ServicePak 
  424.   level, if a BACKUP exists, or to the ARCHIVE level of the product. CSF 
  425.   locates the files in the ARCHIVE or BACKOUT directory and restores them from 
  426.   the appropriate media. 
  427.  
  428.   Description of the Products and the Target Level fields, to perform your 
  429.   system BACKOUT. 
  430.  
  431.    Products            This field lists all the selected products available for 
  432.                        BACKOUT. 
  433.  
  434.    Target Level        This field lists the target levels for each product. 
  435.                        The target level is the level to which you would back 
  436.                        out (previous BACKUP or ARCHIVE level). c. 
  437.  
  438.    - BACKOUT support is for only one level of SERVICE applied or to the ARCHIVE 
  439.      level of the product. 
  440.  
  441.    - When you are backing out to a previous fix, currently installed fix 
  442.      ServicePak files are replaced with BACKUP (fix) files. 
  443.  
  444.    - Files archived by the previous full ServicePak SERVICE application are not 
  445.      deleted when you back out to the previous fix. 
  446.  
  447.    - If BACKUP is not enabled during the last application of a ServicePak, then 
  448.      BACKOUT to the previous level is not permitted. 
  449.  
  450. o COMMIT (Access COMMIT from Uncommitted Products window) 
  451.  
  452.   In performing COMMIT, you are committing a product at its current level and 
  453.   removing the ability to BACKOUT to a previous fix level. The ARCHIVE is not 
  454.   affected unless you are committing a full ServicePak. You can BACKOUT to the 
  455.   ARCHIVE of the last committed full ServicePak until the next full ServicePak 
  456.   is committed. 
  457.  
  458.   Description of the Product, the Archive, and the Backup Level fields to 
  459.   perform your system COMMIT. 
  460.  
  461.    Product             This field lists all of the selected products available 
  462.                        to COMMIT. 
  463.  
  464.    Archive Level       This field lists the ARCHIVE level for each product. If 
  465.                        you are committing a full ServicePak, the reference to 
  466.                        this directory is removed. 
  467.  
  468.    Backup Level        This field lists the BACKUP level of each product.  All 
  469.                        backups are deleted after you COMMIT. 
  470.  
  471.    - When a full ServicePak (SERVICE application) is committed, all BACKUP 
  472.      files and SERVICE logs are deleted. A BACKOUT cannot be performed after 
  473.      this is done. 
  474.  
  475.    - When a full ServicePak is committed, the ARCHIVE directory is not deleted, 
  476.      but the reference to the ARCHIVE directory is deleted, and CSF no longer 
  477.      has knowledge of where the ARCHIVE resides. Archive directories must be 
  478.      deleted manually, because they can be used by multiple machines or product 
  479.      instances. 
  480.  
  481.    - After a fix ServicePak has been applied, if a COMMIT operation is 
  482.      performed, only the backup files are deleted, and any files archived by 
  483.      the application of the full ServicePak are not deleted, so that you can 
  484.      still back out to the ARCHIVE level if required. 
  485.  
  486.    - When a ServicePak has been applied to a product and not committed, you 
  487.      have the option to BACKOUT that application of SERVICE.  However, 
  488.      application of the next full ServicePak is not permitted until you COMMIT 
  489.      the current ServicePak. 
  490.  
  491. o REDIRECT (Access REDIRECT from Archived Products window) 
  492.  
  493.   Description of the Product, the Source Directory and the Target Directory 
  494.   fields to perform your system REDIRECT. 
  495.  
  496.    Product             This field lists the selected archived products. 
  497.  
  498.    Source Directory    This field lists source directories where the ARCHIVE 
  499.                        currently resides for each product. 
  500.  
  501.    Target Directory    Use this field to enter the desired target path that is 
  502.                        to reference your ARCHIVE directory.  You must enter a 
  503.                        new target directory for each product. 
  504.  
  505.    - Each selected product is listed, and you are able only to supply 
  506.      information pertaining to the new ARCHIVE path.  If the new ARCHIVE path 
  507.      is to a removable media drive, then the path is restricted to the root 
  508.      level of that drive.  There is no path restriction for fixed or remote 
  509.      media. 
  510.  
  511.    - When redirecting the ARCHIVE to diskette or removable media, CSF requires 
  512.      you to supply valid diskettes already containing a CSF-created ARCHIVE 
  513.      file. 
  514.  
  515.    - Because of media differences, an ARCHIVE on disk is different from one on 
  516.      diskette. 
  517.  
  518.    - Redirecting an ARCHIVE alters the reference to the location of your 
  519.      ARCHIVE directory. Using REDIRECT facilitates consolidation of ARCHIVE 
  520.      directories onto a network drive. 
  521.  
  522.       o CSF expects a valid ARCHIVE to exist at the new location. 
  523.  
  524.       o You can only redirect the ARCHIVE of a particular product to a new path 
  525.         if the ARCHIVE exists at the new path for the same system level for all 
  526.         files that were in the original ARCHIVE. 
  527.  
  528.       o File lists are compared and verified.  Failure of a match in either 
  529.         case results in an incomplete redirection of ARCHIVE paths. 
  530.  
  531.  
  532. ΓòÉΓòÉΓòÉ 2.4. Service Logs ΓòÉΓòÉΓòÉ
  533.  
  534. A Service log is built and updated for each installation of service on your 
  535. system.  The user-readable Summary Service Log (SERVICE.LOG) contains a 
  536. cumulative record of service applied to the system.  The CSF-Readable Service 
  537. Log (LOGF0000.XXX) was created to support the CSF utility program.  The Archive 
  538. Layout file (ARCHIVE.XXX) keeps track of ARCHIVE files.  All log files are 
  539. located in the same directory as the SYSLEVEL file that defines the product 
  540. instance.  CSF uses this logged information to help it decide what actions to 
  541. perform. 
  542.  
  543. Service Log Descriptions: 
  544.  
  545.      Warning: Do not delete the SERVICE.LOG files.  You will need this 
  546.      information if you need to call service. 
  547.  
  548.  o The Summary Service Log (SERVICE.LOG) lists: c. 
  549.  
  550.     - The identity and level of the product that was updated. 
  551.  
  552.     - The specific identity and level of the fix ServicePak that was installed. 
  553.  
  554.     - The date and time the fix ServicePak was installed. 
  555.  
  556.     - The type of CSF operation (for example, a fix ServicePak installation or 
  557.       a BACKOUT to a previous fix level). 
  558.  
  559.     - The root directories for the ARCHIVE and BACKUP directory paths used in 
  560.       this CSF operation. 
  561.  
  562.     - If backups are performed to diskette, identification information 
  563.       concerning those diskettes (for example, volume labels and exterior label 
  564.       strings). 
  565.  
  566.     - The files that have been copied to the disk.  Copy operations are logged 
  567.       with lines that are labelled "Copying" and include the full path name of 
  568.       the file on the disk. 
  569.  
  570.     - The files that have been updated on the disk.  Updates are considered to 
  571.       be either full file replacements or file patches.  Update operations are 
  572.       logged with lines that are labelled "Updating" and include the full path 
  573.       name of the target file on the disk. 
  574.  
  575.     - The files that have been archived to the BACKUP directory path.  Archival 
  576.       operations are logged with lines that are labelled "Archiving" and 
  577.       include the full path name of the file in the BACKUP path.  In the event 
  578.       that the ARCHIVE version of the file is already present, then there will 
  579.       be no archival copy performed and no archival entry will be logged. 
  580.  
  581.     - The files that have been backed up to the BACKUP level BACKUP path. 
  582.       These files were copied from the target product directory path before 
  583.       they were replaced with newer file versions from the fix ServicePak. 
  584.       BACKUP operations are logged with lines that are labelled "Backing" and 
  585.       include the full path name of the file in the BACKUP level backup path. 
  586.  
  587.     - If BACKUP is performed to diskette, identification information concerning 
  588.       those diskettes (for example, volume labels and exterior label strings). 
  589.       The identification information for a particular diskette immediately 
  590.       precedes the archival and backup log entries that were made to that 
  591.       diskette. 
  592.  
  593.  o CSF-Readable LOGF0000.XXX (xxx=Product Code) 
  594.  
  595.      Warning: LOGF0000.XXX must not be modified or deleted or your system will 
  596.      be rendered unserviceable. 
  597.  
  598.  In order to provide the BACKUP/BACKOUT facility mentioned above, CSF maintains 
  599.  a machine-readable record of the operations performed during the application 
  600.  of all SERVICE.  This record is maintained in a log file called LOGF0000.XXX 
  601.  in the directory in which the SYSLEVEL file was detected in the system.  This 
  602.  is an internal log file, in binary format. 
  603.  
  604.  o ARCHIVE Layout file  ARCHIVE_.XXX (xxx=Product Code) 
  605.  
  606.      Warning: ARCHIVE_.XXX must not be modified or deleted or your system will 
  607.      be rendered unserviceable. 
  608.  
  609.  o CSF also keeps track of the ARCHIVE directory and files in an Archive Layout 
  610.    File. This file is located either in the ARCHIVE path on hard disk or on the 
  611.    first ARCHIVE diskette. 
  612.  
  613.  
  614. ΓòÉΓòÉΓòÉ 2.5. Response File Syntax ΓòÉΓòÉΓòÉ
  615.  
  616. This section provides a detailed look at response file syntax primarily needed 
  617. by the FSERVICE user.  Functional examples are included on: c. 
  618.  
  619.  CSF Diskette 2 if you have 3.5-inch diskettes. 
  620.  
  621.  CSF Diskette 3 if you have 5.25-inch diskettes. 
  622.  
  623.  The default response file is provided on CSF Diskettte 2. 
  624.  
  625.  
  626. ΓòÉΓòÉΓòÉ 2.5.1. General Tags ΓòÉΓòÉΓòÉ
  627.  
  628. General tags must appear before any keyword tags in the response file or they 
  629. will be ignored.  These general tags can appear in any order at the front of 
  630. the response file but must occur only once.  FSERVICE will fail if these tags 
  631. appear following any other keyword tags. 
  632.  
  633.  :LOGFILE  drive\path\filename 
  634.  
  635.            This specifies the drive, directory, and log file name if a log file 
  636.            is desired which differs from the default name of the user readable 
  637.            log.  This file will be created if it does not exist and will be 
  638.            appended if it does exist. 
  639.  
  640.  :FLAGS    [flag1] [flag2] [flag3] 
  641.  
  642.            This optional tag specifies flags that apply only to the :SERVICE 
  643.            tag.  If specified in a response file that does not have the 
  644.            :SERVICE tag, they will be ignored.  The flags include: 
  645.  
  646.     REPLACE_NEWER 
  647.                       Replace files that have dates later than the 
  648.                       corresponding file on the ServicePak.  If this is not 
  649.                       specified, the user is prompted if any newer files are 
  650.                       found. 
  651.  
  652.     REPLACE_PROTECTED 
  653.                       Replace files that are read-only, hidden, or system 
  654.                       files.  If this is not specified, the user is prompted if 
  655.                       any protected files are found. 
  656.  
  657.     EXIT_WHEN_DONE 
  658.                       This tells FSERVICE to stop if any errors are encountered 
  659.                       and to report the errors. 
  660.  
  661.  :SOURCE   drive\path 
  662.  
  663.            This specifies the drive, and directory where the ServicePak is to 
  664.            be found.  It is mostly intended for use with the CID installations 
  665.            where the ServicePak is from a LAN drive.  It is required for 
  666.            response files that contain a :SERVICE tag and if it is found 
  667.            missing for :SERVICE, then FSERVICE will fail.  If it is encountered 
  668.            in a response file that does not contain the :SERVICE tag, it is 
  669.            ignored. 
  670.  
  671.  :TARGET   ARCHIVE Γöé BACKUP 
  672.  
  673.            This general tag applies only to response files that contain the 
  674.            :BACKOUT keyword.  The tag has one argument, which must be either 
  675.            "ARCHIVE" or "BACKUP." This limits the BACKOUT function to back out 
  676.            to the archive level or the backup level.  It is specified only 
  677.            once, and any :BACKOUT keywords encountered in a response file will 
  678.            use the one :TARGET tag to qualify all backouts being done.  It must 
  679.            exist prior to any :BACKOUT keyword or FSERVICE will fail.  If it is 
  680.            encountered in a response file that does not contain the :BACKOUT 
  681.            tag, it is ignored. 
  682.  
  683.  * 
  684.  
  685.            This tag specifies that a comment follows. 
  686.  
  687.  
  688. ΓòÉΓòÉΓòÉ 2.5.2. Keyword Tags ΓòÉΓòÉΓòÉ
  689.  
  690. Any one of the keyword tags can appear many times in a given response file. 
  691. Each occurrence of a keyword tag marks the start of another serviceable 
  692. product. Each occurrence of a serviceable product is referred to as a product 
  693. instance.  This means that the same product could be installed multiple times 
  694. or might be installed in multiple partitions.  The action that is to be 
  695. performed for each installation (product instance) is unique and is determined 
  696. by the response file syntax and keyword choice.  Mixing or repeating keywords 
  697. for a specific product instance is not permitted and will cause the FSERVICE 
  698. program to fail. 
  699.  
  700.  :SERVICE 
  701.            This is used to apply service to a product instance on the system. 
  702.            It uses the ServicePak information from the :SOURCE tag previously 
  703.            specified. :SERVICE has two position-dependent parameter tags that 
  704.            must follow it, and one that is optional.  Each tag must be on a 
  705.            line by itself.  They are: 
  706.  
  707.     :SYSLEVEL drive\path 
  708.  
  709.               This is the drive, and directory of the SYSLEVEL file for a given 
  710.               product instance and must follow the :SERVICE keyword in the 
  711.               response file. 
  712.  
  713.     :ARCHIVE  drive\path 
  714.  
  715.               This is the drive, and directory of the ARCHIVE for a given 
  716.               product instance and must follow the :SERVICE keyword in the 
  717.               response file. 
  718.  
  719.     :BACKUP   drive\path 
  720.  
  721.               This is the drive, and directory of the BACKUP for a given 
  722.               product instance and can optionally follow the :SERVICE keyword 
  723.               in the response file. 
  724.  
  725.  :BACKOUT 
  726.            This is used to back out a product instance on the system to the 
  727.            level specified on the :TARGET tag.  The TARGET tag must have been 
  728.            found before any back out can be done. :BACKOUT has one 
  729.            position-dependent parameter tag, which must follow it on a line by 
  730.            itself. It is: 
  731.  
  732.     :SYSLEVEL drive\path\filename 
  733.  
  734.               This is the drive, directory, syslevel filename of the SYSLEVEL 
  735.               file for a given product instance and must follow the :BACKOUT 
  736.               keyword in the response file. 
  737.  
  738.  :REDIRECT 
  739.            This is used to redirect an archive of a product instance on the 
  740.            system to the location of another existing archive. :REDIRECT has 
  741.            two position-dependent parameter tags that must follow it, each of 
  742.            which must be on a line by itself.  They are: 
  743.  
  744.     :SYSLEVEL drive\path\filename 
  745.  
  746.               This is the drive, directory, syslevel filename of the SYSLEVEL 
  747.               file for a given product instance and must follow the :REDIRECT 
  748.               keyword in the response file. 
  749.  
  750.     :ARCHIVE  drive\path 
  751.  
  752.               This is the new ARCHIVE drive, and directory for a given product 
  753.               instance and must follow the :REDIRECT keyword in the response 
  754.               file. :REDIRECT and :SYSLEVEL. 
  755.  
  756.  :COMMIT 
  757.            This is used to COMMIT a product instance on the system. :COMMIT has 
  758.            one position-dependent parameter tag, which must follow it on a line 
  759.            by itself. It is: 
  760.  
  761.     :SYSLEVEL drive\path\filename 
  762.  
  763.               This is the drive, directory, and syslevel filename of the 
  764.               SYSLEVEL file for a given product instance and must follow the 
  765.               :COMMIT keyword in the response file. 
  766.  
  767.  
  768. ΓòÉΓòÉΓòÉ 3. Notices ΓòÉΓòÉΓòÉ
  769.  
  770. References in this publication to IBM products, programs, or services do not 
  771. imply that IBM intends to make these available in all countries in which IBM 
  772. operates. Any reference to an IBM product, program or service is not intended 
  773. to state or imply that only IBM's product, program, or service may be used. Any 
  774. functionally equivalent product, program, or service that does not infringe any 
  775. of IBM's intellectual property rights or other legally protectable rights may 
  776. be used instead of the IBM product, program, or service. Evaluation and 
  777. verification of operation in conjunction with other products, programs, or 
  778. services, except those expressly designated by IBM, are the user's 
  779. responsibility. 
  780.  
  781. IBM may have patents or pending patent applications covering subject matter in 
  782. this document. The furnishing of this document does not give you any license to 
  783. these patents. You can send license inquiries, in writing, to the IBM Director 
  784. of Licensing, IBM Corporation, 208 Harbor Drive, Stamford, Connecticut 
  785. 06904-2501, U.S.A. 
  786.  
  787. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESSED OR IMPLIED, INCLUDING WITHOUT 
  788. LIMITATION, WARRANTIES OF FITNESS AND MERCHANTABILITY WITH RESPECT TO THE 
  789. INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO 
  790. LICENSES TO ANY RELATED PATENTS OR COPYRIGHTS. 
  791.  
  792.  
  793. ΓòÉΓòÉΓòÉ 3.1. Trademarks ΓòÉΓòÉΓòÉ
  794.  
  795. The following terms, denoted by an asterisk ([*]) in this publication, are 
  796. trademarks of the IBM Corporation in the United States or other countries. 
  797.  
  798. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  799. Γöé OS/2                                   Γöé Presentation Manager                  Γöé
  800. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  801.