808 lines
34 KiB
HTML
808 lines
34 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>Start Printer Emulation (STRPRTEML)</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="STRPRTEML.Top_Of_Page"></a>
|
|
<h2>Start Printer Emulation (STRPRTEML)</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="#STRPRTEML.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#STRPRTEML.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#STRPRTEML.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="STRPRTEML"></a>
|
|
<p>The Start Printer Emulation (STRPRTEML) command starts 3270 printer emulation using a binary synchronous communications (BSC) or Systems Network Architecture (SNA) emulation printer device and a printer device file. The STRPRTEML command is used to print host system (System/370 type) information on an iSeries system. It is used when the user is working on an iSeries system and the information is on a System/370 type system.
|
|
</p>
|
|
<p>More information is in the 3270 Device Emulation Support book, SC41-5408.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="STRPRTEML.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRPRTEML.EMLCTL"><b>EMLCTL</b></a></td>
|
|
<td valign="top">Emulation controller, or</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRPRTEML.EMLDEV"><b>EMLDEV</b></a></td>
|
|
<td valign="top">Emulation device, or</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRPRTEML.EMLLOC"><b>EMLLOC</b></a></td>
|
|
<td valign="top">Emulation location</td>
|
|
<td valign="top"><i>Communications name</i></td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRPRTEML.PRTDEV"><b>PRTDEV</b></a></td>
|
|
<td valign="top">Print device</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRPRTEML.JOB"><b>JOB</b></a></td>
|
|
<td valign="top">Job name</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*EMLDEV</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRPRTEML.ENDBKTEJT"><b>ENDBKTEJT</b></a></td>
|
|
<td valign="top">End Bracket eject</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#STRPRTEML.PRTFILE"><b>PRTFILE</b></a></td>
|
|
<td valign="top">Printer 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: Printer file</td>
|
|
<td valign="top"><i>Name</i>, <b><u>QPEMPRTF</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="3"><a href="#STRPRTEML.TIMOUTEJT"><b>TIMOUTEJT</b></a></td>
|
|
<td valign="top">Timeout wait eject</td>
|
|
<td valign="top">Single values: <b><u>*NONE</u></b>, *IMMED<br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Minutes</td>
|
|
<td valign="top">
|
|
0-99</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Seconds</td>
|
|
<td valign="top">
|
|
0-59, <b><u>0</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRPRTEML.DFRPRTOUT"><b>DFRPRTOUT</b></a></td>
|
|
<td valign="top">Defer printing spool output</td>
|
|
<td valign="top"><b><u>*PRTFILE</u></b>, *YES, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRPRTEML.SPOOL"><b>SPOOL</b></a></td>
|
|
<td valign="top">Spool output</td>
|
|
<td valign="top"><b><u>*PRTFILE</u></b>, *YES, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRPRTEML.OPNPRTF"><b>OPNPRTF</b></a></td>
|
|
<td valign="top">Open printer file</td>
|
|
<td valign="top"><b><u>*IMMED</u></b>, *RCVDTA</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRPRTEML.NUMCOL"><b>NUMCOL</b></a></td>
|
|
<td valign="top">Print positions per line</td>
|
|
<td valign="top">1-378, <b><u>*PRTFILE</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRPRTEML.NUMLIN"><b>NUMLIN</b></a></td>
|
|
<td valign="top">Lines per page</td>
|
|
<td valign="top">1-255, <b><u>*PRTFILE</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRPRTEML.LPI"><b>LPI</b></a></td>
|
|
<td valign="top">Lines per inch</td>
|
|
<td valign="top"><b><u>*PRTFILE</u></b>, 6, 3, 4, 7.5, 7,5, 8, 9</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#STRPRTEML.MSGQ"><b>MSGQ</b></a></td>
|
|
<td valign="top">Message queue</td>
|
|
<td valign="top">Single values: <b><u>*DSPDEV</u></b>, *NONE<br>Other values: <i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Message 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>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#STRPRTEML.CHRSET"><b>CHRSET</b></a></td>
|
|
<td valign="top">Language character set</td>
|
|
<td valign="top"><b><u>*SYSVAL</u></b>, AGB, AGE, AGI, AGM, ALI, ALM, BGB, BGE, BLI, BLM, BRB, BRE, CAB, CAE, CAI, CAM, CLB, CLE, CYB, CSB, CSE, DMB, DMI, DME, DMM, ESB, FAB, FAI, FAE, FAM, FNB, FNI, FQB, FQI, FNE, FNM, ICE, GKB, GNB, GNE, HIB, HNB, HNE, ICB, ICI, ICM, INB, INI, IRB, ITB, ITE, ITI, ITM, JEB, JEI, JKB, JPB, JPE, JUB, KAB, KOB, LTB, LAE, LVB, MKB, MKE, NCB, NCE, NEB, NEI, NEE, NEM, NWB, NWE, NWI, NWM, PKE, PLB, PLE, PRB, PRI, PRE, PRM, RCB, RMB, RME, ROB, ROE, RUB, RUE, SFI, SFM, SGM, SGI, SKB, SKE, SPB, SPE, SPI, SPM, SQB, SQE, SSB, SSI, SWB, SWI, SSE, SSM, SWE, SWM, TAB, THB, THE, TKB, TKE, TRB, TRE, UAE, UKB, UKI, USB, USI, UKE, UKM, USE, USM, VNE, YGI, YGM, *TRNTBL</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRPRTEML.SBMJOB"><b>SBMJOB</b></a></td>
|
|
<td valign="top">Submit job</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#STRPRTEML.JOBD"><b>JOBD</b></a></td>
|
|
<td valign="top">Job description</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Job description</td>
|
|
<td valign="top"><i>Name</i>, <b><u>QBATCH</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="3"><a href="#STRPRTEML.TRNTBLOUT"><b>TRNTBLOUT</b></a></td>
|
|
<td valign="top">Outgoing translation table</td>
|
|
<td valign="top">Single values: <b><u>*CHRSET</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: Outgoing translation table</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="#STRPRTEML.JOBQ"><b>JOBQ</b></a></td>
|
|
<td valign="top">Job queue</td>
|
|
<td valign="top">Single values: <b><u>*JOBD</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 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>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#STRPRTEML.ENDCOND"><b>ENDCOND</b></a></td>
|
|
<td valign="top">End emulation conditions</td>
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 3 repetitions): *DACTLU, *ENDBKT, *UNBIND</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRPRTEML.FORMFEED"><b>FORMFEED</b></a></td>
|
|
<td valign="top">Acknowledge form feed</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRPRTEML.EMLCFGE"><b>EMLCFGE</b></a></td>
|
|
<td valign="top">Configuration entry</td>
|
|
<td valign="top"><i>Name</i>, QEMDFTCFGE, <b><u>*NONE</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="STRPRTEML.EMLCTL"></a>
|
|
<h3>Emulation controller (EMLCTL)</h3>
|
|
<p>Specifies the name of a BSC controller description or SNA controller description that has attached 3270 printer emulation device descriptions. When this parameter is specified, the printer emulation job uses a 3270 printer emulation device attached to this controller description. The requester must be authorized to the controller and at least one device, and the device must be available.
|
|
</p>
|
|
<p>Either this parameter, the <b>Emulation device (EMLDEV)</b> parameter, or the <b>Emulation location (EMLLOC)</b> parameter is required.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPRTEML.EMLDEV"></a>
|
|
<h3>Emulation device (EMLDEV)</h3>
|
|
<p>Specifies the name of a BSC or an SNA printer emulation device (EMLDEV(3284, 3286, 3287, 3288, or 3289)) that is used by the printer emulation job to do a type 3270 printer emulation. The user must be authorized to the device, and the device must be available.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPRTEML.EMLLOC"></a>
|
|
<h3>Emulation location (EMLLOC)</h3>
|
|
<p>Specifies the emulation remote location name that describes the location of the 3270 printer emulation devices. This name is defined during device description configuration and refers to the remote location where communication takes place. When this parameter is specified, an available printer emulation device is selected from those referred to by the location. At least one printer emulation device referred to by the location must be available, and the job running emulation must be authorized to use the device.
|
|
</p>
|
|
<p>Either this parameter, the <b>Emulation controller (EMLCTL)</b> parameter, or the <b>Emulation device (EMLDEV)</b> parameter is required.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPRTEML.PRTDEV"></a>
|
|
<h3>Print device (PRTDEV)</h3>
|
|
<p>Specifies the name of the printer used with this printer device file to print the output. This parameter is ignored if the printer data is spooled. If the output is not spooled and the printer device is being used at the time the job is initiated, the emulation session ends.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If a printer name is not specified, the output is sent to the printer device specified on the <b>Device (DEV)</b> parameter of the Create Printer File (CRTPRTF) command. This printer device can be displayed by using the Display File Description (DSPFD) command.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPRTEML.JOB"></a>
|
|
<h3>Job name (JOB)</h3>
|
|
<p>Specifies a job name for the printer emulation job. If the EMLDEV parameter is not specified, and a batch job is to be submitted (*YES is specified for the <b>Submit job (SBMJOB)</b> parameter), a job name must be specified. This parameter is ignored when *NO is specified for the SBMJOB parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*EMLDEV</u></b></dt>
|
|
<dd>The job name is the same as the printer emulation device name.
|
|
</dd>
|
|
<dt><b><i>job-name</i></b></dt>
|
|
<dd>Specify a name for this printer emulation job.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPRTEML.ENDBKTEJT"></a>
|
|
<h3>End Bracket eject (ENDBKTEJT)</h3>
|
|
<p>Specifies whether SNA printer emulation should force out the emulation output when an SNA End Bracket (EB) is received from the host system. Emulation output is forced out by closing and then reopening the emulation printer file specified in the PRTFILE parameter. When the emulation printer output is ejected, a page eject is performed. The parameter uses the default value of *NO for BSC printer emulation.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>The emulation output is not forced out when SNA printer emulation receives an End Bracket.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The emulation output is forced out when SNA printer emulation receives an End Bracket. This is done only if the open printer file contains host system data.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPRTEML.PRTFILE"></a>
|
|
<h3>Printer file (PRTFILE)</h3>
|
|
<p>Specifies the printer device file that prints data received from the host system. The printer device file can be spooled or not spooled.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QPEMPRTF</u></b></dt>
|
|
<dd>The standard printer file (which specifies SPOOL(*YES)) shipped with the emulation program is used as the printer device file.
|
|
</dd>
|
|
<dt><b><i>printer-device-file-name</i></b></dt>
|
|
<dd>Specify the name and library of a user-defined printer device file.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible library values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the printer device file. 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 library where the printer device file is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPRTEML.TIMOUTEJT"></a>
|
|
<h3>Timeout wait eject (TIMOUTEJT)</h3>
|
|
<p>Specifies whether printer emulation forces out the emulation output when a time-out has occurred while waiting for host system data. The emulation output is forced out only if the open printer file contains host system data. The wait interval can be specified in number of minutes or seconds. If a value is specified for both minutes and seconds, then these values will be added together.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>When the emulation printer output is ejected, a page eject is also performed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>The emulation output is not forced out based on a specified timeout period.
|
|
</dd>
|
|
<dt><b>*IMMED</b></dt>
|
|
<dd>The emulation output is forced out immediately.
|
|
</dd>
|
|
<dt><b><i>minutes-seconds</i></b></dt>
|
|
<dd>Specify a time-out wait interval in minutes or seconds or both.
|
|
<dl>
|
|
<dt><b>Minutes</b></dt>
|
|
<dd>Valid values range from 0 through 99.
|
|
</dd>
|
|
<dt><b>Seconds</b></dt>
|
|
<dd>Valid values range from 0 through 59.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPRTEML.DFRPRTOUT"></a>
|
|
<h3>Defer printing spool output (DFRPRTOUT)</h3>
|
|
<p>Specifies whether spooled output is printed immediately or is delayed. This parameter is ignored when *NO is specified for the Spool output (SPOOL) parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PRTFILE</u></b></dt>
|
|
<dd>The SCHEDULE value for the printer file controls how the spooled output is printed.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Spooled output is printed when the spooled file is closed.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Spooled output can be printed before the spooled file is closed. The printed output does not contain all the data sent by the host system until the spooled file is closed. If the printer is not using spooling, this parameter is ignored.
|
|
<p>
|
|
<b>Note: </b>Once the printer starts printing output from 3270 device emulation, spooled output from other jobs sharing the printer does not print until the spooled file that is currently printing is complete.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPRTEML.SPOOL"></a>
|
|
<h3>Spool output (SPOOL)</h3>
|
|
<p>Specifies whether the output data for the printer device file is spooled. If *NO is specified on this parameter, output is sent to the printer specified on the <b>Print device (PRTDEV)</b> parameter. If the output is spooled, it is sent to the output queue specified on the <b>Spooled output queue (OUTQ)</b> parameter of the Create Printer File (CRTPRTF) command for the printer file specified on the PRTFILE parameter. The Output Queue value can be displayed by using the Display File Description (DSPFD) command and specifying the printer file name.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If *JOB is specified on the OUTQ parameter, output is sent to the output queue specified on the OUTQ parameter of the job description specified on the JOBD parameter. This value can be displayed by using the Display Job Description (DSPJOBD) command and specifying the job description name.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PRTFILE</u></b></dt>
|
|
<dd>The value specified on the <b>Spool output (SPOOL)</b> parameter of the Create Printer File (CRTPRTF) command determines whether spooling is performed.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The data is spooled.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>The data is not spooled; it is sent directly to the device and is printed as the output becomes available.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPRTEML.OPNPRTF"></a>
|
|
<h3>Open printer file (OPNPRTF)</h3>
|
|
<p>Specifies when the printer file is opened during the SNA 3270 printer emulation session. If the printer data is not spooled, then the printer will be allocated to your job when the printer file is opened. If the printer data is spooled, then the spool writer is allocated to your job after the printer file is opened depending on the value of the DFRPRTOUT parameter.
|
|
</p>
|
|
<p>This parameter is not allowed if specified for BSC 3270 printer emulation.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*IMMED</u></b></dt>
|
|
<dd>The printer file is opened immediately after starting the 3270 printer emulation session.
|
|
</dd>
|
|
<dt><b>*RCVDTA</b></dt>
|
|
<dd>The printer file is opened after first receiving print data from the host system.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPRTEML.NUMCOL"></a>
|
|
<h3>Print positions per line (NUMCOL)</h3>
|
|
<p>Specifies the number of columns in a line when creating the printed output.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PRTFILE</u></b></dt>
|
|
<dd>The printer file PAGESIZE(width) value contains the number of columns per line. This value is used if *IMMED is specified on the open printer file (OPNPRTF) parameter, or *RCVDTA is specified on the OPNPRTF parameter and the maximum print positions (MPP) value is not sent from the host system. Otherwise, the MPP value sent from the host system is used.
|
|
</dd>
|
|
<dt><b><i>number-of-columns</i></b></dt>
|
|
<dd>Specify the number of columns per line in the printed output. Valid values range from 1 through 378.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPRTEML.NUMLIN"></a>
|
|
<h3>Lines per page (NUMLIN)</h3>
|
|
<p>Specifies the number of lines per page when creating the printed output.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PRTFILE</u></b></dt>
|
|
<dd>The printer file PAGESIZE(length) value contains the number of lines per page. This value is used if *IMMED is specified on the open printer file (OPNPRTF) parameter, or *RCVDTA is specified on the OPNPRTF parameter and the maximum page length (MPL) value is not sent from the host system. Otherwise, the MPL value sent from the host system is used.
|
|
</dd>
|
|
<dt><b><i>number-of-lines</i></b></dt>
|
|
<dd>Specify the number of lines per page in printed output. Valid values range from 1 through 255.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPRTEML.LPI"></a>
|
|
<h3>Lines per inch (LPI)</h3>
|
|
<p>Specifies the number of lines per inch when creating the printed output.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PRTFILE</u></b></dt>
|
|
<dd>The printer file LPI value contains the number of lines per inch. This value is used if *IMMED is specified on the open printer file (OPNPRTF) parameter, or *RCVDTA is specified on the OPNPRTF parameter and the set line density (SDL) value is not sent from the host system. Otherwise, the SDL value sent from the host system is used.
|
|
</dd>
|
|
<dt><b><i>lines-per-inch</i></b></dt>
|
|
<dd>Specify the number of lines per inch in the printed output. Valid values are 3, 4, 6, 7.5, 7,5, 8 and 9. Values 3, 7.5 and 7,5 are valid only for double-byte character set (DBCS) printer devices.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPRTEML.MSGQ"></a>
|
|
<h3>Message queue (MSGQ)</h3>
|
|
<p>Specifies the message queue to which operational messages for this device are sent.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DSPDEV</u></b></dt>
|
|
<dd>The current display station message queue is used.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No messages are sent to message queues other than the job log for the printer emulation job.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible library values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the message queue. 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 library where the message queue is located.
|
|
</dd>
|
|
<dt><b><i>message-queue-name</i></b></dt>
|
|
<dd>Specify the name and library of the message queue where messages are sent when the printer emulation job is running.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPRTEML.CHRSET"></a>
|
|
<h3>Language character set (CHRSET)</h3>
|
|
<p>Specifies the 3-character country or region keyboard language identifier which represents a specific full character identifier (CHRID - comprised of a character set and code page) that is used by the printer being emulated.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SYSVAL</u></b></dt>
|
|
<dd>The current QKBDTYPE system value is used.
|
|
</dd>
|
|
<dt><b><i>country-keyboard-identifier</i></b></dt>
|
|
<dd>Specify the country or region keyboard language identifier to be used.
|
|
</dd>
|
|
<dt><b>*TRNTBL</b></dt>
|
|
<dd>Allows a user-defined translation table to be used. The character translation is defined in the translation table specified by the <b>Outgoing translation table (TRNTBLOUT)</b> parameter. The CHRID associated with the QKBDTYPE system value will be used by the printer being emulated.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPRTEML.SBMJOB"></a>
|
|
<h3>Submit job (SBMJOB)</h3>
|
|
<p>Specifies whether the printer emulation should be done as a separate job or as part of this job.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>A specific job is submitted to do the printer emulation. The job attributes are determined from the job description specified by the <b>Job description (JOBD)</b> parameter. The job uses your user profile.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Printer emulation is done in the current job.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPRTEML.JOBD"></a>
|
|
<h3>Job description (JOBD)</h3>
|
|
<p>Specifies the job description for the job that is being submitted for 3270 printer emulation. This parameter is ignored when *NO is specified for the <b>Submit job (SBMJOB)</b> parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QBATCH</u></b></dt>
|
|
<dd>The job description QBATCH is used for the job.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible library values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the job description name. 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 library where the job description name is located.
|
|
</dd>
|
|
<dt><b><i>job-description-name</i></b></dt>
|
|
<dd>Specify the name and library of the job description associated with the job.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPRTEML.TRNTBLOUT"></a>
|
|
<h3>Outgoing translation table (TRNTBLOUT)</h3>
|
|
<p>Specifies the outgoing translation table used to translate characters sent from the host system to 3270 Emulation.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CHRSET</u></b></dt>
|
|
<dd>Specify that translation is done when data is sent from the host system using the character set specified on the <b>Language character set (CHRSET)</b> parameter.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible library values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the translation table. If no current library entry exists in the library list, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the library where the translation table is located.
|
|
</dd>
|
|
<dt><b><i>table-name</i></b></dt>
|
|
<dd>Specifies the name and library of the table which is used for outgoing translation.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPRTEML.JOBQ"></a>
|
|
<h3>Job queue (JOBQ)</h3>
|
|
<p>Specifies the name of the job queue in which this 3270 printer emulation job is placed. This parameter is ignored when *NO is specified for the <b>Submit job (SBMJOB)</b> parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*JOBD</u></b></dt>
|
|
<dd>The submitted job is placed in the job queue associated with the job description specified in the (JOBD) parameter.
|
|
</dd>
|
|
<dt><b><i>job-queue-name</i></b></dt>
|
|
<dd>Specify the name and library of the job queue to contain the submitted job.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible library values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the job queue. 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 library where the job queue is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPRTEML.ENDCOND"></a>
|
|
<h3>End emulation conditions (ENDCOND)</h3>
|
|
<p>Specifies additional ways in which the SNA 3270 printer emulation session can end.
|
|
</p>
|
|
<p>This parameter is not allowed if specified for BSC 3270 printer emulation.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No additional ways to end 3270 printer emulation are requested.
|
|
</dd>
|
|
<dt><b>*DACTLU</b></dt>
|
|
<dd>The 3270 printer emulation session ends if it receives an SNA DACTLU from the host system.
|
|
</dd>
|
|
<dt><b>*ENDBKT</b></dt>
|
|
<dd>The 3270 printer emulation session ends if it receives an SNA end bracket from the host system. Please consider the following before selecting this end condition:
|
|
<ul>
|
|
<li>This end condition should be used only when you need to print one host system file for the duration of the session. An end bracket may occur after printing the first file, and the 3270 session ends before a second file can print.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
<dt><b>*UNBIND</b></dt>
|
|
<dd>The 3270 printer emulation session will end if it receives an SNA UNBIND from the host system. Please consider the following before selecting this end condition:
|
|
<ul>
|
|
<li>This end condition should be used only when you need to print one host system file for the duration of the session. An UNBIND may occur after printing the first file, and the 3270 session will end before a second file can print.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPRTEML.FORMFEED"></a>
|
|
<h3>Acknowledge form feed (FORMFEED)</h3>
|
|
<p>Specifies whether to acknowledge a form-feed instruction located in the first character position of the first print line for a 3270 Information Display System data-stream compatibility (DSC) LU3 printer.
|
|
</p>
|
|
<p>This parameter is ignored for an SNA character string (SCS) LU1 printer.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>The form-feed instruction is acknowledged. The print position advances to a new page.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>The form-feed instruction is ignored. The print position does not advance to a new page.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPRTEML.EMLCFGE"></a>
|
|
<h3>Configuration entry (EMLCFGE)</h3>
|
|
<p>Specifies whether a configuration entry is used for this session. Configuration entries indicate 3270 emulation configuration options. Configuration entries are created with the Add Emulation Configuration Entry (ADDEMLCFGE) command.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No configuration entry is named and the configuration entry defaults are used.
|
|
</dd>
|
|
<dt><b>QEMDFTCFGE</b></dt>
|
|
<dd>The default configuration entry QEMDFTFGE is used. This entry is shipped with configuration entry defaults, and can be updated with the Change Emulation Configuration Entry (CHGEMLCFGE) command.
|
|
</dd>
|
|
<dt><b><i>configuration-entry-name</i></b></dt>
|
|
<dd>Specify the name of the configuration entry to be used. If the configuration entry named does not exist in the configuration file, the configuration entry defaults are used.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRPRTEML.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Printing Data to Standard Emulation Printer File</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRPRTEML EMLDEV(HOSTPRT4)
|
|
</pre>
|
|
</p>
|
|
<p>This command starts a batch job by accepting data from the HOSTPRT4 device and prints the data to the standard emulation printer file (QPEMPRTF). The job is named HOSTPRT4 and runs until the job is canceled. Messages are sent to the current work station message queue.
|
|
</p>
|
|
<p><b>Example 2: Emulating a Printer in the Current Job</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRPRTEML EMLDEV(HOSTPRT5) SBMJOB(*NO)
|
|
</pre>
|
|
</p>
|
|
<p>This command does printer emulation in the current job by accepting data from the HOSTPRT5 device, and writing the data to the standard emulation printer device file (QPEMPRTF). The request is active until it ends through the End Printer Emulation (ENDPRTEML) command, or until the job is canceled.
|
|
</p>
|
|
<p><b>Example 3: Printing Output Immediately</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRPRTEML EMLCTL(EMLCTL1) TIMOUTEJT(10)
|
|
DFRPRTOUT(*NO) NUMLIN(96)
|
|
</pre>
|
|
</p>
|
|
<p>This command starts a batch job by accepting data from the device and printing the data in printer file QPEMPRTF. If a timeout of 10 minutes occurs, printer emulation forces out the emulation output. The output prints immediately; the maximum number of lines per page is 96.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRPRTEML.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF85EB</b></dt>
|
|
<dd>3270 device emulation session ended.
|
|
</dd>
|
|
<dt><b>CPF85ED</b></dt>
|
|
<dd>Values other than ENDCOND(*NONE) are not supported.
|
|
</dd>
|
|
<dt><b>CPF85EE</b></dt>
|
|
<dd>*RCVDTA on the OPNPRTF parameter is not supported.
|
|
</dd>
|
|
<dt><b>CPF8510</b></dt>
|
|
<dd>Internal error occurred on device &1.
|
|
</dd>
|
|
<dt><b>CPF8511</b></dt>
|
|
<dd>Emulation ended by errors on device &2.
|
|
</dd>
|
|
<dt><b>CPF8512</b></dt>
|
|
<dd>Emulation ended because device &2 was held.
|
|
</dd>
|
|
<dt><b>CPF8513</b></dt>
|
|
<dd>Emulation ended by errors on device &2.
|
|
</dd>
|
|
<dt><b>CPF8514</b></dt>
|
|
<dd>Error recovery stopped on device &1.
|
|
</dd>
|
|
<dt><b>CPF8515</b></dt>
|
|
<dd>3270 emulation session ended by host.
|
|
</dd>
|
|
<dt><b>CPF8516</b></dt>
|
|
<dd>No match between host and device &2.
|
|
</dd>
|
|
<dt><b>CPF8517</b></dt>
|
|
<dd>Received more than maximum number of fields allowed.
|
|
</dd>
|
|
<dt><b>CPF8518</b></dt>
|
|
<dd>Emulation ended because of internal failure in system.
|
|
</dd>
|
|
<dt><b>CPF8519</b></dt>
|
|
<dd>Function check in 3270 emulation.
|
|
</dd>
|
|
<dt><b>CPF8561</b></dt>
|
|
<dd>Printer emulation not started.
|
|
</dd>
|
|
<dt><b>CPF8564</b></dt>
|
|
<dd>Printer emulation job &3/&2/&1 ended.
|
|
</dd>
|
|
<dt><b>CPF8570</b></dt>
|
|
<dd>Translate of 3270 printer data stream failed.
|
|
</dd>
|
|
<dt><b>CPF8579</b></dt>
|
|
<dd>Cannot open printer file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF8580</b></dt>
|
|
<dd>File &1 is not a printer file or has been overridden.
|
|
</dd>
|
|
<dt><b>CPF8582</b></dt>
|
|
<dd>Cannot open printer file &1 again in library &2.
|
|
</dd>
|
|
<dt><b>CPF8583</b></dt>
|
|
<dd>Printer emulation cannot open required file.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPRTEML.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|