=======================================================================

UNIX Printing Solution User's Manual for 
Aficio CL3000e/CL3100N/CL2000.

Copyright 1999 - 2004 RICOH Corp.
All rights reserved.

Last Updated: December 14, 2004
Version: 11.2

=======================================================================

Software License Agreement

YOU, THE END USER, SHALL USE THIS SOFTWARE("THE SOFTWARE") ACCORDING TO
THE TERMS OF THIS AGREEMENT. BY LOADING THE SOFTWARE INTO ANY COMPUTER,
YOU ARE AGREEING TO BE BOUND BY THESE TERMS. IF YOU DO NOT ACCEPT THE
TERMS OF THIS AGREEMENT, YOU MAY NOT LOAD THIS SOFTWARE INTO ANY
COMPUTER.

Grant of License
The Software is licensed for use by you for the equipment packaged with
the Software or designated by its supplier ("the equipment"). You are
permitted to use the Software on any computer which permits electronic
access to the equipment. You are not permitted to rent or lease the
Software or to transfer your rights under this license to a third party.

Acceptance
You shall be deemed to have accepted the terms of this Agreement by
loading the Software into any computer.

Duration
This license is effective until terminated. The license will terminate
where you fail to comply with the terms of this Agreement. Upon
termination, you agree to destroy all copies of the Software and its
documentation.


Ownership of Software
You own, if any, only the magnetic media on which the Software has
been delivered. It is an express condition of this Agreement that the
title and ownership of the Software shall be retained by its owners.


Copying
The Software and its documentation are the subject of Copyright. You
may not make any copies nor cause others to make copies of the
Software except such copies as are necessary for licensed use and one
copy for operational security. Any such copies are subject to the
conditions of this Agreement. You may not modify, adapt, merge,
translate, reverse engineer, decompile, disassemble or create
derivative works based on the whole or any part of the Software or its
associated documentation. You may be held legally responsible for any
copyright infringement, unauthorized transfer, reproduction or use of
the Software or its documentation.

Limitation of Warranty
The media, if any, not the Software contained therein, is warranted to
the original purchaser against defects in material and workmanship for
a period of one year from the date of original purchase. Defective
media will be replaced when it is returned to your supplier, postage
prepaid, along with a copy of the purchase receipt.

THESE RIGHTS ARE YOUR SOLE AND EXCLUSIVE REMEDY, WHETHER IN TORT,
CONTRACT, OR OTHERWISE. IN NO EVENT SHALL SUPPLIER, OWNER OF THE
SOFTWARE OR ITS LICENSORS BE LIABLE FOR DAMAGES (INCLUDING ANY FOR LOSS
OF INFORMATION, PROFITS, SAVINGS OR BUSINESS INTERRUPTION OR OTHER
DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL OR SPECIAL DAMAGES) ARISING
OUT OF THE SOFTWARE OR THE USE THEREOF, OR THE INABILITY TO USE THE
SOFTWARE.


Exporting Law
You acknowledge that the export of the Software is governed by the
export control laws of the United States and other countries. You agree
to comply with all such export control laws.


Governing Law and Jurisdiction
If any provision or portion of this Agreement shall be found to be
illegal, invalid or unenforceable, the remaining provisions shall remain
in full force and effect. This Agreement shall be governed by the laws
of California, USA and is subject to the jurisdiction of the Federal
District courts for the Central District of California by a judge and
not a jury.

=======================================================================

Table of Contents
	1. Introduction
	2. Supported UNIX Platforms
	3. System Requirements
	4. Installation and Uninstallation
		4.1 Requirements
		4.2 Installation
		4.3 Uninstallation
	5. Specifying Device Options
	6. Limitations and Known Issues
		6.1 Function-related Issues
		6.2 OS-related Issues
	7. Release File Contents
	8. Device Option Support
		8.1 Device Options
		8.2 Constraints

=======================================================================

1. Introduction

The UNIX Printing Solution enables users on the UNIX network
environment to use the rich array of print features supported by the
printers. Depending on the model of the printer, these features may
include duplex printing, stapling, punching, input/output tray
selection, paper size selection, media type selection, filter banner
page, print quality and color-related feature selection etc.

