665 lines
23 KiB
HTML
665 lines
23 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">
|
||
|
|
<title>Change License CRQ Activity (CHGLICCRQA)</title>
|
||
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
||
|
|
</head>
|
||
|
|
<body bgcolor="white">
|
||
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<a name="CHGLICCRQA.Top_Of_Page"></a>
|
||
|
|
<h2>Change License CRQ Activity (CHGLICCRQA)</h2>
|
||
|
|
<table width="100%">
|
||
|
|
<tr>
|
||
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
||
|
|
<b>Threadsafe: </b>No
|
||
|
|
</td>
|
||
|
|
<td valign="top" align="right">
|
||
|
|
<a href="#CHGLICCRQA.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CHGLICCRQA.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CHGLICCRQA.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CHGLICCRQA"></a>
|
||
|
|
<p>The Change License CRQ Activity (CHGLICCRQA) command changes a license key distribution activity in a change request description.
|
||
|
|
</p>
|
||
|
|
<p>A prompt override program will be provided to display the current activity information.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>This command is shipped with public *EXCLUDE authority.
|
||
|
|
</li>
|
||
|
|
<li>The user must have *CHANGE authority to the change request description object and *EXECUTE authority to the library.
|
||
|
|
</li>
|
||
|
|
<li>The user changing the activity does not need to be authorized to any objects that are to be manipulated.
|
||
|
|
</li>
|
||
|
|
<li>If a node list (NODL) value is specified, the node list can only contain entries that have a value of *SNA for the address type.
|
||
|
|
</li>
|
||
|
|
<li>The license key information does not need to exist in the license repository when a license activity is being added to a change request, but it must exist by the time the activity runs.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<p><b>Notes:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>All conditions must be satisfied before the activity can be performed.
|
||
|
|
</li>
|
||
|
|
<li>The start times indicate when the activity can be started. Actual start times may be later due to network and system delays.
|
||
|
|
</li>
|
||
|
|
<li>All the existing records in the central site license repository containing the license key information for the specified product will be sent to the specified managed system or systems Only those ones that match the system serial number are added to the managed system license repository.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGLICCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CHGLICCRQA.PARAMETERS.TABLE">Parameters</a></h3>
|
||
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
||
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
||
|
|
<tr>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CHGLICCRQA.CRQD"><b>CRQD</b></a></td>
|
||
|
|
<td valign="top">Change request description</td>
|
||
|
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Required, Key, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Change request description</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#CHGLICCRQA.ACTIVITY"><b>ACTIVITY</b></a></td>
|
||
|
|
<td valign="top">Activity</td>
|
||
|
|
<td valign="top"><i>Name</i>, *LAST</td>
|
||
|
|
<td valign="top">Required, Key, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGLICCRQA.ACTION"><b>ACTION</b></a></td>
|
||
|
|
<td valign="top">Action</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *SND</td>
|
||
|
|
<td valign="top">Optional, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGLICCRQA.PRDID"><b>PRDID</b></a></td>
|
||
|
|
<td valign="top">Product ID</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *ALL</td>
|
||
|
|
<td valign="top">Optional, Positional 4</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGLICCRQA.LICTRM"><b>LICTRM</b></a></td>
|
||
|
|
<td valign="top">License term</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *ALL</td>
|
||
|
|
<td valign="top">Optional, Positional 5</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#CHGLICCRQA.NODL"><b>NODL</b></a></td>
|
||
|
|
<td valign="top">Managed systems node list</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="4">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Node list</td>
|
||
|
|
<td valign="top">
|
||
|
|
Single values: <b><u>*SAME</u></b>, *NONE<br>Other values: <i>Qualified object name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Qualifier 1: Node list</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CHGLICCRQA.CPNAME"><b>CPNAME</b></a></td>
|
||
|
|
<td valign="top">Managed system node names</td>
|
||
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values (up to 50 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Network identifier</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Communications name</i>, *NETATR</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Control point</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Communications name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGLICCRQA.TEXT"><b>TEXT</b></a></td>
|
||
|
|
<td valign="top">Text 'description'</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *GEN, *BLANK</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="5"><a href="#CHGLICCRQA.COND"><b>COND</b></a></td>
|
||
|
|
<td valign="top">Activity conditions</td>
|
||
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values (up to 5 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="5">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Activity</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Generic name, name</i>, <b><u>*PRV</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Relational operator</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*EQ</u></b>, *GT, *LT, *LE, *NE, *GE</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: End code</td>
|
||
|
|
<td valign="top">
|
||
|
|
0-99, <b><u>*SUCCESS</u></b>, *FAIL, *NOTRUN, *ANY</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 4: Condition mode</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*ALLNODES</u></b>, *SAMENODE</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="7"><a href="#CHGLICCRQA.STRTIME"><b>STRTIME</b></a></td>
|
||
|
|
<td valign="top">Activity start time</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="7">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Start after</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Element list</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 1: Time</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Time</i>, <b><u>*SAME</u></b>, *CURRENT</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 2: Date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Date</i>, <b><u>*SAME</u></b>, *CURRENT, *NEXT</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Start before</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Element list</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 1: Time</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Time</i>, <b><u>*SAME</u></b>, *ANY, *CURRENT</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 2: Date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Date</i>, <b><u>*SAME</u></b>, *ANY, *CURRENT, *NEXT</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGLICCRQA.HOLD"><b>HOLD</b></a></td>
|
||
|
|
<td valign="top">Hold activity</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGLICCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CHGLICCRQA.CRQD"></a>
|
||
|
|
<h3>Change request description (CRQD)</h3>
|
||
|
|
<p>Change request description object name.
|
||
|
|
</p>
|
||
|
|
<p>The possible library values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>All of the libraries in the user and system portions of the job's library list are searched.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the job is used to locate the object.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Only the library named in this parameter is searched.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible value for the change request description is:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>change-request-description</i></b></dt>
|
||
|
|
<dd>The name of the change request description object.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGLICCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGLICCRQA.ACTIVITY"></a>
|
||
|
|
<h3>Activity (ACTIVITY)</h3>
|
||
|
|
<p>The name of the activity to change in the change request description.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*LAST</b></dt>
|
||
|
|
<dd>The activity is the last to run in the change request. Only one activity named *LAST can exist in the change request description.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>activity-name</i></b></dt>
|
||
|
|
<dd>A 10-character activity name.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGLICCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGLICCRQA.ACTION"></a>
|
||
|
|
<h3>Action (ACTION)</h3>
|
||
|
|
<p>The license distribution function that is to be performed.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SND</b></dt>
|
||
|
|
<dd>Send the license keys of the specified product and license term to the specified managed systems.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGLICCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGLICCRQA.PRDID"></a>
|
||
|
|
<h3>Product ID (PRDID)</h3>
|
||
|
|
<p>Specify the 7-character identifier of the product for which the license key information will be distribution.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>The license keys for all the products existing in the central site license repository will be distributed.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>Product-Identifier</i></b></dt>
|
||
|
|
<dd>Specifies the 7-character identifier of the product for which the license key information will be distributed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGLICCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGLICCRQA.LICTRM"></a>
|
||
|
|
<h3>License term (LICTRM)</h3>
|
||
|
|
<p>Specifies the license term for which the licenses key information will be sent.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>The product licenses for all license term found will be sent.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>license-term</i></b></dt>
|
||
|
|
<dd>Specify the license term in one of the following formats:
|
||
|
|
<dl>
|
||
|
|
<dt><b>Vx</b></dt>
|
||
|
|
<dd>The authorized usage limit is valid for the entire version of the product or feature.
|
||
|
|
</dd>
|
||
|
|
<dt><b>VxRy</b></dt>
|
||
|
|
<dd>The authorized usage limit is valid for the entire release of the product or feature.
|
||
|
|
</dd>
|
||
|
|
<dt><b>VxRyMz</b></dt>
|
||
|
|
<dd>The authorized usage limit is valid only for a modification of the product.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>where x and y can be a number from 0 through 9, and z can be a number 0 through 9 or a letter A through Z.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGLICCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGLICCRQA.NODL"></a>
|
||
|
|
<h3>Managed systems node list (NODL)</h3>
|
||
|
|
<p>Node list object name that contains a list of systems that are the destinations for the request. Cannot be specified if the control point names (CPNAME) parameter is also specified
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>The systems on which this activity is to be performed are not identified by a node list. Individual control point names must be specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible library values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*LIBL</b></dt>
|
||
|
|
<dd>All of the libraries in the user and system portions of the job's library list are searched for the node list object.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the job is used to locate the node list object.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Only the library named in this keyword is searched.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible value for the node list name is:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>node-list-name</i></b></dt>
|
||
|
|
<dd>Node list object name which contains the list of systems on which the command is to be performed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGLICCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGLICCRQA.CPNAME"></a>
|
||
|
|
<h3>Managed system node names (CPNAME)</h3>
|
||
|
|
<p>The APPN control point names of the managed systems on which this activity is to be performed. Control point names cannot be specified if the node list (NODL) parameter is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>The systems on which this activity is to be performed are not identified individually. A node list must be specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NETATR</b></dt>
|
||
|
|
<dd>The network ID of the local system will be used. This is useful when the node being specified is in the same network as the local system.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>network-identifier</i></b></dt>
|
||
|
|
<dd>The APPN network identifier of the managed system on which the activity is to be performed, it is a character field of length 8.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>control-point-name</i></b></dt>
|
||
|
|
<dd>The APPN control point name of the managed system on which the activity is to be performed, it is a character field of length 8.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGLICCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGLICCRQA.TEXT"></a>
|
||
|
|
<h3>Text 'description' (TEXT)</h3>
|
||
|
|
<p>Specifies the activity description.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*GEN</b></dt>
|
||
|
|
<dd>A text description is generated based upon the action chosen.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>text-description</i></b></dt>
|
||
|
|
<dd>Specify a 50-character description of the activity.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGLICCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGLICCRQA.COND"></a>
|
||
|
|
<h3>Activity conditions (COND)</h3>
|
||
|
|
<p>Specifies which conditions must be met before this activity can be performed. Each condition identifies an activity that must be run before this activity and the value the end codes from that activity must have to allow this activity to run. The default condition is that the previous activity (in alphabetical order) must complete successfully before this activity can be run.
|
||
|
|
</p>
|
||
|
|
<p>The possible single values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>There are no conditions for this activity.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible conditioning activity values are:
|
||
|
|
</p>
|
||
|
|
<p>This is the activity that must be run before this activity.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*PRV</b></dt>
|
||
|
|
<dd>This activity is conditioned on the previous activity. Activities are ordered alphabetically by activity name. If the activity being added is the first activity, a previous activity does not exist and any condition with *PRV is marked as having been met.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>conditioning-activity-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the activity that must be run before this activity. The activity name specified in the activity (ACTIVITY) parameter cannot be specified in the conditioning activity name. An activity cannot be conditioned on itself.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>generic*-conditioning-activity-name</i></b></dt>
|
||
|
|
<dd>Specify the generic name of the activities that must be run before this activity.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible relational operator values are:
|
||
|
|
</p>
|
||
|
|
<p>This element is the relational operator to use when comparing the end code from the conditioning activity.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*EQ</b></dt>
|
||
|
|
<dd>Equal
|
||
|
|
</dd>
|
||
|
|
<dt><b>*GT</b></dt>
|
||
|
|
<dd>Greater than
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LT</b></dt>
|
||
|
|
<dd>Less than
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NE</b></dt>
|
||
|
|
<dd>Not equal
|
||
|
|
</dd>
|
||
|
|
<dt><b>*GE</b></dt>
|
||
|
|
<dd>Greater than or equal
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LE</b></dt>
|
||
|
|
<dd>Less than or equal
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible conditioning code results are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*SUCCESS</b></dt>
|
||
|
|
<dd>The activity ended successfully (0 <= end code <= 9). This end code can only be specified with relational operator *EQ or *NE.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FAIL</b></dt>
|
||
|
|
<dd>The activity failed (10 <= end code <= 89). This end code can only be specified with relational operator *EQ or *NE.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOTRUN</b></dt>
|
||
|
|
<dd>The activity was never started (90 <= end code <= 99). This end code is only specified with relational operator *EQ or *NE.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ANY</b></dt>
|
||
|
|
<dd>The activity ended with any end code. This end code is only specified with relational operator *EQ.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>end-code</i></b></dt>
|
||
|
|
<dd>Specify an integer value (0-99) that indicates the result of an activity (success or failure). The end codes used by the change request manager and recommended for applications are:
|
||
|
|
<dl>
|
||
|
|
<dt><b>00</b></dt>
|
||
|
|
<dd>Activity completed successfully.
|
||
|
|
</dd>
|
||
|
|
<dt><b>01-09</b></dt>
|
||
|
|
<dd>Activity completed with warning messages.
|
||
|
|
</dd>
|
||
|
|
<dt><b>10-29</b></dt>
|
||
|
|
<dd>Activity did not complete successfully.
|
||
|
|
</dd>
|
||
|
|
<dt><b>30-39</b></dt>
|
||
|
|
<dd>Activity was canceled by a user before it completed.
|
||
|
|
<ul>
|
||
|
|
<li>30 = Activity ended with *CNTRLD option
|
||
|
|
</li>
|
||
|
|
<li>35 = Activity ended with *IMMED option
|
||
|
|
</li>
|
||
|
|
<li>39 = Activity ended with *FRCFAIL option
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
<dt><b>40-49</b></dt>
|
||
|
|
<dd>Activity was not run due to errors detected by the application.
|
||
|
|
<ul>
|
||
|
|
<li>40 = Activity not run for security reasons
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
<dt><b>90-99</b></dt>
|
||
|
|
<dd>Activity was not run because conditions or schedules were not met.
|
||
|
|
<ul>
|
||
|
|
<li>95 = Scheduled start time expired
|
||
|
|
</li>
|
||
|
|
<li>99 = Conditions cannot be met
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible conditioning mode values are:
|
||
|
|
</p>
|
||
|
|
<p>The condition mode indicates which systems the conditioning activity must have completed on before this activity can be performed.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALLNODES</b></dt>
|
||
|
|
<dd>The conditioning activity specified must have completed on all nodes before this activity runs.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SAMENODE</b></dt>
|
||
|
|
<dd>When the conditioning activity specified completes for a given node, the activity specified on the ACTIVITY parameter may run for that same node even though the conditioning activity specified may not have completed for all other nodes. In the case where this activity lists a node not in the conditioning activity, this activity may run for that node; the condition is ignored.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible value is:
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGLICCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGLICCRQA.STRTIME"></a>
|
||
|
|
<h3>Activity start time (STRTIME)</h3>
|
||
|
|
<p>Specifies the date and time when this activity can start on the central site system. The current date and time values and next date values are determined when the change request is submitted.
|
||
|
|
</p>
|
||
|
|
<p>The possible start after time values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURRENT</b></dt>
|
||
|
|
<dd>This activity can start any time on or after the time when the change request was submitted.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>start-after-time</i></b></dt>
|
||
|
|
<dd>Specify the time when this activity can start. The time can be entered as 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds. Seconds are optional. The time can be specified with or without a time separator such as a colon (:). With a time separator, specify a string of 5 or 8 digits (hh:mm or hh:mm:ss).
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible start after date values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURRENT</b></dt>
|
||
|
|
<dd>This activity can start on or after the date on which the change request is submitted.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NEXT</b></dt>
|
||
|
|
<dd>The activity can start on any date after the date the change request is submitted.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>start-after-date</i></b></dt>
|
||
|
|
<dd>Specify the date after this activity can start. The date must be specified in the job date format.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible start before time values are:
|
||
|
|
</p>
|
||
|
|
<p>This element is ignored if the start before date is *ANY.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ANY</b></dt>
|
||
|
|
<dd>The activity can start at any time on or before the start before date.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURRENT</b></dt>
|
||
|
|
<dd>The activity must start before the time when the change request was submitted on the date specified on the start before date element.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>start-before-time</i></b></dt>
|
||
|
|
<dd>Specify the time before the activity must be started. If the activity cannot be started before this time, it never starts. The time can be entered as 4 or 6 digits (hhmm or hhmmss) where h = hours, m = minutes, and s = seconds. Seconds are optional. The time can be specified with or without a time separator such as a colon (:). With a time separator, specify a string of 5 or 8 digits (hh:mm or hh:mm:ss).
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible start before date values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ANY</b></dt>
|
||
|
|
<dd>The activity can start at any time after the start after time and the start after date.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURRENT</b></dt>
|
||
|
|
<dd>The activity must start on the date the change request is submitted.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NEXT</b></dt>
|
||
|
|
<dd>The activity must start by the day after the date the change request is submitted.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>start-before-date</i></b></dt>
|
||
|
|
<dd>Specify the date before the activity must start. If the activity cannot be started by this date, it never starts. The date must be specified in the job date format.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGLICCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGLICCRQA.HOLD"></a>
|
||
|
|
<h3>Hold activity (HOLD)</h3>
|
||
|
|
<p>Specifies that the activity be held when the change request is submitted.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>The activity is not held and will run when all conditions are met.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The activity is held for all nodes when the change request is submitted. It must be released by a user before it will run.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGLICCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CHGLICCRQA.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Changing an activity to send</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGLICCRQA CRQD(MYLIB/CR1) ACTIVITY(ACT01) ACTION(*SND)
|
||
|
|
PRDID(1ACCOUN) LICTRM(V5R2M0)
|
||
|
|
CPNAME((*NETATR SYS1))
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>Change an activity to send the licenses for the 1ACCOUN product, with a license term of V5R2M0, to the license repository of the iSeries server SYS1. If 1ACCOUN product is installed on the managed system, the license is also activated.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGLICCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CHGLICCRQA.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p>None
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGLICCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|