RDISPLAY Command and RDISPLAY Statement

RDISPLAY Command and RDISPLAY Statement

Create two windows. One window displays the contents of the log and the other window lists output generated from the execution of an asynchronous remote submit.

Local

Syntax
Syntax Description

Syntax

RDISPLAY <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 displayed.

Details

The RDISPLAY command and the RDISPLAY statement create two windows to display the spooled log and the output that is generated by an asynchronous remote submit. One window displays the log statements, and the other window displays the output statements.

When an asynchronous remote submit executes, the log and the output are not merged into the local log and the output windows; instead, they are spooled until they are retrieved at a later time. RDISPLAY allows you to view the spooled log and output statements created by the asynchronous remote submit. RGET command and the RGET statement must be used to actually merge the spooled and local statements.

The primary difference between the RDISPLAY command and the RDISPLAY statement is that the command can only be used from a windowing environment session or within the DM statement. The RDISPLAY statement can be used in any type of SAS session on the local host.

The following are options for the RDISPLAY command and statement.

remote-session-id
CONNECTREMOTE=remote-session-id
REMOTE=remote-session-id: is the name of the remote session in which the asynchronous remote submit is executing or has executed. 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 displayed. 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