Specifying Destination-Dependent Options for RMTOUTQs or the SNDTCPSPLF/LPR Command

Resolving The Problem

This document provides information on the destination dependent options available when printing using the LPR/LPD (Line Printer Requester/Line Printer Daemon) protocol. This includes options specified through the Destination options (DESTOPT) parameter in a Remote Output Queue (RMTOUTQ) or through the Destination-dependent options (DESTOPT) parameter when using the Send TCP/IP Spooled File (SNDTCPSPLF or LPR) command.

This document was last updated on 3 November 2011.

---

The destination dependent options are used to add lines to the control file which specify parameters that are unique to the target LPD print server. Without this option, the control file contains only commands that should apply to any LPD server.

Multiple options may be specified, delimited by blanks (no blanks may be imbedded in an option). Each valid option is entered as a line of ASCII text in the control file, terminated by a line feed. The validity of an option is determined by its first character.

LPD Control File Lines supported by i5/OS

The following LPD control file lines are used by i5/OS. Most of these are not supported in the DESTOPT parameter, in which case a warning message will be issued.

C	Class for banner page According to RFC 1179, this command sets the class name to be printed on the banner page. i5/OS uses the "C" command to send the IP address of the interface that is sending the print job. For example: C192.168.1.15 Note: i5/OS does not allow this command to be overridden on the DESTOPT parameter.
H	Host name According to RFC 1179, this command specifies the name of the host which is to be treated as the source of the print job. i5/OS uses the "H" command to send the host name of the IBM i system sending the print job. For example: HS1012345.MYCOMPANY.COM Note: i5/OS does not allow this command to be overridden on the DESTOPT parameter.
J	Job name for banner page According to RFC 1179, this command sets the job name to be printed on the banner page. i5/OS uses the "J" command to send the name of the spooled file. For example: JQPJOBLOG but does allow this to be overridden by the DESTOPT parameter in either a Remote Output Queue (RMTOUTQ) or the Send TCP/IP Spooled File (SNDTCPSPLF or LPR) command. If specified, whatever characters follow the J are taken as the job name. For example: SNDTCPSPLF ... DESTOPT('Jnewjobname')
L	Print banner page According to RFC 1179, this command causes the banner page to be printed. The user name can be specified or omitted on this command. i5/OS uses this to request the printer or print server to print the banner page, dependent on the setting of the Print separator page (SEPPAGE) parameter, but includes the user name. For example: LQSECOFR Note: i5/OS does not allow this command to be overridden on the DESTOPT parameter.
N	Name of source file According to RFC 1179, this command specifies the name of the file from which the data file was constructed. i5/OS uses the "J" command to send the name of the spooled file. For example: NQPJOBLOG Note: i5/OS does not allow this command to be overridden on the DESTOPT parameter.
P	User identification According to RFC 1179, this command specified the user idenfication of the entity requesting the print job. i5/OS uses the "P" command to send the name of the user profile that was used to generate the spooled file. For example: PQSECOFR Note: i5/OS does not allow this command to be overridden on the DESTOPT parameter.
U	Unlink data file According to RFC 1179, this command indicates that the specified file is no longer needed. i5/OS uses the "U" command to indicate the end of the Control File information. Note: i5/OS does not allow this command to be overridden on the DESTOPT parameter.

LPD Control File Lines not supported by i5/OS

The following LPD control file lines are not used by i5/OS and are not supported in the DESTOPT parameter. Any use of these options in the DESTOPT parameter will be ignored, and a warning message will be issued.

I	Indent Printing Note: i5/OS does not issue this command, and does not allow this command to be specified on the DESTOPT parameter.
M	Mail When Printed Note: i5/OS does not issue this command, and does not allow this command to be specified on the DESTOPT parameter.
S	Symbolic link data Note: i5/OS does not issue this command, and does not allow this command to be specified on the DESTOPT parameter.
T	Title for pr Note: i5/OS does not issue this command, and does not allow this command to be specified on the DESTOPT parameter.
W	Width of output Note: i5/OS does not issue this command, and does not allow this command to be specified on the DESTOPT parameter.
1	troff R font Note: i5/OS does not issue this command, and does not allow this command to be specified on the DESTOPT parameter.
2	troff I font Note: i5/OS does not issue this command, and does not allow this command to be specified on the DESTOPT parameter.
3	troff B font Note: i5/OS does not issue this command, and does not allow this command to be specified on the DESTOPT parameter.
4	troff S font Note: i5/OS does not issue this command, and does not allow this command to be specified on the DESTOPT parameter.
k	Reserved for use by Kerberized LPR clients and servers Note: i5/OS does not issue this command, and does not allow this command to be specified on the DESTOPT parameter.

LPD Print Filter Commands

The following LPD Control File lines are actually print filter commands. By default, i5/OS will issue the 'l' commands, but if any of these filters are specified in the DESTOPT parameter then the first one specified will be passed on to the printer or LPD server.

c	CIF (CalTech Intermediate Form) graphics language
d	DVI output
f	plain text file
g	Berkeley UNIX plot file
l	leave control characters in file
n	ditroff (device-independent troff) output;
p	print with 'pr' format (pagination)
r	print with FORTRAN carriage control
t	UNIX troff output
v	print verbatim with no additional processing

For More Information

For more information, refer to Section 7. Control file lines in RFC 1179, Line Printer Daemon Protocol, which is available online at:

http://www.ietf.org/rfc/rfc1179.txt