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

492 lines
17 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>Add Configuration Entry (ADDEMLCFGE)</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="ADDEMLCFGE.Top_Of_Page"></a>
<h2>Add Configuration Entry (ADDEMLCFGE)</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="#ADDEMLCFGE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ADDEMLCFGE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ADDEMLCFGE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ADDEMLCFGE"></a>
<p>The Add Emulation Configuration Entry (ADDEMLCFGE) command is used to add a configuration entry for a 3270 device emulation session to the configuration file. You can use this command to specify display and printer emulation options, such as setting the maximum image size for a display, or tracing the data stream for a printer.
</p>
<p>The values you specify are used during an emulation session when the configuration entry is specified on the Start 3270 Display Emulation (STREML3270) or Start Printer Emulation (STRPRTEML) commands.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ADDEMLCFGE.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="#ADDEMLCFGE.EMLCFGE"><b>EMLCFGE</b></a></td>
<td valign="top">Configuration entry</td>
<td valign="top"><i>Name</i>, QEMDFTCFGE</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEMLCFGE.EMLDBGJOB"><b>EMLDBGJOB</b></a></td>
<td valign="top">Debug job</td>
<td valign="top"><b><u>*NOTRACE</u></b>, *TRACE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEMLCFGE.EMLSIG"><b>EMLSIG</b></a></td>
<td valign="top">Handle signals</td>
<td valign="top"><b><u>*SAVE</u></b>, *IGNORE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEMLCFGE.EMLATR"><b>EMLATR</b></a></td>
<td valign="top">Handle attributes</td>
<td valign="top"><b><u>*IGNORE</u></b>, *REJECT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEMLCFGE.EMLMAXSCR"><b>EMLMAXSCR</b></a></td>
<td valign="top">Maximum screen size</td>
<td valign="top"><b><u>*DEVD</u></b>, *MOD2, *MOD5</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEMLCFGE.EMLTRC"><b>EMLTRC</b></a></td>
<td valign="top">VLIC trace</td>
<td valign="top"><b><u>*NOTRACE</u></b>, *TRACE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEMLCFGE.EMLSTR"><b>EMLSTR</b></a></td>
<td valign="top">Start printer TRCJOB</td>
<td valign="top"><b><u>*NOTRACE</u></b>, *TRACE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEMLCFGE.EMLINLSCN"><b>EMLINLSCN</b></a></td>
<td valign="top">Initial screen</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEMLCFGE.EMLGRDLIN"><b>EMLGRDLIN</b></a></td>
<td valign="top">Gridline</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEMLCFGE.EMLDBCS"><b>EMLDBCS</b></a></td>
<td valign="top">Graphic DBCS</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEMLCFGE.EMLPRTFMT"><b>EMLPRTFMT</b></a></td>
<td valign="top">Printout formatting</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEMLCFGE.EMLSNACLR"><b>EMLSNACLR</b></a></td>
<td valign="top">Clear processing</td>
<td valign="top"><b><u>*RETRY</u></b>, *IGNORE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEMLCFGE.EMLBUF"><b>EMLBUF</b></a></td>
<td valign="top">Gridline Buffer</td>
<td valign="top"><b><u>*FRONT</u></b>, *BACK</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEMLCFGE.EMLVLG"><b>EMLVLG</b></a></td>
<td valign="top">Conditional vlog generated</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEMLCFGE.EMLSCS"><b>EMLSCS</b></a></td>
<td valign="top">Handle SCS command errors</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEMLCFGE.EMLNML"><b>EMLNML</b></a></td>
<td valign="top">Enforce 5250 Numeric Lock</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEMLCFGE.EMLMSG"><b>EMLMSG</b></a></td>
<td valign="top">Send SNA Unbind message</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#ADDEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ADDEMLCFGE.EMLCFGE"></a>
<h3>Configuration entry (EMLCFGE)</h3>
<p>Specifies the name of the emulation configuration entry that you are adding to the configuration file.
</p>
<p>
<b>Note: </b>The configuration file is shipped with the default configuration entry for 3270 emulation sessions, QEMDFTCFGE.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEMLCFGE.EMLDBGJOB"></a>
<h3>Debug job (EMLDBGJOB)</h3>
<p>Specifies whether to trace the printer data stream being passed to the printer function manager when a job that is using printer emulation is being debugged with the Trace Job (TRCJOB) command.
</p>
<dl>
<dt><b><u>*NOTRACE</u></b></dt>
<dd>The printer data stream is not traced in the TRCJOB output.
</dd>
<dt><b>*TRACE</b></dt>
<dd>The printer data stream is traced in the TRCJOB output.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEMLCFGE.EMLSIG"></a>
<h3>Handle signals (EMLSIG)</h3>
<p>Specifies how an i5/OS emulation job that is not in send mode responds to a Systems Network Architecture (SNA) request for permission to send data (signal).
</p>
<dl>
<dt><b><u>*SAVE</u></b></dt>
<dd>The emulation job stores the SNA signal, and if appropriate grants the host permission to send when a piece of data with the change direction indicator (CD) on it is received.
</dd>
<dt><b>*IGNORE</b></dt>
<dd>The emulation job does not grant the host permission to send.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEMLCFGE.EMLATR"></a>
<h3>Handle attributes (EMLATR)</h3>
<p>Specifies how the 3270 emulation job responds to an incorrect character attribute or attribute value that is received during a single-byte character set (SBCS) session. In 3270 data stream terminology, a <b>character attribute</b> is a set attribute instruction (SA order) and an <b>attribute value</b> is a value on which the instruction operates (value).
</p>
<dl>
<dt><b><u>*IGNORE</u></b></dt>
<dd>The emulation job ignores the incorrect value.
</dd>
<dt><b>*REJECT</b></dt>
<dd>The emulation job sends a negative response to the data stream containing the incorrect character attribute or attribute value.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEMLCFGE.EMLMAXSCR"></a>
<h3>Maximum screen size (EMLMAXSCR)</h3>
<p>Specifies the maximum size of the image to be shown on the display screen.
</p>
<dl>
<dt><b><u>*DEVD</u></b></dt>
<dd>The maximum size is whatever the device can support.
</dd>
<dt><b>*MOD2</b></dt>
<dd>The maximum size is 24 rows by 80 columns.
</dd>
<dt><b>*MOD5</b></dt>
<dd>The maximum size is 27 rows by 132 columns.
<p>
<b>Note: </b>If the device does not support 27 rows by 132 columns, the maximum size defaults to 24 rows by 80 columns.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEMLCFGE.EMLTRC"></a>
<h3>VLIC trace (EMLTRC)</h3>
<p>Specifies whether trace points are issued by the data stream translation component of the Licensed Internal Code (LIC) when the following are true:
</p>
<ul>
<li>The job is using the data stream translation API (application program interface).
</li>
<li>The Trace Job (TRCJOB) command is running on the job using the data stream translation API.
</li>
<li>A LIC source/sink trace is also running.
</li>
</ul>
<dl>
<dt><b><u>*NOTRACE</u></b></dt>
<dd>Data stream translation trace points are not issued.
</dd>
<dt><b>*TRACE</b></dt>
<dd>Data stream translation trace points are issued.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEMLCFGE.EMLSTR"></a>
<h3>Start printer TRCJOB (EMLSTR)</h3>
<p>Specifies whether to call the Trace Job (TRCJOB) command when a printer emulation job is started.
</p>
<dl>
<dt><b><u>*NOTRACE</u></b></dt>
<dd>The TRCJOB command is not called.
</dd>
<dt><b>*TRACE</b></dt>
<dd>The TRCJOB command is called.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEMLCFGE.EMLINLSCN"></a>
<h3>Initial screen (EMLINLSCN)</h3>
<p>Specifies whether to show the Emulation Initialization In Progress display when a 3270 device emulation session is starting.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>The display is shown.
</dd>
<dt><b>*NO</b></dt>
<dd>The display is not shown.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEMLCFGE.EMLGRDLIN"></a>
<h3>Gridline (EMLGRDLIN)</h3>
<p>Specifies whether to suppress field outlining on the display.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Field outlining is not suppressed.
</dd>
<dt><b>*YES</b></dt>
<dd>Field outlining is suppressed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEMLCFGE.EMLDBCS"></a>
<h3>Graphic DBCS (EMLDBCS)</h3>
<p>Specifies whether to support the DBCS-graphic character string for input fields.
</p>
<p>
<b>Note: </b>This parameter is valid only for customer applications that specify field attributes or that specify character attributes for the entire input field. If only part of a field is defined with the DBCS-graphic attribute, you will get unpredictable results.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The DBCS-graphic character string is not supported.
</dd>
<dt><b>*YES</b></dt>
<dd>The DBCS-graphic character string is supported.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEMLCFGE.EMLPRTFMT"></a>
<h3>Printout formatting (EMLPRTFMT)</h3>
<p>Specifies whether to use the values supplied by the STRPRTEML command for the number of lines (NUMLIN) parameter and the number of columns (NUMCOL) parameter instead of using the values supplied by the printer file.
</p>
<p>
<b>Note: </b>This parameter is valid only for SNA character string (SCS) printer sessions.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The STRPRTEML command values for lines and columns are not used.
</dd>
<dt><b>*YES</b></dt>
<dd>The STRPRTEML command values for lines and columns are used.
<p>
<b>Note: </b>The STRPRTEML command values remain in effect until a set horizontal format or a set vertical format command is received from the host.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEMLCFGE.EMLSNACLR"></a>
<h3>Clear processing (EMLSNACLR)</h3>
<p>Specifies how the 3270 emulation job recovers when an attempt to get data sent by the host system fails after an SNA CLEAR command is received.
</p>
<p>
<b>Note: </b>This parameter is valid only for display emulation sessions.
</p>
<dl>
<dt><b><u>*RETRY</u></b></dt>
<dd>The emulation job tries again to get the data.
</dd>
<dt><b>*IGNORE</b></dt>
<dd>The emulation job does not try again to get the data.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEMLCFGE.EMLBUF"></a>
<h3>Gridline Buffer (EMLBUF)</h3>
<p>Specifies whether the foreground or background buffer is used when base gridlines are displayed. This parameter does not apply when strategic gridlines are used.
</p>
<dl>
<dt><b><u>*FRONT</u></b></dt>
<dd>The foreground buffer is used.
</dd>
<dt><b>*BACK</b></dt>
<dd>The background buffer is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEMLCFGE.EMLVLG"></a>
<h3>Conditional vlog generated (EMLVLG)</h3>
<p>Specifies whether to generate a VLIC log when the datastream translation routines send a negative response to the host because a command or order was not valid.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The VLIC log is not generated.
</dd>
<dt><b>*YES</b></dt>
<dd>The VLIC log is generated. The emulation session continues.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEMLCFGE.EMLSCS"></a>
<h3>Handle SCS command errors (EMLSCS)</h3>
<p>For SCS printer sessions only, this parameter says whether to follow architecture and default to a page size or page width of 1 line when a bad set horizontal format (SHF) or a bad set vertical format (SVF) is received.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The architecture is followed. Page size is one line.
</dd>
<dt><b>*YES</b></dt>
<dd>The architecture is not followed, page size and width default to values entered on the start printer emulation (STRPRTEML) command.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEMLCFGE.EMLNML"></a>
<h3>Enforce 5250 Numeric Lock (EMLNML)</h3>
<p>Specifies whether to enforce 5250 Numeric Lock by the data stream translation component of the Licensed Internal Code (LIC) when the job is using the data stream translation API (application program interface).
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>5250 Numeric Lock is not enforced.
</dd>
<dt><b>*YES</b></dt>
<dd>5250 Numeric Lock is enforced.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEMLCFGE.EMLMSG"></a>
<h3>Send SNA Unbind message (EMLMSG)</h3>
<p>Specifies whether to display a message on the screen when an unbind has been received.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>No message is displayed.
</dd>
<dt><b>*YES</b></dt>
<dd>Message is displayed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDEMLCFGE.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Adding a Configuration Entry</b>
</p>
<p>
<pre>
ADDEMLCFGE EMLCFGE(ARTSDEPT) EMLMAXSCR(*MOD5)
EMLGRDLIN(*YES)
</pre>
</p>
<p>This command adds an emulation configuration entry named ARTSDEPT for a display with a maximum screen image of 27 rows by 132 columns. Field outlining does not show on the display.
</p>
<p><b>Example 2: Adding a Configuration Entry for a Printer</b>
</p>
<p>
<pre>
ADDEMLCFGE EMLCFGE(FASBPRINT) EMLDBGJOB(*TRACE)
EMLATR(*REJECT)
</pre>
</p>
<p>This command adds an emulation configuration entry named FASBPRINT to the configuration file. The FASBPRINT configuration entry traces the printer data stream when a job is running with a trace on it and sends a negative response when incorrect data is received.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDEMLCFGE.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF853A</b></dt>
<dd>Emulation entry &amp;1 already exists.
</dd>
<dt><b>CPF854B</b></dt>
<dd>Internal error in emulation configuration routines.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>