Using the Work with Licensed Programs menu to install IBM licensed programs

If you have logical partitions, you must perform this procedure on each partition to which you want to install the IBM^® licensed programs.

If you are not already signed on to the server as the security officer (QSECOFR user profile), do so now.
Note: The i5/OS™ Main Menu (or the menu you chose as your initial menu) appears on the console.
If you are installing from an image catalog (virtual optical device), the setup instructions are in the topic Preparing to upgrade or replace software using an image catalog.
If you are installing from optical media, insert the volume of the licensed program that you want to install into the installation device. If this is a new installation, start with i5/OS media volume B29xx_02. To install keyed products, load the volumes labeled L29xx_01 and L29xx_02. If you have priced features of i5/OS or single licensed programs, load the volume labeled F29xx_01. For more information on the optical media you received with your order, see Media labels and their contents. Wait until the In Use indicator goes out before you continue.
Do the following to put the system in a restricted state and filter the messages that appear.
1. Type CHGMSGQ QSYSOPR *BREAK SEV(60) and press Enter.
2. A message display could appear. Press Enter.
3. Type ENDSBS *ALL *IMMED and press Enter.
4. When the following message appears, press Enter to continue:
```
ENDSBS SBS(*ALL) command being processed
```
5. The message System ended to restricted condition appears. Press Enter to continue.
6. Type CHGMSGQ QSYSOPR SEV(95) and press Enter.
7. A message display could appear. Press Enter.
Type GO LICPGM and press Enter.

The Work with Licensed Programs display appears.

 LICPGM                   Work with Licensed Programs                           
                                                             System:   XXXX     
 Select one of the following:                                                   
                                                                                
   Manual Install                                                               
      1. Install all                                                            
                                                                                
   Preparation                                                                  
      5. Prepare for install                                                    
                                                                                
   Licensed Programs                                                            
     10. Display installed licensed programs                                    
     11. Install licensed programs                                              
     12. Delete licensed programs                                               
     13. Save licensed programs

If you want to accept software agreements for your licensed programs individually, continue with step 6.

If you have many licensed programs to install, accepting them together is faster than accepting them individually through manual installation. If you want to preaccept your licensed program agreements all at one time, select option 5 (Prepare for install).

Select the option to work with software agreements. If a licensed program that you want to install does not appear on the Work with Software Agreements display, use F22 (Restore software agreements). Otherwise, continue with the next step.
Type a 5 to display the software agreements for the licensed programs that you want to install and press Enter. Press F14 to accept the software agreements and then return to the Work with Licensed Programs display.

On the Work with Licensed Programs display, either type 1 (Install all) or type 11 (Install licensed programs). Read the following note to help you decide.
Note: If you want to install all licensed programs that are on the distribution media, use Manual Install option 1, Install all. This will save time for the installation. If you want most of the licensed programs on the media, then Manual Install option 1 is also the preferred choice. You will have to delete the extra unwanted licensed programs. The Manual Install display appears after selecting Manual Install option 1.
Type the following on this display:
- Install option: 2 (2=all products)
- Installation device: OPT01
- Replace if current: N
- Nonaccepted agreement: 2 (2=Display software agreement)
- Automatic IPL: N
In this example, OPT01 is used for the installation device. If you use a different naming convention, type the name that you have assigned to the installation device.

For more information about using option 1, refer to Manual installation Option 1. Install all.
Press Enter. If you typed 1, continue with step 10 of these instructions.
If you typed 11, the Install Licensed Programs display appears.
Page through the display to find the licensed programs you want. Type a 1 in the Option column next to the licensed programs to be installed.
```
                            Install Licensed Programs
                                                               System: XXXX
 Type options, press Enter.
   1=Install
 
         Licensed  Product
Option   Program   Option       Description
  _      _______   _______
  _      5722SS1                i5/OS - Library QGPL
  _      5722SS1                i5/OS - Library QUSRSYS
  _      5722SS1   1            i5/OS - Extended Base Support
  _      5722SS1   2            i5/OS - Online Information
  _      5722SS1   3            i5/OS - Extended Base Directory Support
  _      5722SS1   5            i5/OS - System/36 Environment
  _      5722SS1   6            i5/OS - System/38 Environment
  _      5722SS1   7            i5/OS - Example Tools Library
  _      5722SS1   8            i5/OS - AFP Compatibility Fonts
  _      5722SS1   9            i5/OS - *PRV CL Compiler Support
  _      5722SS1   12           i5/OS - Host Servers
  _      5722SS1   13           i5/OS - System Includes
                                                                    More...
 F3=Exit   F11=Display status/release   F12=Cancel   F19=Display trademarks
 
 
```
Notes:
- The libraries QGPL and QUSRSYS, and Extended Base Support (option 1) and Extended Base Directory Support (option 3) are preselected if you are installing licensed programs as part of a new system installation. If you are adding additional (new) licensed programs or optional parts, these items would be preselected only if they are in an error state.
- A licensed program you want to install might not be listed on the Install Licensed Programs display. If a licensed program is not listed, it can be added to the list by entering information into the blank fields at the top of the list. After you press Enter, this product then appears on the list with the other products.
  - Type 1 in the Option column.
  - Type the product identifier in the Licensed Program column.
  - Type the product option value in the Product Option column.
  - Press Enter.
  When you are typing the product option, the system accepts only the following three values: *BASE, option number, or *ALL.
  - A value of *BASE installs only the base product of the associated product identifier.
  - The product option number installs only the particular option of the associated product identifier. To be able to install options, you must install the base product (*BASE).
  - A value of *ALL installs the base product and all options of the associated product identifier that are found on the media.
  Keep in mind that licensed programs that you add will appear on the list with only the product identifier and will not give a descriptive name of the product. Also, you should check the documentation that came with the product to see whether there are any special instructions.
  
  If you get a message that the product already appears in the list, scroll down to the product. Make sure that there is a 1 in the Option column. Make sure that it is selected for installation.