The user is expected to use the UNIX command "lp" to print an input
file. Device option are specified by using the "-o" option of the
"lp" print command.

The UNIX Printing Solution supports printing of input files of Text,
PostScript and other types. But support of device options is provided
only for input files of Text and PostScript types. The UNIX Printing
Solution utility can automatically detect the type of input files
specified on the command line if each file is of an unique type
(i.e., it cannot be a combined stream of more than one different types).
Alternatively, the user can use the file type option "-o text", "-o ps" 
or "-o nofilter" to specify the input file of Text (or ASCII),
PostScript or any other type respectively. When used, these options 
will overridethe result of automatic file type detection. 
Please note that in case the multiple input files on the command 
line are of different types, the user should not use the above type 
options and should instead leave it to the utility to detect the file types.

The device option support in this utility is achieved by inserting
appropriate printing commands into the original input document to
perform print features specified by the user. More specifically, PCL
commands are used in case of a Text input file and PostScript commands
are used in case of a PostScript input file. If the input file is of
any other type as detected by this utility or specified by using the
"-o nofilter" option, this utility will do nothing but dumping the
input file to the printer.

The UNIX Printing Solution is provided with an all-in-one installation
program that easily installs this utility on the user's system.

=======================================================================

2. Supported UNIX Platforms

The UNIX Printing Solution is supported on the following UNIX systems.

   . Sun Solaris 2.6, 7, 8 and 9
   
   . HP-UX 10.x and 11.x/11iv2
   
   . IBM AIX V4.3/5L V5.1 & V5.2
   
   . SCO OpenServer 5.0.6, 5.0.7
   
   . RedHat Linux 6.x, 7.x, 8.x, 9 (The printing system needs to be switched to LPRng)
   
   . RedHat Linux Enterprise: 
   
       The printing system needs to disable the CUPS, then install the LPRng
       Printing software package, It can be download at http://www.LPRng.org.
        
   
=======================================================================

3. System Requirements

The following are required for installation of the UNIX Printing
Solution:

	. a supported printer with valid TCP/IP network connection
	. a supported UNIX platform

=======================================================================

4. Installation and Uninstallation

4.1 Requirements:

A supported printer with a valid IP address on a TCP/IP network

4.2 Installation:

The following steps need to be followed to install the UNIX Printing
Solution:
	1) User login as "root"
	2) Create a new temporary directory. If you use the default /tmp
	   directory, installation may fail
	3) Change to the temporary directory created
	4) Extract files from the distributed tar file, using the command
	   "tar -xvf file_name". The installation program "unix_installer",
	   together with other files, should now exist in this directory
	5) Make sure "unix_installer" has execution permission. If not,
	   use the command "chmod" to change the mode of the program to
	   be executable
	6) Type "./unix_installer" and hit Enter to start the
	   installation
	7) Follow the instructions on screen and answer the questions

During installation, user is prompted for the following information:
	. A valid IP address for the printer
	. A name for the installed printer

The installation creates two printer entries for device option support,
one remote and another local. The local entry is named with the printer
name provided by the user during installation.

User can verify a successful installation by issuing one of the
following commands:
	. On Sun Solaris, HP-UX:	lp -d PRINTER_NAME test_file_name

	. On IBM AIX: 			qprt -PPRINTER_NAME test_file_name

	. On Linux:			lpr -PPRINTER_NAME test_file_name

	. On SCO OpenServer:		lp -d PRINTER_NAME test_file_name or
					lpr -d PRINTER_NAME test_file_name

4.3 Uninstallation:

The following steps need to be followed to un-install the UNIX Printing
Solution:
	1) Login as "root".
	2) Type "./uninstall [Printer_Name]" and hit Enter to start the
	   uninstallation
	3) Follow the instructions on screen and answer possible questions

If a version of this utility is already installed on the system, the
user needs to uninstall the utility before installing a newer version
of this utility.

