SYSRPUTSYNC System Option

Sets %SYSRPUT macro variables in the client session when the %SYSRPUT statements are executed rather than when a synchronization point is encountered.
Client: optional
Server: optional
Valid in: configuration file, OPTIONS statement, SAS System Options window, SAS invocation
Category: Communications: Networking and Encryption
PROC OPTIONS GROUP= Communications
Alias: CSYSRPUTSYNC, NOCSYSRPUTSYNC
Default: NOSYSRPUTSYNC

Syntax

SYSRPUTSYNC | NOSYSRPUTSYNC

Syntax Description

SYSRPUTSYNC
specifies that the client session's macro variables will be updated when the client session receives the results of the server session's execution of the %SYSRPUT macro. The results are delivered in the form of a packet. Specifying YES does not mean that the client's macro variables will be updated immediately after the server's execution of the %SYSRPUT macro variable. YES means that the client's macro variables will be updated when the client receives the packet from the server. Therefore, the exact time that the client's macro variables are updated will depend on the availability of the client to receive the packet. If the client is busy, the server waits until the client is ready to receive the packet.
NOSYSRPUTSYNC
specifies that the client session's macro variables will be updated when a synchronization point is encountered.

Details

This option is useful only when executing an asynchronous RSUBMIT, which is enabled via these methods:
  • NOCONNECTWAIT system option
  • CONNECTWAIT=NO option in RSUBMIT
  • CONNECTWAIT=NO option in SIGNON
In addition to being a system option, CSYSRPUTSYNC= can be specified as an option in the RSUBMIT statement. The CSYSRPUTSYNC= option in the RSUBMIT statement or command takes precedence over the system option.
By contrast, a synchronous RSUBMIT is enabled via these methods:
  • CONNECTWAIT system option
  • CONNECTWAIT=YES option in RSUBMIT
  • CONNECTWAIT=YES option in SIGNON
A synchronous RSUBMIT causes macro variables to be updated when a synchronization point is encountered.
Note: You should not change the value of the SYSRPUTSYNC= option between consecutive asynchronous RSUBMIT statements. Changing SYSRPUTSYNC= between asynchronous RSUBMIT statements causes unpredictable results.