PROFILE - Dynamisches Parameterprofil anwenden

Mit diesem Natural-Profilparameter können Sie ein Parameterprofil anwenden.

Anstatt jedes Mal, wenn Sie Natural aufrufen, eine ganze Zeichenkette mit Einzelparametern anzugeben, können Sie die Parameter-Zeichenkette einmal angeben, diese Zeichenkette dann unter einem Profilnamen speichern und anschließend Natural mit diesem Parameterprofil aufrufen. Die mit diesem Profil definierten Parameter werden dann als dynamische Parameter an Natural übergeben.

Anmerkung:
Zum Erstellen und Pflegen von Parameterprofilen dient die Utility SYSPARM (eine deutsche Beschreibung existiert als Anhang zu diesem Dokument, eine englische Beschreibung befindet sich in der Utilies-Dokumentation)

Mit dem Profilparameter FPROF können Sie eine Systemdatei für Parameterprofile (FPROF) angeben.

Mögliche Werte	Siehe PROFILE-Parameter-Syntax.
Standard-Einstellung	keine
Dynamische Angabe	ja
Angabe innerhalb der Session	nein

Anmerkungen:

Falls der Profilparameter PROFILE im Natural-Parametermodul angegeben ist, wird er nach den anderen Parametern im Parametermodul ausgewertet, jedoch bevor irgendwelche dynamisch angegebenen Parameter ausgewertet werden. Das bedeutet, dass Parameter, die innerhalb des Profils angegeben sind, durch einzeln angegebene dynamische Parameter aufgehoben werden können.
Mit dem Profilparameter USER können Sie die Benutzung eines Profils einschränken.
Im Gegensatz zu anderen Parametern kann eine PROFILE-Parameterangabe nicht durch ein anderes Profil überschrieben werden. Somit können Sie mehrere Parameterprofile haben, die alle nacheinander ausgewertet werden.
Der Profilparameter PROFILE kann nicht mit ADARUN MODE=SINGLE benutzt werden.

PROFILE-Parameter-Syntax

Der Profilparameter PROFILE kann gemäß einer der beiden folgenden Syntax-Optionen angegeben werden:

Syntax 1 - Standard-Datenbank/Datei:

PROFILE=

profile-name
AUTO
PROGRAM
TERMINAL

Syntax 2 - Angegebene Datenbank/Datei:

PROFILE=(

profile-name
AUTO
PROGRAM
TERMINAL

,dbid,fnr,password,cipher-key)

Die Syntax-Elemente sind im folgenden Abschnitt beschrieben.

Eine Erläuterung der in dem Syntax-Diagramm verwendeten Symbole entnehmen Sie dem Abschnitt Syntax-Symbole (in der Statements-Dokumentation).

Speicherort für Parameterprofile

Die Speicherung der Parameterprofile erfolgt abhängig davon, ob beim PROFILE-Parameter die Datenbankkennung und die Dateinummer angegeben wird. Dabei gilt Folgendes:

Wenn die Datenbankkennung und die Dateinummer beim PROFILE-Parameter nicht angegeben sind (Syntax 1), werden die Standardeinstellungen benutzt.
1. Wenn der Profilparameter FPROF gesetzt ist, wird das Parameterprofil aus der aktuellen Systemdatei FPROF gelesen.
2. Wenn der Profilparameter FPROF nicht gesetzt ist, wird das Parameterprofil aus der aktuellen Systemdatei FNAT gelesen.
Wenn die Datenbankkennung und die Dateinummer beim PROFILE-Parameter angegeben sind (Syntax 2), werden die angegebenen Werte benutzt.

Syntax-Element-Beschreibung

Syntax 1 verwendet Standardeinstellungen für Datenbankkennungen und Dateinummern:

Wenn der Profilparameter FPROF gesetzt ist, wird das Parameterprofil aus der aktuellen Systemdatei FPROF gelesen.
Wenn der Profilparameter FPROF nicht gesetzt ist, wird das Parameterprofil aus der aktuellen Systemdatei FNAT gelesen.

Syntax 2 verwendet Datenbankkennungen und Dateinummern gemäß den Beschreibungen in der folgenden Tabelle:

Syntax-Element	Wert	Erklärung
`profile-name`	1 - 8 Zeichen	Der Name des zu verwendenden Parameterprofils. Wenn Sie möchten, dass alle während einer Sitzung verwendeten Profile nicht aus der Standard-Datenbank und Standard-Systemdatei, sondern aus einer anderen Datenbank und Systemdatei gelesen werden, geben Sie Folgendes an, bevor Sie das erste Profil benutzen: PROFILE=(,`dbid`,`fnr`)
`AUTO`	nicht zutreffend	Natural nimmt die aktuelle TP-Benutzerkennung (enthalten in der Systemvariablen `*INIT-USER`) als Profilname, was bedeutet, dass das Profil benutzt wird, das unter dem Namen gespeichert ist, der dieser Kennung entspricht. Wird kein solches Profil gefunden, wird stattdessen (falls vorhanden) ein Profil mit dem Namen `AUTO` benutzt. Sie können ein solches `AUTO`-Profil als Standard-Profil für Benutzer definieren, die kein individuelles Profil haben.
`PROGRAM`	nicht zutreffend	Natural nimmt den Namen des Programms, das zurzeit als Natural ausgeführt wird (enthalten in der Systemvariablen `*INIT-PROGRAM`) als Profilname, was bedeutet, dass das Profil benutzt wird, das unter dem Namen definiert ist, der dieser Kennung entspricht. Wird kein solches Profil gefunden, wird stattdessen (falls vorhanden) ein Profil mit dem Namen `PROGRAM` benutzt. Sie können ein solches `PROGRAM`-Profil als Standard-Profil für Benutzer definieren, die kein individuelles Profil haben.
`TERMINAL`	nicht zutreffend	Natural nimmt die aktuelle Terminalkennung (enthalten in der Systemvariablen `*INIT-ID`) als Profilname, was bedeutet, dass das Profil benutzt wird, das unter dem Namen gespeichert wird, der dieser Kennung entspricht. Wird kein solches Profil gefunden, wird stattdessen (falls vorhanden) ein Profil mit dem Namen `TERMINAL` benutzt. Sie können ein solches `TERMINAL`-Profil als Standard-Profil für Benutzer definieren, die kein individuelles Profil haben.
`dbid`	`1 - 65535`, außer `255`	Die Kennung der Datenbank (DBID), in der sich die Natural-Systemdatei für Parameterprofile befindet. Falls `dbid` nicht angegeben wird, dann wird der entsprechende Wert des Profilparameters `DBID` benutzt.
`fnr`	`1 - 65535`	Die Dateinummer (FNR) der Datenbank, in der sich die Natural-Systemdatei für Parameterprofile befindet. Falls `fnr` nicht angegeben wird, dann wird der entsprechende Wert des Profilparameters `FNR` benutzt.
`password`	1 - 8 Zeichen	Das Adabas-Passwort, falls bei einer durch Passwort geschützten Natural-Systemdatei erforderlich. Falls `password` nicht angegeben wird, dann wird der entsprechende Wert des Profilparameters `SYSPSW` benutzt.
`cipher-key`	8 Zeichen	Der Adabas-Chiffrierschlüssel, falls bei einer durch Passwort geschützten Natural-Systemdatei erforderlich. Falls `cipher-key` nicht angegeben wird, dann wird der entsprechende Wert des Profilparameters `SYSCIP` benutzt.