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

193 lines
6.3 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>Hold Submitted CRQ Activity (HLDSBMCRQA)</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="HLDSBMCRQA.Top_Of_Page"></a>
<h2>Hold Submitted CRQ Activity (HLDSBMCRQA)</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="#HLDSBMCRQA.PARAMETERS.TABLE">Parameters</a><br>
<a href="#HLDSBMCRQA.COMMAND.EXAMPLES">Examples</a><br>
<a href="#HLDSBMCRQA.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="HLDSBMCRQA"></a>
<p>The Hold Submitted Change Request Activity (HLDSBMCRQA) command holds one or more change request activities.
</p>
<p><b>Restrictions:</b>
</p>
<ol>
<li>Only activities that have a status of Wait, Scheduled, or Ready can be held.
</li>
<li>You must be either the submitter of the change request, or have *JOBCTL special authority.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#HLDSBMCRQA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="HLDSBMCRQA.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="#HLDSBMCRQA.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="#HLDSBMCRQA.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="#HLDSBMCRQA.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>
</table>
<table width="100%">
<tr><td align="right"><a href="#HLDSBMCRQA.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="HLDSBMCRQA.CRQ"></a>
<h3>Change request (CRQ)</h3>
<p>Specifies the change request name and the change request sequence number of the activities held.
</p>
<p>The possible change request name value is:
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><i>change-request-name</i></b></dt>
<dd>Specify the change request name of the activities that are held.
<p>The possible sequence number value is:
</p>
</dd>
<dt><b><i>sequence-number</i></b></dt>
<dd>Specify the change request sequence number of the activities to be held.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#HLDSBMCRQA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="HLDSBMCRQA.ACTIVITY"></a>
<h3>Activity name (ACTIVITY)</h3>
<p>Specifies the activity to hold.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Hold all of the specified change request activities.
</dd>
<dt><b>*LAST</b></dt>
<dd>Hold the activity named *LAST. This is not the last activity added to the change request description object. This is the last activity run after the change request is submitted.
</dd>
<dt><b><i>activity-name</i></b></dt>
<dd>Specify the name of the activity to hold.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#HLDSBMCRQA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="HLDSBMCRQA.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 held.
</dd>
<dt><b>*NETATR</b></dt>
<dd>Specify that only activities for the network ID matching the one defined in the network attributes for this system are held.
</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 held.
</dd>
</dl>
<p>The control point values are:
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All activities for the specified network ID are held.
</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 held.
</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="#HLDSBMCRQA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="HLDSBMCRQA.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
HLDSBMCRQA CRQ(CHG001 456)
</pre>
</p>
<p>This command holds all of the activities for the change request named CHG001 with sequence number 456 for all the nodes.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#HLDSBMCRQA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="HLDSBMCRQA.ERROR.MESSAGES">Error messages</a> </h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#HLDSBMCRQA.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>