Ansicht
Dokumentation

DTL_MT_DEFINE - Create mass transfer with initial MT_TABLES entries

DTL_MT_DEFINE - Create mass transfer with initial MT_TABLES entries

General Data in Customer Master   BAL_S_LOG - Application Log: Log header data  
This documentation is copyright by SAP AG.
SAP E-Book

Functionality

This API defines a mass transfer and creates entries in Table DMC_MT_TABLES for all conversion objects that should belong to this mass transfer. The mass transfer is assigned to a subproject which must have been created before.

One entry is created in table DMC_MT_HEADER.

For each conversion object to be created, one entry in table DMC_MT_TABLES is created with all flags set to false; block size, reading type, maximum number of data portions for access plan split, maximum number of parallel-running transfer processes for this conversion object, and write behavior are set either according to the specific value for the individual objects, or, if no specific data exist, according to the global function module input parameters serving as default.

The size category is always set individually for each object.

The Sequence number is either taken from the interface, or, if it is not supplied, set by default as follows:

60 for tables the name of which start with T

50 for all other tables.

Input parameters

  • IM_MT_ID
    mass transfer identifier. Required
  • IM_DESCRIPT
    Description of the mass transfer. Optional
  • IM_BLOCKSIZE
    Default blocksize for the data portions of the conversion objects. Optional (default 16777216 Bytes)
  • IM_SUBPROJECT
    subproject to which the mass transfer is to be assigned. Required.
  • IM_WRITE_BEHAVIOUR
    Default write behaviour. Optional (Default 1)
  • IM_PACKID
    PCL package ID.
  • IM_SESSION_ID
    PCL session ID.
  • I_READING_TYPE
    Default reading type. Optional
  • I_MAX_PORTION_ACPL
    Default maximum number of data portions per access plan (in order to control the access plan split). Optional
  • I_TABLE_MAX_PARALL
    Default maximum number of batch jobs for the data transfer that can run in parallel for one conversion object. Optional
  • I_OBJ_TYPE
    Scenario type that is used when creating the conversion objects. Optional

Tables parameter

  • IT_TABLES
    Conversion objects that should belong to this mass transfer

Return parameters

  • EX_LOGNUMBER
    Number of the application log that is created for this activity
  • EX_STATUS
    Structure containing status information such as a status (running, finished with errors / warnings; success), time stamps for start and end, etc

Possible error situations that are handled by this API (in each of these cases, processing is immediately canceled):

  • subproject does not exist
  • mass transfer already defined
  • Incorrect conversion object names (e.g. containing blanks)
  • inserts lead to duplicate key error in DMC_MT_TABLES

Example

Notes

Further information





Parameters

EX_LOGNUMBER
EX_STATUS
IM_BLOCKSIZE
IM_DESCRIPT
IM_MT_ID
IM_PACKID
IM_SESSION_ID
IM_SUBPROJECT
IM_WRITE_BEHAVIOUR
IT_TABLES
IV_MT_TYPE
I_MAX_PORTION_ACPL
I_OBJ_TYPE
I_READING_TYPE
I_TABLE_MAX_PARALL

Exceptions

Function Group

DMC_DTL

Addresses (Business Address Services)   Fill RESBD Structure from EBP Component Structure  
This documentation is copyright by SAP AG.

Length: 3857 Date: 20240523 Time: 114733     sap01-206 ( 56 ms )