968 lines
28 KiB
HTML
968 lines
28 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
|
|
<title>Create Product Definition (QSZCRTPD) API</title>
|
|
<!-- Begin Header Records ========================================== -->
|
|
<!-- 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. -->
|
|
<!-- QSZCRTPD SCRIPT A converted by B2H R4.1 (346) (CMS) by KENTALA -->
|
|
<!-- at RCHVMW2 on 7 Oct 1998 at 18:11:46 -->
|
|
<!-- Change History: -->
|
|
<!-- YYMMDD USERID Change description -->
|
|
<!-- Edited by Kersten Jan 02 -->
|
|
<!--End Header Records -->
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body>
|
|
<a name="Top_Of_Page"></a>
|
|
<!-- Java sync-link -->
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript">
|
|
</script>
|
|
|
|
<h2>Create Product Definition (QSZCRTPD) API</h2>
|
|
|
|
<div class="box" style="width: 80%;">
|
|
<br>
|
|
Required Parameter Group:<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
<table width="100%">
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">1</td>
|
|
<td align="left" valign="top" width="50%">Qualified product definition
|
|
name</td>
|
|
<td align="left" valign="top" width="20%">Input</td>
|
|
<td align="left" valign="top" width="20%">Char(20)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">2</td>
|
|
<td align="left" valign="top">Product definition information</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(106)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">3</td>
|
|
<td align="left" valign="top">Product option list</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Array of Char(41)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="left" valign="top">Number of product options</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Binary(4)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">5</td>
|
|
<td align="left" valign="top">Language load list</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Array of Char(20)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">6</td>
|
|
<td align="left" valign="top">Number of language loads</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Binary(4)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">7</td>
|
|
<td align="left" valign="top">Text description</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(50)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">8</td>
|
|
<td align="left" valign="top">Public authority</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(10)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">9</td>
|
|
<td align="left" valign="top">Error code</td>
|
|
<td align="left" valign="top">I/O</td>
|
|
<td align="left" valign="top">Char(*)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
Default Public Authority: *USE<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
Threadsafe: No<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
</div>
|
|
|
|
<p>The Create Product Definition (QSZCRTPD) API creates a product definition
|
|
(*PRDDFN) object. Each release of a packaged software product requires one
|
|
product definition.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3>Authorities and Locks</h3>
|
|
|
|
<dl>
|
|
<dt><em>Library Authority</em></dt>
|
|
|
|
<dd>*ADD and *READ<br>
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><em>Library Lock</em></dt>
|
|
|
|
<dd>*SHRUPD<br>
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><em>Product Availability Lock</em></dt>
|
|
|
|
<dd>*SHRRD. The product availability object resides in the QUSRSYS
|
|
library.</dd>
|
|
</dl>
|
|
|
|
<br>
|
|
|
|
|
|
<h3>Required Parameter Group</h3>
|
|
|
|
<dl>
|
|
<dt><strong>Qualified product definition name</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(20)
|
|
|
|
<p>The first 10 characters contain the product definition name. The second 10
|
|
characters contain the name of the library into which the product definition is
|
|
to be created.</p>
|
|
|
|
<p>The following special value is supported for the library name:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CURLIB</em></td>
|
|
<td align="left" valign="top">The job's current library</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>Product definition information</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(106)
|
|
|
|
<p>A structure containing information about the product. For more information,
|
|
see <a href="#HDRPDINFO">Format of Product Definition Information</a>.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Product option list</strong></dt>
|
|
|
|
<dd>INPUT; ARRAY of CHAR(41)
|
|
|
|
<p>An array containing information for each of the options defined for the
|
|
product. Each element of the array contains information for one option. There
|
|
must be one element of the array for each option. The first element of the
|
|
array must be for the base (0000) option. The required data for the product
|
|
option list is described in <a href="#HDRPRDOPT">Format of Product Option
|
|
List</a>.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Number of product options</strong></dt>
|
|
|
|
<dd>INPUT; BINARY(4)
|
|
|
|
<p>The number of options defined for the product. This number is the same as
|
|
the number of elements in the product option list parameter. Up to 100 product
|
|
options can be specified. If the number of elements in the product option list
|
|
is less than the value specified, the results are unpredictable.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Language load list</strong></dt>
|
|
|
|
<dd>INPUT; ARRAY of CHAR(20)
|
|
|
|
<p>Specifies which languages are defined for the product options. The required
|
|
data for the language load list is described in <a href="#HDRLNGLOD">Format of
|
|
Language Load List</a>.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Number of language loads</strong></dt>
|
|
|
|
<dd>INPUT; BINARY(4)
|
|
|
|
<p>The number of elements in the language load list parameter. If the number of
|
|
elements in the language load list parameter is less than the value specified,
|
|
the results are unpredictable. The valid range is 1 to 139.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Text description</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(50)
|
|
|
|
<p>Text that briefly describes the product definition object.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Public authority</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(10)
|
|
|
|
<p>The authority you give to users who do not have specific authority to the
|
|
product definition object and whose group profile has no specific authority to
|
|
the object.</p>
|
|
|
|
<p>Valid values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">Allows the user to perform all operations on the object except
|
|
those limited to the owner or controlled by the authorization list management
|
|
authority.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CHANGE</em></td>
|
|
<td align="left" valign="top">Allows the user to perform all operations on the object except
|
|
those limited to the owner or controlled by the object existence authority and
|
|
object management authority.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*EXCLUDE</em></td>
|
|
<td align="left" valign="top">Prevents the user from accessing the object.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*LIBCRTAUT</em></td>
|
|
<td align="left" valign="top">The public authority for the object is taken from the value of
|
|
the create authority (CRTAUT) parameter of the target library. (This is the
|
|
library that is to contain the object.) This value is determined when the
|
|
object is created. If the CRTAUT value for the library changes after the object
|
|
is created, the new value does not affect any existing objects.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*USE</em></td>
|
|
<td align="left" valign="top">Provides object operational authority and read authority.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>Error code</strong></dt>
|
|
|
|
<dd>I/O; CHAR(*)
|
|
|
|
<p>The structure in which to return error information. For the format of the
|
|
structure, see <a href="../apiref/error.htm#hdrerrcod">Error Code Parameter</a>.</p>
|
|
</dd>
|
|
</dl>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRPDINFO">Format of Product Definition Information</a></h3>
|
|
|
|
<p>The following table describes the order and format of the product definition
|
|
information parameter. For detailed descriptions of fields in the table, see
|
|
the <a href="#HDRCRTPLFD">Field Descriptions</a>.</p>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="center" valign="bottom">Dec</th>
|
|
<th align="center" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="left" valign="top" width="20%">CHAR(7)</td>
|
|
<td align="left" valign="top" width="60%">Product ID</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">7</td>
|
|
<td align="center" valign="top">7</td>
|
|
<td align="left" valign="top">CHAR(6)</td>
|
|
<td align="left" valign="top">Release level</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">13</td>
|
|
<td align="center" valign="top">D</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Message file</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">23</td>
|
|
<td align="center" valign="top">17</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">First copyright</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">33</td>
|
|
<td align="center" valign="top">21</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Current copyright</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">43</td>
|
|
<td align="center" valign="top">2B</td>
|
|
<td align="left" valign="top">CHAR(6)</td>
|
|
<td align="left" valign="top">Release date</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">49</td>
|
|
<td align="center" valign="top">31</td>
|
|
<td align="left" valign="top">CHAR(4)</td>
|
|
<td align="left" valign="top">Allow multiple releases</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">53</td>
|
|
<td align="center" valign="top">35</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Registration ID type</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">63</td>
|
|
<td align="center" valign="top">3F</td>
|
|
<td align="left" valign="top">CHAR(14)</td>
|
|
<td align="left" valign="top">Registration ID value</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">77</td>
|
|
<td align="center" valign="top">4D</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Release date century</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">78</td>
|
|
<td align="center" valign="top">4E</td>
|
|
<td align="left" valign="top">CHAR(28)</td>
|
|
<td align="left" valign="top">Reserved</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRPRDOPT">Format of Product Option List</a></h3>
|
|
|
|
<p>Up to 100 product options can be specified. The first option specified must
|
|
be 0000 (the base option). The product option list parameter is described in
|
|
the table below. The offsets shown in the table are for the first element in
|
|
this array. For detailed descriptions of fields in the table, see the <a href=
|
|
"#HDRCRTPLFD">Field Descriptions</a>.</p>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="center" valign="bottom">Dec</th>
|
|
<th align="center" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="left" valign="top" width="20%">CHAR(4)</td>
|
|
<td align="left" valign="top" width="60%">Product option number</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="left" valign="top">CHAR(7)</td>
|
|
<td align="left" valign="top">Message ID</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">11</td>
|
|
<td align="center" valign="top">B</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Allow dynamic naming</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">21</td>
|
|
<td align="center" valign="top">15</td>
|
|
<td align="left" valign="top">CHAR(4)</td>
|
|
<td align="left" valign="top">Code load ID</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">25</td>
|
|
<td align="center" valign="top">19</td>
|
|
<td align="left" valign="top">CHAR(16)</td>
|
|
<td align="left" valign="top">Reserved</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRLNGLOD">Format of Language Load List</a></h3>
|
|
|
|
<p>Up to 40 language loads can be specified for the base (0000) option. A
|
|
maximum of 139 total can be specified. The language load list field is
|
|
described in the table below. The offsets shown in the table are for the first
|
|
element in this array. For detailed descriptions of fields in the table, see
|
|
the <a href="#HDRCRTPLFD">Field Descriptions</a>.</p>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="center" valign="bottom">Dec</th>
|
|
<th align="center" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="left" valign="top" width="20%">CHAR(8)</td>
|
|
<td align="left" valign="top" width="60%">Language load ID</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">8</td>
|
|
<td align="center" valign="top">8</td>
|
|
<td align="left" valign="top">CHAR(4)</td>
|
|
<td align="left" valign="top">Product option number</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">12</td>
|
|
<td align="center" valign="top">C</td>
|
|
<td align="left" valign="top">CHAR(8)</td>
|
|
<td align="left" valign="top">Reserved</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRCRTPLFD">Field Descriptions</a></h3>
|
|
|
|
<p><strong>Allow dynamic naming.</strong> Allow libraries and root folders to
|
|
be named during installation of the product option.</p>
|
|
|
|
<p>Valid values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NODYNNAM</em></td>
|
|
<td align="left" valign="top">Do not allow naming of libraries and folders during
|
|
installation.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALWDYNNAM</em></td>
|
|
<td align="left" valign="top">Allow naming of libraries and root folders during
|
|
installation.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Allow multiple releases.</strong> Allow different releases of this
|
|
product to be installed on the same system.</p>
|
|
|
|
<p>Valid values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NO</em></td>
|
|
<td align="left" valign="top">Do not allow multiple releases.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*YES</em></td>
|
|
<td align="left" valign="top">Allow multiple releases.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Code load ID.</strong> The identifier of the code load for the
|
|
option. Valid values are 5001 through 9999. For all product options that are
|
|
part of the same feature, specify the same code load ID. If you are not adding
|
|
license information to your product, you should use 5001 for the code load ID
|
|
for each option. The code load ID you specify for this option must be the same
|
|
as the load ID specified when you create the code product load for this option.
|
|
See <a href="qszcrtpl.htm">Create Product Load (QSZCRTPL) API</a> for
|
|
information about creating product loads.</p>
|
|
|
|
<p><strong>Current copyright.</strong> The year of the most recent copyright
|
|
for this product. The year must be specified as a 4-digit number, such as 1990.
|
|
The field must be padded with blanks. If this field and the first copyright
|
|
field have values other than *NONE, the first copyright field must be less than
|
|
the current copyright field.</p>
|
|
|
|
<p>The following special values are valid:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CURRENT</em></td>
|
|
<td align="left" valign="top">The current year is used.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NONE</em></td>
|
|
<td align="left" valign="top">The product does not have a current copyright.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>First copyright.</strong> The first year that the product was
|
|
copyrighted. The year must be specified as a 4-digit number, such as 1990. The
|
|
field must be padded with blanks.</p>
|
|
|
|
<p>The following special values are valid:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CURRENT</em></td>
|
|
<td align="left" valign="top">The current year is used.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NONE</em></td>
|
|
<td align="left" valign="top">The product does not have a first copyright.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Language load ID.</strong> The national language versions (NLVs)
|
|
that are valid for a given product option. Individual NLVs may be specified for
|
|
the base option, with one element of the language load list parameter for each
|
|
NLV for the base option. For options other than the base option, only *BASEOPT
|
|
and *NONE are valid. For example, to create a product definition with NLVs 2924
|
|
and 2931 defined for both the base option and option 1, the language load list
|
|
would have three elements:</p>
|
|
|
|
<ul>
|
|
<li>One with 2924 0000.</li>
|
|
|
|
<li>One with 2931 0000.</li>
|
|
|
|
<li>One with *BASEOPT 0001.</li>
|
|
</ul>
|
|
|
|
<p>Valid special values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NONE</em></td>
|
|
<td align="left" valign="top">Defines the option to have no NLVs.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*IBMLNG</em></td>
|
|
<td align="left" valign="top">Only valid for the base option, 0000. Specifies the product
|
|
definition is created with the list of all the NLVs for the base option the
|
|
same as the currently installed operating system.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*BASEOPT</em></td>
|
|
<td align="left" valign="top">Only valid for an option other than 0000. Defines this option
|
|
to have the same NLVs as the base option of this product.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Message file.</strong> The name of the message file containing the
|
|
messages that describe the product and its options. The message file for the
|
|
base option is considered the message file for the product.</p>
|
|
|
|
<p><strong>Message ID.</strong> The identifier of the message that describes
|
|
the product option.</p>
|
|
|
|
<p><strong>Product ID.</strong> The 7-character identifier of the product for
|
|
which a product definition is being created. The product ID must be in the
|
|
format <em>nlxxxxx</em>, where <em>n</em> is any numeric character 0 through 9.
|
|
The <em>l</em> is any uppercase letter A through Z, and <em>x</em> is any
|
|
numeric character 0 through 9 or uppercase letter A through Z.</p>
|
|
|
|
<p><strong>Product option number.</strong> The identifier of the product
|
|
option.</p>
|
|
|
|
<p>When used in the product option list parameter, valid values are 0000
|
|
through 0099, with each number specified at most once. Specify 0000 for the
|
|
base product option. The value 0000 must be the first option specified.</p>
|
|
|
|
<p>When used in the language load list parameter, this is the identifier for
|
|
the product option for which NLVs are being defined. This must be one of the
|
|
options specified on the product option list parameter.</p>
|
|
|
|
<p><strong>Registration ID type.</strong> Specifies what the registration ID
|
|
value field represents.</p>
|
|
|
|
<p>Valid values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*PHONE</em></td>
|
|
<td align="left" valign="top">Telephone number will be entered in the registration ID value
|
|
field.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CUSTOMER</em></td>
|
|
<td align="left" valign="top">Country or region code and IBM customer number will be entered in the
|
|
registration ID value field.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Registration ID value.</strong> The identifier of the organization
|
|
to which the product belongs. This number should be unique from other vendors
|
|
on the systems on which this product will be installed. It is recommended you
|
|
specify a telephone number (including the country or region code and city code) or your
|
|
IBM customer number appended to your country or region code. Valid characters for the
|
|
registration ID value are A through Z and 0 through 9, padded with blanks on
|
|
the right.</p>
|
|
|
|
<p><strong>Release date.</strong> Release date of the product. The format is
|
|
yymmdd, where yy is the year, mm is the month, and dd is the day.</p>
|
|
|
|
<p>The following special value is valid for the release date:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NONE</em></td>
|
|
<td align="left" valign="top">The product does not have a release date.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Release date century.</strong> The century that corresponds to the
|
|
release date of the product. This field is ignored if *NONE is specified for
|
|
release date.</p>
|
|
|
|
<p>Possible values follow:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">Indicates years 19<em>xx</em></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">Indicates years 20<em>xx</em></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>Blank</em></td>
|
|
<td align="left" valign="top">The release date century is set to 0 if the release date year
|
|
is equal to or greater than 40 (years 1940 through 1999); it is set to 1 if the
|
|
release date year is less than 40 (years 2000 through 2039).</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Release level.</strong> The version, release, and modification level
|
|
of the product being created in the format V<em>x</em>R<em>y</em>M<em>z</em>.
|
|
Valid values for <em>x</em> and <em>y</em> are 0 through 9. Valid values for
|
|
<em>z</em> are 0 through 9 or A through Z. For example, V2R1M0 is Version 2,
|
|
Release 1, Modification 0.</p>
|
|
|
|
<p><strong>Reserved.</strong> This field must contain blank characters;
|
|
otherwise, an error occurs.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3>Error Messages</h3>
|
|
|
|
<table width="100%" cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<th align="left" valign="top">Message ID</th>
|
|
<th align="left" valign="top">Error Message Text</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td width="15%" valign="top">CPF0CAA E</td>
|
|
<td width="85%" valign="top">First product option not *BASE.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0CAB E</td>
|
|
<td align="left" valign="top">Language load identifier not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0CAC E</td>
|
|
<td align="left" valign="top">Language load identifier not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0CAD E</td>
|
|
<td align="left" valign="top">Duplicate language load identifier specified.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0CAE E</td>
|
|
<td align="left" valign="top">Language load not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0CAF E</td>
|
|
<td align="left" valign="top">Duplicate option &3 specified.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0CA3 E</td>
|
|
<td align="left" valign="top">Code load &4 supported.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0CA6 E</td>
|
|
<td align="left" valign="top">Product definition &3 not created in library &4.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0CBA E</td>
|
|
<td align="left" valign="top">Number of options parameter not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0CBB E</td>
|
|
<td align="left" valign="top">Release date &3 not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0CBC E</td>
|
|
<td align="left" valign="top">Message identifier &4 not allowed.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0CBD E</td>
|
|
<td align="left" valign="top">Code load ID &9 not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0CBE E</td>
|
|
<td align="left" valign="top">Release date century field not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0CB0 E</td>
|
|
<td align="left" valign="top">Copyright dates not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0CB1 E</td>
|
|
<td align="left" valign="top">Registration identifier not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0CB2 E</td>
|
|
<td align="left" valign="top">Product identifier &1 not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0CB3 E</td>
|
|
<td align="left" valign="top">Value for reserved field not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0CB5 E</td>
|
|
<td align="left" valign="top">Copyright field &3 not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0CB6 E</td>
|
|
<td align="left" valign="top">Allow multiple releases field not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0CB7 E</td>
|
|
<td align="left" valign="top">Allow dynamic naming field not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0CB8 E</td>
|
|
<td align="left" valign="top">Language load field not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0CB9 E</td>
|
|
<td align="left" valign="top">Number of language loads parameter not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C16 E</td>
|
|
<td align="left" valign="top">Object &1 type &3 already exists in library
|
|
&2.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C17 E</td>
|
|
<td align="left" valign="top">*&3 object already exists for product &4 release
|
|
&5.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C18 E</td>
|
|
<td align="left" valign="top">Registration identifier &7 not valid for product &4
|
|
release &5.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C19 E</td>
|
|
<td align="left" valign="top">Damage occurred on object &1 in library &2.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C4A E</td>
|
|
<td align="left" valign="top">Product record not found.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C4D E</td>
|
|
<td align="left" valign="top">Error occurred while processing object &1 in library
|
|
&2.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C8A E</td>
|
|
<td align="left" valign="top">Product option &1 not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C84 E</td>
|
|
<td align="left" valign="top">Load identifier &4 not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C86 E</td>
|
|
<td align="left" valign="top">Registration identifier not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C9B E</td>
|
|
<td align="left" valign="top">Authority &1 not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF24B4 E</td>
|
|
<td align="left" valign="top">Severe error while addressing parameter list.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3CF1 E</td>
|
|
<td align="left" valign="top">Error code parameter not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C29 E</td>
|
|
<td align="left" valign="top">Object name &1 is not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C90 E</td>
|
|
<td align="left" valign="top">Literal value cannot be changed.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF35E3 E</td>
|
|
<td align="left" valign="top">Interface error detected.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF358A E</td>
|
|
<td align="left" valign="top">Release not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9810 E</td>
|
|
<td align="left" valign="top">Library &1 not found.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9818 E</td>
|
|
<td align="left" valign="top">Object &2 in library &3 not created.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9819 E</td>
|
|
<td align="left" valign="top">Object &2 in library &3 not created.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9820 E</td>
|
|
<td align="left" valign="top">Not authorized to use library &1.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9830 E</td>
|
|
<td align="left" valign="top">Cannot assign library &1.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9872 E</td>
|
|
<td align="left" valign="top">Program or service program &1 in library &2 ended.
|
|
Reason code &3.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<hr>
|
|
API introduced: V4R4
|
|
|
|
<hr>
|
|
<center>
|
|
<table cellpadding="2" cellspacing="2">
|
|
<tr align="center">
|
|
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href=
|
|
"sw1.htm">Software Product APIs</a> | <a href="aplist.htm">APIs by
|
|
category</a></td>
|
|
</tr>
|
|
</table>
|
|
</center>
|
|
</body>
|
|
</html>
|
|
|