ICU for Adabas & Natural (ICS) installieren

#### Search Results

Search

# ICU for Adabas & Natural (ICS) installieren

Dieses Dokument beschreibt die Schritte zur Installation der ICU for Adabas & Natural (ICS) auf z/OS, wodurch Natural die Konvertierung von Codepages und die Unterstützung von Unicode ermöglicht wird.

ICU for Adabas & Natural erfordert die Verwendung eines ICS-Moduls und einer ICU-Datenbibliothek. Darüber hinaus können Sie ICU-Datenelemente verwenden, um ICU-Komponenten zu laden, die nicht in der ICU-Datenbibliothek enthalten sind. Das ICS-Modul muss nicht mit dem Natural-Nukleus verlinkt werden, wenn weder Codepage-Konvertierung noch Unicode-Unterstützung erforderlich sind.

Durch die Verwendung der ICU-Funktionalität erhöht sich die erforderliche Natural-Thread-Größe.

Anmerkung
Um die Flexibilität zu erhöhen, kann das ICS-Modul auch während der Initialisierung der Natural-Sitzung geladen werden. Ein dynamisch geladenes ICS-Modul hat Vorrang vor dem statisch gelinkten ICS-Modul. Sie können auch eine ICU-Datenbibliothek während der Initialisierung der Natural-Sitzung laden. Eine dynamisch geladene ICU-Datenbibliothek hat Vorrang vor jeder statisch verlinkten ICU-Datenbibliothek.

Das ICS-Modul, die ICU-Datenbibliotheken und die ICU-Datenelemente werden unter Unicode- und Codepage-Unterstützung aktivieren in der Unicode- und Codepage-Unterstützung-Dokumentation erläutert.

#### Notation vrs oder vr:

In diesem Dokument steht die Notation `vrs` oder `vr` für die jeweilige Produktversion (siehe auch Version im Glossar).

- Voraussetzungen

- Installationsdatenträger

- Installationsvorgang

- Installation überprüfen

- ICS32 in Natural Subtask verwenden (benötigt APF-autorisierte ICS-Ladebibliothek)

## Voraussetzungen

Siehe Allgemeine Voraussetzungen und Systemunterstützung und Übersicht über den Installationsvorgang.

## Installationsdatenträger

Das ICS-Modul, die ICU-Datenbibliotheken und die ICU-Datenelemente sind in den Datasets `ICSvrs.LOAD` und `ICSvrs.SRCE` enthalten, die auf dem Installationsdatenträger für das Basisprodukt Natural mitgeliefert werden.

## Installationsvorgang

Bevor Sie mit der Installation beginnen, sollten Sie unbedingt die Abschnitte im Kapitel Installationsverfahren und wichtige Natural-Funktionen lesen.

- Schritt 1: ICS-Modul verlinken

- Schritt 2: ICU-Datenbibliothek verlinken

- Schritt 3: ICS-Modul beim Sitzungsstart laden

- Schritt 4: ICU-Datenbibliothek beim Sitzungsstart laden

- Schritt 5: ICU-Datenelemente auf Anforderung in eine Sitzung laden

### Schritt 1: ICS-Modul verlinken

1. Fügen Sie die folgende `INCLUDE`-Anweisung zu den Link-Anweisungen für den umgebungsunabhängigen Nukleus hinzu:

        INCLUDE ICSLIB(SAGICU)

   Zur Unterstützung von IBM Architecture Level 9 können Sie anstelle von `SAGICU` das alternative ICS-Modul `SAGICUA9` verwenden:

   - Setzen Sie den System Maintenance Aid (SMA)-Parameter `NAT-ARCHLEVEL9` auf `Y` (Standardeinstellung ist `N`).

     Or:

   - Fügen Sie die folgende `INCLUDE`-Anweisung zu den Link-Anweisungen für den umgebungsunabhängigen Nukleus hinzu:

          INCLUDE ICSLIB(SAGICUA9)

   - Siehe auch alternative ICS-Module in der Unicode and Code Page Support-Dokumentation.

   Anmerkung
   Die ICU-Datenbibliothek `ICSDT58J` ist im ICS-Modul `SAGICU` (bzw. `SAGICUA9`) enthalten und standardmäßig verfügbar.

