NAF-Funktionen in einer IMS TM-Umgebung

#### Search Results

Search

# NAF-Funktionen in einer IMS TM-Umgebung

In diesem Dokument werden die Funktionen von Natural Advanced Facilities speziell für eine IMS TM-Umgebung erläutert.

- Übersicht

- IMS TM-Optionen

- Warten auf Eingabe (Wait for Input, WFI)

## Übersicht

`NATSPOOL` sammelt alle während einer Natural-Benutzersitzung erzeugten Reports in der Spool-Datei.

Um einen Report physisch zu drucken (d.h. die Ausgabe an einen IMS LTERM zu senden, der einem Drucker zugeordnet ist), führt `NATSPOOL` die folgenden Schritte durch:

1. Der MPP Natural fügt eine Nachricht in die IMS-Nachrichtenwarteschlange für einen Transaktionscode ein, der als (nicht-konversationeller) Eingabe-Transaktionscode für eine BMP-Region verwendet wird. Dieser Transaktionscode kann ein WFI-Transaktionscode (Wait for Input (WFI)) sein oder nicht.

2. Wenn die BMP als WFI generiert und vom IMS TM-Operator gestartet wurde, werden alle Reports, die während der IMS TM-Sitzung erstellt werden, von dieser BMP gedruckt. Wird die BMP nicht als WFI generiert, gibt Natural das Kommando `/STA REGxxxxxxxx` aus, um die BMP-Region zu starten, wobei `xxxxxxxx` für den in den Spool-Datei-Optionen angegebenen BMP JCL-Member-Namen steht (siehe Funktion 30.5).

3. Die BMP-Region führt Natural unter der Kontrolle der Natural BMP-Schnittstelle für IMS TM aus. Die Eingabe in Natural muss wie folgt lauten:

       //CMSYNIN DD *
         LOGON SYSPRINT
         SVPIMS01
         FIN
       /*

4. Das Natural-Programm `SVPIMS01` in der Library `SYSPRINT` ruft die Nachricht aus der IMS-Warteschlange ab, um herauszufinden, was gedruckt werden muss, und sendet die ausgewählte Ausgabe an den IMS-Drucker. Je nachdem, ob der Transaktionscode WFI ist oder nicht, "wartet" die BMP-Region entweder auf die nächste Eingangsnachricht oder bricht ab. Die Nachricht enthält den in den Spool-Datei-Optionen (siehe Funktion 30.5) angegebenen BMP-Transaktionscode und den LTERM-Namen des IMS-Druckers. Da `SVPIMS01` `CMGETMSG` dynamisch aufruft, muss die Ladebibliothek, die dieses Modul enthält, in der BMP-JCL verkettet werden.

Die logische Verbindung zwischen den beiden von `NATSPOOL` verwendeten Natural-Sessions ist unten dargestellt.

## IMS TM-Optionen

Um Natural Advanced Facilities in einer IMS TM-Umgebung zu installieren, müssen Sie die untern aufgeführten `NATSPOOL`-Parameter angeben.

Sie können diese Parameter auch mit der Funktion 30.5 (Set Spool Option/Spool-Option setzen) festlegen, wie in Layout der Spool-Datei beschrieben.

Parameter | Erläuterung
--- | ---
`BMPCODE= name` | Gibt den BMP-Transaktionscode an.
`BMPNAME= name` | Gibt den Namen des BMP-JCL-Members an.
`BMPWFI=ON/OFF` | Gibt die Option BMP WFI an.

Sie können einen Parameter weglassen oder den zugewiesenen Wert (`name` oder `OFF`/`ON`) auf "leer" setzen.

Für die Verwendung von Parametern gilt die folgende Vorrangregel:

- Für alle Parameter, die nicht in `NAFPRMI` definiert oder auf "leer" gesetzt wurden, gelten die entsprechenden in der Spool-Datei definierten Werte.

- Parameter, die im `NAFPRMI`-Parametermodul definiert wurden, indem der Wert ungleich "leer" gesetzt wurde, haben Vorrang vor den in der Spool-Datei definierten Werten. Daher können Sie das `NAFPRMI`-Parametermodul verwenden, um bestimmte Optionen nur für bestimmte BMPs zu setzen. Dies kann bei mehreren IMS TM-Umgebungen nützlich sein, die sich dieselbe Spool-Datei teilen.

## Warten auf Eingabe (Wait for Input, WFI)

Unter IMS TM gibt es die Möglichkeit, alle Reports, die während einer IMS TM-Sitzung erstellt werden, mit nur einem BMP zu drucken. Um dies zu ermöglichen, kann das BMP-Programm `SVPIMS01` in der Library `SYSPRINT` dazu veranlasst werden, dass es nach dem Start durch den IMS-Operator "auf Eingabe wartet". Nachdem die Nachricht für den BMP-Eingabe-Transaktionscode in die IMS-Warteschlange eingefügt wurde, wird kein `/STA REG`-Kommando von der MPP-Region ausgegeben.

Um die BMP zu stoppen, geben Sie das Kommando `/PSTO REG` aus. Die BMP wird automatisch gestoppt, wenn die Datenbank, in der sich die Spool-Datei befindet, nicht mehr aktiv ist, oder wenn während der Ausführung ein Fehler auftritt.

Um diese Funktion zu nutzen, muss die BMP-Transaktion als WFI im Makro IMS TM `TRANSACT` generiert werden, und in den Spool-Datei-Optionen oder im `NAFPARMI`-Parametermodul muss "Warten auf Eingabe" (Wait for input) eingestellt sein.

Da die Natural Advanced Facilities-Transaktion als BMP-WFI ausgeführt werden kann, ist es auch möglich, diese Druckertransaktion als Online-Transaktion unter dem nachrichtenorientierten Online-Natural laufen zu lassen.

Dies kann erreicht werden, indem die Spool-Datei-Optionen mit einer BMP-ID angegeben werden, die einem nicht-konversationellen Transaktionscode entspricht, der von dem nachrichtenorientierten Online-Natural empfangen wird. Außerdem ist "Warten auf Eingabe" (Wait for input) gleich `Y` erforderlich, um das Kommando `/STA REG` zu unterdrücken, da diese Transaktion wie die normalen dialogorientierten Natural-Transaktionen geplant wird.

Um das nachrichtenorientierte Natural anzuweisen, das Natural-Druckprogramm `SVPIMS01` auszuführen, muss ein Bootstrap-Modul mit den folgenden dynamischen Natural-Parametern als Startprogramm der Transaktion generiert werden:

    STACK=(LOGON SYSPRINT;SVPIMS01),PRINTER=LTERMP01

Andere Anforderungen, wie WRKPCBS, entsprechen der BMP-Version. Eine Anleitung zur Generierung des Bootstraps finden Sie im Abschnitt Installing the Natural IMS TM Interface on z/OS in der Installation for z/OS-Dokumentation.

Bei der Entscheidung, wie Sie Natural Advanced Facilities unter IMS betreiben wollen, müssen Sie die Besonderheiten des Standorts berücksichtigen. So können beispielsweise extrem lange Druckvorgänge andere Online-Transaktionen in derselben Region behindern. Ständig in der Warteschlange befindliche Druckvorgänge können auch zu einer Sperrung der Region durch das Drucken führen. Sie können dies vermeiden, indem Sie IMS-Transaktionsparameter wie `PROCLIM` verwenden.

### On this page

- Übersicht
- IMS TM-Optionen
- Warten auf Eingabe (Wait for Input, WFI)