topic Re: how to create a include in Application Development and Automation Discussions

how to create a include

Former Member — Tue, 25 Jul 2006 13:39:28 GMT

Hello ABAP Experts,

I was suggested to use an include for some modification in the program.

what is the purpose of the include and how to create it.

how is it different from using a function module.

how to decide, whether i have to use the include or the function module.

Thanks,

BWer

Re: how to create a include

Former Member — Tue, 25 Jul 2006 13:41:37 GMT

When you use a function module you can use it in another program, but an include is only for save procedures, so you can use these procedures, but only on this program,

regards

Re: how to create a include

RichHeilman — Tue, 25 Jul 2006 13:42:29 GMT

An INCLUDE is simply a way to separate code to make it more managable. For example, in a module pool program, there are includes. In a basic one, you will see a TOP include which as all of the data and type declaractions, a O01 include which as all of the PBO modules, a PAI include which has all of the I01 modules and a F01 include which has all of the forms or subroutines. You can create an include via SE38, instead of selecting "Execture Program" from the listbox, just choose "Include Program".

Regards,

Rich Heilman

Re: how to create a include

Former Member — Tue, 25 Jul 2006 13:53:13 GMT

Hi,

to create a include program->goto se38 editor create a program with type INCLUDE PROGRAM.

u can call this include in ur program by the statement

include zprogname.

reward if helpful.

regards,

keerthi.

Re: how to create a include

Former Member — Tue, 25 Jul 2006 13:57:49 GMT

hi,

Include programs are global R/3 Repository objects. They are solely for modularizing source code, and have no parameter interface.

They have the following functions:

Library: Include programs allow you to use the same source code in different programs. For example, this can be useful if you have lengthy data declarations that you want to use in different programs.

Order. Include programs allow you to manage complex programs in an orderly way. Function groups and module pools use include programs to store parts of the program that belong together. The ABAP Workbench supports you extensively when you create such complex programs by creating the include programs automatically and by assigning them unique names. A special include is the TOP include of a program. If you name it according to the naming convention, it is always included in program navigation and in the syntax check.

Creating Your Own Include Programs

If you create an include program yourself, you must assign it the type I in its program attributes. You can also create or change an include program by double-clicking on the name of the program after the INCLUDE statement in your ABAP program. If the program exists, the ABAP Workbench navigates to it. If it does not exist, the system creates it for you.

An include program cannot run independently, but must be built into other programs. Include programs can contain other includes.

The only restrictions for writing the source code of include programs are:

Include programs cannot call themselves.

Include programs must contain complete statements.

You must ensure that the statements of your include program fit logically into the source code of the programs from which it is called. Choosing Check while editing an include program in the ABAP Editor is normally not sufficient for this.

***INCLUDE INCL_TST.

TEXT = 'Hello!'.

Here, the syntax check reports an error because the field TEXT is not declared. However, you can include INCL_TST in any program in which a field called TEXT with the correct type has been declared.

For the syntax check to produce valid results, you must check the program in which the include occurs. The exception to this is the TOP include, the contents of which are always included when you check the syntax of another include.

Using Include Programs

To use an include program in another program, enter the statement

INCLUDE <incl>.

The INCLUDE statement has the same effect as copying the source code of the include program <incl> into the program. In the syntax check, the contents of the include program are also analyzed. Include programs are not loaded at runtime, but are expanded when the program is generated. Once the program has been generated, the load version contains static versions of all of its includes. If you subsequently change an include program, the programs that use it are automatically regenerated.

The INCLUDE statement must be the only statement on a line and cannot extend over several lines.

Suppose we have the following program:

***INCLUDE STARTTXT.

WRITE: / 'Program started by', SY-UNAME,

/ 'on host', SY-HOST,

'date:', SY-DATUM, 'time:', SY-UZEIT.

ULINE.

We can then include this program in any other ABAP program to display a standard list header.

PROGRAM SAPMZTST.

INCLUDE STARTTXT.

............

This could produce the following output:

Program started by KELLERH

on host ds0025 date: 03/19/1998 time: 09:00:39

___________________________________________________________

................

check the below link for it

http://help.sap.com/saphelp_nw2004s/helpdata/en/9f/db973535c111d1829f0000e829fbfe/frameset.htm

If u find it useful plz mark the points

Regards,

Naveen

Re: how to create a include

Former Member — Tue, 25 Jul 2006 13:57:49 GMT

INCLUDE pgm is used for coding common routines used, thereby making it possible to re-use the code. So, in short you can use the routines(FORMS) defined in the INCLUDE from the main pgm(including the other includes in the main pgm). U can create it just like another ABAP

using SE38 but defining the type attribute as Include.

Function module, are basically used for general code which can be used by any ABAP just by using the call function statement. Surely, you can import/export variables and tables to function module.

In short, we can say Include is for routines to be used within the Main Calling program while Function module is for global use.

Regards

Anurag

Re: how to create a include

Laxmana_Appana_ — Tue, 25 Jul 2006 14:01:12 GMT

Hi,

you want to make some modifications in the script , that time with out changing the print program , you can call subroutines from the script , in this case you can define these soubroutines in a include.

to create include , just write below statement in any report program and double click on name , system automatically gives pop-up to create include

INCLUDE <Name>

you can create include from SE38 , give a name in SE38 and take type from the attributes as 'INCLUDE program' then system will create a include.

includes are useful to create subroutines ,these are specific to particular program .function modules can be called from any program , these are global objects.but if you want to call any subroutines from any include , you need to add that include in the program.

if you are writing any generic code which can be used in any program then go for function modules.

if you are writing partcular code which is specific to one object then go for include .

Regards

Appana