140 lines
5.3 KiB
HTML
140 lines
5.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>Remove PEX Filter (RMVPEXFTR)</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="RMVPEXFTR.Top_Of_Page"></a>
|
||
|
|
<h2>Remove PEX Filter (RMVPEXFTR)</h2>
|
||
|
|
<table width="100%">
|
||
|
|
<tr>
|
||
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
||
|
|
<b>Threadsafe: </b>Conditional
|
||
|
|
</td>
|
||
|
|
<td valign="top" align="right">
|
||
|
|
<a href="#RMVPEXFTR.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#RMVPEXFTR.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#RMVPEXFTR.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="RMVPEXFTR"></a>
|
||
|
|
<p>The Remove Performance Explorer Filter (RMVPEXFTR) command removes one or more Performance Explorer filters from the system. Each filter is stored as a member in the QAPEXFTR file in library QUSRSYS. The member name is the same as the filter name.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>This command is shipped with public *EXCLUDE authority.
|
||
|
|
</li>
|
||
|
|
<li>To use this command you must have *SERVICE special authority, or be authorized to the Service Trace function of i5/OS through iSeries Navigator's Application Administration support. The Change Function Usage Information (QSYCHFUI) API, with a function ID of QIBM_SERVICE_TRACE, can also be used to change the list of users that are allowed to perform trace operations.
|
||
|
|
</li>
|
||
|
|
<li>The following user profiles have private authorities to use the command:
|
||
|
|
<ul>
|
||
|
|
<li>QPGMR
|
||
|
|
</li>
|
||
|
|
<li>QSRV
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>Two threads within the same job will not be allowed to run RMVPEXFTR at the same time. The thread that issued RMVPEXFTR first will run the command to completion while the second RMVPEXFTR waits.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RMVPEXFTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="RMVPEXFTR.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="#RMVPEXFTR.FTR"><b>FTR</b></a></td>
|
||
|
|
<td valign="top">Filter</td>
|
||
|
|
<td valign="top"><i>Generic name, name</i>, *ALL</td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RMVPEXFTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="RMVPEXFTR.FTR"></a>
|
||
|
|
<h3>Filter (FTR)</h3>
|
||
|
|
<p>Specifies the name of the Performance Explorer filter being removed. A specific or generic filter name, or *ALL, can be specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All Performance Explorer filters are removed.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>generic*-filter-name</i></b></dt>
|
||
|
|
<dd>Specify the generic name of the Performance Explorer filter to be removed. A generic name is a character string of one or more characters followed by an asterisk (*); for 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. For more information about generic object names, see the i5/OS objects topic under Programming->CL in the iSeries Information Center at the Web site: http://www.ibm.com/eserver/iseries/infocenter
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>filter-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the Performance Explorer filter to be removed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RMVPEXFTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="RMVPEXFTR.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Removing a Single Filter</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
RMVPEXFTR FTR(SAMPLE)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command removes the member named SAMPLE from file QAPEXFTR in library QUSRSYS that contains the performance explorer filter named SAMPLE.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Removing All Filters that Start with SAM</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
RMVPEXFTR FTR(SAM*)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command removes all filters with names that start with SAM by removing all members that start with SAM from file QAPEXFTR in library QUSRSYS.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RMVPEXFTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="RMVPEXFTR.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF3203</b></dt>
|
||
|
|
<dd>Cannot allocate object for file &1 in &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3220</b></dt>
|
||
|
|
<dd>Cannot do operation on file &1 in &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF7301</b></dt>
|
||
|
|
<dd>&5 members not removed from file &2 in &3.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF7310</b></dt>
|
||
|
|
<dd>Member &1 not removed from file &2 in &3.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RMVPEXFTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|