chprtsv Command

Purpose

Changes a print service configuration on a client or server machine.

Syntax

chprtsv -c | -s [  -d | -i ] [  -h"HostName..." | -H FileName ] [  -x"HostName..." | -X FileName ] [  -q"QEntry" -v DeviceName -a"Attribute =Value..." -b"Attribute =Value..." | -A FileName ] 

Description

The chprtsv high-level command changes print service configuration on a client or server machine.

To change print service for a client, the chprtsv command does the following:

  1. Disables the client spool queue with the chque and chquedev commands.
  2. Changes the appropriate entries in the /etc/qconfig file with the chque and chquedev commands.
  3. Enables the client spool queue with the chque and chquedev commands.

To change print service for a server, the chprtsv command does the following:

  1. Calls the ruser low-level command to change remote users configured on the print server, if necessary.
  2. Calls the chque and chquedev Command commands to change the print queues and entries in the qconfig file, if necessary.
  3. Calls the SRC refresh command to restart the lpd and qdaemon servers.

If you want to change the attributes of a queue, you must specify the queue name and the attributes associated with the queue. If you want to change the attributes of the queue device, you must specify queue name, queue device name, and the attributes associated with the queue device.

The changes you make with the chprtsv -i command go into effect on the system database and on the current active system.

If you want the changes you make to go into effect at system startup time without affecting the current system, use the chprtsv -d command to change only TCP/IP and its associated network interfaces in the system database only.

Flags

Item Description
-A FileName Specifies the name of the file containing qconfig command-related entries.
-a "Attribute =Value..." Specifies a list of attributes with corresponding values to be used for updating the spooler's qconfig file or object class. The list should be enclosed in quotes. Valid attribute types follow:
acctfile (true/false)
Identifies the file used to save print accounting information. The default value of false suppresses accounting. If the named file does not exist, no accounting is done.
device
Identifies the symbolic name that refers to the device stanza.
discipline
Defines the queue-serving algorithm. The default, fcfs, means first come, first served. A value of sjn means shortest job next.
host
Specifies the name of the host from which to print. (The name of this host must be the same as the name specified by the HostName variable.)
l_statfilter
Translates long queue-status information from non-AIX® format to AIX format.
s_statfilter
Translates short queue-status information from non-AIX format to AIX format.
up (true/false)
Defines the state of the queue. The default true indicates that it is running. A value of false indicates that it is not.
-b "Attribute =Value..." Specifies a list of attributes with corresponding values for device stanza corresponding values to be used for updating the spooler's qconfig file or object class. The list should be enclosed in quotes. Valid attribute types follow:
access (write/both)
Specifies the type of access the backend has to the file specified by the file field. The access file has a value of write if the backend has write access to the file, or a value of both if the backend has both read and write access. This field is ignored if the file field has a value of false.
align (true/false)
Specifies whether the backend sends a form-feed control before starting the job if the printer has been idle. The default is false.
backend
Specifies the full path name of the backend, optionally followed by the flags and parameters to be passed to it.
feed
Specifies the number of separator pages to print when the device becomes idle, or takes a value of never, which indicates that the backend is not to print separator pages.
file
Identifies the special file where the output of the backend is to be redirected. The default values of false indicates no redirection. In this case, the backend opens the output file.
header (never/always/group)
Specifies whether a header page prints before each job or group of jobs. The default is a value of never which indicates no header page. To produce a header page before each job, specify a value of always. To produce a header before each group of jobs for the same user, specify a value of group.
trailer (never/always/group)
Specifies whether a trailer page prints after each job or group of jobs. The default value of never indicates no trailer page. To produce a trailer page after each job, specify a value of always. To produce a trailer after each group of jobs for the same user, specify a value of group.
-c Specifies to the chprtsv command to reconfigure print service for a client machine.
-d Specifies that changes be reflected in the system database only, so that they can take effect at the next system startup.
-H FileName Specifies the name of a file containing a list of host names to be included.
-h"HostName..." Specifies a list of host names to be included on the current list of remote users who can use the print server. Note that the queuing system does not support multibyte host names.
-i Specifies that the change be reflected not only in the database, but also in the current running system.
-q"QEntry" Specifies a qconfig file entry to be removed.
-s Specifies that print service reconfiguration is to be performed for a server machine.
-v DeviceName Specifies a list of device stanzas to be changed.
-X FileName Specifies the name of a file containing a list of host names to be excluded.
-x"HostName..." Specifies a list of host names to be excluded on the current list of remote users who can use the print server.

Examples

To reconfigure a print server, specify that the changes will take effect at the next startup, specify the file containing the host names, and then exclude some of those hosts, enter:

chprtsv -s -d -H ruser.inc -x "host1,host2,host3"

Files

Item Description
/etc/qconfig Contains configuration information for the printer queuing system.
/etc/hosts.lpd Specifies foreign hosts that can print on the local host.