October 2001 701P37503 Xerox Document Services Platform Using the lpr Utilities for DOS and UNIX
Prepared by: Xerox Corporation Global Knowledge and Language Services 800 Philips Road Bldg. 845-17S Webster, New York 14580 USA ©2001 by Xerox Corporation. All rights reserved. Copyright protection claimed includes all forms and matters of copyrightable material and information now allowed by statutory judicial law or hereinafter granted, including without limitation, material generated from the software programs displayed on the screen such as icons, screen displays, or looks.
Table of Contents Introduction 1 About this guide Contents 1 Conventions 2 Related Xerox Document Services Platform (DocuSP) documentation Additional client documentation 1.
TABLE OF CONTENTS iv The options 4-1 Example 4-2 USING THE LPR UTILITIES FOR DOS AND UNIX
TABLE OF CONTENTS USING THE LPR UTILITIES FOR DOS AND UNIX v
TABLE OF CONTENTS vi USING THE LPR UTILITIES FOR DOS AND UNIX
Introduction Using the lpr Utilities for DOS and UNIX explains the enhanced options for submitting a document to a Xerox printer using the lpr utilities in DOS or UNIX. About this guide Before you perform any procedures in this guide, you should become familiar with its contents and conventions. You should know how to create a document in a software application on your workstation and should be familiar with the options available to you for printing.
Introduction Using the lpr Utilities for DOS and UNIX Conventions This guide uses the following conventions: • All caps and angle brackets–Within procedures, the names of keys are shown in all caps within angle brackets (for example, press ). • Angle brackets–Variable information, or the position of a specified argument in the command syntax, appears in angle brackets (for example, List Fonts ).
Using the lpr Utilities for DOS and UNIX Introduction Related Xerox Document Services Platform (DocuSP) documentation Using the lpr Utilities for DOS and Unix Using the lp Utilities for Solaris Using the Xerox Client Software for Solaris Preparing and printing PDF files System Guide Any documentation delivered with the Xerox printer.
Introduction 4 Using the lpr Utilities for DOS and UNIX
1. Installation This chapter contains the procedures to install and enable the lpr utilities for DOS and SunOS 4.1.3 or higher. Print submission requirements To allow non-root user command line clients to submit jobs, the DocuSP controller needs three pieces of information in its database: • The users must be listed in the password database on the DocuSP controller. Use the User option from the admintool application to add new users.
Installation Using the lpr Utilities for DOS and UNIX Native lpr printing protocol for DOS This section describes the procedures for configuration of the client workstation and the DocuSP controller to enable native lpr printing. Workstation requirements The workstation must meet the following hardware and software requirements: Hardware requirements • 486 CPU or greater • 4 MBytes RAM Software requirements • DOS 5.
Using the lpr Utilities for DOS and UNIX Installation PathWay Access Submitting documents from a PC to a queue on the DocuSP controller will involve the following: 1. The hostname and IP address for the DocuSP controller need to be defined in the HOSTS file. 2. When submitting or setting up the redirection, the DocuSP controller hostname and queue name need to be specified. The DOS command line mechanism can be tested as per the following example: CD \PATHWAY LPR -S printsrv -P proofqueue C:\AUTOEXEC.
Installation Using the lpr Utilities for DOS and UNIX Native lpr printing protocol for SunOS 4.1.3 This section describes the procedures for configuration of the client workstation and the DocuSP controller to enable native lpr printing. Workstation requirements The workstation must meet the following hardware and software requirements: Hardware requirements • Sun workstation Software requirements • SunOS 4.1.
Using the lpr Utilities for DOS and UNIX Installation 4. Verify connectivity to the DocuSP controller by entering the following command: ping printsrv If your machine can see the DocuSP controller from the net you will see: printsrv is alive 5. Add an entry for each queue to the /etc/printcap file similar to the following example: proofqueue:\ :lp=:\ :rm=printsrv:\ :rp=proofqueue:\ :mx#0:\ :sd=/var/spool/lpd/printsrv/ proofqueue: proofqueue: the local client name for the remote queue.
Installation Using the lpr Utilities for DOS and UNIX Verify installation To test this setup at the client, perform the following steps: 1. Check the status of the queues to verify that queuing and printing are enabled. This can be done using the following command: lpc stat proofqueue The following information is displayed: Figure 1-1. Queue status 2. Submit a job by entering the following command: lpr -P proofqueue /etc/printcap 3.
Using the lpr Utilities for DOS and UNIX Installation Setting the default queue The system administrator can specify one of the printing queues as the default by specifying the primary name as lp in the printcap file: lp|proofqueue:\ :lp=:\ :rm=printsrv:\ :rp=proofqueue:\ :mx#0:\ :sd=/var/spool/lpd/printsrv/ proofqueue: or the secondary name: proofqueue|lp:\ :lp=:\ :rm=printsrv:\ :rp=proofqueue:\ :mx#0:\ :sd=/var/spool/lpd/printsrv/ proofqueue: 1-7
Installation 1-8 Using the lpr Utilities for DOS and UNIX
2. Using the lpr utilities Use the lpr command to send a document file to the Xerox printer. Network communication options Not all of the commands described in this chapter will be available to you, depending upon the type of network protocol software installed on your DOS workstation. Refer to the documentation you received with your software for more information. Printing hierarchy When submitting documents to the printer, keep in mind the following hierarchy to achieve the desired results: 1.
Using the lpr utilities Using the lpr Utilities for DOS and UNIX The lpr command syntax and options This section gives the syntax for the lpr command, and lists the required and optional information you use to submit a print job. Syntax Required Information lpr –P –P Identify the queue to send the jobs to. Specify the names of the files to print. You must include any filename extension when you type the filename.
Using the lpr Utilities for DOS and UNIX Using the lpr utilities Account number –C"(account=)" Specify an account number for the job. Banner page text –C"() text" The text entered will be printed on the banner page when the job is printed. You may type up to a maximum of 100 characters. If the lpr command includes printing options, the format is: -C"(print options) banner page text". Control characters override –f Override any "Control-" characters in your document that could interrupt printing.
Using the lpr utilities Using the lpr Utilities for DOS and UNIX Finishing options - stitch -C”(stitch | staple=
Using the lpr Utilities for DOS and UNIX Using the lpr utilities Image shift – y –C"(yshift=<#>)" Specify the y (vertical for portrait page) image shift in millimeters. The value of # must be a positive value greater than zero. The point of origin is the lower left corner of the portrait page. –C"(yshift2=<#>)" If your printing requirements include duplex or tumble duplex, you can select an independent vertical image shift for both side 1 and side 2.
Using the lpr utilities Using the lpr Utilities for DOS and UNIX The modulus is the number of different items in a set, for example precut tabs or rainbow paper, before the set repeats. For example, a set of 5 precut tabs has a modulus of 5. • Paper color = white, clear, yellow, pink, blue, green, or a text string excluding the colon and comma for a custom color. The carat character (^) is not required for a custom color string using spaces in this media option.
Using the lpr Utilities for DOS and UNIX Using the lpr utilities –C"(mediaWeight=)" Specify the paper stock weight in grams per square meter (gsm). Paper stock size –C"()" Specify the paper stock size to be used for the job. The acceptable values are USLetter, USLegal, USLedger, a0 through a10, isob0 through isob10, and jisb0 through jisb10.
Using the lpr utilities Using the lpr Utilities for DOS and UNIX Save –C"(print|save)" Save the specified job. Print is the default option and only needs to be specified if the job is being submitted to a save queue. –C"(savedest=)" Specify the save location of the job relative to the save location set at the DocuSP controller.
Using the lpr Utilities for DOS and UNIX Using the lpr utilities Uncollated -C"(uncollate)" Will print the job uncollated. If this option is not used, the job will print collated. ASCII options for the lpr command The following options are valid for ASCII jobs only: Font –C”(font=)” Specify the font to use. Any fonts installed on the DocuSP controller can be specified. Font size –C"(fontsize=)" Specify the font size in points. Orientation –C"()" Specify the page orientation to use.
Using the lpr utilities 2-10 Using the lpr Utilities for DOS and UNIX
3. Print queue status The lpq command is used to show the contents of the DocuSP controller queues. The lpq command syntax and options Refer to the man pages for further information on other options available with the lpq command. The options are case-sensitive. More than one option may be entered at one time.
Print queue status Using the lpr Utilities for DOS and UNIX Host name –I (upper case i) Include the host name from where the job originated when the queue information is displayed. Job number Report the status of a job with the specified job number. Periodic display + Clear the terminal screen and display the queue contents periodically. If an interval is included in the option, the lpq utility will wait that interval in seconds between reports.
4. Remove a print job from the queue The lprm command is used to remove a print job from the print queue. The lprm command syntax and options If no options are specified for the lprm command, the command will remove all active jobs with your user name. Syntax lprm –P NOTE: The lprm command will only work with jobs that have not been sent to the printer. Required information –P Identify the print queue where the job was sent.
Remove a print job from the queue Using the lpr Utilities for DOS and UNIX User name Remove the job with the specified user name. Example The following example shows removal of all jobs submitted by orilee to the print queue “rushmore”: lpq -P rushmore Figure 4-1. Job queue listing lprm -P rushmore orilee lpq -P rushmore Figure 4-2.
