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

570 lines
18 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>Display Chart (DSPCHT)</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="DSPCHT.Top_Of_Page"></a>
<h2>Display Chart (DSPCHT)</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="#DSPCHT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DSPCHT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DSPCHT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DSPCHT"></a>
<p>The Display Chart (DSPCHT) command displays a chart defined by the Business Graphics Utility (BGU). You can type this command to display a chart on a graphics-capable work station without starting BGU.
</p>
<h3>Error messages for DSPCHT</h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>BGU0670</b></dt>
<dd>BGU is already active.
</dd>
<dt><b>BGU9002</b></dt>
<dd>BGU session ended abnormally.
</dd>
<dt><b>BGU9003</b></dt>
<dd>Unrecoverable error detected during BGU operation.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCHT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPCHT.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="#DSPCHT.CHTFMT"><b>CHTFMT</b></a></td>
<td valign="top">Chart format</td>
<td valign="top">Single values: <b><u>*DFT</u></b><br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Chart format</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>, *CURLIB</td>
</tr><tr>
<td valign="top" rowspan="3"><a href="#DSPCHT.FILE"><b>FILE</b></a></td>
<td valign="top">File</td>
<td valign="top">Single values: <b><u>*DFT</u></b><br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top">Qualifier 1: File</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>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#DSPCHT.MBR"><b>MBR</b></a></td>
<td valign="top">Member</td>
<td valign="top"><i>Name</i>, <b><u>*FIRST</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPCHT.OUTPUT"><b>OUTPUT</b></a></td>
<td valign="top">Output</td>
<td valign="top"><b><u>*</u></b>, *PLOT, *PRINT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPCHT.RCDFMT"><b>RCDFMT</b></a></td>
<td valign="top">Record format</td>
<td valign="top"><i>Name</i>, <b><u>*FIRST</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPCHT.DTAFMT"><b>DTAFMT</b></a></td>
<td valign="top">Data format</td>
<td valign="top"><b><u>*FILEDFT</u></b>, *NONPAIR, *PAIR</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPCHT.FROMRCD"><b>FROMRCD</b></a></td>
<td valign="top">Starting record number</td>
<td valign="top">1-2147483647, <b><u>*FIRST</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPCHT.NBRRCDS"><b>NBRRCDS</b></a></td>
<td valign="top">Number of records</td>
<td valign="top">1-999, <b><u>100</u></b>, *END</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPCHT.CHTHDG"><b>CHTHDG</b></a></td>
<td valign="top">Chart heading</td>
<td valign="top"><i>Character value</i>, <b><u>*CHTFMT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPCHT.DEVTYPE"><b>DEVTYPE</b></a></td>
<td valign="top">Device type</td>
<td valign="top"><b><u>7372</u></b>, 7371, 5224, 5225, 4234, IPDS, 4214, 6180, 6182</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPCHT.PENRATE"><b>PENRATE</b></a></td>
<td valign="top">Plotter pen rate</td>
<td valign="top">1-100, <b><u>100</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPCHT.PENWTH"><b>PENWTH</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="#DSPCHT.PLTADR"><b>PLTADR</b></a></td>
<td valign="top">Plotter address</td>
<td valign="top">1-31, <b><u>*SEARCH</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPCHT.HRZPPR"><b>HRZPPR</b></a></td>
<td valign="top">Plotter paper horizontal</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPCHT.CHRSHAPE"><b>CHRSHAPE</b></a></td>
<td valign="top">Maintain character shape</td>
<td valign="top">*YES, <b><u>*NO</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPCHT.PPRSIZE"><b>PPRSIZE</b></a></td>
<td valign="top">Plotter paper size</td>
<td valign="top"><b><u>*SMALL</u></b>, *LARGE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPCHT.FORMFEED"><b>FORMFEED</b></a></td>
<td valign="top">Form feed</td>
<td valign="top"><b><u>*AUTOCUT</u></b>, *CUT</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#DSPCHT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DSPCHT.CHTFMT"></a>
<h3>Chart format (CHTFMT)</h3>
<p>Specifies the chart format to be used to chart the data found in the file and member specified by the FILE and MBR parameters.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*DFT</u></b></dt>
<dd>The default data to be used for your chart format.
</dd>
</dl>
<p>The possible library values are:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to locate the chart format.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the chart format. If no current library entry exists in the library list, QGPL is used.
</dd>
<dt><b>library-name</b></dt>
<dd>Specify the library where the chart format is located.
</dd>
<dt><b>format-name</b></dt>
<dd>Specify the qualified name of an existing chart format used to chart the data.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCHT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCHT.FILE"></a>
<h3>File (FILE)</h3>
<p>Specifies the database file (physical or logical) containing the data to be charted. The data is charted using the format specified in the CHTFMT parameter.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*DFT</u></b></dt>
<dd>The default data to be used for your chart.
</dd>
<dt><b>file-name</b></dt>
<dd>The qualified name of an existing database file containing the data to be charted.
</dd>
</dl>
<p>The possible library values are:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to locate the file.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the file. If no current library entry exists in the library list, QGPL is used.
</dd>
<dt><b>library-name</b></dt>
<dd>Specify the library where the file is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCHT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCHT.MBR"></a>
<h3>Member (MBR)</h3>
<p>Specifies the database file member containing the data to be charted. The data is charted using the format specified in the CHTFMT parameter.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>The first member in the database file specified in the FILE parameter is used.
</dd>
<dt><b>member-name</b></dt>
<dd>Specify the name of the file member used to chart the data.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCHT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCHT.OUTPUT"></a>
<h3>Output (OUTPUT)</h3>
<p>Specifies that the chart is either displayed (at a graphics-capable work station), plotted, or printed.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*</u></b></dt>
<dd>The output is displayed at the graphics-capable work station.
</dd>
<dt><b>*PLOT</b></dt>
<dd>The output is plotted on one of the available plotters.
</dd>
<dt><b>*PRINT</b></dt>
<dd>The output is printed on either the 5224/5225, 4214, 4234, or IPDS printers.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCHT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCHT.RCDFMT"></a>
<h3>Record format (RCDFMT)</h3>
<p>Specifies the record format used to describe the physical database file named in the FILE parameter.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>The first record format containing numeric fields in the file is used.
</dd>
<dt><b>record-format-name</b></dt>
<dd>The name of the record format to be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCHT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCHT.DTAFMT"></a>
<h3>Data format (DTAFMT)</h3>
<p>Specifies how the data fields are selected for charting.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*FILEDFT</u></b></dt>
<dd>The data fields are selected in the manner specified in the data file.
</dd>
<dt><b>*NONPAIR</b></dt>
<dd>The data fields are selected in a nonpaired manner. This means that the first numeric field represents the X value (independent variable) and all remaining numeric fields represent the Y values dependent on it.
</dd>
<dt><b>*PAIR</b></dt>
<dd>The data fields are selected in a paired manner. For example, the first numeric field represents the independent variable X1, and the second numeric field represents the variable Y1 dependent on X1. The third numeric field represents the independent variable X2, and the fourth numeric field represents the variable Y2 dependent on X2 and so on.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCHT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCHT.FROMRCD"></a>
<h3>Starting record number (FROMRCD)</h3>
<p>Specifies the record number in the file member where data charting begins. The total number of records is specified by the NBRRCDS parameter.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>Charting begins with the first record in the specified file member.
</dd>
<dt><b>record-number</b></dt>
<dd>The number of the record in the database file member from which charting begins.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCHT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCHT.NBRRCDS"></a>
<h3>Number of records (NBRRCDS)</h3>
<p>Specifies the number of records that are used as data for the chart. The number of records to be used begins at the record specified by the FROMRCD parameter.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>100</u></b></dt>
<dd>100 records are used to create your chart.
</dd>
<dt><b>*END</b></dt>
<dd>The records charted end at the last record of the file.
</dd>
<dt><b>number-of-records</b></dt>
<dd>The number of records used as data for the chart. Valid values are from 1 to 999.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCHT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCHT.CHTHDG"></a>
<h3>Chart heading (CHTHDG)</h3>
<p>Specifies a chart heading to override the existing chart heading while the chart is displayed, printed, or plotted.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*CHTFMT</u></b></dt>
<dd>The heading defined in the chart format is used when you plot, print or display the chart.
</dd>
<dt><b>chart-heading-text</b></dt>
<dd>A character string of up to 132 characters to override the existing chart heading. A semicolon (;) in the text string signifies to BGU to start a new line in the heading.
</dd>
</dl>
<p>
<b>Note: </b>This parameter overrides the chart heading only. To change the chart heading permanently, you must select option 3 (Chart change format) from the Business Graphics Utility (BGU) menu.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCHT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCHT.DEVTYPE"></a>
<h3>Device type (DEVTYPE)</h3>
<p>Specifies the device type to be used for the printing or plotting of your chart. This parameter is relevant only if OUTPUT(*PLOT) or OUTPUT(*PRINT) is specified.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>7372</u></b></dt>
<dd>The 7372 plotter that plots your chart.
</dd>
<dt><b>7371</b></dt>
<dd>The 7371 plotter that plots your chart.
</dd>
<dt><b>6180</b></dt>
<dd>The 6180 plotter that plots your chart.
</dd>
<dt><b>6182</b></dt>
<dd>The 6182 plotter that plots your chart.
</dd>
<dt><b>5224</b></dt>
<dd>The 5224 printer that prints your chart.
</dd>
<dt><b>5225</b></dt>
<dd>The 5225 printer that prints your chart.
</dd>
<dt><b>4214</b></dt>
<dd>The 4214 printer that prints your chart.
</dd>
<dt><b>4234</b></dt>
<dd>The 4234 printer that prints your chart.
</dd>
<dt><b>IPDS</b></dt>
<dd>Any graphics-capable Intelligent Printer Data Stream (IPDS) printer installed at your location. Specify this parameter when using either the 4224, 4028 3812, or 3816 printers.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCHT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCHT.PENRATE"></a>
<h3>Plotter pen rate (PENRATE)</h3>
<p>Specifies the speed of the pens on the plotter when your chart is being plotted.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>100</u></b></dt>
<dd>The pens plot your chart at 100% speed.
</dd>
<dt><b>pen-rate</b></dt>
<dd>The speed, specified as a percentage, of the pens on the plotter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCHT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCHT.PENWTH"></a>
<h3>Plotter pen width (PENWTH)</h3>
<p>Specifies the width of the strokes of the pens when your chart is plotted.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>3</u></b></dt>
<dd>The stroke of the pens is 0.3 millimeters.
</dd>
<dt><b>pen-width</b></dt>
<dd>A number that specifies the stroke of the pens (between 0.1 and 1.0 millimeters).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCHT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCHT.PLTADR"></a>
<h3>Plotter address (PLTADR)</h3>
<p>Specifies the plotter address where the plotter is located.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SEARCH</u></b></dt>
<dd>The chart is at the first address for plotting.
</dd>
<dt><b>plotter-address</b></dt>
<dd>A number, between 1 and 31, that specifies the plotter location.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCHT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCHT.HRZPPR"></a>
<h3>Plotter paper horizontal (HRZPPR)</h3>
<p>Specifies the position of the paper in the plotter.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>The long side of the paper is horizontal.
</dd>
<dt><b>*NO</b></dt>
<dd>The short side of the paper is horizontal.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCHT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCHT.CHRSHAPE"></a>
<h3>Maintain character shape (CHRSHAPE)</h3>
<p>Specifies the shape of the characters on a chart that is plotted vertically.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Character shape is not maintained as it would appear on a chart plotted horizontally.
</dd>
<dt><b>*YES</b></dt>
<dd>Character shape is maintained as it would appear on a chart plotted horizontally.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCHT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCHT.PPRSIZE"></a>
<h3>Plotter paper size (PPRSIZE)</h3>
<p>Specifies the size of the paper on which you plot your chart.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SMALL</u></b></dt>
<dd>Your chart is plotted on paper 8.5 by 11 inches (210 by 297 millimeters).
</dd>
<dt><b>*LARGE</b></dt>
<dd>Your chart is plotted on paper 11 by 17 inches (297 by 420 millimeters).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCHT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCHT.FORMFEED"></a>
<h3>Form feed (FORMFEED)</h3>
<p>Specifies that the plotter automatically loads the paper.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*AUTOCUT</u></b></dt>
<dd>The plotter automatically loads the paper.
</dd>
<dt><b>*CUT</b></dt>
<dd>You must manually load the paper before plotting.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCHT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPCHT.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCHT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPCHT.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>BGU0670</b></dt>
<dd>BGU is already active.
</dd>
<dt><b>BGU9002</b></dt>
<dd>BGU session ended abnormally.
</dd>
<dt><b>BGU9003</b></dt>
<dd>Unrecoverable error detected during BGU operation.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCHT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink