End Printer Emulation (ENDPRTEML)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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, then writes the last data received from the host system out 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.
| Top |
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 |
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
Examples
ENDPRTEML EMLDEV(HOSTPRT3)
This command ends the printer emulation request that is using the device HOSTPRT3.
| Top |
| Top |