rxstack(1)

NAME
rxstack - access the Rexx data queue

SYNOPSIS
rxstack [ -fifo | -lifo ] [ -drop | -num | -peek | -pop | -print | -string data ]

DESCRIPTION
rxstack is a program to access the data queue served by rxque(1) and used by rexx(1). It can be used to stack the output of a Unix command for use in Rexx programs or to feed the contents of the queue into a Unix command. With no parameters, rxstack reads lines from the standard input and stacks them in FIFO (first in, first out) order. This behaviour may be modified by supplying an alternative order and/or an alternative action to perform.

OPTIONS

-fifo
    Specify FIFO order (the first item to be stacked will be the first item output).

-lifo
    Specify LIFO order (the last item to be stacked will be the first item output, and this will also be output before all items stacked in FIFO order).

-drop
    Delete the first item in the queue.

-num
    Print the current number of items in the queue.

-peek
    Print the first item in the queue without changing the queue.

-pop
    Remove and print the first item in the queue.

-print
    Remove and print successive items from the queue until the queue is exhausted. (It is possible for this command to leave some items in the queue if it is terminated by a signal such as SIGPIPE before the queue is exhausted.)

-string data
    Add the data to the queue as a single item.

ENVIRONMENT
The environment variable RXSTACK must be set to the name of the communication socket which is in use by a stack server.

SEE ALSO
rexx(1), rxque(1), The REXX/imc documentation.

AUTHOR
Ian Collier <imc@comlab.ox.ac.uk>