tnprinter

This command manages printers in the TAS system. A printer, initially created as a system object, does not become available until a file service references it. Consequently, you must perform two operations to reference a printer: add a printer as a system object and reference a printer. This command lists, reads, adds, modifies, and deletes TAS printer configuration options.

You must reference printers from file services to allow connections to those services. A single file service may reference any number of printers. You must define printer names in lower case.

Because each TotalNET realm has its own case-mapping scheme, the naming conventions allow volume names to conform to the style of individual realm; however, one realm may allow a printer name that another realm does not.

Printers have three naming schemes:

• Each realm has its own set of characters for use in printer names. They do not include the null character ('\0'), upper case characters, and any other characters forbidden by the realm.

• All printer names must have at least one character, and at least one realm must allow all the characters in a name.

• Clients cannot access a printer with forbidden characters for a their realms. To make a printer accessible in all realms, you must create its name only from characters that all realms allow.

Location

TNHOME/usr/sbin

Usage

tnprinter [-L]
tnprinter [-R [-p printer [{-a attribute=value}]]]
tnprinter [(-A|-M) -p printer {-a attribute=value}]
tnprinter [-D -p printer]

Options

• "Realm Options"

• "Realm Options"

-p printer

Specify a printer.

Note

You cannot delete a printer from the system if a service references it.

Attributes

• "atalk-device-name"

• "description"

• "queue"

• "share-access"

• "share-passwd"

• "spooler-options"

• "template-only"

atalk-device-name

This attribute designates the printer's AppleTalk entity name. If defined, this attribute overrides the spooler and queue attributes defined under the system for the printer object. You must have the AppleTalk transports running, and the printer name must exist in the AppleTalk network.

Usage:

tnprinter -M -p printer -a atalk-device-name=name

description

This attribute designates a description of the printer. This attribute has no default.

Usage:

tnprinter -M -p printer -a description=string

queue

This attribute designates the UNIX queue name associated with the printer.

Usage:

tnprinter -M -p printer -a queue=queuename

share-access

This LM-NT-OS/2 realm attribute designates the printer mode, of value on or off. If you set this attribute to on, clients can access the printer through NB file services using share-level and user-level security. In this case, you can set a share password for the printer. If you set this attribute to off, clients can only access the printer through an NB file service using user-level security.

Usage:

tnprinter -M -p printer -a share-access={on|off}

share-passwd

This LM-NT-OS/2 realm attribute designates the share password for the printer. This attribute applies only if you set share-access to on. Use a plain-text string for the share password. If you do not specify this option, or if the string has no value, clients can access the printer without passwords through the NetBIOS file services using share-mode security.

Usage:

tnprinter -M -p printer -a share-passwd=password-string

spooler-options

This attribute designates options to pass to the UNIX printer spooler, such as lp.

Usage:

tnprinter -M -p printer -a spooler-options=option-strings

template-only

An attribute that, if set to on, causes the volume to behave only as a template, with no effect on TotalNET system performance.

Examples

1. Use one of the following commands to list all printers defined at the system level:

   tnprinter tnprinter -L

2. Use the following command to list the value of printer attribute queue for printer blahprn:

   tnprinter -R -p blahprn -a queue

3. Use the following command to change the value of the share-access attribute for the printer macprn to on:

   tnprinter -M -p macprn -a share-access=on

4. Use the following command to delete the printer blahprn as a printer option in the system:

   tnprinter -D -p blahprn