.\" $Header: 
.TA p
.TH pdmsg 1
.SH NAME
pdmsg \- displays the text and description of a HPDPS message at the command line
.SH SYNOPSIS
.C pdmsg
.RC [ -d\0]
.RC [ -t \0]
.RI \f2message-number\f1...
.PP
.SH DESCRIPTION
The
.CR pdmsg
utility displays the text and description of an
HPDPS message at the command line.
The 
.C pdmsg
utility extracts the text and description from
the appropriate message catalogs.  If you do not
specify the 
.C -d
or
.C -t
flag with the utility, 
.C pdmsg
displays both the text and the
message description.
.PP
.SS Options
The
.CR pdmsg 
uses the following flags:
.PP
.TP
.C "-d"
Displays only the description of a message, which consists of a 
message number, an explanation of the message, the system
action, and the response.
.TP
.C -h      
Displays only the text of the message, which consists of a 
message number along with the actual words of the 
message itself.  
.TP
.C message-number
The number of the HPDPS message you want displayed.  Valid
message numbers range from 5010-002 through 5010-1500 for HPDPS;
however, not every number in these ranges has an associated 
message.
.PP
.SH EXAMPLES
.SS To View Text and Description 
.C for a HPDPS Message
.PP
To view text and description for the HPDPS message 5010-096, 
enter the command:
.PP
.CR "pdmsg 5010-096"
.PP
The following appears:
.PP
5010-096 The value %1$AV is not supported for attribute %2$AN.
.PP
5010-096
.PP
EXPLANATION: The server or printer does not support this value.
.PP
SYSTEM ACTION:  HPDPS could not process the request.
.PP
RESPONSE:  Enter the command again and specify a value that is 
supported by the server and printer, or specify a printer that 
supports (by association) the value.
.PP
.SS To View Only the Text 
.C for a HPDPS Message
.PP
To view only the text for HPDPS message 5010-096, enter the command:
.PP
.CR "pdmsg -t 5010-096"
.PP
The following appears:
.PP
5010-096 The value %1$AV is not supported for attribute %2$AN.
.SS To View Only the Description 
.C for a HPDPS Message
.PP
To view only the description for HPDPS message 5010-096, enter the command:
.PP
.CR "pdmsg -d 5010-096"
.PP
The following appears:
.PP
EXPLANATION: The server or printer does not support this value.
.PP
SYSTEM ACTION:  HPDPS could not process the request.
.PP
RESPONSE:  Enter the command again and specify a value that is 
supported by the server and printer, or specify a printer that 
supports (by association) the value.
.PP
.in -2
.C NOTE:  
%1$AV & %2$AN are two types of substitution variables
that will be replaced by actual values at runtime.
