Show TOC

Procedure documentationCalling ABAP Subroutines: PERFORM Locate this document in the navigation structure

Procedure

You can use the PERFORM command to call an ABAP subroutine from any program, subject to the normal ABAP runtime authorization checking. You can use such calls to subroutines for carrying out calculations, for obtaining data from the database that is needed at display or print time, for formatting data, and so on.

PERFORM commands, like all control commands, are executed when a document is formatted for display or printing. Communication between a subroutine that you call and the document is by way of symbols whose values are set in the subroutine.

Note Note

The PERFORM command is not executed within SAPscript replace modules, such as TEXT_SYMBOL_REPLACE or TEXT_INCLUDE_REPLACE. The replace modules can replace symbol values or open include texts, but they cannot interpret SAPscript control commands.

End of the note.

Syntax in a form window:

Syntax Syntax

  1. /: PERFORM <form> IN PROGRAM <prog>
/: USING &INVAR1&
/: USING &INVAR2&
......
/: CHANGING &OUTVAR1&
/: CHANGING &OUTVAR2&
......
/: ENDPERFORM
End of the code.

INVAR1 and INVAR2 are variable symbols and may be of any of the four SAPscript- symbol types.

OUTVAR1 and OUTVAR2 are local text symbols and must therefore be character strings.

The ABAP subroutine called via the command line stated above must be defined in the ABAP report prog as follows:

Syntax Syntax

  1. FORM <form> TABLES IN_TAB STRUCTURE ITCSY
OUT_TAB STRUCTURE ITCSY.
...
ENDFORM.
End of the code.

The values of the SAPscript symbols passed with /:USING... are now stored in the internal table IN_TAB. Note that the system passes the values as character string to the subroutine, since the field VALUE in structure ITCSY has the domain TDSYMVALUE (CHAR 80). See the example below on how to access the variables.

The internal table OUT_TAB contains names and values of the CHANGING parameters in the PERFORM statement. These parameters are local text symbols, that is, character fields. See the example below on how to return the variables within the subroutine.

Example Example

From within a SAPscript form, a subroutine GET_BARCODE in the ABAP program QCJPERFO is called. Then the simple barcode contained there (‘First page’, ‘Next page’, ‘Last page’) is printed as local variable symbol.

End of the example.

Definition in the SAPscript form:

Syntax Syntax

  1. /: PERFORM GET_STRICHCODE IN PROGRAM QCJPERFO
/: USING &PAGE&
/: USING &NEXTPAGE&
/: CHANGING &BARCODE&
/: ENDPERFORM
/

/  &BARCODE&
End of the code.

Coding of the calling ABAP program:

Syntax Syntax

  1. REPORT QCJPERFO.


FORM GET_STRICHCODE TABLES IN_PAR STUCTURE ITCSY
OUT_PAR STRUCTURE ITCSY.

DATA: PAGNUM LIKE SY-TABIX,	"page number 
NEXTPAGE LIKE SY-TABIX.		"number of next page


READ TABLE IN_PAR WITH KEY 'PAGE'.
CHECK SY-SUBRC = 0.
PAGNUM = IN_PAR-VALUE.
READ TABLE IN_PAR WITH KEY 'NEXTPAGE'.
CHECK SY-SUBRC = 0.
NEXTPAGE = IN_PAR-VALUE.

READ TABLE OUT_PAR WITH KEY 'BARCODE'.
CHECK SY-SUBRC = 0.
IF PAGNUM = 1.
OUT_PAR-VALUE = '|'.		"First page
ELSE.
OUT_PAR-VALUE = '||'.		"Next page
ENDIF.

IF NEXTPAGE = 0.
OUT_PAR-VALUE+2 = 'L'.		"Flag: last page

ENDIF.

MODIFY OUT_PAR INDEX SY-TABIX.


ENDFORM.
End of the code.