NAME

       rxqueue - The Regina Rexx Interpreter external queue filter

SYNOPSIS

       rxqueue  [-h,  --help]  [-D,  --debug] [-t string, --text string] [queue] [/fifo | /lifo |
       /clear | /pull | /queued]

DESCRIPTION

       rxqueue is a utility that provides  access  to  the  Regian  Rexx  external  queue  daemon
       (rxstack).   It  acts as a filter by placing lines onto a queue via stdin or a single line
       with the -t or --text switches. Lines can be pulled off the queue to stdout

OPTIONS

       -h, --help
              Displays short help.

       -D, --debug
              Turns debugging on -t string, --text string Places the  single  line  specified  in
              string onto an optional queue in the order specified by /fifo or /lifo

       queue  The  name  of  the  queue  to  use.  Format  is  queuename[@machine][:port]. If not
              specified the queue name used is SESSION on localhost using the default port.

ACTIONS

       /fifo  Stacks the contents of stdin onto the queue in first in, first out order.

       /lifo  Stacks the contents of stdin onto the queue in last in, first out order.

       /clear Removes all lines currently stacked in the queue.

       /pull  Extracts the next line from the queue to stdout and removes it from the queue.

       /queued
              Returns the number of lines stacked on the queue to stdout

ENVIRONMENT

       rxqueue uses the following environment variables if set.

       RXDEBUG
              Enables debugging. Same as specifying -D or --debug option.

       RXSTACK
              The port number on which rxstack listens. By default this is 5757.

       RXQUEUE
              The name of the queue to be used if not specified by the client using rxqueue.   By
              default this is SESSION.

COPYRIGHT

       The  Regina  Rexx interpreter is distributed under the GNU Library General Public License,
       see the file `COPYING-LIB' in the source code distribution.

AUTHOR

       Anders Christensen, University of Trondheim, Norway <anders (at) pvv.unit.no>.

MAINTAINER

       Changes to Regina since  0.07a,  Mark  Hessling  <mark  (at)  rexx.org>  with  significant
       assistance from Florian Grosse-Coosmann.

SEE ALSO

       rxstack(1)

       There  are several good reference books on Rexx. The most famous is "The Rexx Language" by
       Mike Cowlishaw.  Visit http://www.rexxla.org (The Rexx Language Association) for any  Rexx
       related information.