Using the SAS RFC Server

Using the SAS RFC Server on Windows

In a Windows environment, the SAS RFC server for SAP is installed in the !SASROOT\access\sasexe directory.

To start or stop the SAS RFC server using a command line in the Windows operating environment, use the following command:

sasrfc_server [-i n] [-r] [-s] [-k] [-t n] [-d n] [-n name[,desc]] [-p port] 
     [-N namespace] [-V variant] [-help] [-c dialog_compat_port] 
     [-b "-p port-number -V variant_name -R report_name"] 
     [-B number_of_bytes]

The options for the SAS RFC server command for Windows are as follows:

-i n

installs the program as a Windows service and specifies the startup option for a new service. Startup options are

n=2	starts the service automatically
n=3	starts the service on demand
n=4	disables the service

-r

removes the program from the Service Manager.

-s

starts the service.

-k

stops the service

-t n

sets the startup option for an existing service. Startup options are

n=2	starts the service automatically
n=3	starts the service on demand
n=4	disables the service.

-d n

specifies the diagnostic level. When you specify the -d n option where n= any number between 1 and 6, the program runs as an application and messages are routed to standard error. Higher diagnostic levels route more detailed messages to standard error.

-n name,desc

specifies the name and description of the service.

-p port

specifies the port number on which the server listens. The default port number is 6999.

-N namespace

specifies the namespace for ABAP functions and programs that are used by SAS. The default value is /SAS/. If the ABAP programs are installed in the customer namespace rather than in the /SAS/ namespace, then this parameter identifies where the ABAP programs are installed.

-V variant

specifies the R/3 report variant that is assigned to this server. You must assign a report variant for each SAS RFC Server that accesses an R/3 application server in batch mode. The variant parameter G_DEST specifies a unique destination to call back to the SAS RFC Server.

-help

specifies that you want to display command line Help.

-c
dialog_compat
_port

identifies the option that, when specified, runs the SAS RFC Server in V8 compatibility mode on the port indicated by the dialog_compat_port parameter. The port number for a SAS 9.1 request must be different than the one used for the SAS 9 requests. If the -c option is omitted, no dialog compatibility will be available.

-b
"-p port_number
-V variant_name
-R report_name"

enables batch compatibility so that you can process V8 ACCR3 requests while you are using a V9 SAS RFC Server. You must use the double quotation marks in the batch compatibility option in order to separate the batch compatibility parameters from the V9 parameters that use the same syntax.

The port parameter is optional. If omitted, the port number defaults to 6999.

The report variant parameter is required and must be a valid variant of the report.

The report parameter is optional and would normally be omitted. If the report parameter is omitted, then report_name defaults to /SAS/ZSASV8COMPAT.

The values in port_number, variant_name, and report_name must be different from the values used by V9 and different from the values used by dialog compatibility.

-B number_of_bytes

sets the minimum buffer size for data transfers in batch and dialog modes. The number of bytes should be greater than 10000 and no more than 8 digits, or it will be ignored. If the -B option is omitted, the default is 10000 bytes.

In batch mode, if you specify a value for the G_BUFMAX parameter that is less than the value of -B, then the -B value is used.

For example, if you want to start the SAS RFC Server with a debug level of 1 on port number 6991, use the following command:

sasrfc_server -d 1 -p 6991

To install the SAS RFC Server as a service with automatic startup on port 6991 and use the name test and a description of 'Test RFC server', use the following command:

sasrfc_server -i 2 -n "test,Test RFC server" -p 6991

To uninstall the server that was started in the previous example, use the following command:

sasrfc_server -r -n "test"

Top of Page