Natural-CICS-Generierungsparameter

#### Search Results

Search

# Natural-CICS-Generierungsparameter

In diesem Kapitel werden die Natural CICS-Generierungsparameter beschrieben. Folgende Themen werden behandelt:

- NCISCPCB-Generierungsparameter

- NCMDIR-Makro-Parameter

- NCMTGD-Makro-Parameter

- NTCICSP-Makro-Parameter

Die zum Starten von Natural CICS verwendeten Parameter finden Sie im Abschnitt CICS Startup Parameters in Installing Natural CICS Interface on z/OS in der Natural Installation-Dokumentation.

#### Verwandte Themen:

- Installing Natural CICS Interface on z/OS in der Natural-Installation-Dokumentation.

- SYSTP Utility - ein Natural-Dienstprogramm, das verschiedene TP-Monitor-spezifische Funktionen bereitstellt.

- Informationen zum Betrieb und zu den einzelnen Komponenten von Natural in einer CICS-Umgebung finden Sie in den folgenden Kapiteln der vorliegenden Natural unter CICS-Dokumentation:

## NCISCPCB-Generierungsparameter

Das Systemverzeichnis der Natural CICS-Schnittstelle wird durch Assemblieren und Verlinken des Quellcodemoduls `NCISCPCB` erzeugt; siehe den entsprechenden Schritt in Installing Natural CICS Interface on z/OS in der Natural-Installation-Dokumentation.

`NCISCPCB` enthält die folgenden Makros:

- `NCMDIR`

- `NCMTGD`

Der Zweck dieser Makros und die einzelnen Parameter, die in diesen Makros angegeben werden können, werden in den folgenden Abschnitten beschrieben.

## NCMDIR-Makro-Parameter

Das Makro `NCMDIR` ist zwingend erforderlich und muss als erstes Makro im `NCISCPCB`-Quellcodemodul angegeben werden. Es enthält verschiedene Optionen für das System. Die einzelnen Parameter, die im `NCMDIR`-Makro angegeben werden können, werden im Folgenden beschrieben.

`CICSPLX` | `ROLLSRV` | `SIPSERV` | `SUBSID` | `TSKEY` | `TSRECSZ` | `USERS`

### CICSPLX - Wechsel der CICS-Anwendungsregion

Mögliche Werte:

Wert | Erläuterung
--- | ---
`YES` | Die Natural CICS-Schnittstelle bewahrt alle sitzungsrelevanten Daten wie die Session Information Records (SIRs) und die Sitzungsdaten über eine pseudokonversationelle Bildschirm-Ein-/Ausgabe außerhalb einer lokalen CICS Application Owning Region (AOR) und ermöglicht so den Wechsel von CICS AORs. Wird dieser Parameter auf `YES` gesetzt, muss außerdem der Profilparameter `ADAMODE` auf einen Wert größer `0` gesetzt werden.
`MODE` | Diese Einstellung hat nahezu die gleiche Bedeutung wie `YES`. Die einzige Ausnahme ist, dass `CICSPLX=MODE` die Angabe des Profilparameters `ADAMODE=0` erlaubt, d.h. ein CICS-AOR-Wechsel ist nicht möglich, aber eine Natural-Session kann den Neustart eines CICS-AOR in einer MRO-Umgebung überdauern.
`NO` | Kritische Natural-Sitzungsdaten werden im lokalen CICS-AOR aufbewahrt, wodurch der CICS-AOR-Wechsel faktisch deaktiviert wird. Dies ist der Standardwert.

Natural-PLEX-Unterstützung bedeutet, dass eine Natural CICS-Sitzung am Ende einer CICS-Task alle in einer CICS-Anwendungsregion von ihr hinterlassenen Spuren beseitigt, da sie möglicherweise nie wieder in diese Region zurückkehrt. Daher müssen alle für eine Natural CICS-Sitzung relevanten Daten außerhalb einer CICS-Anwendungsregion gehalten werden, d.h. Natural unter CICS übergibt am Ende der CICS-Task seine Sitzungsinformationsdatensätze (SIRs) an den SIP-Handler des Authorized Services Manager und die Sitzungsdaten an den Natural Roll Server. Darüber hinaus müssen alle "gehaltenen" Module, d.h. Module, die nicht mit Natural verlinkt sind, sondern direkt über Standard-Linkage-Konventionen wie RCA-Module oder das Adabas-Linkage-Modul aufgerufen werden, am CICS-Task-Ende freigegeben werden. Außerdem muss die Neustart-Information im Falle von `COMARET=YES` in einer CICS Terminal Owning Region (TOR) oder im Falle von `COMARET=NO` in einer CICS Data Owning Region (DOR), die von allen teilnehmenden CICS-AORs gemeinsam genutzt wird, aufbewahrt werden. Einzelheiten siehe Parameter `COMARET`.

