---
name: "rxqueue"
section: "1"
platform: "linux"
package: "regina-rexx"
version: "3.9.5+dfsg1-0.1+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/rxqueue-regina-rexx"
---

# rxqueue(1)

The Regina Rexx Interpreter external queue filter

Part of [rxqueue-regina-rexx(1)](/rxqueue-regina-rexx/1.md).

## 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)](/rxstack/1.md)

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.