Printing to Reality Printers from the Host

This section describes how to associate UNIX lp printer names with Reality formqueues. Users will then be able to send print jobs to Reality formqueues using the standard UNIX lp command.

You administer Reality printers by selecting the Reality Printer Administration option (realityprint) from the Print Management Utility menu. The following menu is displayed:

                   Reality Printer Administration
addprinter   - Make a Reality Form Queue available as UNIX printer
listprinters - List Reality printers
remprinter   - Deconfigure a Reality Form Queue for UNIX access

UNIX and Reality configuration

If you intend printing to Reality formqueues, you will first need to configure both the UNIX and Reality environments:

• Create a UNIX user called rxlp. For security reasons, this user should use a restricted shell and have a password.
• On Reality, do the following
  • Use SSM, USERS File Maintenance to create a user called PRINTER-SERVER. This user must have no password (field 1), have SERVERS as its default account (field 7), and operate in server mode only (set field 14 to 'S').
  • Use CREATE-ACCOUNT to create a synonym (Q-pointer) account. Set the actual account name to SYSPROG.

Adding a printer

ROUTE-FILE entry

Before you can add a Reality printer, you must ensure that the ROUTE-FILE contains entries that will allow you to communicate with the Reality environment:

• If the formqueue is on a remote REALITY system Unless otherwise stated, references to REALITY systems in this section refer to REALITY 7.x on Series 19. , the ROUTE-FILE entry must be a destination type entry that identifies the remote system.
• If the formqueue is on a remote Reality database Unless otherwise stated, references to Reality databases in this section refer to RealityX on UNIX and Reality 8.x or later on UNIX and Windows. , there must be two ROUTE-FILE entries — a destination entry that defines the system that holds the Reality database, and a Q-type entry that points to the database.
• If the formqueue is on a local Reality database there must be two ROUTE-FILE entries — a Reality entry that defines the database, and a Q-type entry that points to that database. These entries must either both have the same system name, or the Q-type entry must point to the Reality entry.

Printer configuration

To add a new network printer, select addprinter  from the Reality Printer Administration menu. You will see the following prompts:

1. Northgate Reality Printer Client Setup
 ======================================
 
 Enter the UNIX printer name:

   Enter the local UNIX printer name which UNIX users will use with the lp command to send print jobs to the Reality formqueue.

   Note The printer must not already exist - it will be created by addprinter.

2. Enter the Reality system name :

   This must be the system name of the ROUTE-FILE entry that points to the system or database containing the required formqueue.

   • If the Reality formqueue is on a remote REALITY system, this must be the destination type entry that identifies that system.
   • If the formqueue is on a Reality database, it must be the Q-type entry that points to the database.

3. Enter the Reality form-queue name (default is STANDARD):

   Enter the name of the Reality formqueue. If you do not specify a formqueue name, print jobs will be sent to the STANDARD formqueue.

4. Enter the UNIX User id:

   • If the Reality formqueue is on a remote REALITY system, press RETURN.
   • If the formqueue is on a Reality database, enter rxlp.

5. Enter the UNIX Password:

   This prompt is only displayed if you have entered a user-id.

   Enter the password for the rxlp user entered above.

Once a valid printer name, system name and formqueue name (and for a connection to a Reality database, a user-id and password) have been entered, the following series of messages is displayed:

Installing UNIX printer Printer

        System   : UserId
        Formqueue: FormQueue

destination "Printer" now accepting requests
printer "Printer" now enabled

UNIX Installation Complete

Once this operation has completed successfully a printer interface script of the same name as the UNIX printer will have been created in /etc/lp/interfaces. The lp command can be used with the -o switch to pass an optional parameter in argument 5 ($5), this can be passed on to the Reality spooler as SP-ASSIGN options by appending -o$5 to the REALPRINT command line.

Listing printers

To display a list of Reality printers (that is, a list of UNIX printer names which have been associated with Reality formqueues), select listprinters from the Reality Printer Administration menu. You will see a list similar to the following:

Northgate List Reality Printers
===============================
members of class Reality:
        name name

Press ENTER to continue

Removing a printer

To remove an association between a local UNIX printer name and a Reality formqueue, select remprinter  from the Reality Printer Administration menu. You will see the following prompt:

Northgate Reality Printer Client Removal
========================================
Enter the UNIX printer name :

Enter the name of the printer you wish to remove. You will see the following messages:

Removing UNIX printer Printer

destination "Printer" will no longer accept requests
printer "Printer" now disabled 
UNIX Printer Removal Complete