2    User Commands

 

pdconntf(1)

NAME

pdconntf - Advanced Printing Software client notification daemon.

SYNOPSIS

/usr/pd/lib/pdconntf [-llogfile]

OPTIONS

-llogfile

Writes event messages to the specified log file.

DESCRIPTION

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]...

OPTIONS

-c class_name

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.

-f filter_expression

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.

-F

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.

-g

Omits line and column headings.

-r requested_attributes

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.

-s style_name

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.

-x extended_attribute_string

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

-X attribute_filename

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.

OPERANDS

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.

[server_name:]job_id

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.

[server_name:]ob_id.doc_int

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.

[server_name:]ivdoc_name

When class_name is initial-value-document, the utility lists the requested attributes of the initial-value-document object named in ivdoc_name.

[server_name:]ivjob_name

When class_name is initial-value-job, the utility lists the requested attributes of the initial-value-job object named in ivjob_name.

[server_name:]printer_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.

[server_name:]queue_name

When class is queue, the utility lists the requested attributes of the queue named in queue_name.

server_name

When class_name is server, the utility lists the requested attributes of the spooler or supervisor identified by server_name.

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.

DESCRIPTION

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:

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.

EXAMPLES

  1. List all your jobs on the default spooler, the one that contains your default logical printer identified by PDPRINTER environment variable:

    pdls
     
     
    

  2. List all jobs on the default spooler:

    pdls -F
     
     
    

  3. List all queues on spooler blue_spl:

    pdls -c queue blue_spl:
     
     
    

  4. List all physical printers on supervisor blue_sup:

    pdls -c printer blue_sup:
     
     
    

  5. List all attributes for two printers, LP1 and PP2:

    pdls -c printer -r all -s line LP1 PP2
     
     
    

  6. List initial-value-document objects, on separate lines, on spooler blue_spl:

    pdls -c i-v-d -r all -s line blue_spl:
     
     
    

  7. 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;
     
     
    

  8. List all job and document attributes, on separate lines, for job 3127:

    pdls -c job -r all -s line -x "scope=1" 3127
     
     
    

  9. 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:
     
     
    

SEE ALSO

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]

OPTIONS

-g

Omits line or column headings. If you use this option with the -x string option, the equivalent attribute is headings=no.

-m message_text

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

-n copies

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.

-N notification_method

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.

email

The host processing the request sends an email message to your username account on your client host.

-r requested_attributes

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.

-s style_name

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.

-t job_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.

-x extended_attribute_string

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

-X attribute_filename

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.

OPERANDS

server_name

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.

job_id

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.

doc_int

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.

DESCRIPTION

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

  1. Change the copy count to 4 for the job with an ID of 10 on spooler1:

    pdmod -n 4 spooler1:10
     
     
    

  2. Change the job retention period to one hour for job 32704 on the default spooler:

    pdmod -x "job-retention-period=1:00:00" 32704
     
     
    

  3. Change the default media for the third document of job 12987 on the default spooler:

    pdmod -x "default-medium=a" 12987.3
     
     
    

SEE ALSO

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...

OPTIONS

-c class_name

Specifies the class or type of the object.

The following values are allowed:

To use the -x string option or the -X file option, the equivalent attribute is class=class_name.

-m message_text

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:

The option looks like this:

-x "message='Printer1 paused, not currently printing jobs'"

-x extended_attribute_string

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

-X attribute_filename

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.

OPERANDS

The value you supply for the operand depends on the value given with the -c class_name option or the class=class_name attribute.

[server_name:]printer_name

When class equals printer, the value of printer_name is the name of the printer you are pausing.

[server_name:]job_id

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.

[server_name:]queue_name

When class equals queue, the value of queue_name is the name of the queue you are pausing.

[server_name]

When class is server, the value of server_name is the name of the spooler you are pausing.

DESCRIPTION

The pdpause utility pauses a pending print job, a physical printer, a queue, or a spooler.

The following facts apply when using this utility:

Pausing a spooler:

Pausing a physical printer:

Pausing a print job:

Pausing a queue:

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.

EXAMPLES

  1. 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
     
     
    

  2. 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
     
     
    

  3. 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
     
     
    

SEE ALSO

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

OPTIONS

-f filename

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.

-g

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.

-n copies

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.

-N notification_method

Specifies how you want to be notified when your job has completed.

The following values are allowed:

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.

email

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.

-p printer_name

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.

-r requested_attributes

Specifies job attributes you want displayed after the submission is complete.

You can specify the following values for requested_attributes:

all

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.

verbose

pdpr writes an expanded set of attributes to output.

brief

pdpr writes a subset of the verbose list to output.

none

pdpr does not write any attributes to output.

-s style_name

Format the output that you requested with the -r requested_attributes option.

The values you can use for style_name are:

column

pdpr displays requested attributes in columns. This is the default.

line

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

-t job_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

extended_attribute_string

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:

attributes
requested-attributes
document-filename
headings
style

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.

-X attribute_filename

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.

OPERANDS

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

content-orientation
copy-count
default-input-tray
default-medium
initial-value-document
number-up
modification-filter
plex
reset-printer
sides
translation-filter

Common Job Attributes

initial-value-job
job-name
job-comment
job-copies
job-print-after
notification-profile
output-bin
job-sheets
document-sheets

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:

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.

