PROFILE - Dynamisches Parameterprofil anwenden

#### Search Results

Search

# 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.

Anmerkungen:

1. Zum Erstellen und Pflegen von Parameterprofilen dient die Utility `SYSPARM`.
2. Eine deutsche Beschreibung der Utility SYSPARM existiert im Dokumentensatz Debugger und AE-Dienstprogramme, englische Beschreibung siehe 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:

1. 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.
2. Mit dem Profilparameter `USER` können Sie die Benutzung eines Profils einschränken.
3. 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.
4. 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.