Licensed programs, PTFs, and secondary language recovery

Use this procedure if an error occurred when you installed an IBM i licensed program, PTF, or secondary language.

Type GO LICPGM on an IBM i control language (CL) command line.
On the Work with Licensed Programs menu, type 50 (Display log for messages). Press Enter.
The Display Install History display appears. Press Enter.
The Display History Log Contents display appears. Look at the messages to determine the installation status of the licensed programs and PTFs. The messages show what part of the licensed program installation function has failed. Areas where the failure could have occurred include the following:
- Installing the IBM-supplied libraries
- Installing the licensed programs
- Installing PTFs
- Installing a secondary language
- Initialization process
If a problem such as a power failure occurs during a process in the preceding list, you could see a message that the process has started. An example of such a message is Licensed program installation process started. However, the failed or completed status message might not be displayed.
There should be one or more messages that indicate which IBM-supplied library or licensed program failed. Be sure to look at all of the messages. Use F10 (Display all) to see all messages.
To see the online help information, move the cursor to the message and press the Help key. Look at the online help information for the error message to get the message identifier and more information about the cause and recovery for the failure. Go to the error messages table in this topic to review the list of possible messages that you could see.
A copy of the job log has been spooled to an output queue.
To locate and display the job log, enter one of the following Work with Spool File (WRKSPLF) commands:
- For automatic installation, type the following command and press Enter: WRKSPLF SELECT(QLPAUTO) ASTLVL(*INTERMED)
- For manual installation, type the following command and press Enter: WRKSPLF SELECT(QSECOFR) ASTLVL(*INTERMED)
- For the PTF process, type the following command and press Enter: WRKJOB JOB(000000/QSYS/SCPF) then select option 10 to view the job log.
If the bottom of the display shows More..., page down (Roll up) until Bottom... appears. Select option 5 (5=Display) on the last entry.
Note: Ignore any error messages listed in the nnnnnn/QSYS/QLPINSTALL job log. These messages are not installation error messages.

Scan the job log for error messages. Determine the cause and recovery for each error message in the job log. Go to the error messages table in this topic for a list of possible messages that you might see. Be sure to scan the entire job log. There could be more than one failure. Scan the job log by using the message ID. Remember that the message ID is case-sensitive.
Select option 10 (Display installed licensed programs) on the Work with Licensed Programs display. The Installed Status column indicates which licensed programs and optional parts are installed. The Installed Status column also indicates whether each licensed program installed successfully and whether it is compatible with the installed operating system. Refer to Installed status values for a description of the installed status values.
You can press the F11 key to see a view of the display that shows the Installed Release column. The version, release, and modification value appears for licensed programs that are either installed compatibly or are installed at a back level. Page down (Roll up) through all of the displays to see the status of your licensed programs.

Check to see if the licensed program that you are installing had a different language feature code than your primary language feature code. If it does, the licensed program either is flagged as *ERROR or the column is blank. The language objects for the licensed program are installed in a secondary language library. Obtain distribution media with the correct primary language feature code. Press the F3 key to return to the Work with Licensed Programs menu.
After you determine the cause of the error and complete the recommended recovery action, resume the installation process. If you were using automatic installation, go to Starting the automatic installation process again. If you were using the manual installation process, go to Starting the manual installation process again.

The following table contains some of the error messages with possible causes of the errors. Look at the messages on your system to determine the exact cause and recovery.

