TF - Umsetzung der Datenbankkennung/Dateinummer

Dieser Natural-Profilparameter kann benutzt werden, um während der Ausführung einer Anwendung die Datenbankkennung (DBID)/Dateinummer (FNR) in eine andere Datenbankkennung/Dateinummer umzusetzen. Er entspricht dem Makro NTTF im Natural-Parametermodul.

Mögliche Werte Siehe TF-Parameter-Syntax.
Standard-Einstellung keine  
Dynamische Angabe ja Dieser Parameter kann nur dynamisch angegeben werden. Im Natural-Parametermodul wird stattdessen das Makro NTTF benutzt.
Angabe innerhalb der Session nein  
Anwendungsprogrammierschnittstelle USR1034N

Siehe SYSEXT Utility in der Debugger und AE-Dienstprogramme-Dokumentation.

* Empfohlen.

USR2005N *

Anmerkungen:

  1. Dieser Parameter gilt nur für Benutzerdateien. Er gilt nicht für Systemdateien.

  2. Dieser Parameter ist relevant, wenn eine Anwendung in einer Produktionsumgebung entwickelt wird. Er ermöglicht es Ihnen, eine Anwendung in einer Test-Datenbank zu entwickeln und dann die fertiggestellte Anwendung in die Produktionsdatenbank zu übertragen, ohne die Anwendung verändern oder neu katalogisieren zu müssen. Die Natural-Objekte werden mit Produktionsdatenbankkennung und -dateinummer (DBID/FNR) katalogisiert, aber immer dann, wenn ein Datenbankzugriff ausgeführt wird, wird die Produktions-DBID/FNR gemäß den Angaben im Parameter TF in die Test-DBID/FNR umgesetzt; d.h., es wird die Testdatenbank benutzt. Das bedeutet, dass der Test in der aktuellen Produktionsumgebung, jedoch ohne Produktionsdaten stattfinden kann.

  3. Der Parameter TF bzw. das Makro NTTF kann mehrmals angegeben werden, so dass verschiedene Kombinationen von Dateinummern angegeben werden können.

    Falls mehrere TF-Parameter angegeben werden, gilt Folgendes:

    • Die Liste der TF-Definitionen wird in der Reihenfolge durchsucht, in der sie angegeben sind. Verwendet wird der erste Eintrag, der exakt bezüglich DBID und FNR (kein *-Platzhalterzeichen) übereinstimmt.

    • Wird keine Übereinstimmung gefunden, werden die TF-Definitionen ein zweites Mal durchsucht. Dieses Mal wird der erste passende *-Platzhalterzeichen-Eintrag (entweder DBID oder FNR ist ein *-Platzhalterzeichen) verwendet.

Dieses Dokument behandelt folgende Themen:


TF-Parameter-Syntax

Der Profilparameter TF wird wie folgt angegeben:

TF=(production-dbid,production-fnr,test-dbid,test-fnr)

Dabei ist:

Syntax-Element Wert Erklärung
production-dbid 0 - 254 oder 256 - 65535 oder * Datenbankkennung der Produktionsdatenbank. Ein Stern (*) kann als Platzhalterzeichen für alle Datenbankkennungen benutzt werden.

Anmerkung:
Die Datenbankkennung 255 ist für logische Systemdateien für Software AG-Produkte reserviert, siehe Profilparameter LFILE.

production-fnr 1 - 65535 oder * Dateinummer der Produktionsdatenbank. Ein Stern (*) kann als Platzhalterzeichen für alle Dateinummern benutzt werden.
test-dbid 0 - 254 oder 256 - 65535 oder * Datenbankkennung der Testdatenbank. Ein Stern (*) kann als Platzhalterzeichen benutzt werden, dann bleibt die Datenbankkennung unverändert.
test-fnr 1 - 65535 oder * Dateinummer der Testdatenbank. Ein Stern (*) kann als Platzhalterzeichen benutzt werden, dann bleibt die Dateinummer unverändert.

NTTF-Makro-Syntax

Das Makro NTTF wird wie folgt angegeben:

         NTTF production-dbid,production-fnr,test-dbid,test-fnr

Anmerkung:
Erklärung der Syntax-Elemente und der möglichen Werte siehe TF-Parameter-Syntax.

Beispiel für TF-Parameter

TF=(777,39,17,88),TF=(251,*,9,*)

Beispiel für NTTF-Makro

Äquivalente Angabe im Natural-Parametermodul:

         NTTF 777,39,17,88
         NTTF 251,*,9,*