IMSPE - Umgebungsparameter für das Natural IMS TM Interface

#### Search Results

Search

# IMSPE - Umgebungsparameter für das Natural IMS TM Interface

Dieser Natural-Profilparameter kann nur im Makro `NTIMSPE` angegeben werden. Die dynamische Parameterangabe ist noch nicht möglich.

Das Makro `NTIMSPE` dient zur Definition von umgebungsspezifischen Parametergruppen, die zu Transaktionsdefinitionen zugewiesen werden können (Schlüsselwort-Subparameter `ENVPID` im Makro `NTIMSPT`).

Anmerkung
Sie können im Natural-Parametermodul nur dann ein `NTIMSPE`-Makro definieren, wenn das Modul bereits mindestens ein `NTIMSPT`-Makro enthält. Andernfalls tritt ein Assemblierungsfehler auf, wenn Sie versuchen, das Modul zu assemblieren.

Mögliche Werte | Siehe unten.
Standard-Einstellung | Siehe unten.
Dynamische Angabe | nein
Angabe innerhalb der Session | nein

Dieses Dokument behandelt folgende Themen:

- NTIMSPE-Makro-Syntax

- Schlüsselwort-Subparameter

- Beispiel für NTIMSPE-Makro

## NTIMSPE-Makro-Syntax

Das Makro `NTIMSPE` wird wie folgt angegeben:

             NTIMSPE ACTACTV=value,                                        *
                   ACTAHDR=value,                                          *
                   ACTARID=value,                                          *
                   ACTLOG=value,                                           *
                   BMPABER=value,                                          *
                   BROACTV=value,                                          *
                   CMBSIZE=value,                                          *
                   COLPSCR=value,                                          *
                   ENDMODN=value,                                          *
                   ENTRYNM=value,                                          *
                   ERRLHDR=value,                                          *
                   HCBSIZE=value,                                          *
                   HDENSDU=value,                                          *
                   LINPSCR=value,                                          *
                   MISIZE=value,                                           *
                   MONACTV=value,                                          *
                   MOSIZE=value,                                           *
                   PRTDRIV=value,                                          *
                   ROLLSRV=value,                                          *
                   ROLLFN=value,                                           *
                   SPASIZE=value,                                          *
                   SPATID=value,                                           *
                   SUPNONC=value,                                          *
                   TERMIPL=value,                                          *
                   THBELOW=value,                                          *
                   THSIZE=value,                                           *
                   USERID=value

See Keyword Subparameters.

## Schlüsselwort-Subparameter

`ACTACTV` | `ACTAHDR` | `ACTARID` | `ACTLOG` | `BMPABER` | `BROACTV` | `CMBSIZE` | `COLPSCR` | `ENDMODN` | `ENTRYNM` | `ERRLHDR` | `HCBSIZE` | `HDENSDU` | `LINPSCR` | `MISIZE` | `MONACTV` | `MOSIZE` | `PRTDRIV` | `ROLLSRV` | `ROLLFN` | `SPASIZE` | `SPATID` | `SUPNONC` | `TERMIPL` | `THBELOW` | `THSIZE` | `USERID`

### ACTACTV - Abrechnung aktivieren

Dieser Schlüsselwort-Subparameter gilt nur in dialog-orientierten Umgebungen.

`ACTACTV=value` gibt an, ob die Abrechnungsfunktion ("Accounting") aktiviert ist.

Wert | Erklärung
--- | ---
`ON` | Bei jeder Terminal-Ein-/Ausgabe wird ein Abrechnungsdatensatz geschrieben.
`OFF` | Es wird kein Abrechnungsdatensatz geschrieben. Dies ist der Standardwert.

### ACTAHDR - Vorsatz für Abrechnungsdatensätze

Dieser Schlüsselwort-Subparameter gilt nur für die Abrechnungsfunktion.

`ACTAHDR=value` definiert den Vorsatz für die Abrechnungsdatensätze, falls diese in die IMS-Protokolldatei ("Log File") geschrieben werden. Dieser Schlüsselwort-Subparameter wird nur ausgewertet, wenn der Schlüsselwort-Subparameter `ACTLOG` auf `CMD` gesetzt ist.