Examples

  1. Submit the file called semantics.txt to the default printer:

    pdpr semantics.txt
     
     
    

  2. Submit the file quote.ps to the logical printer called my-printer and print five copies:

    pdpr -p my-printer -n 5 quote.ps
     
     
    

  3. 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
     
     
    

SEE ALSO

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]...

OPTIONS

-a

Causes the input file to be formatted using the man command.

-d

Specifies the destination logical printer for the submitted print job.

-e

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.

-h

Causes pdprint to display a help message then exit

-n copies

Specifies the number of copies of the print job. The default is one.

-s

Submits the print job without posting the pdprint dialog.

-u job_name

Sets the name of the submitted job to job_name. If the job name contains blanks it must be enclosed in quotes.

DESCRIPTION

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.

SEE ALSO

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 ]

OPTIONS

-sl status_ lines

Specify the number of lines to display in the status area located at the bottom of the pdprintinfo window.

-d printer

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.

DESCRIPTION

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.

ACCESS LEVEL: User

SEE ALSO

pdprint(1), pdprintadmin(8)

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]]

OPTIONS

-f filter_expression

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.

-F

Disables all attribute filtering, including any default filtering. The -F option takes precedence over any filter expressions you specify with the -f option.

-g

Displays output without column headings.

If you use the -x string option or the -X file options, the equivalent attribute is headings=no.

-p printer_name

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.

-r requested_attributes

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.

-s style_name

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.

-x extended_attribute_string

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.

-X attribute_filename

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.

OPERANDS

The pdq utility supports a job or document operand, which is optional.

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:

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

  1. Display the jobs you submitted to the queue associated with the default printer:

    pdq
    

  2. Display all your jobs in the queue associated with the logical printer, myprinter:

    pdq -p myprinter
    

  3. 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"
    

  4. Display all information about job 123 and its documents:

    pdq -r all -s line -x scope=1 123
    

  5. Display all pending jobs on spooler, sonny_spl belonging to user, bolitho

    pdq -f "(job-owner==bolitho) && (cur-job-state==pending)" sonny_spl:
    

SEE ALSO

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...

OPTIONS

-c class_name

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.

-x extended_attribute_string

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.

-X attribute_filename

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.

OPERANDS

target_printer_name

This value identifies a logical printer to which the job(s) specified in the object_instance of the operand are to be resubmitted.

object_instance

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.

[server_name:]job_id...

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.

[server_name:]queue_name

When class equals queue, this value identifies a queue, and the value for server_name is optional.

DESCRIPTION

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

  1. Resubmit jobs 2000 and 2001 on the default spooler to the logical printer named ginger:

    pdresubmit ginger 2000 2001
    

  2. Resubmit all jobs currently pending or on hold on the queue called jose to the logical printer named luke:

    pdresubmit -c queue luke jose
    

SEE ALSO

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...

OPTIONS

-c class_name

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.

-m message_text

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.

-x extended_attribute_string

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.

-X attribute_filename

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.

OPERANDS

The value you provide for the operand depends on the value given with the -c class_name option or the class=class_name attribute.

[server_name:]printer_name

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.

[server_name:]job_id

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.

[server_name:]queue_name

When class equals queue, the value of queue_name is the name of the queue that you want to resume.

server_name

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.

Description

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:

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.

EXAMPLES

  1. Resume printing jobs at physical printer samantha and set a message that can be displayed using the pdls utility:

    pdresume -m "back online" samantha
     
     
    

  2. Resume queue daniel to begin submitting jobs to physical printers:

    pdresume -c queue daniel
     
     
    

  3. Resume the spooler named ginger to begin distributing jobs to physical printers:

    pdresume -c server ginger
     
     
    

SEE ALSO

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...

OPTIONS

-m message_text

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.

-r retention_period

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.

-x extended_attribute_string

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.

-X attribute_filename

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.

OPERANDS

[server_name:]job_id

Identifies the job as residing on the named spooler server.

job_id

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 pdqcommand to display a list of jobs in the printer queue.

DESCRIPTION

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

  1. Remove job 2127 from the default spooler:

    pdrm 2127
    

  2. Remove and retain job 2001 for one hour before deleting it from the spooler named ginger.

    pdrm -r 1:00:00 ginger:2001
    

SEE ALSO

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...

OPTIONS

-c class_name

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.

-g

Omits line or column headings when requesting attributes.

To use this option in an attribute file, the equivalent command attribute is headings=no.

-m message_text

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.

-r requested_attributes

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.

-s style_name

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.

-x extended_attribute_string

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.

-X attribute_filename

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.

OPERANDS

The value you supply for the operand depends on the class of the object you are modifying:

[server_name:]job_id

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.

[server_name:]job_id.doc_int

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.

[server_name:]printer_name

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.

server_name

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.

[server_name:]queue_name

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.

[server_name:]ivjob_name

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.

[server_name:]ivdoc_name

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.

Description

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:

EXAMPLES

  1. Connect physical printer ginney to queue les.

    pdset -c printer -x associated-queue=les ginney
    

  2. 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
    

  3. Release job 21, which was placed in the held state when it was submitted for printing.

    pdset -c job -x "job-hold=no" 21
    

SEE ALSO

Commands: pdcreate(8), pddelete(8), pdmod(1), pdpr(1), pdq(1), pdrm(1), pdls(1)