ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/endsbmcrqa.htm

216 lines
7.6 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>End Submitted CRQ Activity (ENDSBMCRQA)</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="ENDSBMCRQA.Top_Of_Page"></a>
<h2>End Submitted CRQ Activity (ENDSBMCRQA)</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="#ENDSBMCRQA.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ENDSBMCRQA.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ENDSBMCRQA.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ENDSBMCRQA"></a>
<p>The End Submitted Change Request Activity (ENDSBMCRQA) command allows you to end one or more change request activities.
</p>
<p><b>Restriction:</b>
</p>
<p>You must be either the submitter of the change request or have *JOBCTL special authority.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDSBMCRQA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ENDSBMCRQA.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="#ENDSBMCRQA.CRQ"><b>CRQ</b></a></td>
<td valign="top">Change request</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Required, Positional 1</td>
</tr>
<tr>
<td valign="top">Element 1: Name</td>
<td valign="top">
<i>Name</i></td>
</tr>
<tr>
<td valign="top">Element 2: Sequence number</td>
<td valign="top">
1-999999</td>
</tr>
<tr>
<td valign="top"><a href="#ENDSBMCRQA.ACTIVITY"><b>ACTIVITY</b></a></td>
<td valign="top">Activity name</td>
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b>, *LAST</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#ENDSBMCRQA.CPNAME"><b>CPNAME</b></a></td>
<td valign="top">Managed system node name</td>
<td valign="top"><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>, <b><u>*ALL</u></b>, *NETATR</td>
</tr>
<tr>
<td valign="top">Element 2: Control point</td>
<td valign="top">
<i>Character value</i>, <b><u>*ALL</u></b>, *NETATR</td>
</tr>
<tr>
<td valign="top"><a href="#ENDSBMCRQA.OPTION"><b>OPTION</b></a></td>
<td valign="top">How to end</td>
<td valign="top"><b><u>*CNTRLD</u></b>, *IMMED, *FRCFAIL</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#ENDSBMCRQA.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ENDSBMCRQA.CRQ"></a>
<h3>Change request (CRQ)</h3>
<p>Specifies the change request name and the change request sequence number for the activities that are to be ended.
</p>
<p>The possible change request name values are:
</p>
<dl>
<dt><b><i>change-request-name</i></b></dt>
<dd>Specify the change request name of the activities to be ended.
</dd>
</dl>
<p>The possible sequence number values are:
</p>
<dl>
<dt><b><i>sequence-number</i></b></dt>
<dd>Specify the change request sequence number of the activities to be ended.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDSBMCRQA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ENDSBMCRQA.ACTIVITY"></a>
<h3>Activity name (ACTIVITY)</h3>
<p>Specifies the activity that is ended.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>End all activities of the specified change request.
</dd>
<dt><b>*LAST</b></dt>
<dd>End the activity named *LAST. This is not the last activity added to the change request description object. This is the last activity to be run after the change request is submitted.
</dd>
<dt><b><i>activity-name</i></b></dt>
<dd>Specify the name of the activity to end.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDSBMCRQA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ENDSBMCRQA.CPNAME"></a>
<h3>Managed system node name (CPNAME)</h3>
<p>Specifies 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>
<p>The possible network identifier values are:
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All activities for the specified control point name are ended.
</dd>
<dt><b>*NETATR</b></dt>
<dd>Only network ID activities that match the ones defined in the network attributes for this system are ended.
</dd>
<dt><b><i>network-identifier</i></b></dt>
<dd>Specify a network ID. Only activities for the network ID and the control point name specified are ended.
</dd>
</dl>
<p>The possible control point values are:
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All activities for the specified network ID are ended.
</dd>
<dt><b>*NETATR</b></dt>
<dd>Only activities for the control point name that match the one defined in the network attributes for this system are ended.
</dd>
<dt><b><i>control-point-name</i></b></dt>
<dd>Specify the APPN control point name of the managed system on which the activity is to be performed. For NetView Distribution Management Agents, the control point name is the change control client which supports numeric characters (0-9) in the first position of control point names that are valid in other platforms.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDSBMCRQA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ENDSBMCRQA.OPTION"></a>
<h3>How to end (OPTION)</h3>
<p>Specifies how the activity is ended.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*CNTRLD</u></b></dt>
<dd>The activity is ended in a controlled manner. Activities that have not started to run are ended. Activities that have already started (Started or Running) only end if they do not leave partial results. The end code returned is 30.
</dd>
<dt><b>*IMMED</b></dt>
<dd>The activity is to be ended as soon as possible even if partial results occur. Activities that have not yet started to run are ended. Activities that have already started (Started or Running) can have their process interrupted which can cause partial results. The end code returned is 35.
</dd>
<dt><b>*FRCFAIL</b></dt>
<dd>The activity is ended immediately. If the activity cannot be ended, it is marked as ended with an end code of 39. Other activities conditioned on this activity are evaluated to determine if they are ready to run.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDSBMCRQA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ENDSBMCRQA.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
ENDSBMCRQA CRQ(CHG001 456) ACTIVITY(*ALL) CPNAME(*ALL)
</pre>
</p>
<p>This command ends all of the activities for the change request named CHG001 with sequence number 456 for all the nodes in a controlled manner.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDSBMCRQA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ENDSBMCRQA.ERROR.MESSAGES">Error messages</a> </h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDSBMCRQA.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>