Chapter 05_ Batch Input Session

IBM Global Business Services

© IBM Corporation 2013Data Interfaces | Dec-2008

Batch Input Session


© IBM Corporation 20132 Dec-2008Data Interfaces |

Objectives

The participants will be able to: Create the Batch Input part of an Inbound Interface.

Describe the Batch Input Session Method for Batch Input.



Overview

SAPSAPDatabaseDatabase

TableTable

BatchInput

Session

BDCProgram

ExternalData

The first batch input method is to create a batch input session. It is the processing of this batch input

session that updates the database, not the execution of the batch input program.



Creating Batch Input Sessions

“BDC_INSERT” is called for each

transaction entered into the

batch input session.

Open Batch Input SessionOpen Batch Input Session

Close Batch Input SessionClose Batch Input Session

Insert Transaction Data into Session

BDC_OPEN_GROUP

BDC_INSERT

BDC_CLOSE_GROUP



BDC_OPEN_GROUP

CALL FUNCTION ‘BDC_OPEN_GROUP’

EXPORTING

CLIENT = <client>

GROUP = <session name>

HOLDDATE = <lock session until date>

KEEP= <keep or delete session>

USER= <user name>

EXCEPTIONS

CLIENT_INVALID = 1

. . .

OTHERS = 11.

SY-SUBRCCHECK



BDC_INSERT

CALL FUNCTION ‘BDC_INSERT’

EXPORTING

TCODE = <transaction code>

POST_LOCAL = <local update>

TABLES

DYNPROTAB = <bdc internal table>

EXCEPTIONS

INTERNAL_ERROR = 1

. . .

OTHERS = 5.

SY-SUBRCCHECK



BDC_INSERT (Contd.)

CALL FUNCTION ‘BDC_INSERT’

EXPORTING

TCODE = <transaction code>

POST_LOCAL = <local update>

TABLES

DYNPROTAB = <bdc internal table>

EXCEPTIONS

INTERNAL_ERROR = 1

. . .

OTHERS = 5.

SY-SUBRCCHECK



BDC_CLOSE_GROUP

CALL FUNCTION ‘BDC_CLOSE_GROUP’

EXCEPTIONS

NOT_OPEN = 1

QUEUE_ERROR = 2

OTHERS = 3.SY-SUBRC

CHECK



Batch Input Session - Structure

BatchInput

Session

Data Section

Transaction Data

Header Section

Creator

Client

Session Name

Authorization User

Hold Date

Keep or Delete



Example #1 - Change Vendor

Vendor

Company Code

ABAPXX-002

AddressX

Name

Street

Computers, Inc.

Buyer, Inc.1

City Philadelphia

In this example, we will create a batch input session to add a street

address to an already existing vendor (TEST1).

The “Change Vendor” transaction is “FK02”.



Example #1 - Declaration Section

REPORT YDIXX5_2.

DATA: BDC_TAB TYPE STANDARD TABLE OF BDCDATA INITIAL SIZE 6 WITH HEADER LINE,

WA_BDC_TAB TYPE BDCDATA,

SESSION TYPE APQ_GRPNVALUE 'DEMO#8'.

Step #1

** This program is continued on the next slide **



Example #1 - Main Program

START-OF-SELECTION.CALL FUNCTION ‘BDC_OPEN_GROUP’

EXPORTINGCLIENT = SY-MANDTGROUP = SESSIONUSER = SY-UNAME

EXCEPTIONS. . . .PERFORM FILL_BDC_TAB.CALL FUNCTION ‘BDC_INSERT’

EXPORTINGTCODE = ‘FK02’

TABLESDYNPROTAB = BDC_TAB

EXCEPTIONS. . . .CALL FUNCTION ‘BDC_CLOSE_GROUP’

EXCEPTIONS. . . .

Step #2

Step #3

Step #4

Step #5




Example #1 - Subroutines

FORM FILL_BDC_TAB.

REFRESH BDC_TAB.

PERFORM POPULATE_BDC_TABUSING:

‘1’‘SAPMF02K’ ‘0106’,‘ ’‘RF02K-LIFNR’ ‘ABAPXX-002’,‘ ’‘RF02K-D0110’ ‘X’,

‘1’‘SAPMF02K’ ‘0110’,‘ ’‘LFA1-STRAS’ ‘Buyer, Inc.1’,‘ ’‘BDC_OKCODE’ ‘=UPDA’.

ENDFORM.

