Preselecting the licensed programs to install

Use these procedures to create and customize an installation list from your IBM® i distribution media.

Media considerations before you begin

Media type Special considerations for this task
Virtual optical storage using the Network File System or 632B-003 Ensure that you complete the steps in the topic Preparing to upgrade or replace software with virtual optical storage using the Network File System before you follow the steps in this procedure. Ensure that the first entry is in mounted status by entering the command LODIMGCLGE IMGCLG(*DEV) IMGCLGIDX(1) OPTION(*MOUNT) DEV(NETWORK_DEVICE).
Optical image catalog Ensure that you complete steps 1 through 5 in the topic Preparing an optical image catalog to install software before you follow the steps in this procedure. Ensure that the first entry is in mounted status by entering the command LODIMGCLGE IMGCLG(MYCATALOG) IMGCLGIDX(1) OPTION(*MOUNT).
Physical optical media A message might appear that instructs you to load the next media volume.
  • If you have more volumes to load, type G and press Enter.
  • If there are no more volumes to load or if you want to end the loading process, type X and press Enter.
Continue to load the physical optical media in order (as described in step 2) until the system has read all of the volumes. If the display contains the message, Problem occurred loading volume into device, or if it states that a product was not found on the media, one of these situations occurred:
  • You left the same media in the drive and the system read it again.
  • The system had problems reading in the new volume that you placed into the drive.
  1. Sign on as security officer (QSECOFR user profile). If you are using image catalogs, go to step 3.
  2. If you are using physical optical media, arrange the optical media for Licensed Internal Code, the operating system, and licensed programs in the order that is shown in the table Latest version of media labels and their contents. The order is important. More specifically, include only the operating system, IBM-supplied libraries, no charge options, no-charge licensed programs, and keyed products. Do not include any other optical media when creating the installation list at this time.
  3. Type CHGMSGQ QSYSOPR *BREAK SEV(95) to put your message queue in the break mode.
  4. A message display could appear. Press Enter.
  5. Type GO LICPGM and press Enter.
  6. Select option 5 (Prepare for install) from the Work with Licensed Programs (LICPGM) menu and press Enter. The Prepare for Install display appears.
  7. Select the option to Work with Licensed Programs for Target Release and press Enter. The Work with Licensed Programs for Target Release display appears.
  8. Do the following:
    1. If you are using physical optical media, load the first optical media in the optical device.
    2. Specify 1 (Distribution media), for the Generate list from prompt.
    3. Specify a value for the media device or virtual media device.
    4. Specify the target release for the IBM i release. (This is the release of the operating system, not the Licensed Internal Code).
    5. Press Enter.
  9. The Work with Licensed Programs for Target Release display appears.

    The list you see contains the licensed programs that are on the optical distribution media. Preselected licensed programs indicate that the product on the distribution media can replace a product that is installed on the system. (Preselected means a 1 appears in the option column.) Although more than one version of Licensed Internal Code might appear on the display, only one can be selected.

    Verify that you received all of the licensed programs and priced features that you ordered.
    • Use the F11 key to see alternative views that display information about licensed programs in greater detail. Press F11 to toggle through these views:
      1. Display additional storage
      2. Display expected release
      3. Display expected action
      4. Display product option
    • Use option 5 (Display release-to-release mapping) to see what, if any, currently installed product will be replaced by the selected product.

      You might need to specify option 2 (Merge with additional distribution media) on the Work with Licensed Programs for Target Release display to merge your existing list with information about licensed programs on additional optical media. This task is described later. Continue with the next step.

  10. Select additional licensed programs or optional parts of licensed programs to add to your customized list. Type a 1 in the Option column to select a licensed program to install. To remove a selected product from the list, blank out or remove the 1 in the Option column.
    Note: If you deselect an item, the licensed program still will be installed unless you also follow the steps in Deleting licensed programs during cleanup.
    When you complete your selections, press Enter. A message at the bottom of the display will prompt you to enter more changes, or press Enter to confirm the changes. The Confirm Target Release Licensed Programs display appears.
  11. Press Enter to confirm the list. The Prepare for Install display appears.
  12. Select the option to List Licensed Programs Not Found on Media and press Enter. The Licensed Programs Not Found On Media display appears.
  13. If no products are listed, you have all the media needed to replace your existing software. Press Enter to return to the Work with Licensed Programs menu. Go to the next step (step 14) to create a printed list of the licensed programs you selected. If there are any products listed, do the following:
    1. Delete the licensed programs that are no longer supported.
    2. You might need to obtain the others before you begin installing software. Do the following:
      1. Check to see whether you accidentally omitted an optical disk when you performed step 8.
      2. Compare your media labels to the product tables (Latest version of media labels and their contents and Licensed program releases and sizes) to see if the product was shipped. If you did not receive a licensed program that you expected, contact your software provider.
      3. When you receive the product or locate the media, use the distribution media and product tables (Latest version of media labels and their contents and Licensed program releases and sizes) to add its contents to the installation list. Use the procedure Adding additional licensed programs to the installation list to create a printed list of the programs that you selected to install.
      4. If you want to modify the installation list, type 3 (Modify previously generated list) on the Work with Licensed Programs for Target Release display.
  14. If you do not need to select any additional licensed programs, do this step now. Otherwise, skip this step and continue with Adding additional licensed programs to the installation list.
    1. From the Prepare for Install display, select the option to Display Licensed Programs for the Target Release and press Enter.
    2. Specify *PRINT for output on the Display Licensed Programs for Target Release display and press Enter. This creates a spooled file that you can print and use as a reference while performing the installation. You should see the message Task to prepare for install successfully completed appear at the bottom of the display.
    3. Press F3 to exit.
Parent topic: Required: Creating a custom list of software to install