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>