2. Verlinken Sie das ICS-Modul mit dem umgebungsunabhängigen Nukleus, wie unter Nukleus verlinken in Natural installieren beschrieben.

### Schritt 2: ICU-Datenbibliothek verlinken

Die von uns bereitgestellten Datenbibliotheken werden von der Version ICS 322 nicht unterstützt. Sie werden im Rahmen der Übergangsversion ICS 222 (Transition Version) weiterhin unterstützt.

Die Version ICS 322 verwendet die Gesamtheit der ICU-Lokalisierungsdaten wie in Schritt 5 beschrieben.

Dieser Schritt ist nur erforderlich, wenn Sie zusätzlich zu `ICSDT58J` eine andere Datenbibliothek verwenden möchten.

1. Fügen Sie je nach der zu verwendenden ICU-Datenbibliothek eine der folgenden `INCLUDE`-Anweisungen in die Link-Anweisungen für den umgebungsunabhängigen Nukleus ein:

        INCLUDE ICSLIB(ICSDT58E)

   Oder:

        INCLUDE ICSLIB(ICSDT58X)

2. Verlinken Sie die ICU-Datenbibliothek mit dem umgebungsunabhängigen Nukleus, wie unter Link the Nucleus in Natural installieren beschrieben.

   Wenn Sie die Datenbibliothek `ICSDT58X` verlinken, müssen Sie den umgebungsunabhängigen Nukleus in eine PDSE anstatt in eine PDS verlinken, um den IBM-Fehler IEW2641S zu vermeiden.

### Schritt 3: ICS-Modul beim Sitzungsstart laden

1. Vergewissern Sie sich, dass die ICS-Ladebibliothek aus dem Datensatz `ICSvrs.LOAD` in der Ausführungs-JCL Ihrer Natural- oder TP-Monitorschnittstelle verfügbar ist. Führen Sie je nach Umgebung eine der folgenden Optionen aus:

   - Im Batch-Modus, unter TSO und in allen IMS TM-Umgebungen:

     Fügen Sie `ICSvrs.LOAD` in die `STEPLIB`-Verkettung Ihrer Ausführungs-JCL ein.

   - Unter CICS:

     Fügen Sie `ICSvrs.LOAD` in die `DFHRPL`-Verkettung Ihrer CICS-Ausführungs-JCL ein.

   - Unter Com-plete:

     Fügen Sie `ICSvrs.LOAD` zur `COMPLIB`-Verkettung Ihrer Com-plete-Ausführungs-JCL hinzu.

2. Setzen Sie zu Beginn einer Natural-Sitzung den Natural-Profilparameter `RCA` wie folgt:

       RCA=SAGICU

   `RCA` wird in der Parameter-Referenz-Dokumentation beschrieben.

   Das ICS-Modul `SAGICU` wird in der Unicode- und Codepage-Unterstützung-Dokumentation beschrieben.

   Anstelle des ICS-Moduls `SAGICU` können Sie auch das ICS-Modul `SAGICUA9` laden. Dieses Modul unterstützt zusätzlich den IBM Architecture Level 9. Siehe alternative ICS-Module in der Unicode- und Codepage-Unterstützung-Dokumentation.

   Wenn Sie `SAGICUA9` laden wollen, müssen Sie die folgende Parametereinstellung verwenden:

       RCA=SAGICU RCALIAS=(SAGICU,SAGICUA9)

   Der Natural-Profilparameter `RCALIAS` ist in der Parameter-Referenz-Dokumentation beschrieben.

### Schritt 4: ICU-Datenbibliothek beim Sitzungsstart laden

Die von uns bereitgestellten Datenbibliotheken werden vom ICS 322 nicht unterstützt. Sie werden im Rahmen der Übergangsversion ICS 222 (Transition Version) weiterhin unterstützt.

