RGET Command and RGET Statement

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.

Valid in:

client session

Syntax

Details

Syntax

RGET <<CONNECTREMOTE=>server-ID> ;

Syntax Description

CONNECTREMOTE=server-IDserver-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.

Alias:CREMOTE=, PROCESS=, REMOTE=

See: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 .

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 System Options: Reference.