ENDPRTEML (End Printer Emulation)

ENDPRTEML Command syntax diagram

 

Purpose

The End Printer Emulation (ENDPRTEML) command ends printer emulation without ending the job. If there is another request in the job, that request is then processed.

This command closes the file to the host system, and then writes the last data received from the host system to the spooled file or printer by closing the printer file.

In some cases, the request does not take effect immediately. The request is delayed while any of the following conditions exist in the printer emulation request:

• Printing a block sent from the host system.
• Waiting for a printer error to be cleared (for example, a paper jam).
• Waiting for a reply to a PA1 or PA2 inquiry message.
• Waiting for error recovery to be done to the host system or printer device.
• The job has been held by using the HLDJOB command. When the condition is cleared, the End Printer Emulation request takes effect, and the printer emulation request ends.

 

Required Parameters

EMLDEV

Specifies the name of the printer emulation device requested to receive data from the host system. The printer emulation job using this device is informed of the request and closes the printer file. This forces all of the data received from the host system to the spooled file or printer. The printer file is then reopened and printer emulation continues. To use this function, the user must be authorized to the device.

EMLLOC

Specifies the remote location name associated with this session. This name is defined during configuration and refers to the remote location where communication takes place. This value was specified on the Start Printer Emulation (STRPRTEML) command.

PRTDEV

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

Example for ENDPRTEML

ENDPRTEML   EMLDEV(HOSTPRT3)

This command ends the printer emulation request that is using the device HOSTPRT3.

Error messages for ENDPRTEML

*ESCAPE Messages

CPF8599

End printer emulation function not performed.