NAME

himagen − Remote Imagen printer on Harris H-Series host

SYNOPSIS

model of printer for lp(1)

DESCRIPTION

himagen is the name of the model script that provides the remote printer interface for a model 4508 laser printer which is physically connected to a Harris H-Series system. See Imagen(7) for detailed information on the Imagen printer itself.  himagen requires that the remote H-Series host has been configured to accept remote print requests. 

CONFIGURING PRINTER SOFTWARE

The himagen remote printer is supported as part of the lp(1) spooling system.  Refer to the instructions in the CX/UX Systems Administration manual for installing LP (in the managing peripherals chapter).  Himagen 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 -pimagen -v/dev/null -mhimagen The -v option specifies the device to which the Imagen 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. 

Entering the printer into the LP subsystem tells lpsched(1M) what interface program to run.  In the case of remote imagen printers on an H-Series system, a standard model interface, himagen, 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 imfilt, which quotes non-ASCII characters, and adds document headers to the file. Then the 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 himagen 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 "imagen" edit the file /usr/spool/lp/interface/imagen.  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), see the man page for the meaning of these error codes. 

FILES

/usr/lib/imfilt
/usr/lib/rlpf
/usr/spool/lp/model/himagen
/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 the existence of the request. 

Only files containing ASCII text and files in the appropriate format for the Imagen printer should be spooled to this printer model. Other files may cause unexpected results. 

CX/UX Administrator’s Reference