QUEUE

Purpose

Read syntax diagramSkip visual syntax diagram>>-QUEUE--+------------+--;------------------------------------><
          '-expression-'
 

QUEUE appends the string resulting from expression to the tail of the external data queue. That is, it is added FIFO (First In, First Out).

If you do not specify expression, a null string is queued.

Note:
The REXX/CICS implementation of the external data queue is the program stack. The language processor reads a line from the program stack. If the program stack is empty, a terminal read occurs. The program stack for you is in an RLS queue named \SYSTEM\rexxtnum\*PROGSTACK* where rexxtrnum is an internal REXX task number.
Example:
a='Toft'
queue a 2  /* Enqueues "Toft 2" */
queue      /* Enqueues a null line behind the last */

The QUEUED built-in function (described on page ***) returns the number of lines currently in the external data queue.