NAME

hline − Remote line printer on Harris H-Series host

SYNOPSIS

model of printer for lp(1)

DESCRIPTION

hline is the name of the model script that provides the remote printer interface for a lineprinter which is physically connected to a Harris H-Series system.  hline requires that the remote H-Series host has been configured to accept remote print requests. 

CONFIGURING PRINTER SOFTWARE

The hline remote printer is supported as part of the lp(1) spooling system.  Refer to the instructions in the CX/UX System Administration Manual for installing LP (in the managing peripherals chapter).  Hline remote printers must be configured into the LP subsystem via lpadmin(1M).  To add a printer lpsched(1M) cannot be currently running.  The printer should be added as:
lpadmin -plph -v/dev/null -mhline The -v option specifies the device to which the printer is connected.  Since the device actually exists on a remote system, this should be set to /dev/null.  The -m option specifies the model interface which the printer should use.  The -p option specifies the name you choose to call the printer, "lph" in this example. 

Entering the printer into the LP subsystem tells lpsched(1M) what interface program to run.  In the case of remote line printers on an H-Series system, a standard model interface, hline, is provided.  When the printer has been added via lpadmin(1M), an interface script will be created in the file /usr/spool/lp/interface/ printer_name.  This script is executed by lpsched(1M), for each spool request sent to the printer.  This script calls rlpf(1M) to transfer the file to the remote host. On the remote host rlpd, the VOS remote line printer, spools the file to the appropriate VOS PDN. 

Before using an hline printer you have configured via, you have to modify the interface script created to specify the name of the remote host the PDN of the printer. For a printer called "lph" you would edit the file /usr/spool/lp/interface/lph.  Change the lines which look like:       remotehost="-h systemx"
      remotepdn="-p 130" to reflect the actual system name and the PDN you wish to print to. In the example above, the system name is "systemx" and the remote PDN is "130".

In the event that rlpf(1M) encounters an error condition, it will exit with an error code, which will be passed back to the lpsched(1M) which in turn will send mail to the user that initiated the lp(1) request.  An error code of 1 usually indicates an error with the interface script itself. Other error number are generated by rlpf(1M), consult the man page for the meaning of these error codes. 

FILES

/usr/lib/rlpf
/usr/spool/lp/model/hline
/usr/spool/lp/interface/∗

SEE ALSO

lp(1), lpstat(1), cancel(1), rlpf(1M), enable(1), accept(1M), lpsched(1M), lpadmin(1M)

BUGS

Once the file has been transfered to the H-Series system, there is no way to determine which VOS spoolfile corresponds to your print request. In addition, once rlpf has transfered the file, cancel(1) has no effect on the print request and lpstat(1) does not indicate that the request exists. 

Only files containing ASCII text and files in the appropriate format for a Harris lineprinter should be spooled to this printer model. Other files may cause unexpected results. Tabs are expanded to spaces and formfeeds are converted to the appropriate spool control character in column one of each line as required by the VOS spooler. 

CX/UX Administrator’s Reference