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

117 lines
4.4 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>End Performance Collection (ENDPFRCOL)</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="ENDPFRCOL.Top_Of_Page"></a>
<h2>End Performance Collection (ENDPFRCOL)</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="#ENDPFRCOL.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ENDPFRCOL.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ENDPFRCOL.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ENDPFRCOL"></a>
<p>The End Performance Collection (ENDPFRCOL) command stops the system-level collection. If there are no other client applications using Collection Services, the Collection Services server job (QYPSPFRCOL) will also end.
</p>
<p>If client applications are using Collection Services, the server job will continue to run unless you also specify the Force end parameter. Forcing the server job to end when it is being used by client applications (for example, iSeries Navigator monitors or Performance Collector APIs) will cause those clients to experience data collection failure.
</p>
<p>Other system functions are capable of starting Collection Services. Even though this command ends the current instance of the server job, it does not prevent the server job from being restarted. Functions which can start the server job include PM iSeries, the Management Central server, and the Performance Collector APIs.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDPFRCOL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ENDPFRCOL.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="#ENDPFRCOL.FRCCOLEND"><b>FRCCOLEND</b></a></td>
<td valign="top">Force end</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional, Positional 1</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#ENDPFRCOL.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ENDPFRCOL.FRCCOLEND"></a>
<h3>Force end (FRCCOLEND)</h3>
<p>Determines whether the Collection Services server job (QYPSPFRCOL) should be forced to end.
</p>
<dl>
<dt><b><u>*NO </u></b></dt>
<dd>The QYPSPFRCOL job will be ended only if it is not being used by a client application.
</dd>
<dt><b>*YES</b></dt>
<dd>The QYPSPFRCOL job will be forced to end immediately.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDPFRCOL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ENDPFRCOL.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Ending the Performance Collection</b>
</p>
<p>
<pre>
ENDPFRCOL
</pre>
</p>
<p>This command will end the system-level collection of performance data. If no client applications are using Collection Services, this command will also end the Collection Services server job (QYPSPFRCOL). If client applications are using Collection Services, the QYPSPFRCOL job will continue to run.
</p>
<p><b>Example 2: Forcing the Performance Collection to End</b>
</p>
<p>
<pre>
ENDPFRCOL FRCCOLEND(*YES)
</pre>
</p>
<p>This command will force the Collection Services server job (QYPSPFRCOL) to end, even if it is being used by client applications.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDPFRCOL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ENDPFRCOL.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF3CF2</b></dt>
<dd>Error(s) occurred during running of &amp;1 API.
</dd>
<dt><b>CPFB94A</b></dt>
<dd>Collector communications error. Reason code &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDPFRCOL.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>