The PUSH subroutine pushes character arguments that contains 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 many statements at one time. Pushing too many statements causes problems that can result in exiting the SAS system.

For details, see Chapter 18.

An example that uses the PUSH subroutine follows:

   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;