PUSH Call

Chapter Contents

Language Reference

PUSH Call

pushes SAS statements into the command input stream

CALL PUSH( argument1<, argument2,..., argument15>);

where argument is a character matrix or quoted literal containing valid SAS statements.

The PUSH subroutine pushes character arguments containing valid SAS statements (usually SAS/IML statements or global statements) to the input command stream. You can specify up to 15 arguments. Any statements pushed to the input command queue get executed when the module is put in a hold state. This is usually induced by one of the following:

an execution error within a module
an interrupt
a pause command

The string pushed is read before any other lines of input. If you call the PUSH subroutine several times, the strings pushed each time are ahead of the less recently pushed strings. If you would rather place the lines after others in the input stream, then use the QUEUE command instead.

The strings you push do not appear on the log.

CAUTION: Do not push too much code at one time.

Pushing too much code at one time, or getting into infinite loops of pushing, causes problems that may result in exiting the SAS system.

For details, see Chapter 15, "Using SAS/IML Software to Generate IML Statements."

An example using the PUSH subroutine is shown below:

   start;
      code='reset pagesize=25;';
      call push(code,'resume;');
      pause;
         /* show that pagesize was set to 25 during   */
         /* a PAUSE state of a module                 */
      show options;
   finish;
   run;

Chapter Contents
Previous
Next
Top