.FO OFF

IBM i PTF Shipping Information Letter


IBM i CUMULATIVE PTF PACKAGE
INSTALLATION INSTRUCTIONS
SF99750 Level 23306
PACKAGE ID:  C3306750
VERSION 7 RELEASE 5.0


Cumulative PTF Package Instructions Last Updated: 11/17/2023

Note: Online copy of this document is the latest version. Any
printed copy should be assumed to be obsolete and not used unless
the date of last update is verified to match that shown on the
online version.

The information contained in this document was current at the
time this cumulative PTF package was made available. We recommend
you get the most current information (including a more detailed
installation instructions version if desired) which can be found
via the following URL:

 https://www.ibm.com/support/pages/node/667567


PSP SF98750 lists HIPER PTFs not included in this cumulative PTF
package and any defective PTFs identified since this package was
released.

You will receive the cumulative PTF package in one of three
different formats:

*  Electronically downloaded as individual PTF save files

*  Electronically downloaded as optical image files

*  Physical optical media (when it cannot be downloaded
   electronically)

The installation instructions contained in this document will
guide you through the install steps needed for each format.

REVIEW PTF COVER LETTERS

As with any PTF order, before you install the PTFs you should
review the cover letter of each delivered PTF for any special
instructions that may need to be followed. When you ordered your
cumulative PTF package, you were automatically sent the latest
HIPER and Database PTF groups along with the cumulative PTF
package. You should review the cover letters for the PTFs in
these groups that are applicable to your system. The commands
needed for copying and printing (or displaying) the PTF cover
letter(s) are included below.

1. COPYING PTF COVER LETTERS:

   *  Mount the PTF media and sign on using a security officer
      user profile such as QSECOFR.

   *  To copy all cover letters from media onto the system for
      PTFs that are not already applied to your system, enter the
      following command:

      CPYPTFCVR DEV(device_name) LICPGM(*ALL) SELECT(*NOTAPY)

   *  To copy a specific cover letter from media onto the system,
      enter the following command:

      CPYPTFCVR DEV(device_name) LICPGM(product_id) SELECT(ptf_id)

2. DISPLAYING OR PRINTING PTF COVER LETTERS:

   *  The PTF cover letters must be copied from the media first
      before they can be displayed or printed.

   *  To display or print cover letters for all PTFs that are
      currently not applied on your system, enter one of the
      following commands:

      DSPPTFCVR LICPGM(*ALL) SELECT(*NOTAPY)
      DSPPTFCVR LICPGM(*ALL) SELECT(*NOTAPY) OUTPUT(*PRINT)



      Note: You can also specify CVRATR(*SPCINST) on the
      DSPPTFCVR command to view all cover letters that have
      special instructions.

   *  To display or print a specific cover letter, enter one of
      the following commands:

      DSPPTFCVR LICPGM(product_id) SELECT(ptf_id)
      DSPPTFCVR LICPGM(product_id) SELECT(ptf_id) OUTPUT(*PRINT)

   *  PTF TC23306 is the Cumulative PTF package cover letter and
      contains a list of all PTFs contained in this cumulative
      PTF package. To display the Cumulative PTF package cover
      letter, enter one of the following commands:

         DSPPTFCVR LICPGM(5770SS1) SELECT(TC23306)
         DSPPTFCVR LICPGM(5770SS1) SELECT(TC23306) OUTPUT(*PRINT)

3. You can also review the special instructions for PTFs in the
   cumulative package or groups in a convenient format online:

   *  Cumulative package:
      https://www.ibm.com/support/pages/uid/nas4C3306750

   *  HIPER PTF group:
      https://www.ibm.com/support/pages/uid/nas4SF99959_SI

   *  Database PTF group:
      https://www.ibm.com/support/pages/uid/nas4SF99950_SI

READ THIS FIRST

1. Failure to follow these instructions may result in failure of
   your system to operate. Follow the directions carefully every
   time you install a cumulative PTF package.

2. Cumulative PTF packages must be installed delayed for proper
   PTF installation. Do NOT use any immediate apply install
   options to install this package; otherwise, unpredictable
   results may occur.

