dslpprotocol Command

Purpose

Configure the remote print protocol of print queue for a System V print subsystem.

Syntax

dslpprotocol -t RemoteProtocol [ -T TimeOut ] [ -R Retry ] [ -r ] PrintQueueName

dslpprotocol -l [ -S ] PrintQueueName

Description

The dslpprotocol command is used to configure the "remote print protocol" that a remote print client can use when sending print requests to a print queue.

In directory-enabled printing, to print to a remote print queue, the client must first get the remote print protocol it can use. This is obtained from the print queue object in the directory. This can be one or both of BSD and HPNP. Where more than one protocol is configured for a print queue, the UNIX print system uses the first value it reads, so a queue will normally only have a single protocol configured.

The PrintQueueName parameter is the Relative Distinguished Name (RDN®) of the print queue. If the value assigned to PrintQueueName does not exist, the command fails.

The user of this command must be directory-enabled and have permissions set for write, modify, search and read on the directory, in the directory context in which they are administrator.

Flags

Item	Description
-l	Print out a description of the remote print protocol parameters associated with the print queue.
-t RemoteProtocol	Specifies the remote print protocol that can be used when sending print requests to this print queue. The protocol type values supported are bsd and hpnp. The default value is bsd.
-T TimeOut	Set the network connection timeout value for the specified protocol, that is, the time a network connection should stay alive in an idle condition before disconnection. The value n can also be specified in order to disable timing out. The value 0 causes the connection to be dropped as soon as it becomes idle. The default value is 10 minutes, and there is no practical upper limit. See the lpsystem manual page for a full definition of the -T option.
-r	This option is used to remove a specified protocol from the print queue object. This option requires that the -t option also be specified.
-R Retry	Set the network connection retry time for the specified protocol, that is, the time in minutes to wait before trying to re-establish the network connection after a failure. The default value is 2 minutes. A value of 0 causes the connection to be retried immediately. Note that this value must be shorter than the timeout value specified using the -T option. The value n can also be specified in order to prevent dropped connections being retried when no work is available. There is no practical upper limit on the value. For "networked printers", the retry time should be set to 0. See the lpsystem manual page for a full definition of the -R option.
-S	Used with the -l option to display the print queue's protocol setup in a simple format.

Parameters

Item	Description
PrintQueueName	The PrintQueueName parameter is the Relative Distinguished Name (RDN) of the print queue. If the value assigned to PrintQueueName does not exist, the command fails.

Exit Status

0: Indicates success.
1: Indicates invalid options.
2: Indicates that the specified print queue is unknown.
3: Indicates that this user does not have modify permissions.
4: Indicates that an invalid RDN was supplied.
5: Indicates that the value is already set.
6: Indicates any other error.

Examples

To set print queue "printq1" to allow the BSD remote print protocol, enter the following:
```
dslpprotocol -t BSD printq1
```
To remove the BSD protocol from print queue "hpcolor", enter the following:
```
dslpprotocol -r -t BSD hpcolor
```