Change Configuration Entry (CHGEMLCFGE)

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.

You also can prompt on this command to display existing values for an emulation session without making a change.

Parameters

Keyword	Description	Choices	Notes
EMLCFGE	Configuration entry	Name, QEMDFTCFGE	Required, Key, Positional 1
EMLDBGJOB	Debug job	SAME, NOTRACE, *TRACE	Optional
EMLSIG	Handle signals	SAME, SAVE, *IGNORE	Optional
EMLATR	Handle attributes	SAME, IGNORE, *REJECT	Optional
EMLMAXSCR	Maximum screen size	SAME, DEVD, MOD2, MOD5	Optional
EMLTRC	VLIC trace	SAME, NOTRACE, *TRACE	Optional
EMLSTR	Start printer TRCJOB	SAME, NOTRACE, *TRACE	Optional
EMLINLSCN	Initial screen	SAME, YES, *NO	Optional
EMLGRDLIN	Gridline	SAME, NO, *YES	Optional
EMLDBCS	Graphic DBCS	SAME, NO, *YES	Optional
EMLPRTFMT	Printout formatting	SAME, NO, *YES	Optional
EMLSNACLR	Clear processing	SAME, RETRY, *IGNORE	Optional
EMLBUF	Gridline Buffer	SAME, FRONT, *BACK	Optional
EMLVLG	Conditional vlog generated	SAME, NO, *YES	Optional
EMLSCS	Handle SCS command errors	SAME, NO, *YES	Optional
EMLNML	Enforce 5250 Numeric Lock	SAME, NO, *YES	Optional
EMLMSG	Send SNA Unbind message	SAME, NO, *YES	Optional

Top

Configuration entry (EMLCFGE)

Specifies the name of the existing emulation configuration entry that you are changing.

This is a required parameter.

QEMDFTCFGE: The default configuration entry for 3270 emulation sessions is changed.
configuration-entry-name: Specify the name of the configuration entry to be changed.

Debug job (EMLDBGJOB)

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.

*SAME: The value does not change.
*NOTRACE: The printer data stream is not traced in the TRCJOB output.
*TRACE: The printer data stream is traced in the TRCJOB output.

Handle signals (EMLSIG)

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).

*SAME: The value does not change.
*SAVE: 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.
*IGNORE: The emulation job does not grant the host permission to send.

Handle attributes (EMLATR)

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 character attribute is a set attribute instruction (SA order) and an attribute value is a value on which the instruction operates (value).

*SAME: The value does not change.
*IGNORE: The emulation job ignores the incorrect value.
*REJECT: The emulation job sends a negative response to the data stream containing the incorrect character attribute or attribute value.

Maximum screen size (EMLMAXSCR)

Specifies the maximum size of the image to be shown on the display screen.

*SAME: The value does not change.
*DEVD: The maximum size is whatever the device can support.
*MOD2: The maximum size is 24 rows by 80 columns.
*MOD5: The maximum size is 27 rows by 132 columns.
Note: If the device does not support 27 rows by 132 columns, the maximum size defaults to 24 rows by 80 columns.

VLIC trace (EMLTRC)

Specifies whether Licensed Internal Code (LIC) data stream translation trace points are issued when the following are true:

The job is using the data stream translation API (application program interface).
The Trace Job (TRCJOB) command is running on the job using the data stream translation API.
A LIC source/sink trace is also running.

*SAME: The value does not change.
*NOTRACE: Data stream translation trace points are not issued.
*TRACE: Data stream translation trace points are issued.

Start printer TRCJOB (EMLSTR)

Specifies whether to call the Trace Job (TRCJOB) command when a printer emulation job is started.

*SAME: The value does not change.
*NOTRACE: The TRCJOB command is not called.
*TRACE: The TRCJOB command is called.

Initial screen (EMLINLSCN)

Specifies whether to show the Emulation Initialization In Progress display when a 3270 device emulation session is starting.

*SAME: The value does not change.
*YES: The display is shown.
*NO: The display is not shown.

Gridline (EMLGRDLIN)

Specifies whether to suppress field outlining from showing on the display.

*SAME: The value does not change.
*NO: Field outlining is not suppressed.
*YES: Field outlining is suppressed.

Graphic DBCS (EMLDBCS)

Specifies whether to support the DBCS-graphic character string for input fields.

Note: 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.

*SAME: The value does not change.
*NO: The DBCS-graphic character string is not supported.
*YES: The DBCS-graphic character string is supported.

Printout formatting. (EMLPRTFMT)

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.

Note: This parameter is valid only for SNA character string (SCS) printer sessions.

*SAME: The value does not change.
*NO: The STRPRTEML command values for lines and columns are not used.
*YES: The STRPRTEML command values for lines and columns are used.
Note: The STRPRTEML command values remain in effect until a set horizontal format or a set vertical format command is received from the host.

Clear processing (EMLSNACLR)

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.

Note: This parameter is valid only for display emulation sessions.

*SAME: The value does not change.
*RETRY: The emulation job tries again to get the data.
*IGNORE: The emulation job does not try again to get the data.

Gridline Buffer (EMLBUF)

Specifies whether the foreground or background buffer is used when base gridlines are displayed. This parameter does not apply when strategic gridlines are used.

*SAME: The value does not change.
*FRONT: The foreground buffer is used.
*BACK: The background buffer is used.

Conditional vlog generated (EMLVLG)

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.

*SAME: The value does not change.

*NO: The VLIC log is not generated.
*YES: The VLIC log is generated. The emulation session continues.

Handle SCS command errors (EMLSCS)

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.

*SAME: The value does not change.

*NO: The architecture is followed. Page size is one line.
*YES: The architecture is not followed, page size and width default to values entered on the start printer emulation (STRPRTEML) command.

Enforce 5250 Numeric Lock (EMLNML)

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).

*SAME: The value does not change.

*NO: 5250 Numeric Lock is not enforced.
*YES: 5250 Numeric Lock is enforced.

Send SNA Unbind message (EMLMSG)

Specifies whether to display a message on the screen when an unbind has been received.

*SAME: The value does not change.

*NO: No message is displayed.
*YES: Message is displayed.

Examples

CHGEMLCFGE   EMLCFGE(ARTSDEPT)  EMLMAXSCR(*DEVD)
             EMLGRDLIN(*NO)

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.