Installation und Upgrade des R4Z-Produkts in z/OS

In diesem Abschnitt wird erläutert, wie Sie das R4Z-Produkt in z/OS installieren und upgraden.

Installation und Upgrade des R4Z-Produkts in z/OS

Die folgenden Konfigurationsschritte umfassen das Senden von in der INSTALL-Bibliothek gefundenen Aufträgen (in R4Z-Produktbibliotheken als <r4z-vnd-hlq>.INSTALL bezeichnet). Für jeden Auftrag ist die INSTALL-Bibliothek (oder deren Kopie) als JCLLIB erforderlich, und er muss sowohl eine Auftragskarte als auch JES-Steuerungsbefehle umfassen, die den Vorschriften des Standorts entsprechen.

Anwenden der Installation in der Verarbeitungsumgebung

Während des Installationsprozesses müssen Sie die meisten Mitglieder mit dem vorangestellten „DO*“ in der Bibliothek übermitteln. Bevor Sie diese Mitglieder übermitteln, müssen Sie sie wie folgt bearbeiten:

1. Legen Sie den Auftragsnamen, die Auftragskartenparameter und die JES-Steuerungsbefehle entsprechend Ihren Systemanforderungen fest.
2. Legen Sie die im Parameter JCLLIB ORDER angegebene Bibliothek als INSTALL-Bibliothek fest.

Schritt 1: Festlegen der INCLUDE-Mitglieder der INSTALL-Bibliothek

Sie müssen die folgenden JCL-Symbole festlegen, bevor Sie Aufträge ausführen, da die „DO“-Aufträge diese JCL-Symbole zum Konfigurieren der R4Z-Verarbeitung verwenden. Um die Werte zu ändern, müssen Sie zuerst den „UNDO“-Auftrag mit dem alten Wert und dann den „DO“-Auftrag mit dem neuen Wert ausführen.

Bearbeiten Sie dieses Mitglied, um die JCL-Symbole festzulegen, die von den Aufträgen in dieser Bibliothek verwendet werden sollen, und speichern (überschreiben) Sie das Mitglied. Diese Symbole sind in der Tabelle Installationssymbole unten aufgeführt.

Es folgt eine detailliertere Erläuterung mehrerer Parameter:

• Parameter, die die R4Z-Produktbibliotheksnamen angeben:
  &R4ZHLVL: Auf den Qualifizierer auf hoher Ebene festlegen, der den R4Z INSTALL-, LOAD- und CONFIG-Bibliotheken gemeinsam ist, also den längsten gemeinsamen Teil dieser Bibliotheksnamen:
  • &R4ZVNDH: Auf den Wert festlegen, den Sie als „versionierten“ Qualifizierer auf hoher Ebene verwendet haben (<r4z_vnd_HLQ>), als die INSTALL- und LOAD-Bibliotheken empfangen wurden.
  • &R4ZBSCH: Auf den Wert festlegen, den Sie für den „einfachen“ Qualifizierer auf hoher Ebene verwendet haben (<r4z_bsc_HLQ>), der bei der Erstellung der CONFIG-Bibliothek verwendet wird.
  • &R4ZINSTL, &R4ZLOADL, &R4ZCNFGL : Geben Sie diese nur an, wenn ihr Wert von dem im DFSYMLST-Mitglied festgelegten Wert abweicht, basierend auf den oben beschriebenen Symbolen.
• Parameter, die die DASD-Zuteilung steuern:

  • ALCSMSPM, &ALCVLSER : Verwenden Sie diese Parameter, um die Volumes anzugeben, denen die CONFIG-Bibliothek und einige Zwischendatensätze zugeteilt werden.

    Verwenden Sie &ALCSMSPM, um SMS-Zuteilungsattribute in einem kommagetrennten, mit einem Leerzeichen endenden String in folgendem Format anzugeben:

    '[STORCLAS=…][,MGMTCLAS=…][,DATACLAS=…] '

    Verwenden Sie &ALCVLSER, um die Volume-Seriennummer anzugeben.

    Wenn die SMS-verwaltete Zuteilung von ACS-Routinen gesteuert wird, können Sie alle Attribute auslassen und stattdessen &ALCSMSPM=' ' (ein einziges Leerzeichen) angeben.

    Wenn Sie &ALCSMSPM=' '(ein einziges Leerzeichen) angeben, müssen Sie einen Wert für den Parameter &ALCVLSER angeben.

    Für nicht SMS-verwaltete Zuteilungen verwenden Sie &ALCVLSER, um die Volume-Seriennummer anzugeben.

