HPlogo HP-UX Reference Volume 1 of 5 > p

pdenable(1)

» 

Technical documentation

Complete book in PDF

 » Table of Contents

 » Index

NAME

pdenable — enables printers to accept jobs and logs to log

SYNOPSIS

pdenable -h

pdenable [-c ObjectClass] [ -m "MessageText" ] [ -x "AttributeValuePairs" ] [-X AttributesFileName] { ServerName ... | [ServerName : ]LogName ... | [ServerName : ]PrinterName ... | [ServerName : ]QueueName ... }

DESCRIPTION

Use this administrative command, pdenable, to enable the logging function of logs or to enable logical printers or physical printers to accept jobs.

To discontinue acceptance of print jobs, use the pddisable command. To discontinue logs from logging data, use the pddisable command.

Note: The pdenable and pddisable commands control input, whereas pdpause and pdresume control output.

Options

You can use the following options with the pdenable command:

-c ObjectClass

Specify the object class you want for this command. The ObjectClass can be one of the following:

printer (default) log queue server

Within the valid classes, queue enables all associated logical printers, printer is for a logical or a physical printer, server is for a spooler or a supervisor and enables all printers residing in that server, and log is for error log. See the HPDPS Administration Guide for more detail on error logging.

This option is equivalent to specifying the command-attribute class.

-h

Display a command-specific help message containing information about command syntax and options. This option cannot be used with another option or with an attribute.

-m "MessageText"

Specify the message that is to be associated with the printer, log, queue, or server that is being enabled. You can use this message to indicate the reason for enabling the printer, log, queue, or server or to provide other comments.

If the -m option is not specified, the message already stored with the printer, log, queue, or server remains unchanged.

When the command is issued against a server, HPDPS propagates the message to the message attribute of the printers residing in that server. The message attribute for that server is not changed. When the command is issued against a queue, the message is propagated to the message attribute of the logical printers associated with the queue. The message attribute for that queue is not changed.

You can list this message by specifying requested-attributes=message with the pdls command.

This option is equivalent to specifying the command-attribute message.

-x "AttributeValuePairs"

A single attribute string, consisting of one more attribute-value pairs.

-X AttributesFileName

The name of a file containing attribute-value pairs you want inserted at the current point in the command line. This option is equivalent to specifying the command-attribute attributes.

Command Attributes

You can specify these attributes in a -x "AttributeValuePairs" string or in an attributes file designated with the -X AttributesFileName option.

attributes=AttributesFileName

Specifies the designated attributes file that HPDPS is to read and insert at the current point in the command line. This file contains attribute and value pairs that HPDPS uses to expand on the command being entered.

class=ObjectClass

Specify the ObjectClass that you want for this command. Valid object class names for the pdenable command are: printer (default), log, queue, or server. Within the valid classes, queue enables all associated logical printers, printer is for a logical or a physical printer, server is for a spooler or a supervisor and enables all printers residing in that server and log is for error log.

message="MessageText"

Specify the message you want associated with the printer, log, queue, or server that is being enabled. You may use this message to indicate the reason for enabling the printer, log, queue, or server or to provide other comments. If the message attribute is not specified, the message already stored with the object remains unchanged.

When the command is issued against a server, HPDPS propagates the message to the message attribute of the printers residing in that server. The message attribute for that server is not changed. When the command is issued against a queue, the message is propagated to the message attribute of the logical printers associated with the queue. The message attribute for that queue is not changed.

You can list this message by specifying requested-attributes=message with the pdls command.

Object Attributes

There are no object attributes for this command.

Arguments

Use the arguments to identify the specific object you want to enable. If you specify multiple objects, each must be separated by spaces.

You can use the following arguments with the pdenable command:

[ServerName:]LogName

Specify the log you want enabled. Enabling a log allows it to begin accepting input (logging).

[ServerName:]PrinterName

Specify the printer you want enabled. When first created, printers are in the disabled state. Printers cannot be enabled unless they are associated with an existing queue. Any other objects referenced by the printer also must exist. These are for logical printers:

initial-value-job objects initial-value-document objects

[ServerName:]QueueName

Specify the queue you want enabled. When the pdenable command is issued against a queue, HPDPS attempts to enable all of its associated logical printers.

ServerName

Specify the server you want enabled. When the pdenable command is issued against a server, HPDPS attempts to enable all of its printers. When issued against a:

Spooler

HPDPS attempts to enable all of its logical printers.

Supervisor

HPDPS attempts to enable all of its physical printers.

When a server is initialized again after being shut down, the printers are either enabled or disabled. This depends on the state the printer was in when HPDPS was shut down and on ability of the server to communicate with its associated queue.

EXAMPLES

Enable Printers

To enable logical printers lj4si and lj5si on spooler SPOOL1, enter one of these commands:

pdenable lj4si lj5si pdenable SPOOL1:lj4si SPOOL1:lj5si

The server name is not required.

To enable all physical printers contained in the supervisor SUPERG1, enter the command:

pdenable -c server SUPERG1

STANDARDS CONFORMANCE

pdenable: POSIX 1387.4

© Hewlett-Packard Development Company, L.P.