Wert | Erklärung
--- | ---
1 - 8 Zeichen | Ein Vorsatz-Name.
`SAG$$$$$` | Dies ist der Standardwert.

### ACTARID - Abrechnungsdatensatzkennung

Dieser Schlüsselwort-Subparameter gilt nur für die Abrechnungsfunktion (Accounting).

`ACTARID=value` gibt die Abrechnungsdatensatzkennung an, wenn der Abrechnungsdatensatz unter Verwendung der Einstellungen `LOG` oder `SMF` des Schlüsselwort-Subparameters `ACTLOG` geschrieben wird.

Wert | Erklärung
--- | ---
`A0 - FF` | Der Protokollschlüssel, wenn `ACTLOG` auf `LOG` gesetzt ist.
`128 - 255` | Die Nummer des SMF-Datensatztyps, wenn `ACTLOG` auf `SMF` gesetzt ist.

Anmerkung
Es gibt keinen Standardwert.

### ACTLOG - Abrechnungsdatensätze in Protokolldatei schreiben

Dieser Schlüsselwort-Subparameter gilt nur für die Abrechnungsfunktion (Accounting).

`ACTLOG=value` gibt an, wohin die Abrechnungsdatensätze geschrieben werden.

Wert | Erklärung
--- | ---
`CMD` | Die Abrechnungsdatensätze werden unter Verwendung des `CMD`-Aufrufs in die IMS-Protokolldatei geschrieben. Dies ist der Standardwert.
`LOG` | Die Abrechnungsdatensätze werden unter Verwendung des `LOG`-Aufrufs in die IMS-Protokolldatei geschrieben.
`SMF` | Die Abrechnungsdatensätze werden nach SMF geschrieben, und zwar unter Verwendung des Authorized Services Manager (siehe TP Monitor Interfaces-Dokumentation).

### BMPABER - Fehler für Beendigung eines BMP-Laufs

`BMPABER=value` gibt an, wie ein BMP-Lauf beendet werden soll, falls entweder ein Natural-Laufzeitfehler oder ein nicht korrigierbarer Natural IMS TM Interface-Fehler auftritt.

Wert | Erklärung
--- | ---
`ON` | Der BMP-Lauf wird mit dem Benutzer-Abbruchschlüssel U3521 beendet.
`OFF` | Der BMP-Lauf wird normal beendet, wobei der Natural-Beendigungsfehler als Bedingungsschlüssel verwendet wird. Falls der BMP-Lauf mit einem nicht rekonstruierbaren Natural IMS TM Interface-Fehler beendet wird, wird der Bedingungsschlüssel 1024 gesetzt. Dies ist der Standardwert.

### BROACTV - Rundspruch-Nachrichtenfunktion aktivieren/deaktivieren

Dieser Schlüsselwort-Subparameter gilt nur in dialog-orientierten Umgebungen.

`BROACTV=value` aktiviert bzw. deaktiviert die allgemeine Rundspruch-Nachrichtenfunktion ("Broadcasting").

Wert | Erklärung
--- | ---
`ON` | Die Rundspruch-Nachrichtenfunktion ist aktiviert.
`OFF` | Die Rundspruch-Nachrichtenfunktion ist deaktiviert. Dies ist der Standardwert.

### CMBSIZE - Befehlspuffergröße

`CMBSIZE=value` gibt die Größe des Befehlspuffers an.

Der Befehlspuffer wird benutzt von den Anwendungsprogrammierschnittstellen (APIs) `NIICMD` und `NIIGCMD`, dem Service-Modul `CMCMMND` und der Abrechnungsfunktion. Weitere Informationen siehe TP Monitor Interfaces-Dokumentation.

Der Befehlspuffer muss groß genug sein, um die Maximallänge der zu verarbeitenden IMS-Befehle und die Maximallänge des Abrechnungsdatensatzes einschließlich der Benutzer-Erweiterung aufnehmen zu können.

Wert | Erklärung
--- | ---
`100 – 16777216` | Puffergröße in KB.
`1024` | Dies ist der Standardwert.

### COLPSCR - Anzahl der Bildschirmspalten

`COLPSCR=value` gibt die Anzahl der Spalten pro Bildschirm an.

Wert | Erklärung
--- | ---
`35 – 250` | Bildschirmbreite.
`80` | Dies ist der Standardwert.

### ENDMODN - Format des Beendigungsbildschirms

`ENDMODN=value` gibt den `MOD name` an, der zum Formatieren des Bildschirms benutzt wird, welcher nach erfolgreicher Beendigung einer Natural-Session erscheint.

`ENDMODN` ermöglicht es, Natural in ein kundenspezifisches Menü aufzunehmen.

Der Wert von `ENDMODN` kann durch die Anwendungsprogrammierschnittstelle (API) `NIIEMOD` und das Service-Modul `CMEMOD` überschrieben werden. Weitere Informationen siehe TP Monitor Interfaces-Dokumentation.

Wenn Natural mit einem Fehler beendet wird, wird standardmäßig der Wert `DFSMO2` zur Ausgabe der entsprechenden Natural-Fehlermeldung benutzt.

Wert | Erklärung
--- | ---
1 - 8 Zeichen | Ein gültiger `MOD name`.
`DFSMO2` | Dies ist der Standardwert.

### ENTRYNM - Aktuellen umgebungsspezifischen Parametersatz ermitteln

`ENTRYNM=value` ermittelt den aktuellen umgebungsspezifischen Parametersatz.

Wert | Erklärung
--- | ---
1 - 8 Zeichen | Der Name des zurzeit benutzten umgebungsspezifischen Parametersatzes.
`ENV00000` | Dies ist der Standardwert.

### ERRLHDR - Vorsatz für IMS TM-Fehlerprotokolle

`ERRLHDR=value` gibt den Vorsatz für IMS TM-Protokolldatensätze an, die bei Auftreten von Fehlern im Natural IMS TM Interface geschrieben werden.

Wenn Sie nicht wollen, dass im Falle eines nicht korrigierbaren Natural IMS TM Interface-Fehlers eine Meldung in das IMS TM-Protokoll geschrieben wird, setzen Sie den Subparameter `ERRLHDR` auf Null, d.h., geben Sie `ERRLHDR=,` an.

Weitere Informationen siehe Recovery Handling in der TP Monitor Interfaces-Dokumentation.

Wert | Erklärung
--- | ---
1 - 8 Zeichen | Name eines Vorsatzes.
`NIIERR$$` | Dies ist der Standardwert.

### HCBSIZE - Größe des Hardcopy Print-Puffers

`HCBSIZE=value` gibt die Größe des Puffers für gedruckte Maschinenausgaben an.

Datensätze, die unter Benutzung der Natural Hardcopy-Funktion an ein Druckerziel gesendet werden, werden zwischengespeichert.

Wert | Erklärung
--- | ---
`0 – 16777216` | Puffergröße in KB.
`1024` | Dies ist der Standardwert.

### HDENSDU - High-Density Dump

`HDENSDU=value` gibt an, ob ein durch einen Natural IMS TM Interface-Fehler veranlasster Hauptspeicherteilauszug ("Snap Dump"") als hoch verdichteter Hauptspeicherauszug auf ein Drucksubsystem 3800 geschrieben werden soll.

Wert | Erklärung
--- | ---
`ON` | Es wird ein hoch verdichteter Hauptspeicherauszug geschrieben.
`OFF` | Es wird kein hoch verdichteter Hauptspeicherauszug geschrieben. Dies ist der Standardwert.

### LINPSCR - Anzahl der Bildschirmzeilen

`LINPSCR=value` definiert die Anzahl der Zeilen pro Bildschirm.

Wert | Erklärung
--- | ---
`1 – 250` | Bildschirmgröße.
`24` | Dies ist der Standardwert.

### MISIZE - Puffergröße für Eingabenachricht

`MISIZE=value` gibt die Größe des Puffers an, der die Eingabenachricht aufnehmen soll.

Dieser Bereich muss so groß sein wie die längste von IMS TM zu empfangende Eingabenachricht.

Wert | Erklärung
--- | ---
`100 – 16777216` | Puffergröße in KB.
`4096` | Dies ist der Standardwert.

### MONACTV - Monitoring-Funktion aktivieren/deaktivieren

Dieser Schlüsselwort-Subparameter gilt nur in dialog-orientierten Umgebungen.

`MONACTV=value` aktiviert bzw. deaktiviert die Überwachungsfunktion. Bei aktivierter Funktion wird der Status der Session bei jeder Terminal-Ein-/Ausgabe auf den SIP Server geschrieben. Bei deaktivierter Funktion wird kein Session-Status unterstützt.

Wert | Erklärung
--- | ---
`ON` | Die Überwachungsfunktion ist aktiviert.
`OFF` | Die Überwachungsfunktion ist deaktiviert. Dies ist der Standardwert.

### MOSIZE - Puffergröße für Ausgabenachricht

`MOSIZE=value` gibt die Größe des Puffers an, der die Ausgabenachricht aufnehmen soll.

Dieser Bereich muss so groß sein wie die längste an IMS TM zu sendende Ausgabenachricht.

Wert | Erklärung
--- | ---
`2048 - 16777216` | Puffergröße in KB.
`4096` | Dies ist der Standardwert.

### PRTDRIV - Treiber für IMS TM-Drucker

`PRTDRIV=value` gibt den Druckertreiber an, der für Berichte benutzt werden soll, die direkt auf einen IMS TM-Drucker geschrieben werden.

Weitere Informationen siehe Support of the Natural WRITE (n) Statement in der TP Monitor Interfaces-Dokumentation.

Wert | Erklärung
--- | ---
`driver-name` | Name eines Treibers, der in einer der folgenden Tabellen aufgeführt ist: Treiber für SCS-Drucker Treiber für SCS-Drucker Treiber für JES API
`SCS_S2` | Dies ist der Standardwert.

> Treiber für SCS-Drucker

>   Treiber | Verwendungszweck
>   --- | ---
>   `SCS_B1` | Formularvorschub am Anfang und Ende des Berichts, Seitenanfang in Zeile 1.
>   `SCS_B2` | Formularvorschub am Anfang und Ende des Berichts, Seitenanfang in Zeile 2.
>   `SCS_E1` | Formularvorschub am Ende des Berichts, Seitenanfang in Zeile 1.
>   `SCS_E2` | Formularvorschub am Ende des Berichts, Seitenanfang in Zeile 2.
>   `SCS_N1` | Kein Formularvorschub am Anfang oder Ende des Berichts, Seitenanfang in Zeile 1.
>   `SCS_N2` | Kein Formularvorschub am Anfang oder Ende des Berichts, Seitenanfang in Zeile 2.
>   `SCS_S1` | Formularvorschub am Anfang des Berichts, Seitenanfang in Zeile 1.
>   `SCS_S2` | Formularvorschub am Anfang des Berichts, Seitenanfang in Zeile 2.

> Treiber für Nicht-SCS-Drucker

>   Treiber | Verwendungszweck
>   --- | ---
>   `NSCS_B1` | Formularvorschub am Anfang und Ende des Berichts, Seitenanfang in Zeile 1.
>   `NSCS_B2` | Formularvorschub am Anfang und Ende des Berichts, Seitenanfang in Zeile 2.
>   `NSCS_E1` | Formularvorschub am Ende des Berichts, Seitenanfang in Zeile 1.
>   `NSCS_E2` | Formularvorschub am Ende des Berichts, Seitenanfang in Zeile 2.
>   `NSCS_N1` | Kein Formularvorschub am Anfang oder Ende des Berichts, Seitenanfang in Zeile 1.
>   `NSCS_N2` | Kein Formularvorschub am Anfang oder Ende des Berichts, Seitenanfang in Zeile 2.
>   `NSCS_S1` | Formularvorschub am Anfang des Berichts, Seitenanfang in Zeile 1.
>   `NSCS_S2` | Formularvorschub am Anfang des Berichts, Seitenanfang in Zeile 2.

> Treiber für JES API

>   Treiber | Verwendungszweck
>   --- | ---
>   `JES` | Die folgenden Optionen für die Verarbeitung von Datasets für JES werden von den enstprechenden `NTPRINT`-Makro-Parametern oder den Optionen des Statements `DEFINE PRINTER` (siehe Statements-Dokumentation) übernommen:
>   `JES` | `NTPRINT` | `DEFINE PRINTER`
>   `CLASS` | `CLASS` | `CLASS`
>   `COPIES` | `COPIES` | `COPIES`
>   `DEST` | `DEST` | `OUTPUT`
>   `FORMS` | `FORMS` | `FORMS`
>   `NAME` | `NAME` | `NAME`
>   `OUTDISP` | `DISP` | `DISP`
>   `PRTY` | `PRTY` | `PRTY`
>   Die generierte JES API-Parameter-Zeichenkette lautet:
>       IAFP=A0M,PRTO=..OUTDI(disp),DES(dest),
>       CLA(class,COP(copies),
>       FORMS(forms),NAME(name),
>       PRTY(prty)
>   Anmerkung Nicht angegebene `NTPRINT`-Makro-Parameter bzw. `DEFINE PRINTER`-Statement-Optionen werden ignoriert.
>   JES xxxxx | Die Optionen für die Verarbeitung von Datasets für JES werden vom `OUTPUT JCL`-Statement mit dem Namen `JESxxxxx` übernommen. Dabei kann `xxxxx` bis zu 5 Zeichen lang sein. Die generierte JES API-Parameter-Zeichenkette lautet:
>       IAFP=A0M,OUTN=JESxxxxx
>   Das `OUTPUT JCL`-Statement folgendenmaßen aussehen:
>       JESxxxxx OUTPUT OUTDISP=WRITE,DEST=dest,
>       CLASS=A,COPIES=1,FORMS=form,...
>   Anmerkung Falls im Jobstrom kein `OUTPUT JCL`-Statement existiert, wird ein Fehler gemeldet.

### ROLLSRV - Natural-Thread-Speicherung

Dieser Schlüsselwort-Subparameter gilt nur in dialog-orientierten Umgebungen.

`ROLLSRV=value` gibt das Speichermedium an, auf dem ein Natural-Thread zwischen Terminal-Ein- und Ausgabe aus- bzw eingespeichert werden soll.

Siehe auch Roll File and Roll Server in der TP Monitor Interfaces-Dokumentation.

Wert | Erklärung
--- | ---
`ON` | Es wird der Natural Roll Server benutzt. Dies ist der Standardwert.
`OFF` | Es werden Dateien ("Roll Files)") zum Aus- und Einspeichern benutzt, siehe `ROLLFN`.

### ROLLFN - Anzahl der Roll Files

Dieser Schlüsselwort-Subparameter gilt nur in dialog-orientierten Umgebungen.

`ROLLFN=value` gibt die Anzahl der Dateien ("Roll Files)") an, die zum Aus- und Einspeichern eines Natural-Thread benutzt werden sollen, wenn der Subparameter `ROLLSRV` auf `OFF` gesetzt ist.

Wert | Erklärung
--- | ---
`1 - 5` | Anzahl der zu benutzenden Dateien.
`1` | Dies ist der Standardwert.

### SPASIZE - Puffergröße für Scratch-Pad

Dieser Schlüsselwort-Subparameter gilt nur in dialog-orientierten Umgebungen.

`SPASIZE=value` gibt die Größe des Puffers an, der den Scratch-Pad-Bereich ("Scratch Pad Area", SPA) enthalten soll.

In einer nicht-konversationellen Umgebung ist dies ebenfalls die Größe des simulierten SPA, der auf den SIP Server geschrieben wird.

Wert | Erklärung
--- | ---
`256 - 16777216` | Puffergröße in KB.
`1024` | Dies ist der Standardwert.

### SPATID - Subsystem ID für ASM

`SPATID=value` gibt die Natural-Subsystemkennung für den Authorized Services Manager (ASM) an, der benutzt wird, um den Scratch-Pad-Bereich ("Scratch Pad Area", SPA) für einen nicht-konversationellen Treiber zu speichern. Der ASM wird in der Operations-Dokumentation beschrieben.

Wert | Erklärung
--- | ---
1 - 4 Zeichen | Subsystemkennung. Dieser Wert muss bei allen Parametertabellen gleich sein und muss mit dem Wert übereinstimmen, der für `SPATID` im Makro `NIMPIXT` angegeben ist (siehe TP Monitor Interfaces-Dokumentation).
`NAT2` | Dies ist der Standardwert.

### SUPNONC - Umgebungsumschaltung ermöglichen

Dieser Schlüsselwort-Subparameter gilt nur in dialog-orientierten konversationellen Umgebungen.

`SUPNONC=value` gibt an, ob das Umschalten von einer terminalorientierten auf eine konversationelle Umgebung möglich ist oder nicht.

Wert | Erklärung
--- | ---
`ON` | Das Umschalten ist gestattet.
`OFF` | Das Umschalten ist nicht gestattet. Dies ist der Standardwert.

### TERMIPL - Session-Beendigung bei IPL

Dieser Schlüsselwort-Subparameter gilt nur in dialog-orientierten Umgebungen.

`TERMIPL=value` gibt an, ob die Natural-Session mit einer Fehlermeldung beendet wird, wenn ein Initial Program Load (IPL) zwischen dem aktuellen Transaktionsschritt und dem Beginn der Session aufgetreten ist.

Wert | Erklärung
--- | ---
`ON` | Die Natural-Session wird beendet.
`OFF` | Die Natural-Session wird nicht beendet. Dies ist der Standardwert.

### THBELOW - Natural-Thread-Zuweisung

`THBELOW=value` gibt an, ob der Natural-Thread unterhalb oder oberhalb der 16 MB-Grenze zugewiesen wird.

Wert | Erklärung
--- | ---
`ON` | Der Natural-Thread wird unterhalb der 16 MB-Grenze zugewiesen. Dies ist der Standardwert.
`OFF` | Der Natural-Thread wird oberhalb der 16 MB-Grenze zugewiesen.

### THSIZE - Natural-Thread-Größe

`THSIZE=value` gibt die Größe des Natural-Thread an. Dies ist der Bereich, welcher alle Natural-Puffer enthält, die einen Bezug zur Benutzersitzungen haben.

Wert | Erklärung
--- | ---
`100000 - 99999999` | Eine Thread-Größe, die ein Vielfaches von 8 und größer als oder gleich 100000 ist.
`1048576` | Dies ist der Standardwert.

### USERID - Wert von *INIT-USER festlegen

Dieser Schlüsselwort-Subparameter gilt nur für den BMP-Treiber.

`USERID=value` gibt an, wie der Wert der Systemvariablen `*INIT-USER` (siehe Systemvariablen-Dokumentation) bestimmt wird.

Wert | Erklärung
--- | ---
`ON` | Die Natural-Benutzerkennung, die in der Systemvariablen `*INIT-USER` enthalten ist, wird entweder vom Security-Zugangskontrollblock (falls ein Security-Software-Paket aktiv ist) oder vom Parameter `USER` der Jobkarte übernommen.
`OFF` | Die Natural-Benutzerkennung, die in der Systemvariablen `*INIT-USER` enthalten ist, wird vom Jobnamen übernommen. Dies ist der Standardwert.

## Beispiel für NTIMSPE-Makro

             NTIMSPE ENTRYNM=ENV0021,                                      *
                   ACTACTV=ON,                                             *
                   ACTLOG=LOG,                                             *
                   ACTARID=A1,                                             *
                   PRTDRIV=SCS_E1,                                         *
                   THBELOW=OFF,                                            *
                   THSIZE=1000000,                                         *
                   SPATID=ASM1

### On this page

- NTIMSPE-Makro-Syntax
- Schlüsselwort-Subparameter
- Beispiel für NTIMSPE-Makro