friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
master
ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzahc_5.4.0.1/rzahclicprg.htm

309 lines
18 KiB
HTML
Raw Permalink Normal View History

Add readme and dist folders
2024-04-02 14:02:31 +00:00
<?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>
Reference in New Issue Copy Permalink