NAME

rlpf − filter to send data to an rlpd daemon on a remote H-Series system

SYNOPSIS

rlpf [ −t ] −h host −p pdn −f function [ −q ] [ −n ] [ −m margin ]

DESCRIPTION

rlpf is a filter used by the hline and himagen LP printer models.  The filter transports a file via TCP/IP protocols to the rlpd daemon on a remote Harris H-Series host for subsequent printing by the the VOS spooling system.  The filter takes standard input and, depending on the options selected, translates the CX/UX byte stream into a VOS record-oriented stream.  The rlpd daemon on the remote H-Series system takes this image and spools it the the appropriate VOS printer. 

The command line options are:

−t Optionally turn on trace function to stderr to display the operation of the filter. This is for diagnostic purposes and should be left out for most work. 

−h host
rlpf will attempt to connect to the given host. This name should appear in the hosts network database file as a valid network host. The rlpd daemon must be running on the remote H-Series system. 

−p pdn
rlpf will inform the remote system that the file is to be printed on the given VOS PDN (physical device number). 

−f function
This causes rlpf to optionally perform a translation other than Harris Symbolic.  The symbolic translation function, hs, is the default. Other translation functions are: hb, Harris Binary translation (the stream is transmitted as close to a stream as is possible); hi, Imagen translation, transmitting the stream enclosed by a pair of Impress Language file delimiters. 

−q The hi function optionally can be used to quote the byte stream. This may or may not be required by the remote site. 

−n Suppress the banner page on the VOS system.  This option can be used when sending symbolic records. 

−m margin
The hs function optionally can be made to indent the symbolic image by margin spaces, where margin is an integer 0-40. This is an aid to printer images where the printer margins cannot be reset manually. 

The purpose of rlpf is to allow a user to transport a file, in whatever format, to an rlpd daemon on an H-Series host and its attached printers. The rlpd daemon supports remote spooling between H-Series VOS hosts but is sufficiently flexible to accept input from any client, assuming it is in the appropriate form. 

DATA FORMATS

Rlpd expects input from its port in the following form:

 <013> <pdn>
function code open, 16-bit pdn number

 <002> <bc> ... 
function code symbolic write, 16-bit byte count, symbolic byte stream record

 <004> <bc> ... 
function code binary write, 16-bit byte count, binary byte stream record

 <006> <bc> ... 
function code special write, 16-bit of byte count, special byte stream record

 <014> <000> <000>
function code close

To each function code packet rlpd responds with a single byte to indicate that it is OK to continue sending data. 

The open code opens a spool file on the remote site. The intermediate symbolic write, binary write, and special write write out records to the VOS file with those record types. The close will terminate the stream and rlpf will close the file, which allows the spooler to print the file. 

rlpd requires no login on the remote system. The daemon simply takes what he is given and writes it the appropriate PDN. 

The rlpd daemon will terminate in the event the formats in DATA FORMATS are not met. The records sent before the abnormal termination are still spooled. This should not occur in normal operation. 

ERROR CODES

Rlpf returns a 0 if the file was successfully sent to the remote host, in the event of an error, one of the following values is returned:

1-9A general error condition exists (not rlpf specific)
10Connection time-out
11Connection broken by remote daemon
12No acknowledgement received from remote daemon
13Error with arguments on command line
14Invalid function requested  on command line
15Multiple hosts declared on command line
16Host name can not be found in hosts database
17The rlpd service can not be found in the services database
18Multiple PDNs declared on command line
19No remote site specified on command line
20No PDN specified on command line
21Error occurred in call to socket()
22Error occurred in call to connect(),
        the remote system may be down

FILES

/usr/lib/rlpf

SEE ALSO

himagen(7),hline(7)

CX/UX Administrator’s Reference