Chapter Contents

Previous

Next
SUBMITCLEAR

SUBMITCLEAR



Aborts a pending submit transaction

Category: Submit Block


Syntax
Details
Examples
Example 1: Abort a Pending Transaction
See Also

Syntax

sysrc=SUBMITCLEAR();

sysrc
contains the return code for the operation:
0 successful
!0 not successful

Type: Numeric


Details

SUMBITCLEAR 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.


Examples

Example 1: Abort a Pending Transaction

Submit code to SAS for execution, then call SUBMITCLEAR to ensure there is no hanging transaction due to mismatched quoted string or other syntax errors.

SUBUMIT CONTINUE;
  data test;
    . . .
ENDSUBMIT;

rc = SUBMITCLEAR();

See Also

PREVIEW

SUBMIT


Chapter Contents

Previous

Next

Top of Page

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.