SharedPrint/UX User and Administrator's Guide for HP-UX 10.0 ABCDE HP Part No. Order No.
Notice HEWLETT-PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS MATERIAL, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance or use of this material. Hewlett-Packard assumes no responsibility for the use or reliability of its software on equipment that is not furnished by Hewlett-Packard.
Preface The SharedPrint/UX User and Administrator's Guide for HP-UX 10.0 describes procedures for con guring, troubleshooting, using, and extending SharedPrint/UX. SharedPrint/UX is client-server software that includes a graphical user interface for printing. The manual also introduces the SharedPrint/UX Manager, which helps administrators manage SharedPrint/UX print requests and other print requests in a networked environment.
Problems, Questions, and Suggestions If you have any questions or problems with our hardware, software, or documentation, please contact either your HP Response Center or your local HP representative. Printing History December 1992. . . . . . . . ..B2154-90601 October 1993. . . . . . . . . . . B3242-90601 January 1995. . . . . . . . . . . B3242-90602 November 1995. . . . . . . . ..
Contents 1. Introducing SharedPrint/UX SharedPrint/UX Features . . . . . . . SharedPrint/UX From the lp Command Printers Needed for Speci c Files . . . . Types of Files Supported . . . . . . . Printing TIFF Files . . . . . . . . . Printers and Plotters Supported . . . . Basic Architecture of SharedPrint/UX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 1-2 1-2 1-4 1-5 1-6 1-7 2.
4. Understanding the SharedPrint/UX Architecture The HP-UX Spooling System . . . . . . . . . Communications Phase . . . . . . . . . . Processing Phase . . . . . . . . . . . . . How lp Creates the Control File . . . . . . The print model.sh Shell Script . . . . . . . . Parse Command Line . . . . . . . . . . . Get Printer Type . . . . . . . . . . . . . Build Options . . . . . . . . . . . . . . Front Banner Page . . . . . . . . . . . . Get File Type . . . . . . . . . . . . . . Command line option . . . . . . .
6. Extending SharedPrint/UX Adding Support For An Unsupported Printer . . . . . . . . . Adding Support For A New Filter . . . . . . . . . . . . . . Modifying Default SharedPrint/UX Behavior . . . . . . . . . 7. Troubleshooting SharedPrint/UX What To Do . . . . . . . . . . . . . . . . . . . . If nothing appears on the printer . . . . . . . . . If Network Computing System (NCS) errors appear . If GUI performance problems occur . . . . . . . .
Figures 1-1. 1-2. 4-1. 5-1. SharedPrint/UX Access to Files, Printers, and Plotters SharedPrint/UX Client Server Architecture . . . . . print model.sh Shell Script . . . . . . . . . . . . . The SharedPrint/UX Filters . . . . . . . . . . . . . . . . . . . . . . . . 1-3 1-7 4-5 5-2 1-1. Files Supported by SharedPrint/UX . . . . . . . . . . . . 4-1. Banner Page Formatting Features . . . . . . . . . . . . . 5-1. txpcl and txps Filter Formatting Options . . . . . . . . .
1 Introducing SharedPrint/UX SharedPrint/UX enhances the basic capabilities of the lp spooling system, using a client-server implementation. SharedPrint/UX is included as part of HP-UX 10.0 on all HP 9000 Series 700 and 800 systems as SharedPrint/UX version 1.5.
SharedPrint/UX From the lp Command You can also use SharedPrint/UX with the lp command; you can use any of the options found in SharedPrint/UX Graphical User Interface. See Appendix A for a list of option names. Printers Needed for Specific Files Figure 1-1 provides a overview of what types of les you can print using SharedPrint/UX. The following les require speci c printers: PostScript and Encapsulated PostScript les require a PostScript printer. CGM les require an HP-GL/2 printer.
Figure 1-1.
Types of Files Supported SharedPrint/UX can print the types of les listed in Table 1-1. Note For details about some printers requirements, see the preceding section, \Printers Needed for Speci c Files." Table 1-1. Files Supported by SharedPrint/UX Version Supported File Contents File Type TIFF PC, scanned, and FAX images 5.0 (6.
Printing TIFF Files SharedPrint/UX can print any type of TIFF image le that the HP-UX Image Library can read.
Printers and Plotters Supported SharedPrint/UX supports the following printers and plotters. To add support for additional printers, see Chapter 6, Extending SharedPrint/UX.
Basic Architecture of SharedPrint/UX SharedPrint/UX uses a client/server implementation. The SharedPrint/UX client contains the user interface, while the SharedPrint/UX server contains the software that processes print requests. The server software invokes the necessary conversion and formatting lters, and controls the use of printer capabilities, such as duplex printing and tray selection. Figure 1-2 illustrates the client/server architecture of SharedPrint/UX.
2 Setting Up SharedPrint/UX You can use this chapter for three tasks: To con gure local printers to support SharedPrint/UX To add remote printers that were con gured for SharedPrint/UX To enable printing via SharedPrint/UX on a user's system Configuring Local Printers for SharedPrint/UX Check the printer you need is listed under \Supported printers and plotters" in Chapter 1.
Printer Attached to SharedPrint/UX Server 1. Become root on the SharedPrint/UX server. 2. Use sam as follows: a. Use the Printer/Plotter Manager to list printers on your system. b. If the list includes the printer you planned to add for SharedPrint/UX, use the sam action for removing it. (By completing subsequent steps, you add it back for use by both SharedPrint/UX and lp.) c. Use the procedure for adding a local printer, lling in these elds as follows: Printer Name - assign a name to the printer.
Printer Controlled by JetDirect Network Software 1. Become root on the SharedPrint/UX server. 2. If you have not installed the JetDirect Network software (separately purchased TCP/IP software) on the SharedPrint/UX server, use the documentation that comes with the TCP/IP Ethernet Network Peripheral Interface to install this TCP/IP software. 3. Use the JetDirect jetadmin command as follows: Con gure the boot server for this printer. Add this printer to the spooler.
a. Hold the F12 key on the X station keyboard until the setup window appears. b. Choose the Terminal button. c. Set the Serial Port parameters to match your printer. d. Choose OK to close the setup window. e. Continue with step 3. 3. Become root on the system that is the X server for the X Station. 4. If this is a parallel printer, add the following line to the /etc/inittab le: lp:2:once:/usr/bin/slp -r /dev/device- lename 2>/dev/null For device- lename , supply the appropriate le name. 5.
9. If the printer will be used for color graphics, see \Modifying Color Printers," later in this chapter. 10. Con gure other printers (if needed) using a procedure in this chapter. 11. When all printers are con gured, see \Enabling SharedPrint/UX on a System" at the end of this chapter.
Printing in Europe In Europe, most SharedPrint/UX users require the HP_Roman_8 symbol set and a4 paper size which are not the default values. While each individual user can set these defaults values via the GUI, you can change the defaults for all users: 1. Become root on the SharedPrint/UX server that controls the printer. 2. Enable SharedPrint/UX on this system by entering this command: /opt/sharedprint/bin/sp_enable 3. Click on the front panel printer control to display the SharedPrint/UXManager. 4.
3. Choose an appropriate printer model number from a list you display with this command: ./list_tmplt.sh Select PS if the printer only accepts PostScript input. Select a di erent model if the printer handles multiple types of les. 4. Add the printer to the system and the SharedPrint/UX database by entering this command: ./add_printer.sh printer name model number io port printer name is any name you assign, up to 14 characters long. model number is a printer model number displayed by list_tmplt.sh.
7. When all printers are con gured, see \Enabling SharedPrint/UX on a System" at the end of this chapter. Adding Remote SharedPrint/UX Printers 1. Log on to the SharedPrint/UX server where you con gured the printer for SharedPrint/UX. 2. Note down the exact printer name(s) displayed by this command: /opt/sharedprint/lbin/splistpr -llsp No output means no printers are con gured for SharedPrint/UX. 3. On the client system, become root. 4. Run sam and respond to the prompts as follows: a.
5. When all printers are con gured, see \Enabling SharedPrint/UX on a System," which follows. Enabling SharedPrint/UX on a System Once you have access to one or more SharedPrint/UX printers (either local or remote), you need to enable SharedPrint/UX on each system where you plan to print.
3 Using SharedPrint/UX Once you have set up SharedPrint/UX printers on a system, you can use this chapter to get started start printing various text and graphics les. See the following topics covered in this chapter: Printing Files Checking Print Status Saving Common Print Setups Getting Help with SharedPrint/UX Printing Files You can print from HP VUE or from the UNIX command line once you have access to SharedPrint/UX printers.
2. On the SharedPrint/UX window that appears, select the printer you want by clicking the Printers button. 3. Type the number of copies you want in the Copies eld. 4. Change other print controls and ll in text elds, if needed; use the Help button for details. 5. Choose OK to print the le. 6. To con rm the le is printing, choose the Printer control in the HP VUE Front Panel. The SharedPrint/UX Manager displays all print requests in the queue.
Checking Print Status To invoke the SharedPrint/UX Manager, click on the printer control in the front panel. A Graphical User Interface appears and displays menus for checking the status of printers and print requests and administering the SharedPrint/UX system. Accessing SharedPrint/UX Manager at the Command Line To access the SharedPrint/UX Manager at the HP-UX command line, use this command: /opt/sharedprint/bin/spadmin For further details on this command, type: man spadmin.
Before creating a Virtual Printer, you may wish to test your print request to check that it provides the output you want. Because SharedPrint/UX saves the last used settings, the next time you enter SharedPrint/UX, you can ne-tune your settings or values and then create the Virtual Printer. For more details on Virtual Printers, click on the Help button on the Virtual Printers window.
Printing Multiple Files and Silent Printing If you added a SharedPrint/UX printer to your subpanel, you see an SP labeled on the printer icon. To print one or more les on that printer, drop the le(s) on that printer icon. This action prints the le(s) with the last SharedPrint/UX options you used. This printing is called silent printing, because the SharedPrint/UX dialog does not appear. You can also use the Printers subpanel to obtain the status of printers.
Understanding the SharedPrint/UX 4 Architecture The spooling system interface for HP-UX is based on the System V lp spooling system. This system uses a shell script to process a print request. SharedPrint/UX does not modify the lp spooler functionality, but adds the print model.sh shell script to process spooled requests. This chapter covers the following topics that explain how SharedPrint/UX and its print model.
Communications Phase The communications phase begins when the user makes a print request with the lp command. During the communications phase, lp creates the data and control les in the /var/spool/lp/request/printer name directory, where printer name is the name of the printer speci ed for this request. Then, a child process spawned by the Line Printer scheduling daemon (lpsched) opens a streams connection to the data and control les. The communications phase involves the lp command and the lpsched daemon.
The print model.sh Shell Script The print model.sh shell script, which is also referred to as the SharedPrint/UX model script, is the interface program invoked by the lpsched print daemon when a print request is processed. The script is found in /opt/sharedprint/lbin and is called with the following arguments: job id user name title copies options les The rst four arguments represent the request number, user who queued the request, print request title, and number of copies to be printed.
The following 5 steps form the basic procedure for each request: 1. Determine the printer type 2. Build an options list for the request 3. Determine the le type 4. Build a lter pipeline to process the request 5. Execute the lter pipeline Figure 4-1 illustrates the ow of print model.sh, and its use of con guration les. It is followed by sections that describe each block in the ow chart.
Figure 4-1. print model.
Parse Command Line The Parse Command Line function (parse cmdline) reads the command line arguments and converts them to the shell variables used by the remaining portion of the script. The main purpose of this function is to enclose the speci cs of a spooling system in one location. For the HP-UX spooling system, this function rst strips the printer name o the request id argument. It builds the printer con guration le name from this printer name. The format of the lename is printer name .
writes a shell variable called OPTIONS, which is a list of options and their values. The format of each item in the list is OPTION=VALUE, with each item separated by newlines. The Build Options function parses each token in the options variable, checks the le Options.cf for the correct spelling, and stores the option and its value. After parsing the last token in the options variable, the build options function reads directives from the printer con guration le.
Table 4-1. Banner Page Formatting Features Feature units high Filled region (maybe text ) 3 white space 2 user name 4 white space 2 full user name from /etc/passwd 1 white space 1 request id: # printer name: 1 white space 1 date & time 1 white space 2 title 4 white space 2 lled region (possibly text) 3 The basic ow of this function follows: 1. Check if the front banner is in the Con guration le. Exit, if no entry. 2. Check if the user has speci ed the -banner o option.
Get File Type The Get File Type function (get le type) determines the le type of the spooled le. The le types supported by this model are listed in the print script con guration le le types. The le type is necessary to determine what if any processing is necessary so that the content is correctly formatted for the target printer. For instance, a PostScript le must be converted to PCL to print on a LaserJet printer. The le typing checking process uses three methods in the following order: 1.
File Type Reader The File Type Reader function compares the le contents with a prede ned set of patterns for speci c le types. These patterns are coded as C programs or Korn shell scripts in the /opt/sharedprint/bin directory. Each program or script expects a le as input. If the le type matches the de ned pattern, the program or script writes the type string to standard output, and returns an exit code of 0. If no match results, the program or script returns an exit code of 1.
Next, the executable script is created by adding the appropriate options to each of the lter and driver elements. The le OptionsMap.cf maps the options that apply to each lter or driver, so that the correct arguments are passed to the actual lters.
Last File The Last File function cycles the script back to processing the next request. The initial state of the options, printer con guration le, and output type remain the same and do not need to be recalculated. Rear Banner Page The Rear Banner Page function is the same function used to print the front banner page (print banner). It may be used to print a short trailer or for requests on printers that print face up.
printer model les - These les are templates that contain information for a speci c model of printer. The information in each le includes options supported by this printer, default values for any lters that may be used with this printer, default interface settings, and le types which this printer can handle. The format is option=value or if an option supports multiple values the format is option=value1:value2: These les are stored in /opt/sharedprint/lib/printers.
lter options le - This le lists the supported options for each lter or driver. The format is lter name=option:option( lter speci c spelling):option . This le is OptionsMap.cf in the /opt/sharedprint/lib/con g directory. options le - This le lists the known options and aliases. The format is option:alias:alias . This le is stored as Options.cf in the /opt/sharedprint/lib/con g directory. Filter Design Needs Each lter reads from standard input and writes to standard output.
5 Using SharedPrint/UX Filters The directory /opt/sharedprint/bin contains the SharedPrint/UX lters. These lters are programs that operate on data, producing resultant data with di erent characteristics. SharedPrint/UX has two types of lters: translators - lters that change the encoding of the information in the data le without changing its appearance. For example, a translator may convert text to PostScript format. formatters - lters that modify how the information in the data le is rendered on the page.
Figure 5-1. The SharedPrint/UX Filters This chapter explains these lters under the following headings: Text Filters CGM Filter PCL Page Description Language Filter Image Library Filter Text Filters The txpcl and txps lters format and translate text documents into PCL and PostScript, respectively. As Table 5-1 shows, formatting options enable users to change point size, print portrait or landscape, choose double-columns, add headers and footers, and change typeface and symbol set mapping.
Table 5-1.
Options that have con icting requirements are resolved in this order of priority: orientation symbol set style spacing point pitch weight typeface These lters process the following control characters (ASCII code in parenthesis): backspace Insert a bold character at the preceding position if the next character is the same. Add an underline to the preceding (0x08) character if the next character is an underscore.
Text to PostScript Filter The txps (text to PostScript R ) lter supports all level 1 (initial PostScript release) and level 2 PostScript devices. The font metrics used by this lter are stored internally and are limited to courier typefaces. An external set of les is used to de ne PostScript code used to remap the existing symbol sets. SharedPrint/UX includes a symbol set mapping for the Latin-1 character set.
The following PostScript procedures are prede ned as an aid in creating new character procedures: /in {72 mul} def /sh {show} def /mt {moveto} def /tl {translate} def /ng {1 neg mul} def /sl {scale} def /hf &/ Courier findfont 1000 scalefont def /hfc {hf setfont 0 0 moveto show} def /hs &/ Symbol findfont 1000 scalefont def /hsc {hs setfont 0 0 moveto show} def CGM Filter The cgmhpgl2 (CGM to HP-GL/2) lter reads a binary CGM le and produces an HP-GL/2 byte stream.
The following options are supported by this lter: tpage Forces the plot to t on the page as best as possible. orientation Specifying portrait forces the image to be rotated 90 degrees on the paper. Normally, the plot is oriented so that the long axis is the paper is plotted as the x axis. pen color Speci es that the target device is a pen plotter. paperwidth Speci es the width of the output media in inches. paperlength Speci es the length of the output media in inches.
The PCL PDL image: resolution paperwidth paperlength lter requires the following information to create the raster Speci es the target device dot spacing in dots per inch. Speci es the width of the output media in inches. Speci es the length of the output media in inches. PCL Filter Limitations The PCL PDL lter has the following limitations: This lter converts characters with bitmap sizes of up to 64 KB. A 64 KB character is approximately 2.5 by 2.5 inches (at 300 dots per inch), or 7.5 by 7.
This lter does not support the following commands in a PCL le: Simplex/Duplex: ESCAPE & I # s/S User De ned Logical Page: ESCAPE & a # w/W [LP de nition] VFC (Vertical Format Control sequence) Support Source Transparency Mode: ESCAPE * v # n/N Pattern Transparency Mode: ESCAPE * v # o/O Select Pattern: ESCAPE * v # t/T User-De ned Patterns: ESCAPE * c # w/W [pattern data] Set Pattern Reference Point: ESCAPE * p # r/R Image Library Filter The ilFilter (Image Library) lter converts a well-known bitmap forma
The Image Library producers read a bitmap le and translate it to an Image Library format. In addition to the producers shown in gure 5-1, the EFS Image Library includes producers that accept the following formats: X window dumps Bitonal X bitmaps Color X pixmaps Starbase bitmaps TIFF 5.0 and TIFF JPEG 6.0 images JFIF images GIF images PostScript PDL Filter Raster The PostScript PDL raster producer takes a bitmap created by the PostScript PDL and feeds it to the Image Library pipeline.
Image Library Consumers The Image Library consumers read an image from an Image Library pipeline and formats it for a speci c device PDL. Figure 5-1 shows the following consumers: X-Windows (as an X bitmap) TIFF les JFIF les Postscript The PostScript Image Library consumer generates Level 1 PostScript. Color information is mapped to the Level 1 PostScript color commands. PCL This consumer generates PCL 3 or PCL4+ code as directed by the printer con guration le.
6 Extending SharedPrint/UX This chapter describes the three ways that SharedPrint/UX can be extended: Adding Support For An Unsupported Printer Adding Support For A New Filter Modifying Default SharedPrint/UX Behavior Adding Support For An Unsupported Printer To add support for an unsupported printer to SharedPrint/UX, perform the following steps: 1. Write a new driver for the printer. 2. 3. 4. 5. 6.
important items are the le types directive and the driver directive. The le types directive tells SharedPrint/UX which le types this printer can handle. The driver directive should specify the driver you are creating or adding. Adding Support For A New Filter To add a new lter to SharedPrint/UX, perform the following steps: 1. Write a new lter if needed; see the Chapter 4 section, Filter Design Needs. 2. Modify the pipeline le Pipeline.cf .
Modifying Default SharedPrint/UX Behavior To modify the default behavior of SharedPrint/UX, perform the following steps: 1. Modify the pipeline le Pipeline.cf . Changing the order of the speci cations may cause di erent lters to be used. For instance, if a printer supports PostScript and PCL, a text le can be printed by using the txpcl or txps lter. SharedPrint/UX uses the rst speci cation encountered that performs the required translation. 2. Modify the printer con guration le.
7 Troubleshooting SharedPrint/UX This chapter gives you information on what to do if problems occur during printing and on how to analyze error and debug pages. What To Do . . . This section tells you what to do if any of the following situations occur: If nothing appears on the printer. If Network Computing System (NCS) errors appear. If GUI performance problems occur. If performance slows on servers with network printers. If problems occur on PostScript printers.
If nothing appears on the printer If you send print requests, but nothing appears on the printer, use the following steps: 1. From the client system, check the print queue as follows: $ lpstat -oprinter name If lpstat displays a warning, such as Warning printer name is down, skip to Step 2. If lpstat lists the print request in the queue, but the output does not eventually appear, check if the printer has the ONLINE button set to OFF or if it is out of paper. 2.
$ /etc/ping server name 64 2 If this command issues information indicating 0% packet loss, the client can see the server. Skip to the Step 4. If /etc/ping issues an error, or a message indicating 100% packet loss, the client cannot see the server. To see the server, the client must either have named enabled or must list the server in the /etc/hosts le. To correct this problem, use these steps: a.
$ /etc/ping server name 64 2 If /etc/ping still issues an error, your network may be experiencing problems. 4. If /etc/ping issued no errors, use these commands on the client system: $ disable printer name $ enable printer name $ lpstat -oprinter name 5. If lpstat still does not show the le in the printer queue, perform these steps: a. Search the le /etc/inetd.conf for the following line: #printer stream tcp nowait root /usr/lib/rlpdaemon rlpdaemon -i b.
If /etc/ping issues an error, or any message indicating 100% packet loss, the client cannot see the server. Network problems exist; see your network administrator documentation. 2. On the client and the server system, check that either NCS or DCE is correctly set up. (Refer to Appendix C for NCS. For DCE, refer to the HP DCE/9000 documentation.) 3. If the server is running and you still cannot print, check the llbd by issuing this command from the system with the printer attached.
/opt/sharedprint/bin/spserver 5. On the system with the printer attached, use SharedPrint/UX to submit a print request. 6. If the print request succeeds, use the client system to submit the print request. 7. If SharedPrint/UX fails on the client system, but works on the server system, use sam to reinstall the remote printer. If GUI performance problems occur If SharedPrint/UX GUI is slow to respond, the cause may be that the print server software has failed.
The following example illustrates the use of the splistpr command. $ /opt/sharedprint/bin/splistpr -check status machine_name + node_a + node_b node_c + node_d One or more SharedPrint/UX servers are down.
If you are printing images or PostScript documents with an output page size of D or larger, try 1800 as the timeout value. If problems occur on PostScript printers If problems occur when you print a full-page bitmap image on a PostScript printer, the printer may need more memory. Up to 2 MB of memory may be required.
If no output appears on the plotter or if you receive swap space errors, you need to increase the swap space on your system. See your HP-UX system administration tasks documentation. If you receive disk full error messages, the disk with the /usr/spool/lp directory has insu cient space for processing the print request. Consider moving /usr/spool/lp to a second disk and creating a link between the original and new /usr/spool/lp directories.
Margin Settings Printer Top Bottom Left Right Tektronix 4693DX 0.2 0.2 1.7 1.7 0.2 0.2 1.7 1.7 0.5 0.5 Tektronix Phaser HP DeskJet 500C 0.25 0.25 Analyzing Debug and Error Pages SharedPrint/UX provides the following printing tools that help you analyze printing problems: A debug page, created with each print request. An error page, created only if printing fails.
pcl3xl pcl3+ pcl3 JOB_OPTIONS -copies 1 -resolution 90 -orientation portrait -papersize letter -top 0.25 -bottom 0.25 -left 0.25 -right 0.25 -tab 8 -charheight 10.0 -columns 1 wrap 1 -symbolset ISO_100 -page_reversal 1 -collate_copies 1 processing " /usr/spool/lp/request/pjxl/dA0358toast" file type = bitmap pipeline = "ilFilter -p 3 -c 2 5 -resolution 90 -orientation portrait -papersize letter -top 0.25 -bottom 0.25 -left 0.25 -right 0.25 | pjxl.
pcl3xl pcl3+ pcl3 These lines show command line and printer con guration le options: JOB_OPTIONS -copies 1 -resolution 90 -orientation portrait -papersize letter -top 0.25 -bottom 0.25 -left 0.25 -right 0.25 -tab 8 -charheight 10.0 -columns 1 -wrap 1 -symbolset ISO_100 -page_reversal 1 -collate_copies 1 This line indicates which le is being processed by the print request: processing "/usr/spool/lp/request/pjxl/dA0358toast" This line shows the le type of the print request being processed.
Mon Jul 27 14:29:30 EDT 1992 Can not determine a pipeline for this job . /usr/spool/lp/request/tp/dA0376toast ================= Debug information for job tp-376 ================= job owner = smith_b options = file(s) = /usr/spool/lp/request/tp/dA0376toast Mon Jul 27 14:29:29 EDT 1992 printer file type(s) = teksx JOB_OPTIONS -copies 1 -orientation portrait -papersize letter -paperwidth 8.500000 -paperlength 11.000000 -top 0.5 -bottom 0.5 -left 1.0 -right 1.0 -tab 8 -charheight 10.
/usr/spool/lp/request/tp/dA0376toast The remaining lines provide the same debug information explained in \Analyzing a debug page".
A SharedPrint/UX Printing Options This appendix describes options under two headings: The User Options - the options that you can set either through the (Graphical User Interface) GUI or the lp command line. Printer Con guration File Options - the options that appear only in the printer's con guration le, not in the SharedPrint/UX GUI. These options contain the default values for the behavior of the printer. However, these defaults are overriden when you use the lp command.
User Options These options can be set either through the GUI or by using the lp command line, which has this format: lp -dprinter -o" -option1 value1 -option2 value2 . . . " For a given printer, these options can also be set in the printer con guration le (/var/opt/sharedprint/printer .pcf) on the server, the system with the printer. If an option does not apply to the current print request, it is grayed out on the GUI. If you want to identify the le type, use the -t lepathname.ext option.
charweight (weight, cw) integer Sets the character weight of text to a point size between 07 (a thin weight and +7 (a thick weight). copies (cop) integer Sets the number of copies to be printed. columns (cpl, columns per line, col per line) f1, 2, 4g Sets the page make-up to a single column (1), double column (2), or four-column format (4). Note that no SharedPrint/UX lters use the 4-column format, but other lters can be created to use it.
footer (foot, foot string) left-string/center-string/right-string Places the text string you supply at the bottom of each page. This string can include any of the characters de ned for header. gamma (ga) real-number Sets the gamma correction value. To darken the image, use a number between 1 and 0; to lighten it, use a number higher than 1. header (head, head string) left-string/center-string/right-string Places the text string you supply at the top of each page.
To print text documents that are formatted for 66 lines per page, set the following options: lpi 6.3 wrap o top margin 0.25 bottom margin 0.25 nobgcolor (nobg) fon, o g If on, sets the background color to white. orientation (or, orient) flandscape, portraitg Determines the orientation of the page. portrait prints the text or x-axis of the bitmap parallel to the short edge of the paper. landscape prints the text or x-axis of the bitmap parallel to the long edge of the paper.
paperwidth (pw) real-number Sets the length of the page in inches, if you set papersize to variable. pitch (pi, charspace) real-number Sets the number of characters printed per (horizontal) inch. This value is used only if xedspacing is set to on. pixelexp (pex) integer Determines the size of the printed image: To enlarge the image - Enter a number greater than 1. To shrink the image - Enter a number between 1 and 0. To ll the page - Enter 0 or select Best Fit on Paper.
Sets the number of spaces between tabs. top margin (tm, top margin) real-number Sets the top margin in inches for text and graphics print requests. typeface (tf ) string Set the typeface for text les to one supported by this printer. For typefaces you can enter, see the con guration le for this printer. wrap (wr) fon, o g If on, wraps lines that exceed the right margin. If o , truncates lines that exceed the margin.
media type (mt, media) string Identi es the type of media that is loaded in the printer/plotter. page reversal (pr)fon, o g If on, reverses the order of text page output. pen color (pc) string Sets the pen colors loaded in the pen plotter for graphics print requests. The format is color1:color2:color3... color8 where: colorn is the pen color loaded in carousel slot number n . Use the following values for color. (Except for red-violet, they are rst three letters of the color.
B CGM Support This appendix de nes the support for CGM to HP-GL/2 conversion under these topics: Starbase and HP-PHIGS CGM Generators CGM Element Bounds Starbase and HP-PHIGS CGM Generators The following list contains the CGM elements supported by the cgmhpgl2 (CGM to HP-GL/2) lter. This list represents the CGM elements emitted by the StarBase and HP-PHIGS CGM generators.
1 7 COLOR PRECISION 1 8 COLOR INDEX PRECISION 1 11 METAFILE ELEMENT LIST 2 1 SCALING MODE 2 2 COLOR SELECTION MODE 2 3 LINE WIDTH SPECIFICATION MODE 2 5 EDGE WIDTH SPECIFICATION MODE 2 6 VDC EXTENT 3 2 VDC REAL PRECISION 3 5 CLIP RECTANGLE 3 6 CLIP INDICATOR 4 1 POLYLINE 4 7 POLYGON 4 8 POLYGON SET 4 10 GENERALIZED DRAWING PRIMITIVE 4 12 CIRCLE 4 15 CIRCLULAR ARC CENTER 5 2 LINE TYPE 5 3 LINE WIDTH 5 4 LINE COLOR 5 22 INTERIOR STYLE 5 23 FILL COLOR 5 24 HATCH INDEX 5 27 EDGE TYPE 5 28 EDGE WIDTH 5 29 EDGE C
5 30 EDGE VISIBILITY 5 34 COLOR TABLE CGM Element Bounds The following are the speci c CGM element bounds: VDC TYPE 0, 1 INTEGER 16 PRECISION REAL PRECISION 0 9 23 32-bit oating-point INDEX PRECISION 8 COLOR PRECISION 8 COLOR INDEX 8 PRECISION METAFILE -1 1 Drawing plus Control Set ELEMENT LIST SCALING MODE 0, 1 LINE WIDTH 0, 1 SPECIFICATION MODE EDGE WIDTH 0, 1 SPECIFICATION MODE VDC EXTENT VDC values: 0 - 32767, 0.0 - 32767.0 VDC REAL 0 9 23 32-bit oating-point PRECISION CLIP RECTANGLE VDC values: 0.
POLYGON POLYGON SET GENERALIZED DRAWING PRIMITIVE CIRCLE CIRCLULAR ARC CENTER LINE TYPE LINE WIDTH LINE COLOR INTERIOR STYLE FILL COLOR HATCH INDEX EDGE TYPE EDGE WIDTH EDGE COLOR EDGE VISIBILITY COLOR TABLE B-4 CGM Support 3-1024 points VDC values: 0 - 32767, -32767.0 32767.0 3-1024 points VDC values: -32767.0 - 32767.0 gdp-id: -100 0-1024 points VDC values : -32767.0 32767.0 datarecord contents : 0-1024 4-byte integer values : 0 - 16 VDC values: 0 - 32767, -32767.0 - 32767.
C Meeting NCS or DCE Requirements SharedPrint/UX depends on either Network Computing System (NCS) or HP DCE/9000. This appendix is provided for network administrators who have not set up NCS in the standard manner or have not set up HP 9000/DCE to accommodate SharedPrint/UX. If HP DCE/9000 is set up, use the following section to have it work with SharedPrint/UX. If NCS is set up, SharedPrint/UX will work with no changes. If you don't know if NCS is set up, see the section \Checking the NCS Setup.
2. To have DCE also work with the HP-UX Audio server (another NCS-based application) you need to stop it also; at later step shows you how to restart it. Use these steps to stop the Aserver: a. Find the PID for the Aserver. Type: ps -ef|grep Aserver b. Of the two processes displayed, remove the lower-numbered PID. Type: kill PID c. To check if both processes were killed, type: ps -ef|grep Aserver d. If one process still exists, remove it by typing: kill -KILL PID 3.
Checking the NCS Setup Use this procedure to check if you already have one or more glbd daemons running on your network: 1. Log on to any SharedPrint/UX server or client machine as root. 2. Be sure that NCS/NCK (the Network Computing Kernel) is installed on all the system as follows: a. Check for the existence of the le /usr/sbin/ncs/glbd. If this le exists, you can assume that NCK has been installed. b. If NCK is not installed, install it from your HP-UX installation media.
The following guidelines give additional suggestions for selecting systems on which to run glbd: The systems running the NCS daemons should be stable; they should not be systems that are frequently taken down or unavailable. If you already have designated \server" systems within your network, these systems are generally good candidates for the glbd daemon. These server systems could be le servers, print servers, mail hubs, or diskless servers. Take into account the layout of your network.
Starting the First glbd Daemon After choosing systems to run glbds from the preceding section, use the following procedure to start glbd. 1. For use later in this procedure, write down the names and internet addresses of the hosts that will run glbd daemons. 2. Be sure that NCS/NCK (the Network Computing Kernel) is installed on all the systems where you plan to run glbd as follows: a. Check for the existence of the le /usr/sbin/ncs/glbd.
% /usr/sbin/ncs/llbd % ps -e | grep llbd 11628 ? 0:00 llbd c. Perform the following steps to automate the llbd and glbd startup processes, so that they restart whenever the host is rebooted: i. Open the /etc/rc.config.d/ncs le ii. Check that the START_LLBD variable is set to 1. If it's set to 0, edit the le to change the value to 1. iii. Check that the START_GLBD variable is set to 1. If it's set to 0, edit the le to change the value to 1. iv. Save and exit this le. d.
ii. Set the default glbd to be the one you just started. To specify a glbd host on HP-UX, use a name with the form ip:host . For host , use either a network address (preceded by a # sign) or a system name. The following example shows how to start drm_admin and set the default glbd to the daemon running on the host ip:mars. # /usr/sbin/ncs/drm_admin drm_admin: set -o glb -h ip:mars Default object: glb default host: ip:mars state: in service Checking clocks of glb replicas ip:mars 1992/07/14.
b. If NCK is not installed, install it from your HP-UX installation media. You will need the NCSNCK-RUN leset from the NETWORKING partition and the NCSNCK-MAN leset from the REFERENCEDOC partition. 2. On each host that will run glbd, use the following steps, which describe how to show if the NCS local location broker daemon (llbd) is running, then how to start it if not running. a. Use the ps command to see if llbd is currently running.
4. Make sure that the following lines are in the le /etc/netlinkrc. If these lines are missing, add them to the end of the /etc/netlinkrc le. if [ -f /etc/rc.config.d/ncs ] then /etc/rc.config.d/ncs fi 5. Verify that the clocks on each glbd host are within two minutes of each other. If the clocks are skewed (that is, if they are not within two minutes of each other), reset the clocks. Use the date command to check the system clock and reset it, if necessary.
that the output also indicates whether the clocks on the the glbd hosts are synchronized. (You'll receive a warning if the clocks are skewed.) # /usr/sbin/ncs/drm_admin drm_admin: set -o glb -h ip:pluto Default object: glb default host: ip:pluto state: in service Checking clocks of glb replicas ip:pluto 1992/07/14.15:45 ip:saturn 1992/07/14.15:45 ip:mars 1992/07/14.
Index le types supported, 1-3 lters adding support, 6-2 CGM, 5-6 formatters, 5-1 Image Library, 5-9 PDL, 5-7 supported, 5-2 text, 5-2 translators, 5-1 A architecture, 1-7, 4-1 automating glbd startup, C-7 automating llbd startup, C-6, C-8 C CGM, B-1 client, 1-7 command line access to GUIs, 3-2 con guration les, 4-12, 4-14 D DCE, C-1 debug page, 7-10 drivers creation of, 4-14 drm admin, C-6 drm admin utility verifying glbd communication, C-7, C-10 E error page, 7-12 /etc/hosts, 7-3 /etc/netlinkrc le, C-
N NCK, C-5 NCS, 7-4, C-3, C-5 netlinkrc le, C-6, C-9 network printer performance, 7-7 P PCL Font problems, 7-9 plotters, 7-8 postscript printers, 7-8 printers adding support, 6-1 con guration les, 4-12, 4-14 troubleshooting, 7-1 printers and plotters supported, 1-6 print model.
