Advanced fix installation: Building a custom fix package

Edit online

You can encounter situations where you, as a service provider, do not want to distribute the same IBM® i fixes to your service requesters. In those situations, you will want to build your own fix package from DVD-ROM that can be used the same way as a fix package supplied by IBM service support.

This example combines a fix package with individual fixes into a custom fix package for distribution to other systems in your network.

Note: If you build a custom fix package and save it to virtual optical media, you cannot span virtual volumes. Your custom fix package must fit on one volume.

The order of a cumulative PTF package is:

  • High-impact pervasive (HIPER) Licensed Internal Code fixes
  • HIPER IBM i fixes
  • HIPER licensed program fixes
  • A delimiter that divides the HIPER fixes from the non-HIPER fixes
  • Non-HIPER Licensed Internal Code fixes
  • Non-HIPER IBM i fixes
  • IBM i Online information fixes, if any
  • Non-HIPER licensed program fixes

Customizing a PTF package from DVD-ROM

Edit online

For the following example, assume that you want a tape that contains all but one (SF00600) of the PTFs from the most recent PTF package received from IBM service support, including the HIPER PTFs. In addition, you want to include four individual PTFs received electronically from service support. These PTFs are MF00050, SF00480, SF00500, and SF00800.

Because the four individual PTFs were received from IBM service support, they already exist in save files in library QGPL. They exist in the library as object type *file, as shown below:

  • QMF00050: *FILE
  • QSF00480: *FILE
  • QSF00500: *FILE
  • QSF00800: *FILE
  1. Find out the path identifier for the fix file you want to copy from the cumulative PTF package:
    Note: A path identifier is a 1 to 6-digit number that identifies each fix file on the DVD-ROM. Each release of a licensed product on the DVD-ROM has its own unique set of identifiers. Each set of path identifiers for the product begins with the number 1 indicating the first fix file for the product and release. This first fix file may or may not contain HIPER fixes for the product.

    To get the path identifier for each fix file you want to copy from the cumulative PTF package for your product, use the Copy Program Temporary Fix (CPYPTF) command, and specify PATHID(*SELECT). The Select PTF File display is shown.

    Select PTF File display

                                    Select PTF File                          
                                                                                
                                                           System:   SYSNAMXX   
                                                                                
Product . . . . . . . . :   5770SS1                                             
                                                                                
Type option, press Enter.                                                       
1=Select                                                                        
                                                                                
                           National                                            
                Feature    Language       Path      Hiper                       
Opt   Release    Type      Version     Identifier   PTFs                        
      V7R2M0     *CODE                     1        Yes                         
      V7R2M0     *CODE                     2        No                          
      V7R2M0     *LNG       2924           2        No
  2. Use the CPYPTF command to bring the HIPER fixes from the cumulative PTF package into library QGPL. Two licensed programs are being used in this example (MF and SF PTFs). You can identify the HIPER fix files on the Select PTF File display by a Yes in the Hiper PTFs column. 
    CPYPTF   LICPGM(5770999)
FROMDEV(OPT01)
TODEV(*SAVF)
FROMPATHID(1)
TOSAVF(QGPL/PCUMH999)
 
CPYPTF   LICPGM(5770SS1)
FROMDEV(OPT01)
TODEV(*SAVF)
FROMPATHID(1)
TOSAVF(QGPL/PCUMHSS1)
  3. Copy the product delimiter into a save file. 
    CPYPTF   LICPGM(5770111)
FROMDEV(OPT01)
TODEV(*SAVF)
SELECT(*ALL)
FROMPATHID(1)
TOSAVF(QGPL/PCUMH111)
  4. Copy the non-HIPER fixes from the cumulative package into a save file omitting the unwanted fixes. 
    CPYPTF   LICPGM(5770999)
FROMDEV(OPT01)
TODEV(*SAVF)
FROMPATHID(2)
TOSAVF(QGPL/PCUMP999)
 
CPYPTF   LICPGM(5770SS1)
FROMDEV(OPT01)
TODEV(*SAVF)
OMIT(SF00600)
FROMPATHID(2)
TOSAVF(QGPL/PCUMPSS1)

Creating the custom package

Edit online

Repeat the command for each licensed program with non-HIPER fixes. The OMIT parameter was used to identify the fix not included in the tailored package. The TOSAVF name must be 8 characters in length and must start with the letter P. You can choose the remaining seven characters. The library on the TOSAVF parameter must be QGPL.

Library QGPL now contains:

File Name  Object Type
QMF00050   *FILE
QSF00480   *FILE
QSF00500   *FILE
QSF00800   *FILE
PCUMH999   *FILE
PCUMHSS1   *FILE  (plus more for HIPERs of licensed programs)
PCUMH111   *FILE
PCUMH999   *FILE
PCUMPSS1   *FILE  (plus more for non-HIPERs of licensed programs)
  1. Initialize the tape for the tailored cumulative package. 
    INZTAP   DEV(TAP01)
NEWVOL(CUMPKG)
  2. Copy the Licensed Internal Code HIPER fixes into one file and place it first on the tape. 
    CPYPTF   LICPGM(5770999)
FROMDEV(*SERVICE)
TODEV(TAP01)
SELECT(CUMH999)
TOENDOPT(*LEAVE)

    The TOENDOPT(*LEAVE) parameter is used to maintain the tape position.

  3. Copy the IBM i HIPER fixes onto the tape. 
    CPYPTF   LICPGM(5770SS1)
FROMDEV(*SERVICE)
TODEV(TAP01)
SELECT(CUMHSS1)
TOENDOPT(*LEAVE)

    Repeat for each licensed program with HIPER fixes.

  4. Copy the delimiter to the tape. 
    CPYPTF   LICPGM(5770111)
FROMDEV(*SERVICE)
TODEV(TAP01)
SELECT(CUMH111)
TOENDOPT(*LEAVE)
  5. Copy the non-HIPER Licensed Internal Code fixes into one file and place on the tape. 
    CPYPTF   LICPGM(5770999)
FROMDEV(*SERVICE)
TODEV(TAP01)
SELECT(CUMP999 MF00050)
TOENDOPT(*LEAVE)
  6. Copy the non-HIPER IBM i fixes into one file and place on the tape. 
    CPYPTF   LICPGM(5770SS1)
FROMDEV(*SERVICE)
TODEV(TAP01)
SELECT(CUMPSS1 SF00480 SF00500 SF00800)
TOENDOPT(*LEAVE)

    Repeat for each licensed program with non-HIPER fixes.

The tape now contains the tailored fix package. It can be used in the same way that your service support fix packages are used.

Fixes can now be loaded on, applied to, or removed from a system.