rxstack
Section: User Commands (1)
Updated: February 1999
Index
Return to Main Contents
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>
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- ENVIRONMENT
-
- SEE ALSO
-
- AUTHOR
-
This document was created by
man2html,
using the manual pages.
Time: 00:11:57 GMT, February 16, 2023