ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/dspgdf.htm

364 lines
10 KiB
HTML
Raw Normal View History

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 Graphics Data File (DSPGDF)</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="DSPGDF.Top_Of_Page"></a>
<h2>Display Graphics Data File (DSPGDF)</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="#DSPGDF.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DSPGDF.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DSPGDF.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DSPGDF"></a>
<p>The Display Graphics Data File (DSPGDF) command displays, prints, and plots a graphics data file defined by the Business Graphics Utility (BGU), by a system graphics application, or by an application on a different system that produces the graphics-data-file-orders which are compatible with the system.
</p>
<h3>Error messages for DSPGDF</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="#DSPGDF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPGDF.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="#DSPGDF.FILE"><b>FILE</b></a></td>
<td valign="top">File</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: 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="#DSPGDF.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, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#DSPGDF.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="#DSPGDF.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="#DSPGDF.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="#DSPGDF.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="#DSPGDF.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="#DSPGDF.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="#DSPGDF.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="#DSPGDF.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="#DSPGDF.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DSPGDF.FILE"></a>
<h3>File (FILE)</h3>
<p>Specifies the physical database file containing the graphics data to be displayed.
</p>
<p>The possible library values are:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to locate the database file.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job locates the database 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 database file is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPGDF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPGDF.MBR"></a>
<h3>Member (MBR)</h3>
<p>Specifies the database file member containing the data to be displayed.
</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>The name of the file member used to display the data.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPGDF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPGDF.OUTPUT"></a>
<h3>Output (OUTPUT)</h3>
<p>Specifies that the file 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 file is displayed at the graphics-capable work station.
</dd>
<dt><b>*PLOT</b></dt>
<dd>The file is plotted on one of the available plotters.
</dd>
<dt><b>*PRINT</b></dt>
<dd>The file is printed on one of the available printers.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPGDF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPGDF.DEVTYPE"></a>
<h3>Device type (DEVTYPE)</h3>
<p>Specifies the device type that prints or plots the file. 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 the file.
</dd>
<dt><b>7371</b></dt>
<dd>The 7371 plotter that plots the file.
</dd>
<dt><b>6180</b></dt>
<dd>The 6180 plotter that plots the file.
</dd>
<dt><b>6182</b></dt>
<dd>The 6182 plotter that plots the file.
</dd>
<dt><b>5224</b></dt>
<dd>The 5224 printer that prints the file.
</dd>
<dt><b>5225</b></dt>
<dd>The 5225 printer that prints the file.
</dd>
<dt><b>4214</b></dt>
<dd>The 4214 printer that prints the file.
</dd>
<dt><b>4234</b></dt>
<dd>The 4234 printer that prints the file.
</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 4234, 4028 3812, or 3816 printers.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPGDF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPGDF.PENRATE"></a>
<h3>Plotter pen rate (PENRATE)</h3>
<p>Specifies the speed of the pens on the plotter when the file is being plotted.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>100</u></b></dt>
<dd>The pens plot 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="#DSPGDF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPGDF.PENWTH"></a>
<h3>Plotter pen width (PENWTH)</h3>
<p>Specifies the width of the strokes of the pens when the file 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="#DSPGDF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPGDF.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 file is plotted on the first plotter located by the address specified.
</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="#DSPGDF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPGDF.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="#DSPGDF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPGDF.PPRSIZE"></a>
<h3>Plotter paper size (PPRSIZE)</h3>
<p>Specifies the size of the paper where you plot the file.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SMALL</u></b></dt>
<dd>The file is plotted on paper 210 by 297 millimeters (8.5 by 11 inches).
</dd>
<dt><b>*LARGE</b></dt>
<dd>The file is plotted on paper 297 by 420 millimeters (11 by 17 inches).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPGDF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPGDF.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="#DSPGDF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPGDF.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPGDF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPGDF.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="#DSPGDF.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>