pioattred Command

Purpose

Provides a way to format and edit attributes in a virtual printer.

Syntax

pioattred -q PrintQueueName -d QueueDeviceName [ -o Action] [ -a Attribute]

Description

The pioattred command provides a way to format virtual printer attributes and to edit the attributes. Specifically, attributes in the printer definition file can be formatted and/or edited according to the action specified with the -o flag. Formatted attributes are written to standard output stdout. Attributes are edited with the editor who is specified in the VISUAL environment variable. The virtual printer definition file is assumed to be in the /var/spool/lpd/pio/@local/custom/* directory.

Flags

Table 1. Flags
Item	Description
-a `Attribute`	Specifies the name of the attribute in the virtual printer definition file to format or edit. This flag may be specified many times.
-d `QueueDeviceName`	Specifies the `QueueDeviceName` spooler of the virtual printer definition to format or edit.
-o `Action`	Specifies the action that the pioattred command must take on the virtual printer definition. If this flag is omitted, the pioattred command assumes a value of 0 (zero). 0 Format the attributes specified. The result goes to `stdout`. 1 Format and edit one or more attributes specified; use the editor who is specified in the `VISUAL` environment variable. If no editor is specified in the `VISUAL` environment variable, use the vi editor. If an error is made in editing the attributes, save the erroneous attributes in a temporary file, and return a return code indicating an error. The following values are used in case an error return code was returned after editing the attributes. 2 Edit the attributes again. The virtual printer definition is the state it was left in when the error occurred. 3 Ignore the error and save the edited attributes in the virtual printer definition. 4 Clean up and leave things in the state they were before the pioattred command was started.
-q `PrintQueueName`	Specifies the `PrintQueueName` spooler of the virtual printer definition to format or edit.

Examples

To format the ci and sh attributes in the queue: quedev virtual printer definition, enter:
```
pioattred -q queue -d quedev -o 0 -a ci -a sh
```
OR
```
pioattred -q queue -d quedev -a ci -a sh
```
To format all attributes in the queue: quedev virtual printer definition, enter:
```
pioattred -q queue -d quedev -o 0
```
OR
```
pioattred -q queue -d quedev
```
To edit the st attribute in the queue: quedev virtual printer definition, enter:
```
pioattred -q queue -d quedev -o 1 -a st
```

Files

Table 2. Files
Item	Description
/usr/sbin/pioattred	Contains the pioattred command.