Wurde `YES` oder `MODE` angegeben und der Parameter `SUBSID` im Makro `NCMDIR` nicht gesetzt wurde, wird der Wert des Natural-Profilparameters `SUBSID` genommen, der für die Natural-Sitzung gilt, die die NCI-Umgebung initialisiert.

| Warnung: Wird dieser Parameter auf `YES` oder `MODE` setzen, so werden automatisch die Parameter `SIPSERV` und `ROLLSRV` auf `YES` gesetzt.

### ROLLSRV - Roll Server als Roll Facility

Mögliche Werte:

Wert | Erläuterung
--- | ---
`NO` | Dies ist der Standardwert, wenn `CICSPLX=NO` und `SIPSERV=NO`. Wenn `CICSPLX` oder `SIPSERV` `YES` ist, wird `ROLLSRV=YES` erzwungen.
`YES` | Die Angabe von `YES` bewirkt, dass die Natural CICS-Schnittstelle als Roll Facility nur den Natural Roll Server verwendet.

Wenn der Natural Roll Server zum Sichern und Wiederherstellen der Natural-Sitzungsdaten über eine Bildschirm-Ein-/Ausgabe hinweg verwendet werden soll, muss dieser Parameter auf `YES` gesetzt werden, wenn die Parameter `CICSPLX` und `SIPSERV` beide auf `NO` gesetzt sind. Wenn `YES` angegeben (oder erzwungen) wurde und der Parameter `SUBSID` im Makro `NCMDIR` nicht gesetzt wurde, wird der Wert des Natural-Profilparameters `SUBSID` übernommen, der für die die NCI-Umgebung initialisierende Natural-Sitzung gilt.

Beachten Sie, dass der Natural-Profilparameter `SUBSID` für die Zwecke der Natural CICS-Schnittstelle nur berücksichtigt wird, wenn er dynamisch oder im Natural-Parametermodul angegeben ist. Er wird ignoriert, wenn er in einem Parameterstring durch den Profilparameter `SYS` oder `PROFILE` oder in einem alternativen, mit dem Profilparameter `PARM` definierten Parametermodul angegeben ist.

Weitere Informationen zur Wahl zwischen Natural Roll Server und von der Natural CICS-Schnittstelle unterstützte Roll Files, siehe Wahl zwischen Roll Server und Roll Facilities und Auswahl der Roll Facility.

### SIPSERV - Session Information Pool des Authorized Services Manager

Mögliche Werte:

Wert | Erläuterung
--- | ---
`NO` | Bei `CICSPLX=NO` ist dies der Standardwert. Wenn `CICSPLX` nicht auf `NO` gesetzt ist, wird `SIPSERV=YES` erzwungen.
`YES` | Bewirkt, daß die Natural CICS-Schnittstelle ihre Session Information Records (SIRs) im Session Information Pool des Authorized Services Manager speichert.

Wenn dieser Parameter auf `YES` gesetzt ist oder wenn `YES` erzwungen wird, werden die Natural-Session-Information-Records außerhalb einer CICS-Region aufbewahrt, so dass Natural eine CICS-Anwendungsregion nach einer pseudo-konversationellen Bildschirm-Ein-/Ausgabe wechseln kann.

Wenn `YES` angegeben (oder erzwungen) wird und der Parameter `SUBSID` im Makro `NCMDIR` nicht gesetzt wurde, wird der Wert des Natural-Profilparameters `SUBSID` verwendet, der für die die NCI-Umgebung initialisierende Natural-Sitzung gilt.

Beachten Sie, dass für die Zwecke der Natural CICS-Schnittstelle der Natural-Profilparameter `SUBSID` nur dann berücksichtigt wird, wenn er dynamisch oder im Parametermodul angegeben ist. Er wird ignoriert, wenn er in einem Parameterstring durch den Profilparameter `SYS` oder `PROFILE` oder in einem (mit dem Profilparameter `PARM` definierten) alternativen Parametermodul angegeben ist.