Die Version ICS 322 verwendet die Gesamtheit der ICU-Lokalisierungsdaten wie in Schritt 5 beschrieben.

1. Vergewissern Sie sich, dass die ICS-Ladebibliothek aus dem Dataset `ICSvrs.LOAD` in der Ausführungs-JCL Ihrer Natural- oder TP-Monitor-Schnittstelle vorhanden ist. Führen Sie je nach Umgebung eine der folgenden Optionen aus:

   - Im Batch-Modus, unter TSO und in allen IMS TM-Umgebungen:

     Fügen Sie `ICSvrs.LOAD` in die `STEPLIB`-Verkettung Ihrer Ausführungs-JCL ein.

   - Unter CICS:

     Fügen Sie `ICSvrs.LOAD` in die `DFHRPL`-Verkettung Ihrer CICS-Ausführungs-JCL ein.

   - Unter Com-plete:

     Fügen Sie `ICSvrs.LOAD` zur `COMPLIB`-Verknüpfung Ihrer Com-plete-Ausführungs-JCL hinzu.

2. Setzen Sie zu Beginn einer Natural-Sitzung die Natural-Profilparameter `RCA` und `CFICU` für die zu verwendende ICU-Datenbibliothek:

   Für `ICSDT58E`:

       RCA=ICSDT58E  CFICU=(DATFILE=ICSDT58E)

   Für `ICSDT58X`:

       RCA=ICSDT58X  CFICU=(DATFILE=ICSDT58X)

   `RCA` und `CFICU` sind in der Parameter-Referenz-Dokumentation beschrieben.

### Schritt 5: ICU-Datenelemente auf Anforderung in eine Sitzung laden

Dieser Schritt ist abhängig von der ICS-Version.

- Für die Übergangsversion ICS 222 (Transition Version)
- Für ICS 322

#### Für die Übergangsversion ICS 222 (Transition Version)

Dieser Schritt ist optional und nur dann erforderlich, wenn Sie während einer Natural-Sitzung statt einer ganzen ICU-Datenbibliothek ein ICU-Datenelement dynamisch auf Anforderung laden möchten. Weitere Informationen finden Sie in der Unicode- und Codepage-Unterstützung-Dokumentation.

1. Vergewissern Sie sich, dass die ICS-Ladebibliothek aus dem Dataset `ICSvrs.LOAD` für die Ausführungs-JCL Ihrer Natural- oder TP- Monitor-Schnittstelle verfügbar ist. Führen Sie je nach Ihrer Umgebung eine der folgenden Optionen aus:

   - Im Batch-Modus, unter TSO und in allen IMS TM-Umgebungen:

     Fügen Sie `ICSvrs.LOAD` in die `STEPLIB`-Verkettung Ihrer Ausführungs-JCL ein.

   - Unter CICS:

     Fügen Sie `ICSvrs.LOAD` in die `DFHRPL`-Verkettung Ihrer CICS-Ausführungs-JCL ein.

   - Unter Com-plete:

     Fügen Sie `ICSvrs.LOAD` zur `COMPLIB`-Verknüpfung Ihrer Com-plete-Ausführungs-JCL hinzu.

2. Abhängig von Ihrer TP-Umgebung und der Einstellung des Natural-Profilparameters `CFICU` müssen Sie eine der folgenden Optionen wählen:

   - Unter CICS, mit der Einstellung `CFICU=(DATITEM=NONE)` set:

     Fügen Sie einen PPT-Eintrag für jedes ICU-Datenelement hinzu.

     Siehe auch den entsprechenden Schritt in Natural CICS-Schnittstelle installieren.

   - Unter Com-plete, mit der Einstellung `CFICU=(DATITEM=NONE)` set:

     Fügen Sie `THREAD-ESQA-SIZE=15K` als Schlüsselwortparameter zu den Startoptionen für Ihr Com-plete hinzu.

#### Für ICS 322

