NAME

printtool - OpenWindows tool for printing files

SYNOPSIS

printtool [ −P printer ] [ −v ] [ −?  ]

AVAILABILITY

This command is available with the OpenWindows environment.  All OpenWindows standard tools use the OPEN LOOK Graphical User Interface (GUI). 

DESCRIPTION

printtool is a user interface to the lp(1), cancel(1), and lpstat(1) operating system printing functions. 

printtool is an OpenWindows based XView application that uses the lp(1) command to print files.  By specifying a filename, printer name, number of copies to be printed, any header page, method to notify all jobs done and any user specified print method, the user can print files, get status on files printed and remove files from a printer queue. 

OPTIONS

printtool accepts all the generic tool arguments described in xview(1).  In addition, it can accept these options:

−P printer
Send output to the named printer.

−v Show the version number and the usage message of this release of the printtool program. 

−?  Show the version number and the usage message of this release of the printtool program. 

USAGE

printtool is part of the OpenWindows user environment. 

The user must specify a filename in the ‘Filename:’ text field, choose a printer from the printer options and specify the number of copies to print.  Selecting ‘Print’ prints the file.  You can drag and drop a file from filemgr(1) or a mail message, an attachment from mailtool(1) onto an open printtool drop target or icon, instead of typing a name in the ‘Filename:’ text field.  For dropping onto the drop target, selecting ‘Print’ is required.  You can get the status of the printer queue automatic or with ‘Status’.  To remove a printing job, you can select a job in the status window, then the ‘Stop Printing’ will be enable and then select ‘Stop Printing’. 

The header option in the printtool window allows user to set it per job or globally.  This will override whatever it sets in the properties window. 

A print method can be invoked interactively by first setting the "Override Default Print Method" option in the properties window, then entering the print method in the space provided. This lets user has better control on how the file to be printed.  printtool will not add, append or pipe anything to/from the print method.  User can use environment variables $FILES, $PRINTER, $LPDEST and $COPIES, which are specified in printtool, to write their own print method.  For instance, the entry:

cat $FILE | mp -l | lp -d $PRINTER -T postscript will print the file at the selected printer with landscape format. 

‘Information...’ button brings up a text window which is the place system administrators can put information about the selected printer.  It will have default text if no information is available on the printer. 

‘Properties...’ button brings up a dialog that allows the user to specify options. These include with header page or not, method to notify when all jobs done and whether to override default print method or not.  ‘Apply’ options only set options for current process.  printtool will only remember all default options which set last time for next run. 

RESOURCES

On startup, printtool uses the following resources which are store in $HOME/.desksetdefaults:

Resource: deskset.printtool.checkInterval

Values: Status check interval (numeric)

Description This is the number of seconds between status checks on the printer.  The default value is 10 seconds. 

Resource: deskset.printtool.headerPage

Values: true, false

Description This is the flag for printing with header page or not.  The default value is false (no header page). 

Resource: deskset.printtool.printMethodOverride

Values: true, false

Description This is the flag for overriding the default print method.  The default value is false (use default print method which determined by Classing Engine). 

Resource: deskset.printtool.lastPrintMethod

Values: Print method string or full path of script string

Description This is the print method for printing instead of the default method if deskset.printtool.printMethodOverride is set to true. 

Resource: deskset.printtool.notifyFlash

Values: true, false

Description If set to true, printtool will flash the window or icon when all print jobs are done.  The default value is false (no flash). 

Resource: deskset.printtool.notifyBeep

Values: true, false

Description If set to true, printtool will beep when all print jobs are done.  The default value is false (no beep). 

SEE ALSO

accept(1M), cancel(1), enable(1), filemgr(1), lp(1), lpadmin(1), lpfilter(1M), lpstat(1), lpsystem(1M), mailtool(1)
OpenWindows user documentation
"About Print Tool" in the Help Handbook available through the Help option on the Workspace menu.

DIAGNOSTICS

See lpstat(1) diagnostics. 

BUGS

See lp(1), lpstat(1) bugs. 
 

SunOS 5.2  —  Last change: 2 December 1992