Message	Description
CPA3DD2 CPA3DD3	Cause: The system could not identify the last volume loaded in the device. Recovery: Open the device door, verify that correct volume is loaded, and close the device door.
CPA3DDD CPA3DDF	Cause: The installation process is expecting more licensed programs to be loaded. Recovery: If you have more media that contains licensed programs, load the volume and type `G` to continue the installation process. If you do not have any more volumes that contain licensed programs, type `X` to indicate that there is no more media to load. When the installation process is completed, use option 50 of the LICPGM menu to verify messages in the installation history log.
CPA3DE1	Cause: The volume that is loaded does not contain licensed programs that are supported through the Work with Licensed Programs (LICPGM) menu. Recovery: Load the optical media that contains licensed programs.
CPDB6DA	Cause: During a manual installation, the software agreement for a licensed program was not accepted and cannot be installed. Recovery: Follow the instructions in Using the Work with Licensed Programs menu to install IBM licensed programs to accept the software agreement and retry the installation.
CPDB6DB	Cause: During an automatic installation, the software agreement for a licensed program was not accepted and cannot be installed. Recovery: Follow the instructions in Using the Work with Licensed Programs menu to install IBM licensed programs to accept the software agreement and retry the installation.
CPD4F39	Cause: The volumes located in a network optical device are not in the correct sort order for the program temporary fix (PTF) package application. Recovery: Follow these steps: Find the catalog that owns the images loaded in the device. Use the Verify Image Catalog (VFYIMGCLG) command to sort the volume list for the type Program Temporary Fix. Use the Vary Configuration (VFYCFG) command to vary off and vary on the device.
CPF3DC1	Cause: Directory objects for product 5770SS1 option BASE release V7R1M0 failed to install. The system will not install library QGPL and will not allow licensed programs to be installed until the directory objects have been installed. Recovery:* See previous messages in the job log to determine the cause of the failure. Correct the errors
CPF3DC2	Cause: Required user library cannot be installed. The system will not install library QGPL and will not allow licensed programs to be installed because the operating system directory installation was not successful. Recovery:Examine the history log for errors that occurred while operating system directories were being installed. Correct the errors.
CPD32B0 reason code 7 CPF327E reason code 3	Cause: 5770SS1 option 1, Extended Base Support, failed to install. Recovery: Use the Reclaim Storage (RCLSTG) command and try to install option 1 again.
CPD3713	Cause: The licensed program is currently installed on your system and was not found on the distribution media. Recovery: Get another set of distribution media that contains the licensed program. Either install the licensed program again from Installing additional licensed programs or delete the licensed program from your systemif you no longer want it.
CPD3D82 CPF3D8F	Cause: These messages could be shown if you did not end all of the subsystems before you started the installation process. Recovery: End all subsystems and start installing the licensed programs again.
CPF371C CPF3731	Cause: Look at the messages previously listed in the job log to determine the failure. Recovery: Take the recommended recovery action. If you received one of these messages, the installation process ended before you completed installing the licensed programs.
CPF371D CPF371E	Cause: These messages could be shown if the wrong volume is loaded. The online information of the message can help determine the cause. Recovery: Load the correct volume and start the process again.
CPF3D96	Cause: Errors occurred during the restoring process for a licensed program. Recovery: Take the recommended recovery action explained in the online help information. If you received these messages, the installation continued with the other licensed programs if the problem was not too severe. However, problems with the tape or system storage level would have caused the installation to end.
CPF3D81 CPF3D84 CPF3D8B CPF3D8C CPF3D90 CPF3D91	Cause: Errors occurred when restoring a licensed program or PTFs. Recovery: Use the Display Job (DSPJOB) command. Enter `DSPJOB nnnnnn/QLPINSTALL/QBCHINST` or `DSPJOB nnnnnn/QLPINSTALL/QLPINSTALL` where nnnnnn is the job number of the job log in the message help of the error message. Select option 4 on the Display Job display to display spooled files. Select option 5 on the Display Job Spooled Files display to determine the cause of the failure. Correct the error and start the installation process again. Ignore error messages in the nnnnnn/QSYS/QLPINSTALL job log. These messages are not installation error messages.
CPF3D82 CPF3D83	Cause: There is not enough auxiliary storage to install the licensed programs that you selected. Recovery: Go to Licensed program releases and sizes to determine the space requirements for each licensed program that you want to install. Obtain additional auxiliary storage and start the installation process again.
CPF3D85 CPF3D86 CPF3D8E	Cause: An object or PTF is not installed because it requires successful installation of a licensed program. That licensed program might not be installed or might be installed at the wrong release. Recovery: See the previous messages in the job log to determine if the licensed program is installed successfully. Correct any errors or install the required licensed program and start the installation process again.
CPF3DD3	Cause: The device description could not be found or could not be used. Recovery: Create a device description for the installation device (optical or tape). Use the CRTOPTDEV command to create a device description for the optical device that supports the optical media class. Use the CRTDEVTAP command to create a device description for the tape device. Then start the process again.
CPI3D82 CPI3D84 CPI3D85	Cause: A licensed program that is included on the distribution media was not currently installed on the system. Recovery: Use the online information of the message for recovery help. Use the topic Installing additional licensed programs to install the licensed program.
Media error messages	Cause: A media error occurred during the installation process. Recovery: If you are using optical media, clean the disc, and then follow the recovery actions that are indicated for this message. If you are using tape, clean the tape head and tape path thoroughly. If you receive another error message that indicates a media error on the same tape, get another set of tapes to complete the installation.