FORM POPULATE_BDC_TAB USINGFLAG TYPE C

VAR1 TYPE C VAR2 TYPE C.

CLEAR WA_BDC_TAB.IF FLAG = ‘1’.

WA_BDC_TAB-PROGRAM = VAR1. WA_ BDC_TAB-DYNPRO= VAR2.

WA_BDC_TAB-DYNBEGIN= ‘X’.ELSE.

WA_BDC_TAB-FNAM = VAR1.WA_BDC_TAB-FVAL = VAR2.

ENDIF.

APPEND WA_BDC_TAB TO BDC_TAB.

ENDFORM.



Example #2 - Change Vendors

Vendor

Company Code

TEST1

AddressX

Name

Street

Computers, Inc.

123 Main St.

City Philadelphia

Vendor

Company Code

TEST2

AddressX

Name

Street

Computer Land

10 Walnut St.

CityBoston

In this example, we will read records from a sequential file on the application server to create a batch input session that

updates multiple vendors.



Example #2 - Sequential File

TEST1 123 Main St.

TEST2 10 Walnut St.

TEST3 32 Chestnut St.

TEST4 30 Market St.

TEST5 17 S. 30th St.

File name:

‘/tmp/bc180_file3’

The sequential file we will read is set up in records. Each record has two fields with

the following formats:

<Field1> LIKE LFA1-LIFNR

<Field2> LIKE LFA1-STRAS



Example #2 - Declaration Section

REPORT YDIXX5_02.

DATA: BDC_TAB TYPE STANDARD TABLE OF BDCDATA INITIAL SIZE 6 ,SESSION TYPE APQ_GRPN

VALUE 'DEMO#9',INFILE(20) VALUE '/tmp/bc180_file3'.

DATA: BEGIN OF INREC,VENDNUM TYPE LIFNR,STREET TYPE STRAS_GP,

END OF INREC.

Step #1

Step #2




Example #2 - Main Program

START-OF-SELECTION.OPEN DATASET INFILE

FOR INPUT IN TEXT MODE ENCODING DEFAULT.

CALL FUNCTION ‘BDC_OPEN_GROUP’. . . .DO.

READ DATASET INFILE INTO INREC.IF SY-SUBRC <> 0. EXIT. ENDIF.PERFORM FILL_BDC_TAB.CALL FUNCTION ‘BDC_INSERT’

EXPORTINGTCODE = ‘FK02’

TABLESDYNPROTAB = BDC_TAB. . . .

ENDDO.CALL FUNCTION ‘BDC_CLOSE_GROUP’. . . .CLOSE DATASET INFILE.

SY-SUBRCCHECKStep #3

Step #4

Step #5

Step #6

Step #7

Step #8

Step #9

Step #10




Example #2 - Subroutines

FORM FILL_BDC_TAB.

REFRESH BDC_TAB.

PERFORM POPULATE_BDC_TABUSING:

‘1’ ‘SAPMF02K’ ‘0106’,‘ ’ ‘RF02K-LIFNR’ INREC-VENDNUM,‘ ’ ‘RF02K-D0110’ ‘X’,

‘1’ ‘SAPMF02K’ ‘0110’,‘ ’ ‘LFA1-STRAS’ INREC-STREET,‘ ’ ‘BDC_OKCODE’ ‘=UPDA’.

ENDFORM.

FORM POPULATE_BDC_TAB USINGFLAG TYPE C

VAR1 TYPE C VAR2 TYPE C. CLEAR WA_BDC_TAB.

IF FLAG = ‘1’.WA_BDC_TAB-PROGRAM = VAR1.WA_BDC_TAB-DYNPRO = VAR2.WA_BDC_TAB-DYNBEGIN = ‘X’.ELSE.WA_BDC_TAB-FNAM = VAR1.WA_BDC_TAB-FVAL = VAR2.ENDIF.

APPEND WA_BDC_TAB TO BDC_TAB.

ENDFORM.

Notice that the vendor number and street values are coming from the file’s records read into the “INREC” structure.



Demonstration

Creation of a custom batch input session program for transaction XD02 (Change Customer).



Practice

Creation of a custom batch input session program for transaction XD02 (Change Customer).



Summary

Research Transaction

Code BDC Program

Execute BDC Program

Batch Input Session Created

Process Batch Input Session

SAP Database Updated



Questions

What are the function modules required to create a batch input session ?

In what sequence are they called ?

Documents

Chapter 05_ Batch Input Session