• Variablen im Zusammenhang mit CDC-Dienst und UDF:

  DFSYMPER	Definieren Sie Namen für die UDF, die WLM-Anwendungsumgebung und das STC-Verfahren basierend auf dem CDC-Dienstqualifizierer	Pro R4Z-Installation
  Verwendet: &CDCSRV Legt fest: &R4ZWLMPR, &R4ZAPPNV, &R4ZIFITF, &R4ZSCNM, &STCUSER, &UDFUSER
  DFSYMONE	Definieren Sie Namen für die UDF, die WLM-Anwendungsumgebung und das STC-Verfahren ausgehend von der Annahme, dass ein einzelner CDC-Dienst verwendet wird	Pro DB2-Untersystem
  Legt fest: &R4ZWLMPR, &R4ZAPPNV, &R4ZIFITF, &R4ZSCNM, &STCUSER, &UDFUSER

Abhängig vom Wert, der für DEFWLMAE, ONE oder PER ausgewählt wurde, bearbeiten Sie das Mitglied DFSYMONE bzw. DFSYMPER und wählen Sie Werte für die WLM APPLENV und das WLM JCL-Verfahren für die CDC Reader UDTF aus.

Schritt 2: Ausführen von Konfigurationsaktionen

1. Legen Sie die R4Z LOAD-Bibliothek als APF-autorisiert fest.

   Um eine Bibliothek vorübergehend als APF-autorisiert festzulegen (bis zur nächsten IPL- oder APF-Aktualisierung), können Sie einen der folgenden Systembefehle ausführen:

   • Für nicht SMS-verwaltete Datensätze:

     setprog apf,add,dsn=<xmit-HLQ>.LOAD,volume=<volser>

   • Für SMS-verwaltete Datensätze:

     setprog apf,add,dsn=(<xmit-HLQ>.LOAD,sms

     Um die Einstellung als dauerhaft festzulegen, fügen Sie die Bibliothek zu Ihrem PROGxx-Mitglied in PARMLIB hinzu.

2. Richten Sie eine WLM-Anwendungsumgebung ein, um den CDC-Prozess auszuführen.
   

   DO2WLMAE	WLM-Anwendungsumgebung definieren	Pro CDC-Dienst
   Akzeptiert: &CDCSRV Verwendet: &R4ZAPPNV, &R4ZWLMPR, &CEERUNL, &DB2EXITL, &DB2LOADL, &DB2RUNL
   DO2WLMPR	JCL-Verfahren für WLM STC erstellen	pro WLM-Verfahren
   Akzeptiert: &CDCSRV Verwendet: &PROCLIB, &R4ZWLMPR, &SSID
   DO2WLMPV	Auftrag: WLM-Server als Ressource in RACF definieren und APPLENV und DB2-Untersystem zur Verwendung autorisieren	pro CDC-Dienst und WLM-Verfahren
   Akzeptiert: &CDCSRV Verwendet: &R4ZAPPNV, &R4ZWLMPR, &STCUSER

   
   Abhängig vom für DEFALMAE festgelegten Wert führen Sie die folgenden Aufträge aus – einmal (wenn ONE ausgewählt ist) oder für jeden zu definierenden CDC-Dienst (wenn PER ausgewählt ist), nachdem das JCL-Symbol CDCSRV mit dem relevanten CDC-Dienstqualifizierer eingerichtet wurde.

   1. Auftrag DO2WLMAE bearbeiten; Symbol &CDCSRV auf den relevanten CDC-Dienstqualifizierer festlegen und übermitteln. Der Auftrag definiert die WLM APPLENV im WLM-Richtliniendatensatz und aktiviert sie.

      • Voraussetzungen:

        • &R4ZWLMPR ist der Name der gestarteten Aufgabe, die von WLM verwendet wird. Sie müssen einen gültigen Benutzer mit der gestarteten Aufgabe verknüpfen und &STCUSER auf diesen Benutzer festlegen.

        • Der Übermittler benötigt UPDATE-Zugriff auf MVSADMIN.WLM.POLICY, um die WLM-Richtlinie abzufragen und zu aktualisieren.

        • UPDATE für die Verfahrensbibliothek, die in DSSYMLST im Symbol &PROCLIB angegeben ist.

   2. Auftrag DO2WLMPR bearbeiten; Symbol &CDCSRV auf den relevanten CDC-Dienstqualifizierer festlegen und übermitteln. Der Auftrag erstellt ein JCL-Verfahren für die APPLENV und muss mit RC 0 enden.

      • Autorisierungen:

        UPDATE für die PROCLIB-Bibliothek.

   3. Auftrag DO2WLMPV bearbeiten; Symbol &CDCSRV auf den relevanten CDC-Dienstqualifizierer festlegen und übermitteln. Der Auftrag legt RACF-Berechtigungen für die APPLENV zur Verwendung des WLM-Servers und für das DB2-Untersystem zu dessen Aufruf fest. Der Auftrag muss mit RC 0 enden.

      • Autorisierungen:

        ALTER für Klasse SERVER

        Wenn Sie ein anderes Sicherheitspaket als RACF verwenden (z. B. CA-TSS oder CA-ACF2), müssen Sie die betreffenden Befehle für Ihr Sicherheitspaket ausführen.

3. CDC Reader UDTF(s) erstellen.
   

   DO3SRVDF	Standard-UDTF des CDC-Diensts erstellen	Pro DB2-Untersystem
   Verwendet: &R4ZSCNM, &R4ZIFITF, &R4ZCNFGL, &ALCSMS, &ALCSMSPM, &ALCVLSER, &SSID, &DB2EXITL, &DB2LOADL, &DB2RUNL, &UDFUSER
   DO3SRVTF	UDTF für die Verwendung durch einen bestimmten CDC-Dienst erstellen	Pro CDC-Dienst und DB2-Untersystem
   Akzeptiert: &CDCSRV Verwendet: &R4ZSCNM, &R4ZIFITF, &R4ZCNFGL, &ALCSMS, &ALCSMSPM, &ALCVLSER, &SSID, &DB2EXITL, &DB2LOADL, &DB2RUNL, &UDFUSER

   Der erste Auftrag erstellt die Standard-Dienst-UDTF mit dem spezifischen Namen &R4ZIFITF (unter dem Schemanamen &R4ZSCNM) und erteilt die Ausführungsrechte daran an &UDFUSER. Er instanziiert auch einen „bereitgestellten“ CDC-Dienst CDC1 (indem die entsprechende CONFIG-Bibliothek des Mitglieds erstellt wird) und richtet ihn mit Standardkonfigurationen ein. Dieser Auftrag muss zuerst ausgeführt werden.

   Der zweite Auftrag, der für jeden definierten CDC-Dienst explizit ausgeführt wird, verhält sich genau wie der erste Auftrag, außer dass jede UDF mit einem spezifischen CDC-Dienst verknüpft wird, der vom CDC1-Dienst instanziiert wird.

   1. Auftrag DO3SRVDF ausführen. Er wird:

      • Eine UDTF mit einem Namen ohne Suffix erstellen, der mit dem Standard-CDC-Dienst (CDC1) verknüpft wird.
      • Die CONFIG-Bibliothek erstellen und ein Mitglied namens CDCS platzieren, das verwendet wird, wenn kein mit dem CDC-Dienst verbundenes Mitglied vorhanden ist.

      Die Aufträge müssen mit RC4 enden.

   2. Für jeden CDC-Dienst, den Sie definieren möchten, bearbeiten Sie Auftrag DO3SRVTF; legen Sie Symbol &CDCSRV auf den relevanten CDC-Dienstqualifizierer fest und übermitteln Sie. Er wird:

      • Eine UDTF mit einem Namenssuffix „__&CDCSRV“ erstellen, der mit dem Standard-CDC-Dienst „&CDCSRV“ verknüpft wird.
      • Ein Mitglied namens „&CDCSRV“ in der CONFIG-Bibliothek erstellen.
      • Das JCL-Symbol CDCSRV mit dem entsprechenden CDC-Dienstqualifizierer (xxxx) festlegen und den Auftrag übermitteln.

      Die Aufträge müssen mit RC4 enden.

      • Autorisierungen:

        Der übermittelnde Benutzer muss eine der folgenden Autorisierungen haben:

        • SYSADM oder SYSCTRL-Autorität.
        • CREATEIN-Autorisierung im von &R4ZSCNM. angegebenen Schema

4. Die angegebene Benutzer-ID zum Ausführen von CDC-Aufgaben befähigen.

   DO4GRANT	Dem ODBC-Benutzer Zugriff auf Katalogtabellen gewähren und Berechtigung zum Lesen von CDC erteilen	Pro DB2-Untersystem
   Verwendet: &R4ZUSER, &SSID, &DB2EXITL, &DB2LOADL, &DB2RUNLR

   Dieser Auftrag befähigt die ausgewählte Benutzer-ID zur Interaktion mit ODBC. Dies ist der „ODBC-Benutzer“, der berechtigt ist (über DB2), CDC-Daten und einige DB2-Katalogtabellen zu lesen.

   Informationshinweis

   Es ist nicht sinnvoll, den Auftrag über den ODBC-Benutzer selbst zu übermitteln (da ein Benutzer sich nicht selbst Berechtigungen gewähren kann), bzw. über einen Benutzer, der nicht über die Berechtigungen verfügt, die er zu gewähren versucht.

   Auftrag DO4GRANT ausführen. Er wird:

   • GRANT SELECT an den ODBC-Benutzer für die folgenden Tabellen gewähren:

     • SYSIBM.SYSTABLES
     • SYSIBM.SYSTABLESPACE
     • SYSIBM.SYSCOLUMNS
     • SYSIBM.SYSROUTINES
     • SYSIBM.SYSDUMMY1
     • ALTER SYSIBM.SYSTABLES mit Aktivierung von DATA CAPTURE.

   Die Aufträge müssen mit RC 0 oder RC 4 enden.

   Autorisierungen:

   Der übermittelnde Benutzer muss eine der folgenden Autorisierungen haben:

   • SYSADM oder SYSCTRL-Autorität.
   • TRACE/ MONITOR2 mit „grant“-Option
5. Stellen Sie der von WLM gestarteten Aufgabe Berechtigungen bereit, sich selbst abzubrechen. In RACF geschieht dies wie folgt:

1. Definieren Sie ein PROFILE für die Klasse OPERCMDS mit dem Namen PERMIT MVS.CANCEL.STC.mbrname.*:

   RDEFINE OPERCMDS MVS.CANCEL.STC.mbrname.* UACC(NONE) SETROPTS REFRESH RACLIST(OPERCMDS)

   Dabei ist mbrname der Name der gestarteten Aufgabe.

2. Gewähren Sie der USERID, die der von WLM gestarteten Aufgabe zugewiesen ist, die Berechtigung zum Abbrechen der gestarteten Aufgabe:

   PERMIT MVS.CANCEL.STC.mbrname.* CL(OPERCMDS) ACCESS(UPDATE) ID(stcuser)

   Dabei ist stcuser die USERID, die mit der gestarteten WLM-Aufgabe verknüpft ist.

6. Leistungserwägungen:

   1. Vollständiges Laden - Bei Prozessen mit vollständigem Laden werden alle verfügbaren ZIIP-Prozessoren verwendet. Als Best Practice wird empfohlen, als Leistungsziel festzulegen, dass die Prozesse niedriger als Online-Arbeitslasten klassifiziert werden. In einem stark ausgelasteten System können Sie Priorität beachten auf NO für die Dienstklasse festlegen, die dem vollständigen Laden zugewiesen ist. Dafür ist z/OS 2.1 + OA50845 oder z/OS 2.2 oder höher erforderlich.

   2. CDC - Als Best Practice wird empfohlen, das Leistungsziel für die CDC-Prozesse gleich hoch wie für Online-Arbeitslasten und höher als für das Ziel für vollständiges Laden festzulegen. Diese Prozesse können anhand eines der folgenden Elemente klassifiziert werden:

      - Name der gestarteten Aufgabe der WLM-Anwendungsumgebung

      - DDF-Klassifizierung mit „Procedure Name“

Migrieren des R4Z-Produkts in z/OS

Wenn Sie Ihre R4Z-Installation aktualisieren und die aktuelle Installation überschreiben möchten, oder wenn Sie die R4Z-Installation aktualisieren möchten, ohne die aktuell installierte Version zu überschreiben, müssen Sie die unten beschriebenen relevanten Schritte ausführen.

Um ein Upgrade Ihrer R4Z-Installation durchzuführen und die aktuell installierte Version zu überschreiben, halten Sie alle CDC-Dienste, die R4Z verwenden, wie folgt an:

1. Verwenden Sie den folgenden Bedienerbefehl, um die WLM-Anwendungsumgebung stillzulegen und zu verhindern, dass Clients den CDC-Dienst automatisch aktivieren, bevor er bereit ist:

   VARY WLM,APPLENV=<applic.env-name>,Q

   Wiederholen Sie dies für alle Anwendungsumgebungen mit den JCL-Verfahren, die die LOAD-Bibliothek der ersetzten Version angeben. Wenn der Host ein Parallel Sysplex ist, stellen Sie dem Befehl ROUT *ALL voran, um ihn zu allen Systemen in „plex“ zu routen.

2. Verwenden Sie R4ZUTIL TERMINATE, um alle Systemressourcen freizugeben, die derzeit vom CDC-Dienst verwendet werden.

   Wiederholen Sie dies in allen LPARs, in denen der Dienst möglicherweise ausgeführt wird (wenn die Quell-DB2 Mitglieder mit Datenfreigabe in diesen Systemen hat).