RGET Command and RGET Statement

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.

Local

Syntax
Syntax Description

Syntax

RGET <remote-session-id>;

Syntax Description

remote-session-id: specifies the name of the remote session which generated the spooled log and output that is to be retrieved.

Details

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 MACVAR 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. [cautionend]

The following are options for the RGET command and statement.

remote-session-id
CONNECTREMOTE=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. [cautionend]

Chapter Contents
Previous
Next
Top of Page