Press Enter.
The Confirm Install of Licensed Programs display appears on the console. Press Enter to confirm your choices.

The Install Options display appears.

                                Install Options                                 
                                                             System:   XXXX     
 Type choices, press Enter.                                                     
                                                                                
   Installation device  . . .   OPT01        Name                               
                                                                                
   Objects to install . . . .   1            1=Programs and language objects    
                                             2=Programs                         
                                             3=Language objects                 
                                                                                
   Nonaccepted agreement. . .   2            1=Do not install licensed program  
                                             2=Display software agreement       
                                                                                
   Automatic IPL  . . . . . .   N            Y=Yes                                    
                                             N=No

Type the following on this display:

Installation device: OPT01 (In this example, OPT01 is used for the installation device. If you use a different naming convention, type the name that you have assigned to the installation device.)
Objects to install: 1
Nonaccepted agreement: 2
Automatic IPL: N

One or both of the following displays show the status of the licensed programs and language objects as they are being installed on the system. You do not need to respond to these status displays.

                         Installing Licensed Programs                         
                                                             System: XXXX     
                                                                              
                                                                              
   Licensed programs processed . . . . . . . . . . :      0 of XXX            
                                                                              
                   Licensed program install in progress

The following display is an example of the display that appears during the installation process.

                            Installing Licensed Programs 
                                                              System: XXXX
   
    Licensed programs processed  . . . . . . . . . . . . . . . :    X of XXX

    Licensed
    Program  Option  Description                                 Type
    5722SS1   12     i5/OS - Host Servers                       2924

Note: This display shows which licensed programs and optional parts of licensed programs are being installed. After the *PGM objects and *LNG objects for each licensed program or optional part have been installed, the licensed program identifier disappears from the display and the number in the licensed programs processed field changes to show how many are processed.

You might see the Display Messages display. If you have another media volume that contains licensed programs to load, you can load it at this time. If you are installing from optical media, wait for the In Use indicator to go out before responding to the message.

                                 Display Messages
                                                       System:   XXXX
 Queue  . . . . . :    QSYSOPR               Program . . . . :   *DSPMSG
   Library  . . . :     QSYS                   Library . . . :
 Severity . . . . :       95                 Delivery  . . . :   *BREAK
 
 Type reply (if required), press Enter.
   Load the next volume in optical device OPT01 (X G)
     Reply . . . . G

Type G and press Enter. After you load each volume, type G and press Enter. If there are no more volumes to load that contain licensed programs, or if you want to end the loading process, type X and press Enter.

If a licensed program requires acceptance of a software agreement, the Software Agreements display appears. Do either of the following:
- Press F14 to accept the agreement and allow the licensed program to continue installing.
- Press F16 to decline the agreement and end the installation of that licensed program.
The Work with Licensed Programs display appears on your console when the installation process is completed. One of the following messages appears on the bottom of the Work with Licensed Programs display.
Work with licensed programs function not complete. Go to the topic Troubleshooting software installation problems to determine the problem.

Work with licensed programs function has completed. Continue with the next step.
Verify the installed status values of your licensed programs and check for compatibility. It is important to make sure all of your licensed programs are compatible with the operating system.
Use LICPGM menu option 10 (Display licensed programs) to see the release and installed status values of the installed licensed programs. If the installed status value of a licensed program is *COMPATIBLE, it is ready for use. If the installed status value of a licensed program is *BACKLEVEL, the licensed program is installed, but its version, release, and modification is not compatible with the currently installed level of the operating system. Check the topic, Licensed program releases and sizes, to verify the current version, release, and modification of the licensed program. Installed status values lists the possible installed status value descriptions.

You have completed this task.

Do you have more licensed programs or optional parts to install, but they did not appear in the list displayed in step 7 (or could not be added to the list)?
- No. Go to the next step (step 2).
- Yes. Go to Using the Restore Licensed Programs command to install IBM or non-IBM licensed programs to install these licensed programs or optional parts.
Do you need to install a secondary language?
- No. Go to the next step (step 3).
- Yes. Go to Installing a secondary language and complete the instructions.
You must complete the installation process before you put your system into operation. Go to Checklist: Completing the installation and complete the instructions.