CONNECTWAIT=

CONNECTWAIT=

Specifies the default whether remote submits are to be executed synchronously or asynchronously.

Remote

Syntax
Syntax Description

Syntax

CONNECTWAIT=YES|NO

Syntax Description

YES|Y: indicates to execute RSUBMITs synchronously.
NO|N: indicates to execute RSUBMITs asynchronously.

Details

The CONNECTWAIT= system option is used to set whether remote submits are to be executed synchronously or asynchronously by default during a SAS session. This default setting can be overridden by specifying the CONNECTWAIT= option in subsequent RSUBMIT statements for a particular remote submit. CWAIT is the alias for this option.

Synchronous processing means that you will wait for the remote processing to complete before regaining control in the local SAS session. This is the default processing technique for RSUBMIT if the CONNECTWAIT option is not specified. In the asynchronous case, after the RSUBMIT statement begins to execute in the background of the remote host, you will regain control of your local SAS session to continue local processing or to continue to RSUBMIT to other remote sessions.

If CONNECTWAIT=NO is specified, it will also be useful to specify the CMACVAR= option in the RSUBMIT statement. This will allow you to test the status of the current asynchronous RSUBMIT by determining whether it has completed or is still in progress.

When %SYSRPUT executes within a synchronous (CWAIT=YES) remote submit, the macro variable is defined to the local SAS session as soon as it executes.

When %SYSRPUT executes within an asynchronous (CWAIT=NO) remote submit, the macro variable will not be set in the local session until a synchronization point. See %SYSRPUT Statement for more details about synchronization points.

Chapter Contents
Previous
Next
Top of Page