SAP TREX_EXT_PROCESS_INI_FILE Function Module for Get list of trace files for one TREX landscape









TREX_EXT_PROCESS_INI_FILE is a standard trex ext process ini file SAP function module available within SAP R/3 or S/4 Hana systems, depending on your version and release level. It is used for Get list of trace files for one TREX landscape processing and below is the pattern details for this FM, showing its interface including any import and export parameters, exceptions etc. there is also a full "cut and paste" ABAP pattern code example, along with implementation ABAP coding, documentation and contribution comments specific to this or related objects.


See here to view full function module documentation and code listing for trex ext process ini file FM, simply by entering the name TREX_EXT_PROCESS_INI_FILE into the relevant SAP transaction such as SE37 or SE38.

Function Group: TREX_EXT_TRACE
Program Name: SAPLTREX_EXT_TRACE
Main Program: SAPLTREX_EXT_TRACE
Appliation area:
Release date: N/A
Mode(Normal, Remote etc): Normal Function Module
Update:



Function TREX_EXT_PROCESS_INI_FILE pattern details

In-order to call this FM within your sap programs, simply using the below ABAP pattern details to trigger the function call...or see the full ABAP code listing at the end of this article. You can simply cut and paste this code into your ABAP progrom as it is, including variable declarations.
CALL FUNCTION 'TREX_EXT_PROCESS_INI_FILE'"Get list of trace files for one TREX landscape
EXPORTING
I_RFC_DESTINATION = "RFC destination to TREX engine
I_FILE_NAME = "File name pattern
* I_LAYER = 'H' "Layer
* I_TENANT = "Tenant
* I_HOST = "Host
* I_ACTION = '1' "1:readFile 2:writeFile 3:delete 4:check 5:saveToAllHost 6:saveToAll+Reconfi
* I_LINES = "Long lines

IMPORTING
E_RETURN_CODE = "Return code
E_RETURN_TEXT = "Return text
E_LINES = "Content of the file
E_FILE_SIZE = "File size
E_RECONFIG = "saveToAllHosts: 1:reconfig possible
E_SUSPECT_LINES = "saveToAllHosts: suspected lines of saveToAllHots (ini file)
E_ERROR_LIST = "saveToAllHosts: list of errors of each host

EXCEPTIONS
CONVERSION_ERROR = 1 ERROR = 2 NO_AUTHORIZATION = 3
.



IMPORTING Parameters details for TREX_EXT_PROCESS_INI_FILE

I_RFC_DESTINATION - RFC destination to TREX engine

Data type: TREX_RFC-RFC_DESTINATION
Optional: No
Call by Reference: Yes

I_FILE_NAME - File name pattern

Data type: TREXS_FILE-FILE_NAME
Optional: No
Call by Reference: Yes

I_LAYER - Layer

Data type: CHAR1
Default: 'H'
Optional: Yes
Call by Reference: Yes

I_TENANT - Tenant

Data type: SY-MANDT
Optional: Yes
Call by Reference: Yes

I_HOST - Host

Data type: TREXS_FILE-HOST
Optional: Yes
Call by Reference: Yes

I_ACTION - 1:readFile 2:writeFile 3:delete 4:check 5:saveToAllHost 6:saveToAll+Reconfi

Data type: TREX_RFC-FLAG
Default: '1'
Optional: No
Call by Reference: Yes

I_LINES - Long lines

Data type: TREXT_STRINGS
Optional: Yes
Call by Reference: Yes

EXPORTING Parameters details for TREX_EXT_PROCESS_INI_FILE

E_RETURN_CODE - Return code

Data type: TREX_RFC-RETURN_CODE
Optional: No
Call by Reference: Yes

E_RETURN_TEXT - Return text

Data type: TREX_RFC-RETURN_TEXT
Optional: No
Call by Reference: Yes

E_LINES - Content of the file

Data type: TREXT_STRINGS
Optional: No
Call by Reference: Yes

E_FILE_SIZE - File size

Data type: TREXS_FILE-SIZE
Optional: No
Call by Reference: Yes

E_RECONFIG - saveToAllHosts: 1:reconfig possible

Data type: TREX_RFC-BOOLEAN
Optional: No
Call by Reference: Yes

E_SUSPECT_LINES - saveToAllHosts: suspected lines of saveToAllHots (ini file)

Data type: TREXT_SUSPECT_LINES
Optional: No
Call by Reference: Yes

E_ERROR_LIST - saveToAllHosts: list of errors of each host

