Skip to main content

IBM Software Technical Document

_______________________________________________________________
Hide details for       Document Information Document Information

Document Number:18762910
Functional Area: Print
Subfunctional Area: Network Print from iSeries
Sub-Subfunctional Area: General
OS/400 Release:5.4.5; 6.1; 6.1.1; 7.1; V5R2M0; V5R3M0; V5R3M5; V5R4M0; V5R4M5; V6R1M0; V6R1M1; V7R1M0
Product: I5/OS (5761SS100)
I5/OS PRINT/SPOOL (5761SS1SP)
IBM I (5770SS100)
OS/400 BASE (5722SS100)
OS/400 PRINT/SPOOL (5722SS1SP)
PRINT/SPOOLING (5770SS1SP)
TCP/IP CON UTIL (5722TC100)
TCP/IP CONNECTIVITY UTIL I5OS (5761TC100)
Product Release:N/A


_______________________________________________________________

Document Title
Configuring a *LAN 3812 Device Description that Uses the LPR Print Driver (TSPLPRD) Exit Program

Document Description
Note: This document previously was entitled TSPLPRD LPR Print Driver Exit Program.

This document was last updated on 11 May 2012.




Overview

The LPR Print Driver (TSPLPRD) exit program is an unsupported utility that provides the function of using a *LAN 3812 device description and a printer writer, rather than a Remote Output Queue and a remote writer, to send spooled files to an ASCII printer that is attached to an LPD server or to a Microsoft Windows print queue. This is a similar function to what is provided using remote output queues in IBM OS/400 or IBM i5/OS, especially because it communicates using the Line Printer Requester (LPR) and Line Printer Daemon (LPD) protocols; however, it differs because this driver exit program is specified on a printer device description. Thus, it can make use of information specified about the printer in the device description, which is not available on a remote output queue. Also, because it uses LPR/LPD within a printer writer, it supports page ranges and multiple copies, yet can be used with any printer that currently uses a remote output queue, including dot matrix and line printers.

Note: You can also configure the remote output queue first to ensure that it works, then configure the *LAN 3812 device description with comparable settings. If this method is done, use the Work with OUTQ Description (WRKOUTQD) command to display the settings in the remote output queue and note the values used for the Remote system (RMTSYS), Remote printer queue (RMTPRTQ), Internet address (INTNETADR), Manufacturer type and model (MFRTYPMDL), and Workstation customizing object (WSCST) parameters so you know which values to specify when configuring the *LAN 3812 device description.

For information on the capabilities and limitations of Remote Output Queues (RMTOUTQs) and *LAN 3812 printer device descriptions, refer to the following Rochester Support Center knowledgebase documents:

14143423, Capabilities and Limitations of Remote Output Queues (RMTOUTQs): Database 'Rochester Support Line KnowledgeBase', View 'All Documents\All Software', Document 'Capabilities and Limitations of TCP/IP Remote Output Queues'
412453666, Capabilities and Limitations of *LAN 3812 Printer Device Descriptions: Rochester Support Line KnowledgeBase

To get the TSPLPRD utility, do one of the following:
oIf running 5.3 (V5R3M0 or R530) or 5.4 (V5R4M0 or R540) i5/OS, detach or download the tsplprd-r530.savf file from this document (which file depends on the version of i5/OS), upload it to a save file using an FTP session, and restore the objects from the save file.
oIf running 6.1 (V6R1M0 or R610) or 7.1 (V7R1M0 or R710) i5/OS, detach or download the tsplprd-r610.savf file from this document (which file depends on the version of i5/OS), upload it to a save file using an FTP session, and restore the objects from the save file.

Note: If the tsplprd-r530.savf file is uploaded and restored to a system running 6.1 or 7.1 i5/OS, or if the tsplprd-r530.savf file has been uploaded and restored to a system running V5R3 or V5R4 i5/OS and that system is later upgraded or migrated to 6.1 or 7.1 i5/OS, then the V5R3/V5R4 version of the TSPLPRD utility will need to go through object conversion in order to run on the newer releases. The need for object conversion can be avoided by uploading and restoring the 6.1/7.1 version of the TSPLPRD utility instead.
oGet the source code from the QUSRTOOL library on an R440 or later OS/400, and compile the source code using the ILE C/400 compiler (ILE C/400 is product 5769CX2 in R4xx and product 5716CX2 in R370).
oCall the Rochester Support Center at 1-800-IBM-SERV, select the appropriate option and ask about opening a consulting agreement PMR to do a remote signon, then have the appropriate version of the TSPLPRD save file sent to you.
oNote: The save files for V5R2 (R520) OS/400 and below (tsplprd-r520.savf, tsplprd-r510.savf and tsplprd-r410.savf) have been removed from this document because these versions are no longer supported. However, they are available in an internal document so if one of the older save files are needed, please contact the Rochester Support Center representation or a World Trade support represent.
Technical Support

