Skip to main content

Step 5 — Create the RFC Connection in SAP

Step 5 — Create the RFC Connection in SAP

This guide shows how to set up the TCP/IP RFC destination that Crestone will use to communicate with your SAP system.

The RFC destination provides the secure transport channel for Crestone to execute remote-enabled function modules.

info

Note on handling extractions: By default, Crestone uses a single RFC connection (CRESTONE_SERVER) to communicate with the SAP system, which means that extractions are executed sequentially—that is, an RFC connection can only process one extraction at a time. If your scenario requires running multiple extractions simultaneously, see the "Using Parallelism: Additional RFC Connections (Slots)" section below.

Prerequisites​

  • SAP GUI (SAP Logon) access to the target system/client.
  • Technical user dedicated to Crestone integration with the role ZCRESTONE assigned (see Step 4).
  • Hostname/IP, system number (SYSNR), client, and logon language for the SAP application server where Crestone will connect.

1) Open the RFC configuration​

  1. Log in to SAP with a user authorized to maintain RFC destinations.
  2. Launch transaction SM59 (RFC Destinations).
  3. In the navigation tree, expand TCP/IP Connections.
  4. Click Create (or use Display/Change → Create).

alt text

2) Maintain the RFC destination​

Fill the tabs as follows:

Technical Settings

  • RFC Destination: CRESTONE_SERVER.
  • Connection Type: Select T (TCP/IP Connection).
  • Description: Provide a short purpose (e.g., "Crestone integration").
  • Activation Type: Choose Registered Server Program.
  • Program ID: Set a unique identifier (e.g., CRESTONE_SERVER). This must match the ID configured in the Crestone connector.
  • Leave Gateway Host and Gateway Service with the default values for your SAP system unless BASIS specifies otherwise.

No logon credentials are required for TCP/IP destinations. Save the destination when the fields are complete.

Click Save when the fields are complete.

alt text

These Gateway options are essential for RFC connection with SAP. Although they are located at the bottom of the screen and require scrolling, they must be completed for the integration to function correctly.

Techical Settings

  • Gateway Host: Here you must specify the IP address or hostname of the SAP server acting as the Gateway host. This information is critical, as it defines which SAP system the RFC service will connect to.

  • TCP Service: This value corresponds to the standard SAP Gateway service, in the format: sapgw + SAP instance number

(for example: sapgw00, sapgw01, etc.).

Special Options

Classical serialization ("classic") must be configured, as it is the setting that ensures the orderly and stable processing of asynchronously transmitted data. If left configured as "fast" (or any option other than "classic"), the connection will fail and produce the following error:

[JCO ERROR SYSTEM FAILURE: Index -1 out of bounds for length 0 RFC ERROR SYSTEM – Message number: 341]

serialization

Regarding the handling of outgoing bgRFCs, the option to convert outgoing bgRFCs to outgoing qRFCs should be selected. This maintains execution order, improves queue monitoring, and facilitates error analysis during the testing and validation phase.

3) Test the connection​

  1. With the new destination selected, choose Connection Test.
  2. Confirm you receive status Connection test OK.
  3. If any errors appear, verify that the Crestone connector is running and registered with the same Program ID, and confirm network/firewall settings permit the registration.

alt text

4) Configure SAP Gateway security​

  1. Access transaction SMGW.
  2. Navigate to Goto ▸ Expert Functions ▸ External Security ▸ Maintain ACL Files.

alt text

  1. In the secinfo file, add the standard entry that allows program CRESTONE_SERVER to start, specifying:
    • TP: CRESTONE_SERVER
    • HOST: the application server host name or * (per security policy)
    • USER: the SAP user permitted to start the program (often * for registered programs)

alt text

  1. In the reginfo file, add the standard entry that allows program CRESTONE_SERVER to register from the connector host, for example:
    • TP: CRESTONE_SERVER
    • HOST: connector host/IP
    • ACC: * (permitted users/clients)

alt text

Coordinate these ACL entries with your BASIS/security team; incorrect values can block gateway registrations or expose the gateway unnecessarily.

Verification​

  • The RFC destination appears under TCP/IP Connections with a green status icon.
  • Connection tests complete without errors.
  • Logs in transaction SM59 show successful registration/test timestamps.

Summary​

  1. Create a TCP/IP RFC destination in SM59 with connection type T.
  2. Set the destination name and Program ID to CRESTONE_SERVER (or your agreed identifier).
  3. Save and test the destination to confirm successful registration and connectivity.
  4. Configure SAP Gateway security
  5. Use of parallelism: additional RFC connections (slots) Each extraction performed by Crestone consumes one RFC connection. With only one connection configured (CRESTONE_SERVER), extractions can only be processed sequentially, one at a time. If parallel processing is to be enabled, additional RFC connections must be created in SM59, following the same procedure detailed in steps 2) Maintain the RFC Destination, 3) Test the Connection, and 4) Configure SAP Gateway Security, using EXACTLY the following destination names:
  • CRESTONE_SERVER_SLOT_01
  • CRESTONE_SERVER_SLOT_02
  • CRESTONE_SERVER_SLOT_03
  • CRESTONE_SERVER_SLOT_04
  • CRESTONE_SERVER_SLOT_05

Important:

These are the only slot names supported by the platform; Crestone recognizes a maximum of 5 slots, predefined with these exact names. No variants are supported (different names, different numbering, or a quantity greater than 5); any RFC connection created with a different name will not be recognized by Crestone as a valid parallelism slot. When configuring each slot, every reference to CRESTONE_SERVER must be replaced with the corresponding slot name, in all fields and steps where applicable. For example, if configuring CRESTONE_SERVER_SLOT_01:

  • RFC Destination (step 2): CRESTONE_SERVER_SLOT_01
  • Program ID (step 2): CRESTONE_SERVER_SLOT_01 (must match the ID configured in the Crestone connector for that slot)
  • secinfo file (step 4): TP: CRESTONE_SERVER_SLOT_01
  • reginfo file (step 4): TP: CRESTONE_SERVER_SLOT_01

The remaining technical parameters (connection type, activation type, gateway host/service, classical serialization, and conversion of outgoing bgRFC calls to outgoing qRFC calls) remain the same as in the CRESTONE_SERVER configuration.

info

the number of RFC connections created defines the maximum degree of parallelism available. For example, with 5 slots configured, Crestone will be able to run up to 5 simultaneous extractions; without additional connections, processing will be strictly sequential.

Platform-side activation: in addition to the SAP-side configuration, parallelism must be enabled from the Crestone configuration (Settings → Extraction → RFC Parallelism), where an option exists to turn this mode on or off. If parallelism is disabled, Crestone will use only the CRESTONE_SERVER connection sequentially, even if additional slots are configured in SAP.