| Warnung: Wenn `YES` für diesen Parameter wirksam ist, wird der `ROLLSRV`-Parameter zwangsweise auf `YES` gesetzt, sofern er nicht bereits entsprechend gesetzt ist.

### SUBSID - Subsystemkennung

Mögliche Werte:

Wert | Erläuterung
--- | ---
`xxxx` | Definiert die Subsystemkennung für den Natural Roll Server und/oder für den Authorized Services Manager.

Dieser Parameter definiert die Natural-Subsystemkennung, die für den Natural Roll Server und/oder für den Authorized Services Manager verwendet werden soll. Wird dieser Parameter nicht angegeben, so wird der Wert des Natural-Profilparameters `SUBSID` genommen.

Beachten Sie, dass für die Zwecke der Natural CICS-Schnittstelle der Natural-Profilparameter `SUBSID` nur dann berücksichtigt wird, wenn er dynamisch oder im Parametermodul angegeben ist. Er wird ignoriert, wenn er in einem Parameterstring durch den Profilparameter `SYS` oder `PROFILE` oder in einem (mit dem Profilparameter `PARM` definierten) alternativen Parametermodul angegeben ist.

### TSKEY - Präfixe für Natural CICS-Zwischenspeicherschlüssel

Dieser Parameter definiert die konstanten Präfixe der Zwischenspeicherwarteschlangen (Temporary Storage Queues). Erläuterung siehe unten.

Dieser Parameter hat die gleiche Bedeutung wie der Parameter `TSKEY` im Modul `NCIZNEP` (siehe Natural-Installation-Dokumentation) und muss identisch angegeben werden.

Mögliche Werte:

Wert | Erläuterung
--- | ---
`(xxxx,yyyy)` | `xxxx` definiert das Präfix für Roll-Daten, während `yyyy` das Präfix für pseudo-konversationelle Restart-Daten definiert.
`(NAT2,NCOM)` | Dies ist der Standardwert.

Wenn der CICS-Zwischenspeicher (Haupt- oder Hilfsspeicher) für die Roll Facility der Natural-CICS-Schnittstelle oder für den Kommunikationsbereich für pseudokonversationelle Natural-Tasks (wie beim Parameter `COMARET` des Makros NTCICSP beschrieben) verwendet werden soll, müssen Namen für Warteschlangen des Task-abhängigen spezifischen Zwischenspeichers angegeben werden.

Diese Warteschlangennamen bestehen aus einem konstanten 4-Byte-Schlüssel und einem Task-bezogenen Schlüssel. Bei terminalabhängigen Tasks entspricht dieser Task-bezogene Schlüssel der Terminalkennung, bei asynchronen Nicht-Terminal-Tasks entspricht er der eindeutigen CICS-Task-Nummer (CICS Unique Task Number). Das konstante Präfix der temporären Speicherwarteschlangennamen wird durch den Parameter `TSKEY` definiert.

Die Natural CICS-Schnittstelle erfordert zwei 4-Byte-Präfixe: eines für Ein-/Auspeicherungsdaten (Roll Data) und eines für pseudo-konversationelle Neustart-Daten (Restart Data). `xxxx` definiert das Präfix für Ein-/Auspeicherungsdaten, `yyyy` definiert das Präfix für pseudo-konversationelle Restart-Daten. Die beiden Präfixe müssen sich voneinander unterscheiden und für Natural unter CICS exklusiv sein.

Wenn Sie in einer CICSplex-Umgebung arbeiten, muss das CICS-Präfix für den temporären Speicher für Natural-Sitzungsneustartinformationen in einem CICS-TST als `REMOTE/SHARED` definiert werden, um in allen beteiligten CICS-Regionen zugänglich zu sein.

### TSRECSZ - Satzgrößen für Haupt- und Hilfszwischenspeicher

Dieser Parameter legt die maximale Satzlänge für das Aus-/Einpeichern (Rolling) von Daten fest, wenn der CICS-Zwischenspeicher als Natural CICS Interface Roll Facility verwendet werden soll.

Mögliche Werte:

