SAP Function Modules

comments icon Comments

RSAR_UPDATE_DESTINATION SAP Function module - Updating an RFC destination of type R/3







RSAR_UPDATE_DESTINATION is a standard SAP function module available within R/3 SAP systems depending on your version and release level. Below is the pattern details for this FM showing its interface including any import and export parameters, exceptions etc as well as any documentation contributions (Comments) specific to the object.

See here to view full function module documentation and code listing, simply by entering the name RSAR_UPDATE_DESTINATION into the relevant SAP transaction such as SE37 or SE80.

Associated Function Group: RSACTC
Released Date: Not Released
Processing type: Normal fucntion module
Normal function module settings


Pattern for FM RSAR_UPDATE_DESTINATION - RSAR UPDATE DESTINATION 





CALL FUNCTION 'RSAR_UPDATE_DESTINATION' "Updating an RFC destination of type R/3
  EXPORTING
    destination =               " rfcdisplay-rfcdest  Destination for RFC use
*   authority_check = 'X'       " rfcdisplay-rfctrace  SM59 AUTHORITY_CHECK active ?
*   loadbalancing = SPACE       " rfcdisplaz-rfclbflag  Load balancing mode
*   systemid = SPACE            " rfcopt-rfcsysid  System identifier
*   systemnr = SPACE            " rfcdisplay-rfcservice  System Number
*   server = SPACE              " rfcdisplay-rfchost  Server (message server or application server)
*   group = 'SPACE'             " rfcdisplaz-rfcload  Group name for load balancing mode
*   trace = SPACE               " rfcdisplay-rfctrace  Trace functionality
*   trusted_system = SPACE      " rfcdisplay-rfcslogin
*   rfclogon_gui = SPACE        " rfcdisplay-rfclogon
*   language = SPACE            " rfcdisplay-rfclang  Language for maintaining logon data
*   client = SPACE              " rfcdisplay-rfcclient  Client for maintenance of logon data
*   user = SPACE                " rfcdisplay-rfcuser  User for maintaining logon data
*   same_user = SPACE           " rfcdisplay-rfcsameusr
*   password = SPACE            " rfcdisplay-rfcauth  Password for maintaining logon data
*   keep_password = SPACE       " char1         Single-Character Indicator
*   passwordscr = 'X'           " rfcdisplay-rfcpwscr  Passwort encryption active
*   description = SPACE         " rfcdoc-rfcdoc1  Destination Description
*   gwhost = SPACE              " rfcdisplay-rfcgwhost  Gateway Host
*   gwservice = SPACE           " rfcdisplay-rfcgwserv  Gateway Service
*   trfcbtcsuppr = SPACE        " rfcdisplay-btcsuppr  Background suppress for transactional RFC (TRFC)
*   trfcbtctries = SPACE        " rfcdisplay-btctries  Background repetitions for transactional RFC
*   trfcbtcdelay = SPACE        " rfcdisplay-btcdelay  Background delays for transactional RFC
*   destlock = SPACE            " rfcdisplay-rfclock  Display of destination not modifiable
*   dequeue_synchron = SPACE    " rfcdisplay-rfcnowait
*   arfc_active = SPACE         " rfccheck-arfcactive
*   arfc_method = 'S'           " rfccheck-arfcmethod
*   arfc_cycle = '10'           " rfccheck-arfccycle
*   snc_param =                 " rfcsncpara    Transfer Structure for SNC Extension of RFC Destinations
*   rfcconvert = SPACE          " rfcdisplay-rfcconvert  Conversion with incompatible code page? (SPACE, 'I', 'N')
*   rfcconvx = '0023'           " rfcraw02      Conversion sign as Unicode point in hex (if RFCCONV = 'I')
*   rfcunicode = '1'            " rfcdisplay-rfcunicode  Unicode System?
*   rfcbitmap = '00000000'      " rfcraw04      Bitmap for Variable Options in RFCOPT
*   savehostname = SPACE        " rfcdisplay-saveserver  Save target host as hostname?
*   rfcwan = SPACE              " rfcdisplay-rfcwan  'X' -> Slow RFC Connection (in WAN)
*   mdmpsetting = 'N'           " char1         'N' for inactive and 'Y' for active MDMP settings
*   mdmplist = SPACE            " rfcdisplay-rfcrest  List of MDMP code pages. Please add $ after each code page
*   authority = SPACE           " destauth      Authorization
*   qrfcvers = '0'              " qrfcchar      qRFC-Version; 0 classic; 1 Netweaver
*   exporttrace = '2'           " rfcdisplay-tracepropagation  GW-default value = '2 '; export Trace = '1'; no export Trace = '0 '
*   keepalivetimeoutval = '-2'  " keep_timeout_val  Keepalive-timeout value
  EXCEPTIONS
    AUTHORITY_NOT_AVAILABLE = 1  "              You do not have this authorization
    DESTINATION_ALREADY_EXIST = 2  "            Destination already exists
    DESTINATION_NOT_EXIST = 3   "               Destination does not Exist
    DESTINATION_ENQUEUE_REJECT = 4  "           Destination is locked by another user
    INFORMATION_FAILURE = 5     "               Parameters (information) not maintained correctly
    TRFC_ENTRY_INVALID = 6      "               Inconsistent parameter maintenance for TRFC options
    INTERNAL_FAILURE = 7        "               Internal error
    SNC_INFORMATION_FAILURE = 8  "              SNC information error
    SNC_INTERNAL_FAILURE = 9    "               SNC: Internal error
    DESTINATION_IS_LOCKED = 10  "               Destination is locked
    .  "  RSAR_UPDATE_DESTINATION