3. Vital PTF information: Application of PTFs within this
   cumulative PTF package may disable or render ineffective
   programs that use system memory addresses not generated by the
   IBM® translator, including programs that circumvent control
   technology designed to limit interactive capacity to purchased
   levels. These PTFs may be prerequisites for future PTFs. By
   applying these PTFs you authorize and agree to the foregoing.

4. Each of these PTFs is subject to the terms of the license
   agreement which accompanied, or was contained in, the Program
   for which you are obtaining such PTF. You are not authorized
   to install or use any such PTF except as part of the Program
   for which you have a valid Proof of Entitlement.

   SUBJECT TO ANY WARRANTIES WHICH CAN NOT BE EXCLUDED OR EXCEPT
   AS EXPLICITLY AGREED TO IN THE APPLICABLE LICENSE AGREEMENT OR
   AN APPLICABLE SUPPORT AGREEMENT, IBM MAKES NO WARRANTIES OR
   CONDITIONS EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT
   LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF
   MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON
   INFRINGEMENT, REGARDING EACH PTF.

   The applicable license agreement may have been provided to you
   in printed form and/or may be viewed using the Work with
   Software Agreements (WRKSFWAGR) CL command.

5. Attention Content Manager OnDemand - 5770RD1 - Users. If you
   have Content Manager OnDemand - 5770RD1 - installed, please
   see https://www.ibm.com/support/pages/node/404923 for any
   important special instructions.

6. If you received this cumulative PTF package as physical
   optical media, it is strongly recommended that you create an
   image catalog from the media and perform the PTF install from
   a virtual optical device. This may avoid multiple IPLs during
   the PTF installation.

7. The approximate install time for this cumulative PTF package
   is one hour.

8. You should have a current backup of your system before
   applying this package. If you have backed up your system since
   the last time you applied PTFs, that backup is acceptable.

9. If you are running on the A storage area, perform a normal IPL
   from the B IPL source. To determine the storage area you are
   running from, type DSPPTF 5770999 and press Enter. On the
   Display PTF Status display, the storage area is identified in
   the IPL source field. ##MACH#A is the A storage area and
   ##MACH#B is the B storage area.

10. IMPORTANT: Permanently apply any temporarily applied Licensed
    Internal Code PTFs on your partition before installing this
    cumulative PTF package:

    APYPTF LICPGM(5770999) SELECT(*ALL) APY(*PERM)

11. Be sure the IPL mode is set to Normal and sign on using a
    security officer user profile such as QSECOFR.

12. DO NOT cancel any of the steps once they are started. Allow
    each step to complete normally.

13. Select the appropriate INSTALL steps below based on the
    format in which you received the cumulative PTF package.

14. If you have changed defaults to any IBM commands using the
    CHGCMDDFT command, application of this PTF package will
    change the command defaults back to the shipped values for
    any commands included in this PTF package. This can cause
    commands to behave differently after applying PTFs. IBM
    recommends that any time you change a command default for a
    command in an IBM library, you keep the CHGCMDDFT commands in
    a CL program, and run that program after you apply PTFs to
    reapply your customized command defaults.

15. If the WRKPTFGRP command shows any PTF groups with a status
    of "Apply at next IPL", it is recommended that you IPL to
    complete the PTF install prior to installing this cumulative
    PTF package.

16. The PTF install processing will automatically pre-apply the
    following PTF(s) when applicable: 5770999-MF71388,
    5770999-MF71395, 5770SS1-SI78869, 5770SS1-SI82617,
    5770SS1-SI84578, 5770SS1-SI84231.

17. If your partition has IBM Advanced Job Scheduler for i
    (5770-JS1) installed, run the following command before
    installing this package:

    CHGDTAARA DTAARA(QUSRIJS/QIJSPM (246 1)) VALUE('1')

    This will prevent unnecessary inquiry messages in the SCPF
    job log that could hang the install when certain System Reply
    List entries have been customized with an 'R' reply.

INSTALL FROM *SERVICE

If you received the cumulative PTF package electronically as
individual PTF save files, refer to the INSTALL FROM *SERVICE
section in the detailed installation instructions.