Wert | Erläuterung
--- | ---
`(nnnnn,mmmmm)` | Der erste Subparameter `nnnnn` gilt für den CICS-Hauptzwischenspeicher und muss im Bereich von `4096` bis `32763` oder `0` liegen oder eines der Schlüsselwörter `MAX`, `YES` oder `NO` sein: Wenn der Wert numerisch und nicht Null ist, wird er ohne Bedingungen verwendet. Wenn der Wert auf `0` oder `NO` gesetzt ist, kann der CICS-Hauptzwischenspeicher nicht für eine Natural Roll Facility verwendet werden. Wenn der Wert auf `MAX` oder `YES` gesetzt ist, wird eine Datensatzgröße von `32763` verwendet. Der zweite Subparameter `mmmmm` gilt für den CICS-Hilfszwischenspeicher und muss im Bereich von `3976` bis `32763` oder `0` liegen oder eines der Schlüsselwörter `MAX`, `YES` oder `NO` sein: Wenn der Wert numerisch und nicht Null ist, wird er ohne Bedingungen verwendet. Wenn er auf `MAX` gesetzt ist, wird eine Datensatzgröße von `32763` genommen. Wenn er auf `NO` gesetzt ist, kann der CICS-Zwischenspeicher nicht für eine Natural Roll Facility verwendet werden. Wenn dieser Wert auf `0` oder `YES` gesetzt ist, legt die Natural CICS-Schnittstelle die Satzlänge fest, die in ein Kontrollintervall des Zwischenspeichers passt, d.h. CI-Größe minus VSAM-Kontrollinformationen minus CICS-Kontrollinformationen. Eine benutzerdefinierte Satzgröße, die größer ist als die CI-Größe, führt zu weniger (logischen) Ein-/Ausspeicherungs-Operationen (Roll In/Out) auf Kosten des zusätzlichen CICS-Aufwands durch das Schreiben von übergreifenden Sätzen.
`(32748,0)` | Dies ist der Standardwert.

### USERS - Anzahl der Session Information Record Slots

Dieser Parameter gibt die Anzahl der Session Information Record Slots (SIRs) an.

Mögliche Werte:

Wert | Erläuterung
--- | ---
`(nnnnn, mmm)` | Der Subparameter `nnnnn` definiert die Anzahl der SIRs, die im Natural CICS-Verzeichnismodul selbst gehalten werden sollen. `nnnnn` muss im Bereich von `1` bis `32767` liegen. Wenn die SIR-Slots im Verzeichnis belegt sind, belegt die Natural CICS-Schnittstelle ein CICS-Shared-Storage-Segment, das groß genug ist, um die durch `mmm` definierte Anzahl von SIRs aufzunehmen, die im Bereich von `0` bis `255` liegen muss. Wenn der Subparameter `mmm` `0` ist oder weggelassen wird, belegt das System keinen zusätzlichen Speicher für SIRs, wenn kein freier SIR-Slot im Systemverzeichnis verfügbar ist. In diesem Fall ist das Natural CICS-System tatsächlich auf die durch den ersten Subparameter angegebene Anzahl von Benutzern beschränkt. Wenn für `mmm` ein anderer Wert als `0` angegeben wird, werden sekundäre Speichersegmente automatisch nach Bedarf zugewiesen. Zugewiesene Sekundärsegmente werden wieder freigegeben, wenn sie nicht mehr benötigt werden.
`(100,20)` | Dies ist der Standardwert.

Die Natural CICS-Schnittstelle speichert permanent Informationen über alle aktiven Natural-Sitzungen. Für jede Sitzung wird ein so genannter Session Information Record (SIR) geführt.

Diese SIRs werden aufbewahrt

- in einer Coupling Facility, wenn sie in einer z/OS Parallel Sysplex-Umgebung laufen;

- in einem Datenbereich des Natural Authorized Services Manager, wenn er in mehreren CICS-Regionen innerhalb eines einzelnen z/OS-Systems läuft;

- im Hauptspeicher einer CICS-Region, wenn sie in einem einzelnen CICS-AOR (lokal) ausgeführt wird.

Wenn jedoch eine Natural-Sitzung in einer CICS-Region aktiv ist, belegt sie einen SIR-Slot in der aktuellen Anwendungsregion.

Bei der lokalen Ausführung in einem einzelnen CICS-AOR gilt der Parameter `USERS` für alle Natural-Sitzungen. Bei der Ausführung in einer CICSplex-Umgebung gilt `USERS` für die Teilmenge der Natural-Sitzungen, die derzeit in jedem der beteiligten CICS-AORs aktiv ist.

## NCMTGD-Makro-Parameter

