rembak Command

Purpose

Sends a print job to a queue on a remote server.

Syntax

rembak -S Server -P Queue [ -R ] [ -N Filter] [ -L ] [ -p ] [ -q ] [ -x ] [ -# JobNumber ] [ -u UserName ] [ -X ] [ -o Option ] [ -T Timeout] [ -C] [ -D DebugOutputFile] [ File ... ]

Description

The rembak command sends a job to be queued on a remote server. The request can either be a print job, a status request, a job cancel request, or a request to kill the remote queuing system. The server and the queue flags are required. All the other flags are optional, depending on what needs to be done.

This command should only be called by the qdaemon command. It is not intended to be entered on the command line by a user. See the enq command for details on how to issue a print job request, or use the System Manager Interface Tool (SMIT) to request a print job.

Flags

Item Description
-# JobNumber Specifies the JobNumber to cancel.
-C Sends control file first. The lpd protocol allows two handshaking sequences for processing a print job. The default consists of sending the data files(s) first followed by the control file. The other sequence is to send the control file first followed by the data file(s). If -C is specified, rembak will send the control file first followed by the data file(s).
-D DebugOutputfile Turns on the debugging option for rembak. If no output file name is specified, or if there are any problems creating or writing to the output file, the debugging option is ignored. If the output file specified already exists, new debugging output is appended to the end of it.
-L Indicates a long (verbose) status request from the remote queue.
-N Filter Indicates the machine type of the remote server. The filter name is specified by the s_statfilter attribute in the /etc/qconfig file. Values for the filter variable include the following:
/usr/lib/lpd/aixshort
Indicates the server is another AIX® machine.
/usr/lib/lpd/aixv2short
Indicates the server is an RT with an AIX Version 2 operating system.
/usr/lib/lpd/bsdshort
Indicates the server is a bsd machine
/usr/lib/lpd/attshort
Indicates the server is an AT&T machine
-o Option Specifies an Option to be sent to the backend on the remote server. (These Options are passed through the rembak command.)
-p Indicates that the port range used by rembak is restricted to ports below 1023.
-P Queue Specifies the name of the Queue on the remote server where the print job is sent.
-q Indicates a short (abbreviated) status request from the remote queue.
-R Restarts the remote queuing system.
Note: The -R flag is not supported when sending a request to an operating system. The lpd daemon does not support such a request. The -R flag is supported only for compatibility with other systems.
-S Server Specifies the name of the remote print Server where the print request is sent.
-T Timeout Sets a timeout period, in minutes, for rembak to wait for acknowledgements from the remote server. If no value is specified, a default timeout of 90 seconds is used. This default is also used if Timeout is 0 or a negative value.
-u UserName@HostName Cancels a print job for UserName that was submitted from the HostName machine.
Note: The queuing system does not support multibyte host names.
-X Specifies that the rembak command send the -o Option to the remote server, even if the remote server is a non-AIX machine. If the remote is a non-AIX machine, then the Option is sent without the -o flag. Thus, -o -abc is sent as -abc.

To use the -X flag on a remote queue, the following line for the specific queue must be included in the /etc/qconfig file:

backend = /usr/lib/lpd/rembak -X

The qprt, lpr and other queuing commands are not guaranteed to work when -X is specified on a queue. Use the enq command.

-x Cancels a job request. Use the -# JobNumber flag or the -u UserName flag to cancel a request.

Examples

  1. To print the files spinach, asparagus, and broccoli on the queue popeye on the remote server olive, which is an RT with an AIX Version 2 operating system, enter:
    rembak -S olive -P popeye -N /usr/lib/lpd/aixv2short spinach asparagus broccoli
  2. To issue a verbose status request to olive for the queue popeye, enter:
    rembak -S olive -P popeye -N /usr/lib/lpd/aixv2short -L
  3. To cancel job number 23 on a remote server submitted by user sweetpea from machine bluto, which is a Version 3 machine, enter:
    rembak -S olive -P popeye -N /usr/lib/lpd/aixv2short -x -#23 -u sweetpea@bluto

Files

Item Description
/usr/lib/lpd/rembak Contains the rembak command.
/etc/hosts.lpd Contains host names that are allowed to do print requests.
/etc/hosts.equiv Contains host names that are allowed to do print requests.