200 lines
7.6 KiB
HTML
200 lines
7.6 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>Start Performance Explorer (STRPEX)</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="STRPEX.Top_Of_Page"></a>
|
||
|
|
<h2>Start Performance Explorer (STRPEX)</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="#STRPEX.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#STRPEX.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#STRPEX.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="STRPEX"></a>
|
||
|
|
<p>The Start Performance Explorer (STRPEX) command starts a new Performance Explorer session or resumes a suspended Performance Explorer session.
|
||
|
|
</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 STRPEX at the same time. The thread that issued STRPEX first will run the command to completion while the second STRPEX waits.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPEX.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="STRPEX.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="#STRPEX.SSNID"><b>SSNID</b></a></td>
|
||
|
|
<td valign="top">Session ID</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
<td valign="top">Required, Key, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRPEX.OPTION"><b>OPTION</b></a></td>
|
||
|
|
<td valign="top">Option</td>
|
||
|
|
<td valign="top"><b><u>*NEW</u></b>, *INZONLY, *RESUME</td>
|
||
|
|
<td valign="top">Optional, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRPEX.DFN"><b>DFN</b></a></td>
|
||
|
|
<td valign="top">Definition</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*SELECT</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRPEX.FTR"><b>FTR</b></a></td>
|
||
|
|
<td valign="top">Filter</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b>, *SELECT</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPEX.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="STRPEX.SSNID"></a>
|
||
|
|
<h3>Session ID (SSNID)</h3>
|
||
|
|
<p>Specifies an identifier for this Performance Explorer session. This name must be unique within the active sessions of the Performance Explorer tool.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>session-identifier</i></b></dt>
|
||
|
|
<dd>Specify the session identifier for a new or suspended Performance Explorer session.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPEX.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPEX.OPTION"></a>
|
||
|
|
<h3>Option (OPTION)</h3>
|
||
|
|
<p>Specifies whether a new session should be started or a session which is currently suspended should be resumed.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NEW</u></b></dt>
|
||
|
|
<dd>A new session of the Performance Explorer tool is started. Performance data collection begins as soon as the session has been established.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*INZONLY</b></dt>
|
||
|
|
<dd>A new Performance Explorer session is started, but once the session is established, it is suspended. This option allows the user to perform the setup for a particular session before the scenario to be monitored is started. To begin data collection, the user must invoke this command again specifying the same session identifier and OPTION(*RESUME).
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RESUME</b></dt>
|
||
|
|
<dd>A suspended Performance Explorer session is resumed. The session was suspended either by specifying OPTION(*SUSPEND) on the ENDPEX command or by specifying OPTION(*INZONLY) on a previous STRPEX command.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPEX.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPEX.DFN"></a>
|
||
|
|
<h3>Definition (DFN)</h3>
|
||
|
|
<p>Specifies the name of the Performance Explorer definition to use when starting a new Performance Explorer session. The definition identifies the performance data to be collected. This parameter is required in order to start a new Performance Explorer session. This parameter cannot be specified when resuming a suspended session, since the suspended session already has an associated Performance Explorer definition.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>definition-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the Performance Explorer definition.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPEX.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPEX.FTR"></a>
|
||
|
|
<h3>Filter (FTR)</h3>
|
||
|
|
<p>Specifies the name of the Performance Explorer filter to use when starting a new Performance Explorer session. The filter determines which events are collected based on the filter values which are compared to the event's actual data. If a filter is not specified, then all events in the definition are collected. This parameter cannot be specified when resuming a suspended session.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SELECT</u></b></dt>
|
||
|
|
<dd>A list of existing filters will be displayed for user selection. This value is valid only if the command is run in an interactive job.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>filter-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the Performance Explorer filter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPEX.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="STRPEX.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Start a New Session</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRPEX SSNID(TESTRUN2) DFN(NEWDESC) OPTION(*NEW)
|
||
|
|
FTR(MYFILTER)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command starts a new session of the performance explorer using the criteria identified in a definition named NEWDESC and a filter named MYFILTER. The new session name is TESTRUN2.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Resume a Suspended Session</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRPEX SSNID(TESTRUN1) OPTION(*RESUME)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command resumes an already existing session of the performance explorer named TESTRUN1.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPEX.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="STRPEX.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<h3>Error messages for RMVPEXDFN</h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPFAF05</b></dt>
|
||
|
|
<dd>STRPEX command was not successful. Reason code is &1. See details for more information.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPFAF11</b></dt>
|
||
|
|
<dd>Unable to locate program, object, library, or file member as specified in the definition or filter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPEX.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|