829 lines
25 KiB
HTML
829 lines
25 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>List Activities (QFVLSTA) 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. -->
|
||
|
<!-- COMM4 SCRIPT A converted by B2H R4.1 (346) (CMS) by V2DCIJB at -->
|
||
|
<!-- RCHVMW2 on 1 Jun 1999 at 17:32:50 -->
|
||
|
<!-- Change History: -->
|
||
|
<!-- YYMMDD USERID Change description -->
|
||
|
<!--File Edited December, 2001 =========================================== -->
|
||
|
<!--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 type="text/javascript" language="Javascript" src="../rzahg/synch.js">
|
||
|
</script>
|
||
|
|
||
|
<h2>List Activities (QFVLSTA) 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 user space 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">Format</td>
|
||
|
<td align="left" valign="top">Input</td>
|
||
|
<td align="left" valign="top">Char(8)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">3</td>
|
||
|
<td align="left" valign="top">Qualified change request description name</td>
|
||
|
<td align="left" valign="top">Input</td>
|
||
|
<td align="left" valign="top">Char(20)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">4</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 List Activities (QFVLSTA) API retrieves a list of activities from a qualified change request description.</p>
|
||
|
|
||
|
<br>
|
||
|
<h3>Authorities and Locks</h3>
|
||
|
|
||
|
<dl>
|
||
|
<dt><em>Change request description authority</em></dt>
|
||
|
<dd>*USE<br><br></dd>
|
||
|
|
||
|
<dt><em>Change request description lock</em></dt>
|
||
|
<dd>*SHRRD<br><br></dd>
|
||
|
|
||
|
<dt><em>User space authority</em></dt>
|
||
|
<dd>*CHANGE<br><br></dd>
|
||
|
|
||
|
<dt><em>User space library authority</em></dt>
|
||
|
<dd>*EXECUTE<br><br></dd>
|
||
|
|
||
|
<dt><em>User space lock</em></dt>
|
||
|
<dd>*EXCLRD</dd>
|
||
|
</dl>
|
||
|
|
||
|
<br>
|
||
|
<h3>Required Parameter Group</h3>
|
||
|
|
||
|
<dl>
|
||
|
<dt><strong>Qualified user space name</strong></dt>
|
||
|
<dd>INPUT; CHAR(20)
|
||
|
|
||
|
<p>The name of the qualified user space that receives the generated list. The first 10 characters contain the user space name, the second 10 characters contain the user space library name.</p>
|
||
|
|
||
|
<p>Special values for the user space library name are:</p>
|
||
|
|
||
|
<table cellpadding="3">
|
||
|
<!-- cols="15 85" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*CURLIB</em></td>
|
||
|
<td valign="top">The current library</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*LIBL</em></td>
|
||
|
<td valign="top">The library list</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
<br>
|
||
|
</dd>
|
||
|
|
||
|
<dt><strong>Format</strong></dt>
|
||
|
<dd>INPUT; CHAR(8)
|
||
|
|
||
|
<p>The format of the data to return. The valid values are:</p>
|
||
|
|
||
|
<table cellpadding="3">
|
||
|
<!-- cols="15 85" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>CRDA0100</em></td>
|
||
|
<td valign="top">The activity name is returned. See <a href="#HDRTIQFMT1">CRDA0100 Format</a>.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>CRDA0200</em></td>
|
||
|
<td valign="top">The activity name, start time, and conditions are returned. See <a href="#HDRTIQFMT2">CRDA0200 Format</a>.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>CRDA0300</em></td>
|
||
|
<td valign="top">The activity name, type, text, conditions and function parameters are returned. See <a href="#HDRTIQFMT3">CRDA0300 Format</a>.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
<br>
|
||
|
</dd>
|
||
|
|
||
|
<dt><strong>Qualified change request description name</strong></dt>
|
||
|
<dd>INPUT; CHAR(20)
|
||
|
|
||
|
<p>The name of the qualified change request description from which information will be retrieved. The first 10 characters contain the change request description name and the second 10 characters contain the change request description library name.</p>
|
||
|
|
||
|
<p>Special values for the qualified change request description library name are:</p>
|
||
|
|
||
|
<table cellpadding="3">
|
||
|
<!-- cols="15 85" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*CURLIB</em></td>
|
||
|
<td valign="top">The current library</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*LIBL</em></td>
|
||
|
<td valign="top">The library list</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="HDRTIUSFMT">Format of the Generated List</a></h3>
|
||
|
|
||
|
<p>The user space is used to retrieve the activity list with the requested information and consists of:</p>
|
||
|
|
||
|
<ul>
|
||
|
<li>A user area</li>
|
||
|
|
||
|
<li>A generic header</li>
|
||
|
|
||
|
<li>An input parameter section</li>
|
||
|
|
||
|
<li>A header section</li>
|
||
|
</ul>
|
||
|
|
||
|
<p>For details about the user area and generic header, see <a href="../apiref/usf.htm">User Space Format for List APIs</a>. For details about the other items, see the following sections. For a detailed description of each field in the information returned, see <a href="#HDRLMBRDF">Field Descriptions</a>.</p>
|
||
|
|
||
|
<br>
|
||
|
<h3>Input Parameter Section</h3>
|
||
|
|
||
|
<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%">User space name specified</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">10</td>
|
||
|
<td align="center" valign="top" width="10%">A</td>
|
||
|
<td align="left" valign="top" width="20%">CHAR(10)</td>
|
||
|
<td align="left" valign="top" width="60%">User space library name specified</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">20</td>
|
||
|
<td align="center" valign="top" width="10%">14</td>
|
||
|
<td align="left" valign="top" width="20%">CHAR(8)</td>
|
||
|
<td align="left" valign="top" width="60%">Format name specified</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">28</td>
|
||
|
<td align="center" valign="top" width="10%">1C</td>
|
||
|
<td align="left" valign="top" width="20%">CHAR(10)</td>
|
||
|
<td align="left" valign="top" width="60%">Change request description name specified</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">38</td>
|
||
|
<td align="center" valign="top" width="10%">26</td>
|
||
|
<td align="left" valign="top" width="20%">CHAR(10)</td>
|
||
|
<td align="left" valign="top" width="60%">Change request description library name specified</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br><br>
|
||
|
<h3>Header Section</h3>
|
||
|
|
||
|
<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%">User space name used</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">10</td>
|
||
|
<td align="center" valign="top" width="10%">A</td>
|
||
|
<td align="left" valign="top" width="20%">CHAR(10)</td>
|
||
|
<td align="left" valign="top" width="60%">User space library name used</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">20</td>
|
||
|
<td align="center" valign="top" width="10%">14</td>
|
||
|
<td align="left" valign="top" width="20%">CHAR(10)</td>
|
||
|
<td align="left" valign="top" width="60%">Change request description name used</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">30</td>
|
||
|
<td align="center" valign="top" width="10%">1E</td>
|
||
|
<td align="left" valign="top" width="20%">CHAR(10)</td>
|
||
|
<td align="left" valign="top" width="60%">Change request description library name used</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br><br>
|
||
|
<h3><a name="HDRTIQFMT1">CRDA0100 Format</a></h3>
|
||
|
|
||
|
<p>See <a href="#HDRLMBRDF">Field Descriptions</a> for descriptions of the fields in this format.</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%">Activity name</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br><br>
|
||
|
<h3><a name="HDRTIQFMT2">CRDA0200 Format</a></h3>
|
||
|
|
||
|
<p>See <a href="#HDRLMBRDF">Field Descriptions</a> for descriptions of the fields in this format.</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%">Activity name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">10</td>
|
||
|
<td align="center" valign="top" width="10%">A</td>
|
||
|
<td align="left" valign="top" width="20%">Array of CHAR(32)</td>
|
||
|
<td align="left" valign="top" width="60%">Conditions array</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">170</td>
|
||
|
<td align="center" valign="top" width="10%">AA</td>
|
||
|
<td align="left" valign="top" width="20%">CHAR(2)</td>
|
||
|
<td align="left" valign="top" width="60%">Reserved</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">172</td>
|
||
|
<td align="center" valign="top" width="10%">AC</td>
|
||
|
<td align="left" valign="top" width="20%">BINARY(4)</td>
|
||
|
<td align="left" valign="top" width="60%">Number of conditions</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">176</td>
|
||
|
<td align="center" valign="top" width="10%">BO</td>
|
||
|
<td align="left" valign="top" width="20%">CHAR(40)</td>
|
||
|
<td align="left" valign="top" width="60%">Start time</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br><br>
|
||
|
<h3><a name="HDRTIQFMT3">CRDA0300 Format</a></h3>
|
||
|
|
||
|
<p>See <a href="#HDRLMBRDF">Field Descriptions</a> for descriptions of the fields in this format.</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%">Activity name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">10</td>
|
||
|
<td align="center" valign="top" width="10%">A</td>
|
||
|
<td align="left" valign="top" width="20%">CHAR(10)</td>
|
||
|
<td align="left" valign="top" width="60%">Activity type</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">20</td>
|
||
|
<td align="center" valign="top" width="10%">14</td>
|
||
|
<td align="left" valign="top" width="20%">CHAR(50)</td>
|
||
|
<td align="left" valign="top" width="60%">Activity text description</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">70</td>
|
||
|
<td align="center" valign="top" width="10%">46</td>
|
||
|
<td align="left" valign="top" width="20%">CHAR(2)</td>
|
||
|
<td align="left" valign="top" width="60%">Reserved</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">72</td>
|
||
|
<td align="center" valign="top" width="10%">48</td>
|
||
|
<td align="left" valign="top" width="20%">BINARY(4)</td>
|
||
|
<td align="left" valign="top" width="60%">CCSID of activity text description</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">76</td>
|
||
|
<td align="center" valign="top" width="10%">4C</td>
|
||
|
<td align="left" valign="top" width="20%">Array of CHAR(32)</td>
|
||
|
<td align="left" valign="top" width="60%">Conditions array</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">236</td>
|
||
|
<td align="center" valign="top" width="10%">EC</td>
|
||
|
<td align="left" valign="top" width="20%">BINARY(4)</td>
|
||
|
<td align="left" valign="top" width="60%">Number of conditions</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">240</td>
|
||
|
<td align="center" valign="top" width="10%">F0</td>
|
||
|
<td align="left" valign="top" width="20%">BINARY(31)</td>
|
||
|
<td align="left" valign="top" width="60%">Function parameters length</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">271</td>
|
||
|
<td align="center" valign="top" width="10%">10F</td>
|
||
|
<td align="left" valign="top" width="20%">CHAR(*)</td>
|
||
|
<td align="left" valign="top" width="60%">Function parameters</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br><br>
|
||
|
<h3><a name="HDRLMBRDF">Field Descriptions</a></h3>
|
||
|
|
||
|
<p><strong>Activity name.</strong> The name of the activity stored in the change request description name.</p>
|
||
|
|
||
|
<p><strong>Activity text description.</strong> The description of the activity.</p>
|
||
|
|
||
|
<p><strong>Activity type.</strong> The name of the activity type stored in the change request description name. This value is defined by the user program. The API does not define the possible values.</p>
|
||
|
|
||
|
<p><strong>Change request description name specified.</strong> The name of the change request description specified to the API.</p>
|
||
|
|
||
|
<p><strong>Change request description name used.</strong> The name of the change request description used to retrieve the list.</p>
|
||
|
|
||
|
<p><strong>Change request description library name specified.</strong> The name of the library where the change request description is stored specified to the API. If the special values *LIBL or *CURLIB are used, the library name resolved is set here.</p>
|
||
|
|
||
|
<p><strong>Change request description library name used.</strong> The name of the library used where the change request description is stored.</p>
|
||
|
|
||
|
<p><strong>Conditions array.</strong> The list of conditions that must be met before the activity can be run. This is an array of 5 elements. The number of conditions field indicates the actual number of conditions specified for the activity.</p>
|
||
|
|
||
|
<p>The structure of each element is:</p>
|
||
|
|
||
|
<table cellpadding="3">
|
||
|
<!-- cols="15 85" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>activity</em></td>
|
||
|
<td valign="top">CHAR(10)
|
||
|
|
||
|
<p>Activity name. Possible values: *PRV, user-specified name, or a generic name (partial name followed by an asterisk (*)).</p></td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>relation</em></td>
|
||
|
<td valign="top">CHAR(3)
|
||
|
|
||
|
<p>The relational operator. Possible values are:</p>
|
||
|
|
||
|
<p>*EQ, *NE, *GT, *LT, *GE, *LE.</p></td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>reserved</em></td>
|
||
|
<td valign="top">An ignored field.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>code</em></td>
|
||
|
<td valign="top">BIN(31)
|
||
|
|
||
|
<p>The end code value to base conditioning on. The following values are supported:</p>
|
||
|
|
||
|
<table cellpadding="3">
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>0-99</em></td>
|
||
|
<td valign="top">User can specify anything in this range.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>-1 (*SUCCESS)</em></td>
|
||
|
<td valign="top">The end code is any value from 0-9.
|
||
|
|
||
|
<p>If specified, relation must be *EQ or *NE.</p></td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>-2 (*FAIL)</em></td>
|
||
|
<td valign="top">The end code is any value from 10-89.
|
||
|
|
||
|
<p>If specified, relation must be *EQ or *NE.</p></td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>-3 (*NOTRUN)</em></td>
|
||
|
<td valign="top">The end code is any value from 90-99.
|
||
|
|
||
|
<p>If specified, relation must *EQ or *NE.</p></td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>-4 (*ANY)</em></td>
|
||
|
<td valign="top">The end code is any value from 0-99.
|
||
|
|
||
|
<p>If specified, relation must be *EQ.</p></td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>mode</em></td>
|
||
|
<td valign="top">CHAR(10)
|
||
|
|
||
|
<p>Condition mode. Possible values are:</p>
|
||
|
|
||
|
<table cellpadding="3">
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*ALLNODES</em></td>
|
||
|
<td valign="top">All nodes of the conditioning activity must meet the completion criteria before this condition is considered met.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*SAMENODE</em></td>
|
||
|
<td valign="top">Nodes of the conditioned activity need only wait for the same node of the conditioning activity to meet the completion criteria before this condition is considered met.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<p><strong>CCSID of activity text.</strong> The CCSID of the activity text description.</p>
|
||
|
|
||
|
<p><strong>Format name specified.</strong> The format name specified to the API.</p>
|
||
|
|
||
|
<p><strong>Function parameters.</strong> The parameters defined by the calling application when the activity was added.</p>
|
||
|
|
||
|
<p><strong>Function parameters length.</strong> The length of the function parameters returned.</p>
|
||
|
|
||
|
<p><strong>Number of conditions.</strong> The number of conditions specified for the activity. Valid values range from 0 through 5. This field is used to determine how many elements of the condition array contain valid data.</p>
|
||
|
|
||
|
<p><strong>Reserved.</strong> An ignored field.</p>
|
||
|
|
||
|
<p><strong>Start time.</strong> The date and time window during which this activity can be started. The current date and time values and next date values are determined when change request is submitted. The structure is:</p>
|
||
|
|
||
|
<table cellpadding="3">
|
||
|
<!-- cols="15 85" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>start after time</em></td>
|
||
|
<td valign="top">CHAR(10)
|
||
|
|
||
|
<p>The time after which this activity may be started. Special value supported is:</p>
|
||
|
|
||
|
<table cellpadding="3">
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*CURRENT</em></td>
|
||
|
<td valign="top">This activity may start any time on or after the time at which the change request was submitted.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>start after date</em></td>
|
||
|
<td valign="top">CHAR(10)
|
||
|
|
||
|
<p>The date after which this activity may be started. Special values supported are:</p>
|
||
|
|
||
|
<table cellpadding="3">
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*CURRENT</em></td>
|
||
|
<td valign="top">This activity may start on any date on or after the date on which the change request was submitted.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*NEXT</em></td>
|
||
|
<td valign="top">This activity may start on any date after the date on which the change request was submitted.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>start before time</em></td>
|
||
|
<td valign="top">CHAR(10)
|
||
|
|
||
|
<p>The time before which the activity must be started. If the activity cannot be started before this time then it will never be started. Special values supported are:</p>
|
||
|
|
||
|
<table cellpadding="3">
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*ANY</em></td>
|
||
|
<td valign="top">The activity may start any time on or after the start time.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*CURRENT</em></td>
|
||
|
<td valign="top">The activity must start before the time the change request was submitted on the date specified on the start before date field.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top"><em>start before date</em></td>
|
||
|
<td valign="top">CHAR(10)
|
||
|
|
||
|
<p>The date before which the activity must be started. If the activity cannot be started by this date then it will never be started. Special values supported are:</p>
|
||
|
|
||
|
<table cellpadding="3">
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*ANY</em></td>
|
||
|
<td valign="top">The activity may start at any date on or after the start date.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*CURRENT</em></td>
|
||
|
<td valign="top">The activity must start on the date the change request was submitted.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*NEXT</em></td>
|
||
|
<td valign="top">The activity must start by the day after the date the change request was submitted.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<p>The format of time is HHMMSS and the format of date is CYYMMDD.</p>
|
||
|
|
||
|
<p><strong>User space library name specified.</strong> The user space library name specified to the API.</p>
|
||
|
|
||
|
<p><strong>User space library name used.</strong> The names of the actual user space library used to report data. If the special values *LIBL or *CURLIB are used, the library name resolved is set here.</p>
|
||
|
|
||
|
<p><strong>User space name specified.</strong> The user space name specified to the API.</p>
|
||
|
|
||
|
<p><strong>User space name used.</strong> The actual user space name used to report data.</p>
|
||
|
|
||
|
<br>
|
||
|
<h3>Error Messages</h3>
|
||
|
|
||
|
<table width="100%" cellpadding="3">
|
||
|
<!-- cols="15 85" -->
|
||
|
<tr>
|
||
|
<th align="left" valign="top">Message ID</th>
|
||
|
<th align="left" valign="top">Error Message Text</th>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF24B4 E</td>
|
||
|
<td valign="top">Severe error while addressing parameter list.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF3793 E</td>
|
||
|
<td valign="top">Machine storage limit reached.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF3C21 E</td>
|
||
|
<td valign="top">Format name &1 is not valid.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF3C90 E</td>
|
||
|
<td valign="top">Literal value cannot be changed.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF3CAA E</td>
|
||
|
<td valign="top">List is too large for user space &1.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF3CF1 E</td>
|
||
|
<td valign="top">Error code parameter not valid.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF8100 E</td>
|
||
|
<td valign="top">All CPF81xx messages could be returned. xx is from 01 to FF.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF969E E</td>
|
||
|
<td valign="top">Internal processing error occurred.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF96A1 E</td>
|
||
|
<td valign="top">User space library name &1 not valid.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF96A2 E</td>
|
||
|
<td valign="top">CRQD library name &1 not valid.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9801 E</td>
|
||
|
<td valign="top">Object &2 in library &3 not found.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9802 E</td>
|
||
|
<td valign="top">Not authorized to object &2 in &3.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9803 E</td>
|
||
|
<td valign="top">Cannot allocate object &2 in library &3.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9804 E</td>
|
||
|
<td valign="top">Object &2 in library &3 damaged.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9807 E</td>
|
||
|
<td valign="top">One or more libraries in library list deleted.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9808 E</td>
|
||
|
<td valign="top">Cannot allocate one or more libraries on library list.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9810 E</td>
|
||
|
<td valign="top">Library &1 not found.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9811 E</td>
|
||
|
<td valign="top">Program &1 in library &2 not found.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9812 E</td>
|
||
|
<td valign="top">File &1 in library &2 not found.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9814 E</td>
|
||
|
<td valign="top">Device &1 not found.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9820 E</td>
|
||
|
<td valign="top">Not authorized to use library &1.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9821 E</td>
|
||
|
<td valign="top">Not authorized to program &1 in library &2.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9822 E</td>
|
||
|
<td valign="top">Not authorized to file &1 in library &2.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9825 E</td>
|
||
|
<td valign="top">Not authorized to device &1.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9830 E</td>
|
||
|
<td valign="top">Cannot assign library &1.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9831 E</td>
|
||
|
<td valign="top">Cannot assign device &1.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9838 E</td>
|
||
|
<td valign="top">User profile storage limit exceeded.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9872 E</td>
|
||
|
<td valign="top">Program or service program &1 in library &2 ended. Reason code &3.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
|
||
|
<hr>
|
||
|
API introduced: V2R2
|
||
|
|
||
|
<hr>
|
||
|
<center>
|
||
|
<table cellpadding="2" cellspacing="2">
|
||
|
<tr align="center">
|
||
|
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a
|
||
|
href="netmg.htm">Network Management APIs</a> | <a href="aplist.htm">APIs
|
||
|
by category</a></td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
</center>
|
||
|
</body>
|
||
|
</html>
|
||
|
|