Please note that uninstallation does not remove all the files related to
this utility. User needs to manually remove the files if this is desired,
by following these steps:

On Sun Solaris, HP-UX:
        (1) Stop LP print service
	    Command: lpshut
	(2) Remove Printer
	    Command: lpadmin  -x PRINTER_NAME
	(3) HP-UX Restart LP Printer service
	    Command: lpsched
	(4) Sun Solaris Restart LP Printer service
	    Command: /usr/lib/lp/lpsched
	(5) Delete printer filter from /etc/lp/interface(s)

On IBM AIX:
	 Delete the printer configuration entries from /etc/qconfig,
	 also delete the printer filter from /usr/local/bin/myfilter.
On Red Hat Linux:
 	Delete the printer configuration entries from printcap file
	(/etc/printcap or /etc/printcap.local by default), then delete the
	queue directories for the printers in (/var/spool/lpd, by default).
	User may also need to delete the filter from /usr/share/linux_filters
	(default).

On SCO OpenServer 5.0.6:
	Delete the printer configuration entries from printcap file, then
	delete the queue directories for the printers. If the utility was
	installed with device option support,
        (1) Disable print queue
	    Command: disable PRINTER_NAME
	(2) Remove Printer
	    Command: lpadmin  -x PRINTER_NAME


=======================================================================
5. Specifying Device Options

The user is expected to use the UNIX command "lp" to print a input file.
The device options are specified by using the "-o" option of the "lp"
command. There is no limit on the number of "-o" options that can be
used. The user can specify any valid device options supported by this
utility. The supported device options can be found in Section 8 of this
document.


The "lp" command has local variations on different UNIX platforms. The
following are the syntax of the command on different UNIX systems:

	1. On Sys V like UNIX, such as Sun Solaris, HP-UX and SCO
	   OpenServer:
	     lp -d <printer_name> -o option1=value1 -o option2=value2...
   	     <file_name>

	2. On BSD like UNIX, such as RedHat Linux:
   	     lpr -P <printer_name> -Z option1=value1 -Z option2=value2...
   	     <file_name>

	3. On IBM AIX:
   	     qprt -P <printer_name> -o option1=value1 -o option2=value2...
   	     <file_name>


=======================================================================

6. Limitations and Known Issues

6.1 Function-related Issues

	. When specifying the use of certain device options, the user
	  needs to make sure printer accessories necessary for the
	  desired functions are installed on the printer. For example,
	  a finisher with stapling capability needs to be installed in
	  order to perform any stapling function. The utility itself does
	  not enforce or check this kind of constraints. For the
	  information of constraints of supported device options for each
	  printer, please refer to Section 8 of this document.

	. Also it is the users responsibility to make sure that the
	  combination of options specified generates a meaningful output.
	  For example, a side binding duplex output should not be stapled
	  with options like "Top 2". The utility itself does not check
	  the validness of the print output.

	. The user needs to keep in mind that the UNIX print command "lp"
	  does not provide status feedback from a remote printer.
	  Therefore it may not be possible to get feedback information
	  from the printer or cancel a print job. This is the way the
	  "lp" command is implemented on UNIX systems.

	. The device options supported in this utility are based on the
	  PostScript drivers on the MS Windows 2000 platform. Due to
	  implementation difficulties on UNIX platforms, some print features
	  supported in the PostScript driver on MS Windows 2000 platform are
	  not included in this utility. These features include the following:

		- Pages per Sheet (N-Up)
		- Page Order
		- Scaling
		- Custom Paper Size
		- Mirrored/Negative Output
		- Font-related features in PostScript
		- PostScript Output features (optimized for speed, optimized
		  for portability, EPS, Archive format)
		- Watermark-related features
		- ICM (Image Color Management) features

	. Also due to implementation difficulties on UNIX platforms, the
 	  device options supported for Text and for PostScript input files
	  may be different.

	. Some of the device options found in the PPD files of the
	  corresponding PostScript/Windows 2000 driver are not supported
	  if these options are not on the GUI of the driver.

	. Device options set by using this UNIX Printing Solution will
	  overwrite options set by applications.

	. For some printers, Duplex/Staple/Punch may fail if the paper
	  feeding direction (Short Edge Feeding/Long Edge Feeding) is not
	  compatible with the current selection of Duplex and Orientation.

	. The user is advised to use the Standard input tray when duplex,
	  stapling and punching are also specified.

	. The user is advised to specify paper size before specifying
    	  input tray on the command line.

	. If both Orientation and Line Per Inch(lpi) need to be specified,
	  the user needs to specify Orientation before specifying Line Per
	  Inch.

	. Limitations regarding automatic file type detection
		- PostScript files that do not have PostScript header
		 (such as %!PS) might not detected correctly.

	. Limitations regarding Filter Banner Page
		- On HP-UX, the print request id is displayed instead of
		 "Job Name" (file name).
	. The Unix Filter doesn't support CUPS(Common Unix Printing System)
	  It suppprots only LPRng.
