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

376 lines
13 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>Print Lock Report (PRTLCKRPT)</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="PRTLCKRPT.Top_Of_Page"></a>
<h2>Print Lock Report (PRTLCKRPT)</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="#PRTLCKRPT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#PRTLCKRPT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#PRTLCKRPT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="PRTLCKRPT"></a>
<p>The Print Lock Report (PRTLCKRPT) command produces a report that shows lock and seize conflicts that occur during system operation. The report is produced from the resource management trace data collected by the Start Performance Trace (STRPFRTRC) command and formatted by the Print Transaction Report (PRTTNSRPT) command. This information can be used to determine if jobs are delayed during processing because of unsatisfied lock requests or internal machine seizes (these conditions are also known as waits).
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTLCKRPT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="PRTLCKRPT.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="#PRTLCKRPT.MBR"><b>MBR</b></a></td>
<td valign="top">Data base file member</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#PRTLCKRPT.LIB"><b>LIB</b></a></td>
<td valign="top">Data base file library</td>
<td valign="top"><i>Name</i>, <b><u>QPFRDATA</u></b></td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#PRTLCKRPT.TITLE"><b>TITLE</b></a></td>
<td valign="top">Report title</td>
<td valign="top"><i>Character value</i>, <b><u>*MBRTXT</u></b>, *BLANK</td>
<td valign="top">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#PRTLCKRPT.RPTTYPE"><b>RPTTYPE</b></a></td>
<td valign="top">Report type</td>
<td valign="top"><b><u>*SUM</u></b>, *TOD, *RQS, *HLD, *OBJ, *ALL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTLCKRPT.FIRST"><b>FIRST</b></a></td>
<td valign="top">First run for current data</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="5"><a href="#PRTLCKRPT.PERIOD"><b>PERIOD</b></a></td>
<td valign="top">Time period for report</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="5">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: </td>
<td valign="top">
<i>Element list</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 1: Starting time</td>
<td valign="top">
<i>Time</i>, <b><u>*FIRST</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: </td>
<td valign="top">
<i>Element list</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 1: Ending time</td>
<td valign="top">
<i>Time</i>, <b><u>*LAST</u></b></td>
</tr>
<tr>
<td valign="top"><a href="#PRTLCKRPT.MINWAIT"><b>MINWAIT</b></a></td>
<td valign="top">Minimum wait time</td>
<td valign="top">0-30000, <b><u>500</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTLCKRPT.JOB"><b>JOB</b></a></td>
<td valign="top">Job name</td>
<td valign="top"><i>Name</i>, <b><u>PRTLCKRPT</u></b>, *MBR</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#PRTLCKRPT.JOBD"><b>JOBD</b></a></td>
<td valign="top">Job description</td>
<td valign="top">Single values: *NONE<br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Job description</td>
<td valign="top"><i>Name</i>, <b><u>QPFRJOBD</u></b></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr></table>
<table width="100%">
<tr><td align="right"><a href="#PRTLCKRPT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="PRTLCKRPT.MBR"></a>
<h3>Data base file member (MBR)</h3>
<p>Specifies the member in file QAPMDMPT in which the resource management trace data is collected by the Start Performance Trace (STRPFRTRC) command.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTLCKRPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTLCKRPT.LIB"></a>
<h3>Data base file library (LIB)</h3>
<p>Specifies the library where the data is saved.
</p>
<dl>
<dt><b><u>QPFRDATA</u></b></dt>
<dd>The IBM-supplied performance data library, QPFRDATA, is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the name of the library where the data is collected.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTLCKRPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTLCKRPT.TITLE"></a>
<h3>Report title (TITLE)</h3>
<p>Specifies the title for the report that is created.
</p>
<dl>
<dt><b><u>*MBRTXT</u></b></dt>
<dd>The text of the database member, which contains the performance data, is the report title.
</dd>
<dt><b>*BLANK</b></dt>
<dd>No title is specified.
</dd>
<dt><b><i>'report-title'</i></b></dt>
<dd>Specify a title of up to 50 characters, enclosed in apostrophes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTLCKRPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTLCKRPT.RPTTYPE"></a>
<h3>Report type (RPTTYPE)</h3>
<p>Specifies the type of reports that are produced.
</p>
<dl>
<dt><b><u>*SUM</u></b></dt>
<dd>The report includes only a summary of the seize/lock data.
</dd>
<dt><b>*TOD</b></dt>
<dd>The report includes detail sorted by time of day, followed by a summary.
</dd>
<dt><b>*HLD</b></dt>
<dd>The report includes detail sorted by name of the holding job and time of day, followed by a summary.
</dd>
<dt><b>*RQS</b></dt>
<dd>The report includes detail sorted by name of the requesting job and time of day, followed by a summary.
</dd>
<dt><b>*OBJ</b></dt>
<dd>The report includes detail sorted by name of the object and time of day, followed by a summary.
</dd>
<dt><b>*ALL</b></dt>
<dd>Four reports are produced. The reports include *TOD, *HLD, *RQS, and *OBJ, followed by a summary.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTLCKRPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTLCKRPT.FIRST"></a>
<h3>First run for current data (FIRST)</h3>
<p>Specifies whether the Print Lock Report (PRTLCKRPT) command was run since the last set of resource management trace data was collected.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>This is the first time the Print Lock Report (PRTLCKRPT) command was run for the data. The data is reformatted and written to member QAPTLCKD of file QAPTLCKD. The report is created from this preprocessed data.
</dd>
<dt><b>*NO</b></dt>
<dd>The Print Lock Report (PRTLCKRPT) command is run for this set of data. The preprocessing pass is not done.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTLCKRPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTLCKRPT.PERIOD"></a>
<h3>Time period for report (PERIOD)</h3>
<p>Specifies the period of time on which to report.
</p>
<p><b>Starting Time</b>
</p>
<p>Records created before this time are not included in either the detail or summary listing.
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>The report includes records starting from the first record.
</dd>
<dt><b><i>start-time</i></b></dt>
<dd>Specify the time of the first data record to include in the report. The time is specified as 4 or 6 digits (hhmm or hhmmss), where <b>hh</b> is the hour, <b>mm</b> is the minute, and <b>ss</b> is the second.
<p>The time can be specified with or without a time separator:
</p>
<ul>
<li>Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds.
</li>
<li>With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.
</li>
</ul>
</dd>
</dl>
<p><b>Ending Time</b>
</p>
<p>Records created after this time are not included in either the detail or summary listing.
</p>
<dl>
<dt><b><u>*LAST</u></b></dt>
<dd>The report includes records through the last record.
</dd>
<dt><b><i>end-time</i></b></dt>
<dd>Specify the time of the last record to include in the report. Use the same time format as used for the starting time.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTLCKRPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTLCKRPT.MINWAIT"></a>
<h3>Minimum wait time (MINWAIT)</h3>
<p>Specifies the minimum wait time for a seize/lock record that is included in the report. Records with shorter wait times are not included in either the detail or summary listing.
</p>
<dl>
<dt><b><u>500</u></b></dt>
<dd>The default value of 500 milliseconds (half a second) is used. Records with shorter wait times are of little interest when determining the source of performance problems.
</dd>
<dt><b><i>number-of-milliseconds</i></b></dt>
<dd>Specify the minimum wait time, ranging from 0 through 30,000 milliseconds (from no minimum up to 30 seconds).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTLCKRPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTLCKRPT.JOB"></a>
<h3>Job name (JOB)</h3>
<p>Specifies the job name to be used if submitting the job for batch processing.
</p>
<p>Any value for this parameter is ignored if *NONE is specified for the <b>Job description</b> prompt (JOBD parameter).
</p>
<p>
<b>Note: </b>If *NONE is specified for the <b>Job description</b> prompt (JOBD parameter), job processing is performed interactively.
</p>
<p>The possible <b>job name</b> values are:
</p>
<dl>
<dt><b><u>PRTLCKRPT</u></b></dt>
<dd>The command name is used for the job name.
</dd>
<dt><b>*MBR</b></dt>
<dd>The name selected for the performance data member in the <b>Member</b> prompt (MBR parameter) is used.
</dd>
<dt><b><i>job-name</i></b></dt>
<dd>Specify the name to be used for any and all batch jobs.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTLCKRPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTLCKRPT.JOBD"></a>
<h3>Batch job description (JOBD)</h3>
<p>Specifies the job description used to submit the job for batch processing.
</p>
<p>The possible job description values are:
</p>
<dl>
<dt><b><u>QPFRJOBD</u></b></dt>
<dd>The IBM-supplied job description, QPFRJOBD, is used.
</dd>
<dt><b><i>job-description-name</i></b></dt>
<dd>Specify the name of an alternate job description.
</dd>
<dt><b>*NONE</b></dt>
<dd>A batch job is not submitted; processing continues interactively while the user waits. The user's workstation is not available for other use during this time, which could be significant for long jobs.
</dd>
</dl>
<p>The possible library values are:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the job's library list are searched until the first match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the job description. If no current library entry exists in the library list, QGPL is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the library in which the job description is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTLCKRPT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="PRTLCKRPT.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Producing a Summary Report</b>
</p>
<p>
<pre>
PRTLCKRPT MBR(RESTRC)
</pre>
</p>
<p>This command produces a summary report from the performance data saved in member RESTRC of QPFRDATA/QAPMDMPT from a prior run of the Start Performance Trace (STRPFRTRC) and Print Transaction Report (PRTTNSRPT) commands.
</p>
<p><b>Example 2: Including a Detail Listing Sorted By Time</b>
</p>
<p>
<pre>
PRTLCKRPT MBR(RESTRC) RPTTYPE(*TOD)
</pre>
</p>
<p>This command produces the same report as the previous example, except that it includes a detail listing sorted by the time in which the lock/seize conflicts occurred.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTLCKRPT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="PRTLCKRPT.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>PFR5511</b></dt>
<dd>Cannot access resource management trace data.
</dd>
<dt><b>PFR5512</b></dt>
<dd>Cannot access processed seize or lock conflict data.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTLCKRPT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink