STREML3270

STREML3270 (Start 3270 Display Emulation)

STREML3270 Command syntax diagram

Purpose

The Start 3270 Display Emulation (STREML3270) command starts a 3270 device emulation session for a display device. 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.
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.
More information on device emulation is in the 3270 Device Emulation Support
book.

Required Parameters

EMLCTL

Specifies the name of a binary synchronous communications (BSC) controller description (APPTYPE(*EML)) or Systems Network Architecture (SNA) controller description type of HOST with attached 3270 emulation display devices. When this parameter is specified, the requesting display device is linked to an available 3270 emulation display device on the emulation controller. The controller of the device must be available, and the requester of the command must be authorized to use the controller.

EMLDEV

Specifies the name of a BSC or an SNA emulation display device that is linked to the requesting display device to emulate a specific type of 3270 display device. The requester must be authorized for this device and the device must be available.

EMLLOC

Specifies the emulation remote location name that describes the location of the 3270 emulation display devices. When this parameter is specified, the requesting display device is linked to an available 3270 display 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.

Optional Parameters

DSPDEV

Specifies the name of the display device used for device 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.
*CURRENT: The current display device name is used for device emulation.
display-device-name: Specify the display device name used for device emulation.

PAGEUP

Specifies an added function for the Page Up (Roll Down) key on the 5250 keyboard when 3270 device emulation is active. This assignment is in effect when the number is not larger than the maximum number of input fields.
*PA2: The 3270 PA2 function is assigned to the Page Up key.
*NONE: No 3270 function is assigned to the Page Up key. When there are fewer input fields on the display than allowed by the 5250 display device, the Page Up key has no function.
*F-KEY: Specify the 3270 function key assigned to the Page Up key.
*PA1-KEY: Specify the PA1 key assigned to the Page Up key.
*PA3-KEY: Specify the PA3 key assigned to be the Page Up key.
*CLEAR: Specify the 3270 Clear function assigned to the Page Up key.
*ERASEINP: Specify the 3270 Erase Input function key assigned to the Page Up key.
*CSRSLT: Specify the 3270 Cursor Select Key function key assigned to the Page Up key, and the real Cursor Select Key cannot be used.

PAGEDOWN

Specifies an added function for the Page Down (Roll Up) key on the 5250 keyboard when 3270 device emulation is active. This assignment is in effect when the number is not larger than the maximum number of input fields.
*PA1: The 3270 PA1 function is assigned to the Page Down key.
*NONE: No 3270 function is assigned to the Page Down key. When there are fewer input fields on the display than allowed by the 5250 display device, the Page Down key has no function.
*F-KEY: Specify the 3270 function assigned to the Page Down key.
*PA2-KEY: Specify the PA2 key assigned to the Page Down key.
*PA3-KEY: Specify the PA3 key assigned to be the Page Down key.
*CLEAR: Specify the 3270 Clear function assigned to the Page Down key.
*ERASEINP: Specify the 3270 Erase Input function assigned to the Page Down key.
*CSRSLT: Specify the 3270 Cursor Select Key function assigned to the Page Down key, and the real Cursor Select Key cannot be used.

TESTREQ

Specifies an added function for the Test Request key on the 5250 keyboard when a 3270 device emulation is active.
*DFT: Normal function is assigned to the Test Request key. This is the system default. The normal function is defined in the emulation Help text, and depends on whether the 3270 emulation display device is BSC or SNA. BSC defaults to a 3270 test request function, while SNA defaults to a 3270 system request function.
*CLEAR: The Clear key is assigned to the Test Request key.
*ERASEINP: The Erase Input key is assigned to the Test Request key.

CSRSLT

Specifies a function key to emulate the cursor select key.
*NONE: A physical function key is not assigned to emulate the cursor select key. Instead, the Cursor Select Key defined on the keyboard is used.
*F-KEY: Specify the function key assigned to emulate the Cursor Select Key, and the Cursor Select Key defined on the keyboard cannot be used.

IGCEMLPC

Specifies whether SNA Japanese 3270 PC emulation or 3270 device emulation is used.
*NO: SNA Japanese 3270 PC emulation is not used.
*YES: SNA Japanese 3270 PC emulation is used.

EMLPRTDEV

Specifies the printer device used for SNA Japanese 3270 PC emulation. The printer device is selected after the display device is selected.
*NONE: SNA Japanese 3270 PC emulation with display emulation is not used. No emulation printer device is selected.
*EMLCTL: The first available emulation printer device from the specified emulation controller in the EMLCTL parameter is used.
*EMLLOC: The first available emulation printer device from the specified emulation location in the EMLLOC parameter is used.
emulation-device-description-name: Specify the emulation printer device with the selected emulation display device for SNA Japanese 3270 PC emulation.

INZWAIT

Specifies the first amount of time (in seconds) that the utility waits for the first display from the host system. This parameter only applies to the first read to the host system. If the host system does not send the first display within this time, the emulation session is ended and a message is returned to the requester.
120: The utility waits 120 seconds for the first display from the host system.
*NOMAX: There is no limit on the amount of time the utility 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.
number-of-seconds: Specify the length of time (in seconds) that the utility waits for the first display from the host system. Valid values range from 1 through 32767.

NUMLCK

Specifies whether the numeric input fields allow only numeric data on a 5250 keyboard.
*EMLDEV: Numeric shift lock is specified in the emulation device description in the EMLNUMLCK parameter. The DSPDEVD command can be used to display the current EMLNUMLCK setting for the emulation device.
*NO: Data can be typed in the numeric input fields of a 3270 emulation device.
*YES: Only numeric data can be typed in the numeric input fields of a 3270 emulation device. Numeric data includes characters ranging from 0 through 9, the symbols + - , . and the blank symbol, which is the character b with a slash on the stem.

NULLS

Specifies how beginning and embedded nulls within the 3270 data stream (sent from a 5250 display station) are changed.
*BLANK: Beginning and embedded nulls are changed to blanks before the 3270 data stream is sent to the host system.
*REMOVE: Beginning and embedded nulls are removed before the 3270 data stream is sent to the host system.

LOGON

Specifies the sign-on (logon) text that is sent to the host system after starting SNA 3270 device emulation. This text can be used to sign on a specific host application.
This parameter is not allowed if specified for BSC 3270 display emulation, SNA 3270 display station pass-through, or SNA DBCS 3270PC emulation.
*NONE: No text is sent to the host system after starting 3270 device emulation.
host-logon-command: Specify text that is sent to the host system after starting 3270 device emulation. 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.

WAITRSP

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 400 may be longer than the time recorded by the host when the emulation device does not wait.
*NO: The emulation device does not wait to send a positive response. It sends the response as soon as the data received is sent to the workstation display.
*YES: The emulation device waits until the data received is shown on the workstation display to send a positive response.

ENDCOND

Specifies additional ways in which the SNA 3270 device emulation session can end.
This parameter is not allowed if BSC 3270 display emulation, SNA 3270 display station pass-through, or SNA DBCS 3270PC emulation is specified on the EMLDEV parameter.
*NONE: No additional ways to end 3270 device emulation are requested.
*DACTLU: The 3270 display emulation session ends if it receives an SNA DACTLU command from the host system.
There are certain host system applications that issue a DACTLU (deactivate logical unit) before starting, such as Time Sharing Option (TSO), which ends the 3270 display emulation session before the desired application is accessed. This end condition must be avoided when trying to access these applications.
*UNBIND: The 3270 emulation session ends if it receives an SNA UNBIND from the host system. Consider the following items before selecting this end condition:

This end condition can be used only when accessing one host application for the duration of the session. An UNBIND occurs while switching from one application to the next, and the 3270 session ends before accessing the second application.

This end condition can 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 400 on which the 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 occurs while switching from one system to the next, and the 3270 display emulation session ends before accessing the desired application.

There are certain host system applications that issue an UNBIND before starting, such as Time Sharing Option (TSO), which ends the 3270 display emulation session before the desired application is accessed. This end condition must be avoided when trying to access these applications.

ATNEMLMNU

Specifies whether or not the emulation menu is displayed when the Attn key is pressed.
*YES: The 3270 display emulation menu is displayed when the Attn key is pressed.
*NO: The 3270 display emulation menu is not displayed when the Attn key is pressed.

FKEYPGM

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.
This parameter is not valid if specified for either BSC 3270 display emulation, SNA 3270 display station pass-through, or SNA DBCS 3270PC emulation.

Note: 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 to try again.
The iSeries 400 user-exit program must be coded to allow for input parameters. The following parameters are passed to the program in the specified order:

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.

The display name (10 characters). The name of the display on which the 3270 display emulation session is running. The value is left-justified within the parameter.

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.

Element 1: Program Name
*NONE: A user-exit program is not associated with any function key.
The name of the program can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

program-name: 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.
Element 2: Function Key
*ALLFKEYS: All function keys call the specified user-exit program.
function-key: Specify a function key to call the user-exit program. A maximum of 24 values can be specified on this parameter.

KBDTYPE

Specifies the type of keyboard language used on the display device.
This parameter does not apply when running SNA 3270 display station pass-through.
*DSPDEV: The display device description is used.
*SYSVAL: The value specified in the system value QKBDTYPE is used.
*LCL: The display device that requested 3270 device emulation is a local display device. The keyboard type is determined from the display device description.
*TRNTBL: Allows user-defined translate tables to be used. The character translation is defined in the translation tables specified by the TRNTBLOUT and TRNTBLIN parameters. This value is valid for both local and remote display devices.
keyboard-language-identifier: Specify the 3-character identifier for the language group associated with the remote display requesting 3270 emulation. The identifier consists of 3 characters. The languages and associated identifiers are shown below.
Table 1. Keyboard Mapping

Language/Country or Region Identifier ASCII Device Group

Albania ALI

Arabic X/Basic CLB D

Austria/Germany AGB A, B

Austria/Germany Euro Currency AGE

Austria/Germany Multinational AGI A, B

Belgium Multinational BLI B

Belgium Multinational Euro Currency BLM

Brazilian Portuguese BRB

Brazilian Portuguese Euro Currency BRE

Bulgaria BGB

Canadian French CAB A, B

Canadian French Multinational CAI A, B

Canadian French Multinational Euro Currency CAM

Chinese (Simplified) RCB

Chinese (Traditional) TAB

Croatia YGI

Cyrillic CYB

Czech Republic CSB

Denmark DMB B

Denmark Euro Currency DME

Denmark Multinational DMI B

Estonia ESB

Finland/Sweden FNB B

Finland/Sweden Euro Currency FNE

Finland/Sweden Multinational FNI B

France (Azerty) FAB A, B

France (Azerty) Euro Currency FAE

France (Azerty) Multinational FAI A, B

France (Qwerty) FQB

France (Qwerty) Multinational FQI

Greece ¹ GNB ¹

Hebrew NCB D

Hungary HNB

Iceland ICB

Iceland Euro Currency ICE

Iceland Multinational ICI

International INB

International Multinational INI

Iran (Farsi) IRB

Italy ITB A, B

Italy Euro Currency ITE

Italy Multinational ITI A, B

Japan English JEB

Japan English Multinational JEI

Japan Kanji (for PS/55 and 5295 display stations) JKB

Japan Latin Extended JPB

Japan United States Basic JUB

Japan Katakana (for 5251, 5291, 5292, and 3180 Katakana display stations) KAB

Korea KOB

Latin-2/ROECE ROB

Latvia LVB

Lithuania LTB

FYR Macedonia (Former Yugoslav Republic) MKB

Netherlands NEB

Netherlands Euro Currency NEE

Netherlands Multinational NEI

Norway NWB B

Norway Euro Currency NWE

Norway Multinational NWI B

Poland PLB

Portugal PRB B

Portugal Euro Currency PRE

Portugal Multinational PRI B

Romania RMB

Russia RUB

Serbia (Cyrillic) SQB

Serbia (Latin) YGI

Slovakia SKB

Slovenia YGI

Spain SPB B

Spain Euro Currency SPE

Spain Multinational SPI B

Spanish Speaking SSB B

Spanish Speaking Multinational Euro Currency SSE

Spanish Speaking Multinational SSI B

Sweden SWB B

Sweden Euro Currency SWE

Sweden Multinational SWI B

Switzerland/French Multinational SFI B

Switzerland/French Multinational Euro Currency SFM

Switzerland/German Multinational SGI B

Switzerland/German Multinational Euro Currency SGM

Thai THB

Turkey (Qwerty) TKB

Turkey (F) TRB

Ukraine UAB

United Kingdom UKB A, B

United Kingdom Euro Currency UKE

United Kingdom Multinational UKI A, B

United States/Canada USB A, B, C

United States/Canada Euro Currency USE

United States/Canada Multinational USI A, B, C

Urdu PKB

Vietnam VNB

Languages of the former Yugoslavia YGI

Note:

¹

The GNB code is the current identifier for Greece. The GKB code was used prior to V2R1, and continues to be supported, but provides fewer characters than the recommended GNB code.

Note: For example, KBDTYPE(USB) indicates a keyboard using the basic United States/Canada character set.

TRNTBLOUT

Specifies the outgoing translation table used to translate characters sent from the host system to 3270 emulation. This parameter is valid only when KBDTYPE(*TRNTBL) is specified. Both TRNTBLOUT and TRNTBLIN must be specified if KBDTYPE(*TRNTBL) is specified.
*KBDTYPE: Translation is done using the language specified in the KBDTYPE parameter.
The name of the outgoing translation table can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

user-defined-outgoing-table: Specify the qualified name of the table used for outgoing translation.

TRNTBLIN

Specifies the incoming translation table used to translate characters sent from 3270 emulation to the host system. This parameter is valid only when KBDTYPE(*TRNTBL) is specified. Both TRNTBLOUT and TRNTBLIN must be specified if KBDTYPE(*TRNTBL) is specified.
*KBDTYPE: Translation is done using the language specified in the KBDTYPE parameter.
The name of the incoming translation table can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

user-defined-incoming-table: Specify the qualified name of the table used for incoming translation.

EMLCFGE

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.
*NONE: No configuration entry is named and the configuration entry defaults are used.
QEMDFTCFGE: 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.
configuration-entry-name: 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.

Example for STREML3270
STREML3270 EMLCTL(TSOHOST) PAGEUP(*F7) PAGEDOWN(*F8)

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.
Error messages for STREML3270
*ESCAPE Messages

CPF2619

Table &1 not found.

CPF269A

Library parameter is not set to "QSYS " on call.

CPF269B

T.61 conversion table not found.

CPF85EA

Screen address received from host is larger than screen size.

CPF85EB

3270 device emulation session ended.

CPF85EC

Specifying text on the LOGON parameter is not supported.

CPF85ED

Values other than ENDCOND(*NONE) are not supported.

CPF85E2

3270 display emulation is already active at this job.

CPF85E4

Not authorized to translation table &1 in library &2.

CPF85E5

3270 emulation device &1 is reserved for device &2.

CPF85E6

Translation table &1 in library &2 was not found.

CPF8503

Emulation controller &1 not found.

CPF8504

Controller &1 does not support 3270 emulation.

CPF8505

Emulation device &2 not found.

CPF8506

Emulation location &1 not found.

CPF8507

Display emulation cannot open required file.

CPF8508

Host system did not respond.

CPF851A

Maximum number of shift in and shift out characters exceeded.

CPF8510

Internal error occurred on device &1.

CPF8511

Emulation ended by errors on device &2.

CPF8512

Emulation ended because device &2 was held.

CPF8513

Emulation ended by errors on device &2.

CPF8514

Error recovery stopped on device &1.

CPF8515

3270 emulation session ended by host.

CPF8516

No match between host and device &2.

CPF8517

Received more than maximum number of fields allowed.

CPF8518

Emulation ended because of internal failure in system.

CPF8519

Function check in 3270 emulation.

CPF852A

Values other than FKEYPGM(*NONE) are not supported.

CPF852B

Program &1 not found.

CPF852C

Not authorized to program &1.

CPF8521

Not authorized to controller &1.

CPF8522

Not authorized to emulation device &2.

CPF8523

*NO on the ATNEMLMNU parameter is not supported.

CPF8524

Emulation cannot open its required display file.

CPF8525

KBDTYPE(*LCL) not allowed for remote display devices.

CPF8526

No 3270 display emulation devices available.

CPF8527

Emulation device &2 not available.

CPF8528

Device &2 is not a display emulation device.

CPF8530

Not authorized to use any display emulation device.

CPF8533

Display device not specified in a batch job.

CPF8534

Display device &1 is not available.

CPF8535

Display device &1 not found.

CPF8536

Not authorized to display device &1.

CPF8539

&1 keyboard type not supported by 3270 emulation.

CPF8546

No 3270 display emulation devices available.

CPF8547

No 3270 printer emulation devices available.

CPF8550

Emulation ended due to time-out internal failure.

CPF8551

Emulation ended with error code &1.

CPF8552

Emulation ended because of return code.

CPF8553

BSC controller or device not allowed without translation.

CPF8565

Emulation device &1 not found.

CPF8568

Device &1 not printer emulation device.

CPF8569

Not authorized to use any printer emulation device.

CPF8571

No 3270 printer emulation devices available.

CPF8572

Emulation device &1 not available.

Language/Country or Region	Identifier	ASCII Device Group
Albania	ALI
Arabic X/Basic	CLB	D
Austria/Germany	AGB	A, B
Austria/Germany Euro Currency	AGE
Austria/Germany Multinational	AGI	A, B
Belgium Multinational	BLI	B
Belgium Multinational Euro Currency	BLM
Brazilian Portuguese	BRB
Brazilian Portuguese Euro Currency	BRE
Bulgaria	BGB
Canadian French	CAB	A, B
Canadian French Multinational	CAI	A, B
Canadian French Multinational Euro Currency	CAM
Chinese (Simplified)	RCB
Chinese (Traditional)	TAB
Croatia	YGI
Cyrillic	CYB
Czech Republic	CSB
Denmark	DMB	B
Denmark Euro Currency	DME
Denmark Multinational	DMI	B
Estonia	ESB
Finland/Sweden	FNB	B
Finland/Sweden Euro Currency	FNE
Finland/Sweden Multinational	FNI	B
France (Azerty)	FAB	A, B
France (Azerty) Euro Currency	FAE
France (Azerty) Multinational	FAI	A, B
France (Qwerty)	FQB
France (Qwerty) Multinational	FQI
Greece ¹	GNB ¹
Hebrew	NCB	D
Hungary	HNB
Iceland	ICB
Iceland Euro Currency	ICE
Iceland Multinational	ICI
International	INB
International Multinational	INI
Iran (Farsi)	IRB
Italy	ITB	A, B
Italy Euro Currency	ITE
Italy Multinational	ITI	A, B
Japan English	JEB
Japan English Multinational	JEI
Japan Kanji (for PS/55 and 5295 display stations)	JKB
Japan Latin Extended	JPB
Japan United States Basic	JUB
Japan Katakana (for 5251, 5291, 5292, and 3180 Katakana display stations)	KAB
Korea	KOB
Latin-2/ROECE	ROB
Latvia	LVB
Lithuania	LTB
FYR Macedonia (Former Yugoslav Republic)	MKB
Netherlands	NEB
Netherlands Euro Currency	NEE
Netherlands Multinational	NEI
Norway	NWB	B
Norway Euro Currency	NWE
Norway Multinational	NWI	B
Poland	PLB
Portugal	PRB	B
Portugal Euro Currency	PRE
Portugal Multinational	PRI	B
Romania	RMB
Russia	RUB
Serbia (Cyrillic)	SQB
Serbia (Latin)	YGI
Slovakia	SKB
Slovenia	YGI
Spain	SPB	B
Spain Euro Currency	SPE
Spain Multinational	SPI	B
Spanish Speaking	SSB	B
Spanish Speaking Multinational Euro Currency	SSE
Spanish Speaking Multinational	SSI	B
Sweden	SWB	B
Sweden Euro Currency	SWE
Sweden Multinational	SWI	B
Switzerland/French Multinational	SFI	B
Switzerland/French Multinational Euro Currency	SFM
Switzerland/German Multinational	SGI	B
Switzerland/German Multinational Euro Currency	SGM
Thai	THB
Turkey (Qwerty)	TKB
Turkey (F)	TRB
Ukraine	UAB
United Kingdom	UKB	A, B
United Kingdom Euro Currency	UKE
United Kingdom Multinational	UKI	A, B
United States/Canada	USB	A, B, C
United States/Canada Euro Currency	USE
United States/Canada Multinational	USI	A, B, C
Urdu	PKB
Vietnam	VNB
Languages of the former Yugoslavia	YGI
Note: ¹ The GNB code is the current identifier for Greece. The GKB code was used prior to V2R1, and continues to be supported, but provides fewer characters than the recommended GNB code.