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

112 lines
3.8 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>Remove Trace Filter (RMVTRCFTR)</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="RMVTRCFTR.Top_Of_Page"></a>
<h2>Remove Trace Filter (RMVTRCFTR)</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="#RMVTRCFTR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RMVTRCFTR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RMVTRCFTR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RMVTRCFTR"></a>
<p>The Remove Trace Filter (RMVTRCFTR) command removes one or more trace filters from the system.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>You must have service (*SERVICE) special authority, or be authorized to the Service Trace function of Operating System through iSeries Navigator's Application Administration support. The Change Function Usage Information (CHGFCNUSG) command can also be used to change the list of users that are allowed to perform trace operations.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVTRCFTR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RMVTRCFTR.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"><a href="#RMVTRCFTR.FTR"><b>FTR</b></a></td>
<td valign="top">Filter</td>
<td valign="top"><i>Generic name, name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#RMVTRCFTR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RMVTRCFTR.FTR"></a>
<h3>Filter (FTR)</h3>
<p>Specifies the trace filter to be removed. A specific or generic filter name can be specified.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>generic-name</i></b></dt>
<dd>Specify the generic name of the trace filter to be removed. A generic name is a character string of one or more characters followed by an asterisk (*); or example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete object name.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the trace filter to be removed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVTRCFTR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVTRCFTR.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Removing a Single Filter</b>
</p>
<p>
<pre>
RMVTRCFTR FTR(SAMPLE)
</pre>
</p>
<p>This command removes the trace filter named SAMPLE.
</p>
<p><b>Example 2: Removing All Filters that Start with SAM</b>
</p>
<p>
<pre>
RMVTRCFTR FTR(SAM*)
</pre>
</p>
<p>This command removes all trace filters with names that start with SAM.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVTRCFTR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RMVTRCFTR.ERROR.MESSAGES">Error messages</a></h3>Unknown
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVTRCFTR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>