NAME

dtprintegrate − integrate a printer into the desktop

SYNOPSIS

dtprintegrate [-d destination] [-i icon_name] [-h help_text | -f help_file] [-r] [-u] [-v] printer_name

DESCRIPTION

The dtprintegrate utility, run at printer installation time, accepts a small number of parameters and creates the appropriate desktop configuration files for easy user access. 

After the system administrator has run dtprintegrate, the end user will see an icon for the new printer in the Printers container, part of the Application Manager.  By dropping a file on this printer icon, the user invokes the Print action for that filetype, with the LPDEST destination set appropriately.  By double-clicking the printer icon, the user invokes the PrintManager action for that printer. 

Because it writes in system configuration directories by default, dtprintegrate is usually run at a privileged level. 

OPTIONS

-d destination
Specifies the printer destination as known to the print spooler (if different from the printer_name). 

-i icon_name
Include the icon file name to represent the printer on the desktop. The icon_name may consist of just the basename (e.g., laser3) or a complete file name (e.g., laser3.l.pm).  The directories listed in the DTPRINTICONPATH environment variable will be searched for icons matching the basename. Any found will be copied to the DTPRINTERICONFOLDER subdirectory.  (See the ENVIRONMENT section below.)  If an icon cannot be found on the search path a warning message will be issued and the default printer icon will be used. 

-h help_text
Specifies the help_text to be displayed when the user invokes help on the printer icon, typically by pressing function key 1 when the printer icon is selected. 

-f help_file
Read the contents of the entire help_file into the descriptive help for the printer. 

-r Forces the action database to be reloaded.  Normally, the actionbase is reloaded only when the printer is integrated on the local desktop host.  This option is useful when adding a printer by means of an X station. 

-u Causes the named printer to be un-integrated.  That is, its desktop configuration files will be removed from the configured locations on the session server. 

-v Causes the utility to print a log of its actions.  By default, the command operates silently. 

printer_name
Names the printer as it will be presented to the end user.  By default, also names the printer as it is known to the lp print spooler.

RETURN VALUES

0 Command completed sucessfully. 

1 Command completed unsucessfully due to a usage error. 

2 Command completed unsucessfully due to a configuration file creation error. 

ENVIRONMENT

DTPRINTERFOLDER
Causes the dtprintegrate command to install the Printer action file in the specified subdirectory.  Default value is /etc/dt/appconfig/appmanager/C/Printers, where it will be presented under the Printers container of the Application Manager. 

DTPRINTACTIONFOLDER
Causes the dtprintegrate command to install the Printer action definition file (∗.dt) in the specified subdirectory.  Default value is /etc/dt/appconfig/types/C. 

DTPRINTICONPATH
Sets the path to search for icon images.  The path may consist of a comma-separated list of subdirectories. Default value is .,$HOME/.dt/icons,/usr/dt/appconfig/icons/C. 

DTPRINTERICONFOLDER
Specifies the subdirectory where printer icons should be installed for the desktop.  Default value is /etc/dt/appconfig/icons/C. 

LPDEST Set in the Print action by dtprintegrate to specify the printer.  It is honored by the lp print spooling subsystem and by most applications.  It is set to the printer_name as specified on the command line. 

FILES

/usr/dt/appconfig/appmanager/C/Printers
The default location for printer action files shipped from the factory.

/etc/dt/appconfig/appmanager/C/Printers
The default location for configured printer action files.

SEE ALSO

dtappgather(1X). 

DIAGNOSTICS

Unable to create the file <name>
The command probably did not have write privileges to install the named configuration file in the named subdirectory.

NOTES

The Print action is mapped to the appropriate execution string.  For application-specific files (e.g., a file having an application-defined ∗.art suffix), the Print action may map to a command to invoke the application with a -print parameter and with the LPDEST environment variable set to the printer name.   Files that have no predefined Print action mappings will be assumed to be ASCII text files whose Print action is an invocation of the lp spooler for the chosen printer. 

  —  13 May 1994