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

140 lines
5.1 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 PEX Definition (RMVPEXDFN)</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="RMVPEXDFN.Top_Of_Page"></a>
<h2>Remove PEX Definition (RMVPEXDFN)</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="#RMVPEXDFN.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RMVPEXDFN.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RMVPEXDFN.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RMVPEXDFN"></a>
<p>The Remove Performance Explorer Definition (RMVPEXDFN) command removes one or more Performance Explorer definitions from the system. Each definition is stored as a member in the QAPEXDFN file in library QUSRSYS. The member name is the same as the definition 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 RMVPEXDFN at the same time. The thread that issued RMVPEXDFN first will run the command to completion while the second RMVPEXDFN waits.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVPEXDFN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RMVPEXDFN.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="#RMVPEXDFN.DFN"><b>DFN</b></a></td>
<td valign="top">Definition</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="#RMVPEXDFN.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RMVPEXDFN.DFN"></a>
<h3>Definition (DFN)</h3>
<p>Specifies the name of the Performance Explorer definition being removed. A specific or generic definition name, or *ALL, can be specified.
</p>
<dl>
<dt><b>*ALL</b></dt>
<dd>All Performance Explorer definitions are removed.
</dd>
<dt><b><i>definition-name</i></b></dt>
<dd>Specify the name of the Performance Explorer definition to be removed.
</dd>
<dt><b><i>generic*-definition-name</i></b></dt>
<dd>Specify the generic name of the Performance Explorer definition 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.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVPEXDFN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVPEXDFN.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Removing a Single Definition</b>
</p>
<p>
<pre>
RMVPEXDFN DFN(SAMPLE)
</pre>
</p>
<p>This command removes the member named SAMPLE from file QAPEXDFN in library QUSRSYS that contains the performance explorer definition named SAMPLE.
</p>
<p><b>Example 2: Removing All Definitions that Start with SAM</b>
</p>
<p>
<pre>
RMVPEXDFN DFN(SAM*)
</pre>
</p>
<p>This command removes all definitions with names that start with SAM by removing all members that start with SAM from file QAPEXDFN in library QUSRSYS.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVPEXDFN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVPEXDFN.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 &amp;1 in &amp;2.
</dd>
<dt><b>CPF3220</b></dt>
<dd>Cannot do operation on file &amp;1 in &amp;2.
</dd>
<dt><b>CPF7301</b></dt>
<dd>&amp;5 members not removed from file &amp;2 in &amp;3.
</dd>
<dt><b>CPF7310</b></dt>
<dd>Member &amp;1 not removed from file &amp;2 in &amp;3.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVPEXDFN.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>