1. Sie können den Namen des Dataset, der die ICU-Datenelemente aus `ICSvrs.LOAD` enthält, zu Beginn der Sitzung dynamisch mit dem Schlüsselwort-Subparameter `STEPLIB` des Natural-Profilparameters `CFICU` angeben.

   - Siehe Abschnitt Umfang und Handhabung der Daten in Unicode und Codepage-Unterstützung

   - Fügen Sie die Ladebibliothek mit den Datenelementen in die Ausführungs-JCL Ihrer Natural- oder TP-Monitor-Schnittstelle ein, wie in Schritt 2 beschrieben.

2. Sie können die Ladebibliothek mit den Datenelementen aus dem Dataset `ICSvrs.LOAD` auch statisch in die Ausführungs-JCL Ihrer Natural- oder TP-Monitor-Schnittstelle einfügen.

   - Im Batch-Modus, unter TSO und in allen IMS TM-Umgebungen:

     Fügen Sie `ICSvrs.LOAD` in die `STEPLIB`-Verkettung Ihrer Ausführungs-JCL ein.

   - Unter CICS:

     Fügen Sie `ICSvrs.LOAD` in die `DFHRPL`-Verkettung Ihrer CICS-Ausführungs-JCL ein.

   - Unter Com-plete:

     Fügen Sie `ICSvrs.LOAD` zur `COMPLIB`-Verknüpfung Ihrer Com-plete-Ausführungs-JCL hinzu.

   ICS verwendet beide Zuordnungsmethoden, um nach Datenelementen zu suchen, ausgehend (falls vorhanden) vom CFICU STEPLIB-Datensatz und den statisch angegebenen Natural Steplibs in der JCL.

## Installation überprüfen

Nachdem der letzte Schritt des Installationsverfahrens abgeschlossen ist, gehen Sie wie folgt vor:

1. Konfigurieren und aktivieren Sie Ihre Unicode- und Codepage-Umgebung, indem Sie die Anleitungen unter Unicode-/Codepage-Umgebung konfigurieren und verwalten und Natural-Profilparameter und Parameter-Makros in der Unicode- und Codepage-Unterstützung-Dokumentation befolgen. Informationen zu den Codepages und ICU-Datendateien, die in Ihrer aktuellen Natural-Umgebung verfügbar sind, erhalten Sie mit dem Dienstprogramm SYSCP (beschrieben in der Debugger und Dienstprogramme (Utilities)-Dokumentation).

   Informationen zu den Codepages und ICU-Datendateien, die in Ihrer aktuellen Natural-Umgebung verfügbar sind, erhalten Sie mit dem Dienstprogramm SYSCP (beschrieben in der Debugger und Dienstprogramme (Utilities)-Dokumentation).

2. Nach erfolgreicher Aktivierung können Sie die in der Unicode- und Codepage-Unterstützung-Dokumentation beschriebenen Beispiel-Programme ausführen.

## ICS32 in Natural Subtask verwenden (benötigt APF-autorisierte ICS-Ladebibliothek)

Bei der aktuellen Implementierung des Entire System Server (NPR) muss die `PRD.ICSnnn.MVSLOAD` immer APF-autorisiert sein. Dies ist unabhängig davon, ob sie Teil der `STEPLIB`-Verkettung ist oder über den Schlüsselwort-Subparameter `STEPLIB` des Natural-Profilparameters `CFICU`

Die Szenarien für die Verwendung von ICS32 in einer Natural-Subtask sind:

- Wenn mehrere Natural-Sitzungen/-Subtasks von einem Entire System Server (NPR)-Knoten aus laufen.

- Wenn NOP, NOM, EOR automatisch von einem ESS/NPR-Knoten ausgeführt werden sollen.

- Bei der Ausführung eines Natural Development Servers (NDV).

### On this page

- Voraussetzungen
- Installationsdatenträger
- Installationsvorgang
- Installation überprüfen
- ICS32 in Natural Subtask verwenden (benötigt APF-autorisierte ICS-Ladebibliothek)