ABAP code example for Function Module RSAR_UPDATE_DESTINATION





The ABAP code below is a full code listing to execute function module RSAR_UPDATE_DESTINATION including all data declarations. The code uses the latest in-line data DECLARATION SYNTAX but I have included an ABAP code snippet at the end to show how declarations would look using the original method of declaring data variables up front. This will allow you to compare and fully understand the new inline method. Please note some of the newer syntax such as the @DATA is not available until a later 4.70 service pack (SP8).



DATA(ld_destination) = some text here


DATA(ld_authority_check) = some text here


DATA(ld_loadbalancing) = some text here


DATA(ld_systemid) = some text here


DATA(ld_systemnr) = some text here


DATA(ld_server) = some text here


DATA(ld_group) = some text here


DATA(ld_trace) = some text here


DATA(ld_trusted_system) = some text here


DATA(ld_rfclogon_gui) = some text here


DATA(ld_language) = Check type of data required


DATA(ld_client) = Check type of data required


DATA(ld_user) = some text here


DATA(ld_same_user) = some text here


DATA(ld_password) = some text here

DATA(ld_keep_password) = 'Check type of data required'.


DATA(ld_passwordscr) = some text here
 

SELECT single RFCDOC1 
  FROM RFCDOC 
  INTO @DATA(ld_description).



DATA(ld_gwhost) = some text here


DATA(ld_gwservice) = some text here


DATA(ld_trfcbtcsuppr) = some text here


DATA(ld_trfcbtctries) = some text here


DATA(ld_trfcbtcdelay) = some text here


DATA(ld_destlock) = some text here


DATA(ld_dequeue_synchron) = some text here
 

SELECT single ARFCACTIVE 
  FROM RFCCHECK 
  INTO @DATA(ld_arfc_active).

 

SELECT single ARFCMETHOD 
  FROM RFCCHECK 
  INTO @DATA(ld_arfc_method).

 

SELECT single ARFCCYCLE 
  FROM RFCCHECK 
  INTO @DATA(ld_arfc_cycle).


DATA(ld_snc_param) = 'Check type of data required'.


DATA(ld_rfcconvert) = some text here

DATA(ld_rfcconvx) = 'Check type of data required'.


DATA(ld_rfcunicode) = Check type of data required

DATA(ld_rfcbitmap) = 'Check type of data required'.


DATA(ld_savehostname) = some text here


DATA(ld_rfcwan) = some text here

DATA(ld_mdmpsetting) = 'Check type of data required'.


DATA(ld_mdmplist) = some text here

DATA(ld_authority) = 'Check type of data required'.

DATA(ld_qrfcvers) = 'Check type of data required'.


DATA(ld_exporttrace) = some text here

DATA(ld_keepalivetimeoutval) = 'Check type of data required'.
.

CALL FUNCTION 'RSAR_UPDATE_DESTINATION'
  EXPORTING
    destination =                ld_destination
