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.DOC < prev    next >
Text File  |  1994-05-16  |  41KB  |  1,135 lines

  1.  
  2.       USING THE CORRECTIVE SERVICE FACILITY
  3.  
  4.  
  5. Contents
  6.  
  7.    CORRECTIVE SERVICE FACILITY (CSF) OVERVIEW   1
  8.  
  9.    USING THE CORRECTIVE SERVICE FACILITY   1
  10.    SERVICE   1
  11.      Starting SERVICE   1
  12.    FSERVICE   1
  13.      Starting FSERVICE   1
  14.    Service Windows Descriptions   1
  15.    Service Logs   1
  16.    Response File Syntax   1
  17.      General Tags   1
  18.      Keyword Tags   1
  19.  
  20.    NOTICES   1
  21.    Trademarks   1
  22.  
  23.  
  24. Corrective Service Facility (CSF) Overview
  25.  
  26.    CSF is a utility program that is used to apply
  27.    service updates to the OS/2* operating system
  28.    and to OS/2-based subsystems and applications.
  29.    In addition, CSF installs service updates in
  30.    such a manner that the updates can be tracked
  31.    and, if necessary, backed out.
  32.  
  33.    CSF supports two classes of service update
  34.    packages (ServicePaks):
  35.  
  36.    FULL SERVICEPAK  The full ServicePak SYSLEVEL
  37.                     is always higher than the
  38.                     SYSLEVEL that is being
  39.                     refreshed, and will alter the
  40.                     SYSLEVEL to the level of
  41.                     service being applied.
  42.  
  43.    FIX SERVICEPAK   The fix ServicePak SYSLEVEL is
  44.                     always increasing for fixes
  45.                     within a given SYSLEVEL, but
  46.                     will not change the existing
  47.                     SYSLEVEL.
  48.  
  49.    The CSF utility program does the following:
  50.  
  51.    o   Provides SERVICE and FSERVICE (CSF
  52.        components) for ServicePak application.
  53.  
  54.    o   Supports the following function for SERVICE
  55.        and FSERVICE for all ServicePaks:
  56.  
  57.        -   ARCHIVE
  58.        -   BACKUP
  59.        -   BACKOUT
  60.            --  BACKOUT to ARCHIVE
  61.            --  BACKOUT to BACKUP
  62.        -   COMMIT
  63.  
  64.            COMMIT provides the following:
  65.            --  DELETE ARCHIVE (references) and
  66.                BACKUP files (full ServicePak)
  67.            --  DELETE BACKUP files (fix
  68.                ServicePak)
  69.            --  REDIRECT ARCHIVE
  70.  
  71.                REDIRECT must be to another
  72.                existing ARCHIVE location.
  73.                REDIRECT does not copy or move
  74.                ARCHIVE files.
  75.  
  76.    o   Provides two levels of BACKUP:
  77.  
  78.        -   ARCHIVE level:
  79.            --  Original product version
  80.                (installed)
  81.            --  Original product current-version
  82.                (installed)
  83.            --  Full ServicePak (committed)
  84.        -   BACKUP level:
  85.            --  Original product version
  86.                (installed)
  87.            --  Original product current-version
  88.                (installed)
  89.            --  Fix ServicePak (previous fix level)
  90.  
  91.    o   Supports ARCHIVE and BACKUP on a product
  92.        instance basis.  If multiple copies of a
  93.        product exist on the same drive, archiving
  94.        and backup are performed for each instance
  95.        of the product installed.
  96.  
  97.        -   Supports file archives saved on
  98.            diskette and on local and remote hard
  99.            disks.
  100.        -   Supports file backups saved to diskette
  101.            or a local hard disk.
  102.  
  103.    o   Supports ARCHIVE sharing among multiple
  104.        matching product instances.  This is a
  105.        valuable benefit to users who can share an
  106.        ARCHIVE on a LAN server, thus saving disk
  107.        space on numerous local drives.
  108.  
  109.    o   Supports packed file and patch file formats
  110.        in a single ServicePak.  ARCHIVE versions
  111.        of full ServicePak files are always saved
  112.        as whole files.  BACKUP versions of fix
  113.        ServicePak files are saved either as whole
  114.        files or as patch files.  Patch files
  115.        contained within a fix package are built
  116.        relative to the most recent version of the
  117.        product.  This means that patch files are
  118.        built to be applied on top of full
  119.        ServicePaks, original, or current product
  120.        versions.
  121.  
  122.    o   Supports BACKOUT of a fix ServicePak
  123.        version, provided that the BACKOUT is
  124.        performed before the next fix or full
  125.        ServicePak version is applied.
  126.  
  127.        Backing out of a full ServicePak restores
  128.        your system to one of two possible states:
  129.  
  130.        -   If BACKUP was made during the
  131.            application of the full ServicePak,
  132.            then you can restore your system to the
  133.            previous level BACKUP.
  134.        -   If no BACKUP was made, then you can
  135.            restore your system to the previous
  136.            ARCHIVE level only.
  137.  
  138.    o   Generates service log files and an ARCHIVE
  139.        layout file, which contain updated system
  140.        and product information.  CSF uses this
  141.        information when applying SERVICE.
  142.  
  143.    o   Supports the application of service to a
  144.        specific SYSLEVEL of the OS/2 operating
  145.        system, subsystems, or products.
  146.  
  147.  
  148. Using the Corrective Service Facility
  149.  
  150.    SERVICE and FSERVICE are the CSF components
  151.    that you use to apply your ServicePak.  SERVICE
  152.    runs under control of the OS/2 Presentation
  153.    Manager(*)  (PM), which provides a graphical
  154.    user interface (GUI) that will assist and
  155.    prompt you during the application of your
  156.    ServicePak.  FSERVICE is command-oriented and
  157.    does not use the graphical environment provided
  158.    by the OS/2 Presentation Manager.
  159.  
  160.    NOTE:  You should read the README files to
  161.           determine what method of service is
  162.           correct for your application of the
  163.           ServicePak (SERVICE, FSERVICE, or both).
  164.           The README files are located on CSF
  165.                                           ___
  166.           Diskette 1.
  167.           __________
  168.  
  169.    Service is applied only if the following
  170.    criteria are met:
  171.  
  172.    o   System edition, product identification, and
  173.        versions match.
  174.  
  175.    o   Modification level matches:
  176.  
  177.        -   A full ServicePak is identified by a
  178.            modification level that is higher than
  179.            the modification level existing on the
  180.            system.
  181.        -   A fix ServicePak has the same
  182.            modification level as the one existing
  183.            on the system.
  184.  
  185.    o   SYSLEVEL matches:
  186.  
  187.        -   A full ServicePak is identified by a
  188.            SYSLEVEL that is higher than the
  189.            SYSLEVEL existing on the system.
  190.        -   A fix ServicePak has the same SYSLEVEL
  191.            as the one existing on the system.
  192.  
  193.    o   FSERVICE
  194.  
  195.        -   Uses the default response file, or the
  196.            response file created by SERVICE, but
  197.            allows response file modification.
  198.  
  199.  
  200. SERVICE
  201. _______
  202.  
  203.    SERVICE automatically evaluates your system to
  204.    determine if FSERVICE is required to apply the
  205.    ServicePak.  If FSERVICE is required, you will
  206.    be notified by a system message.  Use the HELP
  207.    facility to answer questions on errors, window
  208.    prompts, or CSF function.  In the event of an
  209.    error, you are prompted to open the Service Log
  210.    files.
  211.  
  212.    Things to know before you begin this SERVICE:
  213.  
  214.    o   SERVICE
  215.        -   Automatically:
  216.            --  Determines if the ServicePak can be
  217.                applied
  218.            --  What the serviceable products are
  219.            --  What files are to be backed up
  220.            --  If FSERVICE is required for this
  221.                ServicePak application.
  222.            --  Creates a response file to be used
  223.                by FSERVICE.
  224.  
  225.  
  226. STARTING SERVICE
  227.  
  228.    1.  Open an OS/2 session.
  229.  
  230.    2.  Change the current drive to drive A.
  231.  
  232.    3.  Insert CSF Diskette 1 into drive A.
  233.               ______________
  234.  
  235.    4.  Type SERVICE at the command prompt, and
  236.        press Enter.
  237.  
  238.        The OS/2 Corrective Service Facility window
  239.        appears.
  240.  
  241.    5.  Select OK.
  242.  
  243.        The Serviceable Products window appears,
  244.        which contains a list of products found on
  245.        your system that are eligible for SERVICE.
  246.        All eligible products are initially
  247.        selected and are highlighted.
  248.  
  249.    6.  Accept the highlighted products or modify
  250.        the list (by removing the highlighting).
  251.  
  252.    7.  Select SERVICE after you have made your
  253.        selections.
  254.  
  255.        The SERVICE window is displayed and
  256.        contains a list of the products you
  257.        selected.  The list is displayed in the
  258.        PRODUCT FIELD:
  259.  
  260.    8.  Enter the required ARCHIVE path in the
  261.        ARCHIVE field.
  262.  
  263.        o   When applying SERVICE to your system
  264.            the first time, the ARCHIVE path
  265.            specification requested is mandatory.
  266.            The next time you want to apply
  267.            service, the ARCHIVE path that was
  268.            previously used is automatically
  269.            assumed by CSF.
  270.        o   If the product has previously been
  271.            serviced, the ARCHIVE path cannot be
  272.            modified.
  273.        o   You are expected to provide space for
  274.            an ARCHIVE.  The space can be on a LAN,
  275.            a local or remote hard disk, or on a
  276.            diskette.
  277.        o   You can change the ARCHIVE path by
  278.            using the REDIRECT facility of SERVICE
  279.            or through the REDIRECT command line in
  280.            the FSERVICE response file.
  281.        o   If you are archiving to diskette, the
  282.            path must be to the root of the target
  283.            drive.
  284.  
  285.    9.  Enter the optional BACKUP fix path in the
  286.        BACKUP field.
  287.  
  288.        o   BACKUP is optional.
  289.        o   You are expected to provide space for a
  290.            BACKUP on a local hard disk or on a
  291.            diskette.
  292.        o   Specifying a BACKUP path for a
  293.            previously serviced product results in
  294.            the deletion of the previous BACKUP, if
  295.            one exists.
  296.        o   The system files changed or the patches
  297.            necessary to rebuild the previous
  298.            version of the system are stored in a
  299.            BACKUP directory until the SERVICE has
  300.            been committed or the next ServicePak
  301.            is applied.
  302.        o   If BACKUP is not enabled during the
  303.            last application of a ServicePak,
  304.            BACKOUT can only be used to restore the
  305.            ARCHIVE level.
  306.        o   BACKUP cannot be performed onto a LAN
  307.            drive.
  308.        o   BACKUP and ARCHIVE directory paths must
  309.            be different.
  310.        o   BACKUP and ARCHIVE to diskette must be
  311.            performed on different diskettes.
  312.        o   Deletion of a BACKUP fix level is
  313.            handled by the COMMIT function.
  314.        o   When service is applied to your system,
  315.            any previous BACKUP files are deleted.
  316.            BACKUP files are also deleted when a
  317.            BACKOUT is performed.
  318.        o   If you are backing up to diskette, the
  319.            path must be to the root of the target
  320.            drive.
  321.  
  322.    10. Select OK to perform the SERVICE or select
  323.        CANCEL to return to the Serviceable
  324.        Products window.
  325.  
  326.        SERVICE is successfully applied when you
  327.        see the message Corrective Service has been
  328.                        ___________________________
  329.        successfully applied.
  330.        ____________________
  331.  
  332.    11. When you are prompted by the CSF message Do
  333.                                                 __
  334.        you want to re-display the Product List?,
  335.        ________________________________________
  336.        do one of the following:
  337.  
  338.        o   Select NO to exit the Corrective
  339.            Service Facility
  340.        o   Select YES to view the refreshed
  341.            Product List window.
  342.  
  343.            NOTE:  You can use the Change Product
  344.                   List window to view the
  345.                   following SERVICE windows:
  346.                   -   Serviceable Products
  347.                       (Default Window)
  348.                   -   Backed up Products
  349.                   -   Archived Products
  350.                   -   Uncommitted Products
  351.  
  352.  
  353.    For detailed information about Service Windows,
  354.    see Service Windows Descriptions later in this
  355.        ____________________________
  356.    section.
  357.  
  358.  
  359. FSERVICE
  360. ________
  361.  
  362.    FSERVICE automatically evaluates your system.
  363.    FSERVICE runs from initialization when using
  364.    CSF Diskette 1.  Use the HELP facility to
  365.    ______________
  366.    answer questions on errors, window prompts, or
  367.    CSF function.  In the event of an error, you
  368.    are prompted to open the Service Log files.
  369.  
  370.    NOTE:  You should read the README files to
  371.           determine what method of service is
  372.           correct for your application of the
  373.           ServicePak (SERVICE, FSERVICE, or both).
  374.           FSERVICE is command-oriented and does
  375.           not use the graphical environment
  376.           provided by the OS/2 Presentation
  377.           Manager.  The README files are located
  378.           on CSF Diskette 1.
  379.              ______________
  380.  
  381.    Things to know before you begin this SERVICE:
  382.  
  383.    o   FSERVICE
  384.        -   Automatically:
  385.            --  Determines if the ServicePak can be
  386.                applied
  387.            --  What the serviceable products are
  388.            --  What files are to be backed up
  389.            --  If FSERVICE is required for this
  390.                ServicePak application.
  391.            --  Creates a response file to be used
  392.                by FSERVICE.
  393.  
  394.    You should modify your response files only if
  395.    you need to control the ServicePak application
  396.    manually, otherwise it automatically services
  397.    all partitions.  See "Response File Syntax" for
  398.    more information.
  399.  
  400.    To modify your response files:
  401.  
  402.    1.  Edit response files (to control the service
  403.        application manually).
  404.        o   RESPONSE.FIL samples are located on:
  405.            -   CSF Diskette 2 if you have 3.5-inch
  406.                ______________
  407.                diskettes.
  408.            -   CSF Diskette 3 if you have
  409.                ______________
  410.                5.25-inch diskettes.
  411.    2.  Shut down your system before starting
  412.        FSERVICE.
  413.  
  414.  
  415. STARTING FSERVICE
  416.  
  417.    Use FSERVICE when:
  418.  
  419.    1.  Insert CSF Diskette 1 into drive A.
  420.               ______________
  421.    2.  Restart the system to start FSERVICE.
  422.  
  423.        FSERVICE runs automatically.
  424.  
  425.    3.  Follow the instructions on your screen.
  426.  
  427.  
  428. SERVICE WINDOWS DESCRIPTIONS
  429. ____________________________
  430.  
  431.    o   SERVICE (Start SERVICE from Serviceable
  432.        Products window)
  433.  
  434.        CSF determines if SERVICE can be applied,
  435.        by a comparison of the version, ServicePak
  436.        level, and other information in the
  437.        CSF_PROD file in the ServicePak and the
  438.        SYSLEVEL file on the system.  Once it is
  439.        determined that service can be applied, CSF
  440.        determines the files that need to be backed
  441.        up (if BACKUP has been enabled) and the
  442.        files that need to be archived.  Backups
  443.        and archives are always kept separately.
  444.        If locked files are encountered, you will
  445.        be prompted to insert Diskette 1, and
  446.        restart your system.  FSERVICE will
  447.        automatically be invoked.
  448.  
  449.        Description of the PRODUCT, ARCHIVE, and
  450.        BACKUP LEVEL fields to perform your system
  451.        SERVICE.
  452.  
  453.        PRODUCT        This field lists the product
  454.                       name, level, and the path on
  455.                       which the product is
  456.                       located.  If SERVICE has
  457.                       been applied, then the
  458.                       SERVICE level is listed to
  459.                       the right of the ARCHIVE
  460.                       level and is enclosed in
  461.                       parentheses.
  462.  
  463.        ARCHIVE        Use this field to enter the
  464.                       required ARCHIVE path if the
  465.                       product is being serviced
  466.                       for the first time.  If the
  467.                       product has been previously
  468.                       serviced, the ARCHIVE path
  469.                       cannot be modified.  The
  470.                       ARCHIVE path can be altered
  471.                       only by using REDIRECT.
  472.  
  473.        BACKUP         Use this field to enter the
  474.                       BACKUP path for each product
  475.                       listed.  If the product is
  476.                       being serviced for the first
  477.                       time, you are not able to
  478.                       enter a BACKUP path.  This
  479.                       is because the ARCHIVE and
  480.                       BACKUP are the same thing at
  481.                       this point.  If the product
  482.                       has previously been
  483.                       serviced, the BACKUP path is
  484.                       optional.  Specifying a
  485.                       backup path for a previously
  486.                       serviced product results in
  487.                       the deletion of the previous
  488.                       BACKUP, if one exists.
  489.  
  490.    o   ARCHIVE (Access ARCHIVE from SERVICE
  491.        window)
  492.  
  493.        -   When applying SERVICE to your system
  494.            the first time, the ARCHIVE path
  495.            specification requested is mandatory.
  496.            The next time you want to apply
  497.            service, the ARCHIVE path that was
  498.            previously used is automatically
  499.            assumed by CSF.
  500.        -   If the product has previously been
  501.            serviced, the ARCHIVE path cannot be
  502.            modified.
  503.        -   You are expected to provide space for
  504.            an ARCHIVE.  The space can be on a LAN,
  505.            a local or remote hard disk, or on a
  506.            diskette.
  507.        -   You can change the ARCHIVE path by
  508.            using the REDIRECT facility of SERVICE
  509.            or through the REDIRECT command line in
  510.            the FSERVICE response file.
  511.        -   If you are archiving to diskette, the
  512.            path must be to the root of the target
  513.            drive.
  514.  
  515.    o   BACKUP (Access BACKUP from SERVICE window)
  516.  
  517.        -   BACKUP is optional.
  518.        -   You are expected to provide space for a
  519.            BACKUP on a local hard disk or on a
  520.            diskette.
  521.        -   Specifying a BACKUP path for a
  522.            previously serviced product results in
  523.            the deletion of the previous BACKUP, if
  524.            one exists.
  525.        -   The system files changed or the patches
  526.            necessary to rebuild the previous
  527.            version of the system are stored in a
  528.            BACKUP directory until the SERVICE has
  529.            been committed or the next ServicePak
  530.            is applied.
  531.        -   If BACKUP is not enabled during the
  532.            last application of a ServicePak,
  533.            BACKOUT can only be used to restore the
  534.            ARCHIVE level.
  535.        -   BACKUP cannot be performed onto a LAN
  536.            drive.
  537.        -   BACKUP and ARCHIVE directory paths must
  538.            be different.
  539.        -   BACKUP and ARCHIVE to diskette are
  540.            performed on different diskettes.
  541.        -   Deletion of a BACKUP fix level is
  542.            handled by the COMMIT function.
  543.        -   When service is applied to your system,
  544.            any previous BACKUP files are deleted.
  545.            BACKUP files are also deleted when a
  546.            BACKOUT is performed.
  547.        -   If you are backing up to diskette, the
  548.            path must be to the root of the target
  549.            drive.
  550.  
  551.    o   BACKOUT (Access BACKOUT from Backed Up
  552.        Products and Archived Products windows)
  553.  
  554.        When you back out a ServicePak, you return
  555.        to either the previous ServicePak level, if
  556.        a BACKUP exists, or to the ARCHIVE level of
  557.        the product.  CSF locates the files in the
  558.        ARCHIVE or BACKOUT directory and restores
  559.        them from the appropriate media.
  560.  
  561.        Description of the PRODUCTS and the TARGET
  562.        LEVEL fields, to perform your system
  563.        BACKOUT.
  564.  
  565.        PRODUCTS            This field lists all
  566.                            the selected products
  567.                            available for BACKOUT.
  568.  
  569.        TARGET LEVEL        This field lists the
  570.                            target levels for each
  571.                            product.  The target
  572.                            level is the level to
  573.                            which you would back
  574.                            out (previous BACKUP or
  575.                            ARCHIVE level).
  576.  
  577.        -   BACKOUT support is for only one level
  578.            of SERVICE applied or to the ARCHIVE
  579.            level of the product.
  580.        -   When you are backing out to a previous
  581.            fix, currently installed fix ServicePak
  582.            files are replaced with BACKUP (fix)
  583.            files.
  584.        -   Files archived by the previous full
  585.            ServicePak SERVICE application are not
  586.            deleted when you back out to the
  587.            previous fix.
  588.        -   If BACKUP is not enabled during the
  589.            last application of a ServicePak, then
  590.            BACKOUT to the previous level is not
  591.            permitted.
  592.  
  593.    o   COMMIT (Access COMMIT from Uncommitted
  594.        Products window)
  595.  
  596.        In performing COMMIT, you are committing a
  597.        product at its current level and removing
  598.        the ability to BACKOUT to a previous fix
  599.        level.  The ARCHIVE is not affected unless
  600.        you are committing a full ServicePak.  You
  601.        can BACKOUT to the ARCHIVE of the last
  602.        committed full ServicePak until the next
  603.        full ServicePak is committed.
  604.  
  605.        Description of the PRODUCT, the ARCHIVE,
  606.        and the BACKUP LEVEL fields to perform your
  607.        system COMMIT.
  608.  
  609.        PRODUCT             This field lists all of
  610.                            the selected products
  611.                            available to COMMIT.
  612.  
  613.        ARCHIVE LEVEL       This field lists the
  614.                            ARCHIVE level for each
  615.                            product.  If you are
  616.                            committing a full
  617.                            ServicePak, the
  618.                            reference to this
  619.                            directory is removed.
  620.  
  621.        BACKUP LEVEL        This field lists the
  622.                            BACKUP level of each
  623.                            product.  All backups
  624.                            are deleted after you
  625.                            COMMIT.
  626.  
  627.        -   When a full ServicePak (SERVICE
  628.            application) is committed, all BACKUP
  629.            files and SERVICE logs are deleted.  A
  630.            BACKOUT cannot be performed after this
  631.            is done.
  632.  
  633.        -   When a full ServicePak is committed,
  634.            the ARCHIVE directory is not deleted,
  635.            but the reference to the ARCHIVE
  636.            directory is deleted, and CSF no longer
  637.            has knowledge of where the ARCHIVE
  638.            resides.  Archive directories must be
  639.            deleted manually, because they can be
  640.            used by multiple machines or product
  641.            instances.
  642.  
  643.        -   After a fix ServicePak has been
  644.            applied, if a COMMIT operation is
  645.            performed, only the backup files are
  646.            deleted, and any files archived by the
  647.            application of the full ServicePak are
  648.            not deleted, so that you can still back
  649.            out to the ARCHIVE level if required.
  650.  
  651.        -   When a ServicePak has been applied to a
  652.            product and not committed, you have the
  653.            option to BACKOUT that application of
  654.            SERVICE.  However, application of the
  655.            next full ServicePak is not permitted
  656.            until you COMMIT the current
  657.            ServicePak.
  658.  
  659.    o   REDIRECT (Access REDIRECT from Archived
  660.        Products window)
  661.  
  662.        Description of the PRODUCT, the SOURCE
  663.        DIRECTORY and the TARGET DIRECTORY fields
  664.        to perform your system REDIRECT.
  665.  
  666.        PRODUCT             This field lists the
  667.                            selected archived
  668.                            products.
  669.  
  670.        SOURCE DIRECTORY    This field lists source
  671.                            directories where the
  672.                            ARCHIVE currently
  673.                            resides for each
  674.                            product.
  675.  
  676.        TARGET DIRECTORY    Use this field to enter
  677.                            the desired target path
  678.                            that is to reference
  679.                            your ARCHIVE directory.
  680.                            You must enter a new
  681.                            target directory for
  682.                            each product.
  683.  
  684.        -   Each selected product is listed, and
  685.            you are able only to supply information
  686.            pertaining to the new ARCHIVE path.  If
  687.            the new ARCHIVE path is to a removable
  688.            media drive, then the path is
  689.            restricted to the root level of that
  690.            drive.  There is no path restriction
  691.            for fixed or remote media.
  692.  
  693.        -   When redirecting the ARCHIVE to
  694.            diskette or removable media, CSF
  695.            requires you to supply valid diskettes
  696.            already containing a CSF-created
  697.            ARCHIVE file.
  698.  
  699.        -   Because of media differences, an
  700.            ARCHIVE on disk is different from one
  701.            on diskette.
  702.  
  703.        -   Redirecting an ARCHIVE alters the
  704.            reference to the location of your
  705.            ARCHIVE directory. Using REDIRECT
  706.            facilitates consolidation of ARCHIVE
  707.            directories onto a network drive.
  708.  
  709.            --  CSF expects a valid ARCHIVE to
  710.                exist at the new location.
  711.  
  712.            --  You can only redirect the ARCHIVE
  713.                of a particular product to a new
  714.                path if the ARCHIVE exists at the
  715.                new path for the same system level
  716.                for all files that were in the
  717.                original ARCHIVE.
  718.  
  719.            --  File lists are compared and
  720.                verified.  Failure of a match in
  721.                either case results in an
  722.                incomplete redirection of ARCHIVE
  723.                paths.
  724.  
  725.  
  726. SERVICE LOGS
  727. ____________
  728.  
  729.    A Service log is built and updated for each
  730.    installation of service on your system.  The
  731.    user-readable Summary Service Log (SERVICE.LOG)
  732.    contains a cumulative record of service applied
  733.    to the system.  The CSF-Readable Service Log
  734.    (LOGF0000.XXX) was created to support the CSF
  735.    utility program.  The Archive Layout file
  736.    (ARCHIVE.XXX) keeps track of ARCHIVE files.
  737.    All log files are located in the same directory
  738.    as the SYSLEVEL file that defines the product
  739.    instance.  CSF uses this logged information to
  740.    help it decide what actions to perform.
  741.  
  742.    SERVICE LOG DESCRIPTIONS:
  743.  
  744.    WARNING:  DO NOT DELETE THE SERVICE.LOG FILES.
  745.    YOU WILL NEED THIS INFORMATION IF YOU NEED TO
  746.    CALL SERVICE.
  747.  
  748.    o   The Summary Service Log (SERVICE.LOG)
  749.        lists:
  750.  
  751.        -   The identity and level of the product
  752.            that was updated.
  753.        -   The specific identity and level of the
  754.            fix ServicePak that was installed.
  755.        -   The date and time the fix ServicePak
  756.            was installed.
  757.        -   The type of CSF operation (for example,
  758.            a fix ServicePak installation or a
  759.            BACKOUT to a previous fix level).
  760.        -   The root directories for the ARCHIVE
  761.            and BACKUP directory paths used in this
  762.            CSF operation.
  763.        -   If backups are performed to diskette,
  764.            identification information concerning
  765.            those diskettes (for example, volume
  766.            labels and exterior label strings).
  767.        -   The files that have been copied to the
  768.            disk.  Copy operations are logged with
  769.            lines that are labelled "Copying" and
  770.            include the full path name of the file
  771.            on the disk.
  772.        -   The files that have been updated on the
  773.            disk.  Updates are considered to be
  774.            either full file replacements or file
  775.            patches.  Update operations are logged
  776.            with lines that are labelled "Updating"
  777.            and include the full path name of the
  778.            target file on the disk.
  779.        -   The files that have been archived to
  780.            the BACKUP directory path.  Archival
  781.            operations are logged with lines that
  782.            are labelled "Archiving" and include
  783.            the full path name of the file in the
  784.            BACKUP path.  In the event that the
  785.            ARCHIVE version of the file is already
  786.            present, then there will be no archival
  787.            copy performed and no archival entry
  788.            will be logged.
  789.        -   The files that have been backed up to
  790.            the BACKUP level BACKUP path.  These
  791.            files were copied from the target
  792.            product directory path before they were
  793.            replaced with newer file versions from
  794.            the fix ServicePak.  BACKUP operations
  795.            are logged with lines that are labelled
  796.            "Backing" and include the full path
  797.            name of the file in the BACKUP level
  798.            backup path.
  799.        -   If BACKUP is performed to diskette,
  800.            identification information concerning
  801.            those diskettes (for example, volume
  802.            labels and exterior label strings).
  803.            The identification information for a
  804.            particular diskette immediately
  805.            precedes the archival and backup log
  806.            entries that were made to that
  807.            diskette.
  808.  
  809.    o   CSF-Readable LOGF0000.XXX (xxx=Product
  810.        Code)
  811.  
  812.        WARNING:  LOGF0000.XXX MUST NOT BE MODIFIED
  813.        OR DELETED OR YOUR SYSTEM WILL BE RENDERED
  814.        UNSERVICEABLE.
  815.  
  816.        In order to provide the BACKUP/BACKOUT
  817.        facility mentioned above, CSF maintains a
  818.        machine-readable record of the operations
  819.        performed during the application of all
  820.        SERVICE.  This record is maintained in a
  821.        log file called LOGF0000.XXX in the
  822.        directory in which the SYSLEVEL file was
  823.        detected in the system.  This is an
  824.        internal log file, in binary format.
  825.  
  826.    o   ARCHIVE Layout file  ARCHIVE_.XXX
  827.        (xxx=Product Code)
  828.  
  829.        WARNING:  ARCHIVE_.XXX MUST NOT BE MODIFIED
  830.        OR DELETED OR YOUR SYSTEM WILL BE RENDERED
  831.        UNSERVICEABLE.
  832.  
  833.    o   CSF also keeps track of the ARCHIVE
  834.        directory and files in an Archive Layout
  835.        File. This file is located either in the
  836.        ARCHIVE path on hard disk or on the first
  837.        ARCHIVE diskette.
  838.  
  839.  
  840. RESPONSE FILE SYNTAX
  841. ____________________
  842.  
  843.    This section provides a detailed look at
  844.    response file syntax primarily needed by the
  845.    FSERVICE user.  Functional examples are
  846.    included on:
  847.  
  848.        CSF Diskette 2 if you have 3.5-inch
  849.        ______________
  850.        diskettes.
  851.        CSF Diskette 3 if you have 5.25-inch
  852.        ______________
  853.        diskettes.
  854.  
  855.    The default response file is provided on CSF
  856.                                             ___
  857.    Diskettte 2.
  858.    ___________
  859.  
  860.  
  861. GENERAL TAGS
  862.  
  863.    General tags must appear before any keyword
  864.    tags in the response file or they will be
  865.    ignored.  These general tags can appear in any
  866.    order at the front of the response file but
  867.    must occur only once.  FSERVICE will fail if
  868.    these tags appear following any other keyword
  869.    tags.
  870.  
  871.    :LOGFILE  drive\path\filename
  872.  
  873.              This specifies the drive, directory,
  874.              and log file name if a log file is
  875.              desired which differs from the
  876.              default name of the user readable
  877.              log.  This file will be created if it
  878.              does not exist and will be appended
  879.              if it does exist.
  880.  
  881.    :FLAGS    ╒flag1■ ╒flag2■ ╒flag3■
  882.  
  883.              This optional tag specifies flags
  884.              that apply only to the :SERVICE tag.
  885.              If specified in a response file that
  886.              does not have the :SERVICE tag, they
  887.              will be ignored.  The flags include:
  888.  
  889.              REPLACE_NEWER
  890.                                Replace files that
  891.                                have dates later
  892.                                than the
  893.                                corresponding file
  894.                                on the ServicePak.
  895.                                If this is not
  896.                                specified, the user
  897.                                is prompted if any
  898.                                newer files are
  899.                                found.
  900.  
  901.              REPLACE_PROTECTED
  902.                                Replace files that
  903.                                are read-only,
  904.                                hidden, or system
  905.                                files.  If this is
  906.                                not specified, the
  907.                                user is prompted if
  908.                                any protected files
  909.                                are found.
  910.  
  911.              EXIT_WHEN_DONE
  912.                                This tells FSERVICE
  913.                                to stop if any
  914.                                errors are
  915.                                encountered and to
  916.                                report the errors.
  917.  
  918.    :SOURCE   drive\path
  919.  
  920.              This specifies the drive, and
  921.              directory where the ServicePak is to
  922.              be found.  It is mostly intended for
  923.              use with the CID installations where
  924.              the ServicePak is from a LAN drive.
  925.              It is required for response files
  926.              that contain a :SERVICE tag and if it
  927.              is found missing for :SERVICE, then
  928.              FSERVICE will fail.  If it is
  929.              encountered in a response file that
  930.              does not contain the :SERVICE tag, it
  931.              is ignored.
  932.  
  933.    :TARGET   ARCHIVE | BACKUP
  934.  
  935.              This general tag applies only to
  936.              response files that contain the
  937.              :BACKOUT keyword.  The tag has one
  938.              argument, which must be either
  939.              "ARCHIVE" or "BACKUP."  This limits
  940.              the BACKOUT function to back out to
  941.              the archive level or the backup
  942.              level.  It is specified only once,
  943.              and any :BACKOUT keywords encountered
  944.              in a response file will use the one
  945.              :TARGET tag to qualify all backouts
  946.              being done.  It must exist prior to
  947.              any :BACKOUT keyword or FSERVICE will
  948.              fail.  If it is encountered in a
  949.              response file that does not contain
  950.              the :BACKOUT tag, it is ignored.
  951.  
  952.    *
  953.  
  954.              This tag specifies that a comment
  955.              follows.
  956.  
  957.  
  958. KEYWORD TAGS
  959.  
  960.    Any one of the keyword tags can appear many
  961.    times in a given response file.  Each
  962.    occurrence of a keyword tag marks the start of
  963.    another serviceable product.  Each occurrence
  964.    of a serviceable product is referred to as a
  965.    product instance.  This means that the same
  966.    ________________
  967.    product could be installed multiple times or
  968.    might be installed in multiple partitions.  The
  969.    action that is to be performed for each
  970.    installation (product instance) is unique and
  971.    is determined by the response file syntax and
  972.    keyword choice.  Mixing or repeating keywords
  973.    for a specific product instance is not
  974.    permitted and will cause the FSERVICE program
  975.    to fail.
  976.  
  977.    :SERVICE
  978.              This is used to apply service to a
  979.              product instance on the system.  It
  980.              uses the ServicePak information from
  981.              the :SOURCE tag previously specified.
  982.              :SERVICE has two position-dependent
  983.              parameter tags that must follow it,
  984.              and one that is optional.  Each tag
  985.              must be on a line by itself.  They
  986.              are:
  987.  
  988.              :SYSLEVEL drive\path
  989.  
  990.                        This is the drive, and
  991.                        directory of the SYSLEVEL
  992.                        file for a given product
  993.                        instance and must follow
  994.                        the :SERVICE keyword in the
  995.                        response file.
  996.  
  997.              :ARCHIVE  drive\path
  998.  
  999.                        This is the drive, and
  1000.                        directory of the ARCHIVE
  1001.                        for a given product
  1002.                        instance and must follow
  1003.                        the :SERVICE keyword in the
  1004.                        response file.
  1005.  
  1006.              :BACKUP   drive\path
  1007.  
  1008.                        This is the drive, and
  1009.                        directory of the BACKUP for
  1010.                        a given product instance
  1011.                        and can optionally follow
  1012.                        the :SERVICE keyword in the
  1013.                        response file.
  1014.  
  1015.    :BACKOUT
  1016.              This is used to back out a product
  1017.              instance on the system to the level
  1018.              specified on the :TARGET tag.  The
  1019.              TARGET tag must have been found
  1020.              before any back out can be done.
  1021.              :BACKOUT has one position-dependent
  1022.              parameter tag, which must follow it
  1023.              on a line by itself.  It is:
  1024.  
  1025.              :SYSLEVEL drive\path\filename
  1026.  
  1027.                        This is the drive,
  1028.                        directory, syslevel
  1029.                        filename of the SYSLEVEL
  1030.                        file for a given product
  1031.                        instance and must follow
  1032.                        the :BACKOUT keyword in the
  1033.                        response file.
  1034.  
  1035.    :REDIRECT
  1036.              This is used to redirect an archive
  1037.              of a product instance on the system
  1038.              to the location of another existing
  1039.              archive.  :REDIRECT has two
  1040.              position-dependent parameter tags
  1041.              that must follow it, each of which
  1042.              must be on a line by itself.  They
  1043.              are:
  1044.  
  1045.              :SYSLEVEL drive\path\filename
  1046.  
  1047.                        This is the drive,
  1048.                        directory, syslevel
  1049.                        filename of the SYSLEVEL
  1050.                        file for a given product
  1051.                        instance and must follow
  1052.                        the :REDIRECT keyword in
  1053.                        the response file.
  1054.  
  1055.              :ARCHIVE  drive\path
  1056.  
  1057.                        This is the new ARCHIVE
  1058.                        drive, and directory for a
  1059.                        given product instance and
  1060.                        must follow the :REDIRECT
  1061.                        keyword in the response
  1062.                        file.  :REDIRECT and
  1063.                        :SYSLEVEL.
  1064.  
  1065.    :COMMIT
  1066.              This is used to COMMIT a product
  1067.              instance on the system.  :COMMIT has
  1068.              one position-dependent parameter tag,
  1069.              which must follow it on a line by
  1070.              itself.  It is:
  1071.  
  1072.              :SYSLEVEL drive\path\filename
  1073.  
  1074.                        This is the drive,
  1075.                        directory, and syslevel
  1076.                        filename of the SYSLEVEL
  1077.                        file for a given product
  1078.                        instance and must follow
  1079.                        the :COMMIT keyword in the
  1080.                        response file.
  1081.  
  1082.  
  1083. Notices
  1084.  
  1085.    References in this publication to IBM products,
  1086.    programs, or services do not imply that IBM
  1087.    intends to make these available in all
  1088.    countries in which IBM operates.  Any reference
  1089.    to an IBM product, program or service is not
  1090.    intended to state or imply that only IBM's
  1091.    product, program, or service may be used.  Any
  1092.    functionally equivalent product, program, or
  1093.    service that does not infringe any of IBM's
  1094.    intellectual property rights or other legally
  1095.    protectable rights may be used instead of the
  1096.    IBM product, program, or service.  Evaluation
  1097.    and verification of operation in conjunction
  1098.    with other products, programs, or services,
  1099.    except those expressly designated by IBM, are
  1100.    the user's responsibility.
  1101.  
  1102.    IBM may have patents or pending patent
  1103.    applications covering subject matter in this
  1104.    document.  The furnishing of this document does
  1105.    not give you any license to these patents.  You
  1106.    can send license inquiries, in writing, to the
  1107.    IBM Director of Licensing, IBM Corporation, 208
  1108.    Harbor Drive, Stamford, Connecticut 06904-2501,
  1109.    U.S.A.
  1110.  
  1111.    IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESSED
  1112.    OR IMPLIED, INCLUDING WITHOUT LIMITATION,
  1113.    WARRANTIES OF FITNESS AND MERCHANTABILITY WITH
  1114.    RESPECT TO THE INFORMATION IN THIS DOCUMENT.
  1115.    BY FURNISHING THIS DOCUMENT, IBM GRANTS NO
  1116.    LICENSES TO ANY RELATED PATENTS OR COPYRIGHTS.
  1117.  
  1118.  
  1119. TRADEMARKS
  1120. __________
  1121.  
  1122.    The following terms, denoted by an asterisk
  1123.    ((*)) in this publication, are trademarks of
  1124.    the IBM Corporation in the United States or
  1125.    other countries.
  1126.  
  1127.    +----------------------+----------------------+
  1128.    | OS/2                 | Presentation Manager |
  1129.    +----------------------+----------------------+
  1130.  
  1131.  
  1132. ---------------
  1133.  
  1134. (*) Trademark of the IBM Corporation.
  1135.