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

541 lines
17 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>Change Configuration Entry (CHGEMLCFGE)</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="CHGEMLCFGE.Top_Of_Page"></a>
<h2>Change Configuration Entry (CHGEMLCFGE)</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="#CHGEMLCFGE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGEMLCFGE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGEMLCFGE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGEMLCFGE"></a>
<p>The Change Emulation Configuration Entry (CHGEMLCFGE) command is used to change options for a 3270 emulation session by changing an existing configuration entry in the configuration file.
</p>
<p>You also can prompt on this command to display existing values for an emulation session without making a change.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGEMLCFGE.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="#CHGEMLCFGE.EMLCFGE"><b>EMLCFGE</b></a></td>
<td valign="top">Configuration entry</td>
<td valign="top"><i>Name</i>, QEMDFTCFGE</td>
<td valign="top">Required, Key, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGEMLCFGE.EMLDBGJOB"><b>EMLDBGJOB</b></a></td>
<td valign="top">Debug job</td>
<td valign="top"><b><u>*SAME</u></b>, *NOTRACE, *TRACE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGEMLCFGE.EMLSIG"><b>EMLSIG</b></a></td>
<td valign="top">Handle signals</td>
<td valign="top"><b><u>*SAME</u></b>, *SAVE, *IGNORE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGEMLCFGE.EMLATR"><b>EMLATR</b></a></td>
<td valign="top">Handle attributes</td>
<td valign="top"><b><u>*SAME</u></b>, *IGNORE, *REJECT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGEMLCFGE.EMLMAXSCR"><b>EMLMAXSCR</b></a></td>
<td valign="top">Maximum screen size</td>
<td valign="top"><b><u>*SAME</u></b>, *DEVD, *MOD2, *MOD5</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGEMLCFGE.EMLTRC"><b>EMLTRC</b></a></td>
<td valign="top">VLIC trace</td>
<td valign="top"><b><u>*SAME</u></b>, *NOTRACE, *TRACE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGEMLCFGE.EMLSTR"><b>EMLSTR</b></a></td>
<td valign="top">Start printer TRCJOB</td>
<td valign="top"><b><u>*SAME</u></b>, *NOTRACE, *TRACE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGEMLCFGE.EMLINLSCN"><b>EMLINLSCN</b></a></td>
<td valign="top">Initial screen</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGEMLCFGE.EMLGRDLIN"><b>EMLGRDLIN</b></a></td>
<td valign="top">Gridline</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGEMLCFGE.EMLDBCS"><b>EMLDBCS</b></a></td>
<td valign="top">Graphic DBCS</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGEMLCFGE.EMLPRTFMT"><b>EMLPRTFMT</b></a></td>
<td valign="top">Printout formatting</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGEMLCFGE.EMLSNACLR"><b>EMLSNACLR</b></a></td>
<td valign="top">Clear processing</td>
<td valign="top"><b><u>*SAME</u></b>, *RETRY, *IGNORE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGEMLCFGE.EMLBUF"><b>EMLBUF</b></a></td>
<td valign="top">Gridline Buffer</td>
<td valign="top"><b><u>*SAME</u></b>, *FRONT, *BACK</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGEMLCFGE.EMLVLG"><b>EMLVLG</b></a></td>
<td valign="top">Conditional vlog generated</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGEMLCFGE.EMLSCS"><b>EMLSCS</b></a></td>
<td valign="top">Handle SCS command errors</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGEMLCFGE.EMLNML"><b>EMLNML</b></a></td>
<td valign="top">Enforce 5250 Numeric Lock</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGEMLCFGE.EMLMSG"><b>EMLMSG</b></a></td>
<td valign="top">Send SNA Unbind message</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGEMLCFGE.EMLCFGE"></a>
<h3>Configuration entry (EMLCFGE)</h3>
<p>Specifies the name of the existing emulation configuration entry that you are changing.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b>QEMDFTCFGE</b></dt>
<dd>The default configuration entry for 3270 emulation sessions is changed.
</dd>
<dt><b><i>configuration-entry-name</i></b></dt>
<dd>Specify the name of the configuration entry to be changed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEMLCFGE.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NOTRACE</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="#CHGEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEMLCFGE.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*SAVE</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="#CHGEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEMLCFGE.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*IGNORE</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="#CHGEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEMLCFGE.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*DEVD</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="#CHGEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEMLCFGE.EMLTRC"></a>
<h3>VLIC trace (EMLTRC)</h3>
<p>Specifies whether Licensed Internal Code (LIC) data stream translation trace points are issued 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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NOTRACE</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="#CHGEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEMLCFGE.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NOTRACE</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="#CHGEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEMLCFGE.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*YES</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="#CHGEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEMLCFGE.EMLGRDLIN"></a>
<h3>Gridline (EMLGRDLIN)</h3>
<p>Specifies whether to suppress field outlining from showing on the display.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NO</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="#CHGEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEMLCFGE.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NO</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="#CHGEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEMLCFGE.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NO</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="#CHGEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEMLCFGE.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*RETRY</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="#CHGEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEMLCFGE.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*FRONT</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="#CHGEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEMLCFGE.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<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="#CHGEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEMLCFGE.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<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="#CHGEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEMLCFGE.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<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="#CHGEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEMLCFGE.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<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="#CHGEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGEMLCFGE.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGEMLCFGE EMLCFGE(ARTSDEPT) EMLMAXSCR(*DEVD)
EMLGRDLIN(*NO)
</pre>
</p>
<p>This command changes the maximum display size option of the ARTSDEPT emulation configuration entry to the maximum size for the display device. Field outlining is changed to show on the display.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGEMLCFGE.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF853E</b></dt>
<dd>Emulation configuration entry &amp;1 not found.
</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="#CHGEMLCFGE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>