INSTALL FROM OPTICAL IMAGE FILES

Use these steps when you ordered and received the cumulative PTF
package electronically as optical image files:

1. Create your image catalog and add the image files to the
   catalog. For information on how to create an image catalog
   refer to the IBM Knowledge Center:
   https://www.ibm.com/docs/en/i/7.5?topic=scenario-installing-i-fixes-from-image-catalog
   (IBM i 7.5>IBM i and related software>Maintaining and managing
   IBM i and related software>Using software fixes>Installing
   fixes>Step 3: Choosing your fix installation
   scenario>Installing IBM i fixes from an image catalog).

2. Load the image catalog into the virtual optical device using
   the following command:

   LODIMGCLG IMGCLG(ptfcatalog) DEV(OPTVRTxx) OPTION(*LOAD)

3. Type GO PTF and press the Enter key.

4. Take menu option 8 and press the Enter key.

5. If the Continue PTF Install display is shown, press the Enter
   key.

6. Review the appropriate options and notes which follow, below,
   then complete the Install Options for Program Temporary Fixes
   screen and press the Enter key.

   Device . . . . . .  OPTVRTxx (for example, OPTVRT01)
   Automatic IPL  . .  Y = Yes or N = No
   Prompt for media .  1 or 3
   Restart type . . .  *SYS
   Other options  . .  Y = Yes



   Note: If you have received individual and/or PTF groups as
   save files that you want to install at the same time as the
   cumulative PTF package, type 3 in the Prompt for media field.

7. Review the appropriate options and notes which follow, below,
   then complete the Other Install Options screen and press the
   Enter key.

   Omit PTFs  . .  N = No or Y = Yes
   Apply type . .  1 = Set all PTFs delayed
   PTF type . . .  1 = All PTFs
   Copy PTFs  . .  N = No or Y = Yes



   Note: If you want to copy PTF save files and cover letters
   into *SERVICE for PTFs that are not already applied, enter a Y
   (Yes) in the Copy PTFs field. Otherwise, enter a N (No) and
   PTF save files and cover letters will not be copied.

   Note: Depending on the previous options specified, some fields
   above may not be shown.



   Note: If you have PTFs to omit, type Y in the Other Options
   field and follow the directions on the displays which follow.
   Refer to Appendix A in the detailed installation instructions
   section on omitting PTFs.

8. The display shows the licensed programs for which PTFs are
   being loaded. All volumes that are loaded in the image catalog
   are automatically processed.

9. Continue with the COMPLETE THE INSTALL PROCESS section.

INSTALL FROM OPTICAL MEDIA

Use these steps when you ordered and received the cumulative PTF
package as physical optical media:

1. Enter the following command and press the Enter key.

   CHGMSGQ QSYSOPR *BREAK SEV(70)



   This step ensures a break message will appear if the system
   determines you should mount the next volume. IMPORTANT—If
   there are no PTFs on the other volumes that are applicable to
   your system, the system will not prompt you for the other
   volumes.

2. Ensure volume one of the cumulative PTF package media, labeled
   C3306750_01, is loaded in the appropriate drive for the media
   you are using.

3. Type GO PTF and press the Enter key.

4. Take menu option 8 and press the Enter key.

5. If the Continue PTF Install display is shown, press the Enter
   key.

6. Review the appropriate options and notes which follow, below,
   then complete the Install Options for Program Temporary Fixes
   screen and press the Enter key.

   Device . . . . . .  OPTxx (for example, OPT01)
   Automatic IPL  . .  Y = Yes or N = No
   Prompt for media .  2 or 3
   Restart type . . .  *SYS
   Other options  . .  Y = Yes



   Note: Enter a 2 in the Prompt for media field in order to
   install the HIPER and Database PTF groups along with your
   cumulative PTF package.

   If you have received individual and/or PTF groups as save
   files that you want to install at the same time as the
   cumulative PTF package, type 3 in the Prompt for media field.

