| RGET Command and RGET Statement |
Retrieve the log and output that are created by an asynchronous
remote submit and merge them into local log and output windows.
|
RGET <remote-session-id>;
|
- remote-session-id
- specifies the name of the remote session which generated
the spooled log and output that is to be retrieved.
The RGET command and the RGET statement cause all the spooled log and output
from the execution of an asynchronous remote submit to be merged into the
local log and output windows. When an asynchronous remote submit executes,
the log and output statements are not merged into the local log and output
windows, but instead they are spooled until retrieved at a later time.
If the RGET command or RGET statement is executed while
the asynchronous remote submit is still in progress, all currently spooled
log and output statements are retrieved and merged into local log and output
windows, and the remote submit continues processing as if it were submitted
synchronously. That is, you will NOT regain control until the remote submit
has completed. If you don't want the remote submit to become synchronous,
but you want to check its progress, use the CMACVAR option in the SIGNON or
the RSUBMIT statement. This allows you to check the progress of an asynchronous
remote submit without causing it to execute synchronously.
Note: The system option _LAST_, used to specify the name of the
most recently created data set, is not updated for asynchronous remote submits.
The system option _LAST_ is not updated even when RGET forces an asynchronous
remote submit to a synchronous remote submit. ![[cautend]](../common/images/cautend.gif)
The following are options for the RGET command and statement.
-
remote-session-id
CONNECTREMOTE=remote-session-id
CREMOTE=remote-session-id
REMOTE=remote-session-id
-
is the name of the remote session that generated
the spooled log and output that you want to retrieve. If you have only one
active session, remote-session-id is not needed. When you have
multiple remote sessions that are active and you omit this option, the spooled
log and output statements from the current remote session are retrieved and
merged into the local log and output windows. The current remote session is
the one that is specified in the most recent, successful CONNECTREMOTE= system
option, SIGNON command/statement, RDISPLAY command/statement, RGET command/statement
or RSUBMIT command/statement.
Note:
This command/statement is available in Version
7 and later.
Copyright © 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.
