Product SiteDocumentation Site

2.21. PUSH


>>-PUSH--+------------+--;-------------------------------------><
         +-expression-+

PUSH stacks the string resulting from the evaluation of expression LIFO (Last In, First Out) into the external data queue. (See Chapter 14, Input and Output Streams for a discussion of Rexx input and output.)
If you do not specify expression, a null string is stacked.

Example 2.35. Instructions - PUSH

a="Fred"
push       /* Puts a null line onto the queue */
push a 2   /* Puts "Fred 2"    onto the queue */

The QUEUED built-in function (described in Section 7.4.48, “QUEUED”) returns the number of lines currently in the external data queue.