6.2 OS-related Issues

	. Device option support is tested only on the following UNIX
	  platforms:
		- Sun Solaris 2.6, 7, 8 and 9
		- HP-UX 10.x/11x/11iv2
		- RedHat Linux 6.x, 7.x, 8.x, 9 and Enterprise
		- IBM AIX V4.3/5L V5.1 & V5.2
		- SCO OpenServer 5.0.6, 5.0.7
				
	. IBM AIX 4.x, 5.x Issues
	  This utility is tested only on "IBM AIX Printing System".
	  IBM AIX may offer both IBM AIX and System V printing systems.

	  On IBM AIX 5.1, before running unix_installer to install a
	  printer, the user needs to manually edit the file hosts under
	  /etc to add a line of IP address and host name for the printer
	  to be installed.

	  Use "-o nn=#" to specify the number of copies.

	. Red Hat Linux 7.1 Issues
	  System utilities like the "printtool" on Red Hat Linux 7.1
	  will overwrite any previous changes made to "/etc/printcap".
	  User is advised to choose "/etc/printcap.local" during
	  installation to prevent settings being changed by other
	  utilities. The installation program choose
	  "/etc/printcap.local" by default.

	. Red Hat Linux 7.0 Issues
	  LPRng and file package are required for device option support.
	  They are installed by default for Red Hat Linux 7.0 or above.

	  Use "-Znn=#" to specify the number of copies. Generic "lp"
 	  command option "-K #" is disabled for device option support
	  because it may not work properly for collate printing, Sample
	  Print or Locked Print job type printing and filter banner page
	  printing.

	  Printers installed will not show up in PRINTTOOL.

	. HP-UX Issues
	  Printer name chosen on HP-UX 10.x or 11.x should be limited
	  to no more than 11 characters.

	  User should use the option "-n#" to specify number of copies.

	. Sun Solaris Issues
          User should use the option "-n#" to specify number of copies.

	. SCO OpenServer 5.0.6 Issues
          User should use the option "-n#" to specify number of copies.


=======================================================================

7. Release File Contents

The distribution file of the UNIX Printing Solution is
xxxxx_unix_filter.tar. User needs to extract the release files from
the this ".tar" file by using the following command:

	tar -xvf xxxxx_unix_filter.tar

After the extraction, user will see the following files:
	. unix_installer -- the installation program
	. uninstall -- the uninstallation program
	. sol_xxxx -- the filter programs that provide device option
	  support
	. UserManual -- the User's Manual of the UNIX Printing Solution
	. aix_head, aix_tail, lnx_head, lnx_tail -- files needed to
	  modify print filter program on specific UNIX platforms
	. pssample.ps, testsample.txt, pclample.prn under
	  sub-directory /samplefiles -- sample test files each in
	  PostScript, Text and PCL (printer driver output of PCL and
	  PJL stream) type. These files are sample Postscript, Text and 
	  PCL datastream files. These files can be used to troubleshoot 
	  possible file format compatibility issues.
=======================================================================

8. Supported Device Options

This section specifies in detail the supported device options.

