RDISPLAY Command and RDISPLAY Statement

Creates a Log window to display the lines from the log and an Output window to list the output generated from the execution of the statements within an asynchronous RSUBMIT block.

Valid in:

client session

Syntax

Details

Syntax

RDISPLAY <<CONNECTREMOTE=>server-ID > ;

Syntax Description

CONNECTREMOTE=server-IDserver-ID: specifies the name of the server session that the asynchronous RSUBMIT is executing in or has executed in. If only one session is active, you can omit server-ID. If multiple server sessions are active and you omit this option, the spooled log and output statements from the most recently accessed server session are displayed.

Alias:CREMOTE=, PROCESS=, REMOTE=

Details

The RDISPLAY command and the RDISPLAY statement create a Log window to display the spooled log and an Output window to display the output that is generated by an asynchronous RSUBMIT.

When an asynchronous RSUBMIT executes, the log and the output are not merged into the client Log and Output windows. Instead, they are spooled until they are retrieved at a later time. RDISPLAY enables you to view the spooled log and output statements that are created by the asynchronous RSUBMIT. The RGET command and the RGET statement must be used to merge the spooled statements into the client Log and Output windows.

The primary difference between the RDISPLAY command and the RDISPLAY statement is that the command can be used only from a windowing environment session or within a DM statement. The RDISPLAY statement is used in a client session.