7. Review the appropriate options and notes which follow, below,
   then complete the Other Install Options screen and press the
   Enter key.

   Omit PTFs  . .  N = No or Y = Yes
   Apply type . .  1 = Set all PTFs delayed
   PTF type . . .  1 = All PTFs
   Copy PTFs  . .  N = No or Y = Yes



   Note: If you want to copy PTF save files and cover letters
   into *SERVICE for PTFs that are not already applied, enter a Y
   (Yes) in the Copy PTFs field. Otherwise, enter a N (No) and
   PTF save files and cover letters will not be copied.

   Note: Depending on the previous options specified, some fields
   above may not be shown.



   Note: If you have PTFs to omit, type Y in the Other Options
   field and follow the directions on the displays which follow.
   Refer to Appendix A in the detailed installation instructions
   section on omitting PTFs.

8. The display shows the licensed programs for which PTFs are
   being loaded.

   8.a. After each volume is processed, you will receive a
        message to mount the next volume. Load the volume
        indicated and use the G option to continue.

   8.b. After all the applicable volumes for the cumulative PTF
        package have been processed, you will automatically be
        prompted to mount the first volume of the next media set
        in order to install the HIPER and Database PTF groups.
        Mount the first volume in the set and use the G option to
        continue.

   8.c. Continue mounting any additional volumes. When all your
        volume sets have been processed, use the X option to
        complete the PTF installation.



   Note: If there are volumes that contain PTFs that are not
   applicable to your system, the system will not prompt you to
   mount those volumes.

9. Continue with the COMPLETE THE INSTALL PROCESS section.

COMPLETE THE INSTALL PROCESS

Use these steps to complete the install process.

1. If the Confirm IPL to Complete PTF Install display is shown:

   1.a. End all jobs on the system and perform a normal mode IPL
        to the B IPL source. If you are installing from optical
        image files, do not delete the image catalog until after
        the next normal IPL completes.
   1.b. When the Sign On display is shown, continue with step 4.

2. If the Confirm IPL for Technology Refresh PTFs display is
   shown:

   2.a. Press F10 to end all jobs on the system and IPL the
        system. Note: If an IPL cannot be performed right away,
        press F12 to Cancel the process. Schedule to IPL the
        system at the earliest convenience.
   2.b. When the Sign On display is shown, if you are installing
        from optical media, go back and start the installation of
        this cumulative PTF package again. (The next time through
        these instructions, you will not get this display.) Start
        again with STEP 1 of INSTALL FROM OPTICAL MEDIA section.
        If you installed from *SERVICE or optical image files,
        continue with step 4.

3. If you entered a Y (Yes) for the Automatic IPL option, the
   system will be IPLed automatically. If you entered N (No) for
   the Automatic IPL field, you must use the following command
   when you are ready to activate the fixes:

   PWRDWNSYS OPTION(*IMMED) RESTART(*YES) IPLSRC(B)

4. After the IPL completes, use the following procedure to verify
   the cumulative PTF package was properly installed:

   4.a. Sign on using a security officer user profile such as
        QSECOFR.
   4.b. Type WRKPTFGRP SF99750 on any command line.
   4.c. If the Status field is "Installed" and the Level field is
        "23306", continue with step 5, otherwise, continue with
        step 4.d.
   4.d. Type GO LICPGM on any command line.
   4.e. Press the Enter key. The Work with Licensed Programs
        display is shown.
   4.f. Select option 50.
   4.g. Press the Enter key. The Install History display is
        shown.
   4.h. Press the Enter key. The Display History Log Contents
        display appears.

        *  If the cumulative PTF package was installed
           successfully, you will see messages indicating the
           applying of PTFs completed. Continue with step 5.
        *  If the cumulative PTF package was not installed
           successfully, you will see messages indicating the
           applying of PTFs failed. Contact your provider of
           software service for assistance.
        *  If the previous IPL was abnormal, only PTFs for the
           Licensed Internal Code will be applied (5770999). You
           can check if the previous IPL was abnormal by typing
           the following command:

           DSPSYSVAL SYSVAL(QABNORMSW)

           If the IPL was abnormal and you are installing this
           package immediately after a system install, perform
           the IPL again to apply the remaining PTFs.

5. You can resume normal system operation at this time. You
   should back up your system again at your earliest convenience.

If you have comments or concerns with cumulative PTF packages,
contact your provider of software service.