1355 lines
51 KiB
HTML
1355 lines
51 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>Display Performance Graph (DSPPFRGPH)</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="DSPPFRGPH.Top_Of_Page"></a>
|
|
<h2>Display Performance Graph (DSPPFRGPH)</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="#DSPPFRGPH.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DSPPFRGPH.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DSPPFRGPH.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DSPPFRGPH"></a>
|
|
<p>The Display Performance Graph (DSPPFRGPH) command produces a graph from the performance data collected by Collection Services.
|
|
</p>
|
|
<p>The graph format must have been defined on the Create Graph Format (CRTGPHFMT) command. The graph can be sent as output to a graphics terminal, nongraphics terminal, printer, plotter, and a graphics data format (GDF) file that can be used by other systems. Jobs can be selectively included or omitted from the graph.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DSPPFRGPH.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" rowspan="3"><a href="#DSPPFRGPH.GRAPH"><b>GRAPH</b></a></td>
|
|
<td valign="top">Graph format or package</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Graph format or package</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>QPFRDATA</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.MBR"><b>MBR</b></a></td>
|
|
<td valign="top">Member</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.LIB"><b>LIB</b></a></td>
|
|
<td valign="top">Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>QPFRDATA</u></b></td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.TITLE"><b>TITLE</b></a></td>
|
|
<td valign="top">Title</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *MBRTEXT, *BLANK</td>
|
|
<td valign="top">Optional, Positional 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.SUBTITLE"><b>SUBTITLE</b></a></td>
|
|
<td valign="top">Subtitle</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *MBRTEXT, *BLANK</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.OUTPUT"><b>OUTPUT</b></a></td>
|
|
<td valign="top">Output</td>
|
|
<td valign="top"><b><u>*</u></b>, *PRINT, *PLOT, *OUTFILE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#DSPPFRGPH.OUTFILE"><b>OUTFILE</b></a></td>
|
|
<td valign="top">Output file</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Output file</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Output file library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="3"><a href="#DSPPFRGPH.OUTMBR"><b>OUTMBR</b></a></td>
|
|
<td valign="top">Output file member</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Member name</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*FIRST</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Replace or add records</td>
|
|
<td valign="top">
|
|
<b><u>*REPLACE</u></b>, *ADD</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.PLTSPD"><b>PLTSPD</b></a></td>
|
|
<td valign="top">Plotter speed</td>
|
|
<td valign="top">1-100, <b><u>100</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.PLTPEN"><b>PLTPEN</b></a></td>
|
|
<td valign="top">Plotter pen width</td>
|
|
<td valign="top">1-10, <b><u>3</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.PLTADR"><b>PLTADR</b></a></td>
|
|
<td valign="top">Plotter address</td>
|
|
<td valign="top">1-31, <b><u>1</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.PRTDEV"><b>PRTDEV</b></a></td>
|
|
<td valign="top">Printer device or type</td>
|
|
<td valign="top"><i>Name</i>, <b><u>4214</u></b>, 4234, 522X, *IPDS, *NONGRAPHIC</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#DSPPFRGPH.OUTQ"><b>OUTQ</b></a></td>
|
|
<td valign="top">Output queue</td>
|
|
<td valign="top">Single values: <b><u>*PRTDEV</u></b><br>Other values: <i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Output queue</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.PAGELEN"><b>PAGELEN</b></a></td>
|
|
<td valign="top">Page length</td>
|
|
<td valign="top"><b><u>*PRTDEV</u></b>, 51, 66</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.TYPE"><b>TYPE</b></a></td>
|
|
<td valign="top">Type</td>
|
|
<td valign="top"><b><u>*GPHFMT</u></b>, *GPHPKG</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="4"><a href="#DSPPFRGPH.XAXIS"><b>XAXIS</b></a></td>
|
|
<td valign="top">X-axis</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="4">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Range</td>
|
|
<td valign="top">
|
|
Single values: <b><u>*SAME</u></b>, *AUTO<br>Other values: <i>Element list</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 1: First</td>
|
|
<td valign="top">
|
|
0-99999</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 2: Last</td>
|
|
<td valign="top">
|
|
0-99999</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="4"><a href="#DSPPFRGPH.YAXIS"><b>YAXIS</b></a></td>
|
|
<td valign="top">Y-axis</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="4">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Range</td>
|
|
<td valign="top">
|
|
Single values: <b><u>*SAME</u></b>, *AUTO<br>Other values: <i>Element list</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 1: First</td>
|
|
<td valign="top">
|
|
0-99999</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 2: Last</td>
|
|
<td valign="top">
|
|
0-99999</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.AREAFILL"><b>AREAFILL</b></a></td>
|
|
<td valign="top">Area fill</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="7"><a href="#DSPPFRGPH.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="7">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" style="padding-left:10pt">Element 2: Starting date</td>
|
|
<td valign="top">
|
|
<i>Date</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" style="padding-left:10pt">Element 2: Ending date</td>
|
|
<td valign="top">
|
|
<i>Date</i>, <b><u>*LAST</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="4"><a href="#DSPPFRGPH.SLTJOB"><b>SLTJOB</b></a></td>
|
|
<td valign="top">Select jobs</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 50 repetitions): <i>Qualified job name</i></td>
|
|
<td valign="top" rowspan="4">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Select jobs</td>
|
|
<td valign="top"><i>Generic name, name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: User</td>
|
|
<td valign="top"><i>Generic name, name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 3: Number</td>
|
|
<td valign="top">000000-999999</td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="4"><a href="#DSPPFRGPH.OMTJOB"><b>OMTJOB</b></a></td>
|
|
<td valign="top">Omit jobs</td>
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 50 repetitions): <i>Qualified job name</i></td>
|
|
<td valign="top" rowspan="4">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Omit jobs</td>
|
|
<td valign="top"><i>Generic name, name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: User</td>
|
|
<td valign="top"><i>Generic name, name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 3: Number</td>
|
|
<td valign="top">000000-999999</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.SLTUSER"><b>SLTUSER</b></a></td>
|
|
<td valign="top">Select users</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 50 repetitions): <i>Generic name, name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.OMTUSER"><b>OMTUSER</b></a></td>
|
|
<td valign="top">Omit users</td>
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 50 repetitions): <i>Generic name, name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.SLTPOOLS"><b>SLTPOOLS</b></a></td>
|
|
<td valign="top">Select pools</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 64 repetitions): 1-64</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.OMTPOOLS"><b>OMTPOOLS</b></a></td>
|
|
<td valign="top">Omit pools</td>
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 64 repetitions): 1-64</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.SLTSBS"><b>SLTSBS</b></a></td>
|
|
<td valign="top">Select subsystems</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 50 repetitions): <i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.OMTSBS"><b>OMTSBS</b></a></td>
|
|
<td valign="top">Omit subsystems</td>
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 50 repetitions): <i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.SLTLINE"><b>SLTLINE</b></a></td>
|
|
<td valign="top">Select communications lines</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 50 repetitions): <i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.OMTLINE"><b>OMTLINE</b></a></td>
|
|
<td valign="top">Omit communications lines</td>
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 50 repetitions): <i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.SLTCTL"><b>SLTCTL</b></a></td>
|
|
<td valign="top">Select control units</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 50 repetitions): <i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.OMTCTL"><b>OMTCTL</b></a></td>
|
|
<td valign="top">Omit control units</td>
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 50 repetitions): <i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.SLTFCNARA"><b>SLTFCNARA</b></a></td>
|
|
<td valign="top">Select functional areas</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 50 repetitions): <i>Character value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.OMTFCNARA"><b>OMTFCNARA</b></a></td>
|
|
<td valign="top">Omit functional areas</td>
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 50 repetitions): <i>Character value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPFRGPH.JOB"><b>JOB</b></a></td>
|
|
<td valign="top">Job name</td>
|
|
<td valign="top"><i>Name</i>, <b><u>DSPPFRGPH</u></b>, *MBR</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#DSPPFRGPH.JOBD"><b>JOBD</b></a></td>
|
|
<td valign="top">Job description</td>
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><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>, QPFRJOBD</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="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DSPPFRGPH.GRAPH"></a>
|
|
<h3>Graph format or package (GRAPH)</h3>
|
|
<p>Specifies the graph format or graph package used to create the graph.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p>The possible library values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QPFRDATA</u></b></dt>
|
|
<dd>The IBM-supplied performance data library, QPFRDATA, is where the graph format or graph package is located.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the graph format or graph package. If no library is specified as the current library for the job, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the name of the library where the graph format or graph package is located.
|
|
</dd>
|
|
</dl>
|
|
<p>Since the following are not elements, they are mutually exclusive. Therefore, specify the name of the graph format or specify the name of the graph package. You cannot specify them at the same time.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>format-name</i></b></dt>
|
|
<dd>Specify the name of the graph format.
|
|
</dd>
|
|
<dt><b><i>package-name</i></b></dt>
|
|
<dd>Specify the name of the graph package.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.MBR"></a>
|
|
<h3>Member (MBR)</h3>
|
|
<p>Specifies the performance data to be used in your performance graph. Specify the name of the member.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.LIB"></a>
|
|
<h3>Library (LIB)</h3>
|
|
<p>Specifies the library in which the performance data member to be used in the graph is located.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QPFRDATA</u></b></dt>
|
|
<dd>The IBM-supplied performance data library, QPFRDATA, is where the performance data member is located.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the library where the performance data member is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.TITLE"></a>
|
|
<h3>Title (TITLE)</h3>
|
|
<p>Specifies a title to display at the top of the graph or each graph of a package.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The graph title defined in the graph format is used.
|
|
</dd>
|
|
<dt><b>*BLANK</b></dt>
|
|
<dd>A blank title is used.
|
|
</dd>
|
|
<dt><b>*MBRTEXT</b></dt>
|
|
<dd>The text of the selected member is used.
|
|
</dd>
|
|
<dt><b><i>graph-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="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.SUBTITLE"></a>
|
|
<h3>Subtitle (SUBTITLE)</h3>
|
|
<p>Specifies a subtitle to display at the top of the graph or each graph of a package.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The text of the graph subtitle defined in the graph format is used.
|
|
</dd>
|
|
<dt><b>*BLANK</b></dt>
|
|
<dd>A blank subtitle is used.
|
|
</dd>
|
|
<dt><b>*MBRTEXT</b></dt>
|
|
<dd>The text of the selected member is used.
|
|
</dd>
|
|
<dt><b><i>graph-subtitle</i></b></dt>
|
|
<dd>Specify a subtitle of up to 50 characters enclosed in apostrophes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.OUTPUT"></a>
|
|
<h3>Output (OUTPUT)</h3>
|
|
<p>Specifies whether the graph is to be displayed, printed, plotted, or saved in a graphics data format (GDF) file.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>The graph is to be displayed on the output screen. This special value is not valid if <b>JOBD(*NONE)</b> is not specified.
|
|
<p>Your display station can be either a graphics or nongraphics display station. A graphics display station shows the graph with colors, shading, and so forth. A nongraphics display station shows the graph using characters you choose to represent colors, shading, and so forth.
|
|
</p>
|
|
<p>Once your graph is shown, you can define one overlay. An overlay is a graph that is placed on top of the current graph.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*PRINT</b></dt>
|
|
<dd>The graph is printed to the printer file, QPPGGPH while the spooled output file is named the same as the graph format.
|
|
<p><b>Note:</b>
|
|
</p>
|
|
<p>The appearance of graphs printed or displayed by graphical devices can be different from how they appear when printed or displayed by nongraphical devices, especially when *AUTO is specified for the Y (vertical) axis.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*PLOT</b></dt>
|
|
<dd>The graph is plotted on an attached plotter. This value is not valid if JOBD(*NONE) is not specified. The 6180, 6182, 7371, and 7372 plotters are supported.
|
|
</dd>
|
|
<dt><b>*OUTFILE</b></dt>
|
|
<dd>The graph is saved to the graphics data format (GDF) file specified in the <b>Output file</b> prompt (OUTFILE parameter). This option is not valid if a package is being displayed.
|
|
<p>You can use this file to display the graph on any system supporting the graphical data display manager function or the Business Graphics Utility licensed program.
|
|
</p>
|
|
<p><b>Note:</b>
|
|
</p>
|
|
<p>Graph packages cannot be sent to a GDF file.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.OUTFILE"></a>
|
|
<h3>Output file (OUTFILE)</h3>
|
|
<p>Specifies the library and file in which the graph data format is to be saved. This parameter is only valid when <b>OUTPUT(*OUTFILE)</b> is specified. The graph is saved in a graphics data format (GDF) file.
|
|
</p>
|
|
<p>The possible library values are:
|
|
</p>
|
|
<dl>
|
|
<dl>
|
|
<dt><b><u>QPFRDATA</u></b></dt>
|
|
<dd>The IBM-supplied performance data library, QPFRDATA, is where the graph is saved.
|
|
</dd>
|
|
<dt><b>*LIBL</b></dt>
|
|
<dd>Search the library list to locate the file in which to save the graph.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>Search the current job library to locate the file in which to save the graph. If no current job library entry exists in the library list, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the name of the library where the graph is to be saved.
|
|
</dd>
|
|
</dl>
|
|
<dt><b><i>file-name</i></b></dt>
|
|
<dd>Specify the name of the file into which the graph is to be saved.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.OUTMBR"></a>
|
|
<h3>Output file member (OUTMBR)</h3>
|
|
<p>Specifies the format member in which the graph is to be saved. This parameter is valid only when <b>OUTPUT(*OUTFILE)</b> is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>The first member in the file receives the output. If <b>OUTMBR(*FIRST)</b> is specified and the member does not exist, the system creates a member with the name of the file specified in the <b>Output file</b> prompt (OUTFILE parameter).
|
|
</dd>
|
|
<dt><b><i>member-name</i></b></dt>
|
|
<dd>Specify the name of the member into which the graph is to be saved. If <b>OUTMBR(member-name)</b> is specified and the member does not exist, the system creates it. If the member already exists, you have the option to add new records to the end of the existing member or clear the member and then add the new records.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible optional values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*REPLACE</u></b></dt>
|
|
<dd>If a member exists, the system clears it and adds the new records.
|
|
</dd>
|
|
<dt><b>*ADD</b></dt>
|
|
<dd>If a member exists, the system adds the new records to the end of the existing records.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.PLTSPD"></a>
|
|
<h3>Plotter speed (PLTSPD)</h3>
|
|
<p>Specifies the speed at which the plotter creates the graph. A larger value represents a faster plotting rate. The smaller the value the better the plotting quality of the graph. This parameter is valid only when <b>OUTPUT(*PLOT)</b> is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>100</u></b></dt>
|
|
<dd>A plotter speed of 100 is used.
|
|
</dd>
|
|
<dt><b><i>plotter-speed</i></b></dt>
|
|
<dd>Specify the speed of the plotter. The plotter speed ranges from 1 through 100 (velocity).
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.PLTPEN"></a>
|
|
<h3>Plotter pen width (PLTPEN)</h3>
|
|
<p>Specifies the pen width in which to shade the graph. The smaller the value, the closer together the lines will be for shading. If you choose a small value, the graph takes longer to plot. If the value is too large, the shading will have gaps in it. This parameter is valid only when <b>OUTPUT(*PLOT)</b> is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>3</u></b></dt>
|
|
<dd>A pen width of .3 millimeters is used.
|
|
</dd>
|
|
<dt><b><i>pen-width</i></b></dt>
|
|
<dd>Specify the width of the pen. The pen widths range from .1 millimeter through 1 millimeter. Valid values range from 1 through 10.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.PLTADR"></a>
|
|
<h3>Plotter address (PLTADR)</h3>
|
|
<p>Specifies the plotter address for the terminal on which the graph is to be created.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>1</u></b></dt>
|
|
<dd>Use the plotter designated by address 1.
|
|
</dd>
|
|
<dt><b><i>plotter-address</i></b></dt>
|
|
<dd>Specify the address of the plotter. Valid values range from 1 through 31.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.PRTDEV"></a>
|
|
<h3>Printer device or type (PRTDEV)</h3>
|
|
<p>Specifies the name of the printer or the type of printer on which the graph is to be printed. If a printer name is used, for example, PRT01, PRT02, and so on, the output is spooled to the output queue of the printer. If a printer type is specified, for example, 4214, the output is spooled to the output queue specified on the <b>Output queue</b> prompt (OUTQ parameter). This parameter is valid only when <b>OUTPUT(*PRINT)</b> is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>4214</u></b></dt>
|
|
<dd>The 4214 printer is used.
|
|
</dd>
|
|
<dt><b>4234</b></dt>
|
|
<dd>The 4234 printer is used.
|
|
</dd>
|
|
<dt><b>522X</b></dt>
|
|
<dd>One of the 522 series printer are used. They are the 5224 and 5225 printers.
|
|
</dd>
|
|
<dt><b>*IPDS</b></dt>
|
|
<dd>One of the Intelligent Printer Data Stream (IPDS) printers are used. They are the 3812 and 4224 printers.
|
|
</dd>
|
|
<dt><b>*NONGRAPHIC</b></dt>
|
|
<dd>The output is not spooled in a graphics format for printing on printers that do not support graphics.
|
|
</dd>
|
|
<dt><b><i>printer-name</i></b></dt>
|
|
<dd>Specify the system name of the printer to which the output is sent.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.OUTQ"></a>
|
|
<h3>Output queue (OUTQ)</h3>
|
|
<p>Specifies the name and library of the output queue to which the printer file is to be sent.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PRTDEV</u></b></dt>
|
|
<dd>The output queue associated with the printer is used. If a printer type has been specified, the output is sent to the job's output queue.
|
|
</dd>
|
|
<dt><b><i>output-queue-name</i></b></dt>
|
|
<dd>Specify the name of the output queue.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible library values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b>*LIBL</b></dt>
|
|
<dd>All libraries in the job's library list are searched until the first match is found.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the name of the library where the output queue is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.PAGELEN"></a>
|
|
<h3>Page length (PAGELEN)</h3>
|
|
<p>Specifies the page length for graphs. The PAGELEN parameter is valid only when OUTPUT(*PRINT) is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PRTDEV</u></b></dt>
|
|
<dd>The page length for the printer or printer type specified on the PRTDEV parameter is used.
|
|
</dd>
|
|
<dt><b>51</b></dt>
|
|
<dd>Specifies 51 lines per page (8.5 inches).
|
|
</dd>
|
|
<dt><b>66</b></dt>
|
|
<dd>Specifies 66 lines per page (11 inches).
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.TYPE"></a>
|
|
<h3>Type (TYPE)</h3>
|
|
<p>Specifies whether the graph is a graph format or a graph package.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*GPHFMT</u></b></dt>
|
|
<dd>The graph is a graph format.
|
|
</dd>
|
|
<dt><b>*GPHPKG</b></dt>
|
|
<dd>The graph is a graph package.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.XAXIS"></a>
|
|
<h3>X-axis (XAXIS)</h3>
|
|
<p>Specifies the range used on the X-axis.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The range specified in the graph format is used.
|
|
</dd>
|
|
<dt><b>*AUTO</b></dt>
|
|
<dd>The system determines a range based on the data being used.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible <b>Starting Number</b> value is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>starting-number</i></b></dt>
|
|
<dd>Specify the starting number for the range on the X-axis. This user-defined variable is not valid if you have specified *TIME for the X-axis. If you specify a starting number, you must also specify an ending number.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible <b>Ending Number</b> value is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>ending-number</i></b></dt>
|
|
<dd>Specify the ending number for the range on the X-axis. This user-defined variable is not valid if you have specified *TIME for the X-axis. If you specify an ending number, you must also specify a starting number.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.YAXIS"></a>
|
|
<h3>Y-axis (YAXIS)</h3>
|
|
<p>Specifies the range used on the Y-axis.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The range specified in the graph format is used.
|
|
</dd>
|
|
<dt><b>*AUTO</b></dt>
|
|
<dd>The system determines a range based on the data being used.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible <b>Starting Number</b> value is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>starting-number</i></b></dt>
|
|
<dd>Specify the starting number for the range on the Y-axis. If you specify a starting number, you must also specify an ending number.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible <b>Ending Number</b> value is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>ending-number</i></b></dt>
|
|
<dd>Specify the ending number for the range on the Y-axis. If you specify an ending number, you must also specify a starting number.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.AREAFILL"></a>
|
|
<h3>Area fill (AREAFILL)</h3>
|
|
<p>Specifies whether the graph is to be displayed with surfaces and bars filled in with a shading pattern.
|
|
</p>
|
|
<p>This parameter allows you to display detailed graphs quickly. If you specify <b>AREAFILL(*NO)</b> on this command when you have specified <b>AREAFILL(*YES)</b> on the CRTGPHFMT command, the graph is displayed more quickly. This is caused by the fact that it takes longer to fill in areas with shading patterns than it does to draw lines. Also, the more dense the shading pattern, the more time it takes. These issues are important if time is short and graphic quality is not momentarily important.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The graph is shaded according to the graph format definition.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The graph will be filled in with a shading pattern.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>The graph will not be filled in with a shading pattern.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.PERIOD"></a>
|
|
<h3>Time period for report (PERIOD)</h3>
|
|
<p>Specifies the period of time for which to collect performance information for the performance graph. The starting and ending times and dates consists of four elements:
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
PERIOD((start-time start-date) (end-time end-date))
|
|
</pre>
|
|
</p>
|
|
<p>*N can be used in place of an element that precedes the value being specified in order to maintain positioning. For example, PERIOD(*N(*N 091289)) specifies the ending date and the default values for start-time, start-date, and end-time.
|
|
</p>
|
|
<p>One of the following values is used to specify the starting time. Information collected before the starting time and starting date is not included on the graph.
|
|
</p>
|
|
<p>The possible <b>Starting Time</b> values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>Records starting at the beginning of the day are collected.
|
|
</dd>
|
|
<dt><b><i>start-time</i></b></dt>
|
|
<dd>Specify the time after which records are collected.
|
|
<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. All three must be exactly 2 digits (use leading zeros if necessary).
|
|
</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>
|
|
<p>The time is in 24-hour format; for example, use 13:00 for 1 p.m.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p>One of the following values is used to specify the starting date. Information collected before the starting time on the date specified on this parameter is not included on the graph.
|
|
</p>
|
|
<p>The possible <b>Starting Date</b> values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>Records starting on the first day of the collection period are included on the graph.
|
|
</dd>
|
|
<dt><b><i>start-date</i></b></dt>
|
|
<dd>Specify the date after which records are collected. The date must be entered in the format specified by the system values QDATFMT and, if separators are used, QDATSEP. For instance, the system might have a date format of <i>'mm/dd/yy'</i>. The month (mm), day (dd), and year (yy) are all required 1- or 2-digit values. The slashes (/) are optional if all 6 digits are specified. If the slashes are omitted, or if the value is entered from the prompt display, the apostrophes are not required.
|
|
</dd>
|
|
</dl>
|
|
<p>One of the following values is used to specify the ending time. Information collected after the ending time and ending date is not included on the graph.
|
|
</p>
|
|
<p>The possible <b>Ending Time</b> values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LAST</u></b></dt>
|
|
<dd>Records through the end of the day (23:59:59) are included on the graph.
|
|
</dd>
|
|
<dt><b><i>end-time</i></b></dt>
|
|
<dd>Specify the time after which records are not collected. See <i>start-time</i> in this parameter for details on how the time must be specified.
|
|
</dd>
|
|
</dl>
|
|
<p>One of the following values is used to specify the ending date. Information collected after the ending time and ending date is not included on the graph.
|
|
</p>
|
|
<p>The possible <b>Ending Date</b> values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LAST</u></b></dt>
|
|
<dd>Records through the last day of the collection period are included on the graph.
|
|
</dd>
|
|
<dt><b><i>end-date</i></b></dt>
|
|
<dd>Specify the date after which records are no longer collected. See <i>start-date</i> in this parameter for details on how the date must be specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.SLTJOB"></a>
|
|
<h3>Select jobs (SLTJOB)</h3>
|
|
<p>Specifies a list of up to 50 jobs to select. Only specified jobs are included on the graph.
|
|
</p>
|
|
<p>A job identifier is either the special value *ALL or a qualified name with up to three elements, for example:
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
*ALL
|
|
job-name
|
|
user-name/job-name
|
|
job-number/user-name/job-name
|
|
</pre>
|
|
</p>
|
|
<p>*N can be used in place of an element that follows the values being specified in order to maintain positioning. For example, 123456/*N/*N specifies only the job number 123456, regardless of the job and user names. Without the *N's, 123456 would have been interpreted as the job name, and not the job number.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The <b>Select jobs</b> prompt (SLTJOB parameter) and the <b>Omit jobs</b> prompt (OMTJOB parameter) are mutually exclusive.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All jobs in the collected data are included, unless excluded by some other selection criteria.
|
|
</dd>
|
|
<dt><b><i>job-name</i></b></dt>
|
|
<dd>Specify the name of the jobs to select. Because jobs may have identical job names, this value may not identify a specific job. This can be either a specific or generic name.
|
|
</dd>
|
|
<dt><b><i>user-name</i></b></dt>
|
|
<dd>Specify the user name of the jobs to select. Because jobs may have identical user names, this value may not identify a specific job. This can be either a specific or generic name.
|
|
</dd>
|
|
<dt><b><i>job-number</i></b></dt>
|
|
<dd>Specify the 6-digit number of a job to select. All 6 digits must be specified (use leading zeros if necessary).
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.OMTJOB"></a>
|
|
<h3>Omit jobs (OMTJOB)</h3>
|
|
<p>Specifies a list of up to 50 jobs to omit. All jobs specified are excluded from the graph.
|
|
</p>
|
|
<p>A job identifier is either the special value *NONE or a qualified name with up to three elements. *N can be used in place of an element to maintain the position in the parameter value sequence.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The <b>Select jobs</b> prompt (SLTJOB parameter) and <b>Omit jobs</b> prompt (OMTJOB parameter) are mutually exclusive.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>Jobs are not excluded based on job identifier.
|
|
</dd>
|
|
<dt><b><i>job-name</i></b></dt>
|
|
<dd>Specify the name of the jobs to omit. Because jobs may have identical job names, this value may not identify a specific job. This can be either a specific or generic name.
|
|
</dd>
|
|
<dt><b><i>user-name</i></b></dt>
|
|
<dd>Specify the user name of the jobs to omit. Because jobs may have identical user names, this value may not identify a specific job. This can be either a specific or generic name.
|
|
</dd>
|
|
<dt><b><i>job-number</i></b></dt>
|
|
<dd>Specify the 6-digit number of a job to omit. All 6 digits must be specified (use leading zeros if necessary).
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.SLTUSER"></a>
|
|
<h3>Select users (SLTUSER)</h3>
|
|
<p>Specifies a list of up to 50 user names to select. Only jobs with one of the specified user names are included on the graph.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The <b>Select users</b> prompt (SLTUSER parameter) and <b>Omit users</b> prompt (OMTUSER parameter) are mutually exclusive.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Jobs with all user names are included, unless excluded by other selection criteria.
|
|
</dd>
|
|
<dt><b><i>user-name</i></b></dt>
|
|
<dd>Specify the user name of the jobs to select. Because jobs may have identical user names, this value may not identify a specific job. This can be either a specific or generic name. <b>SLTUSER(user)</b> is equivalent to <b>SLTJOB(*N/user/*N)</b>.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.OMTUSER"></a>
|
|
<h3>Omit users (OMTUSER)</h3>
|
|
<p>Specifies a list of up to 50 user names to omit. Jobs with any of the names specified are excluded from the graph.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The <b>Select users</b> prompt (SLTUSER parameter) and <b>Omit users</b> prompt (OMTUSER parameter) are mutually exclusive.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No jobs are excluded based on user name.
|
|
</dd>
|
|
<dt><b><i>user-name</i></b></dt>
|
|
<dd>Specify the user name of jobs to omit. Because jobs may have identical user names, this value may not identify a specific job. This can be either a specific or generic name. <b>OMTUSER(user)</b> is equivalent to <b>OMTJOB(*N/user/*N)</b>.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.SLTPOOLS"></a>
|
|
<h3>Select pools (SLTPOOLS)</h3>
|
|
<p>Specifies a list of up to 64 pools to select. Only jobs running in one of the specified pools are included on the graph.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The <b>Select pools</b> prompt (SLTPOOLS parameter) and <b>Omit pools</b> prompt (OMTPOOLS parameter) are mutually exclusive.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Jobs running in all pools are included, unless excluded by other selection criteria.
|
|
</dd>
|
|
<dt><b><i>storage-pool-identifier</i></b></dt>
|
|
<dd>Specify the number of a pool to select. Valid values range from 1 to 64.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.OMTPOOLS"></a>
|
|
<h3>Omit pools (OMTPOOLS)</h3>
|
|
<p>Specifies a list of up to 64 pools to omit. Jobs running in the specified pools are excluded from the graph.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The <b>Select pools</b> prompt (SLTPOOLS parameter) and <b>Omit pools</b> prompt (OMTPOOLS parameter) are mutually exclusive.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No jobs are excluded based on their pool.
|
|
</dd>
|
|
<dt><b><i>storage-pool-identifier</i></b></dt>
|
|
<dd>Specify the number of a pool to omit. Valid values range from 1 to 64.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.SLTSBS"></a>
|
|
<h3>Select subsystems (SLTSBS)</h3>
|
|
<p>Specifies a list of up to 50 subsystems to select. Only jobs running in one of the specified subsystems are included on the graph.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The <b>Select subsystems</b> prompt (SLTSBS parameter) and <b>Omit subsystems</b> prompt (OMTSBS parameter) are mutually exclusive.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Jobs in all subsystems are included, unless excluded by other selection criteria.
|
|
</dd>
|
|
<dt><b><i>subsystem-name</i></b></dt>
|
|
<dd>Specify the name of a subsystem to select.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.OMTSBS"></a>
|
|
<h3>Omit subsystems (OMTSBS)</h3>
|
|
<p>Specifies a list of up to 50 subsystems to omit. Jobs running in the specified subsystems are excluded from the graph.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The <b>Select subsystems</b> prompt (SLTSBS parameter) and <b>Omit subsystems</b> prompt (OMTSBS parameter) are mutually exclusive.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No jobs are excluded based on subsystem.
|
|
</dd>
|
|
<dt><b><i>subsystem-name</i></b></dt>
|
|
<dd>Specify the name of a subsystem to omit.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.SLTLINE"></a>
|
|
<h3>Select communications lines (SLTLINE)</h3>
|
|
<p>Specifies a list of up to 50 communications lines to select. Only jobs using a remote device connected through one of the specified communications lines are included on the graph.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The <b>Select communications lines</b> prompt (SLTLINE parameter) and <b>Omit communications lines</b> prompt (OMTLINE parameter) are mutually exclusive.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All jobs are included, unless excluded by other selection criteria.
|
|
</dd>
|
|
<dt><b><i>communications-line-name</i></b></dt>
|
|
<dd>Specify the name of a communications line to select. This excludes jobs using remote devices connected through other communications lines (or no communications line), even if the controllers to which those devices are attached are specified on the SLTCTL parameter.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.OMTLINE"></a>
|
|
<h3>Omit communications lines (OMTLINE)</h3>
|
|
<p>Specifies a list of up to 50 communications lines to omit. Jobs using a remote device connected through any of the specified lines are excluded from the graph.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The <b>Select communications lines</b> prompt (SLTLINE parameter) and <b>Omit communications lines</b> prompt (OMTLINE parameter) are mutually exclusive.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>Jobs are not excluded based on communications line.
|
|
</dd>
|
|
<dt><b><i>communications-line-name</i></b></dt>
|
|
<dd>Specify the name of a communications line to omit.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.SLTCTL"></a>
|
|
<h3>Select control units (SLTCTL)</h3>
|
|
<p>Specifies a list of up to 50 communications controllers to select. Only jobs using a device connected to one of the specified communications controllers are included on the graph.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The <b>Select control units</b> prompt (SLTCTL parameter) and <b>Omit control units</b> prompt (OMTCTL parameter) are mutually exclusive.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All jobs are included, unless excluded by other selection criteria.
|
|
</dd>
|
|
<dt><b><i>controller-name</i></b></dt>
|
|
<dd>Specify the name of a communications controller to select.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.OMTCTL"></a>
|
|
<h3>Omit control units (OMTCTL)</h3>
|
|
<p>Specifies a list of up to 50 communications controllers to omit. Jobs using a device connected to any of the specified communications controllers are excluded from the graph.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The <b>Select control units</b> prompt (SLTCTL parameter) and <b>Omit control units</b> prompt (OMTCTL parameter) are mutually exclusive.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>Jobs are not excluded based on communications controller.
|
|
</dd>
|
|
<dt><b><i>controller-name</i></b></dt>
|
|
<dd>Specify the name of a communications controller to omit.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.SLTFCNARA"></a>
|
|
<h3>Select functional areas (SLTFCNARA)</h3>
|
|
<p>Specifies a list of up to 50 functional areas to select. Only jobs identified in one of the functional areas are included on the graph.
|
|
</p>
|
|
<p>A functional area is a list of jobs and/or user names previously defined by the user. Information on defining functional areas is in the Performance Tools for iSeries book.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The <b>Select functional areas</b> prompt (SLTFCNARA parameter) and <b>Omit functional areas</b> prompt (OMTFCNARA parameter) are mutually exclusive.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All jobs are included, unless excluded by other selection criteria.
|
|
</dd>
|
|
<dt><b><i>functional-area-name</i></b></dt>
|
|
<dd>Specify the name of a functional area to select.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.OMTFCNARA"></a>
|
|
<h3>Omit functional areas (OMTFCNARA)</h3>
|
|
<p>Specifies a list of up to 50 functional areas to omit. Jobs and users identified in any of the functional areas are excluded from the graph.
|
|
</p>
|
|
<p>A functional area is a list of job and user names previously defined by the user. Information on defining functional areas is found in the Performance Tools for iSeries book.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The <b>Select functional areas</b> prompt (SLTFCNARA parameter) and <b>Omit functional areas</b> prompt (OMTFCNARA parameter) are mutually exclusive.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No jobs are excluded based on functional area.
|
|
</dd>
|
|
<dt><b><i>functional-area-name</i></b></dt>
|
|
<dd>Specify the name of a functional area to omit.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.JOB"></a>
|
|
<h3>Job name (JOB)</h3>
|
|
<p>Specifies the job name to be used if submitting a job for batch processing.
|
|
</p>
|
|
<p>If *NONE is specified for the <b>Job description</b> prompt (JOBD parameter), this parameter is ignored and job processing is performed interactively.
|
|
</p>
|
|
<p>The possible <b>job-name</b> values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>DSPPFRGPH</u></b></dt>
|
|
<dd>The command name is used for the job name.
|
|
</dd>
|
|
<dt><b>*MBR</b></dt>
|
|
<dd>The name of the performance data member specified on 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 batch jobs.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFRGPH.JOBD"></a>
|
|
<h3>Job description (JOBD)</h3>
|
|
<p>Specifies the job description used to submit jobs for batch processing.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>A batch job is not submitted; instead, processing continues interactively while the user waits. The user's work station cannot be used during this time. This is something to consider for especially long jobs.
|
|
<dl>
|
|
<dt><b>*LIBL</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 library is specified as the current library for the job, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the name of the library where the job description is located.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b>QPFRJOBD</b></dt>
|
|
<dd>The IBM-supplied performance tools job description is used.
|
|
</dd>
|
|
<dt><b><i>job-description-name</i></b></dt>
|
|
<dd>Specify the name of an alternate job description.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPPFRGPH.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Displaying Performance Data Files</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPPFRGPH GRAPH(GRAPHLIB/CPU) MBR(QPFRDATA/JUN1)
|
|
TITLE(*MBRTEXT)
|
|
</pre>
|
|
</p>
|
|
<p>This command displays the performance data files in library QPFRDATA member JUN1. It is displayed as specified by graph format CPU in library GRAPHLIB. The report title is taken from the text of the member.
|
|
</p>
|
|
<p><b>Example 2: Saving a Graph</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPPFRGPH GRAPH(GRAPHLIB/CPU) MBR(JUN1) OUTPUT(*OUTFILE)
|
|
OUTFILE(USERLIB/USERFILE) OUTMBR(TEST)
|
|
JOBD(*LIBL/QPFRJOBD)
|
|
</pre>
|
|
</p>
|
|
<p>This command submits a job to save the graph of performance data from file member JUN1, which is in library QPFRDATA, in a GDF file. The graph is saved in file USERLIB/USERFILE/TEST (file member TEST in file USRFILE, which is in library USRLIB).
|
|
</p>
|
|
<p><b>Example 3: Printing a Graph</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPPFRGPH GRAPH(GRAPHLIB/CPU) MBR(JUN1) OUTPUT(*PRINT)
|
|
PRTDEV(PRT03) JOBD(*LIBL/QPFRJOBD)
|
|
</pre>
|
|
</p>
|
|
<p>This command submits a job to print the graph of performance data from file member JUN1, which is in library QPFRDATA, on the system printer named PRT03.
|
|
</p>
|
|
<p><b>Example 4: Printing All Graphs</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPPFRGPH GRAPH(GRAPHLIB/PACKAGE1) MBR(JUN1) OUTPUT(*PRINT)
|
|
PRTDEV(PRT03) JOBD(*LIBL/QPFRJOBD) TYPE(*GPHPKG)
|
|
</pre>
|
|
</p>
|
|
<p>This command submits a job to print all of the graphs defined in PACKAGE1 in GRAPHLIB. The print job is sent to system printer PRT03. It's data source is in performance data member JUN1 in library QPFRDATA.
|
|
</p>
|
|
<p><b>Example 5: Displaying a Graph</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPPFRGPH GRAPH(GRAPHLIB/CPU) MBR(JUN1) OUTPUT(*)
|
|
PERIOD((2330)(0130))
|
|
</pre>
|
|
</p>
|
|
<p>This command displays a graph of the data collected from 11:30 PM on the first day of collection through 1:30 AM on the last day of collection. However, if data collection started and ended on the same day, an error message is printed, because the specified ending date and time precedes the specified starting date and time.
|
|
</p>
|
|
<p><b>Example 6: Displaying a Graph for Selected Users</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPPFRGPH GRAPH(GRAPHLIB/CPU) MBR(JUN1) OUTPUT(*)
|
|
PERIOD((2330)(0130)) SLTUSER(D46*)
|
|
</pre>
|
|
</p>
|
|
<p>This command displays a graph of the performance data collected for all the jobs whose user ID starts with D46 from 11:30 PM on the first day of collection through 1:30 AM on the last day of collection. However, if data collection started and ended on the same day, an error message is printed, because the specified ending date and time precedes the specified starting date and time.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPPFRGPH.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>PFR5501</b></dt>
|
|
<dd>Performance data file(s) are not upward compatible.
|
|
</dd>
|
|
<dt><b>PFR5502</b></dt>
|
|
<dd>Performance data file(s) are not downward compatible.
|
|
</dd>
|
|
<dt><b>PFR9031</b></dt>
|
|
<dd>Cannot use member &3 in performance graph.
|
|
</dd>
|
|
<dt><b>PFR9046</b></dt>
|
|
<dd>Jobs defined in more than one functional area.
|
|
</dd>
|
|
<dt><b>PFR9049</b></dt>
|
|
<dd>Graph format &1 in library &3 does not exist.
|
|
</dd>
|
|
<dt><b>PFR9068</b></dt>
|
|
<dd>Value for OUTFILE parameter must be specified.
|
|
</dd>
|
|
<dt><b>PFR9069</b></dt>
|
|
<dd>*NONE value must be specified for JOBD parameter.
|
|
</dd>
|
|
<dt><b>PFR9071</b></dt>
|
|
<dd>X-axis variable for both graphs must be the same.
|
|
</dd>
|
|
<dt><b>PFR9075</b></dt>
|
|
<dd>Plotter not found.
|
|
</dd>
|
|
<dt><b>PFR9076</b></dt>
|
|
<dd>Plotter type not supported.
|
|
</dd>
|
|
<dt><b>PFR9077</b></dt>
|
|
<dd>Graph format has too many legend entries for overlay.
|
|
</dd>
|
|
<dt><b>PFR9078</b></dt>
|
|
<dd>Cannot display graph because of missing data.
|
|
</dd>
|
|
<dt><b>PFR9079</b></dt>
|
|
<dd>Cannot write graph to output file.
|
|
</dd>
|
|
<dt><b>PFR9080</b></dt>
|
|
<dd>Specify *AUTO for range with *TIME for X-axis.
|
|
</dd>
|
|
<dt><b>PFR9082</b></dt>
|
|
<dd>Printer &1 not found.
|
|
</dd>
|
|
<dt><b>PFR9083</b></dt>
|
|
<dd>Graph format selected for historical graph not valid.
|
|
</dd>
|
|
<dt><b>PFR9096</b></dt>
|
|
<dd>Historical Data File QAPGHSTD not found in Library &1.
|
|
</dd>
|
|
<dt><b>PFR9097</b></dt>
|
|
<dd>Cannot copy graph format &1 onto itself.
|
|
</dd>
|
|
<dt><b>PFR9098</b></dt>
|
|
<dd>Cannot copy graph package &1 onto itself.
|
|
</dd>
|
|
<dt><b>PFR9099</b></dt>
|
|
<dd>Cannot copy functional area &1 onto itself.
|
|
</dd>
|
|
<dt><b>PFR9101</b></dt>
|
|
<dd>Graph has too many data points to display.
|
|
</dd>
|
|
<dt><b>PFR9107</b></dt>
|
|
<dd>Graph format &1 is not valid.
|
|
</dd>
|
|
<dt><b>PFR9113</b></dt>
|
|
<dd>Cannot display graph because of missing data.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFRGPH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|