1820 lines
53 KiB
HTML
1820 lines
53 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 Load (QSZCRTPL) 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. -->
|
|
<!-- QSZCRTPL SCRIPT A converted by B2H R4.1 (346) (CMS) by KENTALA -->
|
|
<!-- at RCHVMW2 on 7 Oct 1998 at 18:14:08 -->
|
|
<!-- Change History: -->
|
|
<!-- YYMMDD USERID Change description -->
|
|
<!-- File cleanup completed Feb 2002 by v2cdijab -->
|
|
<!-- 031023 Update directory limit -->
|
|
<!-- 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 Load (QSZCRTPL) 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%">Product load name</td>
|
|
<td align="left" valign="top" width="15%">Input</td>
|
|
<td align="left" valign="top" width="25%">Char(10)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">2</td>
|
|
<td align="left" valign="top">Product load information</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(87)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">3</td>
|
|
<td align="left" valign="top">Secondary language library name</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(10)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="left" valign="top">Principal library information</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(30)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">5</td>
|
|
<td align="left" valign="top">Additional library list</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Array of Char(30)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">6</td>
|
|
<td align="left" valign="top">Number of additional libraries</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">Preoperation exit programs</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">8</td>
|
|
<td align="left" valign="top">Number of preoperation exit programs</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Binary(4)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">9</td>
|
|
<td align="left" valign="top">Folder list</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Array of Char(126)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">10</td>
|
|
<td align="left" valign="top">Number of folders</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Binary(4)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">11</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">12</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">13</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>
|
|
Optional Parameter Group 1:<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
<table width="100%">
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">14</td>
|
|
<td align="left" valign="top" width="50%">Directory list</td>
|
|
<td align="left" valign="top" width="15%">Input</td>
|
|
<td align="left" valign="top" width="25%">Array of Char(*)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">15</td>
|
|
<td align="left" valign="top">Number of directories</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Binary(4)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">16</td>
|
|
<td align="left" valign="top">Directory list format name</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(8)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
Optional Parameter Group 2:<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
<table width="100%">
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">17</td>
|
|
<td align="left" valign="top" width="50%">Software agreement document list</td>
|
|
<td align="left" valign="top" width="15%">Input</td>
|
|
<td align="left" valign="top" width="25%">Array of Char(*)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">18</td>
|
|
<td align="left" valign="top">Number of software agreement documents</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Binary(4)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
Default Public Authority: *EXCLUDE<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
Threadsafe: No<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
</div>
|
|
|
|
<p>The Create Product Load (QSZCRTPL) API creates a product load (*PRDLOD)
|
|
object. Each release of a software product requires one or more product load
|
|
objects.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3>Authorities and Locks</h3>
|
|
|
|
<dl>
|
|
<dt><em>Library Authority</em></dt>
|
|
|
|
<dd>*ADD and *READ</dd>
|
|
|
|
<dt><em>Library Lock</em></dt>
|
|
|
|
<dd>*SHRUPD</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>Product load name</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(10)
|
|
|
|
<p>The name of the product load object to be created. The product load is
|
|
created into the principal development library. The following special value is
|
|
valid:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*LNG</em></td>
|
|
<td align="left" valign="top">The name of the load object is the same as the
|
|
previously created language load object for this product; version, release, and
|
|
modification level; and option. This special value is only valid if a language
|
|
product load is being created.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>Product load information</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(87)
|
|
|
|
<p>A structure containing information about the product load. For more
|
|
information, see the <a href="#HDRPLINFO">Format of Product Load
|
|
Information</a>.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Secondary language library name</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(10)
|
|
|
|
<p>The name of the secondary language library for the language product load
|
|
being created. This is the library into which this product load is installed
|
|
if:</p>
|
|
|
|
<ul>
|
|
<li>The language identifier for this product load does not match the system
|
|
primary language identifier.</li>
|
|
|
|
<li>No override name is specified on the Restore Licensed Program (RSTLICPGM)
|
|
command.</li>
|
|
</ul>
|
|
|
|
<p>This field is valid only if a language product load is being created.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Principal library information</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(30)
|
|
|
|
<p>The first 10 characters specify the principal development library. The
|
|
second 10 characters specify the principal primary library. The last 10
|
|
characters specify the postoperation exit program for both principal libraries.
|
|
For more information, see <a href="#HDRPLPRINC">Format of Principal Library
|
|
Information</a>.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Additional library list</strong></dt>
|
|
|
|
<dd>INPUT; ARRAY of CHAR(30)
|
|
|
|
<p>The additional libraries for the product load. Additional libraries do not
|
|
need to exist before the product load object is created.</p>
|
|
|
|
<p>For each element:</p>
|
|
|
|
<ul>
|
|
<li>The first 10 characters specify the development library.</li>
|
|
|
|
<li>The second 10 characters specify the primary library.</li>
|
|
|
|
<li>The last 10 characters specify the postoperation exit program for both
|
|
libraries.</li>
|
|
</ul>
|
|
|
|
<p>For more information, see <a href="#HDRPLADLLL">Format of Additional Library
|
|
List</a>.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Number of additional libraries</strong></dt>
|
|
|
|
<dd>INPUT; BINARY(4)
|
|
|
|
<p>The number of elements in the additional library list. If the number of
|
|
elements in the additional library list is less than the value specified, the
|
|
results are unpredictable.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Preoperation exit programs</strong></dt>
|
|
|
|
<dd>INPUT; ARRAY of CHAR(20)
|
|
|
|
<p>The preoperation exit programs for this load. The first 10 characters
|
|
specify the exit program name. The second 10 characters specify the development
|
|
library name. For more information, see <a href="#HDRPLPREEP">Format of
|
|
Preoperation Exit Programs</a>.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Number of preoperation exit programs</strong></dt>
|
|
|
|
<dd>INPUT; BINARY(4)
|
|
|
|
<p>The number of elements in the preoperation exit programs array. If the
|
|
number of elements in the preoperation exit programs parameter is less than the
|
|
value specified, the results are unpredictable.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Folder list</strong></dt>
|
|
|
|
<dd>INPUT; ARRAY of CHAR(126)
|
|
|
|
<p>The folders for this product load. When creating a code load, the first
|
|
folder specified must be a root folder. When creating a language load, the
|
|
first folder specified must be a subfolder of a root folder. The folders do not
|
|
need to exist before the product load object is created.</p>
|
|
|
|
<p>Each product option has at most one root folder. A folder cannot belong to
|
|
more than one product option. The root folder must be part of the code load.
|
|
Folders must be specified so that a parent folder precedes its subfolder on the
|
|
list.</p>
|
|
|
|
<p>The number of folders must be zero if the number of directories names in the
|
|
directory list parameter is greater than zero.</p>
|
|
|
|
<p>A maximum of 100 folders can be specified for a load.</p>
|
|
|
|
<p>The documents in the development folders are saved when the product load is
|
|
saved with the Save Licensed Program (SAVLICPGM) command. For more information,
|
|
refer to the <a href="../books/sc415321.pdf">System Manager Use</a> book
|
|
<img src="wbpdf.gif" alt="Link to PDF">.</p>
|
|
|
|
<p>For each element of the folder list, the first 63 characters specify the
|
|
development folder and the next 63 characters specify the primary folder. For
|
|
more information, see <a href="#HDRPLFLRL">Format of Folder List</a>.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Number of folders</strong></dt>
|
|
|
|
<dd>INPUT; BINARY(4)
|
|
|
|
<p>The number of elements in the folder list array. If the number of elements
|
|
in the folder list is less than the value specified, the results are
|
|
unpredictable.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Text description</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(50)
|
|
|
|
<p>Text that briefly describes the product load object.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Public authority</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(10)
|
|
|
|
<p>The authority you give to users:</p>
|
|
|
|
<ul>
|
|
<li>Who do not have specific authority to the product load object.</li>
|
|
|
|
<li>Whose group profile has no specific authority to the object.</li>
|
|
</ul>
|
|
|
|
<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:<br>
|
|
<ul>
|
|
<li>Limited to the owner.</li>
|
|
|
|
<li>Controlled by the object existence authority and object management
|
|
authority.</li>
|
|
</ul>
|
|
</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>Optional Parameter Group 1</h3>
|
|
|
|
<dl>
|
|
<dt><strong>Directory list</strong></dt>
|
|
|
|
<dd>INPUT;CHAR(*)
|
|
|
|
<p>The directories for this product load. You cannot specify directory names if
|
|
any folder names are specified in the folder list parameter. A maximum of
|
|
300 home directories and a total of 5000 directory full path names
|
|
can be specified for a load. For more information,
|
|
see <a href="#HDRDIRI0100">DIRI0100 Format</a>.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Number of directories</strong></dt>
|
|
|
|
<dd>INPUT;BINARY(4)
|
|
|
|
<p>The number of elements in the directory list array. If the number of
|
|
elements in the directory list is less than the value specified, the results
|
|
are unpredictable.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Directory list format name</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(8)
|
|
|
|
<p>The name of the format containing the directory list. The format name
|
|
is:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>DIRI0100</em></td>
|
|
<td align="left" valign="top">See <a href="#HDRDIRI0100">DIRI0100
|
|
Format</a>.</td>
|
|
</tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
<br>
|
|
|
|
|
|
<h3>Optional Parameter Group 2</h3>
|
|
|
|
<dl>
|
|
<dt><strong>Software agreement document list</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(*)
|
|
|
|
<p>The software agreement documents for this product option. The software
|
|
agreement documents do not need to exist before the product load object is
|
|
created. The software agreement documents must be created into a directory in
|
|
'/QIBM/UserData/LicenseDoc' prior to successfully packaging the product option.
|
|
For more information, see <a href="#SAFORMAT">Format of Software Agreement
|
|
Document List</a>.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Number of software agreement documents</strong></dt>
|
|
|
|
<dd>INPUT; BINARY(4)
|
|
|
|
<p>The number of elements in the software agreement document list array. There
|
|
must be a minimum of one and a maximum of ten for software agreements to be
|
|
enabled for a product load. If the number of elements in the software agreement
|
|
document list is less than the value specified, the results are
|
|
unpredictable.</p>
|
|
</dd>
|
|
</dl>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRPLINFO">Format of Product Load Information</a></h3>
|
|
|
|
<p>The product load information parameter is described in the following table.
|
|
For a detailed description of the fields in the table, see <a href=
|
|
"#HDRCRTPLF2">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(4)</td>
|
|
<td align="left" valign="top">Product option</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">17</td>
|
|
<td align="center" valign="top">11</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Product load type</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">27</td>
|
|
<td align="center" valign="top">1B</td>
|
|
<td align="left" valign="top">CHAR(8)</td>
|
|
<td align="left" valign="top">Load ID</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">35</td>
|
|
<td align="center" valign="top">23</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">45</td>
|
|
<td align="center" valign="top">2D</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">59</td>
|
|
<td align="center" valign="top">3B</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Minimum target release</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">69</td>
|
|
<td align="center" valign="top">45</td>
|
|
<td align="left" valign="top">CHAR(18)</td>
|
|
<td align="left" valign="top">Reserved</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRPLPRINC">Format of Principal Library Information</a></h3>
|
|
|
|
<p>The principal library information parameter is described in the following
|
|
table. For a detailed description of the fields in the table, see <a href=
|
|
"#HDRCRTPLF2">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(10)</td>
|
|
<td align="left" valign="top" width="60%">Principal development library
|
|
name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">10</td>
|
|
<td align="center" valign="top">A</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Principal primary library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">20</td>
|
|
<td align="center" valign="top">14</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Postoperation exit program name</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRPLADLLL">Format of Additional Library List</a></h3>
|
|
|
|
<p>The following table describes the additional library list parameter. The
|
|
offsets shown in the table are for the first element in this array. For a
|
|
detailed description of the fields in the table, see <a href="#HDRCRTPLF2">
|
|
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(10)</td>
|
|
<td align="left" valign="top" width="60%">Additional development library
|
|
name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">10</td>
|
|
<td align="center" valign="top">A</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Additional primary library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">20</td>
|
|
<td align="center" valign="top">14</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Postoperation exit program name</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRPLPREEP">Format of Preoperation Exit Programs</a></h3>
|
|
|
|
<p>The following table describes the preoperation exit programs parameter. The
|
|
offsets shown in the table are for the first element in this array. For a
|
|
detailed description of the fields in the table, see <a href="#HDRCRTPLF2">
|
|
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(10)</td>
|
|
<td align="left" valign="top" width="60%">Preoperation exit program name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">10</td>
|
|
<td align="center" valign="top">A</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Development library name</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRPLFLRL">Format of Folder List</a></h3>
|
|
|
|
<p>The following table describes the folder list parameter. The offsets shown
|
|
in the table are for the first element in this array. For a detailed
|
|
description of the fields in the table, see <a href="#HDRCRTPLF2">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(63)</td>
|
|
<td align="left" valign="top" width="60%">Development folder</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">63</td>
|
|
<td align="center" valign="top">3F</td>
|
|
<td align="left" valign="top">CHAR(63)</td>
|
|
<td align="left" valign="top">Primary folder</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRDIRI0100">DIRI0100 Format</a></h3>
|
|
|
|
<p>The following table describes the directory list parameter. The offsets
|
|
shown in the table are for the first element in this array. The decimal and
|
|
hexadecimal offsets to subsequent entries are determined by using the length of
|
|
the full path length field, the length of the home directory length field, and
|
|
the value of the full path length field. For a detailed description of the
|
|
fields in the table, see <a href="#HDRCRTPLF2">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%">BINARY(4)</td>
|
|
<td align="left" valign="top" width="60%">Full path length</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Home directory length</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">8</td>
|
|
<td align="center" valign="top">8</td>
|
|
<td align="left" valign="top">CHAR(*)</td>
|
|
<td align="left" valign="top">Full path name</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="SAFORMAT">Format of Software Agreement Document List</a></h3>
|
|
|
|
<p>The following table describes the software agreement document list
|
|
parameter. The offsets shown in the table are for the first element in this
|
|
array. For a detailed description of the fields in the table, see <a href=
|
|
"#HDRCRTPLF2">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%">BINARY(4)</td>
|
|
<td align="left" valign="top" width="60%">Software agreement document
|
|
length</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">8</td>
|
|
<td align="center" valign="top">8</td>
|
|
<td align="left" valign="top">CHAR(*)</td>
|
|
<td align="left" valign="top">Software agreement document name</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRCRTPLF2">Field Descriptions</a></h3>
|
|
|
|
<strong>Additional development library name.</strong> The name of the
|
|
additional development library.
|
|
|
|
<p><strong>Additional primary library name.</strong> The additional primary
|
|
library name. Valid special values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*DVLLIB</em></td>
|
|
<td align="left" valign="top">The development library name is used as the
|
|
primary library name.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CODE</em></td>
|
|
<td align="left" valign="top">The additional primary library in the code load
|
|
corresponding to the immediately preceding development library is used. This
|
|
value is valid only when the product load type is specified as *LNG in the
|
|
product load information parameter.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Development folder.</strong> The name of a development folder for
|
|
this load. The folder does not need to exist before the product load object is
|
|
created.</p>
|
|
|
|
<p><strong>Development library name.</strong> The development library with
|
|
which the preoperation exit program is associated. The preoperation exit
|
|
program may be associated with the principal library or an additional library.
|
|
If associated with the principal library, this must be the same as the value
|
|
for the principal development library in the principal library information
|
|
parameter. If associated with an additional library, this must be the same as
|
|
one of the values for the additional development library in the additional
|
|
library list parameter. Valid special values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*PRDDFN</em></td>
|
|
<td align="left" valign="top">Specify this value if:<br>
|
|
<ul>
|
|
<li>You want the preoperation exit program to be associated with the principal
|
|
development library.</li>
|
|
|
|
<li>You specified *PRDDFN for the principal development library field of the
|
|
principal library information parameter.
|
|
|
|
<p>This is only valid when *PRDDFN is specified for the principal development
|
|
library in the principal library information parameter.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CODE</em></td>
|
|
<td align="left" valign="top">Specify this value if you want the preoperation
|
|
exit program to be associated with the principal development library and if you
|
|
specified *CODE as the principal development library field of the principal
|
|
library information parameter. This is only valid when *CODE is specified for
|
|
the principal development library in the principal library information
|
|
parameter.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Full path length.</strong> The length of the full path name, in
|
|
bytes.</p>
|
|
|
|
<p><strong>Full path name.</strong> The fully qualified directory name assigned
|
|
to this product load. Naming restrictions for directories assigned to a product
|
|
load include:</p>
|
|
|
|
<ul>
|
|
<li>You cannot specify /QSYS.LIB and /QDLS directories.</li>
|
|
|
|
<li>You must specify unique full path names.</li>
|
|
|
|
<li>You cannot end the path name with a forward slash.</li>
|
|
|
|
<li>You cannot use the "." or ".." directories in the path name.</li>
|
|
|
|
<li>You cannot use "//" in the directory path name.</li>
|
|
</ul>
|
|
|
|
<p><strong>Home directory length.</strong> The length of the home directory
|
|
part of the full path name.</p>
|
|
|
|
<p><strong>Load ID.</strong> The load ID of the product load to be created. For
|
|
language loads, this must be a valid national language version (NLV). The
|
|
following special value is valid:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CODEDFT</em></td>
|
|
<td align="left" valign="top">The default code load ID, 5001, is used. This
|
|
value is valid only when the product load type field is *CODE.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Minimum target release.</strong> The minimum release of the
|
|
operating system to which the SAVLICPGM command allows the product to be saved.
|
|
The format is V<em>x</em>R<em>y</em>M<em>z</em>. Valid values for <em>x</em>,
|
|
<em>y</em>, and <em>z</em> are 0 through 9. For example, V3R1M0 is Version 3,
|
|
Release 1, Modification 0. If this field is blank, the version, release, and
|
|
modification level of the operating system is used. This value may be different
|
|
for each load, however, the code load must specify the earliest release for a
|
|
given option. Also, the code load for the base option must specify the earliest
|
|
release for a given product. Valid special values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CURRENT</em></td>
|
|
<td align="left" valign="top">The version, release, and modification level of
|
|
the operating system is used.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*PRV</em></td>
|
|
<td align="left" valign="top">The version, release, and modification level
|
|
previous to that of the operating system is used. Previous is the previous
|
|
release with modification level 0 of the operating system.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CODE</em></td>
|
|
<td align="left" valign="top">The minimum target release of the code load for
|
|
this option is used.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*BASECODE</em></td>
|
|
<td align="left" valign="top">The minimum target release of the code load for
|
|
the base option is used.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Postoperation exit program name.</strong> The program that is called
|
|
in the corresponding installed library after any of these operations are
|
|
performed on the product load:</p>
|
|
|
|
<ul>
|
|
<li>Save, using the Save Licensed Program (SAVLICPGM) command</li>
|
|
|
|
<li>Restore, using the Restore Licensed Program (RSTLICPGM) command</li>
|
|
|
|
<li>Check, using the Check Product Option (CHKPRDOPT) command</li>
|
|
</ul>
|
|
|
|
<p>The exit program does not need to exist before the product load object is
|
|
created. The following special value is valid:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NONE</em></td>
|
|
<td align="left" valign="top">No exit program is called after the library is
|
|
saved, restored, or checked.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Preoperation exit program name.</strong> The name of the
|
|
preoperation exit program. A preoperation exit program is called before any of
|
|
these operations are performed on the library:</p>
|
|
|
|
<ul>
|
|
<li>Save, using the Save Licensed Program (SAVLICPGM) command</li>
|
|
|
|
<li>Restore, using the Restore Licensed Program (RSTLICPGM) command</li>
|
|
|
|
<li>Delete, using the Delete Licensed Program (DLTLICPGM) command.</li>
|
|
</ul>
|
|
|
|
The exit program does not need to exist before the product load object is
|
|
created.
|
|
|
|
<p><strong>Primary folder.</strong> The primary folder name associated with the
|
|
development folder. The following special value is valid:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*DVLFLR</em></td>
|
|
<td align="left" valign="top">The development folder name is the same as the
|
|
primary folder name.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Principal development library name.</strong> The library into which
|
|
the product load is created. Valid special values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*PRDDFN</em></td>
|
|
<td align="left" valign="top">The name of the library in which the product
|
|
definition exists is used for the development library name.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CODE</em></td>
|
|
<td align="left" valign="top">The name of the principal development library for
|
|
the code load is used. This value is valid only when the product load type
|
|
field is specified as *LNG.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Principal primary library name.</strong> The product load is
|
|
installed into this library when no override name is specified on the Restore
|
|
Licensed Program (RSTLICPGM) command. Valid special values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*DVLLIB</em></td>
|
|
<td align="left" valign="top">The development library name is used as the
|
|
primary library name.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CODE</em></td>
|
|
<td align="left" valign="top">The name of the principal development library for
|
|
the code load is used. This value is valid only when the product load type
|
|
field is specified as *LNG.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Product ID.</strong> The 7-character identifier of the product for
|
|
which a product load 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 load type.</strong> Whether the product load being created
|
|
is a code load or a language load. Valid values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CODE</em></td>
|
|
<td align="left" valign="top">A code load is created.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*LNG</em></td>
|
|
<td align="left" valign="top">A language load is created.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Product option.</strong> The product option for which a product load
|
|
is being created. Use 0000 for the base option.</p>
|
|
|
|
<p><strong>Registration ID type.</strong> Specifies what the registration ID
|
|
value field represents. Valid values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*PRDDFN</em></td>
|
|
<td align="left" valign="top">The registration ID is taken from the product
|
|
definition for this product and release level. The product definition must
|
|
exist for *PRDDFN to be valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*PHONE</em></td>
|
|
<td align="left" valign="top">A 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">The 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> 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 that you
|
|
specify a telephone number, including the country or region and city code, or specify your
|
|
country or region code followed by your IBM customer number. 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 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>
|
|
|
|
<p><strong>Software agreement
|
|
document length.</strong> The length of the software agreement document in
|
|
bytes.</p>
|
|
|
|
<p><strong>Software agreement document name.</strong> The name of the software
|
|
agreement document. For products using software agreements, the software
|
|
agreement documents do not have to exist at the time the product load is
|
|
created but must exist when the product option is packaged and must reside in a
|
|
specific directory structure in IFS. The software agreement document repository
|
|
is '/QIBM/UserData/LicenseDoc'. Each software agreement document must have its
|
|
own subdirectory under '/QIBM/UserData/LicenseDoc'. The subdirectory must be
|
|
named the same as the software agreement document. Each of these subdirectories
|
|
must contain the actual software agreement document(s), translated for your
|
|
supported languages, stored in UTF 16 (Big Endian). See <a href=
|
|
"../rzam8/rzam8swagreegenerate.htm">Generate online software agreements</a> for
|
|
instructions on creating software agreements in UTF 16. Additionally, each
|
|
document name within the subdirectory must contain the appropriate language
|
|
extension that matches the supported languages. See <a href="#LANGSUFFIX">
|
|
Approved Language Suffixes</a> for a full list.</p>
|
|
|
|
<p>The following example provides guidance concerning the naming of software
|
|
agreement documents:</p>
|
|
|
|
<p>Assumptions:</p>
|
|
|
|
<ul>
|
|
<li>The product load being created is going to be enabled for software
|
|
agreements.</li>
|
|
|
|
<li>The product load being created includes three software agreement documents,
|
|
translated in English and French, that need to be accepted prior to the product
|
|
option being successfully installed on the system.</li>
|
|
|
|
<li>The software agreement documents for this product load are named as
|
|
follows:
|
|
|
|
<ol>
|
|
<li>document 1: 1MYPROD-V7R4M1-0000-01_en (English translation)
|
|
1MYPROD-V7R4M1-0000-01_fr (French translation)</li>
|
|
|
|
<li>document 2: 1MYPROD-V7R4M1-0000-02_en (English translation)
|
|
1MYPROD-V7R4M1-0000-02_fr (French translation)</li>
|
|
|
|
<li>document 3: 1MYPROD-V7R4M1-0000-03_en (English translation)
|
|
1MYPROD-V7R4M1-0000-03_fr (French translation)</li>
|
|
</ol>
|
|
</li>
|
|
</ul>
|
|
|
|
<br>
|
|
|
|
|
|
<p>Actions to perform:</p>
|
|
|
|
<ol>
|
|
<li>In the '/QIBM/UserData/LicenseDoc' directory create three sub-directories
|
|
with the names '1MYPROD-V7R4M1-0000-01', '1MYPROD-V7R4M1-0000-02', and
|
|
'1MYPROD-V7R4M1-0000-03'.</li>
|
|
|
|
<li>Within the appropriately named directory just created, put the correct
|
|
document(s). All translated versions of document 1 ( from the example these are
|
|
1MYPROD-V7R4M1-0000-01_en, 1MYPROD-V7R4M1-0000-01_fr) will be located in the
|
|
following directory: 'QIBM/UserData/LicenseDoc/1MYPROD-V7R4M1-0000-01'.
|
|
Similarly, document 2 (1MYPROD-V7R4M1-0000-02_en, 1MYPROD-V7R4M1-0000-02_fr),
|
|
and document 3 (1MYPROD-V7R4M1-0000-03_en, 1MYPROD-V7R4M1-0000-03_fr) will have
|
|
to be located under their respectively named directories.</li>
|
|
|
|
<li>A specific language identifier must be appended to the document name for
|
|
each language the document is available in. Currently there are 43 recognized
|
|
language suffixes valid for software agreements. See <a href="#LANGSUFFIX">
|
|
Approved Language Suffixes</a> for a full list.</li>
|
|
</ol>
|
|
|
|
<p>The naming restrictions on the software agreements document name assigned to
|
|
a product load include:</p>
|
|
|
|
<ul>
|
|
<li>Software agreement document name must be 80 or fewer characters long.</li>
|
|
|
|
<li>To prevent naming conflicts with other software agreement
|
|
documents, the software agreement documents must be uniquely named. One
|
|
suggestion for uniquely naming your software agreement documents would
|
|
be:
|
|
|
|
<ul>
|
|
<li>Insert the Product ID - Version/Release/Modification - Option information
|
|
for the product load into the document name. Example:
|
|
|
|
<ul>
|
|
<li>Product: 1MYPROD, Version/Release/Modification: V7R4M1, Option: 0002</li>
|
|
|
|
<li>Software agreement document name: 1MYPROD-V7R4M1-0002</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
|
|
<li>Software agreement documents must be located in a directory with
|
|
the same name as the document in the '/QIBM/UserData/LicenseDoc'
|
|
directory.</li>
|
|
|
|
<li>Software agreement documents must have a language identifier
|
|
appended to the document name. Note: The directory name in which the document
|
|
is located will not contain a language identifier, only the document name will
|
|
contain the suffix.
|
|
|
|
<ul>
|
|
<li>From the previous example, you would create the directory
|
|
'/QIBM/UserData/LicenseDoc/1MYPROD-V7R4M1-0002'. Then for each language the
|
|
document will be available in, create a file named '1MYPROD-V7R4M1-0002_nn'
|
|
(where '_nn' signifies the language of this document) in this directory. See <a
|
|
href="#LANGSUFFIX">Approved Language Suffixes</a> for a full list of recognized
|
|
languages.</li>
|
|
</ul>
|
|
</li>
|
|
|
|
<li>Software agreement documents must be stored in UTF 16 (Big Endian).
|
|
See <a href="../rzam8/rzam8swagreegenerate.htm">Generate online software agreements</a>
|
|
for more details on creating and storing your software agreements in UTF 16.</li>
|
|
</ul>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="LANGSUFFIX">Approved Language Suffixes</a></h3>
|
|
|
|
<p>The following table displays the language suffixes recognized in V5R2M0 that
|
|
may be used to identify the translated software agreement documents for this
|
|
product load.</p>
|
|
|
|
<table border width="80%" cellpadding="5">
|
|
<tr>
|
|
<th align="left" valign="top">Language</th>
|
|
<th align="left" valign="top">Suffix</th>
|
|
<th align="left" valign="top">Language</th>
|
|
<th align="left" valign="top">Suffix</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" width="25%">Albanian</td>
|
|
<td align="left" valign="top" width="25%">_sq</td>
|
|
<td align="left" valign="top" width="25%">Arabic</td>
|
|
<td align="left" valign="top" width="25%">_ar</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Bulgarian</td>
|
|
<td align="left" valign="top">_bg</td>
|
|
<td align="left" valign="top">Byelorussian</td>
|
|
<td align="left" valign="top">_be</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Catalan</td>
|
|
<td align="left" valign="top">_ca</td>
|
|
<td align="left" valign="top">Croatian</td>
|
|
<td align="left" valign="top">_hr</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Czech</td>
|
|
<td align="left" valign="top">_cs</td>
|
|
<td align="left" valign="top">Danish</td>
|
|
<td align="left" valign="top">_da</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Dutch</td>
|
|
<td align="left" valign="top">_nl</td>
|
|
<td align="left" valign="top">English</td>
|
|
<td align="left" valign="top">_en</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Estonian</td>
|
|
<td align="left" valign="top">_et</td>
|
|
<td align="left" valign="top">Finnish</td>
|
|
<td align="left" valign="top">_fi</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">French</td>
|
|
<td align="left" valign="top">_fr</td>
|
|
<td align="left" valign="top">German</td>
|
|
<td align="left" valign="top">_de</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Greek</td>
|
|
<td align="left" valign="top">_el</td>
|
|
<td align="left" valign="top">Hebrew</td>
|
|
<td align="left" valign="top">_iw</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Hindu</td>
|
|
<td align="left" valign="top">_hi</td>
|
|
<td align="left" valign="top">Hungarian</td>
|
|
<td align="left" valign="top">_hu</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Icelandic</td>
|
|
<td align="left" valign="top">_is</td>
|
|
<td align="left" valign="top">Italian</td>
|
|
<td align="left" valign="top">_it</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Japanese</td>
|
|
<td align="left" valign="top">_ja</td>
|
|
<td align="left" valign="top">Korean</td>
|
|
<td align="left" valign="top">_ko</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Laotion</td>
|
|
<td align="left" valign="top">_lo</td>
|
|
<td align="left" valign="top">Latvian</td>
|
|
<td align="left" valign="top">_lv</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Lithuanian</td>
|
|
<td align="left" valign="top">_lt</td>
|
|
<td align="left" valign="top">Macedonian</td>
|
|
<td align="left" valign="top">_mk</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Polish</td>
|
|
<td align="left" valign="top">_pl</td>
|
|
<td align="left" valign="top">Norwegian</td>
|
|
<td align="left" valign="top">_no</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Portugese</td>
|
|
<td align="left" valign="top">_pt</td>
|
|
<td align="left" valign="top">Portugese</td>
|
|
<td align="left" valign="top">_pt_BR</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Romanian</td>
|
|
<td align="left" valign="top">_ro</td>
|
|
<td align="left" valign="top">Russian</td>
|
|
<td align="left" valign="top">_ru</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Serbian</td>
|
|
<td align="left" valign="top">_sr</td>
|
|
<td align="left" valign="top">Simplified Chinese</td>
|
|
<td align="left" valign="top">_zh_CN</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Slovakian</td>
|
|
<td align="left" valign="top">_sk</td>
|
|
<td align="left" valign="top">Slovenian</td>
|
|
<td align="left" valign="top">_sl</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Spanish</td>
|
|
<td align="left" valign="top">_es</td>
|
|
<td align="left" valign="top">Swedish</td>
|
|
<td align="left" valign="top">_sv</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Thai</td>
|
|
<td align="left" valign="top">_th</td>
|
|
<td align="left" valign="top">Traditional Chinese</td>
|
|
<td align="left" valign="top">_zh_TW</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Turkish</td>
|
|
<td align="left" valign="top">_tr</td>
|
|
<td align="left" valign="top">Ukranian</td>
|
|
<td align="left" valign="top">_uk</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Vietnamese</td>
|
|
<td align="left" valign="top">_vi</td>
|
|
<td align="left" valign="top"> </td>
|
|
<td align="left" valign="top"> </td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Error Messages</h3>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<th align="left" valign="top" nowrap>Message ID</th>
|
|
<th align="left" valign="top">Error Message Text</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0CA1 E</td>
|
|
<td align="left" valign="top">No language load defined.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0CA2 E</td>
|
|
<td align="left" valign="top">Code load ID &9 not valid.</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">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">CPF0C1B E</td>
|
|
<td align="left" valign="top">Requirements between parameters not
|
|
satisfied.</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">CPF0C4B E</td>
|
|
<td align="left" valign="top">Product availability object &2/&1
|
|
recovery required.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C4C E</td>
|
|
<td align="left" valign="top">Cannot allocate object &1 in library
|
|
&2.</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">CPF0C5B E</td>
|
|
<td align="left" valign="top">Duplicate primary product directory.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C5C E</td>
|
|
<td align="left" valign="top">Specified product directory name not
|
|
allowed.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C5D E</td>
|
|
<td align="left" valign="top">Product directory not allowed.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C5E E</td>
|
|
<td align="left" valign="top">Too many product directories specified.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C5F E</td>
|
|
<td align="left" valign="top">Product directory is not in valid format.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C54 E</td>
|
|
<td align="left" valign="top">Data in product record not correct.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C55 E</td>
|
|
<td align="left" valign="top">Registration ID problem with path.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C58 E</td>
|
|
<td align="left" valign="top">Cannot add duplicate path name to *PRDLOD.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C59 E</td>
|
|
<td align="left" valign="top">Directory in use.</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">CPF0C8B E</td>
|
|
<td align="left" valign="top">Product load type &1 not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C8C E</td>
|
|
<td align="left" valign="top">Number of additional libraries not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C8D E</td>
|
|
<td align="left" valign="top">Preoperation exit program information not
|
|
valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C8E E</td>
|
|
<td align="left" valign="top">Preoperation exit program library not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C8F E</td>
|
|
<td align="left" valign="top">Number of folders not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C81 E</td>
|
|
<td align="left" valign="top">Product load &6 in library &5 not
|
|
created.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C82 E</td>
|
|
<td align="left" valign="top">Error occurred while creating product load &6
|
|
in library &5.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C83 E</td>
|
|
<td align="left" valign="top">Previous level folder not specified.</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">CPF0C85 E</td>
|
|
<td align="left" valign="top">Duplicate library &5 specified.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C87 E</td>
|
|
<td align="left" valign="top">Library &1 not allowed.</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">CPF0C9C E</td>
|
|
<td align="left" valign="top">Secondary language library name required.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C9D E</td>
|
|
<td align="left" valign="top">Minimum target release not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C91 E</td>
|
|
<td align="left" valign="top">Code load does not exist.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C92 E</td>
|
|
<td align="left" valign="top">Folder name not correct.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C93 E</td>
|
|
<td align="left" valign="top">More than one root folder specified.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C94 E</td>
|
|
<td align="left" valign="top">Object name *LNG not valid for code load.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C95 E</td>
|
|
<td align="left" valign="top">*CODE not valid for library.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C96 E</td>
|
|
<td align="left" valign="top">Secondary language library not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C97 E</td>
|
|
<td align="left" valign="top">Duplicate folder &5 in folder list.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C98 E</td>
|
|
<td align="left" valign="top">Additional development library &5 not found
|
|
in code load.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0C99 E</td>
|
|
<td align="left" valign="top">Product definition object not found.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0D11 E</td>
|
|
<td align="left" valign="top">Software agreement enablement only valid for
|
|
loads of type *CODE.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0D12 E</td>
|
|
<td align="left" valign="top">Number of software agreement documents specified
|
|
is not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0D13 E</td>
|
|
<td align="left" valign="top">Software agreement document name not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0D14 E</td>
|
|
<td align="left" valign="top">Software agreements enablement only valid with
|
|
minimum target release values after V5R2M0.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF0613 E</td>
|
|
<td align="left" valign="top">User profile does not have enough storage
|
|
assigned.</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">CPF3C21 E</td>
|
|
<td align="left" valign="top">Format name &1 is 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">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: V2R3
|
|
|
|
<hr>
|
|
<table align="center" 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>
|
|
</body>
|
|
</html>
|