The CALLRFC Procedure

PROC CALLRFC Statement

Invokes the CALLRFC procedure and specifies the connection and logon information of an SAP System. The connection to the SAP System is established and the logon information is verified.

PROC CALLRFC <options>;

Task		Option
Specify the name of the ABAP function module that SAS uses internally for metadata requests		ABAPFM=
Specify the name of the ABAP program that the SAS uses		ABAPPROG=
Specify connection and logon parameters
	Accessing the SAP System using connection and logon parameters associated with a libref	LIBREF=
	Specify additional logon or connection parameters	RFC_STRING=
Specify logon parameters
	Specify the SAP logon parameter for user	USER=
	Specify the SAP logon parameter for password	PASSWORD=
	Specify the SAP logon parameter for password in an encrypted form	PASSWORDX=
	Specify the SAP logon parameter for client	CLIENT=
	Specify the SAP logon parameter for language	LANGUAGE=
Specify connection parameters
	Specify the host name or IP address of a specific application server	ASHOST=
	Specify the destination defined in saprfc.ini for connecting to the SAP System	DESTINATION=
	Specify the name for a group of application servers	GROUP=
	Specify the host name of the SAP gateway	GWHOST=
	Specify the service of the SAP gateway	GWSERV=
	Specify the host name of the Message Server for the SAP System	MSHOST=
	Specify the name of the SAP System	R3NAME=
	Specify the string defined for SAPLOGON on 32-bit Windows	SAPLOGON_ID=
	Specify the SAP System number	SYSNR=
Specify SAS RFC Server parameters (z/OS only)
	Specify the host name of the SAS RFC Server	HOST=
	Specify the port number of the SAS RFC Server	PORT=
	Specify the mode for the CALLRFC procedure	MODE=
Specify data type and handling options
	Specify whether floating-point numbers are byte-reversed	IEEE_REVERSE=
	Specify the SAS data type for the ABAP type NUMC	NUMC_SAS_TYPE=
Enable tracing of RFC requests		TRACE=

Options

ABAPFM='abap-function-name'

specifies the name of the ABAP function module that SAS uses internally for metadata requests.

Note: This option is not the name of the ABAP function that is called in the CALL FUNCTION statement. [cautionend]

Aliases	ABAPFUNCTION=, ABAPFUNC=
Default	Z_SAS_DIALOG

ABAPPROG='abap-program'

specifies the name of the ABAP program that SAS uses.

Aliases	ABAPREPORT=, ABAPPROGRAM=
Default	Z_SAS_READ and is set by the ABAP function module

ASHOST='SAP-application-server-host'

specifies the host name or IP address of a specific application server. This option is used for SAP R/3 when it is not configured for load balancing.

Aliases

HST=, RFCHOST=, R3HOST=

CLIENT=SAP-client-number

specifies the SAP logon parameter for client. Examples for a client are 000 or 800. This is a required SAP LIBNAME engine option. The SAP System performs a logon check at OPEN time.

Aliases	CLI=, RFCCLIENT=, RFCCLI=
Default	The default value for this option is the SAP System default.

DESTINATION='SAP-destination'

specifies the destination in saprfc.ini if working with a saprfc.ini file for connecting to the SAP System. If the SAP System is an R/3 system this destination must also be defined in the 'sideinfo' for the SAP gateway.

Aliases

DEST=, DST=, DSTN=

GROUP='SAP-application-server-group'

specifies the name for the group of application servers when the SAP System is configured for load balancing.

GWHOST='SAP-gateway-host-name'

specifies the host name of the SAP gateway.

Alias

GATEWAY_HOST=

GWSERV='SAP-gateway-service'

specifies the service of the SAP gateway.

Alias

GATEWAY_SERVICE

HOST='RFC-server-host'

This option is supported in z/OS operating environments only. This option specifies the host name of the SAS RFC Server.

Aliases	RFC_SERVER_HOST=, RFC_SERVER=, SASRFC_SERVER=, SASRFC_SERVER_HOST=
Default	localhost

IEEE_REVERSE=flag

specifies whether floating-point numbers are byte-reversed.

Default	Y when the SAP R/3 application server is running on Windows N for all other platforms
Alias	IE3_REVERSE

LANGUAGE= SAP-logon-language

specifies the SAP logon parameter for language. The value for language is either the 2-byte ISO-language key or the 1-byte SAP-language. Examples for the language are EN, DE or E, D. The SAP System performs a logon check at OPEN time.

Aliases	LANG=, LNG=, RFCLANG=, RFCLNG=
Default	The default value for this option is the SAP System default.

LIBREF=SAP-engine-libref

specifies the libref for the library used to access the SAP System. The connection and logon information is copied from the libref. Because the connection and logon information is copied from the libref, this is the easiest way of using PROC CALLRFC.

MODE=DIRECT_SAP|RFC_SERVER

specifies the mode for the SAP LIBNAME engine. If DIRECT_SAP is specified, the SAP LIBNAME engine uses RFC calls to the SAP System directly. If RFC_SERVER is specified, a SAS RFC Server is used to communicate with the SAP System.

Default

The default for z/OS operating environments is RFC_SERVER, on all other hosts it is DIRECT_SAP.

MSHOST='SAP-message-server-host'

specifies the host name of the Message Server when the SAP System is configured for load balancing.

NUMC_SAS_TYPE='N'|'C'|'$'

specifies the SAS data type for the ABAP type NUMC. In SAS 8 generated views, it was N, but C is a better match. Setting NUMC_SAS_TYPE='N' ensures SAS 8 compatibility. The macro %R3CONNC sets this option to 'N' by default.

Aliases

NUMC_SASTYPE=, NUMC_TYPE=, NUMC=

PASSWORD='SAP-password'

specifies the SAP logon parameter for password. When using the SAP LIBNAME engine, either use the USER and PASSWORD options to specify logon credentials, or use the AUTHDOMAIN option to retrieve credentials from metadata. If single sign-on is used, this option is not needed. The SAP System performs a logon check at OPEN time.

Aliases

PASSWD=, PWD=, PW=, PASS=

PASSWORDX='encrypted-SAP-password'

specifies the SAP logon parameter for password in an encrypted form. It uses the encryption available with SAS/ACCESS Interface to R/3 for SAS version 8 and is supported for compatibility with the V8 connection profile.

Aliases

PASSWDX=, PWDX=, PWX=, PASSX=

PORT='RFC-server-port'

This option is supported in z/OS operating environments only. This option specifies the port number of the SAS RFC Server that is used to connect to the SAP System.

Aliases	RFC_SERVER_PORT=, RFCSERVERPORT=, SASRFC_SERVER_PORT=, SASRFCSERVERPORT=
Default	6999

R3NAME='SAP-system-name'

specifies the name of the SAP R/3 system when the SAP System is configured for load balancing.

RFC_STRING='additional-RFC-options'

specifies additional logon or connection parameters for the RfcOpenEx() call. This call is used to log on the SAP System. Using this option enables passing parameters to the RfcOpenEx call that are not SAP LIBNAME engine options. This option can be used to support future extensions of the RfcOpenEx call.

Alias

RFCSTRING=, RFC_OPTIONS_EXT=, RFCOPENEX=, ADDITIONAL_RFC_OPTIONS=

SAPLOGON_ID='SAP-logon-id'

specifies the string defined for SAPLOGON on 32-bit Windows.

SYSNR=SAP-system-number

specifies the SAP R/3 system number. This option is used for SAP R/3 when it is not configured for load balancing.

Aliases

SYS=, SYSTEM=, SYSNO=

TRACE='RFC-trace-flag'

determines whether the SAP RFC library traces the RFC requests. The default directory location is read from the RFC_TRACE_DIR environment variable. The rfc library logs messages in the file dev_rfc in the same directory.

0 or N : RFC tracing is disabled
1 or Y : RFC tracing is enabled

Default

USER=SAP-userID

specifies the SAP logon parameter for user. When using the SAP LIBNAME engine, either use the USER and PASSWORD options to specify logon credentials, or use the AUTHDOMAIN option to retrieve credentials from metadata. If single sign-on is used, this option is not needed. The SAP System performs a logon check at OPEN time.

Aliases

USR=, RFCUSER=, USERNAME=, USERID=

Top of Page