SAS Component Language Dictionary

SUBMITCLEAR

Aborts a pending submit transaction

Category:

Submit Block

Syntax
Details
Example
See Also

Syntax

sysrc=SUBMITCLEAR();

sysrc

contains the return code for the operation:

0	successful
!0	not successful

Type: Numeric

Details

SUBMITCLEAR aborts a pending submit transaction. A submit transaction may be pending if the submitted DATA steps or procedure statements are not complete, or if the submitted text contains an open quoted string or other syntax errors. SUBMITCLEAR is particularly useful for terminating programs that are waiting on input because of unmatched quotes or other syntax errors.

A submit transaction starts as SAS/AF sends submitted text in the PREVIEW buffer to SAS for execution (usually through the SUBMIT CONTINUE option). If SUBMIT requests were queued up, they would be flushed out without being executed. The currently running step is aborted, and as a result, the log will not be updated with any specific status information relating to the step that is being terminated.

Example

This example submits code to SAS for execution, then calls SUBMITCLEAR to ensure there is no hanging transaction due to mismatched quoted strings or other syntax errors.

SUBUMIT CONTINUE;
  data test;
    . . .
ENDSUBMIT;

rc = SUBMITCLEAR();