═══ 1. Corrective Service Facility ═══ OS/2 Corrective Service Facility (CSF) is a utility program that applies corrections (service) to the OS/2 operating system and other OS/2 products. CSF updates the files of the products you select with the corresponding product files on a corrective service diskette (CSD) package or in a fix package. The main window contains a list of products found on the system that are eligible for service. All eligible products are initially selected and are highlighted in the list. If you do not want to apply service to one or more products listed, select those products that you do not want to service. The products you select will no longer be highlighted and service will not be applied to them. When only the products to which you are applying service are highlighted, select Service to start the service process. To change to a list of product archives, backups, or a list uncommitted products, select Change Product List. ═══ 2. Archive ═══ An archive is a copy of your product files as they existed before you applied service to the product. With an archive you can restore a product to its earlier state at any time during service by using the Backed Up Products window or the Archived Products window. Corrective Service Facility (CSF) saves an archive of your product files when you: o Apply service to your product for the first time o Apply service to your product for the first time after committing the product with a service package applied. CSF saves only one archive per product, at the time when service is first applied to the product. You can save copies of later product levels by creating a backup of your product files each time you apply a new fix package. ═══ 3. Backup ═══ A backup is a copy of product files to which service has been applied at least once. You request a backup by specifying a path in the Backup field of the Service window. Corrective Service Facility saves a copy of your current product files before applying the next level of service to the product. The backup enables you to restore your product to its state before the most recent level of service was applied. Creating a backup is optional, but be aware that if you do not create a backup when you apply service, you cannot use an older backup to restore your product. You cannot restore your product across multiple service levels. However, you can always restore your product to the archive level. You can have only one backup of a product at a time. If a backup already exists when you request a backup, the older backup is deleted. You cannot create a backup before an archive has been saved. ═══ 4. Uncommitted Product ═══ A product is uncommitted when it can be restored to its level before the latest service was applied by using an archive or a backup. Committing a product when a service package has been applied to it removes the reference to the archive and frees the disk space used by the backup, if one exists. Committing a product when a fix package has been applied to it frees the disk space used by the backup, if one exists, but does not affect the archive. │ │ │Fix package │Service │ │package ────────────┼────────────┼──────────── Archive │unaffected │reference │ │removed ────────────┼────────────┼──────────── Backup │deleted │deleted │ │ You can commit a product when you are satisfied with it by using the Commit Service window. ═══ 5. Serviceable Products ═══ A product is eligible for service (serviceable) when: o The product is installed on your system o The product updates are present in the fix package or service package o The SYSLEVEL of the product on your system is compatible with the SYSLEVEL of the product on the fix package or service package ═══ 6. Application in Use ═══ Corrective Service Facility has encountered a file that is in use and cannot be updated. This error was probably caused by opening a file or starting a program after the service process has begun. Close the indicated file or program and restart Service. You can close the file or program from another OS/2 window, or by using the Window List on the Desktop. To display the Window List, press Ctrl+Esc, or press both mouse buttons simultaneously. If you are unable to close the application, shut down your system. Place the first Corrective Service Diskette in Drive A and restart your system using Ctrl+Alt+Del. ═══ 7. Updating Files ═══ The Updating Files window shows the path of the file being processed and the approximate percentage of the service that is complete. When you are applying service to the product, the Updating Files window displays the percentage of files to which service has been applied. When you are backing out of a service package or fix package change, the Updating Files window displays the percentage of files that have been restored to either the archive level or the backup level. ═══ 8. Insert Diskette ═══ Insert the indicated diskette into the requested diskette drive. Then, press Enter or select OK to continue. If there is no diskette in the requested drive or the wrong diskette is in the requested drive when you select OK, a warning beep will sound and you will not be able to continue until the correct diskette is inserted. ═══ 9. Service Permission ═══ A read-only, hidden, or system file has been encountered that should be serviced. If you do not apply service to this file, your system will not be at the proper corrective service level. Down-level files can cause system problems and might prevent your system from restarting. ═══ 10. Service Permission Verification ═══ Select OK to prevent the indicated file from being serviced. You should select OK only if there is a known reason not to service the file. Select Cancel to service the indicated file. ═══ 11. Newer File Service Permission ═══ The file indicated for service has a more recent date than the file on the corrective service diskettes. Select OK to service the file. Select Cancel only if there is a known reason for not applying service to the file. If you select Cancel, this file will not be at the same corrective service level as the other files for this product. Down-level files can cause system problems and prevent your system from restarting. ═══ 12. Corrective Service Facility Logfile ═══ The logfile is a cumulative service history. You may browse the file. The logfile contains information about the products that are being updated. The end of the file contains the most recent actions and might contain error messages. Select Cancel to return to the error window. ═══ 13. Corrective Service Facility Error ═══ An error has occurred that prevents the Corrective Service Facility from continuing. Select Display Logfile to view the service history. Depending on the error, an Exit button might be displayed. If this button is displayed, you can use it to exit the service process. ═══ 14. Corrective Service Facility Error ═══ An error has occurred that prevents the Corrective Service Facility from continuing. Correct the problem and select Retry. Depending on the error, an Exit button might be displayed. If this button is displayed, you can use it to exit the service process. ═══ 15. Corrective Service Facility Error ═══ An error has occurred that prevents the Corrective Service Facility from continuing. Correct the problem and select Retry, or select Cancel to end the indicated operation. Depending on the error, an Exit button might be displayed. If this button is displayed, you can use it to exit the service process. ═══ 16. Corrective Service Facility Error ═══ Select Yes if you wish to perform the specified operation. Otherwise, select No. ═══ 17. Wait ═══ The Wait window is displayed while lengthy operations are being performed. The window will be removed when the operation is complete. ═══ 18. Access Control List Protected File ═══ The Corrective Service program has encountered an Access Control List (ACL)-protected file that cannot be updated. Exit the Corrective Service Facility, and contact your LAN administrator for more information. The Corrective Service Facility cannot update your system until the ACL-protected file has been released. ═══ 19. Checksum Error Window ═══ The Corrective Service Facility found a file that is not at the expected corrective service level. To apply this service package, all files must be at the prerequisite level. Ensure that your system is at the prerequisite level before applying service. You must replace this file with the original file provided on the installation diskettes for the product. Select Exit until you have exited from CSF. Correct the file before you attempt to start CSF again. ═══ 20. Service Window ═══ This window displays the list of products that you selected, and allows you to enter a path for an archive (if none exists) or a backup. Enter the required information and select OK to perform the service, or Cancel to return to the previous window. After you select OK, you can no longer cancel the service being applied. For a detailed explanation of each field, select from the list below: o Product field o Archive field o Backup field ═══ Product Field ═══ The Product field lists the name and level of each product you selected, in the following format: product name-service level(base level)-SYSLEVEL path This field is for viewing purposes only. product name The name of the selected product. service level The level of service, which reflects the application of one or more fix packages since the product was last committed. If no fix package has been applied to the product since the product was last committed, this field is omitted. base level The last committed level of the product. The base level might be the product level as originally installed, or the product level committed after a service package was applied. Committing a product after a service package has been applied to it always results in a new base level. SYSLEVEL path The path to the product SYSLEVEL file. This file contains information about the product, such as the current version of the product and any optional components installed. ═══ Archive Field ═══ Use the Archive field to enter the path and directory of the archive for each product listed in the Product field. The directory can be located on a diskette, a local drive, or a network drive. The archive path is required if this is the first time that service is being applied to the product. If service has been applied to the product previously, the field will be protected and you will not be able to enter the path. To change the archive path after it is protected, use either the Redirect Service window or the REDIRECT command in the FSERVICE response file. ═══ Backup Field ═══ Use the Backup field to enter the path and directory of the backup for each product listed in the Product field. The directory can be located on either a local drive or diskette, but cannot be on a network drive. The backup path must be a to a directory that does not exist (the Corrective Service Facility will create the directory) or to an empty directory. A backup cannot share an existing directory. If both the backup and archive directories are located on a diskette, they must be on different diskettes. This field is protected if this is the first time that service is being applied to the product, and you will not be able to enter the path. If service has been applied to the product previously, the field is optional. ═══ 21. Back Out Service Window ═══ Use this window to restore a product to a previous fix-level (backup) or the last base-level (archive) of the product. Products This field lists all the selected products that can be restored to a previous fix level. This field can only be viewed. Target Level This field lists the target levels for each product. The target level is the level to which you can restore the product. The product can be restored to either the backup level or the archive level. This field can only be viewed. Select OK to perform the back out, or Cancel to return. ═══ 22. Commit Service Window ═══ Use this window to free the disk space used by the backup directory. Commit a product when you are satisfied with the level of service applied to the product and no longer need the ability to restore the product to its previous level. Committing a product when a service package has been applied to it removes the reference to the product's archive and frees the disk space used by the backup, if one exists. Committing a product when a fix package has been applied to it frees the disk space used by the backup, but does not affect the archive. Product This field lists all the selected products to be committed. This field can only be viewed. Archive Level This field lists the archive level for each product. The reference to this directory is removed after you commit the product with a service package applied, and you will not be able to restore the product to the archive level. The archive is not affected by committing a product with a fix package applied. This field can only be viewed. Backup Level This field lists the backup level of each product. The backup for a product is deleted after you commit the product with a fix package or a service package applied. This field can only be viewed. Select OK to commit the products, or Cancel to return. ═══ 23. Redirect Service Window ═══ Use this window to use an archive on a path other than the path displayed in the Source Directory field. You can copy the archive to a new location, such as a network drive with more storage available. The Redirect Service window causes Corrective Service Facility to reference the new location; it does not copy the archive. To reference a new archive location: 1. Create a directory on the new archive path. 2. Use the XCOPY command to copy all of the existing archive files to the new directory. 3. Enter the new path in the Target Directory field. 4. Select OK to reference the archive in the new location. Product This field displays the products that you selected from the list of products with archives. You can only view this field. Source Directory This field lists the archive directories of each selected product. You can only view this field. Target Directory Use this field to enter the new archive path. You must enter a new path for each product. The system level and files in the archive at the new location must match those of the archive at the old location. Select OK to redirect, or Cancel to return. ═══ 24. Change Product List Window ═══ Select the type of product list that you want to display. The system will be searched for products that meet the required criteria. If a product list does not exist, it will be grayed, which indicates it is unavailable for viewing. Select OK to continue, or Cancel to return. Related information o Archive o Backup o Uncommitted o Serviceable ═══ 25. Directories or Products Not Selected ═══ You must select at least one product to start service. If there are no products listed, service cannot be initiated. Select a product from the Products list in the main window. ═══ 26. Service Complete ═══ Service completed successfully. Select OK to end the Corrective Service Facility. ═══ 27. No Serviceable Products ═══ The products on your system do not match those on the corrective service diskettes. Matching products might not be found if the corrective service diskettes are at a service level lower than the base level of the system. Use the SYSLEVEL program to view the information about the products on your system. ═══ 28. Exit Corrective Service Facility ═══ Select OK to exit from the Corrective Service Facility. ═══ 29. Exit Program Failure ═══ The specified exit program failed. The Corrective Service Facility will continue when you select OK. ═══ 30. Key Assignments ═══ From the OS/2 Setup and Installation window, you can press F3 to display a command prompt. For more information on keys, select Key assignments below. Related Information: Key assignments ═══ 31. Uncommitted Products ═══ A list of products that you can commit is displayed. Select from this list the products you want to commit. You can commit more than one product at a time. Commit a product when you are satisfied with it at its current level. Committing a product frees the disk space used by the backup, and removes your ability to restore the product to the backup level. If you commit a product that has a service package applied to it, the reference to the archive is also deleted, and you cannot restore the product to the archive level. After selecting the products you want, select Commit to perform the action. To change to a list of products that are archived, backed up, or eligible for service, select Change Product List. Select Cancel to return to the previous window. ═══ 32. Archived Products ═══ A list of products that have archives is displayed. Select from this list the products you want to restore to an earlier level (back out) or redirect to an archive at a different location. Back out Select Back out to restore the product to an earlier state before service was applied. You can view the product and target level (archive or backup) to which the product will be restored. Redirect Select Redirect to change the archive location. You can view the product and the location of the current archive, and specify the new archive location. To change to a list of products that have backups, are uncommitted, or are eligible for service, select Change Product List. Select Cancel to return to the previous window. ═══ 33. Backed Up Products ═══ A list of products that have a backup is displayed. Select from this list the products you want to restore to their backup levels. Back out Select Back out to view the product and target level to which you would back out. To change to a list of products that are archived, uncommitted, or eligible for service, select Change Product List. Select Cancel to return to the previous window. ═══ 34. Automatically Commit Products ═══ A list of products that are uncommitted is displayed. You must commit these products before you can apply service to them. You can only view the product list. Select Yes to commit the products and automatically generate a new archive for them. Select No to return to the Service window. ═══ 35. Select Source Drive ═══ Use this window to select the drive from which you will apply service. Choose a drive from the list displayed. The default drive is A. Select OK to use the selected drive to apply service. Select Cancel to cancel service. ═══ 36. Service Interruption ═══ A service interruption damaged one or more system files. Select Continue to allow Corrective Service Facility to continue applying service from the point when the interruption occurred. Select Exit to exit CSF at this time. When you restart the service process at a later time, you will return to this screen. ═══ 37. Locked Files Encountered ═══ The Corrective Service Facility (CSF) has determined that the listed files are locked. Service can continue; however, you must restart the system before applying additional service or using the files. Depending on the error, a Retry button might be displayed. If this button is displayed, you can unlock the files by closing the programs, and select Retry to continue applying service. Select Continue to allow CSF to process the locked files at a later time. Select Reboot to exit from CSF and bypass processing the locked files. You will be prompted to shut down and restart your system. Select Cancel to stop applying service. ═══ 38. Space Required for Locked Files Processing ═══ The Corrective Service Facility (CSF) has determined that the listed files are locked and sufficient space is not available for CSF to process the files. Depending on the error, a Retry button might be displayed. If this button is displayed, you can either: o Unlock the files by closing the applications, and select Retry to continue applying service. o Free the required amount of contiguous disk space on a single drive, and select Retry to continue applying service. Select Reboot to exit CSF and bypass processing the locked files. You will be prompted to shut down and restart your system. Select Cancel to stop applying service. ═══ 39. Insufficient Space for Service ═══ The Corrective Service Facility (CSF) has determined that the listed files are locked, and sufficient space is not available on the listed drives for CSF to process the files. Depending on the error, a Retry button might be displayed. If this button is displayed, you can either: o Unlock the files by closing the applications, and select Retry to continue applying service. o Free disk space on the drives indicated, and select Retry to continue applying service. Select Reboot to exit CSF and bypass processing the locked files. You will be prompted to shut down and restart your system. Select Cancel to stop applying service. ═══ 40. Unprocessed Files ═══ The Corrective Service Facility (CSF) completed successfully, but product files that were locked during service remain unprocessed. Complete the service for these files by shutting down the system and restarting it. You can then apply additional service or use the product. Select Display Logfile to display the service history. The logfile contains a list of files for which service was deferred. Select Exit to exit CSF.