pdconntf
- Advanced Printing Software client notification daemon.
SYNOPSIS
/usr/pd/lib/pdconntf
[-llogfile
]
Writes event messages to the specified log file.
The
pdconntf
client notification daemon listens
for server-generated printing system event messages and writes them to the
local system console window, typically dxconsole.
If you wish to use console notification when print jobs complete or
when printer events occur, the
pdconntf
daemon must be
running on your print client host.
To run
pdconntf
, enter the following command: .
/usr/pd/lib/pdconntf
To stop
pdconntf
, send it a terminate signal as follows:
% kill -TERM <pdconntf-process-id>
The pdntfs notification server process relays notification messages to a client notification daemon when an event's notification profile specifies that client's network address.
Electronic mail notification does not require the
pdconntf
daemon.
The Advanced Printing Software GUI clients,
pdprintinfo
and
pdprintadmin
, do not require
pdconntf
;
they receive and display the notification events directly.
FILES
/usr/pd/lib/pdconntf
- client notification daemon
executable
/usr/pd/lib/pdntfs
- notification server executable
SEE ALSO
Advanced Printing Software System Administration and Operation Guide
pdls(1)
NAME
pdls
-
lists print system attributes
SYNOPSIS
pdls
[-c class_name
]
[-f filter_expression
]
[-F
]
[-g
]
[-r requested_attributes
]
[-s style_name
]
[-x extended_attribute_string
...]
[-X attribute_filename
...]
[object_instance
]...
Specifies the class or type of object.
The values allowed are:
document
initial-value-document
initial-value-job
job (default)
printer
queue
server
You can abbreviate these values to reduce typing. For example, printer can be abbreviated with the letter "p" and initial-value-document can be abbreviated as "i-v-d." The OPERANDS section describes the operand syntax associated with each class.
If you use the
-x
string option or the
-X
file option, the equivalent attribute is
class-type
=class_name.
Specifies an attribute query filter, expressed as a logical expression, to select a subset of object values.
The default value for the filter depends on the class of the object and is one of the following:
When you request a list of jobs, a default filter is used and is equivalent to job-owner=your_username.
When the object is anything other than job, the default is no filter.
Refer to the Advanced Printing Software Command Reference Guide for information about constructing attribute query filters.
Turns off all attribute filtering, including any default filtering that occurs when you do not specify the -f option.
The -F option takes precedence over -f filter_expression options that you specify on the command line.
Omits line and column headings.
Specifies the attributes that you want displayed in an attribute report.
You can use the following values for requested_attributes:
brief (default)
Displays a short subset of the object's attributes.
verbose
Displays an expanded set of attributes.
all
Displays all the object's attributes.
request_attribute_lists
Displays one or more object attributes that you specify.
If you use the
-x
string option or the
-X
file option, the equivalent command attribute expression is
requested-attributes
=requested_attributes.
Specifies how output is to be formatted.
The values for style_name are:
column (default)
Displays attributes in a multicolumn format.
line
Displays each attribute value on a separate line.
Specifies attribute=value pairs on the command line.
You cannot specify object attributes in the -x option; you can only specify command attributes.
You can use the following command-line attributes:
attributes
class
count-limit
filter
headings
requested-attributes
scope
style
time-limit
Specifies an attributes file that the utility can read. An attributes file is a user-written file that contains one or more attribute=value pairs. When the utility runs, it processes the attribute definitions in the file at the current point in the command line, as though you had entered them with the -x option.
If you include the path name to the attribute file in the
attribute_filename,
pdls
uses that path.
If you do not include the path and the file is not in your current working
directory, the utility searches for the file in the path name specified by
the PDPATH environment variable.
The
pdls
utility accepts one or more optional operands.
Each operand is an object instance; that is, a particular printer, queue,
job, serveror initial value object.
The operand values depend on the class
of the object.
All object must be of the same class.
When class_name is job, the utility lists the requested attributes of a job. This is the default. The value of job_id is a unique job identifier. For example, red_spl:120 identifies the job with an ID of 120 on spooler red_sp1.
When class_name is document, the utility lists the requested attributes of the document identified by job_id.doc_int. The document identifier (doc_int) represents the document's position in the job. For example, red_spl:120.2 identifies the second document in job 120 on the spooler red_sp1.
When class_name is initial-value-document, the utility lists the requested attributes of the initial-value-document object named in ivdoc_name.
When class_name is initial-value-job, the utility lists the requested attributes of the initial-value-job object named in ivjob_name.
When class_name is printer, the utility lists the requested attributes of the printer named in printer_name. The value of printer_name can be the name of a logical or physical printer. If you omit printer_name, the utility displays information about all printers on the server.
When class is queue, the utility lists the requested attributes of the queue named in queue_name.
When class_name is server, the utility lists the requested attributes of the spooler or supervisor identified by server_name.
For all object classes, specifying a server name terminated by a colon character causes the utility to list all objects of the specified class defined on the spooler or supervisor identified by server_name.
The
pdls
utility displays attributes and values of
print system objects, such as printers, queues, jobs, documents, and server
processes.
You can use this utility to list the attributes of:
An object you specify
All objects of a class you specify (except the server class)
A subset of all objects that you have filtered
The utility displays information only about an object for which you have sufficient access-control privilege. For jobs belonging to other users, the server returns only those attributes specified in the server attribute job-attributes-visible-to-all. The utility writes its list of attributes to standard output.
ACCESS LEVEL: End user
Environment Variables
PDPRINTER
Specifies your default logical printer. Also, implicitly specifies a default spooler as the one that hosts your default logical printer.
PDPATH
Specifies the path name to be used by the utility if you specify an attribute file, you do not include the path, and the file is not in your working directory.
List all your jobs on the default spooler, the one that contains your default logical printer identified by PDPRINTER environment variable:
pdls
List all jobs on the default spooler:
pdls -F
List all queues on spooler blue_spl:
pdls -c queue blue_spl:
List all physical printers on supervisor blue_sup:
pdls -c printer blue_sup:
List all attributes for two printers, LP1 and PP2:
pdls -c printer -r all -s line LP1 PP2
List initial-value-document objects, on separate lines, on spooler blue_spl:
pdls -c i-v-d -r all -s line blue_spl:
List logical printers and their respective initial-value objects on spooler blue_spl:
pdls -c pr -r "pr-name pr-i-v-j pr-i-v-d" blue_spl;
List all job and document attributes, on separate lines, for job 3127:
pdls -c job -r all -s line -x "scope=1" 3127
List all physical printers that need attention on supervisor blue_sup:
pdls -c pr -f '(pr-state==timed-out) || (pr-state==need-att)' \ blue_sup:
Commands:
pdpr
(1)pdq
(1)pdrm
(1)pdset
(1)pdcreate
(8)pddelete
(8)pdmod(1)
NAME
pdmod
-
modifies attributes of a submitted
print job
SYNOPSIS
pdmod
[-g
]
[-m message_text
]
[-n copies
]
[-N notification_method
]
[-r requested_attributes
]
[-s style_name
]
[-t job_name
]
[-x
extended_attribute_string
...]
[-X
attribute_filename
...]
[server_name:
]
job_id
[.doc_int
]
Omits line or column headings. If you use this option with the -x string option, the equivalent attribute is headings=no.
Includes a message about the job or document that you are modifying. For example, when you are modifying a job, the message might be:
-m "Copies required changed to 1000."
To use the -x extended-attributes-string option or the -X attribute_filename option, the equivalent command attribute type and value are:
For documents:
message
=message_text
For jobs:
job-message-from-administrator
=message_text
Specifies the number of copies of the print job to print. If you use the -x string option or the -X file option, the equivalent attribute is job-copies=number.
Specifies how you want to be notified when your job has completed.
You can use the following values for notification_method:
message
The host processing the request sends a message to the system console window on your workstation, typically the dxconsole program. The console window must be open to view the message.
The host processing the request sends an email message to your username account on your client host.
Specifies a set of job attributes that you want
pdmod
to display to standard output while performing its operation.
You can use the following values for requested_attributes:.
all
Writes all the job's attributes to output.
verbose
Writes an expanded set of job attributes to output.
brief
Writes a subset of the verbose list attributes to output.
none (default)
Does not write any attributes to output.
To use this option in an attribute file, the equivalent attribute is
requested-attributes
=requested_attributes.
Specifies the formatting of output for the -r requested_attributes option.
You can use the following values for style_name:
column (default)
Displays requested attribute in columns.
line
Displays each attribute value on a separate line.
If you use the
-x
string option or the
-X
file option, the equivalent attribute is
style
=style_name.
Specifies a new name for the job that you are modifying.
If you use
the
-x
string option or the
-X
file option,
the equivalent command attribute is
job-name
=job_name.
Specifies one or more attribute type=value pairs to be used by the utility. You can specify any read/write job and document object attributes with the -x and -X options.
Refer to the Advanced Printing Software Command Reference Guide for a complete listing of all supported job and document attributes.
You can use the following command line attributes:
headings
style
filter
job-name
copy-count
message
Specifies an attributes file for the utility to read. When the utility runs, it processes the attribute definitions in the file at the current point in the command line, as though you had specified them with the -x option.
Identifies the server on which the job you are modifying resides. If you do not specify a server name, the operation is attempted on the default server, the spooler associated with your default logical printer, specified by the PDPRINTER environment variable.
Identifies a
job you want to modify.
If you do not know the job ID of the job you want
to modify, use the
pdq
command to display a list of jobs
in the printer queue.
Identifies a document that you want to modify within the job. It must be at least 1 and cannot be greater than the total number of documents in the job.
For example, big_spl:116.3, identifies the third document in job 116 on the spooler named big_spl.
If you do not specify
doc_int,
pdmod
modifies all documents in the job and applies attributes you
have specified for the job.
If you specify
doc_int,
pdmod
modifies only document attributes on the document you have specified.
pdmod
returns an error if you specify modifications to job attributes.
The
pdmod
utility modifies job and document attributes
of a job that you have submitted for printing but that has not yet started
to print.
Changes you make to the job are persistent; that is, they remain
in place after the system is restarted.
The job you are modifying does not lose its position in the queue; however, a resource check of the entire job or document attributes takes place again if you resubmit the print job.
ACCESS LEVEL: End user
EXAMPLES
Change the copy count to 4 for the job with an ID of 10 on spooler1:
pdmod -n 4 spooler1:10
Change the job retention period to one hour for job 32704 on the default spooler:
pdmod -x "job-retention-period=1:00:00" 32704
Change the default media for the third document of job 12987 on the default spooler:
pdmod -x "default-medium=a" 12987.3
Commands:
pdpr
(1)pdls
(1)pdq
(1)pdrm
(1)pdset
(1)pdpause(1)
NAME
pdpause
-
pauses a print job, physical
printer, queue, or spooler
SYNOPSIS
pdpause
[-c class_name
]
[-m message_text
...]
[-x extended_attribute_string
...]
[-X attribute_filename
...]
object_instance
...
Specifies the class or type of the object.
The following values are allowed:
printer (physical printers only) This is the default.
job
queue
server (spooler only)
To use the
-x
string option or the
-X
file option, the equivalent attribute is
class
=class_name.
Include a message about the specific object. For example, if you are pausing a physical printer, the message might be:
-m "Printer paused, not currently printing jobs."
To use the -x extended-attributes-string option or the -X attribute filename option, the equivalent command attribute type and value are:
For physical printers, queues, and spoolers:
message
=message_text
For jobs:
job-message-from-administrator
=message_text
The option looks like this:
-x "message='Printer1 paused, not currently printing jobs'"
Specifies attribute type=value pairs to be used by the utility.
You cannot ser object attributes with the
-x
option
of the
pdpause
command.
You can use the following command
attributes:
attributes
class
message
Specifies an attribute file for the utility to read. When the utility runs, it processes the attribute definitions in the file at the current point in the command line, as though you had specified them with the -x option.
The value you supply for the operand depends on the value given with
the
-c
class_name
option or the
class
=class_name
attribute.
When class equals printer, the value of printer_name is the name of the printer you are pausing.
When class equals job, the value of job_id is the unique identifier of the job that you are pausing. If server_name is not specified, the request is submitted to you default server, the spooler that manages your default printer that is named in the PDPRINTER environment variable.
When class equals queue, the value of queue_name is the name of the queue you are pausing.
When class is server, the value of server_name is the name of the spooler you are pausing.
The
pdpause
utility pauses a pending print job, a
physical printer, a queue, or a spooler.
The following facts apply when using this utility:
After successfully completing the request, the server changes the state of the object to pause.
You can resume a paused physical printer, queue, or spooler with the pdresume utility.
Although a paused physical printer, queue, or spooler does
not process jobs, it can continue to accept and respond to requests such as
pdls
and
pdq
.
You cannot pause logical printers or supervisors. However, you can use the pddisable utility to prevent them from accepting print jobs.
Pausing a spooler:
It does not include jobs for printing.
The logical printers associated with the spooler continue to accept new jobs.
Pausing a physical printer:
The printer stops printing as soon as possible, and when you resume it, it continues printing from the point at which it was paused.
The spooler associated with the printer does not schedule new jobs while the physical printer is in the paused state.
Even if the printer is not printing when you pause it, you must resume it before it can accept a new job.
Pausing a print job:
The operation fails if the supervisor has begun to process the job.
You cannot reschedule the job until you resume it.
You cannot pause a document within the job.
Pausing a queue:
A paused queue does not submit jobs to associated physical printers.
The state of each logical printer associated with the queue does not change.
The state of jobs in the paused queue does not change.
ACCESS LEVEL: Operator
ENVIRONMENT VARIABLES
PDPRINTER
Specifies your default logical printer. Also, implicitly specifies a default spooler as one that hosts your default logical printer.
Pause physical printer myprinter_pp to fix a paper jam. The class need not be specified because printer is the default:
pdpause -m "fixing jam" myprinter_pp
Pause job 123, which has not yet been scheduled, on spooler blue_sp1. Other jobs will continue to print:
pdpause -c job blue_spl:123
Pause a queue. Jobs will be accepted but not sent to the printer. Use this option when you need to stop scheduling jobs for physical printers associated with a queue:
pdpause -c queue -m "pausing queue2" blue_spl:q2
Commands:
pdresume
(1)pdenable
(8)pddisable
(8)pdls
(1)pdpr(1)
NAME
pdpr
-
submits a print job
SYNOPSIS
pdpr
[-f filename
]
[-g
]
[-n
]
[copies
]
[-N notification_method
]
[-rrequested_attributes
]
[-p printer_name
]
[-s style_name
]
[-t job_name
]
[-x extended_attribute_string
...]
[-X attribute_filename
...]
files
Specifies a file to be printed as one document in a print job. The utility creates a document object for each file you specify with the command line, and each document becomes part of the job. Use this option when you submit a job of multiple files that require different document attributes.
If you use the
-x
string option or the
-X
file option, the equivalent command attribute is
document-filename
=filename.
Omit line or column headings when useing the -r option to request a list of attributes with your print command.
If you use the
-x
string option or the
-X
file option, the equivalent attribute is
headings
=no.
Specify how many copies of the print job to print.
If you use the
x
string option or the
X
file option, the equivalent attribute is
job_copies
=number.
Specifies how you want to be notified when your job has completed.
The following values are allowed:
The host processing the request sends a message to the system console window on your workstation, typically the dxconsole program. The console window must be open to view the message.
The host processing the request sends an e-mail message to your user account on your client host.
To use this option in an attribute file, specify the delivery-method
field of thenotification-profile
=profile
attribute.
Specifies the logical printer to which you are submitting a print job.
The value for printer_name is the name of a specific printer. This printer takes precedence over the printer that the PDPRINTER environment variable specifies.
The operation fails if you omit this option and the PDPRINTER variable does not contain the name of a valid logical printer.
To use this option in an attribute file, specify the delivery-method
field of thenotification-profile
=profile
attribute.
Specifies job attributes you want displayed after the submission is complete.
You can specify the following values for requested_attributes:
pdpr
writes all of the job's attributes to standard
output.
You can specify the
-s
line option to cause the
pdpr
utility to format the output one attribute per line.
pdpr
writes an expanded set of attributes to output.
pdpr
writes a subset of the verbose list to output.
pdpr
does not write any attributes to output.
Format the output that you requested with the -r requested_attributes option.
The values you can use for style_name are:
pdpr
displays requested attributes in columns.
This
is the default.
pdpr
displays each attribute value on a separate
line.
To use this option in an attribute file, the equivalent command attribute is style=style_name
Specify a new name for the job that you are submitting. If the job name contains spaces or punctuation characters, you must enclose it inside quotes. If you omit this option, the job-name attribute is set to the filename of the first document file.
To use this option in an attribute file, the equivalent command attribute is job-name=name
Specifies a series of command-line
attribute type=value pairs that
pdpr
processes.
You can use the assignment operator ( = ) to set the value of an attribute. For example, -x document-formats-supported=PCL. You can use all job and document R/W (Read/Write) attributes with the -x and the -X options.
You can use the following command attributes:
Refer to Chapter 3 of the Advanced Printing Software User Guide for information about how to use the most common job and document attributes. Also refer to the attributes table in Appendix A of the Advanced Printing Software Command Reference Guide for a complete listing of all the supported object and command attributes.
Follow the syntax rules for attribute value string, in Appendix A of the Command Reference Guide when you specify your string of attribute type=value pairs. You can produce the same result by including the extended attribute string in an attribute file and identifying that file as the attribute filenameusing the-X option.
Specifies an attribute file that pdpr will read. When the utility runs, it processes the attribute definitions in sequence, as if you had entered them on the command line with the -x option. If you do not inlcude a path to the file, the utility uses the path specified in the PDPATH environment variable.
The
pdpr
utility accepts zero or more document file
specifications as command operands.
You can also specify document files using
the
-f
option.
You cannot append command options beyond the
command operands.
ATTRIBUTES
The Advanced Printing Software system uses object attributes to govern the behavior of jobs, documents, printers, queues, and servers. This section lists some of the more commonly used attributes you can specify as part of a print job submission.
Common Document Attributes
Common Job Attributes
For a complete description of all system attributes, refer to Appendix
A of the Command Reference Guide.
DESCRIPTION
The
pdpr
utility creates a print job from document
files you specify or from standard input.
You submit the print job to a logical
printer.
The spooler associated with the logical printer validates your access
privileges, creates a job object by attaching attribute data, identifies a
physical printer that can support the job's requirements, and inserts the
job into the printer queue.
When the physical printer is available, the spooler
schedules the job for printing.
Consider the following items when using this utility:
A print job comprises one or more documents.
When you specify files for printing in a single command line,
pdpr
creates a document object for each file you specify and a job
object that describes the job.
The document objects contain attributes that
are specific to the printing of each document, and the job object contains
attributes that apply to the entire job.
The job acquires a unique job identifier that you can use with other utilities such as pdls, pdmod, and pdrm.
Job attributes you specify apply to all documents in the job. You can specify them anywhere on the command line, as long as they appear before files specified as operands.
Document attributes you specify apply to all documents specified after the attributes on the command line.
If one document in a multidocument job fails, the operation fails.
If you do not specify a printer,
pdpr
uses
the value of the PDPRINTER environment variable.
The operation fails if PDPRINTER
has no value.
ACCESS LEVEL: End user
ENVIRONMENT VARIABLES
PDPRINTER
Specifies your default logical printer. Also, implicitly specifies a default spooler as the one that hosts your default logical printer.
PDPATH
List of directories (path) that are successively searched for the filename specified in the -X attributes_filename option.
Submit the file called semantics.txt to the default printer:
pdpr semantics.txt
Submit the file quote.ps to the logical printer called my-printer and print five copies:
pdpr -p my-printer -n 5 quote.ps
Submit the file g1.ps for one-sided printing and the file g2.ps for two-sided printing to the default printer:
pdpr -x "sides=1" -f g1.ps -x "sides=2" g2.ps
Commands:
pdls
(1)pdq
(1)pdrm
(1)pdresubmit
(1)pdmod
(1)
Others:
Advanced Printing Software Command Reference Guide
Advanced Printing Software User Guide
pdprint(1)
NAME
pdprint
- Prints files with Advanced Printing Software.
SYNOPSIS
[-a
]
[-d printer_name
]
[-e
]
[-h
]
[-n copies
]
[-s
]
[-u job_name
]
[
print_files
]...
Causes the input file to be
formatted using the
man
command.
Specifies the destination logical printer for the submitted print job.
Removes the file after printing it. This functionality is intended for temporary files generated by applications that do not need to persist beyond the act of printing.
Causes
pdprint
to display a help message then exit
Specifies the number of copies of the print job. The default is one.
Submits the print job without
posting the
pdprint
dialog.
Sets the name of the submitted job to job_name. If the job name contains blanks it must be enclosed in quotes.
The
pdprint
utility provides a Graphical User Interface
(GUI) for printing in the Advanced Printing Software environment.
It replaces
the d to lp program when Advanced Printing Software is installed.
The
pdprint
utility is a CDE application that allows
users to easily control standard printing options such as the name of the
file(s) to be printed, the name of the printer to use, whether or not to print
a header page, number of copies to print, print method, and so on.
The
pdprint
utility also lets users determine the status of print jobs
in progress and cancel print jobs that are waiting in the queue.
For more information on the basic print system functions, see the Advanced Printing Software Administration and Operation Guide.
Users will normally use
pdprint
to print files by
entering the name of the file(s) in the File(s) To Print field, selecting
a printer from the pull down list of possible printers and then clicking on
the Print button.
The number of copies to print is set to 1 by default but
can be easily changed by using the up/down arrows in the Copies control or
by entering a number.
The status of the printer can be checked by clicking the Info... button. Print jobs can be terminated by selecting their names from the list on the Jobs tab and then selecting Cancel Job from the Selected menu.
The Info... button opens a window with information about the selected printer and its associated print objects.
The Details...
button opens a window that allows users to specify options
for the current job.
These include the output bin and the media to print on
as well as when the job will print.
The OK button sets these options only
for the current job.
ENVIRONMENT VARIABLES
LPDEST
Sets the default output device or destination. This can be overridden by specifying -d printer_name on the command line.
PDPRINTER
Similar to LPDEST but with a higher precedence. This can be overridden by specifying -d printer_name on the command line.
DTPRINTFILEREMOVE
Deletes the job file(s) from the client workstation after submission.
DTPRINTSILENT
Suppresses
posting of the
pdprint
window during job submission.
DTPRINTUSERFILENAME
Uses the value of DTPRINTUSERFILENAME as the default job name for all submitted jobs. This can be overridden by specifying -u job_name on the command line.
pdprintadmin
(8)pdprintinfo
(1)
The
pdprint
Help option on the Workspace menu or
the CDE front panel.
pdprintinfo(1)
NAME
pdprintinfo
- Displays printer and print job information
SYNOPSIS
/usr/pd/bin/pdprintinfo
[-sl status_lines
]
[-d printer
]
Specify the number of lines to display in the status area located at the bottom of the pdprintinfo window.
Specify the name of the printer property window to display.
This option
causes
pdprintinfo
to skip the domain view and to go directly
to the Open Printer dialog.
pdprintinfo
displays the status of jobs on the selected
logical printer.
Printer information can only be displayed by
pdprintinfo
;
it cannot be modified.
For each job on the printer,
pdprintinfo
reports
the job name, job id, job status, job owner, current position, requested printer,
and assigned printer.
For each printer,
pdprintinfo
reports the printer
name, printer status, associated spooler, printer default settings, and currently
submitted jobs.
End-users can use
pdprintinfo
to modify
owned jobs.
Print system operators and administrators can modify jobs on printers
to which they have access rights.
The
pdprintinfo
Help option on the Workspace menu
or the front panel.
pdq(1)
NAME
pdq
- displays
information about queued print jobs
SYNOPSIS
pdq
[-f filter_expression
]
[-F
]
[-g
]
[-p printer_name
]
[-r requested_attributes
]
[-s style_name
]
[-x extended_attribute_string
...]
[-X attribute_filename
...]
[server_name:
]
[job_id
[.doc_int
]]
Specifies an attribute query filter in the form of a logical expression that selects a subsets of jobs. The command returns requested infromation about only those jobs that match the filter criteria.
The default value for the
filter_expression
is
job-owner
= =username
Refer to the Advanced Printing Software Command Reference Guide for more information about specifying attribute query filters.
If you use the
-x
string option or the
-X
file options, the equivalent command attribute is
filter
=filter_expression.
Disables all attribute filtering, including any default filtering. The -F option takes precedence over any filter expressions you specify with the -f option.
Displays output without column headings.
If you use the
-x
string option or the
-X file
options, the equivalent attribute is
headings
=no.
Specifies the logical printer whose queue you want to list.
If you do not specify
printer_name, the command
uses the value of
PDPRINTER
as
the default.
If use you the
-x
string option or the
-X
file options, the equivalent command attribute is
printer-name-requested
=printer_name.
Specify the attributes that you want displayed in an attribute report.
The following values are allowed:
verbose - writes an expanded set of attributes.
brief (default) - writes a subset of the verbose list of attributes to standard output.
all - writes all attributes with values. When you use this option, you should also specify the -s line option to prevent line wrapping.
none - does not write any attributes
list of attributes - writes the specified attributes to standard output. If you request more than one attribute, you must enclose them in quotes and separate them with a space. For example, -r "job-owner job-name"
If you use the
-x
string option or the
-X
file options, the equivalent command attribute is
requested-attributes
=requested_attributes.
Specifies how the output requested with the -r requested_attributes option is to be formatted.
The values for style_name are:
column (default)
Displays attributes in multi-column format
line
Writes each attribute on a separate line
If you use the
-x
string option or the
-X
file options, the equivalent command attribute is
style
=style_name.
Specifies one or more attribute_type=value pairs.
You cannot specify object attributes with the
-x
option
of the
pdq
command.
You can use the following command attributes:
count-limit
filter
headings
requested-attributes
scope
style
time-limit
The syntax rules for attribute value strings are described in the Advanced Printing Software Command Reference Guide.
Specifies an attribute file that the utility will read. When the utility runs, it processes the attribute definitions in the file at the current point, as though you had entered them with the -x option.
The
pdq
utility supports a job or document operand,
which is optional.
[server_name:]
Identifies the spooler on which the jobs you want to list reside.
The
default spooler is the one associated with your default printer, as specified
by the
PDPRINTER
environment variable.
job_id
Identifies a specific job that you want pdq to display. If you omit this field, all jobs you have permission to view are displayed.
[.doc_int]
Displays a specific document of the job whose attributes
pdq
will list.
If not specified, only job attributes will be displayed.
If you do not specify an operand,
pdq
lists print
jobs in the queue associated with the printer you specified or the default
logical printer.
DESCRIPTION
The
pdq
utility queries a logical printer for a list
of jobs that are currently in its queue and returns a list of those jobs.
The list displays the jobs in the scheduled print order.
The
pdq
utility writes the list of jobs to standard output.
If you do not
use the
-p
option to specify a printer,
pdq
lists jobs in the queue of the printer specified by the
PDPRINTER
environment variable.
ACCESS LEVEL:
End user - End users can list only jobs they own.
Operators and administrators - Operators and administrators can list all jobs in all queues.
For more information about which attributes are visible to end-users,
refer to the server attribute
job_attributes_visible_to_all
in the
Advanced Printing Software Command Reference Guide.
ENVIRONMENT VARIABLES
PDPRINTER
Specifies your default logical printer.
Also implicitly specifies a
default spooler as the one that hosts your default logical printer.
EXAMPLES
Display the jobs you submitted to the queue associated with the default printer:
pdq
Display all your jobs in the queue associated with the logical printer, myprinter:
pdq -p myprinter
Display the jobs you have submitted to your default printer, and show their state and when they were submitted:
pdq -r "job-ident job-name submission-time current-job-state"
Display all information about job 123 and its documents:
pdq -r all -s line -x scope=1 123
Display all pending jobs on spooler, sonny_spl belonging to user, bolitho
pdq -f "(job-owner==bolitho) && (cur-job-state==pending)" sonny_spl:
Commands:
pdpr
(1)pdls
(1)pdrm
(1)pdmod
(1)pdresubmit
(1)pdresubmit(1)
NAME
pdresubmit
-
resubmit a print job to another
logical printer
SYNOPSIS
pdresubmit
[-c class_name
]
[-x
extended_attribute_string
...]
[-X attribute_filename
...]
target_printer_name
object_instance
...
Specifies the class of object being submitted,
queue
or
job
.
The default is
job
.
If you use the
-x
string option or the
-X
file option, the equivalent attribute is
class
=class_name.
The values you can use for
class_name
are queue and job.
Specifies one or more attribute type=value pairs to be used by the utility.
You cannot set object attributes with the
-x
option.
You can use command attributes
class
and
attributes
.
The syntax rules for attribute value strings are described in the Advanced Printing Software Command Reference Guide.
Specifies an attribute file for the utility to read. When the utility runs, it inserts, at the current point in the command line, the attribute data it finds in the file.
If a path to the file is not specified,
pdresubmit
searches the directory specified by the PDPATH environment variable.
Object attributes cannot be specified with the
-X
option.
Command attributes that can be used are
class
and
attributes
.
This value identifies a logical printer to which the job(s) specified in the object_instance of the operand are to be resubmitted.
A queue or one or more jobs.
This value depends on the value of the
-c
class_name
option or the
class
=class_name
attribute.
If you specify the operation class as
queue, then this operand specifies a queue.
If you specify the operation
class as
job
, then this operand is one or more job identifiers.
When class equals job, this value is a unique job identifier, and the value for server_name is optional. You can specify one or more such job identifier operands on the command.
When class equals queue, this value identifies a queue, and the value for server_name is optional.
Use the
pdresubmit
utility to request that a job
already submitted for printing (and currently in a
pending, held,
paused
, or
retained
state) be resubmitted on
the same spooler.
The operation fails if the job, or jobs, to be resubmitted
is in a printing, processing, preprocessing, or completed state.
If the job
or jobs have a retention period, the operation proceeds but the original retention
period remains unchanged.
When all jobs in a queue are resubmitted to another logical printer,
a revalidation takes place.
If a job fails this process, a warning message
is returned.
You can use the
pdmod
utility to adjust the
requirements of a failed job to meet the printer's capabilities, or the job
can be resubmitted to a printer that provides the correct features.
ACCESS LEVEL:
End user: End users can resubmit only jobs they own.
Operators: Operators can resubmit any job in any queue.
EXAMPLES
Resubmit jobs 2000 and 2001 on the default spooler to the logical printer named ginger:
pdresubmit ginger 2000 2001
Resubmit all jobs currently pending or on hold on the queue called jose to the logical printer named luke:
pdresubmit -c queue luke jose
Commands:
pdpr
(1)pdls
(1)pdq
(1)pdrm
(1)pdmod
(1)
Others:
Advanced Printing Software Command Reference Guide
Advanced Printing Software User Guide
pdresume(1)
NAME
pdresume
-
resumes a paused print job,
physical printer, queue, or spooler
SYNOPSIS
pdresume
[-c class_name
]
[-m message_text
]
[-x extended_attribute_string
...]
[-X attribute_filename
...]
object_instance
...
Specifies the class or type of object.
The following are allowed:
printer (physical printer only) This is the default.
job
queue
server (spooler only)
If you use the
-x
string option or the
-X
file option, the equivalent attribute is
class
=class_name.
Includes a message about the object. For example, when you resume a paused physical printer, the message might be:
-m "resuming printer1"
If you use the -x extended-attribute-string option or the -X attribute_filename option, the equivalent command attribute type and value are:
For physical printers, queues, and spoolers:
message
=message_text
For jobs:
job-message-from-administrator
=message_text
To retrieve a message of this type, use the
pdls
utility, specify the job or document, and include the option-r
message.
Specifies one or more attribute_type=value pairs to be used by the utility.
You cannot set object attributes with the
-x
option
of the
pdresume
command.
You can use the following command
attributes:
attributes
class
message
Follow the syntax rules for attribute value strings listed in the Advanced Printing Software Command Reference Guide.
Specifies an attribute file. When the utility runs, it processes the attribute definitions in the file at the current point in the command line, as though you had specified them with the -x option.
The value you provide for the operand depends on the value given with
the
-c
class_name
option or the
class
=class_name
attribute.
This is the default.
When class equals
printer
,
the value of
printer_name
is the name of the specific
physical printer that you are resuming.
When class equals
job
, the value of
job_id
is the unique identifier of the job that you are resuming.
You cannot include document identifiers because you cannot resume the printing
of a specific document within a job.
When class equals
queue
, the value of
queue_name
is the name of the queue that you want to resume.
When class
equals
server
, the value of
server_name
is the name of the spooler that you want to resume.
If you do not specify server_name in any operand,
pdresume
operates on the server that supports the printer named by the PDPRINTER
environment variable.
The
pdresume
utility resumes print jobs, physical
printers, queues, and spoolers that are in the paused state.
This operation causes the job, printer, queue, or spooler to continue normal operations after being paused by an operator or system administrator.
Consider the following when using this utility:
A job you have resumed is available for scheduling and printing.
The state of a queue you have resumed changes from paused to ready, and the queue resumes distributing print jobs to all associated physical printers.
You can pause and resume a spooler but not a supervisor. The state of the spooler changes to ready, and it begins distributing jobs for printing.
You can pause and resume a physical printer but not a logical printer. The physical printer starts and resumes printing its currently assigned print job, if any, from the point where you paused it.
ACCESS LEVEL: Operator, Administrator
ENVIRONMENT VARIABLE
PDPRINTER
Specifies your default logical printer. Also, implicitly specifies a default spooler as the one that hosts your default logical printer.
Resume printing jobs at physical printer samantha and set
a message that can be displayed using the
pdls
utility:
pdresume -m "back online" samantha
Resume queue daniel to begin submitting jobs to physical printers:
pdresume -c queue daniel
Resume the spooler named ginger to begin distributing jobs to physical printers:
pdresume -c server ginger
Commands:
pdpause
(1)pdpr
(1)pdq
(1)pdrm
(1)pdls
(1)pdrm(1)
NAME
pdrm
- cancels
a print job
SYNOPSIS
pdrm
[-m message_text
]
[-r retention_period
]
[-x extended_attribute_string
...]
[-X attribute_filename
...]
[ server_name:
]
job_id
...
If you are an administrator, you can include a message about the job
that you are removing.
The equivalent command attribute is
job-message-from-administrator=
message_text.
Users can view this message by issuing the
pdls
command,
specifying the job or document, and including the option
-r
message.
Defines the length of time a spooler should retain the removed job before deleting the job. A retained job can be resubmitted.
If you specify a retention period of zero, the job is deleted immediately. If you specify a nonzero retention period, the job is placed in the retained state for the amount of time you specify.
Specify the retention period in hours, minutes, and seconds, according to conventions in your locale. If you specify the retention period as a simple integer, it will be interpreted as minutes.
If you use the
-x
string option or the
-X
file option, the equivalent command attribute is
job-retention-period=
retention_period.
Specifies one or more attribute_type=value pairs to be used
by the
pdrm
utility.
You cannot set job attributes with
the-x
option.
You can use the following command attributes:
attributes and message.
Follow the syntax rules for attribute value strings listed in the Advanced Printing Software Command Reference Guide.
The-X
option identifies an attribute file
to be read by the utility.
When the
pdrm
utility executes,
the attribute definitions included in the file are processed at the current
point in the command line as though they had been specified with the
-x
option.
Identifies the job as residing on the named spooler server.
Identifies
a job that resides on the default spooler.
The default spooler is associated
with the default printer, as specified by your PDPRINTER environment variable.
If you do not know the
job_id
of the job you want
to remove, use the
pdq
command to display a list of jobs
in the printer queue.
Use the
pdrm
utility to remove or cancel a job that
was submitted for printing.
If the job is currently printing, the spooler
forwards the operation to the supervisor and printing is stopped as soon as
possible.
The print job is retained if you specify the -r retention_period option in the command line, or if the job-retention-period attribute has a nonzero value. Retained jobs can be resubmitted for printing later.
ACCESS LEVEL: End user
RESTRICTIONS
The operation is valid only for jobs that reside on a spooler; it fails
if the server named is a printer supervisor.
ENVIRONMENT VARIABLES
PDPRINTER
Specifies your default logical printer.
Also implicitly specifies a
default spooler as the one that hosts your default logical printer.
EXAMPLES
Remove job 2127 from the default spooler:
pdrm 2127
Remove and retain job 2001 for one hour before deleting it from the spooler named ginger.
pdrm -r 1:00:00 ginger:2001
pdpr
(1)pddelete
(8)pdq
(1)pdls
(1)pdmod
(1)pdresubmit
(1)pdset(1)
NAME
pdset
-
set print system attributes
SYNOPSIS
pdset
[-c class_name
]
[-g
]
[-m message_text
]
[-r requested_attributes
]
[-s style_name
]
[-x extended_attribute_string
...]
[-X attribute_filename
...]
object_instance
...
Specifies the class or type of object.
The following values are allowed:
printer (default)
queue
server
job
document
initial-value-job
initial-value-document
If you use the
-x
string option as the
-x
file option, the equivalent attribute is
class
=class_name.
Omits line or column headings when requesting attributes.
To use this option in an attribute file, the equivalent command attribute
is
headings
=no.
Includes a message about the print object that you are modifying. For example, when changing an attribute of a printer, you could attach a message such as the following:
-m "This printer now supports stapled jobs."
The equivalent command attribute type and value are the following:
For server printer, queue, initial-value-job, initial-value-document,
and document objects:
message
=message_text
For jobs:
job-message-from-administrator
=message_text.
Specifies attributes that you want displayed in an attribute report. A formatted list of attribute values is written to standard output.
The following values are allowed:
verbose - specifies an expanded set of attributes to be written to output.
brief - specifies a subset of the verbose list of attributes to be written to output.
all - specifies all attributes with values to be written to output.
none - specifies that no attributes are to be written to output.
To use this option in an attribute file, the equivalent command attribute
expression is
requested-attributes
=requested_attributes.
Specifies how output requested with the -r requested-attributes option is to be formatted.
The following values are allowed:
column - displays requested attributes in columns.
line - displays each attribute value on a separate line.
The equivalent attribute is
style
=style_name.
Specifies one or more attribute=value pairs to be used by the utility.
Some attributes accept multiple values, while others can have only one value. You can use the -x option and appropriate attribute modification operators, to replace an attribute's values with new values, add new values to the existing values, remove all values, remove selected values, and reset an attribute to its default value.
You can include an operator with attribute=value pairs to indicate the type of modification to be done to the specified attribute.
The three modification operators are:
= (replace)
When you use attribute=value, you set or replace the value of the named attribute. The previous value is lost.
+= (add value)
When you use
attribute
+=value,
you add a value to the attribute.
This can be used only with multivalued
attributes.
If you add a value that already exists, the attribute contains
the same value twice.
-= (remove value)
When you use
attribute
-=value, you remove a value from the attribute.
If the value is not
present,
pdset
ignores the command.
If you remove the
last value for an attribute,
pdset
sets the value to the
server default.
If a value to be removed occurs more than once,
pdset
removes all occurrences.
==(reset to default value)
When you use
attribute
==, you set the attribute value
to its default.
Do not include a value when resetting to the default value.
All read/write attributes, except those listed as read only in the Advanced Printing Software Command Reference Guide, can be used with the -x option.
Follow the syntax rules for attribute value strings listed in the Advanced Printing Software Command Reference Guide.
Specifies an attribute's file. When the utility runs, it inserts, at the current point in the command line, the attribute data it finds in the file.
The value you supply for the operand depends on the class of the object you are modifying:
When the object class is
job
, the required
value of
job_id
is the unique identifier of the
job whose attributes are to be set.
You need to specify the server_name field
only if the server that contains the job is not your default spooler, the
one that manages your default logical printer named in the PDPRINTER environment
variable.
When the object class is
document
, the value of
doc_int
is the numerical
position of the document within the specified job.
For example, blue_spl:116.3,
specifies the third document of job 116 on the spooler called blue_spl.
You
need to specify the server_name field only if the server that contains the
job is not your default spooler.
When the object class is
printer
,
the value of
printer_name
is the name of the physical
or logical printer whose attributes are to be set.
When the
object class is
server
, the value of
server_name
is the name of the spooler or supervisor whose attributes are
to be set.
When the object class is
queue
, the value
of
queue_name
is the name of the queue whose attributes
are to be set.
Specifying
server_name
is optional.
When the object class is
initial-value-job
, the value of
ivjob_name
is the name
of the initial-value-job object whose attributes are to be set.
Specifying
server_name
is necessary if the server that maintains the object
is not your default spooler.
When the object class is
initial-value-document
, the value of
ivdoc_name
is the name
of the initial-value-document object whose attributes are to be set.
Specifying
server_name
is necessary if the server that maintains the object
is not your default spooler.
The
pdset
utility sets, adds, or removes values of
writable attributes of printers, queues, servers, jobs, documents, and initial-value
objects in the Advanced Printing Software system.
Changes you make to attribute
values of an object are persistent; they remain in place even after the system
is restarted.
The specified attribute values will be set for every object
you include as a command operand.
Some object attributes make reference to other objects in your configuration. To set any of the following print attributes, the new value must refer to an object that already exists:
associated-queue
printer-initial-value-job
printer-initial-value-document
ACCESS LEVELS:
Administrator - An administrator can set attribute values of any object in the system.
Operator - An operator can set attributes of any job and values of the xxx-ready attributes for physical printers.
End user - An end user can set only attribute values of owned jobs.
Connect physical printer ginney to queue les.
pdset -c printer -x associated-queue=les ginney
Add iso-a4-white media to the media-supported attribute for
the printer named samantha.
The operand is assumed to be a printer name because
the default class for the
pdset
command is printer.
pdset -x "media-supported+=iso-a4-white" samantha
Release job 21, which was placed in the held state when it was submitted for printing.
pdset -c job -x "job-hold=no" 21
Commands:
pdcreate
(8)pddelete
(8)pdmod
(1)pdpr
(1)pdq
(1)pdrm
(1)pdls
(1)