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

895 lines
40 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 3270 Display Emulation (STREML3270)</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="STREML3270.Top_Of_Page"></a>
<h2>Start 3270 Display Emulation (STREML3270)</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="#STREML3270.PARAMETERS.TABLE">Parameters</a><br>
<a href="#STREML3270.COMMAND.EXAMPLES">Examples</a><br>
<a href="#STREML3270.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="STREML3270"></a>
<p>The Start 3270 Display Emulation (STREML3270) command starts a 3270 device emulation session for a display device to a binary synchronous communications (BSC) or Systems Network Architecture (SNA) host system. The user can type this command on the command line or from any display station that allows CL commands to be specified. This command can also be issued from a batch job by specifying the display device (DSPDEV) parameter.
</p>
<p>The STREML3270 command can be in a CL program specified as the INLPGM for a user profile that is run when the user signs on the display device.
</p>
<p>More information on device emulation is in the 3270 Device Emulation Support book, SC41-5408.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="STREML3270.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="#STREML3270.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="#STREML3270.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="#STREML3270.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="#STREML3270.DSPDEV"><b>DSPDEV</b></a></td>
<td valign="top">Display device, batch only</td>
<td valign="top"><i>Name</i>, <b><u>*CURRENT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STREML3270.PAGEUP"><b>PAGEUP</b></a></td>
<td valign="top">Page Up (Roll Down) key</td>
<td valign="top"><b><u>*PA2</u></b>, *PA1, *PA3, *NONE, *F1, *F2, *F3, *F4, *F5, *F6, *F7, *F8, *F9, *F10, *F11, *F12, *F13, *F14, *F15, *F16, *F17, *F18, *F19, *F20, *F21, *F22, *F23, *F24, *CLEAR, *ERASEINP, *CSRSLT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STREML3270.PAGEDOWN"><b>PAGEDOWN</b></a></td>
<td valign="top">Page Down (Roll Up) key</td>
<td valign="top"><b><u>*PA1</u></b>, *PA2, *PA3, *NONE, *F1, *F2, *F3, *F4, *F5, *F6, *F7, *F8, *F9, *F10, *F11, *F12, *F13, *F14, *F15, *F16, *F17, *F18, *F19, *F20, *F21, *F22, *F23, *F24, *CLEAR, *ERASEINP, *CSRSLT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STREML3270.TESTREQ"><b>TESTREQ</b></a></td>
<td valign="top">Test Request key</td>
<td valign="top"><b><u>*DFT</u></b>, *CLEAR, *ERASEINP</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STREML3270.CSRSLT"><b>CSRSLT</b></a></td>
<td valign="top">Cursor Select key</td>
<td valign="top"><b><u>*NONE</u></b>, *F1, *F2, *F3, *F4, *F5, *F6, *F7, *F8, *F9, *F10, *F11, *F12, *F13, *F14, *F15, *F16, *F17, *F18, *F19, *F20, *F21, *F22, *F23, *F24</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STREML3270.IGCEMLPC"><b>IGCEMLPC</b></a></td>
<td valign="top">SNA DBCS 3270PC emulation</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STREML3270.EMLPRTDEV"><b>EMLPRTDEV</b></a></td>
<td valign="top">Emulation printer device</td>
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b>, *EMLCTL, *EMLLOC</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STREML3270.INZWAIT"><b>INZWAIT</b></a></td>
<td valign="top">Timeout wait for host</td>
<td valign="top">1-32767, <b><u>120</u></b>, *NOMAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STREML3270.NUMLCK"><b>NUMLCK</b></a></td>
<td valign="top">Numeric lock keyboard</td>
<td valign="top"><b><u>*EMLDEV</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STREML3270.NULLS"><b>NULLS</b></a></td>
<td valign="top">Handle nulls</td>
<td valign="top"><b><u>*BLANK</u></b>, *REMOVE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STREML3270.LOGON"><b>LOGON</b></a></td>
<td valign="top">Host signon/logon command</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STREML3270.WAITRSP"><b>WAITRSP</b></a></td>
<td valign="top">Wait response</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STREML3270.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 2 repetitions): *DACTLU, *UNBIND</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STREML3270.ATNEMLMNU"><b>ATNEMLMNU</b></a></td>
<td valign="top">Attention emulation menu</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="5"><a href="#STREML3270.FKEYPGM"><b>FKEYPGM</b></a></td>
<td valign="top">Function key program</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="5">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Program</td>
<td valign="top">
<i>Qualified object name</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Qualifier 1: Program</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top">Element 2: Function keys</td>
<td valign="top">
Single values: *ALLFKEYS<br>Other values (up to 24 repetitions): *F1, *F2, *F3, *F4, *F5, *F6, *F7, *F8, *F9, *F10, *F11, *F12, *F13, *F14, *F15, *F16, *F17, *F18, *F19, *F20, *F21, *F22, *F23, *F24</td>
</tr>
<tr>
<td valign="top"><a href="#STREML3270.KBDTYPE"><b>KBDTYPE</b></a></td>
<td valign="top">Keyboard language type</td>
<td valign="top"><b><u>*DSPDEV</u></b>, *SYSVAL, *LCL, AGB, AGE, AGI, AGM, ALI, ALM, BGB, BGE, BLI, BLM, BRB, BRE, CAB, CAE, CAI, CAM, CLB, CLE, CSB, CSE, CYB, DMB, DME, DMI, DMM, ESB, FAB, FAE, FAI, FAM, FNB, FNE, FNI, FNM, FQB, FQI, GKB, GNB, GNE, HIB, HNB, HNE, ICB, ICE, ICI, ICM, INB, INI, IRB, ITB, ITE, ITI, ITM, JEB, JEI, JKB, JPB, JPE, JUB, KAB, KOB, LAE, LTB, LVB, MKB, MKE, NCB, NCE, NEB, NEE, NEI, NEM, NWB, NWE, NWI, NWM, PLB, PKE, PLE, PRB, PRE, PRI, PRM, RCB, RMB, RME, ROB, ROE, RUB, RUE, SFI, SFM, SGI, SGM, SKB, SKE, SPB, SPE, SPI, SPM, SQB, SQE, SSB, SSI, SSE, SSM, SWB, SWE, SWI, SWM, TAB, THB, THE, TKB, TKE, TRB, TRE, UAE, UKB, UKE, UKI, UKM, USB, USE, USI, USM, VNE, YGI, YGM, *TRNTBL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#STREML3270.TRNTBLOUT"><b>TRNTBLOUT</b></a></td>
<td valign="top">Outgoing translation table</td>
<td valign="top">Single values: <b><u>*KBDTYPE</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="#STREML3270.TRNTBLIN"><b>TRNTBLIN</b></a></td>
<td valign="top">Incoming translation table</td>
<td valign="top">Single values: <b><u>*KBDTYPE</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: Incoming 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"><a href="#STREML3270.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="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="STREML3270.EMLCTL"></a>
<h3>Emulation controller (EMLCTL)</h3>
<p>Specifies the name of a binary synchronous communications (BSC) controller description or Systems Network Architecture (SNA) controller description that has attached 3270 emulation device descriptions. When this parameter is specified, the requesting display device is linked to an available 3270 emulation device on the emulation controller. At least one device attached to the controller must be available, and the requester of the command must be authorized to use the controller and device.
</p>
<p>Either this parameter, the <b>Emulation device</b> prompt (EMLDEV parameter), or the <b>Emulation location</b> prompt (EMLLOC parameter) is required.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STREML3270.EMLDEV"></a>
<h3>Emulation device (EMLDEV)</h3>
<p>Specifies the name of a binary synchronous communications (BSC) or any System Network Architecture (SNA) device emulation (3278) that is linked to the requesting display device to emulate a 3270 display device. The requester must be authorized to this device, and the device must be available.
</p>
<p>Either this parameter, the <b>Emulation controller (EMLCTL)</b> parameter, or the <b>Emulation location (EMLLOC)</b> parameter is required.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STREML3270.EMLLOC"></a>
<h3>Emulation location (EMLLOC)</h3>
<p>Specifies the remote location name that describes the location of the 3270 display emulation devices. This name is defined during device description configuration, and it refers to the remote location where communication takes place. When this parameter is specified, the requesting display device is linked to an available 3270 emulation device referred to by the remote location. At least one of the emulation devices referred to by the remote location must be available, and the requester of the command must be authorized to use the device. A remote location can refer to as many as 1,016 emulation display devices.
</p>
<p>Either this parameter, the <b>Emulation controller</b> prompt (EMLCTL parameter), or the <b>Emulation device</b> prompt (EMLDEV parameter) is required.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STREML3270.DSPDEV"></a>
<h3>Display device, batch only (DSPDEV)</h3>
<p>Specifies the name of the display device used for display emulation when the command is in a batch job. The 3270 support tries to acquire the display device by this name; if the display device is acquired, the 3270 device emulation is active on that display device.
</p>
<dl>
<dt><b><u>*CURRENT</u></b></dt>
<dd>The current display device name is used for device emulation. This parameter is used when the command is in an interactive job.
</dd>
<dt><b><i>display-device-name</i></b></dt>
<dd>Specify the display device name used for device emulation. This parameter is used when the command is in a batch job.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STREML3270.PAGEUP"></a>
<h3>Page Up (Roll Down) key (PAGEUP)</h3>
<p>Specifies a 3270 function for the Page Up (Roll Down) key on the 5250 type keyboard when 3270 device emulation is active. This assignment is in effect when the number of input fields is not larger than the maximum number of input fields.
</p>
<dl>
<dt><b><u>*PA-key</u></b></dt>
<dd>Specify the 3270 PA key assigned to the Page Up (Roll Down) key. The default is the *PA2 key.
</dd>
<dt><b>*NONE</b></dt>
<dd>No function is assigned to the Page Up (Roll Down) key. When there are fewer input fields on the display than allowed by the 5250 display device, this key has no function.
</dd>
<dt><b>*F-key</b></dt>
<dd>Specify the 3270 F key assigned to the Page Up (Roll Down) key.
</dd>
<dt><b>*CLEAR</b></dt>
<dd>The 3270 CLEAR key is assigned to the Page Up (Roll Down) key.
</dd>
<dt><b>*ERASEINP</b></dt>
<dd>The 3270 ERASE INPUT key is assigned to the Page Up (Roll Down) key.
</dd>
<dt><b>*CSRSLT</b></dt>
<dd>The 3270 CURSOR SELECT key is assigned to the Page Up (Roll Down) key and does not allow the real Cursor Select key to be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STREML3270.PAGEDOWN"></a>
<h3>Page Down (Roll Up) key (PAGEDOWN)</h3>
<p>Specifies an added function for the Page Down (Roll Up) key on the 5250 type keyboard when 3270 device emulation is active. This assignment is in effect when the number of input fields is not larger than the maximum number of input fields.
</p>
<dl>
<dt><b><u>*PA-key</u></b></dt>
<dd>Specify the 3270 PA key assigned to the Page Down (Roll Up) key. The default is the *PA1 key.
</dd>
<dt><b>*NONE</b></dt>
<dd>No function is assigned to the Page Down (Roll Up) key. When there are fewer input fields on the display than allowed by the 5250 display device, the key has no function.
</dd>
<dt><b>*F-key</b></dt>
<dd>Specify the 3270 F key assigned to the Page Down (Roll Up) key.
</dd>
<dt><b>*CLEAR</b></dt>
<dd>The 3270 CLEAR key is assigned to the Page Down (Roll Up) key.
</dd>
<dt><b>*ERASEINP</b></dt>
<dd>The 3270 ERASE INPUT key is assigned to the Page Down (Roll Up) key.
</dd>
<dt><b>*CSRSLT</b></dt>
<dd>The 3270 CURSOR SELECT key is assigned to the Page Down (Roll Up) key and does not allow the real Cursor Select key to be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STREML3270.TESTREQ"></a>
<h3>Test Request key (TESTREQ)</h3>
<p>Specifies an added function for the Test Request key on the 5250 keyboard when 3270 device emulation is active.
</p>
<dl>
<dt><b><u>*DFT</u></b></dt>
<dd>Normal function is assigned to the Test Request key. This is the system default. The normal function depends on whether the 3270 emulation display device uses binary synchronous communications (BSC) or Systems Network Architecture (SNA) protocol. BSC defaults to a 3270 Test Request function, while SNA defaults to a 3270 System Request function.
</dd>
<dt><b>*CLEAR</b></dt>
<dd>The 3270 CLEAR key is assigned to the Test Request key.
</dd>
<dt><b>*ERASEINP</b></dt>
<dd>The 3270 ERASE INPUT key is assigned to the Test Request key.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STREML3270.CSRSLT"></a>
<h3>Cursor Select key (CSRSLT)</h3>
<p>Specifies one of several physical function keys to be used as the Cursor Select key. When 3270 emulation is active, the specified key can be used to select or reject selectable fields.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>A physical function key is not assigned to emulate the cursor select key. The real Cursor Select key is used.
</dd>
<dt><b>*F-key</b></dt>
<dd>Specify the function key assigned to emulate the Cursor Select key. The use of the real Cursor Select key is not allowed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STREML3270.IGCEMLPC"></a>
<h3>SNA DBCS 3270PC emulation (IGCEMLPC)</h3>
<p>Specifies whether System Network Architecture (SNA) double-byte character set (DBCS) 3270PC emulation or 3270 device emulation is used. This parameter is valid only when using a S/55 Personal Computer.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>SNA DBCS 3270PC emulation is not used.
</dd>
<dt><b>*YES</b></dt>
<dd>SNA DBCS 3270PC emulation is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STREML3270.EMLPRTDEV"></a>
<h3>Emulation printer device (EMLPRTDEV)</h3>
<p>Specifies the emulation printer device that is used for SNA DBCS 3270PC emulation. The printer emulation device is selected after the device emulation is selected. This parameter is valid only when *YES is specified on the <b>SNA DBCS 3270PC emulation</b> prompt (IGCEMLPC parameter).
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>SNA DBCS 3270PC printer emulation with device emulation is not used. No printer emulation device is selected.
</dd>
<dt><b><i>emulation-device-description-name</i></b></dt>
<dd>Specify the printer emulation device with the selected display emulation device for SNA DBCS 3270PC emulation.
</dd>
<dt><b>*EMLCTL</b></dt>
<dd>The first available printer emulation device on the specified controller on the <b>Emulation controller</b> prompt (EMLCTL parameter) is used.
</dd>
<dt><b>*EMLLOC</b></dt>
<dd>The first available printer emulation device from the specified location on the <b>Emulation location</b> prompt (EMLLOC parameter) is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STREML3270.INZWAIT"></a>
<h3>Timeout wait for host (INZWAIT)</h3>
<p>Specifies the initial amount of time (in seconds) that 3270 emulation waits for the first display data from the host system. If the host system does not send the first display in this time, the emulation session is ended, and a message is returned to the requester.
</p>
<dl>
<dt><b><u>120</u></b></dt>
<dd>3270 emulation waits 120 seconds for the first display from the host system.
</dd>
<dt><b>*NOMAX</b></dt>
<dd>There is no limit on the amount of time 3270 emulation waits for the first display from the host system. This value can be used when the user is not sure when the host system is active to this session. The request can be ended by using the system request and ending request functions.
</dd>
<dt><b><i>number-of-seconds</i></b></dt>
<dd>Specify the length of time (in seconds) that the 3270 emulation waits for the first display from the host system. Valid values range from 1 through 32767 seconds.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STREML3270.NUMLCK"></a>
<h3>Numeric lock keyboard (NUMLCK)</h3>
<p>Specifies whether numeric input fields will only allow numeric data on a 5250 keyboard.
</p>
<dl>
<dt><b><u>*EMLDEV</u></b></dt>
<dd>Numeric lock is specified in the EMLNUMLCK field of the emulation device description. You can use the DSPDEVD command to display the current EMLNUMLCK value for the emulation device. The value can be changed using the BSC commands CRTDEVBSC or CHGDEVBSC or the SNA commands CRTDEVHOST or CHGDEVHOST.
</dd>
<dt><b>*NO</b></dt>
<dd>3270 emulation will allow any data to be typed in the numeric input fields.
</dd>
<dt><b>*YES</b></dt>
<dd>3270 emulation will only allow numeric data to be typed in the numeric input fields. Numeric data that can be typed include the characters 0 through 9, and symbols " + - , . " and the blank symbol, which is the character <i>b</i> with a slash on the stem.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STREML3270.NULLS"></a>
<h3>Handle nulls (NULLS)</h3>
<p>Specifies how beginning and embedded nulls within the 3270 data stream sent from a 5250 display station are handled. Beginning nulls are those that occur before a character that is not null. Embedded nulls are those that occur between characters that are not null.
</p>
<dl>
<dt><b><u>*BLANK</u></b></dt>
<dd>Beginning and embedded nulls are changed to blanks within the 3270 data stream.
</dd>
<dt><b>*REMOVE</b></dt>
<dd>Beginning and embedded nulls are removed from the 3270 data stream.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STREML3270.LOGON"></a>
<h3>Host signon/logon command (LOGON)</h3>
<p>Specifies the sign-on text that is sent to the host system after SNA 3270 emulation is started. This text can be used to sign on to a specific host application.
</p>
<p>This parameter is not allowed if specified for BSC 3270 emulation, SNA 3270 display station pass-through, or SNA DBCS 3270PC emulation.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No text is sent to the host system after 3270 emulation is started.
</dd>
<dt><b><i>host-logon-command</i></b></dt>
<dd>Specify text that is sent to the host system after 3270 emulation is started. The text must be enclosed in apostrophes if it contains blanks or other special characters. All apostrophes within the text must be represented by two apostrophes. A maximum of 256 characters can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STREML3270.WAITRSP"></a>
<h3>Wait response (WAITRSP)</h3>
<p>Specifies whether the 3270 emulation device waits until the data received is shown on the workstation display to send a positive response to the host system. The response time recorded by the iSeries system may be longer than the time recorded by the host when the emulation device does not wait.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The emulation device does not wait to send a positive response. It sends the response as soon as the data is received to the workstation display.
</dd>
<dt><b>*YES</b></dt>
<dd>The emulation device waits until the data received is shown on the workstation display to send a positive response.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STREML3270.ENDCOND"></a>
<h3>End emulation conditions (ENDCOND)</h3>
<p>Specifies additional ways in which the SNA 3270 device emulation session can end.
</p>
<p>This parameter is not allowed if specified for BSC 3270 emulation, SNA 3270 display station pass-through, or SNA DBCS 3270PC emulation.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No additional ways to end 3270 device emulation are requested.
</dd>
<dt><b>*DACTLU</b></dt>
<dd>The 3270 emulation session will end if it receives an SNA DACTLU from the host system. Please consider the following before selecting this end condition:
<ul>
<li>There are certain host system applications that issue a DACTLU before starting, such as Time Sharing Option (TSO), which will end the 3270 emulation session before the desired application is accessed. This end condition should be avoided when trying to access these applications.
</li>
</ul>
</dd>
<dt><b>*UNBIND</b></dt>
<dd>The 3270 emulation session will end if it receives an SNA UNBIND from the host system. Consider the following items before selecting this end condition:
<ul>
<li>This end condition should be used only when you need to access one host application for the duration of the session. An UNBIND will occur while switching from one application to the next, and the 3270 session will end before accessing the second application.
</li>
<li>This end condition should only be used when the communication path to the host system is a simple one. A simple communication path is one that only involves accessing the iSeries system where the Start 3270 Display Emulation (STREML3270) command is run, and accessing the host system that contains the desired application. Intermediate systems can exist along this simple path as long as they are not accessed. If intermediate systems are accessed, an UNBIND will occur while switching from one system to the next, and the 3270 display emulation session will end before accessing the desired application.
</li>
<li>There are certain host system applications that issue an UNBIND before starting, such as Time Sharing Option (TSO), which will end the 3270 display emulation session before the desired application is accessed. This end condition should be avoided when trying to access these applications.
</li>
</ul>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STREML3270.ATNEMLMNU"></a>
<h3>Attention emulation menu (ATNEMLMNU)</h3>
<p>Specify whether you want the Select 3270 Emulation Option for SNA menu or the Select 3270 Emulation Option for BSC menu to be displayed when the Attention key is pressed.
</p>
<p>This parameter is not allowed if specified for either SNA 3270 display station pass-through or SNA DBCS 3270PC emulation.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>The Select 3270 Emulation Option for SNA or BSC menu is displayed when you press the Attention key.
</dd>
<dt><b>*NO</b></dt>
<dd>The Select 3270 Emulation Option for SNA or BSC menu is not displayed when you press the Attention key. The attention program (if any) currently active in the job will get control when the Attention key is pressed. You can still display the Select 3270 Emulation Option for SNA or BSC menu by pressing the System Request key sequence and then selecting the <b>Display 3270 emulation options menu</b> option from the System Request menu.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STREML3270.FKEYPGM"></a>
<h3>Function key program (FKEYPGM)</h3>
<p>Specifies a user-exit program and one or more function keys that call the program. When a specified function key is pressed during the 3270 display emulation session and is sent to the host system, the user-exit program is called. When the user-exit program ends, control is returned to the 3270 display emulation session at the point where the function key was pressed.
</p>
<p>This parameter is not valid if specified for either BSC 3270 display emulation, SNA 3270 display station pass-through, or SNA DBCS 3270PC emulation.
</p>
<p>The user-exit program is called only if the function key is successfully sent to the host system. If the function key fails to be received, an error reset message appears at the bottom of the display suggesting you try again.
</p>
<p>The iSeries user-exit program must be coded to allow for input parameters. The following parameters are passed to the program in the specified order:
</p>
<ol>
<li>The function key identifier (10 characters). The identifier of the function key that was pressed. If function key 1 is pressed, the parameter value is *F1. If function key 2 is pressed, the parameter value is *F2, and so on, up to function key 24. The value is left-justified within the parameter.
</li>
<li>The display name (10 characters). The name of the display on which the 3270 display emulation running. The value is left-justified within the parameter.
</li>
<li>The cursor location (6 characters). The screen location of the cursor at the time the function key was pressed. The first three characters are the row position of the cursor location. The second three characters are the column position of the cursor location. For example, if the cursor location is row 24, column 1 when the function key is pressed, the value of the parameter is 024001. The row and column can be extracted from the variable using substring logic.
</li>
</ol>
<p>The possible <b>program name</b> values are:
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>A user-exit program is not associated with any function key.
</dd>
<dt><b><i>program-name</i></b></dt>
<dd>Specify the name and library of the user-exit program that is called when one of the specified function keys is pressed. The program cannot be a system program.
</dd>
</dl>
<p>The possible library values are:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the user and system portions of the job's library list are searched until the first match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the program. If no library is specified as the current library for the job, QGPL is used.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library to be searched.
</dd>
</dl>
<dl>
</dl>
<p>The possible <b>function key</b> values are:
</p>
<dl>
<dt><b>*ALLFKEYS</b></dt>
<dd>All function keys call the specified user-exit program.
</dd>
<dt><b><i>function-key</i></b></dt>
<dd>Specify a function key to call the user-exit program. A maximum of 24 values can be specified on this parameter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STREML3270.KBDTYPE"></a>
<h3>Keyboard language type (KBDTYPE)</h3>
<p>Specifies the 3-character keyboard language identifier which represents a specific full character identifier (CHRID - comprised of a character set and code page) that is used on the display station. To determine the full CHRID from the keyboard language identifier, see the CHRID Values table in the Create Device Display (CRTDEVDSP) command in the CL Reference.
</p>
<p>This parameter does not apply when running SNA 3270 display station pass-through.
</p>
<dl>
<dt><b><u>*DSPDEV</u></b></dt>
<dd>If a local display device is specified for the STREML3270 display device (DSPDEV) parameter, then use the specified display's device description current KBDTYPE value. If a remote display device is specified for the STREML3270 DSPDEV parameter, then use the current QKBDTYPE system value.
</dd>
<dt><b><u>*SYSVAL</u></b></dt>
<dd>Use the current QKBDTYPE system value. This value is valid for both local and remote displays.
</dd>
<dt><b><u>*LCL</u></b></dt>
<dd>The display device that requested 3270 device emulation is a local display device. The keyboard type is determined from the display device description.
</dd>
<dt><b>*TRNTBL</b></dt>
<dd>Allows user-defined translation tables to be used. The character translation is defined in the translation tables specified by the <b>Outgoing translation table</b> prompt (TRNTBLOUT parameter) and the <b>Incoming translation table</b> prompt (TRNTBLIN parameter).
<p>If a local display device is specified for the STREML3270 Display Device (DSPDEV) parameter, then use the specified display's device description current KBDTYPE value to determine the CHRID to be used. If a remote display device is specified for the STREML3270 DSPDEV parameter, then use the current QKBDTYPE system value.
</p>
</dd>
<dt><b><i>keyboard-language-identifier</i></b></dt>
<dd>Specify the keyboard language identifier to be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STREML3270.TRNTBLOUT"></a>
<h3>Outgoing translation table (TRNTBLOUT)</h3>
<p>Specifies the outgoing translation table that is used to translate characters sent from the host system to 3270 Emulation. If *TRNTBL is specified on the <b>Keyboard language type</b> prompt (KBDTYPE parameter), the <b>Incoming translation table</b> prompt (TRNTBLIN parameter), must also be specified.
</p>
<dl>
<dt><b><u>*KBDTYPE</u></b></dt>
<dd>Translation is done using the language specified on the <b>Keyboard language type</b> prompt (KBDTYPE parameter).
</dd>
<dt><b><i>table-name</i></b></dt>
<dd>Specify the name and library of the table that is used for outgoing translation.
<p>The possible library values are:
</p>
</dd>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the user and system portions of the job's library list are searched until the first match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the outgoing translation table. If no library is specified as the current library for the job, QGPL is used.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library to be searched.
</dd>
</dl>
<dl>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STREML3270.TRNTBLIN"></a>
<h3>Incoming translation table (TRNTBLIN)</h3>
<p>Specifies the incoming translation table that is used to translate characters sent from 3270 Emulation to the host system. If *TRNTBL is specified on the <b>Keyboard language type</b> prompt (KBDTYPE parameter), the <b>Outgoing translation table</b> prompt (TRNTBLOUT parameter), must also be specified.
</p>
<dl>
<dt><b><u>*KBDTYPE</u></b></dt>
<dd>Translation is done using the language specified on the <b>Keyboard language type</b> prompt (KBDTYPE parameter).
</dd>
<dt><b><i>table-name</i></b></dt>
<dd>Specify the name and library of the table used for incoming translation.
<p>The possible library values are:
</p>
</dd>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the user and system portions of the job's library list are searched until the first match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the incoming translation table. If no library is specified as the current library for the job, QGPL is used.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library to be searched.
</dd>
</dl>
<dl>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STREML3270.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>
<p>The possible values are:
</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 QEMDFTDFGE 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="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STREML3270.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
STREML3270 EMLCTL(TSOHOST) PAGEUP(*F7) PAGEDOWN(*F8)
</pre>
</p>
<p>This command places the display device into an emulation session that uses the first available device on the controller description TSOHOST for which the user has authority. When there are fewer input fields on the display than the maximum allowed by the 5250 display device and the Page Up key is pressed, an F7 key value is sent to the host system. When the Page Down key is pressed, an F8 key value is sent to the host system.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STREML3270.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF2619</b></dt>
<dd>Table &amp;1 not found.
</dd>
<dt><b>CPF269A</b></dt>
<dd>Library parameter is not set to "QSYS " on call.
</dd>
<dt><b>CPF269B</b></dt>
<dd>T.61 conversion table not found.
</dd>
<dt><b>CPF85EA</b></dt>
<dd>Screen address received from host is larger than screen size.
</dd>
<dt><b>CPF85EB</b></dt>
<dd>3270 device emulation session ended.
</dd>
<dt><b>CPF85EC</b></dt>
<dd>Specifying text on the LOGON parameter is not supported.
</dd>
<dt><b>CPF85ED</b></dt>
<dd>Values other than ENDCOND(*NONE) are not supported.
</dd>
<dt><b>CPF85E2</b></dt>
<dd>3270 display emulation is already active at this job.
</dd>
<dt><b>CPF85E4</b></dt>
<dd>Not authorized to translation table &amp;1 in library &amp;2.
</dd>
<dt><b>CPF85E5</b></dt>
<dd>3270 emulation device &amp;1 is reserved for device &amp;2.
</dd>
<dt><b>CPF85E6</b></dt>
<dd>Translation table &amp;1 in library &amp;2 was not found.
</dd>
<dt><b>CPF8503</b></dt>
<dd>Emulation controller &amp;1 not found.
</dd>
<dt><b>CPF8504</b></dt>
<dd>Controller &amp;1 does not support 3270 emulation.
</dd>
<dt><b>CPF8505</b></dt>
<dd>Emulation device &amp;2 not found.
</dd>
<dt><b>CPF8506</b></dt>
<dd>Emulation location &amp;1 not found.
</dd>
<dt><b>CPF8507</b></dt>
<dd>Display emulation cannot open required file.
</dd>
<dt><b>CPF8508</b></dt>
<dd>Host system did not respond.
</dd>
<dt><b>CPF851A</b></dt>
<dd>Maximum number of shift in and shift out characters exceeded.
</dd>
<dt><b>CPF8510</b></dt>
<dd>Internal error occurred on device &amp;1.
</dd>
<dt><b>CPF8511</b></dt>
<dd>Emulation ended by errors on device &amp;2.
</dd>
<dt><b>CPF8512</b></dt>
<dd>Emulation ended because device &amp;2 was held.
</dd>
<dt><b>CPF8513</b></dt>
<dd>Emulation ended by errors on device &amp;2.
</dd>
<dt><b>CPF8514</b></dt>
<dd>Error recovery stopped on device &amp;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 &amp;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>CPF852A</b></dt>
<dd>Values other than FKEYPGM(*NONE) are not supported.
</dd>
<dt><b>CPF852B</b></dt>
<dd>Program &amp;1 not found.
</dd>
<dt><b>CPF852C</b></dt>
<dd>Not authorized to program &amp;1.
</dd>
<dt><b>CPF8521</b></dt>
<dd>Not authorized to controller &amp;1.
</dd>
<dt><b>CPF8522</b></dt>
<dd>Not authorized to emulation device &amp;2.
</dd>
<dt><b>CPF8523</b></dt>
<dd>*NO on the ATNEMLMNU parameter is not supported.
</dd>
<dt><b>CPF8524</b></dt>
<dd>Emulation cannot open its required display file.
</dd>
<dt><b>CPF8525</b></dt>
<dd>KBDTYPE(*LCL) not allowed for remote display devices.
</dd>
<dt><b>CPF8526</b></dt>
<dd>No 3270 display emulation devices available.
</dd>
<dt><b>CPF8527</b></dt>
<dd>Emulation device &amp;2 not available.
</dd>
<dt><b>CPF8528</b></dt>
<dd>Device &amp;2 is not a display emulation device.
</dd>
<dt><b>CPF8530</b></dt>
<dd>Not authorized to use any display emulation device.
</dd>
<dt><b>CPF8533</b></dt>
<dd>Display device not specified in a batch job.
</dd>
<dt><b>CPF8534</b></dt>
<dd>Display device &amp;1 is not available.
</dd>
<dt><b>CPF8535</b></dt>
<dd>Display device &amp;1 not found.
</dd>
<dt><b>CPF8536</b></dt>
<dd>Not authorized to display device &amp;1.
</dd>
<dt><b>CPF8539</b></dt>
<dd>&amp;1 keyboard type not supported by 3270 emulation.
</dd>
<dt><b>CPF8546</b></dt>
<dd>No 3270 display emulation devices available.
</dd>
<dt><b>CPF8547</b></dt>
<dd>No 3270 printer emulation devices available.
</dd>
<dt><b>CPF8550</b></dt>
<dd>Emulation ended due to time-out internal failure.
</dd>
<dt><b>CPF8551</b></dt>
<dd>Emulation ended with error code &amp;1.
</dd>
<dt><b>CPF8552</b></dt>
<dd>Emulation ended because of return code.
</dd>
<dt><b>CPF8553</b></dt>
<dd>BSC controller or device not allowed without translation.
</dd>
<dt><b>CPF8565</b></dt>
<dd>Emulation device &amp;1 not found.
</dd>
<dt><b>CPF8568</b></dt>
<dd>Device &amp;1 not printer emulation device.
</dd>
<dt><b>CPF8569</b></dt>
<dd>Not authorized to use any printer emulation device.
</dd>
<dt><b>CPF8571</b></dt>
<dd>No 3270 printer emulation devices available.
</dd>
<dt><b>CPF8572</b></dt>
<dd>Emulation device &amp;1 not available.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STREML3270.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>