The LPR Print Driver (TSPLPRD) exit program, and the Set Remote Print Queue (SETRMTPQ) command, are not supported by the Rochester Support Center through Support Line. The TSPLPRD exit program is an unsupported utility that provides the function of sending spooled files from an output queue to an ASCII printer that is attached to an LPD server. The Rochester Support Center can provide assistance with restoring the TSPLPRD utility to an operating system, with configuring a *LAN 3812 device description that uses the TSPLPRD exit program, or with using the Set Remote Print Queue (SETRMTPQ) command, but will not provide assistance with potential defects in the TSPLPRD utility itself.




This exit program also serves the purpose of providing an example of a Print Driver Exit because it is written to the Print Driver Exit interface as documented in the AS/400 System API Reference manual.

This exit program was introduced in the R440 version of QUSRTOOL, but will work with R410 and later versions of the operating system. This tool is supplied as is without support. Therefore, any assistance with configuring or using a printer device description that uses an LPR print driver exit program must be done through a consulting agreement.

Note: The TSPLPRD utility uses includes that are shipped with Licensed Program 57xxSS1 Product Option 13 (System Openness Includes) installed. This product is required to be installed if compiling the TSPLPRD source code that is shipped with the QUSRTOOL library, but it is not required to have this product installed if using the TSPLPRD utility from one of the attached save files.




Show details for Getting the LPR Print Driver Exit Program (TSPLPRD) Utility from one of the Attached Save FilesGetting the LPR Print Driver Exit Program (TSPLPRD) Utility from one of the Attached Save Files
Show details for Getting the LPR Print Driver Exit Program (TSPLPRD) Utility from the QUSRTOOL LibraryGetting the LPR Print Driver Exit Program (TSPLPRD) Utility from the QUSRTOOL Library
Show details for Limitations of the LPR Print Driver Exit Program (TSPLPRD) UtilityLimitations of the LPR Print Driver Exit Program (TSPLPRD) Utility
Show details for Configuration InstructionsConfiguration Instructions
Show details for Configuration Example for a Continuous Form PrinterConfiguration Example for a Continuous Form Printer
Show details for Configuration Example for a Cut-Sheet PrinterConfiguration Example for a Cut-Sheet Printer
Show details for Using the SETRMTPQ Command to Specify the Remote Printer Queue or LPR Queue NameUsing the SETRMTPQ Command to Specify the Remote Printer Queue or LPR Queue Name
Show details for Creating Additional *LAN 3812 Device Descriptions that Use the TSPLPRD UtilityCreating Additional *LAN 3812 Device Descriptions that Use the TSPLPRD Utility
Show details for Specifying LPR Filters in the User-defined options (USRDFNOPT) Parameter in the Printer Device DescriptionSpecifying LPR Filters in the User-defined options (USRDFNOPT) Parameter in the Printer Device Description



__________________________________________________________________
PMR Number:
Related APARs:
Related Public Documents:
17690939, Information on Printers from Various Manufacturers: Database 'AS400 Support Line KnowledgeBase', View 'Personal Views\Documents Needing Your Attention', Document 'Support for Various Printers in Host Print Transform (HPT), PC5250, etc...'
8233537, Recommended Remote Printer Queue Values for Remote Output Queues (RMTOUTQs): Database 'AS400 Support Line KnowledgeBase', View 'Print\Network Attached Printers', Document 'TCP/IP LPR/LPD Printing with Recommended RMTPRTQ Values'
14143423: Capabilities and Limitations of Remote Output Queues (RMTOUTQs) Database 'Rochester Support Line KnowledgeBase', View 'All Documents\All Software', Document 'Capabilities and Limitations of TCP/IP Remote Output Queues'
412453666: Capabilities and Limitations of *LAN 3812 Printer Device Descriptions Rochester Support Line KnowledgeBase

    IBM disclaims all warranties, whether express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. By furnishing this document, IBM grants no licenses to any related patents or copyrights. Copyright © 1996,1997,1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012 IBM Corporation. Any trademarks and product or brand names referenced in this document are the property of their respective owners. Consult the Terms of use link for trademark information.