Decision on what device options should be supported in this utility are
made based on the following:
	. The device options are supported in the PostScript driver on
	  the MS Windows 2000 platform for this printer

	. Technically the device options should not be prohibitively
	  difficult to implement on UNIX platforms by using the filter
	  capability of the "lp" command's parameters

Some of the supported device options on certain printer models will
produce expected results only under certain conditions. An example is
that certain staple options can be used only when a finisher accessory
with stapling function is installed on the printer and the selected
stapling option conforms to the choice of duplex and possibly, media
type options. Unless these conditions are met, use of the feature may
not produce the expected results. Information regarding this type of
constraints is also provided in this section.

For user's convenience, debugging function of this utility is provided by
using the "-o debug". The output is saved as text files (afc*.tmp) under
"/tmp/".

8.1 Device Options
(For quick reference,please use man page,which is "AficioCL3000".)

File Type: specifies the type of input file.

 	Text file 		-o text

	PostScript file 	-o ps
	
	Others		 	-o nofilter

Note: use of file type options will override the result of this utility's
      automatic file type detection. 



Filter Banner Page: specify the use of a customized banner page that

includes the information of user name, host computer name, print job

name(file name), date, time stamp and version of the UNIX Printing

Solution utility. Filter banner page is off by default until specified

by this option. In case there are multiple input files on the command

line, each will be printed with a filter banner page before it.

	<Filter Banner Page>	-o fbanner

Note: no filter banner page is printed, if job type is specified.



User ID: specifies the User ID of a print job. A legal User ID is a

string of up to 8 alphanumeric characters (a-z, A-Z, 0-9), with no

space in between.

	< USERID>		-o userid=<USERID>


User Code: specifies the User Code of a print job.
           It can be set up as a default value during the installation of 
           unix filter script. 
           A legal User Code is a string of up to 8 digit number (0-9).



Password: specifies the password of a print job. A legal password is a

4-digit number.	

	< PASSWORD >		-o password=<PASSWORD>


The User ID longer than 8, File name longer than 16 and Password longer than 4
will be trimmed.


Job Type: specifies the type of a print job.

	Normal (default)        (no option needed)

	Sample Print		-o jobtype=sample -o userid=<USERID>

 	Locked Print		-o jobtype=locked -o userid=<USERID>

 				-o password=<PASSWORD>

Orientation: specifies print orientation (text input files only)

	Portrait (default)	-o portrait

	Landscape		-o landscape

	Rotated Portrait	-o rportrait

	Rotated Landscape	-o rlandscape

Note: we are currently supporting landscape orientation for PS file.



Collate: specifies whether the print output is collated

	Off(default)		-o collate=off

	On			-o collate=on



Duplex: specifies duplex print

	None (default)		-o duplex=off

	Long Edge		-o duplex=long

	Short Edge		-o duplex=short

Toner Saving (PostScript only)
	
	Off (default)		-o toner=off
	
	On			-o toner=on

Resolution:

	600 dpi(default)	-o resolution=600
	
	1200 dpi		-o resolution=1200


Input Tray Selection: specifies the input paper tray

	AutoSelect(default)	-o itray=auto

	Bypass Tray		-o itray=bypass

	Tray 1			-o itray=tray1

	Tray 2			-o itray=tray2

	Tray 3			-o itray=tray3

	
Output Bin
	Default			-o outbin=default
	
	
Paper Size
	
	A4			-o paper=A4
	
	A5			-o paper=A5
	
	A6			-o paper=A6
	
	B5 (JIS)		-o paper=B5
	
	Letter (default)	-o paper=letter
	
	Legal			-o paper=legal
	
	Half Letter(5.5x8.5)	-o paper=halfletter
	
	Executive		-o paper=executive
	
	Folio(8.25x13)		-o paper=folio
	
	8 x 13			-o paper=8x13
	
	8.5 x 13		-o paper=85x13
	
	Com10 Env		-o paper=envelope

	Mon. Env.		-o paper=env-monarch

	C6 Env.			-o paper=env-c6

	C5 Env.			-o paper=env-c5

	DL Env.			-o paper=env-dl

	16K			-o paper=16k


