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