Data type: TREXT_ERROR_LIST
Optional: No
Call by Reference: Yes

EXCEPTIONS details

CONVERSION_ERROR - Error during conversion to UTF-8

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

ERROR - Error, see error message

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

NO_AUTHORIZATION -

Data type:
Optional: No
Call by Reference: Yes

Copy and paste ABAP code example for TREX_EXT_PROCESS_INI_FILE Function Module

The ABAP code below is a full code listing to execute function module POPUP_TO_CONFIRM including all data declarations. The code uses the original data declarations rather than 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 newer method of declaring data variables on the fly. 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), which i why i have stuck to the origianl for this example.

DATA:
lv_e_return_code  TYPE TREX_RFC-RETURN_CODE, "   
lv_conversion_error  TYPE TREX_RFC, "   
lv_i_rfc_destination  TYPE TREX_RFC-RFC_DESTINATION, "   
lv_error  TYPE TREX_RFC, "   
lv_i_file_name  TYPE TREXS_FILE-FILE_NAME, "   
lv_e_return_text  TYPE TREX_RFC-RETURN_TEXT, "   
lv_e_lines  TYPE TREXT_STRINGS, "   
lv_i_layer  TYPE CHAR1, "   'H'
lv_no_authorization  TYPE CHAR1, "   
lv_i_tenant  TYPE SY-MANDT, "   
lv_e_file_size  TYPE TREXS_FILE-SIZE, "   
lv_i_host  TYPE TREXS_FILE-HOST, "   
lv_e_reconfig  TYPE TREX_RFC-BOOLEAN, "   
lv_i_action  TYPE TREX_RFC-FLAG, "   '1'
lv_e_suspect_lines  TYPE TREXT_SUSPECT_LINES, "   
lv_i_lines  TYPE TREXT_STRINGS, "   
lv_e_error_list  TYPE TREXT_ERROR_LIST. "   

  CALL FUNCTION 'TREX_EXT_PROCESS_INI_FILE'  "Get list of trace files for one TREX landscape
    EXPORTING
         I_RFC_DESTINATION = lv_i_rfc_destination
         I_FILE_NAME = lv_i_file_name
         I_LAYER = lv_i_layer
         I_TENANT = lv_i_tenant
         I_HOST = lv_i_host
         I_ACTION = lv_i_action
         I_LINES = lv_i_lines
    IMPORTING
         E_RETURN_CODE = lv_e_return_code
         E_RETURN_TEXT = lv_e_return_text
         E_LINES = lv_e_lines
         E_FILE_SIZE = lv_e_file_size
         E_RECONFIG = lv_e_reconfig
         E_SUSPECT_LINES = lv_e_suspect_lines
         E_ERROR_LIST = lv_e_error_list
    EXCEPTIONS
        CONVERSION_ERROR = 1
        ERROR = 2
        NO_AUTHORIZATION = 3
. " TREX_EXT_PROCESS_INI_FILE




ABAP code using 7.40 inline data declarations to call FM TREX_EXT_PROCESS_INI_FILE

The below ABAP code uses the newer in-line data declarations. This allows you to see the coding differences/benefits of the later inline syntax. Please note some of the newer syntax below, such as the @DATA is not available until 4.70 EHP 8.

"SELECT single RETURN_CODE FROM TREX_RFC INTO @DATA(ld_e_return_code).
 
 
"SELECT single RFC_DESTINATION FROM TREX_RFC INTO @DATA(ld_i_rfc_destination).
 
 
"SELECT single FILE_NAME FROM TREXS_FILE INTO @DATA(ld_i_file_name).
 
"SELECT single RETURN_TEXT FROM TREX_RFC INTO @DATA(ld_e_return_text).
 
 
DATA(ld_i_layer) = 'H'.
 
 
"SELECT single MANDT FROM SY INTO @DATA(ld_i_tenant).
 
"SELECT single SIZE FROM TREXS_FILE INTO @DATA(ld_e_file_size).
 
"SELECT single HOST FROM TREXS_FILE INTO @DATA(ld_i_host).
 
"SELECT single BOOLEAN FROM TREX_RFC INTO @DATA(ld_e_reconfig).
 
"SELECT single FLAG FROM TREX_RFC INTO @DATA(ld_i_action).
DATA(ld_i_action) = '1'.
 
 
 
 


Search for further information about these or an SAP related objects



Comments on this SAP object

What made you want to lookup this SAP object? Please tell us what you were looking for and anything you would like to be included on this page!