GENERATE - Generate a program
Variants
1. GENERATE REPORT prog.
2. GENERATE SUBROUTINE POOL itab NAME name.
Variant 1
GENERATE REPORT prog.
Additions
1. ... MESSAGE f1
2. ... INCLUDE f2
3. ... LINE f3
4. ... WORD f4
5. ... OFFSET f5
6. ... TRACE-FILE f6
7. ... DIRECTORY ENTRY f7
8. ... WITHOUT SELECTION-SCREEN
Effect
Generates the program specified in the field
prog . If the program is a report (i.e. a type 1 program), the
selection screen is generated automatically.
The return code value is set as follows:
SY-SUBRC = 0
Program generated successfully.
SY-SUBRC <> 0
Unable to generate program.
SY_SUBRC = 4
Syntax error.
SY-SUBRC = 8
Generation error.
SY-SUBRC = 12
Error when generating selection screen.
Addition 1
... MESSAGE f1
Effect
When a syntax error occurs, the error message is stored
in this field.
Addition 2
... INCLUDE f2
Effect
When a syntax error occurs, the name of the include
program concerned is stored in this field.
Addition 3
... LINE f3
Effect
When a syntax error occurs, the number of the incorrect
line is stored in this field.
Addition 4
... WORD f4
Effect
When a syntax error occurs, the incorrect word is stored
in this field.
Addition 5
... OFFSET f5
Effect
When a syntax error occurs, the position of the
incorrect word in the incorrect line is stored in this field.
Addition 6
... TRACE-FILE f6
Effect
Trace output is stored in this file. This addition
automatically activates the trace mode.
Addition 7
... DIRECTORY ENTRY f7
Effect
The program attributes required for checking are taken
from the field f4 . This field must correspond to the structure
of the table TRDIR .
Addition 8
... WITHOUT SELECTION-SCREEN
Effect
Does not generate the selection screen.
Variant 2
GENERATE SUBROUTINE POOL itab NAME name.
Additions
1. ... MESSAGE f1
2. ... INCLUDE f2
3. ... LINE f3
4. ... WORD f4
5. ... OFFSET f5
6. ... TRACE-FILE f6
The additions have the same meaning as with GENERATE REPORT .
Only the addition DIRECTORY-ENTRY is not supported with
GENERATE SUBROUTINE POOL because temporary subroutine pools are
always generated as type S programs and the arithmetic flag is taken
over from the generating program.
Effect
Generates a temporary subroutine pool. The source code
for the subroutine pool to be generated is passed on in the internal
table itab . The field name contains the name under which
FORM routines can be addressed in the temporary subroutine pool
via external PERFORM .
The return code value is set as follows:
SY-SUBRC = 0
Generation successful.
SY-SUBRC <> 0
Generation unsuccessful.
SY_SUBRC = 4
Syntax error.
SY-SUBRC = 8
Generation error.
In contrast to GENERATE REPORT , the source code is passed on
in an internal table with GENERATE SUBROUTINE POOL , not read
from the database. The load version generated is not written to the
database but held in main memory only.
Notes
Temporary subroutine pools belong to the runtime context
of the generating program, i.e. to the roll area of the internal mode
from which the generation is performed. They may therefore be addressed
only within this context, i.e. the generated FORM routines can
only be called from within the generating mode.
Up to 36 temporary subroutine pools can currently be managed for each
roll area.
Related
SYNTAX-CHECK
Index
© SAP AG 1996