Syntax for the RSUBMIT Statement and Command |
Retrieves the log and output that are created by an asynchronous
RSUBMIT and merges them into the Log and Output windows of the client session.
RGET <<CONNECTREMOTE=>server-ID>;
|
-
CONNECTREMOTE=server-ID
server-ID
-
specifies the name of the server session
that generated the spooled log and output to be retrieved. If only one session
is active, server-ID can be omitted. If multiple
server sessions are active and the option is omitted, the spooled log and
output statements from the most recently accessed server session are retrieved
and merged into the client Log and Output windows. You can find out which
server session is the current session by examining the value that is assigned
to the CONNECTREMOTE system option.
Details
The RGET command and the RGET statement cause all the
spooled log and output from the execution of an asynchronous RSUBMIT to be
merged into the client Log and Output windows. When an asynchronous RSUBMIT
executes, the log and output are not merged into the client Log and Output
windows immediately. Instead, the log and output are spooled and retrieved
later.
If the RGET command or RGET statement is executed while
the asynchronous RSUBMIT is still in progress, all currently spooled log and
output statements are retrieved and merged into client Log and Output windows.
The RSUBMIT continues execution as if it were submitted synchronously. Control
is returned to the client session after the RSUBMIT has completed.
If you do not want RSUBMIT to become synchronous, but
you want to check its progress, use the CMACVAR= option in the RSUBMIT or
the SIGNON statement. CMACVAR= enables you to monitor the progress of an asynchronous
RSUBMIT without causing it to execute synchronously.
Note: For an overview about monitoring SAS tasks, see
Monitoring MP CONNECT Tasks. ![[cautionend]](../../../../common/61991/HTML/default/images/cautend.gif)
Note: For asynchronous RSUBMIT statements, the SAS system
option _LAST_, which is used to find out the name of the most recently created
data set, does not get updated. Also, if RGET is used to change RSUBMIT execution
from asynchronous to synchronous, the system option _LAST_ is not updated.
For more information about _LAST_, see
SAS Language Reference: Dictionary. ![[cautionend]](../../../../common/61991/HTML/default/images/cautend.gif)
Copyright © 2008 by SAS Institute Inc., Cary, NC, USA. All rights reserved.