friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
8826eae394
ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/chgpexdfn.htm

757 lines
27 KiB
HTML
Raw Blame History

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Change PEX Definition (CHGPEXDFN)</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="CHGPEXDFN.Top_Of_Page"></a>
<h2>Change PEX Definition (CHGPEXDFN)</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="#CHGPEXDFN.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGPEXDFN.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGPEXDFN.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGPEXDFN"></a>
<p>The Change Performance Explorer Definition (CHGPEXDFN) command changes an existing Performance Explorer definition. The current values stored in an existing definition are inserted when the CHGPEXDFN command is prompted. Each definition is stored as a member in the QAPEXDFN file in library QUSRSYS. A Performance Explorer definition identifies the performance data that is to be collected during a Performance Explorer session. A session can be started using the STRPEX (Start Performance Explorer) command. When starting a new session, a Performance Explorer definition name must be provided.
</p>
<p>Additional information about the Performance Explorer tool can be found in the Performance Management information at http://www.ibm.com/servers/eserver/iseries/perfmgmt/resource.htm.
</p>
<p><b>Restrictions:</b>
</p>
<ol>
<li>This command is shipped with public *EXCLUDE authority.
</li>
<li>You must have *EXECUTE authority to the library of each program specified on the PGM parameter.
</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 CHGPEXDFN at the same time. The thread that issued CHGPEXDFN first will run the command to completion while the second CHGPEXDFN waits.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPEXDFN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGPEXDFN.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="#CHGPEXDFN.DFN"><b>DFN</b></a></td>
<td valign="top">Definition</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Key, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGPEXDFN.TYPE"><b>TYPE</b></a></td>
<td valign="top">Type</td>
<td valign="top"><b><u>*SAME</u></b>, *STATS, *TRACE, *PROFILE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="6"><a href="#CHGPEXDFN.JOB"><b>JOB</b></a></td>
<td valign="top">Jobs</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *ALL, *<br>Other values (up to 8 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="6">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Job name</td>
<td valign="top">
<i>Qualified job name</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Qualifier 1: Job name</td>
<td valign="top"><i>Generic name, name</i></td>
</tr><tr>
<td valign="top" style="padding-left:10pt">Qualifier 2: User</td>
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b></td>
</tr><tr>
<td valign="top" style="padding-left:10pt">Qualifier 3: Number</td>
<td valign="top">000001-999999, <b><u>*ALL</u></b></td>
</tr><tr>
<td valign="top">Element 2: Thread identifier</td>
<td valign="top">
Values (up to 20 repetitions): 00000001-FFFFFFFF, <b><u>*ALL</u></b>, *INITIAL, *SELECT</td>
</tr>
<tr>
<td valign="top"><a href="#CHGPEXDFN.TASK"><b>TASK</b></a></td>
<td valign="top">Task name</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE, *ALL<br>Other values (up to 10 repetitions): <i>Generic name, name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="8"><a href="#CHGPEXDFN.PGM"><b>PGM</b></a></td>
<td valign="top">Program to monitor</td>
<td valign="top">Single values: <b><u>*SAME</u></b><br>Other values (up to 16 repetitions): <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>, <b><u>*LIBL</u></b></td>
</tr><tr>
<td valign="top">Element 2: Module</td>
<td valign="top">
<i>Name</i>, <b><u>*ALL</u></b></td>
</tr>
<tr>
<td valign="top">Element 3: Procedure</td>
<td valign="top">
<i>Character value</i>, <b><u>*ALL</u></b></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: Pane size</td>
<td valign="top">
<b><u>4</u></b>, 8, 16, 32, 64, 128, 256, 512, 1024, 2048, 4096</td>
</tr>
<tr>
<td valign="top"><a href="#CHGPEXDFN.DTAORG"><b>DTAORG</b></a></td>
<td valign="top">Data organization</td>
<td valign="top"><b><u>*SAME</u></b>, *FLAT, *HIER</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGPEXDFN.MAXSTG"><b>MAXSTG</b></a></td>
<td valign="top">Maximum storage to use</td>
<td valign="top">1-4000000, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGPEXDFN.TRCFULL"><b>TRCFULL</b></a></td>
<td valign="top">Trace full</td>
<td valign="top"><b><u>*SAME</u></b>, *STOPTRC, *WRAP</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGPEXDFN.MRGJOB"><b>MRGJOB</b></a></td>
<td valign="top">Merge job data</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGPEXDFN.ADDTHDOPT"><b>ADDTHDOPT</b></a></td>
<td valign="top">Add threads/tasks option</td>
<td valign="top"><b><u>*ALL</u></b>, *NEW, *CURRENT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGPEXDFN.LSTALLJOB"><b>LSTALLJOB</b></a></td>
<td valign="top">List all jobs/tasks</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGPEXDFN.INTERVAL"><b>INTERVAL</b></a></td>
<td valign="top">Sampling interval</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Milliseconds</td>
<td valign="top">
0.1-200.0, <b><u>*SAME</u></b>, *NONE</td>
</tr>
<tr>
<td valign="top">Element 2: Randomize</td>
<td valign="top">
<b><u>*SAME</u></b>, *FIXED, *VARY</td>
</tr>
<tr>
<td valign="top"><a href="#CHGPEXDFN.TRCTYPE"><b>TRCTYPE</b></a></td>
<td valign="top">Trace type</td>
<td valign="top">Single values: <b><u>*SAME</u></b><br>Other values (up to 11 repetitions): *CALLRTN, *BASIC, *DSKIO1, *DSKIO2, *DSKSVR, *DSKSTG, *VRTADR, *PGMACT, *FILEOPEN, *PRFDTA, *TASKSWT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGPEXDFN.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text 'description'</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *BLANK</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGPEXDFN.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGPEXDFN.DFN"></a>
<h3>Definition (DFN)</h3>
<p>Specifies the name of the Performance Explorer definition to be changed.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>definition-name</i></b></dt>
<dd>Specify the name of the Performance Explorer definition to change.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPEXDFN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPEXDFN.TYPE"></a>
<h3>Type (TYPE)</h3>
<p>Specifies the type of performance data to be collected.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*STATS</b></dt>
<dd>General performance program statistics are collected to help identify problem areas. This mode is mainly used as a map to help determine if and where more detailed information should be collected and analyzed.
<p>In addition to collecting the information specified above, TYPE(*STATS) also provides the option of counting the occurrences of specific types of events. These can be counted in any of 4 counters provided.
</p>
<p>To count the occurrences of a particular type of event, specify SLTEVT(*YES) and then choose the event-identifier(s) to be counted from the various event categories.
</p>
<p>For example, TYPE(*STATS) SLTEVT(*YES) JOBEVT((*ALL 1)) would count all job events in counter 1.
</p>
</dd>
<dt><b>*TRACE</b></dt>
<dd>Detailed trace information is collected. This is the most detailed type of performance data collection available.
</dd>
<dt><b>*PROFILE</b></dt>
<dd>Specific programs are sampled to identify sections of code that are using larger amounts of resources. This information is very valuable when the user wants to improve the performance of a specific program or application.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPEXDFN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPEXDFN.JOB"></a>
<h3>Job name (JOB)</h3>
<p>Specifies which jobs are included in the Performance Explorer data collection session.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*</b></dt>
<dd>Only the job that issues the STRPEX (Start Performance Explorer) command is included.
</dd>
<dt><b>*ALL</b></dt>
<dd>All jobs on the system are included.
</dd>
</dl>
<p><b>Element 1: Job name</b>
</p>
<dl>
<dt><b></b></dt>
<dd>
<p><b>Qualifier 1: Job name</b>
</p>
<dl>
<dt><b><i>job-name</i></b></dt>
<dd>Specify the name of the job to be included in the Performance Explorer data collection session.
</dd>
<dt><b><i>generic*-job-name</i></b></dt>
<dd>Specify the generic name of the job to be included. 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-&gt;CL in the iSeries Information Center at the Web site: http://www.ibm.com/eserver/iseries/infocenter
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Qualifier 2: User</b>
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All jobs that match the specified job name are included.
</dd>
<dt><b><i>user-name</i></b></dt>
<dd>Specify the name of the user of the job to be included.
</dd>
<dt><b><i>generic*-user-name</i></b></dt>
<dd>Specify the generic user name of the jobs to be included.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Qualifier 3: Number</b>
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All jobs that match the specified job name and user name are included.
</dd>
<dt><b><i>job-number</i></b></dt>
<dd>Specify the job number to further qualify the job name and user name.
</dd>
</dl>
</dd>
</dl>
<p><b>Element 2: Thread identifier</b>
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All threads of the specified job are included.
</dd>
<dt><b>*INITIAL</b></dt>
<dd>Only the initial thread of the specified job is included.
</dd>
<dt><b>*SELECT</b></dt>
<dd>Select the threads from a list of threads for the specified job. This value is only valid if the command is run in an interactive job.
</dd>
<dt><b><i>thread-identifier</i></b></dt>
<dd>Specify the thread identifier of the job to be included. This is the thread ID as shown by the WRKJOB command.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPEXDFN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPEXDFN.TASK"></a>
<h3>Task name (TASK)</h3>
<p>Specifies which licensed internal code (LIC) tasks are included in the Performance Explorer data collection session. Up to 8 task names may be specified.
</p>
<p>
<b>Note: </b>LIC tasks can be obtained from the Performance Tools reports and WRKSYSACT command. There is no guarantee that LIC task names will remain the same or exist from system to system or release to release.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*NONE</b></dt>
<dd>No LIC tasks on the system are included.
</dd>
<dt><b>*ALL</b></dt>
<dd>All LIC tasks on the system are included.
</dd>
</dl>
<p><b>Other values</b>
</p>
<dl>
<dt><b><i>task-name</i></b></dt>
<dd>Specify the name of the task to be included in the Performance Explorer data collection session.
</dd>
<dt><b><i>generic*-task-name</i></b></dt>
<dd>Specify the generic name of the task to be included. 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="#CHGPEXDFN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPEXDFN.PGM"></a>
<h3>Program to monitor (PGM)</h3>
<p>Specifies the program whose performance profile data is collected. This parameter is only valid if TYPE(*PROFILE) is specified. Up to 16 programs may be specified.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<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 sampled.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list of the job that issues the STRPEX command is searched to find the specified program or service program.
</dd>
<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><u>*ALL</u></b></dt>
<dd>All modules in the program or service program will be sampled. If sampling an OPM (Original Program Model) program, specify *ALL for this element.
</dd>
<dt><b><i>module-name</i></b></dt>
<dd>Specify the name of the module within the program or service program that is to be sampled.
</dd>
</dl>
<p><b>Element 3: Procedure</b>
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All procedures in the specified module are sampled.
</dd>
<dt><b><i>'procedure-name'</i></b></dt>
<dd>Specify the name of a procedure within the specified module that is to be sampled. Specify the procedure name within single quotes if the procedure name contains lower case characters.
</dd>
</dl>
<p><b>Element 4: Type</b>
</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: Pane size</b>
</p>
<p>The pane size is the number of consecutive program instruction addresses assigned to each counter. The smaller the pane size, the more fine-grained the program profile information will be.
</p>
<dl>
<dt><b><u>4</u></b></dt>
<dd>The default pane size is 4.
</dd>
<dt><b><i>number</i></b></dt>
<dd>Specify the pane size to use for the program. Valid values are 4, 8, 16, 32, 64, 128, 256, 512, 1024, 2048, and 4096.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPEXDFN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPEXDFN.DTAORG"></a>
<h3>Data organization (DTAORG)</h3>
<p>Specifies how the data is organized.
</p>
<p>
<b>Note: </b>This parameter is only valid if TYPE(*STATS) is specified.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*FLAT</b></dt>
<dd>The Performance Explorer tool will not collect data for a parent-child relationship.
</dd>
<dt><b>*HIER</b></dt>
<dd>The Performance Explorer tool will collect data for a parent-child relationship.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPEXDFN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPEXDFN.MAXSTG"></a>
<h3>Maximum storage to use (MAXSTG)</h3>
<p>Specifies the maximum amount of storage, in kilobytes (K), that the Performance Explorer tool uses for collecting trace data.
</p>
<p>
<b>Note: </b>This parameter is only valid if TYPE(*TRACE) is specified.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>maximum-K-bytes</i></b></dt>
<dd>Specifies the requested maximum amount of storage, in kilobytes (K), to use for the collected trace records. The system calculates the minimum amount of storage that is necessary for the trace. This minimum storage size calculation depends on the system's processor configuration. The minimum amount of storage may be significantly larger than the size specified on the MAXSTG parameter. The system uses the larger of the two values.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPEXDFN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPEXDFN.TRCFULL"></a>
<h3>Trace full (TRCFULL)</h3>
<p>Specifies whether the trace records wrap (replace oldest records with new records) or whether the trace stops when all of the storage specified by the MAXSTG parameter has been used.
</p>
<p>
<b>Note: </b>This parameter is only valid if TYPE(*TRACE) is specified.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*STOPTRC</b></dt>
<dd>Tracing stops when the trace file is full of trace records.
</dd>
<dt><b>*WRAP</b></dt>
<dd>When the trace file is full, the trace wraps to the beginning. The oldest trace records are written over by new ones as they are collected.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPEXDFN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPEXDFN.MRGJOB"></a>
<h3>Merge job data (MRGJOB)</h3>
<p>Specifies whether the data from different jobs should be merged together or kept separate.
</p>
<p>
<b>Note: </b>This parameter is only valid if DTAORG(*FLAT) is specified.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*YES</b></dt>
<dd>The data from individual jobs is merged.
</dd>
<dt><b>*NO</b></dt>
<dd>The data from individual jobs is kept separate.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPEXDFN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPEXDFN.ADDTHDOPT"></a>
<h3>Add threads/tasks option (ADDTHDOPT)</h3>
<p>Specifies what types of threads and tasks should be included in the Performance Explorer session based on the creation time of the threads and tasks relative to the start time of the Performance Explorer session.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*ALL</b></dt>
<dd>The collection will include all threads and tasks that satisfy the criteria specified by the JOB and TASK parameters.
</dd>
<dt><b>*NEW</b></dt>
<dd>The collection will include only new threads and tasks that satisfy the criteria specified by the JOB and TASK parameters and are created after the Performance Explorer session is started. Any threads or tasks that are active at the time the Performance Explorer session is started will not be included.
</dd>
<dt><b>*CURRENT</b></dt>
<dd>The collection will include only threads and tasks that satisfy the criteria specified by the JOB and TASK parameters and are active at the time the Performance Explorer session is started. Any threads or tasks created after the start of the Performance Explorer session will not be included.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPEXDFN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPEXDFN.LSTALLJOB"></a>
<h3>List all jobs/tasks (LSTALLJOB)</h3>
<p>Specifies whether summary data should be listed for all jobs and tasks in the system, or only those jobs and tasks specified on the JOB or TASK parameter.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Data for a job or task is listed in the task information file only if that job or task is specified on the JOB or TASK parameter.
</dd>
<dt><b>*YES</b></dt>
<dd>Data for all jobs and tasks is listed in the task information file, even if the job or task is not specified on the JOB or TASK parameter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPEXDFN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPEXDFN.INTERVAL"></a>
<h3>Sampling interval (INTERVAL)</h3>
<p>Specifies the interval at which samples are taken of the program. A small interval will cause a high number of samples to be taken, and will also cause higher overhead. The smaller the sampling interval, the larger the amount of trace data collected.
</p>
<p>
<b>Note: </b>This parameter is valid only when TYPE(*PROFILE) or TYPE(*TRACE) is specified.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<p><b>Element 1: Milliseconds</b>
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>Interval is not used.
</dd>
<dt><b><i>0.1-200.0</i></b></dt>
<dd>Specify the interval at which samples of the program are taken. Valid values range from 0.1 to 200.0 milliseconds.
</dd>
</dl>
<p><b>Element 2: Randomize</b>
</p>
<dl>
<dt><b><u>*FIXED</u></b></dt>
<dd>The sampling interval will always be the value specified for element 1 of this parameter.
</dd>
<dt><b>*VARY</b></dt>
<dd>The sampling interval will be approximately the value specified for element 1 of this parameter. The specified interval will be changed each time by adding or subtracting a small random percentage of the interval. This may be necessary to eliminate harmonics when the set of threads/tasks in a collection have settled into a steady state sequence of machine cycles that do not vary in order or length during the collection.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPEXDFN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPEXDFN.TRCTYPE"></a>
<h3>Trace type (TRCTYPE)</h3>
<p>Specifies what type of trace performance data to be collected. Additional information about the TRCTYPE options can be found in the Performance Management information at http://www.ibm.com/servers/eserver/iseries/perfmgmt/resource.htm.
</p>
<p>
<b>Note: </b>This parameter is only valid if TYPE(*TRACE) is specified.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<p><b>Other values</b>
</p>
<dl>
<dt><b>*CALLRTN</b></dt>
<dd>Specifies that call return events are included in the trace definition. Call return events occur when a program is entered and exited as well as when certain machine instructions are started and completed.
</dd>
<dt><b>*BASIC</b></dt>
<dd>Specifies that events relative to general performance analysis are included in the trace definition. This option should be used when it is unclear as to what type of performance problem determination is necessary.
</dd>
<dt><b>*DSKIO1</b></dt>
<dd>Specifies that events associated with disk input/output operations are included in the trace definition.
</dd>
<dt><b>*DSKIO2</b></dt>
<dd>Specifies that events associated with disk input/output operations plus higher level requests to do input/output operations are included in the trace definition.
</dd>
<dt><b>*DSKSVR</b></dt>
<dd>Specifies that events associated with disk server operations are included in the trace definition.
</dd>
<dt><b>*DSKSTG</b></dt>
<dd>Specifies that events associated with disk storage consumption are included in the trace definition.
</dd>
<dt><b>*VRTADR</b></dt>
<dd>Specifies that events associated with virtual address assignment are included in the trace definition.
</dd>
<dt><b>*PGMACT</b></dt>
<dd>Specifies that events associated with program activations and deactivations are included in the trace definition.
</dd>
<dt><b>*FILEOPEN</b></dt>
<dd>Specifies that events associated with file (*FILE) opens are included in the trace definition.
</dd>
<dt><b>*PRFDTA</b></dt>
<dd>Specifies that events associated CPU instruction profiling are included in the trace definition.
</dd>
<dt><b>*TASKSWT</b></dt>
<dd>Specifies that events associated with tasking are included in the trace definition.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPEXDFN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPEXDFN.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies the text that briefly describes the Performance Explorer definition.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*BLANK</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="#CHGPEXDFN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGPEXDFN.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Using TYPE(*TRACE)</b>
</p>
<p>
<pre>
CHGPEXDFN DFN(TEST1) TYPE(*TRACE) JOB(*) MAXSTG(5000)
</pre>
</p>
<p>This command changes the performance definition named TEST1. When this definition is used to start a performance explorer session (STRPEX command), detailed trace information will be collected for the job that invoked the STRPEX command. A maximum of 5000 kilobytes of trace data will be collected. When the trace record storage area is full no more trace records will be collected.
</p>
<p><b>Example 2: Using TYPE(*PROFILE)</b>
</p>
<p>
<pre>
CHGPEXDFN DFN(TEST2) TYPE(*PROFILE)
PGM((MYLIB/MYSRVPGM1 *ALL *ALL *SRVPGM))
</pre>
</p>
<p>This command changes the performance explorer definition named TEST2. When this definition is used to start a performance explorer session (STRPEX command), performance profile information for service program MYSRVPGM1 in library MYLIB will be collected.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPEXDFN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGPEXDFN.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPFAF0E</b></dt>
<dd>Definition not found.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPEXDFN.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink