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.

Syntax

PROC CALLRFC <options>;

Summary of Optional Arguments

specifies the name of the ABAP function module that SAS uses internally for metadata requests.
specifies the name of the ABAP program that SAS uses.
enables tracing of RFC requests.
Specify connection and logon parameters
Access the SAP system using connection and logon parameters associated with a libref.
specifies additional logon or connection parameters for the RfcOpenEx() call.
Specify connection parameters
specifies the host name or IP address of a specific application server.
Specify the destination defined in saprfc.ini to connect to the SAP system.
specifies the name for a group of application servers.
specifies the host name of the SAP gateway.
specifies the host name of the Message Server for the SAP system.
specifies the name of the SAP R/3 system.
specifies the string defined for SAPLOGON on 32-bit Windows.
specifies the SAP R/3 system number.
Specify data type and handling options
specifies whether floating-point numbers are byte-reversed.
specifies the SAS data type for the ABAP type NUMC.
Specify logon parameters
specifies the SAP logon parameter for client.
specifies the SAP logon parameter for language.
specifies the SAP logon parameter for password.
specifies the SAP logon parameter for password in an encrypted form.
specifies the SAP logon parameter for user.
Specify SAS RFC Server parameters (z/OS only)
specifies the host name of the SAS RFC Server.
specifies the mode for the CALLRFC procedure.
specifies the port number of the SAS RFC Server.

Optional Arguments

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.
Alias:ABAPFUNCTION=, ABAPFUNC=
Default:Z_SAS_DIALOG
ABAPPROG='abap-program'
specifies the name of the ABAP program that SAS uses.
Alias: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.
Alias: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.
Alias: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 you are working with a saprfc.ini file to connect to the SAP system. If the SAP system is an R/3 system, you must also define this destination in the SIDEINFO file for the SAP gateway.
Alias: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'
specifies the host name of the SAS RFC Server. This option is supported in z/OS operating environments only.
Alias:RFC_SERVER_HOST=, RFC_SERVER=, SASRFC_SERVER=, SASRFC_SERVER_HOST=
Default:localhost
IEEE_REVERSE=flag
specifies whether floating-point numbers are byte-reversed.
Alias:IE3_REVERSE
Default:Y when the SAP R/3 application server is running on Windows

N for all other platforms

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, or D. The SAP system performs a logon check at OPEN time.
Alias: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 that is 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.
Alias: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.
Alias: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 8 and is supported for compatibility with the SAS 8 connection profile.
Alias: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.
Alias: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.
Alias: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 dev_rfc file in the same directory.
  • 0 or N: RFC tracing is disabled.
  • 1 or Y: RFC tracing is enabled.
Default:0
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.
Alias:USR=, RFCUSER=, USERNAME=, USERID=