309 lines
18 KiB
HTML
309 lines
18 KiB
HTML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE html
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html lang="en-us" xml:lang="en-us">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<meta name="security" content="public" />
|
|
<meta name="Robots" content="index,follow" />
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
|
<meta name="DC.Type" content="reference" />
|
|
<meta name="DC.Title" content="Licensed programs, PTFs, and secondary language recovery" />
|
|
<meta name="abstract" content="Use this procedure if an error occurred when you installed a licensed program, PTF, or secondary language." />
|
|
<meta name="description" content="Use this procedure if an error occurred when you installed a licensed program, PTF, or secondary language." />
|
|
<meta name="DC.Relation" scheme="URI" content="rzahctroubleshoot.htm" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2004, 2006" />
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2004, 2006" />
|
|
<meta name="DC.Format" content="XHTML" />
|
|
<meta name="DC.Identifier" content="rzahclicprg" />
|
|
<meta name="DC.Language" content="en-us" />
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
|
<!-- US Government Users Restricted Rights -->
|
|
<!-- Use, duplication or disclosure restricted by -->
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
|
<title>Licensed programs, PTFs, and secondary language recovery</title>
|
|
</head>
|
|
<body id="rzahclicprg"><a name="rzahclicprg"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">Licensed programs, PTFs, and secondary language recovery</h1>
|
|
<div><p>Use this procedure if an error occurred when you installed a licensed
|
|
program, PTF, or secondary language.</p>
|
|
<div class="section"> <ol><li>Type <tt>GO LICPGM</tt> on an i5/OS™ control language (CL) command line.</li>
|
|
<li>On the Work with Licensed Programs menu, type <tt>50</tt> (Display
|
|
log for messages). Press Enter.</li>
|
|
<li>The Display Install History display appears. Press Enter.</li>
|
|
<li>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:
|
|
<ul><li>Installing the IBM-supplied libraries</li>
|
|
<li>Installing the licensed programs</li>
|
|
<li>Installing PTFs</li>
|
|
<li>Installing a secondary language</li>
|
|
<li>Initialization process</li>
|
|
</ul>
|
|
<p>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 <tt>Licensed program installation process started</tt>.
|
|
However, the failed or completed status message might not be displayed.</p>
|
|
</li>
|
|
<li>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.</li>
|
|
<li>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.</li>
|
|
<li>A copy of the job log has been spooled to an output queue. <p>To locate
|
|
and display the job log, enter one of the following Work with Spool File (WRKSPLF)
|
|
commands:</p>
|
|
<ul><li>For automatic installation, type the following command and press Enter: <tt>WRKSPLF
|
|
SELECT(QLPAUTO) ASTLVL(*INTERMED)</tt></li>
|
|
<li>For manual installation, type the following command and press Enter: <tt>WRKSPLF
|
|
SELECT(QSECOFR) ASTLVL(*INTERMED)</tt></li>
|
|
<li>For the PTF process, type the following command and press Enter: <tt>WRKSPLF
|
|
SELECT(QSYS *ALL *ALL SCPF) ASTLVL(*INTERMED)</tt></li>
|
|
</ul>
|
|
<div class="p">If the bottom of the display shows More..., page down (Roll up) until
|
|
Bottom... appears. Select option 5 (5=Display) on the last entry. <div class="note"><span class="notetitle">Note:</span> Ignore
|
|
any error messages listed in the nnnnnn/QSYS/QLPINSTALL job log. These messages
|
|
are not installation error messages.</div>
|
|
</div>
|
|
<p>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.</p>
|
|
</li>
|
|
<li>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 <a href="statusvalues.htm#statusvalues">Installed status values</a> for
|
|
a description of the installed status values. <p>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.</p>
|
|
<p>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.</p>
|
|
</li>
|
|
<li>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 <a href="rzahcstauto.htm#rzahcstauto">Starting the automatic installation process again</a>. If
|
|
you were using the manual installation process, go to <a href="rzahcstman.htm#rzahcstman">Starting the manual installation process again</a>.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section"><p>The following table contains some of the error messages with possible
|
|
causes of the errors. Look at the messages on your server to determine the
|
|
exact cause and recovery.</p>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" class="singleborder" frame="border" border="1" rules="all"><thead align="left"><tr class="tablemainheaderbar"><th colspan="2" align="center" valign="bottom" id="d0e125">Error messages</th>
|
|
</tr>
|
|
<tr class="tablesubheaderbar"><th valign="top" width="28.934010152284262%" id="d0e128">Message</th>
|
|
<th valign="top" width="71.06598984771574%" id="d0e130">Description</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr><td align="left" valign="top" width="28.934010152284262%" headers="d0e125 d0e128 "><p>CPA3DD2<br />
|
|
CPA3DD3</p>
|
|
</td>
|
|
<td align="left" valign="top" width="71.06598984771574%" headers="d0e125 d0e130 "><p><strong>Cause:</strong> The server could not identify
|
|
the last volume loaded in the device.</p>
|
|
<p><strong>Recovery:</strong> Open the device
|
|
door, verify that correct volume is loaded, and close the device door.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.934010152284262%" headers="d0e125 d0e128 "><p>CPA3DDD<br />
|
|
CPA3DDF</p>
|
|
</td>
|
|
<td align="left" valign="top" width="71.06598984771574%" headers="d0e125 d0e130 "><p><strong>Cause:</strong> The installation process
|
|
is expecting more licensed programs to be loaded.</p>
|
|
<p><strong>Recovery:</strong> If
|
|
you have more media that contains licensed programs, load the volume and type <samp class="codeph">G</samp> to
|
|
continue the installation process. If you do not have any more volumes that
|
|
contain licensed programs, type <samp class="codeph">X</samp> 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.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.934010152284262%" headers="d0e125 d0e128 ">CPA3DE1</td>
|
|
<td align="left" valign="top" width="71.06598984771574%" headers="d0e125 d0e130 "><p><strong>Cause:</strong> The volume that is loaded
|
|
does not contain licensed programs that are supported through the Work with
|
|
Licensed Programs (LICPGM) menu.</p>
|
|
<p><strong>Recovery:</strong> Load the optical media
|
|
that contains licensed programs.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="28.934010152284262%" headers="d0e125 d0e128 ">CPDB6DA</td>
|
|
<td valign="top" width="71.06598984771574%" headers="d0e125 d0e130 "><p><strong>Cause:</strong> During a manual installation, the software
|
|
agreement for a licensed program was not accepted and cannot be installed.</p>
|
|
<p><strong>Recovery:</strong> Follow
|
|
the instructions in <a href="contlp.htm#contlp">Using the Work with Licensed Programs menu to install IBM licensed programs</a> to accept the
|
|
software agreement and <span>retry the</span> installation.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="28.934010152284262%" headers="d0e125 d0e128 ">CPDB6DB</td>
|
|
<td valign="top" width="71.06598984771574%" headers="d0e125 d0e130 "><p><strong>Cause:</strong> During an automatic installation, the
|
|
software agreement for a licensed program was not accepted and cannot be installed.</p>
|
|
<p><strong>Recovery:</strong> Follow
|
|
the instructions in <a href="contlp.htm#contlp">Using the Work with Licensed Programs menu to install IBM licensed programs</a> to accept the
|
|
software agreement and <span>retry the</span> installation.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.934010152284262%" headers="d0e125 d0e128 "><p>CPD32B0 reason code 7<br />
|
|
CPF327E reason code 3</p>
|
|
</td>
|
|
<td align="left" valign="top" width="71.06598984771574%" headers="d0e125 d0e130 "><p><strong>Cause:</strong> 5722SS1 option 1, Extended
|
|
Base Support, failed to install. </p>
|
|
<p><strong>Recovery:</strong> Use the Reclaim Storage
|
|
(RCLSTG) command and try to install option 1 again.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.934010152284262%" headers="d0e125 d0e128 ">CPD3713</td>
|
|
<td align="left" valign="top" width="71.06598984771574%" headers="d0e125 d0e130 "><p><strong>Cause:</strong> The licensed program is
|
|
currently installed on your server and was not found on the distribution media.</p>
|
|
<p><strong>Recovery:</strong> Get
|
|
another set of distribution media that contains the licensed program. Either
|
|
install the licensed program again from <a href="addlicpgm.htm#addlicpgm">Installing additional licensed programs</a> or
|
|
delete the licensed program from your server if you no longer want it.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.934010152284262%" headers="d0e125 d0e128 "><p>CPD3D82<br />
|
|
CPF3D8F</p>
|
|
</td>
|
|
<td align="left" valign="top" width="71.06598984771574%" headers="d0e125 d0e130 "><p><strong>Cause:</strong> These messages could be
|
|
shown if you did not end all of the subsystems before you started the installation
|
|
process.</p>
|
|
<p><strong>Recovery:</strong> End all subsystems and start installing the
|
|
licensed programs again.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.934010152284262%" headers="d0e125 d0e128 "><p>CPF371C<br />
|
|
CPF3731</p>
|
|
</td>
|
|
<td align="left" valign="top" width="71.06598984771574%" headers="d0e125 d0e130 "><p><strong>Cause:</strong> Look at the messages previously
|
|
listed in the job log to determine the failure.</p>
|
|
<p><strong>Recovery:</strong> Take
|
|
the recommended recovery action.</p>
|
|
<p>If you received one of these messages,
|
|
the installation process ended before you completed installing the licensed
|
|
programs.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.934010152284262%" headers="d0e125 d0e128 "><p>CPF371D<br />
|
|
CPF371E</p>
|
|
</td>
|
|
<td align="left" valign="top" width="71.06598984771574%" headers="d0e125 d0e130 "><p><strong>Cause:</strong> These messages could be
|
|
shown if the wrong volume is loaded. The online information of the message
|
|
can help determine the cause.</p>
|
|
<p><strong>Recovery:</strong> Load the correct volume
|
|
and start the process again.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.934010152284262%" headers="d0e125 d0e128 ">CPF3D96</td>
|
|
<td align="left" valign="top" width="71.06598984771574%" headers="d0e125 d0e130 "><p><strong>Cause:</strong> Errors occurred during the
|
|
restoring process for a licensed program.</p>
|
|
<p><strong>Recovery:</strong> Take the
|
|
recommended recovery action explained in the online help information.</p>
|
|
<p>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.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.934010152284262%" headers="d0e125 d0e128 "><p>CPF3D81<br />
|
|
CPF3D84<br />
|
|
CPF3D8B<br />
|
|
CPF3D8C<br />
|
|
CPF3D90<br />
|
|
CPF3D91</p>
|
|
</td>
|
|
<td align="left" valign="top" width="71.06598984771574%" headers="d0e125 d0e130 "><p><strong>Cause:</strong> Errors occurred when restoring
|
|
a licensed program or PTFs.</p>
|
|
<p><strong>Recovery:</strong> Use the Display Job (DSPJOB)
|
|
command. Enter <tt>DSPJOB nnnnnn/QLPINSTALL/QBCHINST</tt> or <tt>DSPJOB nnnnnn/QLPINSTALL/QLPINSTALL</tt> 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.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.934010152284262%" headers="d0e125 d0e128 "><p>CPF3D82<br />
|
|
CPF3D83</p>
|
|
</td>
|
|
<td align="left" valign="top" width="71.06598984771574%" headers="d0e125 d0e130 "><p><strong>Cause:</strong> There is not enough auxiliary
|
|
storage to install the licensed programs that you selected.</p>
|
|
<p><strong>Recovery:</strong> Go
|
|
to <a href="rzahcswslpsze.htm#rzahcswslpsze">Licensed program releases and sizes</a> to determine the
|
|
space requirements for each licensed program that you want to install. Obtain
|
|
additional auxiliary storage and start the installation process again.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.934010152284262%" headers="d0e125 d0e128 "><p>CPF3D85<br />
|
|
CPF3D86<br />
|
|
CPF3D8E</p>
|
|
</td>
|
|
<td align="left" valign="top" width="71.06598984771574%" headers="d0e125 d0e130 "><p><strong>Cause:</strong> 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. </p>
|
|
<p><strong>Recovery:</strong> 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.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.934010152284262%" headers="d0e125 d0e128 ">CPF3DD3</td>
|
|
<td align="left" valign="top" width="71.06598984771574%" headers="d0e125 d0e130 "><p><strong>Cause:</strong> The device description could
|
|
not be found or could not be used.</p>
|
|
<p><strong>Recovery:</strong> 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.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.934010152284262%" headers="d0e125 d0e128 "><p>CPI3D82<br />
|
|
CPI3D84<br />
|
|
CPI3D85</p>
|
|
</td>
|
|
<td align="left" valign="top" width="71.06598984771574%" headers="d0e125 d0e130 "><p><strong>Cause:</strong> A licensed program that
|
|
is included on the distribution media was not currently installed on the server.</p>
|
|
<p><strong>Recovery:</strong> Use
|
|
the online information of the message for recovery help. Use the topic <a href="addlicpgm.htm#addlicpgm">Installing additional licensed programs</a> to install the licensed program.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.934010152284262%" headers="d0e125 d0e128 ">Media error messages</td>
|
|
<td align="left" valign="top" width="71.06598984771574%" headers="d0e125 d0e130 "><p><strong>Cause:</strong> A media error occurred during
|
|
the installation process.</p>
|
|
<p><strong>Recovery:</strong> 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.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzahctroubleshoot.htm" title="This information describes common problem scenarios, recovery methods, and ways to get help if you encounter a problem during software installation.">Troubleshooting software installation problems</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |