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

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

  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)

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