October 2001 701P37502 Xerox Document Services Platform Using the lp Utilities for Solaris
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 1. Contents 1 Conventions 2 Related Xerox Document Services Platform (DocuSP) documentation 3 Additional client documentation 3 Installation 1-1 Native lp printing protocol for Sun Solaris 2.3 and higher 2. 3. 1-1 Workstation requirements 1-1 Installation 1-2 Using lp with Solaris 2.6 1-3 Verify installation 1-5 Using the lp utilities 2-1 Printing hierarchy 2-1 The lp command syntax and options 2-2 Using lp with Solaris 2.
TABLE OF CONTENTS ii USING THE LP UTILITIES FOR SOLARIS
Introduction Using the lp Utilities for Solaris provides you with the enhanced options for submitting a document to a Xerox printer using the lp utilities on a workstation running Solaris 2.x software. 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 lp Utilities for Solaris 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 lp Utilities for Solaris 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 lp Utilities for Solaris
1. Installation This chapter describes the procedures for configuration of the client workstation and the DocuSP controller to enable native lp printing. Native lp printing protocol for Sun Solaris 2.3 and higher Workstation requirements The workstation must meet the following hardware and software requirements: Hardware requirements • Sun workstation Software requirements • Solaris 2.
Installation Using the lp Utilities for Solaris Installation NOTE: Refer to the on-line man pages for additional information about the Unix commands used in the following procedure. To configure the client workstation, perform the following steps: 1. Obtain the list of DocuSP controller queues that will be accessed from this client workstation. 2. Log in as root at the client workstation.
Using the lp Utilities for Solaris Installation ping printsrv If your machine can see the DocuSP controller from the net you will see: printsrv is alive 15. Repeat the steps to add a printer for each additional queue. Using lp with Solaris 2.6 Sun Microsystems has discontinued support for the System V Print Protocol in Solaris 2.6. In order to use the lp utilities to print to the DocuSP controller running Solaris 2.
Installation Using the lp Utilities for Solaris On a Solaris 2.5.1 or earlier client The –o options are ignored when using lp on a Solaris 2.5.1 or earlier client and submitting jobs to the controller. To correct this, perform the following on the client workstation: 1. Open a command tool and enter the following: lpsystem -l This will list all the remote printers and the associated lp properties that have been created on the Solaris 2.5.1 client workstation.
Using the lp Utilities for Solaris Installation lpshut This will shut down the lp print service on the DocuSP controller. 5. Then restart the lp print service by entering the following: /usr/lib/lpsched Verify installation To test this setup at the client, perform the following steps: 1. Log in as a non-root user. The following examples use cdoc as the user account name. 2. Check the status of the queues to verify that queuing and printing are enabled.
Installation 1-6 Using the lp Utilities for Solaris
2. Using the lp utilities The lp command is used to send a document file to the Xerox printer. Printing hierarchy When submitting documents to the printer, keep in mind the following hierarchy to achieve the desired results: 1. Queue overrides 2. Exception pages 3. Job ticket settings 4. Submission print protocol (lp, lpr, nprint) 5. Setpagedevice values/PCL copy count 6.
Using the lp utilities Using the lp Utilities for Solaris The lp command syntax and options This section gives the syntax for the lp command, and lists the required and optional information you use to submit a print job. Syntax Required Information lp –d –d Identify the queue where you want to send the jobs. Specify the names of the files to print. You must include any filename extension when you type the filename.
Using the lp Utilities for Solaris Using the lp utilities Using the lp options In addition to the required information, you can use the options listed in this section to specify the print characteristics of the document. Some options may not be appropriate for every printer; for example, some printers do not perform binding or cannot accept precut tabs. If more than one option is set using –o, the options must be enclosed in double quotes and separated by a space.
Using the lp utilities Using the lp Utilities for Solaris Document name –t Replace the name of the specified file. Finishing options - bind -o bind= Bind the document after it is printed. To use this option, the selected printer must have a binder installed and enabled. Finishing options - stitch -o staple | stitch=
Using the lp Utilities for Solaris Using the lp utilities Image shift – x –o xshift=<#> Specify the x (horizontal 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. –o xshift2=<#> If your printing requirements include duplex or tumble duplex, you can select an independent horizontal image shift for both side 1 and side 2.
Using the lp utilities Using the lp Utilities for Solaris Paper stock –o media=size:type:color:weight Define the following options in order: • Paper size = USLetter, USLegal, Tabloid, USLedger, USStatement, a0 through a10, isob0 through isob10, jisb0 through jisb10, or custom where a custom size is entered as width (x) and length (y) in either inches or millimeters. See the example below.
Using the lp Utilities for Solaris Using the lp utilities Specify the media type. Type options are the same as the type options given above. –o mediaSize= Specify the paper stock size. Size options are the same as the paper size options given above. –o mediaColor= Specify the paper color. Color options are the same as the color options given above. If a custom color text string requires spaces, the string must be enclosed with the carat character (^).
Using the lp utilities Using the lp Utilities for Solaris Save –o 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. –o savedest= Specify the save location of the job relative to the save location set at the DocuSP controller.
Using the lp Utilities for Solaris Using the lp utilities Uncollated –o uncollate This option will print the job uncollated. The default is collated. ASCII options for the lp command The following options are valid for ASCII jobs only: Font –o font= Specify the font to use. Any font installed on the DocuSP controller can be specified. Font size –o fontsize= Specify the font size in points. Orientation –o Specify the page orientation to use.
Using the lp utilities 2-10 Using the lp Utilities for Solaris
3. Print queue status The lpstat command is used to show the contents of the printer queues. The lpstat command syntax and options Refer to the man pages for further information on other options available with the lpstat command. Syntax Required information lpstat –o –o Identify the print queue. The option is case-sensitive; more than one option may be entered at one time. User identification –o Report the status of all jobs with the specified user name.
Print queue status 3-2 Using the lp Utilities for Solaris
4. Remove a print job from the queue The cancel command removes a print job from the print queue. The cancel command syntax and options If no options are specified for the cancel command, the command will remove all active jobs with your user name. Syntax cancel NOTE: The cancel command will only work with jobs that have not been sent to the printer. The options The options are case-sensitive; more than one option may be entered at a time.
Remove a print job from the queue 4-2 Using the lp Utilities for Solaris