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

158 lines
5.3 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Remove Routing Entry (RMVRTGE)</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="RMVRTGE.Top_Of_Page"></a>
<h2>Remove Routing Entry (RMVRTGE)</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="#RMVRTGE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RMVRTGE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RMVRTGE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RMVRTGE"></a>
<p>The Remove Routing Entry (RMVRTGE) command removes a routing entry from the specified subsystem description. The subsystem can be active at the time the command is run.
</p>
<p><b>Restrictions:</b>
</p>
<ol>
<li>To use this command, you must have:
<ul>
<li>object operational (*OBJOPR), object management (*OBJMGT), and read (*READ) authority to the specified subsystem description and execute (*EXECUTE) authority to the library containing the subsystem description.
</li>
</ul>
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVRTGE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RMVRTGE.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="#RMVRTGE.SBSD"><b>SBSD</b></a></td>
<td valign="top">Subsystem description</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Required, Positional 1</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Subsystem 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="#RMVRTGE.SEQNBR"><b>SEQNBR</b></a></td>
<td valign="top">Routing entry sequence number</td>
<td valign="top">1-9999</td>
<td valign="top">Required, Positional 2</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#RMVRTGE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RMVRTGE.SBSD"></a>
<h3>Subsystem description (SBSD)</h3>
<p>Specifies the name and library of the subsystem description that contains the routing entry being removed.
</p>
<p>This is a required parameter.
</p>
<p><b>Qualifier 1: Subsystem description</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the subsystem description from which the routing entry is being removed.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the thread's library list are searched until a match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the thread is used to locate the object. If no library is specified as the current library for the thread, the QGPL library is used.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the subsystem description's library from which the routing entry is being removed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVRTGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVRTGE.SEQNBR"></a>
<h3>Routing entry sequence number (SEQNBR)</h3>
<p>Specifies the sequence number of the routing entry being removed. The sequence numbers on the routing entries indicate the order that the routing entries will be processed when comparing values. When a job enters the system, the compare value for the job is compared to the compare value for the routing entries in a subsystem. When the first match is found, the routing information for that entry is used for the new job; therefore, the sequence numbers indicate the compare order.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>1-9999</i></b></dt>
<dd>Specify a sequence number between 1 and 9999.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVRTGE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVRTGE.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
RMVRTGE SBSD(OR/PERT) SEQNBR(9912)
</pre>
</p>
<p>This command removes the routing entry 9912 from subsystem description PERT in library OR.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVRTGE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVRTGE.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF1619</b></dt>
<dd>Subsystem description &amp;1 in library &amp;2 damaged.
</dd>
<dt><b>CPF1691</b></dt>
<dd>Active subsystem description may or may not have changed.
</dd>
<dt><b>CPF1697</b></dt>
<dd>Subsystem description &amp;1 not changed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVRTGE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>