The CALLRFC Procedure
PROC CALLRFC Statement
Calls the CALLRFC procedure and specifies SAP system connection and logon information. The SAP system connection established and logon information is verified.
Syntax
Summary of Optional Arguments
ABAPFM='abap-function-name'
specifies the name of the ABAP function module that SAS uses internally for metadata requests.
ABAPPROG='abap-program'
specifies the name of the ABAP program that SAS uses.
TRACE='RFC-trace-flag'
allows tracing of RFC requests.
Specify connection and logon parameters
LIBREF=SAP-engine-libref
specifies the libref for the library that is used to access the SAP system using connection and logon parameters.
RFC_STRING='additional-RFC-options'
specifies additional logon or connection parameters for the RfcOpenEx() call.
Specify connection parameters
ASHOST='SAP-application-server-host'
specifies the host name or IP address of a specific application server.
DESTINATION='SAP-destination'
specifies the destination that is defined in saprfc.ini, if you are working with that file to connect to the SAP system.
GROUP='SAP-application-server-group'
specifies the name for a 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.
GWSERV='SAP-gateway-service'
MSHOST='SAP-message-server-host'
specifies the host name of the Message Server for the SAP system when the SAP system is configured for load balancing..
R3NAME='SAP-system-name'
specifies the name of the SAP R/3 system when the SAP system is configured for load balancing.
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.
Specify data type and handling options
IEEE_REVERSE=flag
specifies whether floating-point numbers are byte-reversed.
NUMC_SAS_TYPE='N'|'C'|'$'
specifies the SAS data type for the ABAP type NUMC.
Specify logon parameters
CLIENT=SAP-client-number
specifies the SAP logon parameter for client.
LANGUAGE= SAP-logon-language
specifies the SAP logon parameter for language.
PASSWORD='SAP-password'
specifies the SAP logon parameter for password.
PASSWORDX='encrypted-SAP-password'
specifies the SAP logon parameter for password in an encrypted form.
USER=SAP-userID
specifies the SAP logon parameter for user.
Specify SAS RFC Server parameters (z/OS only)
HOST='RFC-server-host'
specifies the host name of the SAS RFC Server.
MODE=DIRECT_SAP|RFC_SERVER
specifies the mode for the CALLRFC procedure.
PORT='RFC-server-port'
specifies the port number of the SAS RFC Server that is used to connect to the SAP system.
Optional Arguments
ABAPFM='abap-function-name'
specifies the name of the ABAP function module that SAS uses internally for metadata requests.
| Alias | ABAPFUNCTION=, ABAPFUNC= |
| Default | Z_SAS_DIALOG |
| Note | This option is not the name of the ABAP function that is called in the CALL FUNCTION statement. |
ABAPPROG='abap-program'
specifies the name of the ABAP program that SAS uses.
| Alias | ABAPREPORT=, ABAPPROGRAM= |
| Default | Z_SAS_READ (set by the ABAP function module) |
ASHOST='SAP-application-server-host'
specifies the host name or IP address of a specific application server.
| Alias | HST=, RFCHOST=, R3HOST= |
| Note | This option is used for SAP R/3 when it is not configured for load balancing. |
CLIENT=SAP-client-number
specifies the SAP logon parameter for client.
| Alias | CLI=, RFCCLIENT=, RFCCLI= |
| Default | SAP system default |
| Requirement | This is a required SAP LIBNAME engine option. |
| Note | The SAP system performs a logon check at OPEN time. |
| Example | 000 or 800 (for a client) |
DESTINATION='SAP-destination'
| Alias | DEST=, DST=, DSTN= |
| Requirement | If the SAP system is an R/3 system, you must also define this destination in the SIDEINFO file for the SAP gateway. |
GROUP='SAP-application-server-group'
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 operating environments .
| Alias | RFC_SERVER_HOST=, RFC_SERVER=, SASRFC_SERVER=, SASRFC_SERVER_HOST= |
| Default | localhost |
| z/OS specifics | z/OS only |
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.
| Alias | LANG=, LNG=, RFCLANG=, RFCLNG= |
| Default | The default value for this option is the SAP system default. |
| Notes | The value for language is either the 2-byte ISO-language key or the 1-byte SAP language. |
| The SAP system performs a logon check at OPEN time. | |
| Example | EN, DE or E, D |
LIBREF=SAP-engine-libref
| Note | Connection and logon information is copied from the libref. As a result, this is the easiest way to use PROC CALLRFC. |
MODE=DIRECT_SAP|RFC_SERVER
| Default | RFC_SERVER (z/OS) |
| DIRECT_SAP (all other hosts) | |
| Note | 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. |
MSHOST='SAP-message-server-host'
NUMC_SAS_TYPE='N'|'C'|'$'
specifies the SAS data type for the ABAP type NUMC.
| Alias | NUMC_SASTYPE=, NUMC_TYPE=, NUMC= |
| Notes | The %R3CONNC macro sets this option to N by default. |
| In SAS 8 generated views, it was N, but C is a better match. Setting NUMC_SAS_TYPE='N' ensures SAS 8 compatibility. |
PASSWORD='SAP-password'
specifies the SAP logon parameter for password.
| Alias | PASSWD=, PWD=, PW=, PASS= |
| Notes | 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. |
PASSWORDX='encrypted-SAP-password'
specifies the SAP logon parameter for password in an encrypted form.
| Alias | PASSWDX=, PWDX=, PWX=, PASSX= |
| Note | This option uses the encryption available with SAS/ACCESS Interface to R/3 for SAS 8. It is supported for compatibility with the SAS 8 connection profile. |
PORT='RFC-server-port'
| Alias | RFC_SERVER_PORT=, RFCSERVERPORT=, SASRFC_SERVER_PORT=, SASRFCSERVERPORT= |
| Default | 6999 |
| z/OS specifics | z/OS only |
R3NAME='SAP-system-name'
RFC_STRING='additional-RFC-options'
specifies additional logon or connection parameters for the RfcOpenEx() call.
| Alias | RFCSTRING=, RFC_OPTIONS_EXT=, RFCOPENEX=, ADDITIONAL_RFC_OPTIONS= |
| Note | This call is used to log on the SAP system. Using it allows passing parameters to the RfcOpenEx call that are not SAP LIBNAME engine options. It can be used to support future extensions of the RfcOpenEx call. |
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.
| Alias | SYS=, SYSTEM=, SYSNO= |
| Note | This option is used for SAP R/3 when it is not configured for load balancing. |
TRACE='RFC-trace-flag'
| Default | 0 or N (disables RFC tracing) |
| Notes | 1 or Y (allowss RFC tracing) |
| This option 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. |
USER=SAP-userID
specifies the SAP logon parameter for user.
| Alias | USR=, RFCUSER=, USERNAME=, USERID= |
| Notes | When using the SAP LIBNAME engine, use either the USER= and PASSWORD= options to specify logon credentials, or use the AUTHDOMAIN= option to retrieve credentials from metadata. |
| This option is not needed if you use single sign-on. | |
| The SAP system performs a logon check at OPEN time. |