Commands Reference, Volume 2

disable Command

The disable command includes information for disable on a POWER-based platform and the System V Print Subsystem disable on an POWER-based and Itanium-based platforms.

disable Command on POWER-based Platform

Syntax

disable [ -c ] [ -rReason ] [ -W ] PrinterName ...

Description

The disable command disables or brings offline the printer queue devices specified by the PrinterName parameter.

Note: You must have root user authority or belong to the printq group to run this command.

By default, any requests that are currently printing on the designated printers are reprinted in their entirety either on the same printer or on another member of the same class of printers. If the printer is remote, this command only stops the transmission of jobs to the remote system. The disable command must be run on the remote system to disable the printer. The lpstat-p command provides status of the printers.

Flags

-c	Cancels all job requests. Using this flag is the same as entering the enq -K command. This flag cannot be used with the -W flag. If the printer is remote, the -c flag is ignored.
-rReason	Specifies the reason for disabling the printer queue device with the Reason variable. This flag is a "no operation" flag, which means that the system ignores this flag. This Reason is reported by lpstat -p. If the Reason contains blanks, it must be enclosed in quotes. The default reason is unknown reason for existing printers, and new printer for printers just added to the system but not yet enabled.
-W	Waits until the request currently being printed is finished before disabling the specified printer. This flag cannot be used with the -c flag. If the printer is remote, the -W flag is ignored.

Examples

To bring printer queue lp0 offline without waiting for the current print jobs to finish, enter:
disable -c lp0
To bring printer queue lp0 offline after all print jobs are finished, enter:
```
disable lp0
```

Files

/usr/sbin/qdaemon	Queuing daemon
/etc/qconfig	Queue configuration file
/etc/qconfig.bin	Digested, binary version of the /etc/qconfig file
/var/spool/lpd/qdir/*	Queue requests
/var/spool/lpd/stat/*	Information on the status of the devices
/var/spool/qdaemon/*	Temporary copies of enqueued files

Related Information

The cancel command, enable command, enq command, lp command, lpstat command.

Starting and Stopping a Print Queue in AIX 5L Version 5.1 Guide to Printers and Printing.

disable Command on POWER-based and Itanium-based Platforms

Note: This is a System V Print Subsystem command.

Purpose

Disable LP printers

Syntax

disable [flags] printers

Description

The disable command deactivates the named printers, disabling them from printing requests submitted by lp. By default, any requests that are currently printing on the designated printers will be reprinted in their entirety either on the same printer or on another member of the same class of printers. If the printer is remote, this command will only stop the transmission of jobs to the remote system. The disable command must be run on the remote system to disable the printer. (Run lpstat -p to get the status of printers.)

Printer names are system-defined words and as such should be restricted to uppercase and lowercase ASCII characters.

Flags

-c: Cancel any requests that are currently printing on any of the designated printers. This flag cannot be used with the -W flag. If the printer is remote, the -c flag is ignored.
-r reason: Assign a reason for the disabling of the printers. This reason applies to all printers specified. This reason is reported by lpstat -p. reason must be enclosed in quotes if it contains blanks. The default reason is unknown reason for existing printers, and new printer for printers just added to the system but not yet enabled.
-W: Wait until the request currently being printed is finished before disabling the specified printer.
This flag cannot be used with the -c flag. If the printer is remote, the -W flag will be silently ignored.

Files

/var/spool/lp/*

References

The lp command, lpstat command.