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/dsphstgph.htm

920 lines
33 KiB
HTML
Raw Normal View History

Add readme and dist folders
2024-04-02 14:02:31 +00:00
<!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 Historical Graph (DSPHSTGPH)</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="DSPHSTGPH.Top_Of_Page"></a>
<h2>Display Historical Graph (DSPHSTGPH)</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="#DSPHSTGPH.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DSPHSTGPH.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DSPHSTGPH.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DSPHSTGPH"></a>
<p>The Display Historical Graph (DSPHSTGPH) command produces a graph from the historical data created by the Create Historical Data (CRTHSTDTA) command. The DSPHSTGPH command is intended to give you a historical perspective of your system in a graphic representation.
</p>
<p>The CRTHSTDTA command summarizes the performance data collected by Collection Services. The graph format must have been defined by the Create Graph Format (CRTGPHFMT) command. The graph can be directed to a graphics terminal, non-graphics terminal, printer, plotter, and a graphics data format (GDF) file that can be used by other systems. Historical data members can be selectively included in the graph.
</p>
<p>It is important that the Create Historical Data (CRTHSTDTA) command has been run for each of the members that you want to include in the graph. If CRTHSTDTA has not been run for a member, it is not included in the graph unless you specify *YES on the <b>Create historical data</b> prompt (CRTHSTDTA parameter) of this command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPHSTGPH.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="#DSPHSTGPH.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="#DSPHSTGPH.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 2</td>
</tr>
<tr>
<td valign="top"><a href="#DSPHSTGPH.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</td>
</tr>
<tr>
<td valign="top"><a href="#DSPHSTGPH.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="#DSPHSTGPH.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="#DSPHSTGPH.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="#DSPHSTGPH.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="#DSPHSTGPH.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="#DSPHSTGPH.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="#DSPHSTGPH.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="#DSPHSTGPH.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="#DSPHSTGPH.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="#DSPHSTGPH.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="#DSPHSTGPH.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="3"><a href="#DSPHSTGPH.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="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Starting date</td>
<td valign="top">
<i>Date</i>, <b><u>*FIRST</u></b>, *SELECT</td>
</tr>
<tr>
<td valign="top">Element 2: Ending date</td>
<td valign="top">
<i>Date</i>, <b><u>*LAST</u></b></td>
</tr>
<tr>
<td valign="top"><a href="#DSPHSTGPH.CRTHSTDTA"><b>CRTHSTDTA</b></a></td>
<td valign="top">Create historical data</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#DSPHSTGPH.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="#DSPHSTGPH.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="#DSPHSTGPH.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"><a href="#DSPHSTGPH.JOB"><b>JOB</b></a></td>
<td valign="top">Job name</td>
<td valign="top"><i>Name</i>, <b><u>DSPHSTGPH</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#DSPHSTGPH.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="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DSPHSTGPH.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="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPHSTGPH.LIB"></a>
<h3>Library (LIB)</h3>
<p>Specifies the library in which the historical data created by the Create Historical Data (CRTHSTDTA) command is located.
</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 historical data is located.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the library where the historical data is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPHSTGPH.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 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 that was last created by the performance monitor 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="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPHSTGPH.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 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 that was last created by the performance monitor is used.
</dd>
<dt><b><i>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="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPHSTGPH.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="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPHSTGPH.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>*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>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="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPHSTGPH.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="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPHSTGPH.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="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPHSTGPH.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="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPHSTGPH.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="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPHSTGPH.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="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPHSTGPH.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="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPHSTGPH.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="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPHSTGPH.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="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPHSTGPH.PERIOD"></a>
<h3>Time period for report (PERIOD)</h3>
<p>Specifies the members which are to be included in the graph which will specify the time period range of the graph. The members can be selected using the *SELECT value or by specifying a starting and ending date range.
</p>
<p>
<b>Note: </b>Members which have not had their historical data created are not included on the graph unless <b>CRTHSTDTA(*YES)</b> is specified.
</p>
<p>*N may be used in place of an element that precedes the value being specified in order to maintain positioning. For example:
</p>
<p>
<pre>
PERIOD(*N 091289)
</pre>
</p>
<p>This example specifies the ending date and uses the default starting date, which is specified by *N.
</p>
<p>Specify one of the following values to signify the starting date. Historical information collected before this date is not included in the graph.
</p>
<p>The possible <b>Starting Date</b> values are:
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>Historical information is included in the graph beginning on the date of the oldest historical information in the library.
</dd>
<dt><b>*SELECT</b></dt>
<dd>Shows a list of performance members and whether or not they have historical data. From this list you can select which members are included in the graph. This value is valid only in the interactive environment. If used, the remaining values on the <b>Time period for report</b> prompt (PERIOD parameter) are ignored (end-date).
</dd>
<dt><b><i>start-date</i></b></dt>
<dd>Specify the date after which data records are included. The date must be entered in the format specified by the system values, QDATFMT, and, if separators are used, QDATSEP. For example, the system might have a date format of <b>'mm/dd/yy'</b>. 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 screen, then apostrophes are not required.
</dd>
</dl>
<p>Specify one of the following values to signify the ending date. Historical information collected after this date is not included in the graph.
</p>
<p>The possible <b>Ending Date</b> values are:
</p>
<dl>
<dt><b><u>*LAST</u></b></dt>
<dd>Historical information is included in the graph ending on the date of the latest historical information in the library.
</dd>
<dt><b><i>end-date</i></b></dt>
<dd>Specify the date after which records are no longer included. This value is specified in the same format as <b>start-date</b>.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPHSTGPH.CRTHSTDTA"></a>
<h3>Create historical data (CRTHSTDTA)</h3>
<p>Specifies whether historical data is to be created for any performance data member that has not had historical data created.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Historical data is not created. All performance members that exist during the period of time selected, and do not have historical data representing them, are not included on the graph.
</dd>
<dt><b>*YES</b></dt>
<dd>Historical data is created.
<p>
<b>Note: </b>Creating historical data takes more time than most display jobs.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPHSTGPH.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="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPHSTGPH.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="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPHSTGPH.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="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPHSTGPH.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 on 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>DSPHSTGPH</u></b></dt>
<dd>The command name is used for the job name.
</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="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPHSTGPH.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="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPHSTGPH.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Displaying a Data File</b>
</p>
<p>
<pre>
DSPHSTGPH GRAPH(GRAPHLIB/CPU)
</pre>
</p>
<p>This command shows the historical data file in library QPFRDATA on the user's screen. It is shown using the graph format CPU in library GRAPHLIB. All of the historical information in library QPFRDATA is included in the graph.
</p>
<p><b>Example 2: Saving a Graph</b>
</p>
<p>
<pre>
DSPHSTGPH GRAPH(GRAPHLIB/CPU) OUTPUT(*OUTFILE)
OUTFILE(USERLIB/USERFILE) OUTMBR(TEST)
JOBD(*LIBL/QPFRJOBD)
</pre>
</p>
<p>This command submits a job to save the graph in a GDF file. The graph is saved in the file USERLIB/USERFILE/TEST.
</p>
<p><b>Example 3: Printing a Graph</b>
</p>
<p>
<pre>
DSPHSTGPH GRAPH(GRAPHLIB/CPU) OUTPUT(*PRINT)
PRTDEV(PRT03) JOBD(*LIBL/QPFRJOBD)
</pre>
</p>
<p>This command submits a job to print the graph on the system printer named PRT03.
</p>
<p><b>Example 4: Printing All Graphs in a Package</b>
</p>
<p>
<pre>
DSPHSTGPH GRAPH(GRAPHLIB/PACKAGE1) OUTPUT(*PRINT)
PRTDEV(PRT03) TYPE(*GPHPKG) JOBD(*LIBL/QPFRJOBD)
</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 the system printer named PRT03. It uses the historical data members in QPFRDATA for its information.
</p>
<p><b>Example 5: Displaying a Graph</b>
</p>
<p>
<pre>
DSPHSTGPH GRAPH(GRAPHLIB/CPU) OUTPUT(*)
PERIOD(112799 100900)
</pre>
</p>
<p>This command displays a graph of historical information from 27 NOV 1999 to 9 OCT 2000.
</p>
<p><b>Example 6: Selecting Members to be in a Graph</b>
</p>
<p>
<pre>
DSPHSTGPH GRAPH(GRAPHLIB/CPU) MBRLIB(MONDAY)
OUTPUT(*) PERIOD(*SELECT *N)
</pre>
</p>
<p>This command shows the historical members selection menu for the members in library MONDAY. The user then selects the members to be shown in the graph.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPHSTGPH.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>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>PFR9072</b></dt>
<dd>Cannot use member &amp;3 in historical graph.
</dd>
<dt><b>PFR9073</b></dt>
<dd>Cannot use member &amp;2 in historical graph.
</dd>
<dt><b>PFR9074</b></dt>
<dd>Too many members selected.
</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 &amp;1 not found.
</dd>
<dt><b>PFR9083</b></dt>
<dd>Graph format selected for historical graph not valid.
</dd>
<dt><b>PFR9088</b></dt>
<dd>Cannot display graph because of missing data.
</dd>
<dt><b>PFR9096</b></dt>
<dd>Historical Data File QAPGHSTD not found in Library &amp;1.
</dd>
<dt><b>PFR9097</b></dt>
<dd>Cannot copy graph format &amp;1 onto itself.
</dd>
<dt><b>PFR9098</b></dt>
<dd>Cannot copy graph package &amp;1 onto itself.
</dd>
<dt><b>PFR9099</b></dt>
<dd>Cannot copy functional area &amp;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 &amp;1 is not valid.
</dd>
<dt><b>PFR9114</b></dt>
<dd>No historical data to graph.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPHSTGPH.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue Copy Permalink