Emulate Printer Keys (EMLPRTKEY)

The Emulate Printer Key (EMLPRTKEY) command causes the printer emulation job or session that is using the specified printer emulation device to send either a PA1 or PA2 key signal to the host system.

PA keys are program access keys that are used to signal the host system. The host system program determines how these keys work. This command can only be used on 3287 or 3289 emulated printers operating as an LU type 1 session. In addition, the PA key signal, although sent to the host system, may not immediately be received.

Parameters

Keyword Description Choices Notes
EMLDEV Emulation device, or Name Optional, Positional 1
EMLLOC Emulation location Communications name Optional, Positional 2
PRTDEV Print device Name Optional, Positional 3
PRTKEY Emulated printer key *PA1, *PA2 Optional

Emulation device (EMLDEV)

Specifies the name of a printer emulation device that receives data from the host system. This device must be a 3287 Printer (EMLDEV(3287)) or a 3289 Printer (EMLDEV(3289)), and must currently be operating as an LU1 unit. The printer emulation job or session that is using this device will be informed of the request. If the LU1 session is between brackets, printer emulation starts a bracket and sends the PA key signal to the host system with a Change Direction (CD) request. If the LU session is in receive condition, a signal (request for CD) is sent to the host system, and printer emulation waits for the CD. When the CD is received, the PA key signal is sent to the host system with the CD. If the LU session is in send condition, the PA key signal is sent to the host system with the CD.

Either this parameter, or the Emulation location (EMLLOC) parameter and the Print device (PRTDEV) parameter is required.

Emulation location (EMLLOC)

Specifies the remote location name associated with this session. The location name is defined during device description configuration and refers to the remote location where communication takes place. This value must be the same as the value specified for the Emulation location (EMLLOC) parameter on the Start Printer Emulation (STRPRTEML) command.

Either this parameter and the Print device (PRTDEV) parameter, or the Emulation device (EMLDEV) parameter is required.

Print device (PRTDEV)

Specifies the name of a printer device that is used to print the spooled output. This value must be the same as the value specified for the Printer device (PRTDEV) parameter on the Start Printer Emulation (STRPRTEML) command. This parameter must be specified when the EMLLOC parameter is specified.

Either this parameter and the Emulation location (EMLLOC) parameter, or the Emulation device (EMLDEV) parameter is required.

Emulated printer key (PRTKEY)

Specifies the PA key signal that is sent to the host system. The host system program determines how these keys work.

*PA1
The PA1 key signal is sent to the host system.
*PA2
The PA2 key signal is sent to the host system.

Examples

EMLPRTKEY   EMLDEV(HOSTPRT2)  PRTKEY(*PA2)

This command causes the printer emulation session using emulation device HOSTPRT2 to send the PA2 key signal to the host system.

Error messages

*ESCAPE Messages

CPF8598
Emulate print key function not performed.