<!-- $XConsortium: printinf.sgm /main/10 1996/10/30 16:29:22 rws $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->
<RefEntry Id="CDEMX.MAN29.rsml.1">
<RefMeta>
<RefEntryTitle>dtprintinfo</RefEntryTitle>
<ManVolNum>user cmd</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Command>dtprintinfo</Command></RefName>
<RefPurpose>the CDE Print Viewer
</RefPurpose>
</RefNameDiv>
<RefSynopsisDiv>
<CmdSynopsis>
<Command>dtprintinfo</Command>
<Group>
<Arg>-p &lt;<Replaceable>printer</Replaceable></Arg>
<Arg>></Arg>
<Arg>-all</Arg>
<Arg>-populate</Arg>
<Arg>-help</Arg>
</Group>
</CmdSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para>The Print Viewer program provides a graphical interface that
displays the status of print queues and print jobs.
Additional information about print queues or print
jobs can be retrieved within the interface, individual print
queue labels and icons can be customized, and individual
print jobs can be canceled. Print jobs can be submitted by
dragging files, text, or attachments from other CDE programs
and dropping them on a print queue icon in a Print Viewer window.
</Para>
<RefSect2>
<Title>KEY SUPPORTED TASKS</Title>
<ItemizedList>
<ListItem>
<Para>Displaying configured print queues on the system.
</Para>
</ListItem>
<ListItem>
<Para>Displaying print queue and print job properties.
</Para>
</ListItem>
<ListItem>
<Para>Changing print queue labels and icons.
</Para>
</ListItem>
<ListItem>
<Para>Submitting print jobs.
</Para>
</ListItem>
<ListItem>
<Para>Canceling print jobs.
</Para>
</ListItem>
</ItemizedList>
</RefSect2>
</RefSect1>
<RefSect1>
<Title>NO OPTIONS</Title>
<Para>When the Print Viewer is started without any options,
it shows the LPDEST printer or the system default printer if
LPDEST is not set.
</Para>
</RefSect1>
<RefSect1>
<Title>OPTIONS</Title>
<RefSect2>
<Title>-p <Emphasis>&lt;printer></Emphasis></Title>
<Para>Display information only for the specified <Emphasis>&lt;printer></Emphasis>.
</Para>
</RefSect2>
<RefSect2>
<Title>-all</Title>
<Para>Display information for all printers.
</Para>
</RefSect2>
<RefSect2>
<Title>-populate</Title>
<Para>The
<Emphasis>-populate</Emphasis> option is available only for root. This
option creates default printer actions for all printers
in /etc/dt/appconfig/types/LANG. If LANG is not defined,
the actions are created in /etc/dt/appconfig/types/C.
The post-installation process uses the
<Emphasis>-populate</Emphasis> feature to create default printer actions in /etc/dt/appconfig/types/C.
</Para>
</RefSect2>
<RefSect2>
<Title>-help</Title>
<Para>Display command line option help.
</Para>
</RefSect2>
<RefSect2>
<Title>-session <Emphasis>&lt;session_file></Emphasis></Title>
<Para>The Print Viewer creates a session file when you exit the desktop. When you
start the desktop again, the Print Viewer uses the session file specified
in the session_file parameter to restore the view settings, which printers are
shown and which printers are opened.
</Para>
</RefSect2>
</RefSect1>
<RefSect1>
<Title>RESOURCES</Title>
<Para>The Print Viewer does not defined any application specific resources.
</Para>
</RefSect1>
<RefSect1>
<Title>ENVIRONMENT</Title>
<RefSect2>
<Title>LPDEST</Title>
<Para>This environment variable determines which print queue to display
when the Print Viewer is started without any options.
</Para>
</RefSect2>
<RefSect2>
<Title>XMICONSEARCHPATH</Title>
<Para>This environment variable determines which icon folders to
search when customizing a printer's icon set.
</Para>
</RefSect2>
</RefSect1>
<RefSect1>
<Title>BROADCAST MESSAGES</Title>
<Para>The Print Viewer responds to ReloadActions messages and sends
a ReloadActions message when you customize a printer's icon name
or icon set.
</Para>
</RefSect1>
<RefSect1>
<Title>WARNING MESSAGES</Title>
<!--Start of RS / RE range-->
<Para>- Are you sure you want to cancel &lt;<Emphasis>job</Emphasis>>? -
</Para>
<!--End of RS / RE range-->
<Para>The Print Viewer displays a prompt before a print &lt;<Emphasis>job</Emphasis>> is canceled.
</Para>
</RefSect1>
<RefSect1>
<Title>EXIT STATUS</Title>
<Para>The following exit values are returned:
</Para>
<VariableList>
<VarListEntry>
<Term>0</Term>
<ListItem>
<Para>Successful completion.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>>0</Term>
<ListItem>
<Para>An invocation error was detected.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</RefSect1>
<RefSect1>
<Title>EXAMPLES</Title>
<RefSect2>
<Title>dtprintinfo</Title>
<Para>Display the status of the LPDEST printer or the system default printer.
</Para>
</RefSect2>
<RefSect2>
<Title>dtprintinfo -p lp0</Title>
<Para>Display the status of the print queue called <Emphasis>lp0</Emphasis>.
</Para>
</RefSect2>
<RefSect2>
<Title>dtprintinfo -all</Title>
<Para>Display the status of all print queues.
</Para>
</RefSect2>
</RefSect1>
<RefSect1>
<Title>RELATED INFORMATION</Title>
<RefSect2>
<Title>CDE Print Specific Actions</Title>
<Para>Two print specific actions are created for each printer on the system.
These actions are defined in &lt;printer>.dt files located in
/etc/dt/appconfig/types/$LANG.
</Para>
</RefSect2>
<RefSect2>
<Title>&lt;printer>_Print</Title>
<Para>This action displays the status of the print queue specified by the
<Emphasis>&lt;printer></Emphasis> parameter.
</Para>
</RefSect2>
<RefSect2>
<Title>&lt;printer>_Print &lt;file></Title>
<Para>This action invokes the Print action for the <Emphasis>&lt;file></Emphasis> on the printer
specified by the <Emphasis>&lt;printer></Emphasis> parameter.
</Para>
</RefSect2>
</RefSect1>
<RefSect1>
<Title>FILES</Title>
<RefSect2>
<Title>dtprintinfo</Title>
<Para>Executable file. This file is located in /usr/dt/bin.
</Para>
</RefSect2>
<RefSect2>
<Title>Dtprintinfo</Title>
<Para>Application defaults file. This file is located in /usr/dt/app-defaults/$LANG.
</Para>
</RefSect2>
<RefSect2>
<Title>print.dt</Title>
<Para>CDE Print action definition file. This file is located in
/usr/dt/appconfig/types/$LANG.
</Para>
</RefSect2>
<RefSect2>
<Title>&lt;printer>.dt (Global actions)</Title>
<Para>The Print Viewer stores a &lt;printer>.dt action file for each printer on the
system. These files are located in /etc/dt/appconfig/types/$LANG.
</Para>
</RefSect2>
<RefSect2>
<Title>&lt;printer>.dt (customized actions)</Title>
<Para>The Print Viewer stores a &lt;printer>.dt action file for each customized
printer. These files are located in the $HOME/.dt/types.
</Para>
</RefSect2>
<RefSect2>
<Title>dtprintinfo.cat</Title>
<Para>Message catalog. This file is located in /usr/dt/lib/nls/msg/$LANG.
</Para>
</RefSect2>
<RefSect2>
<Title>Printmgr.sdl, PM*.tif, PM*.pm</Title>
<Para>Help files. These files are located in /usr/dt/appconfig/help/$LANG and
/usr/dt/appconfig/help/$LANG/graphics.
</Para>
</RefSect2>
</RefSect1>
<RefSect1>
<Title>SEE ALSO</Title>
<Para>&cdeman.dtlp;,&cdeman.dtprintinfoaction;</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.12 mancsf-to-docbook 1.3 08/21/95 21:30:04-->
