PShop ™ Users Guide PShop enables the highest-quality PostScript and image printing for a variety of color and monochrome printers. For version 5.
Copyright Notices Copyright © 1992 - 2003 Vividata, Inc. All Rights Reserved Worldwide. This manual, as well as the software described in it, is furnished under license and may only be used or copied in accordance with the terms of the Vividata End-User License Agreement license.
Copyright Notices U.S. Government Provision If this Software is acquired by or on behalf of a unit or agency of the United States Government this provision applies. This Software: a) Was developed at private expense, and no part of it was developed with government funds, b) Is a trade secret of Vividata, Inc.
Table of Contents Table of Contents Chapter 1: Before You Begin ....................................................................... ix Type Conventions........................................................................... ix System Requirements .................................................................... ix Memory Requirements ....................................................................x Customer Support ..........................................................................
Table of Contents Chapter 5: PShop Graphical User Interface..............................................15 Overview........................................................................................15 Basic Operations ............................................................................16 User Interface.................................................................................17 Appendix A: vvprint/vvlpr Commands & Parameters.............................21 Usage Synopsis ...............
Table of Contents Appendix E: License Manager Commands ............................................... 65 Overview........................................................................................65 License Manager Utilities ..............................................................65 The License Daemon .....................................................................65 License File Format .......................................................................65 Obtaining your lmhostid ......
Table of Contents viii - PShop User’s Guide
Chapter 1: Before You Begin Type Conventions Different kinds of typefaces used throughout this manual indicate text that will appear on the screen or need to be entered by the user. Type: Indicates text is: courier courier bold text generated by the computer text typed in by user text to be replaced by user When asked to enter commands preceded by a pound sign (‘#’), the user should be in super-user mode or ‘root’ first. (The command to be entered does not include the pound sign itself.
Chapter 1:Before You Begin If your platform is not listed above, you can contact Vividata, Inc. to see if your platform has been added since this printing of the manual. Memory Requirements - Minimum 128 MB RAM, depending on workstation configuration - An additional RAM or swap space of approximately twice the output size of the image you are printing (output size = bits per pixel * width in inches * height in inches * printer resolution (dpi) / 8).
Chapter 1:Before You Begin Examples: Table 2: Image Size Resolution Pixel depth Additional memory required 8.5" x 11" 300 dpi 1 bit 3 MB + 2 MB in /tmp 8.5" x 11" 300 dpi 8 bit 18 MB + 9 MB in /tmp 8.5" x 11" 300 dpi 24 bit 50 MB + 25 MB in /tmp 8.5" x 14" 300 dpi 24 bit 64 MB + 32 MB in /tmp 8.5" x 11" 400 dpi 24 bit 88 MB + 44 MB in /tmp Customer Support You can reach the Vividata, Inc. technical support staff by: • Online email form: http://www.vividata.com/support_contact.
Chapter 1:Before You Begin xii - PShop User’s Guide
Chapter 2: Software and Hardware Installation Overview This section describes the installation procedures for PShop, including the License Manager and printer hardware. Please consult the release notes supplied with the product for any last-minute information relevant to your particular system.
Chapter 2:Software and Hardware Installation SCSI Cable Lengths If you have a SCSI bus with SCSI-1 and SCSI-2 devices that do not operate in fast SCSI mode, the bus's total physical cable length should not exceed 6 meters (19.6 feet). On a bus with fast SCSI devices, the length should not exceed 3 meters (9.8 feet). On a bus with Ultra SCSI (SCSI-3) devices, the length should not exceed 1.5 meters (4.9 feet). At longer lengths, data integrity and transmission speed can be degraded significantly.
Chapter 2:Software and Hardware Installation Installing PShop Installing PShop on your system consists of a few simple steps. You may have obtained your PShop distribution either from the internet or from a CD-ROM. In both cases, you should have a PShop distribution file called, “--”. The file name will vary depending on the product name, operating system, release number.
Chapter 2:Software and Hardware Installation # sh vvkey.sh The filename of the script may vary. The license key will be installed in /opt/Vividata/config/vvlicense.dat. If you received a license key on paper, you must manually install it in this file. Once the software and keys have been installed, run the printer installation program, ps_install, to configure your printer.
Chapter 2:Software and Hardware Installation Configuring Your Printer PShop includes a printer installation and configuration tool, ps_install. The following is an explanation of its user interface and operation.
Chapter 2:Software and Hardware Installation PShop Installation Directory This field specifies the location of the PShop installation. By default it will use the directory where PShop is installed (usually /opt/Vividata for Solaris 2.x and /usr/vividata for other platforms). “Select a Printer” - the printer selection list This scrolling list shows the printers supported by PShop. If your printer is not one of the models listed, choose the printer that seems most like yours.
Chapter 2:Software and Hardware Installation already be installed and configured on your system. Vividata's website has additional support information for the lpvi driver if you need it, including information on how to get the latest version in a patch from Sun. This can be found at http://www.vividata.com/sparcprinter/. If you have a network printer, this is the temporary file used to store PShop's rasterized output (in the printer's protocol) for transmission to a remote print queue.
Chapter 2:Software and Hardware Installation may need to handle jobs with sizes in the sixty-plus megabytes (Please refer to the appropriate “Memory Requirements” on page x) so, once again, it important to make sure that the referenced directory has sufficient space. Default Printer This option allows you to set the printer you are installing as the system default printer. This allows easier access to the designated PShop print queue from applications and lp and lpr commands.
Chapter 2:Software and Hardware Installation Figure 2-2 ps_install Remote Print Queues GUI If a remote queue you want to connect to does not already exist, you can create it by filling in the following fields: Remote System Name - the host name of the remote system to which the remote printer is attached. Remote Queue Name - the name of the print queue on the remote system to which the printer is attached, or put another way, the name of the “printer” within the remote system.
Chapter 2:Software and Hardware Installation of a temporary file used to cache the rasterized image for transport to the remote queue. You can change this file name if necessary. Please refer to Appendix C, “Accessing Network Printers”, for more details network printing, Install Printer After you have selected a printer and elected any desired installation options click “Install Printer” to install the printer onto your system. After you install the printer, the “Edit Printer...
Chapter 2:Software and Hardware Installation include them.Edit Printer Configuration File: Pops up a text editor with the printer’s configuration file loaded. Installing the Kernel SCSI Driver for SunOS 4.x, HP-UX 10.x & AIX Now you are ready to invoke the installation script. This script will lead you step-by-step through the kernel driver installation, prompting you where necessary. To begin, go to the PShop directory and enter: # .
Chapter 2:Software and Hardware Installation Configuring the Environment Environment Variables A number of environment variables affect the operation of PShop (and the applications that may use PShop). These are normally either unnecessary or set automatically during installation, but you may want to change their default values if you are customizing your system. If you would like to check on their settings, you can inspect the wrapper script(s) in $VV_HOME/bin.
Chapter 2:Software and Hardware Installation You can also add the name of the directory that contains PShop to the PATH environment variable assignment in your .cshrc or .profile file. This will allow you to launch the user-level vvlpr and PShop gui application from any directory. After modifying your .cshrc or .profile file, logout from the system and then login again to start your session with the modified initialization files.
Chapter 2:Software and Hardware Installation Environment Variables used within the Printer Interface Script A number of environment variables affect the operation of PShop (specifically, the vvprint component). These are normally either unnecessary or set automatically during installation, but you may want to change their default values if you are customizing your system.
Chapter 3: Introduction Overview The growth in the popularity of UNIX for business, scientific, web-based and other specialized applications has its origins in the mid 1980’s. It was at this time that the first RISC processors appeared and inexpensive, powerful workstations were “invented.” The introduction of the first Adobe PostScript laser printers took place about the same time.
Chapter 3:Introduction PostScript-capable CPU’s built into printers. Also, RIP operation is interleaved with the action of the printing mechanism so that in the midst of printing jobs, pages can be “rasterized ahead.” In the use of imaging applications with PostScript controllers, an image must be completely transmitted to the printer before the printer actually starts printing.
Chapter 3:Introduction PShop Components The PShop package is made up of various components that fit together to comprise a whole system. In effect, these components coordinate an entire printing operation from the point at which a print job is submitted via the user GUI or a command line invocation all the way through to delivering the proper data in a printer’s required protocol.
Chapter 3:Introduction On System 5 based systems, PShop’s set up and operation is more complex. When lpsched detects a new entry in a print queue, it will invoke the printer’s interface script with each print job, terminating when the print queue is empty. For every system PShop’s ps_install will set up the necessary interface scripts and other configuration files. Processing the print job vvprint is the command line printing program. The filter script calls vvprint once for each queued print job.
Chapter 3:Introduction PShop Highlights PShop adds many valuable enhancements to the UNIX printing environment. PShop can run on the most popular UNIX platforms and supports every application (such as FrameMaker, Netscape, etc.) that prints PostScript to named print queues. Many image file formats and document types are automatically recognized and printed correctly by PShop.
Chapter 3:Introduction PShop System Diagrams The following diagrams illustrate schematically the flow of information within and between the components of PShop and the UNIX lp system. The diagrams that follow depict PShop installations for use with: 6 - PShop User’s Guide • GhostScript (GS) printers on parallel or network interfaces, and PostScript printers which are being host-RIP accelerated • PostScript printers on parallel ports or network interfaces • SCSI or GPIB printers.
Chapter 3:Introduction PShop User’s Guide - 7
Chapter 3:Introduction 8 - PShop User’s Guide
Chapter 4: Using PShop Overview PShop supports various commands (i.e., PShop, vvlpr, print tools, lp, and lpr) for using BSD style and System 5 style print systems. Using any of these utilities users can submit of many types to be printed. Image files, PostScript, and PDF files are automatically recognized and printed.
Chapter 4:Using PShop Using PShop on BSD Style Print Systems (SunOS 4.x, Linux and Digital UNIX) When you have completed the PShop installation, you will have a new print queue available. You should now be able to print by typing: lpr -P You may want to take a few moments to review the man pages for lpr. There are many options available.
Chapter 4:Using PShop Using PShop on System 5 Style Print Systems (Solaris 2.x, HP-UX, IRIX, and AIX) When you have completed the PShop installation, you will have a new print queue available. You should now be able to print by entering: lp -d (Solaris 2.x, HP-UX) lp -d (IRIX, AIX) You may want to take a few moments to review the man pages for lp. There are many options available.
Chapter 4:Using PShop Installation on Solaris 2.x, HP-UX, AIX and IRIX • Make sure banner.ps is located in $VV_HOME/config. • Copy vvprt_if.banner $VV_HOME/config/vvprt_if • Install new print queues as normal using ps_install. over the existing Installation on SunOS, Linux, OSF/1 • Make sure banner.ps is located in $VV_HOME/config. • Copy vvprtscript.banner $VV_HOME/config/vvprtscript • Install new print queues as normal using ps_install.
Chapter 4:Using PShop or lpr/lp commands. Then they will be able to print to the PShop-supported printer. If the users on the remote system(s) will be referencing a vvprint options file (i.e., “-ifs” parameter), that file does not need to be accessible for vvprint when printing. Users should invoke vvlpr to submit the print job so that the contents of the file can be expanded locally and prepended to their print jobs.
Chapter 4:Using PShop 14 - PShop User’s Guide
Chapter 5: PShop Graphical User Interface Overview While all printing to PShop printers can be done through lp/lpr or vvlpr, the PShop Graphical User Interface (GUI) provides an easy way for users to specify printing parameters. This chapter discusses the operations of the PShop GUI in detail.
Chapter 5:PShop Graphical User Interface Basic Operations To launch the PShop GUI, go to the $VV_HOME/bin directory, or if it is in your path, run: PShop This will launch the PShop GUI with no file name filled in. Alternatively, you can specify a file name in the command line, and it will be used automatically when the program is launched: PShop At the most basic level, you will only need to specify a file name via the “File...
Chapter 5:PShop Graphical User Interface User Interface The user interface consists of a main panel that contains basic controls, three collapsible panels that contain advanced controls, and a row of push buttons to print a job and close the program. Note that while all system printers will appear in the Printer pull-down menu, only PShop printers will have access to the full range of options. Options that have no value selected (certain radio buttons and text fields) will default to reasonable values.
Chapter 5:PShop Graphical User Interface command will be substituted with the name of the printer that appears in the Printer pull-down menu. Printer This pull-down menu lists all the print queues found on your local system. Using the PShop GUI, it is only possible to submit a job to a printer with a system print queue. If you configured a PShop printer using ps_install, it should appear in this list.
Chapter 5:PShop Graphical User Interface Image Size and Position Panel Clicking on the triangle next to “Image Size and Position” will expand the GUI to reveal more controls.
Chapter 5:PShop Graphical User Interface Orientation You can choose to print your file in a portrait (no rotation) or landscape (rotate 90 degrees) orientation. If you leave this field blank, PShop will automatically choose the best fit. Scaling You can choose to print your file to fit the page margins, or scale to a certain percentage of the page or image size. Refer to Appendix A, “vvprint/vvlpr Commands & Parameters”, for more information on scaling.
Appendix A: vvprint/vvlpr Commands & Parameters PShop User’s Guide - 21
Appendix A:vvprint/vvlpr Commands & Parameters Usage Synopsis vvprint [options] filename [filename...] vvlpr [options] filename [filename...] Typing: vvprint -help or vvlpr -help will print out all of the command line parameters that are supported in vvprint and vvlpr. This command line assumes one printer on the system, to switch between printers please see the section on ids on page 26. What follows is a brief description of the parameters.
Appendix A:vvprint/vvlpr Commands & Parameters • in the user's .vvprintrc file • in the printer’s ID file. IFS Files An IFS contains all the varaibles specific to each printer. A complete list of these is available below starting at page 23. If you are using two or more SCSI printers, you will need to uncomment the id line and enter the SCSI id for each printer. Additionaly, if you would like to use a Software Look Up Table, this is where you would specify the location.
Appendix A:vvprint/vvlpr Commands & Parameters Using vvprint/vvlpr options from lp In order to pass options on to vvprint from the lp command you need to use the -o option with double quotes arround the options. For example to print to a print queue named stylus with the scaling=scale and copies=2 options you would simply enter the following: # lp -d stylus -o "scaling=scale copies=2" filename This same command can also be executed as: #$VV_HOME/bin/.
Appendix A:vvprint/vvlpr Commands & Parameters usually do not include such information. As a result, certain PShop parameters will not have any effect on PostScript files, and some have different semantics when applied to PostScript or PDF. For example, since paper size or output area is specified within a PostScript file, and PostScript coordinates can extend beyond the printable area, parameters such as scale-to-fit, width, and length have no meaning.
Appendix A:vvprint/vvlpr Commands & Parameters Parameter Table Parameter(precede each with a '-') Default Value Acceptable Values Explanation General Controls id=:bus:id id=bus:id id=id id=path - bus = 0 to 3 id = 0 to 7 path Set the output device to a SCSI or GPIB bus:id or a PShop ID file. If the value is not set, PShop will print to the first supported printer found which is not already in use. Note that any referenced id file must reside in $VV_HOME/config.
Appendix A:vvprint/vvlpr Commands & Parameters Acceptable Values Parameter(precede each with a '-') Default Value savepaper 0 0, 1 Limit the printable area of the coordinate space to exclude any excess whitespace. If the value is set to 1, Pshop will print only the image area contained within the BoundingBox region of the page as set by the Postscript code of the input file. According to the Postscript specification, this region should include all of the viewable imagery of the page.
Appendix A:vvprint/vvlpr Commands & Parameters Acceptable Values Parameter(precede each with a '-') Default Value orientation - portrait, landscape, automatic Set image orientation. Default is “automatic”. scaling=n 100 n > 0, scale, none Set the image scale factor (percent) relative to the image size. A value greater than 0 will scale the image by a factor of “n” percent, while “scale” will scale the image to fit the printable area and “none” will cause the image not to be rescaled.
Appendix A:vvprint/vvlpr Commands & Parameters Acceptable Values Parameter(precede each with a '-') Default Value width=n length=n - n>0 Width and height of the image. The height=n default unit is 1/1200”. Specify m, i, t, or p for millimeters, inches, twelfths, or pixels. For example, set “width=2i” for a width of 2 inches. By default, these are calculated automatically from the image's dpi (or pdpi, xres, or yres values) and dimensions in pixels. These values are ignored for PostScript data.
Appendix A:vvprint/vvlpr Commands & Parameters Acceptable Values Parameter(precede each with a '-') Default Value hfont=text times font name Set the font used in headers and footers. Must be a font present in the Ghostscript fontmap (see $VV_HOME/ghostscript/Fontmap). bright=n 0 -100 to 100 Set the color transfer curve of an image. The value is inversely related to gamma.
Appendix A:vvprint/vvlpr Commands & Parameters Parameter(precede each with a '-') Default Value Acceptable Values Explanation Canon CJ-10 specific controls bright=n 0 -50 to 50 Set the brightness of the image. Higher values result in brighter images redbal=n greenbal=n bluebal=n 0 -50 to 50 Set the color balance of a specific color channel: red, green, and blue. filter=n 1 0, 1 Turn on/off the “Blacktext” mode.
Appendix A:vvprint/vvlpr Commands & Parameters Acceptable Values Parameter(precede each with a '-') Default Value ptf_file=path - path Load Kodak's standard Printer Table Format file (.TBL) indicated by “path” to replace the standard color lookup table. Files of this format are created using Kodak Tablemaker software. mirror=n 0 0, 1 Turn on/off horizontal mirroring. annotation=text - text Set single word annotation. Default is no annotation.
Appendix A:vvprint/vvlpr Commands & Parameters Acceptable Values Parameter(precede each with a '-') Default Value bright=n 0 -9 to 9 Set the brightness of the image Higher values result in brighter images. colormatch=n 0 0, 1 Turn off / on colormatch mode contrast=n 0 -50 to 50 Set the contrast of the image. Higher values result in higher contrast.
Appendix A:vvprint/vvlpr Commands & Parameters Acceptable Values Parameter(precede each with a '-') Default Value colormatch=n 0 0 to 3 Select the PG-4000’s internal colormatch setting: 0 none 1 CG process 2 photo process 3 standard process contrast=n 0 -9 to 9 Set the contrast of the image. Higher values result in higher contrast. gamma=n 0 0 to 5 Select the PG’s internal gamma setting: 0 default (printer’s internal) 1 1.0 2 1.8 3 2.0 4 2.2 5 2.
Appendix A:vvprint/vvlpr Commands & Parameters Parameter(precede each with a '-') Default Value redbal=n greenbal=n bluebal=n 0 Acceptable Values -9 to 9 Explanation Set the color balance of a specific color channel: red, green, and blue. Some early PG-4000’s need -9, -1, -7 respectively to neutralize a purple cast in gray scale images.
Appendix A:vvprint/vvlpr Commands & Parameters 36 - PShop User’s Guide
Appendix B:Device Driver Configuration Appendix B: Device Driver Configuration PShop User’s Guide - 37
Appendix B:Device Driver Configuration Overview The first part of this section describes the format of the ID files which are used by PShop to define printer configurations. The second part describes ID file extensions, particularly the use of Ghostscript and PostScript Printer Description (PPD) files ID Files PShop uses ID files to determine configurations for different printers.
Appendix B:Device Driver Configuration Fax_port: Printer_port: Print_queue: none parallel deskjet Device_driver: DPI: Paper_width: Paper_height: Left_margin: Right_margin: Top_margin: Bottom_margin: VVP_Opts: cdj550 300 10200 13200 300 300 48 708 bright=75 Tag: Device_driver: VVP_Opts: mono cdjmono bright=25 Tag: DPI: VVP_Opts: draft 75 -r75x75 Tag: DPI: GS_Opts: hires 600 -r600x600 The first line of the file must match exactly as it appears above, as this identifies the file as an ID file.
Appendix B:Device Driver Configuration For a complete list of the default tags included with PShop, please check our website: http://www.vividata.com/SupportShop/tagref.
Appendix B:Device Driver Configuration ID File Field definitions Fields: Option Name Explanation Name The printer's name. Displayed in ps_install or ScanShop's printer selection menu. Scanner_port For a multi-function peripheral, the scanner port. Default value is “none”. Fax_port For a multi-function peripheral, the faxmodem port. Default value is “none”. Printer_port The port which your printer is connected to.
Appendix B:Device Driver Configuration Option Name Explanation VVP_Opts A vvprint command line option to use by default. Refer to Appendix A for a list of available options. GS_Opts Option(s) to pass to Ghostscript, only used by Ghostscript printers (i.e. non-SCSI/GPIB, non-PostScript). You can specify more than one option by separating each with a space Tag Name of an optional subsection. Use the vvprint command line option “tag” to specify an optional subsection to use.
Appendix B:Device Driver Configuration Ghostscript Parameters Parameter Explanation General Controls -r -rx Device resolution in dots per inch. @ A Ghostscript command line file to use. HP DeskJet 300, 400, 500, 600, 800 Series Specific Controls (All Deskjets are supported except the “PPA” printers such as the 720 and 820 series and the DeskJet 1000.) -dBitsPerPixel= 1, 3, 8, 16, 24, or 32. The output color depth.
Appendix B:Device Driver Configuration Parameter Explanation -dSoftweave Enable software weaving. -sDithering= Dithering algorithm. Use this option with “gsmono” or “fsmono” to force monochrome output.
Appendix B:Device Driver Configuration Using PostScript Printer Description (PPD) Files with PShop A PPD file contains sections of PostScript code that control particular features of a PostScript printer. Each section is identified by a keyword and often options associated with the keyword. For example, there may be the keyword “*ManualFeed” that corresponds to the printer's manual feed feature. It may have the options “True” and “False” to tell the printer whether or not to use manual feed.
Appendix B:Device Driver Configuration Paper_width: Paper_height: Left_margin: Right_margin: Top_margin: Bottom_margin: Ppd_file: 10200 13200 300 300 300 300 $VV_HOME/id/ppdfile.ppd The “Ppd_file” field contains information about the full path (or a path relative to $VV_HOME) of your PPD file. Specifying PPD File Options To tell PShop what features to activate in the printer, you need to specify PPD keyword/option pairs on the command line.
Appendix C:Accessing Network Printers Appendix C: Accessing Network Printers PShop User’s Guide - 47
Appendix C:Accessing Network Printers Background In addition to printing to local printers on the parallel port or SCSI bus, PShop can also be used for network printing. The network printers supported can be any of the normally supported printers made accessible over the network via JetDirect with HP's JetAdmin software or via TCP/IP (implicitly with RFC 1179 capability).
Appendix C:Accessing Network Printers http://www.cis.ohio-state.edu/htbin/rfc/rfc1179.html Printers with the built-in TCP/IP protocol capability vary somewhat in the name each uses for its logical printer - each is named as if it were a print queue on the “local host”. Please consult the support area of Vividata’s website for details.
Appendix C:Accessing Network Printers These local queue’s interface script differs from the normal interface scripts in that instead of running vvprint to print to the printer directly, vvprint is run to create an output file (in the protocol designated in the .id file). This temporary file is then submitted automatically with a new lp/lpr command into remote queue. Remote queues may be those of either JetAdmin (for JetDirect printers), Lantronix, or the UNIX system (for TCP/IP printers).
Appendix D: Troubleshooting Overview This chapter offers some troubleshooting hints as well as brief pointers to maximize operation efficiency. Getting Help Read this section of the manual This section of the manual contains useful information on common problems and troubleshooting. If you do not find an answer please go to our website’s support section. Submitting a Question to the Support Department At the Vividata Website http://www.vividata.com you will see a link “Contact Support”.
Appendix D:Troubleshooting If you have never run Vividata software before, the license manager will not be running. This is normal. The license manager is started automatically the first time you run PShop. Try running PShop to start the license manager, then run vvlmstatus again. If the license manager is still not running or shows errors, verify that a license key is installed on your system. The file $VV_HOME/config/license.dat contains your license key(s).
Appendix D:Troubleshooting vvdrv.rc The vvdrv.rc file located in the /tmp directory will display what SCSI devices our software found at boot and is able to communicate with. Those devices supported by our software will be listed as supported. We also include a utility called vvshowdevs that will rescan your SCSI bus for devices that may not have been ready or available at boot. This utility is run from the command line and will display its results for you.
Appendix D:Troubleshooting parameters are being passed to GhostScript and whether the file sent to the print queue is sent correctly. e-mail from lp On some systems (particularly SVR4-based systems), lp will send e-mail to you describing the exit code of a PShop print job if the job was not successful. The exit code is more useful in detecting usage problems than configuration problems. The table below lists possible exit codes and an explanation of each.
Appendix D:Troubleshooting Printing System Type OS/CPU Port Names (parallel; scsi) Printer Interface Script HP-UX 9.x SVR4 /dev/plt_parallel; /dev/scsi/* /usr/spool/lp/interface HP-UX 10.x SVR4 /dev/lp; /dev/scsi/* /etc/lp/interface OSF/1 BSD /dev/lp0; /dev/cam $VV_HOME/config Solaris 2.x (SPARC) SVR4 /dev/bpp0 or /dev/ecpp0; /dev/vvsc* /etc/lp/interfaces Solaris 2.x (x86) SVR4 /dev/lp1; /dev/vvsc* /etc/lp/interfaces SunOS 4.
Appendix D:Troubleshooting described in the following table: OS/CPU SCSI Port Names Installation Requirement AIX /dev/scsi* vv_install IRIX /dev/scsi/* none HP-UX 9.x /dev/scsi/* none HP-UX 10.x /dev/scsi/* vv_install OSF/1 /dev/cam none Solaris 2.x /dev/vvsc* automatic by Installer SunOS 4.x /dev/vvsc* vv_install Problems and Solutions This section lists some common problems in configuring and using PShop and presents possible solutions to them.
Appendix D:Troubleshooting $VV_HOME $VV_HOME/bin $VV_HOME/bin/vvprint $VV_HOME/bin/gs $VV_HOME/config /tmp (the TMPDIR directory) (read/write/execute) Symptom: The.results file indicates: “No write access to specified port or port open fail.” Possible causes and solutions: • The incorrect “Printer_port” value is set in the ID file, or the value is simply “parallel”. Make sure the correct value is set.
Appendix D:Troubleshooting have the printer connected via a switch box, remove the box and make the connection directly. If you are using a long parallel or SCSI cable, try a shorter one. • The printer is out of paper. • You are printing to a file or printing PostScript to a SCSI printer or network printer, and “lp” does not have write permission in /tmp (the TMPDIR directory). • The printer cable is plugged into the wrong port at the back of the computer.
Appendix D:Troubleshooting have a current version), or you can purchase a non-expiring key by contacting Vividata. • PShop cannot find the license server or license file. Follow the instructions in Verify Licensing above. Symptom: Printer outputs garbage characters. Possible causes and solutions: • You have the wrong printer driver selected in the ID file.
Appendix D:Troubleshooting Possible causes and solutions: • Your /tmp (the TMPDIR directory) does not have adequate free space. Use an alternate temporary directory (specified by the TMPDIR variable in the printer interface script) or increase the amount of space in /tmp. • You are printing to a SCSI/GPIB printer and there is an old /tmp/gs_errs file that is not being deleted. Manually delete this file and retry.
Appendix D:Troubleshooting Ghostscript) referenced in the printer's ID file (mainly only in the “alternate” ID files). This file contains some simple transform matrices that you may alter to improve your image. • Your SCSI device ports do not have read and write permissions set for all users. Refer to the “SCSI Drivers” section to determine the name of the SCSI drivers on you system, and check the permissions on those files.
Appendix D:Troubleshooting • You have more than 4 SCSI buses on your system and your scanner is connected to a bus other than 0, 1, 2, or 3. ScanShop only supports up to 4 SCSI buses. Connect the scanner to bus 0, 1, 2, or 3, or reassign the bus number. Symptom: PShop gives the error message: “Error opening printer. Device model is unlicensed.” or “Warning: Not licensed for this printer.” Possible causes and solutions: • You do not have the correct licensing level to use a particular printer model.
Appendix D:Troubleshooting Patches It is suggested that the operating system be maintained by installing the most current patches available from the platform vendor, as certain (possibly known) bugs can affect the operation of PShop. Check Vividata’s release notes and the support areas of our website for mention of any specific known problems which can be fixed with certain patches.
Appendix D:Troubleshooting 64 - PShop User’s Guide
Appendix E: License Manager Commands Overview Publicly distributed versions of Vividata products use a proprietary license manager. This section will describe the usage of the license manager as it pertains to Vividata products, including determining the lmhostid necessary for license keys to be issued, diagnosing the license keys and license server, and additional configuration information.
Appendix E:License Manager Commands product may be stored in one license key. License keys for more than one Vividata product may be included on separate lines in the same license file. Obtaining your lmhostid If you have a Vividata product installed on your system, you can simply run “vvlmhostid” to determine the lmhostid on your system.
Appendix E:License Manager Commands Table 1: lmhostid derivations Platform Windows NT Source ethernet address User command Example Programs: Administrative Tools (common): Windows NT Diagnostics: Network: Transports:Address Programs: Administrative Tools (common): Windows NT Diagnostics PShop User’s Guide - 67
Appendix E:License Manager Commands Command Reference vvlmstat NAME vvlmstat – Displays the current status of the license manager. SYNOPSIS vvlmstatus DESCRIPTION vvlmstatus checks the current state of the license manager and reports how many keys are available for each product for which you have a license key.
Appendix E:License Manager Commands vvlmstop NAME vvlmstop – Shuts down the license daemon SYNOPSIS vvlmstop DESCRIPTION vvlmstop shuts down the license manager process if it is running.
Appendix E:License Manager Commands vvlmhostid NAME vvlmhostid – Prints the lmhostid of the system SYNOPSIS vvlmhostid DESCRIPTION vvlmhostid prints the machine id (lmhostid) of the system, usually used for generating license keys.
Appendix E:License Manager Commands vvlmreread NAME vvlmreread – Forces the license daemon to reread the license file SYNOPSIS vvlmreread DESCRIPTION vvlmreread causes the vendor daemon to reread the license file and update itself on any new feature licensing information.
Appendix E:License Manager Commands Key Read program NAME KeyRead – Utility that decodes the features from a license key; the name varies with the product. SYNOPSIS KeyRead -k [key string] DESCRIPTION The key read program permits you to view what options and licenses are encoded within the license key string. Pass the key string listed in your license file to the key read program to verify the features, number of licenses, and product enabled by that key string.
Appendix F: Software Look Up Tables Overview New in PShop version 5.1 is the facility for software look up tables for color management. This chapter provides a brief introduction to creating and using software Look Up Tables (LUTs).
Appendix F:Software Look Up Tables The heading is case insensitive and is followed by lines with a single data value per line. The lookup tables can appear in any order but all three must be present and must have the correct number of entries and valid data. RGB to RGB: This is a 768 entry table used to map the value of a 24-bit RGB pixel into another RGB pixel. Each line contains a decimal value in the range of 0 through 255.
Appendix F:Software Look Up Tables If the swlut command line option is not specified, the input data are passed to the printer unmodified. The printer will then print the data based upon its internal settings. If the printer is a Kodak printer and the command line option ptf_file is specified a Kodak .TBL (“Tablemaker”) file will be downloaded to the printer. The command line options swlut and ptf_file are not mutually exclusive for the Kodak printers.
Appendix F:Software Look Up Tables 76 - PShop User’s Guide
Appendix G: Glossary Glossary term Term definition ADF Automatic document feeder ASCII An acronym for American Standard Code for Information Interchange. A code in which the numbers from 0 to 127 stand for text characters. ASCII code is used for representing text inside a computer and for transmitting text between computers or between a computer and a peripheral device. bit-mapped image A collection of bits (dots) in memory that represent the scanned image.
Appendix G:Glossary Glossary term Term definition monospaced font Any font in which all characters have the same width. For example, in Courier New (a monospaced font), the letter “M” is the same width as the letter “l”. Thus, “MMMMM” is the same width as “lllll”. peripheral At or outside the boundaries of the computer itself, either physically (as a peripheral device) or logically (as a peripheral card). pixel Pixel is short for picture element. A point (dot) on the graphics screen.
Appendix G:Glossary Glossary term Term definition text file A file containing information in text form; its contents are interpreted as characters encoded using the ASCII (or comparable) format. TIFF An abbreviation for tagged image file format. This is a standard graphic file format for grayscale and high-resolution bit-mapped images.
Appendix G:Glossary 80 - PShop User’s Guide
Index bilinear 27 bitmap image 24 bit-mapped image 77 brightness option 60 BSD style print 3 bspline 27 Symbols "Install Printer" xviii .
EPSI 5 Epson 60 Epson Ethernet/EtherTalk interface card Ethernet 48 exit codes 54 Extended Systems 49 troubleshooting 49 I F file swap 78 text 79 font monospaced 78 proportional 78 FujiFilm Pictrography PG-3000 and PG-4000 FujiFilm Pictrography PG-3000 controls 32 FujiFilm Pictrography PG-4000 controls 33 G garbage characters 59 Generic PostScript Printer 45 Getting Help 51 GhostScript 6, 38, 42, 60 Ghostscript command failed 57 printer 53 Ghostscript options GS_Opts 42 GIF 5, 22 GNU 4 GPIB 6 gs_errs f
Kodak printers command line options, PTF files 42 Tablemaker 42 Kodak XL-7700/XLT-7720 specific controls Kodak XLS-8600/8650 controls 32 P mitchell 27 mpage 60 paper size 38 parallel interface printer xviii parallel ports 6 Parameter Table 26 patches 63 PBM 5 PDF 5 Pegasus 20 peripheral 78 PG-3000. See FujiFilm Pictrography PG-3000 PG-4000.
RFC 1179. See network printing RGB file format for SGI. See SGI RGB RIP 1, 4 RISC 1 RTEL 50 S scaling 27 ScanSoft iii SCSI 6, 57 conflicting ID 61 device ports 55 termination 61 SCSI/GPIB 60 SCSI/GPIB printer 60 SGI RGB 5 software look up tables look up tables 73 Solaris 2.x 55 SPARC Printer xviii SPARCprinter 57 doesn’t print 57 SPARCstation 2 58 stcolor.id 45 Sun Raster 5 SunOS 4.x 55 swlut 75 System 5 4, 11 system requirements ix T type conventions ix U Ultra 5, 10, 30 or 60 xviii V vividata.