Das Makro `NCMTGD` ist zwingend erforderlich und muss für jede Thread-Gruppe angegeben werden. Bei der Natural CICS-Schnittstelle können Sie Gruppen von Threads definieren. Diese Gruppen werden bei der Sitzungsinitialisierung durch die CICS-Transaktionskennung gesteuert/ausgewählt. Die gemeinsame Thread-Größe für die verschiedenen Gruppen kann unterschiedlich sein und die Gruppen können unterschiedliche Optionen haben. Die Thread-Gruppendefinitionen sind Teil des Natural CICS-Systemverzeichnisses, da sie für das gesamte System relevant sind, nicht nur für eine einzelne Sitzung.

Die einzelnen Parameter, die in einem `NCMTGD`-Makro angegeben werden können, werden im Folgenden beschrieben.

`PFKEY` | `PRIMERF` | `THRDSZE` | `THREADS` | `TRAN` | `TYPE` | `XTRAN`

### PFKEY - PF-/PA-Tasten für Thread-Gruppe

Dieser Parameter definiert eine einzelne CICS-Transaktion oder eine Liste von Transaktionen.

Mögliche Werte:

Wert | Erläuterung
--- | ---
`xxx` | Mögliche Werte für `xxx` sind: PF1 bis PF24, PA1 bis PA3.
`(xxx,xxx,...)` | Es kann auch eine Liste von Tasten angegeben werden. Diese muss in Klammern gesetzt werden, zum Beispiel `PFKEY=(PF12, PF14)`. Ein Standardwert ist nicht vorgesehen.

Ein Standardwert ist nicht vorgesehen.

Beim Starten einer Sitzung durchsucht die Natural CICS-Schnittstelle alle Thread-Gruppendefinitionen nach der aktuellen Transaktionskennung bzw. der PF- oder PA-Taste. Wenn sie nicht gefunden wird, wird die erste Thread-Gruppe als Standardwert verwendet.

| Warnung: Für alle Gruppen mit Ausnahme der ersten Gruppe, die als Standardgruppe verwendet wird, muss mindestens eine Transaktionskennung (im Zeichen- oder Hexadezimalformat) oder eine transaktionseinleitende Achtungskennung (Attention Identifier) angegeben werden.

### PRIMERF - Primäre Roll Facility für die Natural CICS-Schnittstelle

Dieser Parameter definiert die primäre Roll Facility für die Natural CICS-Schnittstelle für alle in der zugehörigen Thread-Gruppe definierten Tasks. Daher gilt dieser Parameter nicht für Thread-Gruppen mit `TYPE``=NONE`.

Mögliche Werte:

Wert | Erläuterung
--- | ---
`VSAM` | Als primäre Roll Facility werden VSAM Natural CICS Interface VSAM RRDS Roll Files verwendet. Wenn im CICS-System kein VSAM RRDS Roll File vorhanden ist, wird `PRIMERF=AUX` wirksam. Wenn die VSAM RRDS Roll Files voll werden oder nicht verfügbar sind, gilt Folgendes: `PRIMERF=AUX` wird wirksam, wenn im CICS-System ein Hilfszwischenspeicher definiert ist. `PRIMERF=MAIN` wird wirksam, wenn im CICS-System kein Hilfszwischenspeicher definiert ist.
`AUX` | CICS-Hilfszwischenspeicher wird als primäre Roll Facility der Natural CICS-Schnittstelle genommen. Falls im CICS-System kein Hilfszwischenspeicher definiert ist, wird die Einstellung `PRIMERF=MAIN` wirksam.
`MAIN` | CICS-Hauptzwischenspeicher wird als primäre Roll Facility der Natural CICS-Schnittstelle verwendet. Die Satzgröße wird durch den Parameter `TSRECSZ` definiert. Dabei gilt Folgendes: CICS-Hauptzwischenspeicher ist Speicher, der oberhalb der Grenze zugewiesen wird. Dadurch werden VSAM-Ein-/Ausgabe-Aktivitäten und die Kommunikation mit einem Zwischenspeicher-Server vermieden. Infolgedessen ist `PRIMERF=MAIN` wesentlich schneller als `PRIMERF=AUX` und wird daher empfohlen, wenn für Natural-Sitzungen kein dynamisches Weiterleiten von Transaktionen (Transaction Routing) verwendet wird. Allerdings werden die Aus-/Einspeicherungsdaten (Roll Data) in Sätze mit einer maximalen Größe von 32 KB aufgeteilt. Die Natural CICS-Schnittstelle kann auch CICS-Speicherobjekte als Roll Facility verwenden. Speicherobjekte werden oberhalb der Grenze zugeordnet. Im Gegensatz zu `PRIMERF=MAIN` müssen die Aus-/Einspeicherungsdaten jedoch nicht aufgeteilt werden, wenn sie in ein Speicherobjekt verschoben werden. Wenn Sie Speicherobjekte verwenden möchten, geben Sie `PRIMERF=MAIN` und `MEMOBJR=ON` (Standardeinstellung) mit dem Makro `NTCICSP` an (siehe Parameter-Referenz-Dokumentation).
`NONE` | Die zugehörigen Sitzungen benutzen überhaupt keine Aus-/Einspeicherungsfunktion. `NONE` ist nicht gültig für `TYPE=SHR`-Gruppen und für Gruppen mit `TYPE=ALIAS`, die `TYPE=SHR`-Gruppen neu definieren. Sitzungen, die mit Thread-Gruppen verbunden sind, die mit `PRIMERF=NONE` definiert sind, können nicht verschoben werden, da es keine Aus-/Einspeicherungsfunktion gibt, um diese Aufgabe auszuführen. Diese Sitzungen sind daher konversationell.

Ein Standardwert ist nicht vorgesehen.

Dieser Parameter wird ignoriert, wenn Sie den Natural Roll Server verwenden. Wenn Sie eine Natural-Sitzung mit Roll Server zwangsweise konversationell ohne Aus-/Einspeicherungsfunktion laufen lassen, ist der Wert `NONE` wirksam.

Weitere Informationen zur Wahl zwischen Natural Roll Server und von der Natural CICS-Schnittstelle unterstützte Roll Files, siehe Wahl zwischen Roll Server und Roll Facilities und Auswahl der Roll Facility.

### THRDSZE - Thread-Größe

Dieser Parameter definiert die gemeinsame Thread-Größe für die Gruppen mit `TYPE``=GETM` und `TYPE=SHR`.

Mögliche Werte:

Wert | Erläuterung
--- | ---
`nnnnn` | Die Thread-Größe `nnnnn` kann im Bereich von 40 KB (Minimum) bis 65532 KB (Maximum) liegen.

Ein Standardwert ist nicht vorgesehen.

Beachten Sie, dass dieser Parameter die logische Thread-Größe definiert, die Natural zur Verfügung steht. Die Natural CICS-Schnittstelle fügt jedoch für interne Administrationszwecke weitere 2 KB zur logischen Thread-Größe hinzu. Das bedeutet, dass die physische Thread-Größe oder Länge der Thread-`GETMAIN`-Anforderung um 2 KB größer ist als der `THRDSZE`-Wert.

Bei `TYPE=GETM` sind zusätzlich 16 Bytes für die vor- und nachgelagerten CICS-Speicherabrechnungsbereiche (CICS Storage Accounting Areas, SAAs) zu berücksichtigen.

Wichtige Hinweise:

1. Bei `GETMAIN`s mit mehr als 512 KB richtet CICS diese Speicherbereiche an MB-Grenzen aus.

2. Bei Verwendung von Transaction Isolation verwendet CICS intern 1 MB "Pages" in der EUDSA (Details finden Sie im CICS Performance Guide).

Diese beiden Tatsachen führen zu Speicherfragmentierung und sollten bei der Einstellung eines geeigneten EDSALIM in CICS berücksichtigt werden.

### THREADS - Anzahl der Threads oder Tasks pro Thread-Gruppe

Dieser Parameter gibt die Anzahl der Threads oder Tasks wie unten beschrieben an.

Mögliche Werte:

Wert | Erläuterung
--- | ---
`nnn` | Die Anzahl der Threads kann gleich oder kleiner als `510` sein.

Ein Standardwert ist nicht vorgesehen.

Für Thread-Gruppen mit `TYPE``=SHR` ist der Parameter `THREADS` obligatorisch und definiert die Anzahl der Threads, die während der Installation über `GETMAIN` (SVC oder SHARED, je nach CICS-Version) zugewiesen werden sollen.

Für die Thread-Gruppen mit `TYPE=GETM` und `TYPE=NONE` ist der Parameter `THREADS` optional und bestimmt die maximale Anzahl der gleichzeitig aktiven Natural-Tasks pro Thread-Gruppe. Für diese Thread-Gruppen-Typen steuert der `THREADS`-Parameter im Gegensatz zu Thread-Gruppen mit `TYPE=SHR` nicht die Speichernutzung (siehe auch Kontrolle über die Speichernutzung).

Die Anzahl der Threads bzw. die Anzahl der Tasks pro Thread-Gruppe wird durch die Bereitstellung von Thread Control Blocks (TCBs) definiert.

Bei Thread-Gruppen mit `TYPE=SHR` ist jeder Thread eng mit seinem TCB verbunden. Die Threads werden gemeinsam genutzt, indem sie im zugehörigen TCB in eine Warteschlange gestellt werden. Thread-Gruppen mit `TYPE=GETM` und `TYPE=NONE` stellen sich nur bei einem TCB in die Warteschlange, um aktiv zu werden.

Während Sitzungen mit Thread-Gruppen mit `TYPE=SHR` miteinander um Threads konkurrieren, konkurrieren die anderen Sitzungstypen um TCBs mit einem bereits zugewiesenen Thread (T`YPE=GETM`) oder mit gar keinem zugewiesenen Thread (`TYPE=NONE`).

Wenn der Parameter `THREADS` ungleich Null ist, werden die Natural-Profilparameter `DBROLL` und `MAXROLL` sowie die Aufrufe von `CMROLL` bei `TYPE=GETM/NONE`-Thread-Gruppen anders behandelt: Da Threads nicht freigegeben werden können, wird die gehaltene TCB-Ressource freigegeben, wodurch die Sitzung mit den im Speicher gehaltenen Sitzungsdaten aktiviert wird.

### TRAN - Transaktionskennungen für Thread-Gruppe

Dieser Parameter definiert eine einzelne CICS-Transaktion oder eine Liste mit Transaktionen.

Mögliche Werte:

Wert | Erläuterung
--- | ---
(siehe unten) | Ein oder mehrere CICS-Transaktionscodes, die im PCT für Natural definiert sind.

Ein Standardwert ist nicht vorgesehen.

Der Parameter `TRAN` erwartet Transaktionskennungen im Zeichenformat. Transaktionskennungen mit nicht alphanumerischen Zeichen müssen in Hochkommata eingeschlossen werden.

Beim Starten einer Sitzung durchsucht die Natural CICS-Schnittstelle alle Thread-Gruppendefinitionen nach der aktuellen Transaktionskennung bzw. der PF- oder PA-Taste. Wenn sie nicht gefunden wird, wird standardmäßig die erste Thread-Gruppe verwendet.

Eine Liste mit Transaktionskennungen muss in Hochkommata eingeschlossen werden, zum Beispiel `TRAN=(NATU, XYZ)`.

| Warnung: Für alle Gruppen mit Ausnahme der ersten Gruppe, die als Standardgruppe verwendet wird, muss mindestens eine Transaktionskennung (im Zeichen- oder Hexadezimalformat) oder eine transaktionseinleitende Achtungskennung angegeben werden.

### TYPE - Thread-Typ für Gruppe

Dieser Parameter legt fest, welcher Thread-Typ für eine bestimmte Gruppe verwendet werden soll.

Mögliche Werte:

Wert | Erläuterung
--- | ---
`SHR` | Es werden CICS Shared Storage Threads verwendet. Die für eine Thread-Gruppe verfügbaren Threads werden von allen für diese Gruppe definierten CICS-Transaktionen gemeinsam genutzt. Die Thread-Auswahl beim Start einer CICS-Task erfolgt mittels einer ENQUEUE/DEQUEUE-Technik. Wenn derzeit kein Thread verfügbar ist, wird eine Warteschlange für diese Thread-Gruppe geführt. Dies ist der Standardwert. In einer z/OS-Parallel-Sysplex-Umgebung erzwingt der Natural-Profilparameter `RELO=OFF`, dass Sitzungen mit `TYPE=SHR`-Threads konversationell sind, um einen CICS-Regionswechsel zu verhindern.
`GETM` | Es werden über `GETMAIN` zugewiesene Threads verwendet, was bedeutet, dass ein Thread tatsächlich aufgenommen wird, indem eine CICS-`GETMAIN`-Operation - `EXEC CICS GETMAIN FLENGTH` - mit der gemeinsamen Thread-Größe der Thread-Gruppe ausgeführt wird. Bei der Verwendung von Threads, die über `GETMAIN` zugewiesen werden, steht jeder Natural-Task bis zu ihrer Beendigung exklusiver Thread-Speicher zur Verfügung, d.h. für pseudo-konversationelle Tasks von einer Bildschirm-Ein-/Ausgabe zur nächsten. Wenn der Natural-Parameter `RELO``=OFF` oder `PSEUDO``=OFF` angegeben wird, sind Tasks, die über `GETMAIN` zugewiesene Threads verwenden, gezwungen, konversationell zu sein, da nicht gewährleistet ist, dass nach einem `FREEMAIN` des Threads ein nachfolgendes `GETMAIN` denselben Speicherplatz erhält. Da der über `GETMAIN` zugewiesene Thread-Speicher jedoch ausschließlich der besitzenden Task gehört, können solche Tasks als nicht per Aus-/Einspeicherung (Rolling) verlagerbar definiert werden (siehe den Parameter `PRIMERF`), was bedeutet, dass ein bestimmter Thread bis zum Ende der Natural-Sitzung zu einer bestimmten Task gehört. In diesem Fall ist die Task von vornherein konversationell und es findet keine Aus-/Einspeicherung statt.
`NONE` | Die in dieser Thread-Gruppe definierten Transaktionen verwenden keine Threads, und alle Natural-`GETMAIN`-Anfragen werden direkt an CICS für eine `EXEC CICS-GETMAIN-FLENGTH`-Anfrage weitergeleitet. Konzeptbedingt können derartige Aufgaben nicht per Aus-/Einspeicherung (Rolling) verlagert werden und sind daher konversationell.
`ALIAS` | Das aktuelle `NCMTGD`-Makro bietet verschiedene Optionen für die durch die vorherige `NCMTGD`-Makrospezifikation definierte Thread-Gruppe. Allerdings können nur Thread-Gruppen mit `TYPE=GETM` und `TYPE=SHR` durch eine oder mehrere `NCMTGD`-Makro-Angaben mit `TYPE=ALIAS` als Anfragen neu definiert werden. Es werden bis zu 99 Thread-Gruppen unterstützt, d.h. es werden bis zu 99 `NCMTGD`-Makro-Angaben mit einem anderen `TYPE` als `ALIAS` erkannt.

### XTRAN - Hexadezimale Transaktionskennungen für Thread-Gruppe

Dieser Parameter entspricht dem `TRAN`-Parameter, erwartet aber eine Transaktionskennung im hexadezimalen Format.

Mögliche Werte:

Wert | Erläuterung
--- | ---
(siehe unten) | Mögliche Werte sind: Ein oder mehrere CICS-Transaktionscodes, die in der PCT für Natural definiert sind.

Ein Standardwert ist nicht vorgesehen.

Eine Liste von Transaktionskennungen im hexadezimalen Format muss in runde Klammern gesetzt werden, zum Beispiel: `XTRAN=(D5C1E3E4, E7E8E9)`.

| Warnung: Für alle Gruppen mit Ausnahme der ersten Gruppe, die als Standardgruppe verwendet wird, muss mindestens eine Transaktionskennung (im Zeichen- oder Hexadezimalformat) oder eine transaktionseinleitende Achtungskennung (Attention Identifier) angegeben werden.

## NTCICSP-Makro-Parameter

Die für die Natural-CICS-Schnittstelle erforderlichen Parameter werden durch Assemblierung des Natural-Parametermoduls erzeugt, das die erforderlichen `NTCICSP`-Makro-Definitionen enthält. Das Natural-Parametermodul wird in dem entsprechenden Installationsschritt in Installing Natural CICS Interface on z/OS (in der Natural Installation-Dokumentation) erstellt.

Das `NTCICSP`-Makro bestimmt alle Natural-Sitzungsoptionen, die in einer CICS-Umgebung relevant sind. Die einzelnen Parameter, die im Makro `NTCICSP` enthalten sind, werden unter CICSP - Umgebungsparameter für Natural CICS-Schnittstelle in der Parameter-Referenz-Dokumentation beschrieben.

### On this page

- NCISCPCB-Generierungsparameter
- NCMDIR-Makro-Parameter
- NCMTGD-Makro-Parameter
- NTCICSP-Makro-Parameter