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

149 lines
6.4 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>Emulate Printer Keys (EMLPRTKEY)</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="EMLPRTKEY.Top_Of_Page"></a>
<h2>Emulate Printer Keys (EMLPRTKEY)</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="#EMLPRTKEY.PARAMETERS.TABLE">Parameters</a><br>
<a href="#EMLPRTKEY.COMMAND.EXAMPLES">Examples</a><br>
<a href="#EMLPRTKEY.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="EMLPRTKEY"></a>
<p>The Emulate Printer Key (EMLPRTKEY) command causes the printer emulation job or session that is using the specified printer emulation device to send either a PA1 or PA2 key signal to the host system.
</p>
<p>PA keys are program access keys that are used to signal the host system. The host system program determines how these keys work. This command can only be used on 3287 or 3289 emulated printers operating as an LU type 1 session. In addition, the PA key signal, although sent to the host system, may not immediately be received.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#EMLPRTKEY.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="EMLPRTKEY.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="#EMLPRTKEY.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 1</td>
</tr>
<tr>
<td valign="top"><a href="#EMLPRTKEY.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 2</td>
</tr>
<tr>
<td valign="top"><a href="#EMLPRTKEY.PRTDEV"><b>PRTDEV</b></a></td>
<td valign="top">Print device</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#EMLPRTKEY.PRTKEY"><b>PRTKEY</b></a></td>
<td valign="top">Emulated printer key</td>
<td valign="top"><b><u>*PA1</u></b>, *PA2</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#EMLPRTKEY.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="EMLPRTKEY.EMLDEV"></a>
<h3>Emulation device (EMLDEV)</h3>
<p>Specifies the name of a printer emulation device that receives data from the host system. This device must be a 3287 Printer (EMLDEV(3287)) or a 3289 Printer (EMLDEV(3289)), and must currently be operating as an LU1 unit. The printer emulation job or session that is using this device will be informed of the request. If the LU1 session is between brackets, printer emulation starts a bracket and sends the PA key signal to the host system with a Change Direction (CD) request. If the LU session is in receive condition, a signal (request for CD) is sent to the host system, and printer emulation waits for the CD. When the CD is received, the PA key signal is sent to the host system with the CD. If the LU session is in send condition, the PA key signal is sent to the host system with the CD.
</p>
<p>Either this parameter, or the <b>Emulation location (EMLLOC)</b> parameter and the <b>Print device (PRTDEV)</b> parameter is required.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#EMLPRTKEY.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="EMLPRTKEY.EMLLOC"></a>
<h3>Emulation location (EMLLOC)</h3>
<p>Specifies the remote location name associated with this session. The location name is defined during device description configuration and refers to the remote location where communication takes place. This value must be the same as the value specified for the Emulation location (EMLLOC) parameter on the Start Printer Emulation (STRPRTEML) command.
</p>
<p>Either this parameter and the <b>Print device (PRTDEV)</b> parameter, or the <b>Emulation device (EMLDEV)</b> parameter is required.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#EMLPRTKEY.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="EMLPRTKEY.PRTDEV"></a>
<h3>Print device (PRTDEV)</h3>
<p>Specifies the name of a printer device that is used to print the spooled output. This value must be the same as the value specified for the Printer device (PRTDEV) parameter on the Start Printer Emulation (STRPRTEML) command. This parameter must be specified when the EMLLOC parameter is specified.
</p>
<p>Either this parameter and the <b>Emulation location (EMLLOC)</b> parameter, or the <b>Emulation device (EMLDEV)</b> parameter is required.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#EMLPRTKEY.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="EMLPRTKEY.PRTKEY"></a>
<h3>Emulated printer key (PRTKEY)</h3>
<p>Specifies the PA key signal that is sent to the host system. The host system program determines how these keys work.
</p>
<dl>
<dt><b><u>*PA1</u></b></dt>
<dd>The PA1 key signal is sent to the host system.
</dd>
<dt><b>*PA2</b></dt>
<dd>The PA2 key signal is sent to the host system.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#EMLPRTKEY.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="EMLPRTKEY.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
EMLPRTKEY EMLDEV(HOSTPRT2) PRTKEY(*PA2)
</pre>
</p>
<p>This command causes the printer emulation session using emulation device HOSTPRT2 to send the PA2 key signal to the host system.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#EMLPRTKEY.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="EMLPRTKEY.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF8598</b></dt>
<dd>Emulate print key function not performed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#EMLPRTKEY.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>