1348 lines
45 KiB
HTML
1348 lines
45 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>Add PEX Filter (ADDPEXFTR)</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="ADDPEXFTR.Top_Of_Page"></a>
|
|
<h2>Add PEX Filter (ADDPEXFTR)</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="#ADDPEXFTR.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ADDPEXFTR.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ADDPEXFTR.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ADDPEXFTR"></a>
|
|
<p>The Add Performance Explorer Filter (ADDPEXFTR) command adds a new Performance Explorer (PEX) filter to the system. Each filter is stored as a member in the QAPEXFTR file in library QUSRSYS. A Performance Explorer filter identifies the performance data that is to be collected during a Performance Explorer session, and is meant to limit the amount of data collected by specifying a compare value for specific events. If the data in the event matches the compare value, then the data will be collected. If not, the data is discarded. The filter is specified on the STRPEX (Start Performance Explorer) command.
|
|
</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>You must have *EXECUTE authority to the libraries for PGMTRG, PGMFTR, OBJFTR, and *X authority to the directories for JVATRG, JVAFTR, JVACLSFTR, and PATHFTR if these parameters are specified.
|
|
</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 ADDPEXFTR at the same time. The thread that issued ADDPEXFTR first will run the command to completion while the second ADDPEXFTR waits.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPEXFTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ADDPEXFTR.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="#ADDPEXFTR.FTR"><b>FTR</b></a></td>
|
|
<td valign="top">Filter</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="8"><a href="#ADDPEXFTR.PGMTRG"><b>PGMTRG</b></a></td>
|
|
<td valign="top">Program trigger</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="8">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Program</td>
|
|
<td valign="top">
|
|
<i>Qualified object name</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 1: Program</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Element 2: Module</td>
|
|
<td valign="top">
|
|
<i>Name</i>, *ALL</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: Procedure</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*PEP</u></b>, *ALL</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 4: Type</td>
|
|
<td valign="top">
|
|
<b><u>*PGM</u></b>, *SRVPGM</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 5: Trigger option</td>
|
|
<td valign="top">
|
|
<b><u>*ENTRYEXIT</u></b>, *ENTRY, *ENTRYEXITNOPGM, *ENTRYNOPGM</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="5"><a href="#ADDPEXFTR.JVATRG"><b>JVATRG</b></a></td>
|
|
<td valign="top">Java trigger</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="5">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Java package</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*NONE</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Java class</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*ALL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: Java method</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*ALL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 4: Trigger option</td>
|
|
<td valign="top">
|
|
<b><u>*ENTRYEXIT</u></b>, *ENTRY, *ENTRYEXITNOPGM, *ENTRYNOPGM</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="9"><a href="#ADDPEXFTR.PGMFTR"><b>PGMFTR</b></a></td>
|
|
<td valign="top">Program filter</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="9">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Relational operator</td>
|
|
<td valign="top">
|
|
<b><u>*EQ</u></b>, *NE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: </td>
|
|
<td valign="top">
|
|
Values (up to 16 repetitions): <i>Element list</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 1: Program</td>
|
|
<td valign="top">
|
|
<i>Qualified object name</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:20pt">Qualifier 1: Program</td>
|
|
<td valign="top"><i>Name</i>, *ALL</td>
|
|
</tr><tr>
|
|
<td valign="top" style="padding-left:20pt">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top" style="padding-left:10pt">Element 2: Module</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*ALL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 3: Procedure</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*ALL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 4: Type</td>
|
|
<td valign="top">
|
|
<b><u>*PGM</u></b>, *SRVPGM</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="6"><a href="#ADDPEXFTR.JVAFTR"><b>JVAFTR</b></a></td>
|
|
<td valign="top">Java method filter</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="6">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Relational operator</td>
|
|
<td valign="top">
|
|
<b><u>*EQ</u></b>, *NE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: </td>
|
|
<td valign="top">
|
|
Values (up to 5 repetitions): <i>Element list</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 1: Java package</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*NONE</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 2: Java class</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*ALL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 3: Java method</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*ALL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="6"><a href="#ADDPEXFTR.JVACLSFTR"><b>JVACLSFTR</b></a></td>
|
|
<td valign="top">Java class filter</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="6">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Relational operator</td>
|
|
<td valign="top">
|
|
<b><u>*EQ</u></b>, *NE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: </td>
|
|
<td valign="top">
|
|
Values (up to 5 repetitions): <i>Element list</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 1: Java package</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*NONE</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 2: Java class</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*ALL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 3: Array</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*NOARRAY</u></b>, *CLASSARRAY, *VOIDARRAY, *BOOLEANARRAY, *CHARARRAY, *FLOATARRAY, *DOUBLEARRAY, *BYTEARRAY, *SHORTARRAY, *INTARRAY, *LONGARRAY</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="8"><a href="#ADDPEXFTR.OBJFTR"><b>OBJFTR</b></a></td>
|
|
<td valign="top">Object filter</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="8">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Relational operator</td>
|
|
<td valign="top">
|
|
<b><u>*EQ</u></b>, *NE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: </td>
|
|
<td valign="top">
|
|
Values (up to 5 repetitions): <i>Element list</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 1: Object</td>
|
|
<td valign="top">
|
|
<i>Qualified object name</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:20pt">Qualifier 1: Object</td>
|
|
<td valign="top"><i>Name</i>, *ALL</td>
|
|
</tr><tr>
|
|
<td valign="top" style="padding-left:20pt">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top" style="padding-left:10pt">Element 2: Member, if data base file</td>
|
|
<td valign="top">
|
|
<i>Name</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 3: Object type</td>
|
|
<td valign="top">
|
|
*DTAARA, *DTAQ, *FILE, *FLR, *JRN, *JRNRCV, *LIB, *MSGQ, *PGM, *SRVPGM, *USRPRF, *USRIDX, *USRQ, *USRSPC</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#ADDPEXFTR.PATHFTR"><b>PATHFTR</b></a></td>
|
|
<td valign="top">Path filter</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Relational operator</td>
|
|
<td valign="top">
|
|
<b><u>*EQ</u></b>, *NE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Path</td>
|
|
<td valign="top">
|
|
Values (up to 5 repetitions): <i>Path name</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#ADDPEXFTR.MEMFTR"><b>MEMFTR</b></a></td>
|
|
<td valign="top">Memory filter</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Relational operator</td>
|
|
<td valign="top">
|
|
<b><u>*EQ</u></b>, *NE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Pool identifier</td>
|
|
<td valign="top">
|
|
Values (up to 5 repetitions): 1-64</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#ADDPEXFTR.DSKFTR"><b>DSKFTR</b></a></td>
|
|
<td valign="top">Disk filter</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Relational operator</td>
|
|
<td valign="top">
|
|
<b><u>*EQ</u></b>, *NE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Disk identifier</td>
|
|
<td valign="top">
|
|
Values (up to 5 repetitions): <i>Integer</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#ADDPEXFTR.ASPFTR"><b>ASPFTR</b></a></td>
|
|
<td valign="top">ASP filter</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Relational operator</td>
|
|
<td valign="top">
|
|
<b><u>*EQ</u></b>, *NE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: ASP identifier</td>
|
|
<td valign="top">
|
|
Values (up to 5 repetitions): <i>Integer</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="9"><a href="#ADDPEXFTR.IPFTR"><b>IPFTR</b></a></td>
|
|
<td valign="top">IP filter</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="9">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Relational operator</td>
|
|
<td valign="top">
|
|
<b><u>*EQ</u></b>, *NE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: </td>
|
|
<td valign="top">
|
|
Values (up to 5 repetitions): <i>Element list</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 1: Address family</td>
|
|
<td valign="top">
|
|
1-255, <b><u>*INET</u></b>, *INET6, *UNIX</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 2: Communication type</td>
|
|
<td valign="top">
|
|
1-255, <b><u>*STREAM</u></b>, *DGRAM, *RAW, *SEQPACKET</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 3: Local internet address</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*ALL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 4: Remote internet address</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*ALL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 5: Local port</td>
|
|
<td valign="top">
|
|
1-65535, <b><u>*ALL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 6: Remote port</td>
|
|
<td valign="top">
|
|
1-65535, <b><u>*ALL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="8"><a href="#ADDPEXFTR.USRDFNFTR"><b>USRDFNFTR</b></a></td>
|
|
<td valign="top">User defined filter</td>
|
|
<td valign="top">Values (up to 10 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="8">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Relational operator</td>
|
|
<td valign="top">
|
|
<b><u>*EQ</u></b>, *NE, *LT, *GT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Event type</td>
|
|
<td valign="top">
|
|
1-31</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: Event subtype</td>
|
|
<td valign="top">
|
|
1-31</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 4: Data offset</td>
|
|
<td valign="top">
|
|
<i>Integer</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 5: Data type</td>
|
|
<td valign="top">
|
|
<b><u>*CHAR</u></b>, *HEX, *INT1, *INT2, *INT4, *INT8, *UINT1, *UINT2, *UINT4, *UINT8</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 6: Compare value</td>
|
|
<td valign="top">
|
|
Values (up to 5 repetitions): <i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 7: Trigger option</td>
|
|
<td valign="top">
|
|
0-8, <b><u>*NONE</u></b>, *START, *END, *COLLSTART, *COLLEND</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDPEXFTR.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text 'description'</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPEXFTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ADDPEXFTR.FTR"></a>
|
|
<h3>Filter (FTR)</h3>
|
|
<p>Specifies the name of the Performance Explorer filter to be added. If the specified filter already exists in the QAPEXFTR file in library QUSRSYS, an error condition will occur. The user can either change the filter name or remove the existing filter using the Remove Performance Explorer Filter (RMVPEXFTR) command, and try this command again.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>filter-name</i></b></dt>
|
|
<dd>Specify the name of the new Performance Explorer filter.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPEXFTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPEXFTR.PGMTRG"></a>
|
|
<h3>Program trigger (PGMTRG)</h3>
|
|
<p>If a procedure entry event (*PRCENTRY) or MI entry event (*MIENTRY) occurs that matches this trigger specification, then Performance Explorer will begin collecting all events specified in the Performance Explorer definition used for the active Performance Explorer session. The events will be collected only for the thread where the trigger occurs. When the procedure exit event (*PRCEXIT) or MI exit event (*MIEXIT) occurs that matches the trigger specification, Performance Explorer will stop collecting the events specified in the Performance Explorer definition.
|
|
</p>
|
|
<p>The *PRCENTRY/*PRCEXIT events are enabled in procedures that are compiled at optimization level 30 and under. For optimization level 40, procedures have these events enabled if the LICOPT on CHGPGM has been set to 'CallTracingAtHighOpt' and the procedure stacks a frame on the invocation stack when called (non-leaf procedures).
|
|
</p>
|
|
<p>The *MIENTRY/*MIEXIT events are enabled in procedures that are compiled with the ENBPFRCOL parameter set to *PEP, *FULL, or *ENTRYEXIT.
|
|
</p>
|
|
<p><b>Element 1: Program</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Qualifier 1: Program</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>program-name</i></b></dt>
|
|
<dd>Specify the name of the trigger program.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the library which contains the program or service program.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Module</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All modules in the specified program will act as the trigger.
|
|
</dd>
|
|
<dt><b><i>module-name</i></b></dt>
|
|
<dd>Specify the module within the program or service program that contains the procedure that is to be the trigger. This is required only for ILE programs and service programs.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 3: Procedure</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PEP</u></b></dt>
|
|
<dd>The program entry procedure will act as the trigger. This is not valid for programs of type *SRVPGM.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All procedures in the specified module will act as the trigger.
|
|
</dd>
|
|
<dt><b><i>'procedure-name'</i></b></dt>
|
|
<dd>Specify a specific procedure within the specified module that is to be the trigger. Specify the procedure name within single quotes if the procedure name contains lower case characters.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 4: Type</b>
|
|
</p>
|
|
<p>Indicate the type of program being specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PGM</u></b></dt>
|
|
<dd>The program being specified is a program (*PGM) object.
|
|
</dd>
|
|
<dt><b>*SRVPGM</b></dt>
|
|
<dd>The program being specified is a service program (*SRVPGM) object.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 5: Trigger option</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ENTRYEXIT</u></b></dt>
|
|
<dd>The specified trigger procedure enables the collection of events at procedure entry time. At procedure exit, the collection of events is disabled.
|
|
</dd>
|
|
<dt><b>*ENTRY</b></dt>
|
|
<dd>The specified trigger procedure enables the collection of events at procedure entry time. The collection of events is enabled for the duration of the Performance Explorer session.
|
|
</dd>
|
|
<dt><b>*ENTRYEXITNOPGM</b></dt>
|
|
<dd>The specified trigger procedure enables the collection of events (except program events) at procedure entry time. At procedure exit, the collection of events is disabled. This option is not valid for STATS mode.
|
|
</dd>
|
|
<dt><b>*ENTRYNOPGM</b></dt>
|
|
<dd>The specified trigger procedure enables the collection of events (except program events) at procedure entry time. The collection of events is enabled for the duration of the Performance Explorer session. This option is not valid for STATS mode.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPEXFTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPEXFTR.JVATRG"></a>
|
|
<h3>Java trigger (JVATRG)</h3>
|
|
<p>If a Java method entry event (*JVAENTRY) occurs that matches this trigger specification, then Performance Explorer will begin collecting all events specified in the Performance Explorer definition used for the active Performance Explorer session. The events will be collected only for the thread where the trigger occurs. When the Java method exit event (*JVAEXIT) occurs that matches the trigger specification, Performance Explorer will stop collecting the events specified in the Performance Explorer definition.
|
|
</p>
|
|
<p>The *JVAENTRY and *JVAEXIT hooks are always enabled in interpreted Java. You can also enable these hooks when running in JIT mode by specifying the property 'os400.enbpfrcol=1'.
|
|
</p>
|
|
<p>For code compiled for direct execution, specify ENBPFRCOL(*ENTRYEXIT) on the Create Java Program (CRTJVAPGM) CL command.
|
|
</p>
|
|
<p><b>Element 1: Java package</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>package-name</i></b></dt>
|
|
<dd>Specify the name of the Java package that contains the method to use as the trigger.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Java class</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>class-name</i></b></dt>
|
|
<dd>Specify a class within the package that contains the method to use as the trigger.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 3: Java method</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>method-name</i></b></dt>
|
|
<dd>Specify a method to use as the trigger.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 4: Trigger option</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ENTRYEXIT</u></b></dt>
|
|
<dd>The specified trigger method enables the collection of events at Java method entry time. At Java method exit, the collection of events is disabled.
|
|
</dd>
|
|
<dt><b>*ENTRY</b></dt>
|
|
<dd>The specified trigger method enables the collection of events at Java method entry time. The collection of events is enabled for the duration of the Performance Explorer session.
|
|
</dd>
|
|
<dt><b>*ENTRYEXITNOPGM</b></dt>
|
|
<dd>The specified trigger method enables the collection of events (except program events) at method entry time. At method exit, the collection of events is disabled. This option is not valid for STATS mode.
|
|
</dd>
|
|
<dt><b>*ENTRYNOPGM</b></dt>
|
|
<dd>The specified trigger method enables the collection of events (except program events) at method entry time. The collection of events is enabled for the duration of the Performance Explorer session. This option is not valid for STATS mode.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPEXFTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPEXFTR.PGMFTR"></a>
|
|
<h3>Program filter (PGMFTR)</h3>
|
|
<p>Specifies the program comparisons to use for this filter.
|
|
</p>
|
|
<p><b>Element 1: Relational operator</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*EQ</u></b></dt>
|
|
<dd>Events having program data that matches the specified program are included in the data collected by Performance Explorer.
|
|
</dd>
|
|
<dt><b>*NE</b></dt>
|
|
<dd>Events having program data that matches the specified program are excluded from the data collected by Performance Explorer. These events will not show up in the *MGTCOL object or the Performance Explorer database.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Filter entry</b>
|
|
</p>
|
|
<p>Specify the elements for each filter entry.
|
|
</p>
|
|
<dl>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 1: Program</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Qualifier 1: Program</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>program-name</i></b></dt>
|
|
<dd>Specify the name of the program to be used as a compare value for the program filter.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All programs in the specified library will pass the filter.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the library which contains the program or service program.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 2: Module</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All modules in the program or service program will pass the filter. If filtering an OPM (Original Program Model), specify *ALL for this element.
|
|
</dd>
|
|
<dt><b><i>module-name</i></b></dt>
|
|
<dd>Specify a specific module within the program or service program to be used as a compare value for the program filter. This is required only for ILE programs and service programs.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 3: Procedure</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All procedures in the specified module are used as a compare value for the program filter.
|
|
</dd>
|
|
<dt><b><i>procedure-name</i></b></dt>
|
|
<dd>Specify a procedure to use as the filter compare value. Specify the procedure name within single quotes if the procedure name contains lower case characters.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 4: Type</b>
|
|
</p>
|
|
<p>Indicate the type of program being specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PGM</u></b></dt>
|
|
<dd>The program being specified is a program (*PGM) object.
|
|
</dd>
|
|
<dt><b>*SRVPGM</b></dt>
|
|
<dd>The program being specified is a service program (*SRVPGM) object.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPEXFTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPEXFTR.JVAFTR"></a>
|
|
<h3>Java method filter (JVAFTR)</h3>
|
|
<p>Specifies the Java package, class, and methods to be used as compare values for the Java filter.
|
|
</p>
|
|
<p><b>Element 1: Relational operator</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*EQ</u></b></dt>
|
|
<dd>Events having Java data that match the specified packages,classes, and methods are included in the data collected by Performance Explorer.
|
|
</dd>
|
|
<dt><b>*NE</b></dt>
|
|
<dd>Events having Java data that matches the specified packages, classes, and methods are excluded from the collection and will not show up in the *MGTCOL object or the Performance Explorer database.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Filter entry</b>
|
|
</p>
|
|
<p>Specify the elements for each filter entry.
|
|
</p>
|
|
<dl>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 1: Java package</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>The Java class and methods are not in a package.
|
|
</dd>
|
|
<dt><b><i>package-name</i></b></dt>
|
|
<dd>Specify the name of the Java package to be used as a compare value for the filter.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 2: Java class</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All classes in the specified package will pass the Java filter.
|
|
</dd>
|
|
<dt><b><i>class-name</i></b></dt>
|
|
<dd>Specify a class within the package to be used as a compare value for the filter.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 3: Java method</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All methods in the specified class and package will pass the filter.
|
|
</dd>
|
|
<dt><b><i>method-name</i></b></dt>
|
|
<dd>Specify a method to use as the filter compare value.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPEXFTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPEXFTR.JVACLSFTR"></a>
|
|
<h3>Java class filter (JVACLSFTR)</h3>
|
|
<p>Specifies the Java package and class to be used as compare values for the Java class filter.
|
|
</p>
|
|
<p><b>Element 1: Relational operator</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*EQ</u></b></dt>
|
|
<dd>Events having Java data that match the specified packages and classes are included in the data collected by Performance Explorer.
|
|
</dd>
|
|
<dt><b>*NE</b></dt>
|
|
<dd>Events having Java data that matches the specified packages and classes are excluded from the collection and will not show up in the *MGTCOL object or the Performance Explorer database.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Filter entry</b>
|
|
</p>
|
|
<p>Specify the elements for each filter entry.
|
|
</p>
|
|
<dl>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 1: Java package</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>The Java classes are not in a package.
|
|
</dd>
|
|
<dt><b><i>package-name</i></b></dt>
|
|
<dd>Specify the name of the Java package to be used as a compare value for the filter.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 2: Java class</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All classes in the specified package will pass the Java filter.
|
|
</dd>
|
|
<dt><b><i>class-name</i></b></dt>
|
|
<dd>Specify a class within the package to be used as a compare value for the filter.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 3: Array</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NOARRAY</u></b></dt>
|
|
<dd>The specified class is not an array of classes.
|
|
</dd>
|
|
<dt><b>*CLASSARRAY</b></dt>
|
|
<dd>The specified class is an array of classes.
|
|
</dd>
|
|
<dt><b>*VOIDARRAY</b></dt>
|
|
<dd>The array of void primitive class is to be used as a compare value for the filter.
|
|
</dd>
|
|
<dt><b>*BOOLEANARRAY</b></dt>
|
|
<dd>The array of boolean primitive class is to be used as a compare value for the filter.
|
|
</dd>
|
|
<dt><b>*CHARARRAY</b></dt>
|
|
<dd>The array of char primitive class is to be used as a compare value for the filter.
|
|
</dd>
|
|
<dt><b>*FLOATARRAY</b></dt>
|
|
<dd>The array of float primitive class is to be used as a compare value for the filter.
|
|
</dd>
|
|
<dt><b>*DOUBLEARRAY</b></dt>
|
|
<dd>The array of double primitive class is to be used as a compare value for the filter.
|
|
</dd>
|
|
<dt><b>*BYTEARRAY</b></dt>
|
|
<dd>The array of byte primitive class is to be used as a compare value for the filter.
|
|
</dd>
|
|
<dt><b>*SHORTARRAY</b></dt>
|
|
<dd>The array of short primitive class is to be used as a compare value for the filter.
|
|
</dd>
|
|
<dt><b>*INTARRAY</b></dt>
|
|
<dd>The array of int primitive class is to be used as a compare value for the filter.
|
|
</dd>
|
|
<dt><b>*LONGARRAY</b></dt>
|
|
<dd>The array of long primitive class is to be used as a compare value for the filter.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPEXFTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPEXFTR.OBJFTR"></a>
|
|
<h3>Object filter (OBJFTR)</h3>
|
|
<p>Specifies the object comparisons to use for this filter.
|
|
</p>
|
|
<p><b>Element 1: Relational operator</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*EQ</u></b></dt>
|
|
<dd>Events whose object name, library name, member (if a file) and object type matches this specification will be included in the collected trace data.
|
|
</dd>
|
|
<dt><b>*NE</b></dt>
|
|
<dd>Events whose object name, library name, member (if a file) and object type matches this specification will be excluded from the collected trace data. These events will not show up in the *MGTCOL object or the Performance Explorer database.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Filter entry</b>
|
|
</p>
|
|
<p>Specify the elements for each filter entry.
|
|
</p>
|
|
<dl>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 1: Object</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Qualifier 1: Object</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>object-name</i></b></dt>
|
|
<dd>The name of the object to be used as a compare value in the object filter.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All objects in the specified library will pass the filter. Object type must be blank if *ALL is specified for the object.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>The library which contains the object to use as a compare value.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 2: Member, if data base file</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>member-name</i></b></dt>
|
|
<dd>The member name to use as the compare value. This value is valid for physical or logical *FILE objects only. Specify *N for other objects.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 3: Object type</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*DTAARA</b></dt>
|
|
<dd>The specified object is a data area.
|
|
</dd>
|
|
<dt><b>*DTAQ</b></dt>
|
|
<dd>The specified object is a data queue.
|
|
</dd>
|
|
<dt><b>*FILE</b></dt>
|
|
<dd>The specified object is a physical or logical database file.
|
|
</dd>
|
|
<dt><b>*FLR</b></dt>
|
|
<dd>The specified object is a folder.
|
|
</dd>
|
|
<dt><b>*JRN</b></dt>
|
|
<dd>The specified object is a journal.
|
|
</dd>
|
|
<dt><b>*JRNRCV</b></dt>
|
|
<dd>The specified object is a journal receiver.
|
|
</dd>
|
|
<dt><b>*LIB</b></dt>
|
|
<dd>The specified object is a library. Note: this filters on the library object only, not on the objects contained in the library. Use an object name of *ALL to filter on all objects contained in a library.
|
|
</dd>
|
|
<dt><b>*MSGQ</b></dt>
|
|
<dd>The specified object is a message queue.
|
|
</dd>
|
|
<dt><b>*PGM</b></dt>
|
|
<dd>The specified object is a program.
|
|
</dd>
|
|
<dt><b>*SRVPGM</b></dt>
|
|
<dd>The specified object is a service program.
|
|
</dd>
|
|
<dt><b>*USRPRF</b></dt>
|
|
<dd>The specified object is a user profile.
|
|
</dd>
|
|
<dt><b>*USRIDX</b></dt>
|
|
<dd>The specified object is a user index.
|
|
</dd>
|
|
<dt><b>*USRSPC</b></dt>
|
|
<dd>The specified object is a user space.
|
|
</dd>
|
|
<dt><b>*USRQ</b></dt>
|
|
<dd>The specified object is a user queue.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPEXFTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPEXFTR.PATHFTR"></a>
|
|
<h3>Path filter (PATHFTR)</h3>
|
|
<p>Specifies the Integrated File System object path name comparisons to use for this filter.
|
|
</p>
|
|
<p><b>Element 1: Relational operator</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*EQ</u></b></dt>
|
|
<dd>All events that have an object path that matches the specified object path are included in the data collected by Performance Explorer.
|
|
</dd>
|
|
<dt><b>*NE</b></dt>
|
|
<dd>All events that have an object path data that matches the specified object path are discarded. These events will not show up in the *MGTCOL object or the Performance Explorer database.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Path</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>object-path</i></b></dt>
|
|
<dd>The object path to use as a compare value for this filter.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPEXFTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPEXFTR.MEMFTR"></a>
|
|
<h3>Memory filter (MEMFTR)</h3>
|
|
<p>Specifies the memory pool comparisons to use for this filter.
|
|
</p>
|
|
<p><b>Element 1: Relational operator</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*EQ</u></b></dt>
|
|
<dd>All events that have pool identifier data that matches the specified pool are included in the data collected by Performance Explorer.
|
|
</dd>
|
|
<dt><b>*NE</b></dt>
|
|
<dd>All events that have pool identifier data that matches the specified pool are discarded. These events will not show up in the *MGTCOL object or the Performance Explorer database.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Pool identifier</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>pool-identifier</i></b></dt>
|
|
<dd>The system pool ID to use as a compare value for this filter. This pool ID corresponds to the pool identifier as shown on the WRKACTJOB command or on the output of PRTPEXRPT of type *TRACE.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPEXFTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPEXFTR.DSKFTR"></a>
|
|
<h3>Disk filter (DSKFTR)</h3>
|
|
<p>Specifies the disk unit comparisons to use for this filter.
|
|
</p>
|
|
<p><b>Element 1: Relational operator</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*EQ</u></b></dt>
|
|
<dd>All events that have disk identifier data that matches the specified disk are included in the data collected by Performance Explorer.
|
|
</dd>
|
|
<dt><b>*NE</b></dt>
|
|
<dd>All events that have disk identifier data that matches the specified disk will be discarded. These events will not show up in the *MGTCOL object or the Performance Explorer database.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Disk identifier</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>disk-identifier</i></b></dt>
|
|
<dd>The disk identifier used as a compare value for this filter. This disk identifier corresponds to the disk unit as shown on the WRKDSKSTS command or the output of PRTPEXRPT of type *TRACE. If a disk is mirrored, this identifier applies to both disks in the mirrored pair.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPEXFTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPEXFTR.ASPFTR"></a>
|
|
<h3>ASP filter (ASPFTR)</h3>
|
|
<p>Specifies the ASP (auxiliary storage pool) comparisons to use for this filter.
|
|
</p>
|
|
<p><b>Element 1: Relational operator</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*EQ</u></b></dt>
|
|
<dd>All events with an ASP identifier that matches the specified ASP will be included in the data collected by Performance Explorer.
|
|
</dd>
|
|
<dt><b>*NE</b></dt>
|
|
<dd>All events with an ASP identifier that matches the specified ASP will discarded. These events will not show up in the *MGTCOL object or the Performance Explorer database.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: ASP identifier</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>ASP-identifier</i></b></dt>
|
|
<dd>The ASP identifier to use as a compare value for this filter. This ASP identifier can be set to the name of an independent ASP or to the ASP number that corresponds to the ASP value as shown on the WRKDSKSTS command or in the output of PRTPEXRPT of type *TRACE.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPEXFTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPEXFTR.IPFTR"></a>
|
|
<h3>IP filter (IPFTR)</h3>
|
|
<p>Specifies the IP (internet protocol) information to use as a compare value for this filter.
|
|
</p>
|
|
<p><b>Element 1: Relational operator</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*EQ</u></b></dt>
|
|
<dd>All events with IP data that match the filter compare values will be included in the data collected by Performance Explorer.
|
|
</dd>
|
|
<dt><b>*NE</b></dt>
|
|
<dd>All events with IP data that match the filter compare values will be discarded. These events will not show up in the *MGTCOL object or the Performance Explorer database.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Filter entry</b>
|
|
</p>
|
|
<p>Specify the elements for each filter entry.
|
|
</p>
|
|
<dl>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 1: Address family</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*INET</u></b></dt>
|
|
<dd>The Internet protocol will be used as part of the compare value.
|
|
</dd>
|
|
<dt><b>*INET6</b></dt>
|
|
<dd>The Internet protocol version 6 will be used as part of the compare value.
|
|
</dd>
|
|
<dt><b>*UNIX</b></dt>
|
|
<dd>The Unix protocol will be used as part of the compare value.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 2: Communication type</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All communication types will pass this part of the IP filter.
|
|
</dd>
|
|
<dt><b>*STREAM</b></dt>
|
|
<dd>A communication type of SOCK_STREAM will be used as the compare value.
|
|
</dd>
|
|
<dt><b>*DGRAM</b></dt>
|
|
<dd>A communication type of SOCK_DGRAM will be used as the compare value.
|
|
</dd>
|
|
<dt><b>*RAW</b></dt>
|
|
<dd>A communication type of SOCK_RAW will be used as the compare value.
|
|
</dd>
|
|
<dt><b>*SEQPACKET</b></dt>
|
|
<dd>A communication type of SOCK_SEQPACKET will be used as the compare value.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 3: Local internet address</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All local IP addresses will pass this part of the IP filter.
|
|
</dd>
|
|
<dt><b><i>local-IP-address</i></b></dt>
|
|
<dd>The local IP address to be used as part of the IP compare value.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 4: Remote internet address</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All remote IP addresses will pass this part of the IP filter.
|
|
</dd>
|
|
<dt><b><i>remote-IP-address</i></b></dt>
|
|
<dd>The remote IP address to used as part of the IP compare value.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 5: Local port</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All local ports for the specified local address will pass this part of the IP filter.
|
|
</dd>
|
|
<dt><b><i>local-port</i></b></dt>
|
|
<dd>The local port number to be used as a compare value.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 6: Remote port</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All remote ports for the specified address will pass this part of the IP filter.
|
|
</dd>
|
|
<dt><b><i>remote-port</i></b></dt>
|
|
<dd>The remote port number to be used as the compare value.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPEXFTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPEXFTR.USRDFNFTR"></a>
|
|
<h3>User defined filter (USRDFNFTR)</h3>
|
|
<p>Specifies user-defined comparisons to use for this filter. This type of filter will require help from IBM service.
|
|
</p>
|
|
<p><b>Element 1: Relational operator</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*EQ</u></b></dt>
|
|
<dd>All events for the specified user filter will be collected if the event data matches the compare value.
|
|
</dd>
|
|
<dt><b>*NE</b></dt>
|
|
<dd>All events for the specified user filter will be discarded if the event data matches the compare value. These events will not show up in the *MGTCOL object or the Performance Explorer database.
|
|
</dd>
|
|
<dt><b>*GT</b></dt>
|
|
<dd>All events for the specified user filter will be collected if the event data is greater than the compare value.
|
|
</dd>
|
|
<dt><b>*LT</b></dt>
|
|
<dd>All events for the specified user filter will be collected if the event data is less than the compare value.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Event type</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>event-type</i></b></dt>
|
|
<dd>The event type (1-31) for the event to filter.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 3: Event subtype</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>event-subtype</i></b></dt>
|
|
<dd>The event subtype (1-31) for the event to filter.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 4: Data offset</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>data-offset</i></b></dt>
|
|
<dd>The offset into the event data to be compared against the compare value.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 5: Data type</b>
|
|
</p>
|
|
<p>Specifies how to compare the event data to the compare value.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CHAR</u></b></dt>
|
|
<dd>Compare as two character strings, left adjusted and padded on the right with blanks. The maximum length is 30 bytes.
|
|
</dd>
|
|
<dt><b>*HEX</b></dt>
|
|
<dd>Compare as hexadecimal strings, left adjusted and padded on the right with hexadecimal zeros. The maximum length is 30 hexadecimal digits.
|
|
</dd>
|
|
<dt><b>*INT1</b></dt>
|
|
<dd>The first byte of event data at the specified data offset and the compare value are compared as a signed 1-byte integers.
|
|
</dd>
|
|
<dt><b>*INT2</b></dt>
|
|
<dd>The first two bytes of event data at the specified data offset and the compare value are compared as signed 2-byte integers.
|
|
</dd>
|
|
<dt><b>*INT4</b></dt>
|
|
<dd>The first four bytes of event data at the specified data offset and the compare value are compared as signed 4-byte integers.
|
|
</dd>
|
|
<dt><b>*INT8</b></dt>
|
|
<dd>The first eight bytes of event data at the specified data offset and the compare value are compared as signed 8-byte integers.
|
|
</dd>
|
|
<dt><b>*UINT1</b></dt>
|
|
<dd>The first byte of event data at the specified data offset and the compare value are compared as a unsigned 1-byte integers.
|
|
</dd>
|
|
<dt><b>*UINT2</b></dt>
|
|
<dd>The first two bytes of event data at the specified data offset and the compare value are compared as unsigned 2-byte integers.
|
|
</dd>
|
|
<dt><b>*UINT4</b></dt>
|
|
<dd>The first four bytes of event data at the specified data offset and the compare value are compared as unsigned 4-byte integers.
|
|
</dd>
|
|
<dt><b>*UINT8</b></dt>
|
|
<dd>The first eight bytes of event data at the specified data offset and the compare value are compared as unsigned 8-byte integers.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 6: Compare value</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>compare-value</i></b></dt>
|
|
<dd>The value used to compare against the event data. Up to five compare values can be specified. If multiple values are specified, the comparison will be made with each compare value. If any comparison is true, the event will be filtered.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 7: Trigger option</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>*NONE</i></b></dt>
|
|
<dd>The information in this filter is not used as a trigger.
|
|
</dd>
|
|
<dt><b><i>*START</i></b></dt>
|
|
<dd>If an event occurs that meets the criteria in the filter information, subsequent events will be stored to the database. Previous to this, no events will be recorded. This option can be used to start collecting events once a certain condition has occurred. This option affects only the task or process where the trigger event occured.
|
|
</dd>
|
|
<dt><b><i>*END</i></b></dt>
|
|
<dd>If an event occurs that meets the criteria in the filter information, subsequent events will not be stored to the database. This can be used to stop collecting data once a certain condition has occurred. This option affects only the task or process where the trigger event occured.
|
|
</dd>
|
|
<dt><b><i>*COLLSTART</i></b></dt>
|
|
<dd>If an event occurs that meets the criteria in the filter information, subsequent events will be stored to the database. Previous to this, no events will be recorded. This option can be used to start collecting events once a certain condition has occurred. This option affects all tasks and processes in the collection.
|
|
</dd>
|
|
<dt><b><i>*COLLEND</i></b></dt>
|
|
<dd>If an event occurs that meets the criteria in the filter information, subsequent events will not be stored to the database. This can be used to stop collecting data once a certain condition has occurred. This option affects all tasks and processes in the collection.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPEXFTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPEXFTR.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Specifies the text that briefly describes the Performance Explorer definition.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*BLANK</u></b></dt>
|
|
<dd>Text is not specified.
|
|
</dd>
|
|
<dt><b><i>'description'</i></b></dt>
|
|
<dd>Specify no more than 50 characters of text, enclosed in apostrophes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPEXFTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDPEXFTR.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Adding Disk and Memory Pool Filters</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDPEXFTR FTR(FILTER1) DSKFTR(*EQ (1 2)) MEMFTR(*EQ 3)
|
|
</pre>
|
|
</p>
|
|
<p>This command adds a new performance explorer filter named FILTER1 which will result in a member named FILTER1 being added to file QAPEXFTR in library QUSRSYS. If this filter is used when starting a performance explorer session (STRPEX command), then events will be collected if they contain disk device identifier data of '1' or '2'. In addition, the pool data for that event must contain '3'. If either the disk data or the memory pool data do not match the specified filter, then that event will not be recorded.
|
|
</p>
|
|
<p>If an event does not contain disk device or memory pool data, then the filter does not apply to that event and those events will be collected. For example, the base event *TASKSWTIN does not contain any disk or memory pool data, so this event would still be collected.
|
|
</p>
|
|
<p><b>Example 2: Adding a Disk Filter</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDPEXFTR FTR(DISKFILTER) DSKFTR(*NE (1 2))
|
|
</pre>
|
|
</p>
|
|
<p>This command adds a new performance explorer filter named DISKFILTER. If this filter is used when starting a performance explorer session (STRPEX command), then events will be collected if the event contains disk device name data that does not match '1' and does not match '2'.
|
|
</p>
|
|
<p>If an event does not contain disk device name data, then the filter does not apply to that event and those events will be collected. For example, the base event *TASKSWTIN does not contain any disk data, so this event would still be collected.
|
|
</p>
|
|
<p><b>Example 3: Adding an IP Filter</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDPEXFTR FTR(IPFILTER)
|
|
IPFTR(*EQ (*INET *STREAM '1.2.3.4'))
|
|
</pre>
|
|
</p>
|
|
<p>This command adds a new performance explorer filter named IPFILTER. If this filter is used when starting a performance explorer session (STRPEX command), then events will be collected if a communications event has an address family of *INET, the communication type is *STREAM, and the local IP address is '1.2.3.4'.
|
|
</p>
|
|
<p><b>Example 4: Adding a User-Defined Filter</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDPEXFTR FTR(USERFILTER)
|
|
USRDFNFTR((*EQ 1 2 20 *CHAR ('BOB' 'SAM')))
|
|
</pre>
|
|
</p>
|
|
<p>This command adds a new performance explorer filter named USERFILTER. If this filter is used when starting a performance explorer session (STRPEX command), then events will be collected if the event type is '1', the event subtype is '2' and the data at offset 20 is either 'BOB' or 'SAM'.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPEXFTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDPEXFTR.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPFAF10</b></dt>
|
|
<dd>Definition or filter already exists.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPEXFTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|