ibm-information-center/dist/eclipse/plugins/i5OS.ic.apis_5.4.0.1/QFVADDA.htm

780 lines
21 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>Add Activity (QFVADDA) 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>Add Activity (QFVADDA) API</h2>
<div class="box" style="width: 80%;">
<br>
&nbsp;&nbsp;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 change request description 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">Activity name</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(10)</td>
</tr>
<tr>
<td align="center" valign="top">3</td>
<td align="left" valign="top">Activity type</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">Destination format</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(10)</td>
</tr>
<tr>
<td align="center" valign="top">5</td>
<td align="left" valign="top">Destination</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 destinations</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">Condition list</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Array of Char(32)</td>
</tr>
<tr>
<td align="center" valign="top">8</td>
<td align="left" valign="top">Number of conditions</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">Start time</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(40)</td>
</tr>
<tr>
<td align="center" valign="top">10</td>
<td align="left" valign="top">Hold</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(10)</td>
</tr>
<tr>
<td align="center" valign="top">11</td>
<td align="left" valign="top">Function parameters</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(*)</td>
</tr>
<tr>
<td align="center" valign="top">12</td>
<td align="left" valign="top">Length of function parameters</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Binary(4)</td>
</tr>
<tr>
<td align="center" valign="top">13</td>
<td align="left" valign="top">Text</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(50)</td>
</tr>
<tr>
<td align="center" valign="top">14</td>
<td align="left" valign="top">Replace</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(10)</td>
</tr>
<tr>
<td align="center" valign="top">15</td>
<td align="left" valign="top">Activity added</td>
<td align="left" valign="top">Output</td>
<td align="left" valign="top">Char(10)</td>
</tr>
<tr>
<td align="center" valign="top">16</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>
&nbsp;&nbsp;Default Public Authority: *USE<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Threadsafe: No<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The Add Activity (QFVADDA) API adds an activity to the specified change request description.</p>
<br>
<h3>Authorities and Locks</h3>
<dl>
<dt><em>Change request description authority</em></dt>
<dd>*CHANGE</dd>
<dt><em>Change request description lock</em></dt>
<dd>*EXCLRD</dd>
</dl>
<br>
<h3>Required Parameter Group</h3>
<dl>
<dt><strong>Qualified change request description name</strong></dt>
<dd>INPUT; CHAR(20)
<p>The name and library of the qualified change request description to which an activity is added. The first ten characters contain the name of the change request description. The second ten characters contain the name of the library where the change request description is located.</p>
<p>The following special values can be used for library name:</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>Activity name</strong></dt>
<dd>INPUT; CHAR(10)
<p>The name of the activity to add to the qualified change request description. The first character must be alphabetic or one of the special symbols $, @, or #. The remaining characters can be alphanumeric (A through Z, a through z, 0 through 9, and special symbols $, #, @, ., or _). The maximum number of activities allowed per change request description is 200.</p>
<p>Special values for the name of the activity are:</p>
<table cellpadding="3">
<!-- cols="10 90" -->
<tr>
<td align="left" valign="top"><em>*GEN</em></td>
<td valign="top">The activity name is generated automatically in the format QACTnnnnnn where nnnnnn is a multiple of 10 from 000010 to 999990.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*LAST</em></td>
<td valign="top">This activity is the last activity to run for the change request. Only one activity in a change request may be specified with this value. The number of conditions must be 0. The start after time and date of start time parameter must be *CURRENT. The start before time and date of start parameter must be *ANY.</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Activity type</strong></dt>
<dd>INPUT; CHAR(10)
<p>The name of the activity type to be added to the change request description. This value is defined by the user program. The API does not define the possible values. The characters that can be used for the activity type name are A through Z, 0 through 9, and *. Only IBM activity types should start with *.</p>
</dd>
<dt><strong>Destination format</strong></dt>
<dd>INPUT; CHAR(10)
<p>Whether the activity runs on the local system, a node list name, or a list of 1 to 50 nodes specified by the user.</p>
<p>Special values for the destination format are:</p>
<table cellpadding="3">
<!-- cols="10 90" -->
<tr>
<td align="left" valign="top"><em>*LCL</em></td>
<td valign="top">The activity runs on the local system. The destination and number of destinations parameters are ignored if they are specified (the local network ID and control point name are assumed).</td>
</tr>
<tr>
<td align="left" valign="top"><em>*NODL</em></td>
<td valign="top">The activity runs on the systems identified in the node list name. The number of destinations parameter is ignored if it is specified. The node list is not restricted to 50 nodes.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*SNALST</em></td>
<td valign="top">The activity runs on the systems identified in the list of user-specified SNA nodes.</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Destination</strong></dt>
<dd>INPUT; Array of CHAR(20)
<p>The destination of the activity. The format of the destination is based on the destination format parameter.</p>
<p>When the destination format is *SNALST, the destination parameter is an array of the number of destinations elements.</p>
<p>The format for each element is:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>Network ID</em></td>
<td valign="top">CHAR(8)</td>
</tr>
<tr>
<td align="left" valign="top"><em>Control point</em></td>
<td valign="top">CHAR(8)</td>
</tr>
<tr>
<td align="left" valign="top"><em>Reserved</em></td>
<td valign="top">CHAR(4)</td>
</tr>
</table>
<p>When the destination format is *NODL, the destination parameter is an array of one element with the following format:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>Node list name</em></td>
<td valign="top">CHAR(10)</td>
</tr>
<tr>
<td align="left" valign="top"><em>Library</em></td>
<td valign="top">CHAR(10)</td>
</tr>
</table>
<p>When the destination format is *LCL, the destination parameter is ignored.</p>
</dd>
<dt><strong>Number of destinations</strong></dt>
<dd>INPUT; BINARY(4)
<p>The number of elements in the destination array. Valid values range from 1 through 50. The number of destinations parameter is ignored if the destination format parameter is *LCL or *NODL.</p>
</dd>
<dt><strong>Condition list</strong></dt>
<dd>INPUT: Array of CHAR(32)
<p>The list of conditions that must be met before the activity can be run.</p>
<p>The format for each element is:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>Activity name</em></td>
<td valign="top">CHAR(10)
<p>The activity name which can be:</p>
<table cellpadding="3">
<tr>
<td align="left" valign="top"><em>activity name</em></td>
<td valign="top">the activity is conditioned on the activity name specified.</td>
</tr>
<tr>
<td align="left" valign="top"><em>generic name</em></td>
<td valign="top">the activity is conditioned on all the activities that match the generic name (partial activity followed by an asterisk (*)).</td>
</tr>
<tr>
<td align="left" valign="top"><em>*PRV</em></td>
<td valign="top">the activity is conditioned on the activity that precedes it alphabetically.</td>
</tr>
</table>
<br>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>Relation</em></td>
<td valign="top">CHAR(3)
<p>Valid values are *EQ, *NE, *GT, *LT, *GE, and *LE.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>Reserved</em></td>
<td valign="top">CHAR(3)</td>
</tr>
<tr>
<td align="left" valign="top"><em>Code</em></td>
<td valign="top">BINARY(31)
<p>The end code value to base conditioning on. Possible values are:</p>
<table cellpadding="3">
<tr>
<td align="left" valign="top"><em>0-99</em></td>
<td valign="top">user-specified</td>
</tr>
<tr>
<td align="left" valign="top"><em>-1 (*SUCCESS)</em></td>
<td valign="top">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">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">end code is any value from 90-99.
<p>If specified, relation must be *EQ or *NE.</p></td>
</tr>
<tr>
<td align="left" valign="top"><em>-4 (*ANY)</em></td>
<td valign="top">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>Possible vales 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>
<tr>
<td valign="top"><em>Reserved</em></td>
<td valign="top">Null</td>
</tr>
</table>
</dd>
<br>
<dt><strong>Number of conditions</strong></dt>
<dd>INPUT; BINARY(4)
<p>The number of condition elements. The valid values are 0 through 5. When the number of condition elements is 0, the activity specified is not dependent on any other activities to complete before it can start, and the condition list parameter is ignored.</p>
</dd>
<dt><strong>Start time</strong></dt>
<dd>INPUT; CHAR(40)
<p>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 the 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 values supported are:</p>
<p><em>*CURRENT</em></p></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 value supported:</p>
<p><em>*CURRENT</em></p>
<p><em>*NEXT</em></p></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 is never started. Special values supported are:</p>
<p><em>*ANY</em></p>
<p><em>*CURRENT</em></p></td>
</tr>
<tr>
<td align="left" 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 before this date then it is never started. Special values supported are:</p>
<p><em>*ANY</em></p>
<p><em>*CURRENT</em></p>
<p><em>*NEXT</em></p></td>
</tr>
</table>
<p>The format for time is hhmmss. The format for date is cyymmdd.</p>
</dd>
<dt><strong>Hold</strong></dt>
<dd>INPUT; CHAR(10)
<p>Whether or not this activity is in Held status when it is submitted.</p>
<p>Valid values are *YES and *NO.</p>
</dd>
<dt><strong>Function parameters</strong></dt>
<dd>INPUT; CHAR(*)
<p>The structure containing the specific function parameters. The format is known only by the program calling this API and the exit program that is called to display, change, print, or run this activity.</p>
</dd>
<dt><strong>Length of function parameters</strong></dt>
<dd>INPUT; BINARY(4)
<p>The total length in bytes of the function parameters parameter. Valid values range from 1 through 12288 (12k).</p>
</dd>
<dt><strong>Text</strong></dt>
<dd>INPUT; CHAR(50)
<p>The description of the activity.</p>
</dd>
<dt><strong>Replace</strong></dt>
<dd>INPUT; CHAR(10)
<p>Whether an activity that already exists is replaced. If the activity name is found, it is replaced on this parameter.</p>
<table cellpadding="3">
<!-- cols="10 90" -->
<tr>
<td align="left" valign="top"><em>*YES</em></td>
<td valign="top">The activity that already exists in the change request description is replaced.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*NO</em></td>
<td valign="top">The activity that already exists in the change request description is not replaced.</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Activity added</strong></dt>
<dd>OUTPUT; CHAR(10)
<p>The name of the activity added to the change request description. This is useful when *GEN is specified for the activity name. This parameter is ignored if the activity already exists.</p>
</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>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">CPF2150 E</td>
<td valign="top">Object information function failed.</td>
</tr>
<tr>
<td align="left" valign="top">CPF2151 E</td>
<td valign="top">Operation failed for &amp;2 in &amp;1 type *&amp;3.</td>
</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">CPF3C90 E</td>
<td valign="top">Literal value cannot be changed.</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">CPF9681 E</td>
<td valign="top">Activity &amp;1 already exists.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9682 E</td>
<td valign="top">Element &amp;3 of destination array not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9683 E</td>
<td valign="top">Number of conditions &amp;1 not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9684 E</td>
<td valign="top">Start after time &amp;1 not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9685 E</td>
<td valign="top">Start before time &amp;1 not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9686 E</td>
<td valign="top">Destination format value &amp;1 not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9687 E</td>
<td valign="top">Number of destinations &amp;1 not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9688 E</td>
<td valign="top">Element &amp;3 of condition list array not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9689 E</td>
<td valign="top">Hold value &amp;1 not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF968A E</td>
<td valign="top">Activity name &amp;1 not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF968B E</td>
<td valign="top">Activity type &amp;1 not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF968C E</td>
<td valign="top">Replace value &amp;1 not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF968D E</td>
<td valign="top">Function parameters length &amp;1 not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF968E E</td>
<td valign="top">Condition list or start time cannot be specified.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9691 E</td>
<td valign="top">Start after date &amp;1 not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9692 E</td>
<td valign="top">Start before date &amp;1 not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9696 E</td>
<td valign="top">Generated activity name limit exceeded.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9697 E</td>
<td valign="top">Activity cannot be conditioned on itself.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9698 E</td>
<td valign="top">Maximum size of CRQD &amp;1 exceeded.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9699 E</td>
<td valign="top">Start time not valid.</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">CPF969F E</td>
<td valign="top">Activity &amp;1 already exists in condition list.</td>
</tr>
<tr>
<td align="left" valign="top">CPF96A2 E</td>
<td valign="top">CRQD library name &amp;1 not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF96A4 E</td>
<td valign="top">Activity not added, limit exceeded.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9801 E</td>
<td valign="top">Object &amp;2 in library &amp;3 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9802 E</td>
<td valign="top">Not authorized to object &amp;2 in &amp;3.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9803 E</td>
<td valign="top">Cannot allocate object &amp;2 in library &amp;3.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9804 E</td>
<td valign="top">Object &amp;2 in library &amp;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 &amp;1 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9820 E</td>
<td valign="top">Not authorized to use library &amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9830 E</td>
<td valign="top">Cannot assign library &amp;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 &amp;1 in library &amp;2 ended. Reason code &amp;3.</td>
</tr>
</table>
<br>
<hr>
API introduced: V3R1
<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>