GRMG_AGENT_CUSTOMIZING_PICKUP SAP Function module - Install new customizing automatically by way of agent

GRMG_AGENT_CUSTOMIZING_PICKUP 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 GRMG_AGENT_CUSTOMIZING_PICKUP into the relevant SAP transaction such as SE37 or SE80.

Associated Function Group: GRMG
Released Date: Not Released
Processing type: Normal fucntion module

Pattern for FM GRMG_AGENT_CUSTOMIZING_PICKUP - GRMG AGENT CUSTOMIZING PICKUP

CALL FUNCTION 'GRMG_AGENT_CUSTOMIZING_PICKUP' "Install new customizing automatically by way of agent
* EXPORTING
*   agent_destination =         " rfcdest        logische Destination (Wird bei Funktionsaufruf angegeben)
*   second_agent_destination =   " rfcdest      Destination für Doppelhopp zum Agenten am remoten System
*   agent_host =                " pfehostnam    Name eines Rechners.
*   agent_host_os =             " syopsys       Betriebssystem beim Agenten
*   directory =                 " text_512      Alert: monitoring type full name
*   file_specification =        " text_512      Alert: monitoring type full name
*   agent_type =                " csmagttype    CCMS CSM: Typ des CCMS Agenten
*   agent_ws_type =             " i
*   agent_status =              " flag          Ist Agent erreichbar?  X - Ja, Space - Nein
*   iv_kernel =                 " sykernrl      Kernel Release of remote system
*   iv_pathinifile =            " string        Path to sapccmsr.ini File
*   iv_instance_type =          " string        Type of instance in case of WS
  EXCEPTIONS
    INCOMPLETE_PARAMETERS = 1   "
    INTERNAL_ERROR = 2          "
    .  "  GRMG_AGENT_CUSTOMIZING_PICKUP

ABAP code example for Function Module GRMG_AGENT_CUSTOMIZING_PICKUP

The ABAP code below is a full code listing to execute function module GRMG_AGENT_CUSTOMIZING_PICKUP 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_agent_destination) = 'Check type of data required'.

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

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

DATA(ld_agent_host_os) = 'some text here'.

DATA(ld_directory) = 'some text here'.

DATA(ld_file_specification) = 'some text here'.

DATA(ld_agent_type) = 'some text here'.

DATA(ld_agent_ws_type) = 'some text here'.

DATA(ld_agent_status) = 'some text here'.

DATA(ld_iv_kernel) = 'some text here'.

DATA(ld_iv_pathinifile) = 'some text here'.

DATA(ld_iv_instance_type) = 'some text here'.
.

CALL FUNCTION 'GRMG_AGENT_CUSTOMIZING_PICKUP'
* EXPORTING
*   agent_destination =          ld_agent_destination
*   second_agent_destination =    ld_second_agent_destination
*   agent_host =                 ld_agent_host
*   agent_host_os =              ld_agent_host_os
*   directory =                  ld_directory
*   file_specification =         ld_file_specification
*   agent_type =                 ld_agent_type
*   agent_ws_type =              ld_agent_ws_type
*   agent_status =               ld_agent_status
*   iv_kernel =                  ld_iv_kernel
*   iv_pathinifile =             ld_iv_pathinifile
*   iv_instance_type =           ld_iv_instance_type
  EXCEPTIONS
    INCOMPLETE_PARAMETERS =      1
    INTERNAL_ERROR =             2
    .  "  GRMG_AGENT_CUSTOMIZING_PICKUP

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
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_agent_destination
 
 TYPE RFCDEST ,
ld_second_agent_destination
 
 TYPE RFCDEST ,
ld_agent_host
 
 TYPE PFEHOSTNAM ,
ld_agent_host_os
 
 TYPE SYOPSYS ,
ld_directory
 
 TYPE TEXT_512 ,
ld_file_specification
 
 TYPE TEXT_512 ,
ld_agent_type
 
 TYPE CSMAGTTYPE ,
ld_agent_ws_type
 
 TYPE I ,
ld_agent_status
 
 TYPE FLAG ,
ld_iv_kernel
 
 TYPE SYKERNRL ,
ld_iv_pathinifile
 
 TYPE STRING ,
ld_iv_instance_type
 
 TYPE STRING .


ld_agent_destination = 'some text here'.
ld_second_agent_destination = 'some text here'.
ld_agent_host = 'some text here'.
ld_agent_host_os = 'some text here'.
ld_directory = 'some text here'.
ld_file_specification = 'some text here'.
ld_agent_type = 'some text here'.
ld_agent_ws_type = 'some text here'.
ld_agent_status = 'some text here'.
ld_iv_kernel = 'some text here'.
ld_iv_pathinifile = 'some text here'.
ld_iv_instance_type = 'some text here'.