DX_ATTRIB_SPLIT_CHANGE SAP Function module

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

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

Pattern for FM DX_ATTRIB_SPLIT_CHANGE - DX ATTRIB SPLIT CHANGE

CALL FUNCTION 'DX_ATTRIB_SPLIT_CHANGE' "
  EXPORTING
    project =                   " dxattrib3-project  Data Transfer Project
    subproject =                " dxattrib3-subproject  Data Transfer Subproject
    rundef =                    " dxattrib3-rundef  Data Transfer - Run Definition
    task =                      " dxattrib3-task  Data transfer task
*   progtype =                  " dxattrib3-progtype  Program Type
*   progname =                  " dxattrib3-progname  Data transfer program/method
*   splittype =                 " dxattrib3-splittype  Way Source File Is To Be Split
*   objectno =                  " dxattrib3-objectno  Number of Objects per File
*   linesno =                   " dxattrib3-linesno  Number of Lines per File
*   delsource =                 " dxattrib3-delsource  Delete Source File After Split
*   deltarget =                 " dxattrib3-deltarget  Delete Potential Target Files Before Split
*   dialog = 'X'                " dxfields-dialog
  IMPORTING
    attribdata =                " dxattrib3     Task Attributes
* TABLES
*   input_files =               " dxfilelp      Files: Physical File Name (Transfer Structure)
*   output_files =              " dxfilelp      Files: Name & Type & Storage Data (like LSMW)
  EXCEPTIONS
    TASK_DOES_NOT_EXIST = 1     "
    ERROR_IN_PARAMETERS = 2     "
    RUNS_ALREADY_EXIST = 3      "
    TYPE_DOES_NOT_EXIST = 4     "
    SUBPROJECT_LOCKED = 5       "
    CANCELED_BY_USER = 6        "
    DB_ERROR = 7                "
    NO_AUTHORITY = 8            "
    .  "  DX_ATTRIB_SPLIT_CHANGE

ABAP code example for Function Module DX_ATTRIB_SPLIT_CHANGE

The ABAP code below is a full code listing to execute function module DX_ATTRIB_SPLIT_CHANGE 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_attribdata  
 
 TYPE DXATTRIB3
,
it_input_files  
 
 TYPE STANDARD TABLE OF DXFILELP,"TABLES PARAM
wa_input_files
 
 LIKE LINE OF it_input_files
,
it_output_files  
 
 TYPE STANDARD TABLE OF DXFILELP,"TABLES PARAM
wa_output_files
 
 LIKE LINE OF it_output_files
.

 

SELECT single PROJECT 
  FROM DXATTRIB3 
  INTO @DATA(ld_project).

 

SELECT single SUBPROJECT 
  FROM DXATTRIB3 
  INTO @DATA(ld_subproject).

 

SELECT single RUNDEF 
  FROM DXATTRIB3 
  INTO @DATA(ld_rundef).

 

SELECT single TASK 
  FROM DXATTRIB3 
  INTO @DATA(ld_task).

 

SELECT single PROGTYPE 
  FROM DXATTRIB3 
  INTO @DATA(ld_progtype).

 

SELECT single PROGNAME 
  FROM DXATTRIB3 
  INTO @DATA(ld_progname).

 

SELECT single SPLITTYPE 
  FROM DXATTRIB3 
  INTO @DATA(ld_splittype).

 

SELECT single OBJECTNO 
  FROM DXATTRIB3 
  INTO @DATA(ld_objectno).

 

SELECT single LINESNO 
  FROM DXATTRIB3 
  INTO @DATA(ld_linesno).

 

SELECT single DELSOURCE 
  FROM DXATTRIB3 
  INTO @DATA(ld_delsource).

 

SELECT single DELTARGET 
  FROM DXATTRIB3 
  INTO @DATA(ld_deltarget).



DATA(ld_dialog) = some text here
 

"populate fields of struture and append to itab
append wa_input_files to it_input_files.
 

"populate fields of struture and append to itab
append wa_output_files to it_output_files.
.

CALL FUNCTION 'DX_ATTRIB_SPLIT_CHANGE'
  EXPORTING
    project =                    ld_project
    subproject =                 ld_subproject
    rundef =                     ld_rundef
    task =                       ld_task
*   progtype =                   ld_progtype
*   progname =                   ld_progname
*   splittype =                  ld_splittype
*   objectno =                   ld_objectno
*   linesno =                    ld_linesno
*   delsource =                  ld_delsource
*   deltarget =                  ld_deltarget
*   dialog =                     ld_dialog
  IMPORTING
    attribdata =                 ld_attribdata
* TABLES
*   input_files =                it_input_files
*   output_files =               it_output_files
  EXCEPTIONS
    TASK_DOES_NOT_EXIST =        1
    ERROR_IN_PARAMETERS =        2
    RUNS_ALREADY_EXIST =         3
    TYPE_DOES_NOT_EXIST =        4
    SUBPROJECT_LOCKED =          5
    CANCELED_BY_USER =           6
    DB_ERROR =                   7
    NO_AUTHORITY =               8
    .  "  DX_ATTRIB_SPLIT_CHANGE

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
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_attribdata
 
 TYPE DXATTRIB3 ,
ld_project
 
 TYPE DXATTRIB3-PROJECT ,
it_input_files
 
 TYPE STANDARD TABLE OF DXFILELP ,
wa_input_files
 
 LIKE LINE OF it_input_files,
ld_subproject
 
 TYPE DXATTRIB3-SUBPROJECT ,
it_output_files
 
 TYPE STANDARD TABLE OF DXFILELP ,
wa_output_files
 
 LIKE LINE OF it_output_files,
ld_rundef
 
 TYPE DXATTRIB3-RUNDEF ,
ld_task
 
 TYPE DXATTRIB3-TASK ,
ld_progtype
 
 TYPE DXATTRIB3-PROGTYPE ,
ld_progname
 
 TYPE DXATTRIB3-PROGNAME ,
ld_splittype
 
 TYPE DXATTRIB3-SPLITTYPE ,
ld_objectno
 
 TYPE DXATTRIB3-OBJECTNO ,
ld_linesno
 
 TYPE DXATTRIB3-LINESNO ,
ld_delsource
 
 TYPE DXATTRIB3-DELSOURCE ,
ld_deltarget
 
 TYPE DXATTRIB3-DELTARGET ,
ld_dialog
 
 TYPE DXFIELDS-DIALOG .



SELECT single PROJECT 
  FROM DXATTRIB3 
  INTO ld_project.
 

"populate fields of struture and append to itab
append wa_input_files to it_input_files.

SELECT single SUBPROJECT 
  FROM DXATTRIB3 
  INTO ld_subproject.
 

"populate fields of struture and append to itab
append wa_output_files to it_output_files.

SELECT single RUNDEF 
  FROM DXATTRIB3 
  INTO ld_rundef.


SELECT single TASK 
  FROM DXATTRIB3 
  INTO ld_task.


SELECT single PROGTYPE 
  FROM DXATTRIB3 
  INTO ld_progtype.


SELECT single PROGNAME 
  FROM DXATTRIB3 
  INTO ld_progname.


SELECT single SPLITTYPE 
  FROM DXATTRIB3 
  INTO ld_splittype.


SELECT single OBJECTNO 
  FROM DXATTRIB3 
  INTO ld_objectno.


SELECT single LINESNO 
  FROM DXATTRIB3 
  INTO ld_linesno.


SELECT single DELSOURCE 
  FROM DXATTRIB3 
  INTO ld_delsource.


SELECT single DELTARGET 
  FROM DXATTRIB3 
  INTO ld_deltarget.


ld_dialog = some text here