RXQUEUE.EXE

Description

The purpose of the RXQUEUE filter is to copy the output of an OS/2 program into a REXX queue (The RXQUEUE filter is the external program RXQUEUE.EXE - not the built-in function <RXQUEUE!) The syntax for RXQUEUE filter is:

+------------------------------------------------+
|                                                |
| >>--RXQUEUE--+-----------+--+--------+------>< |
|              +-queuename-+  +-/FIFO--+         |
|                             +-/LIFO--+         |
|                             +-/CLEAR-+         |
|                                                |
+------------------------------------------------+

The RXQUEUE filter usually operates on the default queue named "SESSION". However, if an environment variable named "RXQUEUE" exists, the RXQUEUE value is used for the queue name.

Parameters

queuename

   This is the name of the queue to use. The queue must already exist. 
   The name of a queue can only contain the following characters: 
   'A'...'Z', '0'...'9', '.', '!', '?' and '_'. Lowercase letters are 
   converted to uppercase letters. 

/LIFO

   Stacks items from STDIN last in, first out (LIFO) on a REXX queue. 

/FIFO

   Queues items from STDIN first in, first out (FIFO) on a REXX queue. 

/CLEAR

   Removes all lines from a REXX queue. 

Note: Again, do not confuse the RXQUEUE filter with the <RXQUEUE built-in function! Note further that you cannot use the RXQUEUE filter to write a REXX queue to STDOUT - you've to write a REXX program to do this task. (see Write the REXX Queue to STDOUT for an example).

Links

• OpenObject REXX RXQUEUE.EXE implementation - Open Source