Media Type: specifies the media type of the paper to be used

	Plain (default)		-o mediatype=plain

	Recycled		-o mediatype=recycled

	Special			-o mediatype=special

	Color			-o mediatype=color

	Letterhead		-o mediatype=letterhead

	Preprinted		-o mediatype=preprinted

	Prepunched		-o mediatype=prepunched

	Bond			-o mediatype=bond

Gradation (PostScript files only)

	Fast(Default)		-o gradation=fast

	Standard		-o gradation=standard

Color / Black and White: (PostScript files only,Default is Color)

	Color 			-o color=yes

	Black and White		-o color=no

Color Settings (PostScript files only)

	Off			-o colorsettings=off

	Fine(Default)		-o colorsettings=fine

	Super Fine		-o colorsettings=superfine



Color Profile (PostScript files only)

	Auto (Default)		-o profile=auto
	
	*User Setting		-o profile=usersetting
	
	Photographic		-o profile=photographic
	
	Presentation		-o profile=presentation
	
	Solid Color		-o profile=solidcolor
	
	
Dithering (PostScript files only)

	Auto (Default)		-o dithering=auto
	
	*User Setting		-o dithering=usersetting
	
	Text			-o dithering=text

	Photographic		-o dithering=photographic

Note: User defined value in color profile & dithering, need to
download the profiles to the printer.


Gray Reproduction  (PostScript files only)
	K (Default)		-o black=k
	CMY+K			-o black=cmyk
	
Black Over Print (PostScript files only)

	Off(Default)		-o blackoverprint=off

	On			-o blackoverprint=on

	
Pages per sheet: print out 2 pages per sheet (2-up layout)

	2-up layout		-o 2up

Note: We are currently supporting only 2-up layout with the text format file.
     (we do not support 4-up).



Font Size (Text Files Only): Specifies the text font size in characters

per inch. This utility will print the document with the specified font

size and adjust the space between text lines accordingly so that text line

overlapping doesn't happen.

	# Font Size		-o fsize#

Note: Font size value (#) should be integers greater than 0. Default is printer's

Default. The real valid range depends on printer's specification for Font Pitch.

Say 1 to 100 for most printers.

When specified, the Character Per Inch(cpi) option will not work.



Line Per Inch (Text Files Only)

	# lpi			-o lpi#

Note: Valid lpi values (#) are 1,2,3,4,6,8,12,16,24 and 48. Default is 6.

Horizontal Motion Index (Text Files Only)

	# hmi			-o hmi#
	
Note: Use the HMI to set the distance between columns you can specify
      a value from 0 to 840. Values can be set to four decimal
      places. No horizontal motion will occur if the HMI is 0.
      The pitch value in the font header equals the default HMI value. 
      The factory default font HMI value is 12 to give 10 characters
      per inch.
      
Vertical Motion Index (Text Files Only)
	
	# vmi			-o vmi#

Note: Use the VMI to set the space between rows. You can specify 
      a value from 0 to 336. The factory default VMI value is 8.
      This is the same as six lines per inch.


Character Per Inch (Text Files Only)

	# cpi			-o cpi#

Note: cpi value (#) should be greater than 0, valid to two decimal places.

Default is printer's default. The real valid range depends on printer's

specification for Font Pitch. Say 0.44 to 99.99 by 0.01 for most printers.

This option will not work when Font Size option is used.



Character compression (Text Files Only)

	Compress		-o compress



Auto Wrap(Text Files Only): specifies automatic end-of-line wrap when a 

line of text reaches the right margin. Default is Off, which usually 

results in clipping of text beyond the right margin.

	Auto Wrap		-o autowrap



8.2 Constraints

Use of the supported device options will produce expected results

only under certain constraints. Device options and their constraints

are:



Duplex:

  Long Edge			* Bypass Tray not selected as input tray

  Short Edge			* Document Server not selected



Input Tray:

  Tray 3			* Lower Paper Trays  installed

  
Character Per Inch (cpi):	* Font Size (fsize) option not specified

				

=======================================================================

End of Document

=======================================================================



