システムにより、汎用グループとその汎用モジュールに対するオブジェクトの構成が事前に定義されています。汎用グループを登録すると、ワークベンチによりメインプログラム、グローバルデータ、およびソースコードが自動的に生成されます。書式 SAPL<fgrp> を使って、 メインプログラムの名前が自動的に設定されます。 <fgrp> 変数は、汎用グループの名前です。

汎用グループ内の連続する汎用モジュールごとに、ワークベンチはインクルードファイルを自動的に登録します。汎用モジュールビルダの第一画面でソースコードを選択することで、このインクルードファイルを表示することができます。書式 L<functgrp> U<nn> を使って、このインクルードファイルの名前が自動的に設定されます。たとえば、汎用グループ FGRP の最初の汎用モジュールは、インクルードファイル LFGRPU01 になります。後続の汎用モジュールは、 LFGRPU02 、 LFGRPU03 、 LFGRPU04 というようなインクルードファイルになります。

汎用モジュールビルダにより、メインプログラムのインクルードが生成されます。書式 L<functgrp> UXX を使って、 メインプログラムの名前が自動的に設定されます。汎用グループ FGRP の場合、メインプログラムのインクルードは LFGRPUXX となります。

汎用モジュールビルダの第一画面で、ソースコードを選びます。 ABAP エディタが表示されます。ここから、 FUNCTION 命令から EDNFUNCTION 命令までの間に汎用モジュールのコードを書き込むことができます。
汎用モジュールのパラメータと例外は、コメント行としてエディタに表示されます。

汎用モジュールを作成するときに考慮すべき新しい点

• 汎用モジュールのソースコードでは、 export パラメータや import パラメータを宣言しません。パラメータの一覧をコメント行としてソースコードに挿入する INCLUDE プログラムを使って自動的に宣言されます。
• サブルーチンの場合と同じ方法で、汎用モジュールのローカルデータタイプとオブジェクトを宣言することができます。
• TYPES 命令および DATA 命令を使って、データを L<fgrp>TOP に宣言することができます。すると、このデータは汎用グループ内のすべての汎用モジュールで使用することができるようになります。グループ内の汎用モジュールがはじめて呼び出されるときに、データが登録されます。常に、最後に呼び出されるモジュールから値が保存されます。

• ENDFUNCTION 命令の後に追加することで、内部サブルーチンを書き込みます。これらのサブルーチンは、グループ内のすべての汎用モジュールから呼び出すことができます。ただし、サブルーチンの呼出は、登録した汎用モジュール内の汎用モジュールのみからとすることをお奨めします。これによって、汎用グループを理解しやすくなります。
• 内部サブルーチンを登録し、汎用グループ <fgrp> 内のすべての汎用モジュールからその内部サブルーチンを呼び出す場合は、特別な INCLUDE プログラム L<fgrp>F<XX> を使用します。
• 汎用モジュールから任意の外部サブルーチンでも呼び出すことができます。

汎用モジュール内で、インタフェースで定義した名前を使って、すべての例外にアドレス指定を行うことができます。例外は、システムまたは呼出元プログラムのいずれかから処理することができます。これは、自分で処理する例外に数値を割り当てることで、汎用モジュールを呼び出すときに決定します。追加情報については、 プログラムからの汎用モジュールの呼出しを参照してください。

例外は明示的に開始されなければなりません。
例外の開始に使用できる汎用モジュール内でのみ使用できる ABAP 命令は、次の２つです。

RAISE < 例外 >.

MESSAGE ..... RAISING < 例外 >.

• RAISE 命令で例外を開始し、呼出元プログラムでそれを処理する場合は、汎用モジュールの処理が終了され、例外に割り当てられた数値がシステム項目 SY-SUBRC に入ります。後続の処理が呼出元プログラムで行われます。

• MESSAGE ... RAISING 命令を使用すると、その処理は呼出元プログラムで例外を処理する場合と似ています。システムで例外を処理する場合は、この場合の実行時エラーは生成されません。処理が継続され、定義されたタイプでメッセージが表示されます。これを行うには、インクルードプログラムの最初の命令で MESSAGE-ID を指定しなければなりません。 MESSAGE ... RAISING 命令でも、以下のシステム項目に値が入力されます。