*   authority_check =            ld_authority_check
*   loadbalancing =              ld_loadbalancing
*   systemid =                   ld_systemid
*   systemnr =                   ld_systemnr
*   server =                     ld_server
*   group =                      ld_group
*   trace =                      ld_trace
*   trusted_system =             ld_trusted_system
*   rfclogon_gui =               ld_rfclogon_gui
*   language =                   ld_language
*   client =                     ld_client
*   user =                       ld_user
*   same_user =                  ld_same_user
*   password =                   ld_password
*   keep_password =              ld_keep_password
*   passwordscr =                ld_passwordscr
*   description =                ld_description
*   gwhost =                     ld_gwhost
*   gwservice =                  ld_gwservice
*   trfcbtcsuppr =               ld_trfcbtcsuppr
*   trfcbtctries =               ld_trfcbtctries
*   trfcbtcdelay =               ld_trfcbtcdelay
*   destlock =                   ld_destlock
*   dequeue_synchron =           ld_dequeue_synchron
*   arfc_active =                ld_arfc_active
*   arfc_method =                ld_arfc_method
*   arfc_cycle =                 ld_arfc_cycle
*   snc_param =                  ld_snc_param
*   rfcconvert =                 ld_rfcconvert
*   rfcconvx =                   ld_rfcconvx
*   rfcunicode =                 ld_rfcunicode
*   rfcbitmap =                  ld_rfcbitmap
*   savehostname =               ld_savehostname
*   rfcwan =                     ld_rfcwan
*   mdmpsetting =                ld_mdmpsetting
*   mdmplist =                   ld_mdmplist
*   authority =                  ld_authority
*   qrfcvers =                   ld_qrfcvers
*   exporttrace =                ld_exporttrace
*   keepalivetimeoutval =        ld_keepalivetimeoutval
  EXCEPTIONS
    AUTHORITY_NOT_AVAILABLE =    1
    DESTINATION_ALREADY_EXIST =    2
    DESTINATION_NOT_EXIST =      3
    DESTINATION_ENQUEUE_REJECT =    4
    INFORMATION_FAILURE =        5
    TRFC_ENTRY_INVALID =         6
    INTERNAL_FAILURE =           7
    SNC_INFORMATION_FAILURE =    8
    SNC_INTERNAL_FAILURE =       9
    DESTINATION_IS_LOCKED =      10
    .  "  RSAR_UPDATE_DESTINATION

IF SY-SUBRC EQ 0.
  "All OK
ELSEIF SY-SUBRC EQ 1. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 2. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 3. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 4. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 5. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 6. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 7. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 8. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 9. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 10. "Exception
  "Add code for exception here
ENDIF.







ABAP code to compare 7.40 inline data declaration with original syntax

The below ABAP code uses the older none in-line data declarations. This allows you to see the coding differences/benefits of the later inline syntax. It may also be useful if you are using an older version of SAP as some of the newer syntax above, such as the @DATA is not available until 4.70 EHP 8.

DATA:


ld_destination  TYPE RFCDISPLAY-RFCDEST ,
ld_authority_check  TYPE RFCDISPLAY-RFCTRACE ,
ld_loadbalancing  TYPE RFCDISPLAZ-RFCLBFLAG ,
ld_systemid  TYPE RFCOPT-RFCSYSID ,
ld_systemnr  TYPE RFCDISPLAY-RFCSERVICE ,
ld_server  TYPE RFCDISPLAY-RFCHOST ,
ld_group  TYPE RFCDISPLAZ-RFCLOAD ,
ld_trace  TYPE RFCDISPLAY-RFCTRACE ,
ld_trusted_system  TYPE RFCDISPLAY-RFCSLOGIN ,
ld_rfclogon_gui  TYPE RFCDISPLAY-RFCLOGON ,
ld_language  TYPE RFCDISPLAY-RFCLANG ,
ld_client  TYPE RFCDISPLAY-RFCCLIENT ,
ld_user  TYPE RFCDISPLAY-RFCUSER ,
ld_same_user  TYPE RFCDISPLAY-RFCSAMEUSR ,
ld_password  TYPE RFCDISPLAY-RFCAUTH ,
ld_keep_password  TYPE CHAR1 ,
ld_passwordscr  TYPE RFCDISPLAY-RFCPWSCR ,
ld_description  TYPE RFCDOC-RFCDOC1 ,
ld_gwhost  TYPE RFCDISPLAY-RFCGWHOST ,
ld_gwservice  TYPE RFCDISPLAY-RFCGWSERV ,
ld_trfcbtcsuppr  TYPE RFCDISPLAY-BTCSUPPR ,
ld_trfcbtctries  TYPE RFCDISPLAY-BTCTRIES ,
ld_trfcbtcdelay  TYPE RFCDISPLAY-BTCDELAY ,
ld_destlock  TYPE RFCDISPLAY-RFCLOCK ,
ld_dequeue_synchron  TYPE RFCDISPLAY-RFCNOWAIT ,
ld_arfc_active  TYPE RFCCHECK-ARFCACTIVE ,
ld_arfc_method  TYPE RFCCHECK-ARFCMETHOD ,
ld_arfc_cycle  TYPE RFCCHECK-ARFCCYCLE ,
ld_snc_param  TYPE RFCSNCPARA ,
ld_rfcconvert  TYPE RFCDISPLAY-RFCCONVERT ,
ld_rfcconvx  TYPE RFCRAW02 ,
ld_rfcunicode  TYPE RFCDISPLAY-RFCUNICODE ,
ld_rfcbitmap  TYPE RFCRAW04 ,
ld_savehostname  TYPE RFCDISPLAY-SAVESERVER ,
ld_rfcwan  TYPE RFCDISPLAY-RFCWAN ,
ld_mdmpsetting  TYPE CHAR1 ,
ld_mdmplist  TYPE RFCDISPLAY-RFCREST ,
ld_authority  TYPE DESTAUTH ,
ld_qrfcvers  TYPE QRFCCHAR ,
ld_exporttrace  TYPE RFCDISPLAY-TRACEPROPAGATION ,
ld_keepalivetimeoutval  TYPE KEEP_TIMEOUT_VAL .





ld_destination = some text here

ld_authority_check = some text here

ld_loadbalancing = some text here

ld_systemid = some text here

ld_systemnr = some text here

ld_server = some text here

ld_group = some text here

ld_trace = some text here

ld_trusted_system = some text here

ld_rfclogon_gui = some text here

ld_language = Check type of data required

ld_client = Check type of data required

ld_user = some text here

ld_same_user = some text here

ld_password = some text here
ld_keep_password = 'Check type of data required'.

ld_passwordscr = some text here

SELECT single RFCDOC1 
  FROM RFCDOC 
  INTO ld_description.


ld_gwhost = some text here

ld_gwservice = some text here

ld_trfcbtcsuppr = some text here

ld_trfcbtctries = some text here

ld_trfcbtcdelay = some text here

ld_destlock = some text here

ld_dequeue_synchron = some text here

SELECT single ARFCACTIVE 
  FROM RFCCHECK 
  INTO ld_arfc_active.


SELECT single ARFCMETHOD 
  FROM RFCCHECK 
  INTO ld_arfc_method.


SELECT single ARFCCYCLE 
  FROM RFCCHECK 
  INTO ld_arfc_cycle.

ld_snc_param = 'Check type of data required'.

ld_rfcconvert = some text here
ld_rfcconvx = 'Check type of data required'.

ld_rfcunicode = Check type of data required
ld_rfcbitmap = 'Check type of data required'.

ld_savehostname = some text here

ld_rfcwan = some text here
ld_mdmpsetting = 'Check type of data required'.

ld_mdmplist = some text here
ld_authority = 'Check type of data required'.
ld_qrfcvers = 'Check type of data required'.

ld_exporttrace = some text here
ld_keepalivetimeoutval = 'Check type of data required'.

Contribute (Add Comments)

Please help keep this info upto date and use the comments section below to add useful hints, tips and information specific to this SAP function. This will then be available for you and other users to easily find by simply searching on the object name RSAR_UPDATE_DESTINATION or its description.


   
 

RSAR_UPDATE_DESTINATION - Updating an RFC destination of type R/3
RSAR_UPDATE_CONTROL - Controls the saving of received IDOCS in the database
RSAR_UPDATE_BWMANDTRFC_HOST - Change Host in the RFC destination (TP) BWMANDTRFC
RSAR_UPDATE_ALE_PORT - Enter New Destination in ALE Port for BW-Connection
RSAR_UNASSIGNED_OLTPSOURCE_F4 - F4 help with all unallocated data sources
RSAR_TR_HTML_DOKU_GENERATE - Production of an HTML docu that describes the transfer rules