CHGEMLCFGE (Change Emulation Configuration Entry)

CHGEMLCFGE Command syntax diagram

 

Purpose

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.

 

Required Parameters

EMLCFGE

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

QEMDFTCFGE: The default configuration entry for 3270 emulation sessions is changed.

configuration-entry-name: Specify the name of the configuration entry to be changed.

 

Optional Parameters

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.

EMLSIG

Specifies how an iSeries 400 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.

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.

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.

EMLTRC

Specifies whether VLIC (Vertical Licensed Internal Code) 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. The TRCJOB was started before the first call to the API for that session.
  
• The value for EMLTRC was specified on the QEMDFTCFGE emulation configuration entry.
  
• A VLIC 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.

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.

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.

EMLGRDLIN

Specifies whether to suppress gridlines from showing on the display.

Note:

This parameter does not apply when strategic gridlines are used.

*SAME: The value does not change.

*NO: Gridlines are not suppressed.

*YES: Gridlines are suppressed.

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.

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.

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.

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.

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

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.

Example for CHGEMLCFGE

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.

Error messages for CHGEMLCFGE

*ESCAPE Messages

CPF853E

Emulation configuration entry &1 not found.

CPF854B

Internal error in emulation configuration routines.