Ansicht
Dokumentation

RFFMBTCH - *** Batch Heading Routine ***

TXBHW - Original Tax Base Amount in Local Currency   ABAP Short Reference  
This documentation is copyright by SAP AG.

Use

Batch Heading Routine

Note

The program contains the following subroutines, which can be accessed from every report program:

• BATCH-HEADING

• NEW-SECTION

• JUST-ROUTINE

BATCH-HEADING-ROUTINE

---------------------

You use this routine to include more information on the first two lines of the list than the standard report page header can accommodate. In addition, you can also have microfiche information printed as the first line. This is useful if your company uses microfiche to evaluate information.

The call is as follows:

PERFORM BATCH-HEADING(RSBTCHH0).

The following call should be used from function modules:

PERFORM BATCH-HEADING1(RSBTCHH0) USING BHDGD.

Naturally, the call takes place in TOP-OF-PAGE. The report program instruction contains subparameter NO STANDARD PAGE HEADING.

At START-OF-SELECTION or a comparable point in time, the following

parameters are transferred, at your option, into dictionary table BHDGD:

BHDGD-LINE1: Report program title (SY-TITLE)

BHDGD-LINE2: A subtitle of up to 60 characters, which the user can, for example, set as a parameter (also in report program PARAMETERS: TITLE(40) TYPE C agree).

BHDGD-LINES: Line width in report program (SY-LINSZ).

BHDGD-UNAME: User name (SY-UNAME).

BHDGD-REPID: Name of report program

In the event of a company code change, the company code name and location can be shown, left-justified, when the company code is brought into field BHDGD-BUKRS at event AT NEW BUKRS.

In the case of cross-company group levels (example: event AT LAST in the loop of a sorted dataset in which the totals for all company codes is output on a separate sheet), you can have the system make available the group entry from table T000 by entering " " in field BHDGD-BUKRS.

Use of Field BHDGD-INIFL:

Normally, the batch heading routine initializes once; after that, it only evaluates the company code changes.

However, depending on the data, a situation may arise where you want a different report program header. You must then reset the fields BHDGD-LINE1 and BHDGD-LINE2 with SPACE and enter the new header. You must also set field BHDGD-INIFL to "0", thereby reinitializing it.

Output and Setting of Microfiche Information --------------------------------------------

If you want to see microfiche infromation in the first line of the list,you must first check off parameter BHDGD-MIFFL in START-OF-SELECTION or a similar event. Use PARAMETERS: MI-FICHE(1) TYPE C to offer the user this option.

The system then prints standard information only, in character format, left justified and without blanks, as follows:

- Client (3 characters)

- Selection date (8 characters, format YYYYMMDD)

- Selection time (6 characters, format HHMMSS)

- Report prog.name (8 characters, BHDGD-REPID)

- Sequence nummer (3 characters, always 001 at this time)

- Person using prog.(8 characters BHDGD-UNAME)

Dieser Mikrofiche-Kopf kann nun dynamisch vom Report um die relevanten Gruppenbegriffe ergänzt werden. Dazu muß man zum Zeitpunkt AT NEW ... (... - relevante Gruppenstufe) das Feld BHDGD-GRPIN füllen.

Eventuell ist zum Zeitpunkt AT END OF rel. Gruppenstufe ein Teil des Feldes zu löschen (z.B. bei Ausgaben auf einem separatem Blatt).

Der Reportautor hat das Feld BHDGD-GRPIN selbst zu verwalten.

Ein Beispiel der Programmierung der Batch-Heading-Routine findet sich im Report RFKOPO00.

NEW-SECTION-ROUTINE

-------------------

Diese Routine ermöglicht die Trennung der Listausgabe nach einem Kriterium, z.B. nach Buchungskreis.

Der Aufruf erfolgt vom rufenden Report zu einem Zeitpunkt, an dem ein Seitenvorschub auf eine neue Seite erfolgen würde, z.B. AT NEW BUKRS.

Der Aufruf lautet:

PERFORM NEW-SECTION(RSBTCHH0).

Aus Funktionsbausteinen sollte folgender Aufruf verwendet werden:

PERFORM NEW-SECTION1(RSBTCHH0) USING BHDGD.

Zuvor müssen folgende Felder der Tabelle BHDGD gefüllt sein:

BHDGD-SEPAR - 'X'

BHDGD-DOMAI - Name einer Domäne, z.B. 'BUKRS'

Bhdgd-Werte - aktueller Wert der Domäne, z.B. '0001' für
Buchungskreis 0001

Die Routine macht einen Seitenvorschub und führt eine Neunumerierung der Seiten durch. Mit den Inhalten der Felder BHDGD-DOMAI und BHDGD-WERTE wird nun ein entsprechender Eintrag in der Tabelle LSEP gesucht, um die Druckausgabe zu separieren. Unter anderem ist es möglich, die Druckausgabe auf unterschiedliche logische Druckdateien zu steuern oder die Druckausgabe in den SAP-Spool umzuleiten. Eine genaue Dokumentation der Möglichkeiten findet sich in der Dokumentation der Tabelle LSEP. Wird kein entsprechender Eintrag in der Tabelle LSEP gefunden, so wird die Druckausgabe auf die in der ursprünglichen Batchanforderung definierte Druckdatei geleitet und auf einem separaten Deckblatt gemeldet. Ist das Feld BHDGD-SEPAR nicht gefüllt, so wird lediglich ein Seitenvorschub und eine Seitenneunumerierung durchgeführt. Die Listenseparation unterbleibt.

JUST_Routine

------------

Die Routine dient dazu, einen Text innerhalb eines Feldes zu zentrieren.

Der Aufruf lautet wie folgt:

PERFORM JUST_ROUTINE(RSBTCHH0) USING p1 p2.

Dabei bedeutet

p1 - Name eines Feldes, das den zu zentrierenden Text enthält

p2 - Länge des Feldes

ROGBILLS - Synchronize billing plans   rdisp/max_wprun_time - Maximum work process run time  
This documentation is copyright by SAP AG.

Length: 6106 Date: 20240520 Time: 133647     sap01-206 ( 96 ms )