© Copyright International Business Machines Corporation 2013, 2017. Alle Rechte vorbehalten.
© HCL Technologies Ltd. 2017, 2024
Hinweis an U.S. Regierungsnutzer – Dokumentation in Bezug auf eingeschränkte Rechte – Die Nutzung, Vervielfältigung oder Offenlegung unterliegt den im GSA ADP Schedule-Vertrag mit IBM Corp. festgelegten Einschränkungen.

Inhaltsverzeichnis

Abbildungen

Einführung

Programmmaterial

Programmunterstützung

Programm- und Service-Level-Informationen

Installationsvoraussetzungen und Hinweise

Installationsanweisungen

Bemerkungen

Leserkommentare

Abbildungen

Einführung

Dieses Programmverzeichnis ist für Systemprogrammierer gedacht, die für die Programminstallation und -wartung verantwortlich sind. Es enthält Informationen über das Material und die Verfahren im Zusammenhang mit der Installation von IBM Application Delivery Foundation for z/OS Common Components. Diese Veröffentlichung bezieht sich auf IBM Application Delivery Foundation for z/OS Gemeinsame Komponenten als ADFzCC.

Das Programmverzeichnis enthält die folgenden Abschnitte:

• "Programmmaterialien" bezeichnet die grundlegenden Programmmaterialien und -dokumentationen für ADFzCC.

• "Program Support " beschreibt den IBM -Support, der für ADFzCC verfügbar ist.

• "Program and Service Level Information " listet die APARs (Programmebene) und PTFs (Serviceebene) auf, die in ADFzCC aufgenommen wurden.

• "Installationsanforderungen und -überlegungen " identifiziert die Ressourcen und Überlegungen, die für die Installation und Nutzung von ADFzCC erforderlich sind.

• "Installationsanleitung" bietet detaillierte Installationsanweisungen für ADFzCC. Es beschreibt auch die Verfahren zur Aktivierung der Funktionen von ADFzCC, oder verweist auf entsprechende Publikationen.

Der Rest dieses Abschnitts gilt nur, wenn ADFzCC über Shopz bestellt wird. Er ist nicht zutreffend, wenn Sie es aus dem Web heruntergeladen haben.
Wählen Sie diesen Link, um zum nächsten Abschnitt zu gelangen: "ADFzCC Beschreibung

Lesen Sie vor der Installation von ADFzCC, das CBPDO-Memo an die Benutzer und das CBPDO-Memo an die Benutzer-Erweiterung, die mit diesem Programm im Softcopy-Format und in diesem Programmverzeichnis geliefert werden. Bewahren Sie die Dokumente anschließend zu Referenzzwecken auf. In Abschnitt "Vorbeugende Serviceplanung" erfahren Sie, wie Sie Updates zu den Informationen und Prozeduren in diesem Programmverzeichnis finden.

ADFzCC wird in einem maßgeschneiderten Produktlieferangebot (CBPDO, 5751-CS3 ) bereitgestellt. Das Programmverzeichnis, das im Softcopy-Format auf CBPDO bereitgestellt wird, entspricht dem Hardcopy-Format, falls eines in Ihrer Bestellung enthalten gewesen wäre. Alle Dienste und HOLDDATA für ADFzCC sind im CBPDO enthalten.

Verwenden Sie dieses Programmverzeichnis nicht, wenn Sie ADFzCC mit einer z/OSMF Portable Software Instance ( ServerPac ) installieren. Wenn Sie eines dieser Angebote nutzen, verwenden Sie die Jobs und Dokumentation, die im Angebot enthaltenen sind. Das Angebot verweist Sie gegebenenfalls auf bestimmte Abschnitte in diesem Programmverzeichnis.

ADFzCC Beschreibung

IBM Application Delivery Foundation for z/OS "Common Components" stellt allgemeine Komponenten bereit, die von einigen der Problemermittlungs-Tools von IBM für die Anwendungsentwicklung von z/OS verwendet werden. ADFzCC wird automatisch in Ihre Bestellung aufgenommen, wenn Sie eines der folgenden Produkte erwerben:

IBM Application Performance Analyzer for z/OS

IBM Fault Analyzer for z/OS

IBM File Manager for z/OS

IBM Debug for z/OS

IBM Developer for z/OS

IBM Developer for z/OS Enterprise Edition

ADFzCC FMIDs

ADFzCC besteht aus den folgenden FMIDs:

HVWR1A0

JVWR1A1

Der Rest dieses Abschnitts gilt nur, wenn ADFzCC über Shopz bestellt wird. Er ist nicht zutreffend, wenn Sie es aus dem Web heruntergeladen haben.
Wählen Sie diesen Link aus, um zum nächsten Abschnitt zu gelangen: "Programmmaterialien"

Sie erhalten folgende Materialien:

• Wenn Sie nur das Basisfeature bestellen, erhalten Sie das folgende Material:

  • ADFzCC Basis (FMID HVWR1A0 )

• Wenn Sie sowohl die Basisfeatures als auch die japanischen Features bestellen, erhalten Sie die folgenden Materialien:

  • ADFzCC Base und JPN (FMID HVWR1A0 )

  • ADFzCC JPN (FMID JVWR1A1 )

Programmmaterial

Ein IBM Programm ist durch eine Programmnummer gekennzeichnet. Die Programmnummer für ADFzCC lautet 5755-AB3.

Grundlegendes maschinenlesbares Material ist Material, das unter der Basislizenz bereitgestellt wird und für die Nutzung des Produkts erforderlich ist.

In den Ankündigungsmaterialien für das Programm werden die von ADFzCC unterstützten Funktionen beschrieben. Fragen Sie Ihren IBM Ansprechpartner nach diesen Informationen, wenn Sie noch keine Kopie davon erhalten haben.

Grundlegendes maschinenlesbares Material

Das Verteilungsmedium für diesen Programm sind physische Medien oder Downloaddateien. Dieses Programm befindet sich im SMP/E-Format RELFILE und wird unter Verwendung von SMP/E installiert. Weitere Informationen zur Installation des Programms finden Sie unter "Installationsanweisungen".

Der Rest dieses Abschnitts gilt nur, wenn ADFzCC über Shopz bestellt wird. Er ist nicht zutreffend, wenn Sie es aus dem Web heruntergeladen haben.
Wählen Sie diesen Link aus, um zum nächsten Abschnitt zu gelangen: "Programmveröffentlichungen"

Informationen zu den physischen Medien für die grundlegenden maschinenlesbaren Materialien für ADFzCC finden Sie im CBPDO Memo To Users Extension.

Tabelle 1 beschreibt den Inhalt der Programmdatei für ADFzCC.

Tabelle 2 beschreibt den Inhalt der Programmdatei für die japanische Komponente von ADFzCC.

Im Dokument CBPDO Memo To Users Extension können Sie nachlesen, wo sich diese Dateien im Image befinden.

Hinweise:

1. Die Dateiattribute in dieser Tabelle müssen in der JCL der Jobs verwendet werden, die die Dateien lesen. Da sich die Dateien im "unloaded"-Format IEBCOPY befinden, können ihre tatsächlichen Attribute anders sein.

2. Falls RELFILEs als PDSEs angegeben sind, stellen Sie sicher, dass SMPTLIB-Dateien als PDSEs zugeordnet sind.

Tabelle 1. Programmdateiinhalt -- Basis

Tabelle 2. Inhalt der Programmdatei – JPN

Veröffentlichungen zum Programm

In den folgenden Abschnitten werden die grundlegenden Publikationen für ADFzCC aufgeführt.

Tabelle 3 enthält die grundlegenden nicht lizenzierten Programmveröffentlichungen für ADFzCC.

Tabelle 3. Basismaterial: Nicht lizenzierte Veröffentlichungen

Hinweis: Diese grundlegenden, nicht lizenzierten Veröffentlichungen finden Sie in der IBM Produktdokumentation https://www.ibm.com/docs/en/products und über den in der Tabelle aufgeführten Direktlink.

Hinweis: Die erforderlichen Informationen erhalten Sie, indem Sie unter https://www.ibm.com/software/reports/compatibility/clarity einen Bericht für ADFzCC erstellen.

Programmquellmaterial

Für ADFzCC werden keine Programmquellen oder sichtbaren Programmlisten bereitgestellt.

Während der Installation nützliche Veröffentlichungen

Möglicherweise möchten Sie während der Installation von ADFzCC die in Tabelle 4 aufgeführten Veröffentlichungen verwenden ADFzCC, die Sie in IBM Produktdokumentation https://www.ibm.com/docs/en/products finden.

Tabelle 4. Veröffentlichungen, die während der Installation nützlich sind

Programmunterstützung

In diesem Abschnitt wird der IBM -Support für ADFzCC beschrieben.

Programmservices

Spezifische Informationen über verfügbare Programmservices erhalten Sie bei Ihrem IBM Ansprechpartner.

Vorbeugende Serviceplanung

Bevor Sie ADFzCC, installieren, stellen Sie sicher, dass Sie die PSP-Bucket-Informationen für IBM Z -Produkte im Dokument https://www.ibm.com/support/pages/node/7127792 überprüfen. Es enthält die neuesten Informationen zur Installation von IBM -Produkten, einschließlich der neuesten Serviceempfehlungen und produktübergreifenden Abhängigkeiten. Diese Informationen waren zuvor in den herkömmlichen PSP-Eimern verfügbar, die für IBM Z -Produkte nicht mehr veröffentlicht werden.

Für Unterstützung besuchen Sie die Software-Support-Website unter https://www.ibm.com/mysupport/

Erklärung zu Supportprozeduren

Melden Sie alle Probleme an das IBM Support Center, wenn Sie der Meinung sind, dass es einen Fehler im Produktmaterial gibt. Sie werden vielleicht aufgefordert, zusätzliche Diagnosen zu sammeln und zu übergeben, um dem IBM Support Center bei der Analyse zu helfen.

Tabelle 5 enthält die Komponenten-IDs (COMPID) für ADFzCC.

Tabelle 5. Komponenten-IDs

Informationen über die Programmversion und den Service-Level

In diesem Abschnitt werden das Programm und die relevanten Service-Levels von ADFzCC aufgeführt. Die Programmversion bezieht sich auf die APAR-Fixes, die in das Programm integriert wurden. Der Service-Level bezieht sich auf die PTFs, die in das Programm integriert wurden.

Informationen über die Programmversion

Die folgenden APAR-Korrekturen gegenüber früheren Versionen von ADFzCC wurden in diese Version integriert. Sie sind nach FMID aufgelistet.

• FMID HVWR1A0
  
  PH53075 PH53302 PH53995 PH54201 PH54534 PH54805 PH54834 PH55148 PH55405 PH55489 PH55547 PH56848 PH56883 PH58260 PH58510 PH59540 PH59788 PH61081 PH61524 PH62702 PH62923

   

Informationen über den Service-Level

Es wurden keine PTFs gegen diese Version von ADFzCC in das Produktpaket aufgenommen.

Überprüfen Sie regelmäßig https://www.ibm.com/support/pages/latest-adfz-common-components-service-information die vollständige Liste der für dieses Produkt verfügbaren PTFs.

Hinweis : Die Anwendung eines PTF kann den von ADFzCC, gemeldeten Änderungsgrad erhöhen und zu einer Nichtübereinstimmung zwischen der bestellten Version ( 1.10.0 ) und der gemeldeten Version ( 1.10.x ) führen.

Installationsvoraussetzungen und -hinweise

In den folgenden Abschnitten werden die Systemanforderungen für die Installation und Aktivierung von ADFzCC aufgeführt. Folgende Terminologie wird verwendet:

• Treibersystem: das System, auf dem SMP/E ausgeführt wird, um das Programm zu installieren.

  Das Programm kann spezifische Betriebssystems- oder Produktversionsvoraussetzungen für die Verwendung von Prozessen, wie zum Beispiel Binder- oder Assembly-Dienstprogramme, während der Installation haben.

• Zielsystem: das System, auf dem das Programm konfiguriert und ausgeführt wird.

  Das Programm kann spezifische Produktversionsvoraussetzungen haben, wie zum Beispiel die Notwendigkeit für den Zugriff auf die Bibliothek eines anderen Produkts zur Herstellung von Programmverbindungen. Diese Voraussetzungen, entweder obligatorisch oder optional, können sich direkt auf das Element während der Installation oder bei dessen grundlegenden oder erweiterten Betrieb auswirken.

In vielen Fällen können Sie ein System sowohl als Treibersystem als auch als Zielsystem verwenden. Sie können jedoch einen separaten IPL-fähigen Klon des aktiven Systems erstellen, der als Zielsystem verwendet werden soll. Der Klon muss Kopien von allen Systembibliotheken, die SMP/E aktualisiert, Kopien der SMP/E CSI-Dateien, die die Systembibliotheken beschreiben, sowie Ihre PARMLIB und PROCLIB enthalten.

Verwenden Sie separate Treiber- und Zielsysteme in den folgenden Situationen:

• Wenn Sie eine neue Version eines Produkts installieren, das bereits installiert ist, ersetzt die neue Produktversion die alte Version. Durch Installation der neuen Version auf einem separaten Zielsystem können Sie die neue Version testen und die alte Version gleichzeitig in der Produktion behalten.

• Wenn Sie ein Produkt installieren, das Bibliotheken und Lademodule gemeinsam mit anderen Produkten nutzt, kann die Installation zu Unterbrechungen bei den anderen Produkten führen. Durch Installation des Produkts auf einem separaten Zielsystem können Sie diese Auswirkungen abschätzen, ohne dass Ihr Produktionssystem unterbrochen wird.

Voraussetzungen für das Treibersystem

In diesem Abschnitt wird die Umgebung des Antriebssystems beschrieben, die für die Installation von ADFzCC erforderlich ist.

Hardwarevoraussetzungen

Das Treibersystem kann in jeder Hardwareumgebung ausgeführt werden, die die erforderliche Software unterstützt.

Softwarevoraussetzung

Tabelle 6. Softwarevoraussetzungen für das Betriebssystem

Hinweis: SMP/E ist eine Voraussetzung für die Installation und ein Element von z/OS.

Hinweis: Die Installation erfordert unter Umständen die Migration zu neuen z/OS-Versionen, damit die Services unterstützt werden. Siehe https://www.ibm.com/support/lifecycle/

Voraussetzungen für das Zielsystem

In diesem Abschnitt wird die Umgebung des Zielsystems beschrieben, die für die Installation und Verwendung von ADFzCC erforderlich ist.

ADFzCC installiert in der z/OS ( Z038 ) SREL.

Hardwarevoraussetzungen

Das Zielsystem kann in jeder Hardwareumgebung ausgeführt werden, die die erforderliche Software unterstützt.

Softwarevoraussetzung

Zusätzlich erforderliche Software für die Installation

Zusätzlich erforderliche Software für die Installation sind Produkte, die erforderlich sind und auf dem System vorhanden sein müssen, oder Produkte, die nicht erforderlich sind, aber auf dem System vorhanden sein sollten, damit dieses Produkt installiert werden kann.

Obligatorische zusätzlich erforderliche Software für die Installation sind Produkte, die auf dem System erforderlich sind, damit dieses Produkt installiert werden kann. Diese Produkte werden als PREs oder REQs angegeben.

ADFzCC es gibt keine zwingenden Installationsvoraussetzungen.

Bedingte zusätzlich erforderliche Software für die Installation sind Produkte, die nicht für eine erfolgreiche Installation dieses Produkts erforderlich sind, aber zum Beispiel bestimmte Warnhinweise zur Installationszeit auflösen können. Diese Produkte werden als IF REQs bezeichnet.

ADFzCC hat keine bedingten Installationsvoraussetzungen.

Zusätzlich erforderliche Software für den Betrieb

Zusätzlich erforderliche Software für den Betrieb sind Produkte, die erforderlich sind und auf dem System vorhanden sein müssen, oder Produkte, die nicht erforderlich sind, aber vorhanden sein sollten, damit dieses Produkt alle oder einen Teil seiner Funktionen ausführen kann.

Obligatorische zusätzlich erforderliche Software für den Betrieb sind Produkte, die erforderlich sind, damit dieses Produkt seine Basisfunktionen ausführen kann.

ADFzCC hat keine obligatorischen betrieblichen Anforderungen.

Bedingte zusätzlich erforderliche Software für den Betrieb sind Produkte, die nicht erforderlich sind, damit dieses Produkt seine Basisfunktionen ausführen kann, aber zur Laufzeit erforderlich sind, damit dieses Produkt spezifische Funktionen ausführen kann. Diese Produkte werden als IF REQs bezeichnet.

ADFzCC hat keine bedingten betrieblichen Anforderungen.

Zusätzlich erforderliche Software für Tolerierung/Koexistenz

Zusätzlich erforderliche Software für Tolerierung/Koexistenz sind Produkte, die auf gemeinsam genutzten Systemen vorhanden sein müssen. Diese Systeme können andere Systeme in einer Mehrsystemumgebung (nicht unbedingt Sysplex), einer gemeinsam genutzten DASD-Umgebung (zum Beispiel Test oder Produktion) oder Systeme sein, die dieselbe DASD-Umgebung zu unterschiedlichen Zeitintervallen wiederverwendet.

ADFzCC es gibt keine Voraussetzungen für Toleranz/Koexistenz.

(Negative) zusätzlich erforderliche Software für Inkompatibilität

Negative Anforderungen kennzeichnen Produkte, die nicht auf demselben System wie dieses Produkt installiert werden dürfen.

ADFzCC hat keine negativen Voraussetzungen.

DASD-Speicherbedarf

ADFzCC bibliotheken können auf allen unterstützten DASD-Typen gespeichert werden.

Tabelle 7 listet den Gesamtspeicherbereich auf, der für die einzelnen Bibliothekstypen erforderlich ist.

Tabelle 7. Gesamter DASD-Speicherplatz, der von ADFzCC benötigt wird – Basis

Tabelle 8. Gesamter DASD-Speicherplatzbedarf von ADFzCC -- JPN

Hinweise:

1. Für Nicht-RECFM U-Dateien empfiehlt IBM, vom System ermittelte Blockgrößen für eine effiziente DASD-Nutzung zu verwenden. Für RECFM U-Dateien empfiehlt IBM, die Blockgröße 32760 zu verwenden, die in Bezug auf Leistung und DASD-Nutzung am effizientesten ist.

2. Folgende Abkürzungen werden für Dateitypen verwendet.

   U	Eindeutige Datei, die von diesem Produkt zugeordnet und nur von diesem Produkt verwendet wird. Diese Tabelle enthält alle erforderlichen Informationen, um den richtigen Speicher für diese Datei zu ermitteln. Sie müssen nicht in anderen Tabellen oder Programmverzeichnissen nach der Dateigröße sehen.
   S	Gemeinsam genutzte Datei, die von diesem Produkt zugeordnet und von diesem Produkt und anderen Produkten verwendet wird. Um den richtigen für diese Datei benötigten Speicher zu ermitteln, addieren Sie die in dieser Tabelle vorgegebene Speichergröße zu den in anderen Tabellen (oder anderen Programmverzeichnissen) vorgegebenen Speichergrößen. Wenn die Datei bereits vorhanden ist, muss sie ausreichend freien Speicherplatz haben, um die in dieser Tabelle vorgegebene Speichergröße aufzunehmen.
   E	Vorhandene gemeinsam genutzte Datei, die von diesem Produkt oder anderen Produkten verwendet wird. Diese Datei wird nicht von diesem Produkt zugeordnet. Um den richtigen für diese Datei benötigten Speicher zu ermitteln, addieren Sie die in dieser Tabelle (oder anderen Programmverzeichnissen) vorgegebene Speichergröße zu den in anderen Tabellen vorgegebenen Speichergrößen. Wenn die Datei bereits vorhanden ist, muss sie ausreichend freien Speicherplatz haben, um die in dieser Tabelle vorgegebene Speichergröße aufzunehmen.

   Wenn Sie derzeit ein früheres Release dieses Produkts in diesen Bibliotheken installiert haben, löscht die Installation dieses Release das alte Release und gibt den Speicherplatz frei, der vom alten Release und allen installierten Services verwendet wurde. Sie können ermitteln, ob diese Bibliotheken ausreichend Speicherplatz haben, indem Sie das alte Release mit einer Dummy-Funktion löschen, die Bibliotheken komprimieren und den Speicherbedarf mit dem freien Speicherplatz in den Bibliotheken vergleichen.

   Weitere Informationen über die Namen und Größen der erforderlichen Dateien finden Sie unter "SMP/E-Ziel- und Verteilungsbibliotheken zuordnen".

3. Alle aufgelisteten Ziel- und Verteilungsbibliotheken haben die folgenden Attribute:
   • Der Standardname der Datei kann geändert werden.
   • Die Standardblockgröße der Datei kann geändert werden.
   • Die Datei kann mit einer anderen Datei zusammengeführt werden, die gleichwertige Merkmale hat.
   • Die Datei kann entweder eine PDS oder eine PDSE sein, mit einigen Ausnahmen. Die Ausnahmen sind nach der Tabelle aufgeführt.

4. Alle aufgelisteten Zielbibliotheken haben die folgenden Attribute:
   • Diese Dateien können mit SMS verwaltet werden, das ist aber nicht erforderlich.
   • Diese Dateien müssen sich nicht auf dem IPL-Datenträger befinden.
   • Die Werte in der Spalte "Teildateityp" sind nicht unbedingt die eigentlichen SMP/E-Elementtypen, die im SMPMCS gekennzeichnet sind.

5. Alle Zielbibliotheken, die aufgelistet sind und Lademodule enthalten, haben die folgenden Attribute:
   • Die Dateien können nicht im LPA sein, mit einigen Ausnahmen. Wenn in der Spalte "Teildateityp" der Wert "LPA" steht, soll die Datei im LPA gespeichert werden.
   • Diese Dateien können im LNKLST sein.
   • Diese Dateien müssen nicht APF-autorisiert sein, mit einigen Ausnahmen. Die Ausnahmen sind nach der Tabelle aufgeführt.
   • Überprüfen Sie Ihre SMPLTS-Zuweisung, wenn in der Tabelle angegeben ist, dass eine Ladebibliothek ("RECFM"-Spalte gibt U an) eine PDSE sein muss ("DIR Blks"-Spalte gibt N/A an). Wenn Sie bereits über eine SMPLTS verfügen und es sich dabei um eine PDS handelt, müssen Sie eine neue PDSE zuweisen und Ihre SMPLTS in diese kopieren. Ändern Sie dann den SMPLTS DDDEF-Eintrag, um den neuen PDSE-Datensatz anzugeben.

Die folgenden Abbildungen beschreiben die Ziel- und Verteilerbibliotheken, die für die Installation von ADFzCC erforderlich sind. Der Speicherbedarf von ADFzCC muss zu dem Speicherbedarf anderer Programme addiert werden, die Daten in derselben Bibliothek haben.

Hinweis: Ermitteln Sie mithilfe der Daten in diesen Tabellen, welche Bibliotheken in gemeinsame Dateien zusammengeführt werden können. Da einige ALIAS-Namen möglicherweise nicht eindeutig sein können, müssen Sie sicherstellen, dass keine Namenskonflikte vor dem Zusammenführen von Bibliotheken eingeführt werden.

Tabelle 9. Speicheranforderungen für ADFzCC -Zielbibliotheken – Basis

• SIPVLPA1 muss ein PDS sein.

• SIPVMODA muss ein PDSE sein.

• SIPVMOD1 muss ein PDSE sein.

• SIPVMODA muss von APF autorisiert sein.

Tabelle 10. Speicheranforderungen für ADFzCC -Zielbibliotheken – JPN

Tabelle 11. Speicheranforderungen für ADFzCC -Verteilerbibliotheken – Basis

• AIPVLPA1 muss ein PDS sein.

• AIPVMODA muss ein PDSE sein.

• AIPVMOD1 muss ein PDSE sein.

Tabelle 12. Speicheranforderungen für ADFzCC -Verteilerbibliotheken – JPN

Der Rest dieses Abschnitts gilt nur, wenn ADFzCC aus dem Internet heruntergeladen wird. Sie ist nicht zutreffend, wenn Sie es über Shopz bestellt haben.
Wählen Sie diesen Link aus, um zum nächsten Abschnitt zu gelangen: "FMIDs gelöscht"

Die folgenden Abbildungen listen Datensätze auf, die nicht von ADFzCC, verwendet werden, aber als Eingabe für SMP/E erforderlich sind.

Tabelle 13. Speicheranforderungen für ADFzCC -Web-Download-Datensätze – Basis

• hlq.IBM.HVWR1A0.F3 und hlq.IBM.HVWR1A0.F9 muss ein PDS sein.

• hlq.IBM.HVWR1A0.F7 und hlq.IBM.HVWR1A0.F8 muss ein PDSE sein.

Tabelle 14. Speicheranforderungen für ADFzCC -Web-Download-Datensätze – JPN

• hlq.IBM.JVWR1A1.F2 muss ein PDS sein.

• hlq.IBM.JVWR1A1.F6 muss ein PDSE sein.

Löschung von FMIDs

Die Installation von ADFzCC kann zur Löschung anderer FMIDs führen. Um zu sehen, welche FMIDs gelöscht werden, sehen Sie sich die ++VER-Anweisung im SMPMCS des Produkts an.

Wenn Sie diese FMIDs derzeit nicht löschen möchten, installieren Sie ADFzCC in separaten SMP/E-Ziel- und Verteilungszonen.

Hinweis: Diese FMIDs werden nicht automatisch von der globalen Zone gelöscht. Wenn Sie diese FMIDs von der globalen Zone möchten, verwenden Sie den Befehl SMP/E REJECT NOFMID DELETEFMID. Details finden Sie im Handbuch mit SMP/E-Befehlen.

Spezielle Hinweise

PDSE-Überlegungen:

ADFzCC verwendet das "partitioned data set extended"- oder PDSE-Format für seine Zielbibliotheken. Es gibt einige Unterschiede zwischen PDS- und PDSE-Datensätzen. Das PDS-Format kann von mehr als einem z/OS -System gemeinsam genutzt werden und es sind keine besonderen Vorsichtsmaßnahmen erforderlich. Das PDSE-Format kann jedoch nur von z/OS -Systemen gemeinsam genutzt werden, die Teil eines Sysplex sind oder über Global Resource Serialization (GRS) verbunden sind (sich in einem GRS-Komplex befinden). Wenn z/OS -Systeme einen PDSE-Datensatz außerhalb einer Sysplex- oder GRS-Umgebung gemeinsam nutzen, können beim Aktualisieren des Datensatzes schwerwiegende Probleme auftreten. Dies liegt daran, dass die PDSE-Verzeichnisinformationen im Speicher zwischengespeichert werden. Wenn der Datensatz von einem System aus aktualisiert wird, erhalten die anderen Systeme keine Informationen über die Aktualisierung, sodass ihre zwischengespeicherten Verzeichnisinformationen falsch sind.

Sie müssen darauf achten, dass Sie die Bibliotheken nicht zwischen z/OS -Systemen teilen, es sei denn, sie befinden sich in einem Sysplex oder sind in einem GRS-Komplex verbunden. Wenn Sie den Inhalt der Bibliotheken teilen möchten, muss für jedes z/OS -System eine separate Kopie erstellt werden.

Installationsanweisungen

In diesem Kapitel werden die Installationsmethode und die schrittweisen Verfahren zur Installation und Aktivierung der Funktionen von ADFzCC beschrieben.

Beachten Sie die folgenden Punkte:

• Wenn Sie ADFzCC in einer eigenen SMP/E-Umgebung installieren möchten, finden Sie in den SMP/E-Handbüchern Anweisungen zum Erstellen und Initialisieren der SMPCSI und der SMP/E-Steuerdatensätze.

• Sie können mithilfe der bereitgestellten Beispieljobs einen Teil oder alle Installationsaufgaben ausführen. Die SMP/E-Jobs setzen voraus, dass alle DDDEF-Einträge, die für die SMP/E-Ausführung erforderlich sind, in den entsprechenden Zonen definiert wurden.

• Sie können die SMP/E-Dialoge anstelle der Beispieljobs verwenden, um die SMP/E-Installationsschritte auszuführen.

Installieren ADFzCC

SMP/E-Überlegungen zur Installation ADFzCC

Verwenden Sie die SMP/E-Befehle RECEIVE, APPLY und ACCEPT, um diese Version von ADFzCC zu installieren.

Werte für Untereinträge des SMP/E-Eintrags OPTIONS

Die empfohlenen Werte für bestimmte SMP/E-CSI-Untereinträge sind in Tabelle 15 aufgeführt. Wenn Sie niedrigere Werte als die empfohlenen Werte verwenden, kann es zu Fehlern bei der Installation kommen. DSSPACE ist ein Untereintrag im OPTIONS-Eintrag für globale Zonen. PEMAX ist ein Untereintrag des GENERAL-Eintrags im OPTIONS-Eintrag für globale Zonen. Anweisungen zur Aktualisierung der globalen Zone finden Sie in den SMP/E-Handbüchern.

Tabelle 15. Untereintragswerte für SMP/E-Optionen

Übersicht über die Installationsschritte

Übersicht über die erforderlichen Schritte zur Installation von IBM Application Delivery Foundation for z/OS Gemeinsame Komponenten.

1. Ordnen Sie das Dateisystem zu, um das Web-Download-Paket zu halten
   (nur für Web-Download anwendbar, nicht für Shopz-Bestellungen)

2. Laden Sie das Web-Download-Paket auf den Host
   hoch (nur für den Web-Download, nicht für Shopz-Bestellungen)

3. Extrahieren und erweitern Sie die komprimierten SMPMCS und RELFILEs
   (nur für den Web-Download, nicht für Shopz-Bestellungen)

   Wählen Sie diesen Link aus, um die Web-Download-spezifischen Schritte zu überspringen: "Beispieljobs"

4. SMP/E-Umgebung erstellen (optional)

5. SMP/E RECEIVE ausführen

6. SMP/E-Ziel- und Verteilungsbibliotheken zuordnen

7. DDDEF-Einträge erstellen

8. SMP/E APPLY ausführen

9. Aktivieren/Registrieren ADFzCC

10. Alte Registrierungen entfernen

11. Führen Sie die Installationsüberprüfungsprogramme (IVPs) aus

12. Überprüfen Sie die Funktion "Utilities Setup Utility" von ADFzCC

13. SMP/E ACCEPT ausführen

14. REPORT CROSSZONE ausführen

Dateisystem zur Speicherung des Web-Downloadpakets zuordnen

Dieser Abschnitt gilt nur, wenn ADFzCC aus dem Internet heruntergeladen wird. Er ist nicht zutreffend, wenn es über Shopz bestellt wird.
Wählen Sie diesen Link aus, um die Schritte zum Herunterladen im Web zu überspringen: "Beispieljobs"

Die SMP/E-Eingabedatensätze zur Installation IBM Application Delivery Foundation for z/OS Gemeinsame Komponenten werden als komprimierte Dateien in Archiven bereitgestellt HVWR1A0.pax.Z und JVWR1A1.pax.Z, die als z/OS UNIX-Datei auf z/OS hochgeladen werden müssen. Sie können entweder ein neues z/OS UNIX-Dateisystem (zFS) erstellen oder ein neues Verzeichnis in einem vorhandenen Dateisystem erstellen, um das Downloadpaket zu speichern.

Sie können die folgende Beispiel-JCL verwenden, um ein neues Dateisystem und Verzeichnis für das Downloadpaket zu erstellen. In diesem Beispiel wird davon ausgegangen, dass Sie nur die Basisfunktion (FMID HVWR1A0 ) hochladen. Die Größe des Dateisystems muss erhöht werden, wenn Sie auch andere Features einschließen:

• Grundfunktion, bereitgestellt in HVWR1A0.pax.Z: 390 Titel

• Japanischer Beitrag, bereitgestellt von JVWR1A1.pax.Z: 18 Titel

//FILESYS JOB <job information>
//*
//* - Geben Sie gültige Jobkarteninformationen an
//* - Ändern Sie:
//*   @zfs_path@
//*   ----+----1----+----2----+----3----+----4----+----5
//*              - In den absoluten z/OS UNIX-Pfad für das
//*                Downloadpaket (beginnend mit /)
//*              - Die max. Länge beträgt 50 Zeichen
//*                  - Geben Sie keinen abschließenden / ein
//*   @zfs_dsn@
//*              - In den Datasetnamen Ihres Dateisystems
//*
//* Ihre Benutzer-ID MUSS als SUPERUSER definiert sein,
//* damit dieser Job erfolgreich ausgeführt werden kann
//*
//CREATE   EXEC PGM=IDCAMS,REGION=0M,COND=(0,LT)
//SYSPRINT DD SYSOUT=*
//SYSIN    DD *
  DEFINE CLUSTER ( -
         NAME(@zfs_dsn@) -
         TRK(390 10) -
         LINEAR -
         SHAREOPTIONS(3) -
         )
//*
//         SET ZFSDSN='@zfs_dsn@'
//FORMAT   EXEC PGM=IOEAGFMT,REGION=0M,COND=(0,LT),
// PARM='-aggregate &ZFSDSN. -compat'
//*STEPLIB  DD DISP=SHR,DSN=IOE.SIOELMOD        before z/OS 1.13
//*STEPLIB  DD DISP=SHR,DSN=SYS1.SIEALNKE       from z/OS 1.13
//SYSPRINT DD SYSOUT=*
//*
//MOUNT    EXEC PGM=IKJEFT01,REGION=0M,COND=(0,LT)
//SYSEXEC  DD DISP=SHR,DSN=SYS1.SBPXEXEC
//SYSTSPRT DD SYSOUT=*
//SYSTSIN DD *
  PROFILE MSGID WTPMSG
  oshell umask 0022; +
    mkdir -p @zfs_path@
  MOUNT +
    FILESYSTEM('@zfs_dsn@') +
    MOUNTPOINT('@zfs_path@') +
    MODE(RDWR) TYPE(ZFS) PARM('AGGRGROW')
//*

Erwartete Rückgabecodes und Nachrichten: Sie erhalten den Rückgabecode 0 zurück, wenn dieser Job korrekt ausgeführt wird.

Web-Downloadpaket auf den Host hochladen

Dieser Abschnitt gilt nur, wenn ADFzCC aus dem Internet heruntergeladen wird. Er ist nicht zutreffend, wenn es über Shopz bestellt wird.
Wählen Sie diesen Link aus, um die Schritte zum Herunterladen im Web zu überspringen: "Beispieljobs"

Laden Sie die Datei HVWR1A0.readme.txt und bei Bedarf JVWR1A1.readme.txt im Textformat und die Datei HVWR1A0.pax.Z und bei Bedarf JVWR1A1.pax.Z im Binärformat von Ihrer Workstation in das UNIX-Dateisystem z/OS hoch.

Im folgenden Beispieldialog verwenden wir FTP von einer Microsoft Windows- Befehlszeile, um den Transfer durchzuführen. Befehle oder andere vom Benutzer eingegebene Informationen sind fett gedruckt und die folgenden Werte werden angenommen:

Tabelle 16. Vom Benutzer eingegebene Werte

Geben Sie diese Befehle ein, um die ADFzCC -Basis hochzuladen:

C:\>ftp mvsaddr
Connected to mvsaddr.
220-FTPD1 IBM FTP CS %version% at mvsaddr, %time% on %date%.
220 Connection will close if idle for more than 5 minutes.
User (mvsaddr:(none)): tsouid
331 Send password please.
Password: tsopw
230 tsouid wird angemeldet.  Das Arbeitsverzeichnis ist "tsouid.".
ftp> cd @zfs_path@
250 HFS directory @zfs_path@ ist das aktuelle Arbeitsverzeichnisftp> ascii
200 Darstellungsart ist Ascii NonPrintftp> put d:\HVWR1A0.readme.txt
200 Port request OK.
125 Datensätze speichern @zfs_path@/HVWR1A0.readme.txt
250 Transfer completed successfully.
ftp: 20574 Bytes in 0.01 Sek. gesendet. (1366,67 Kb/s)ftp> binary
200 Darstellungstyp ist Imageftp> put d:\HVWR1A0.pax.Z
200 Port request OK.
125 Datensätze speichern @zfs_path@/HVWR1A0.pax.Z
250 Transfer completed successfully.
ftp: 5419008 Bytes in 1.26 Sek. gesendet. (1040,52 Kb/s)ftp> quit
221 Quit-Befehl empfangen. Auf Wiedersehen.

Geben Sie diese Befehle ein, um die japanische Funktion von ADFzCC hochzuladen:

C:\>ftp mvsaddr
Connected to mvsaddr.
220-FTPD1 IBM FTP CS %version% at mvsaddr, %time% on %date%.
220 Connection will close if idle for more than 5 minutes.
User (mvsaddr:(none)): tsouid
331 Send password please.
Password: tsopw
230 tsouid wird angemeldet.  Das Arbeitsverzeichnis ist "tsouid.".
ftp> cd @zfs_path@
250 HFS directory @zfs_path@ ist das aktuelle Arbeitsverzeichnisftp> ascii
200 Darstellungsart ist Ascii NonPrintftp> put d:\JVWR1A1.readme.txt
200 Port request OK.
125 Datensätze speichern @zfs_path@/JVWR1A1.readme.txt
250 Transfer completed successfully.
ftp: 19521 Bytes gesendet in 0,01 sec. (1323,80 Kb/s)ftp> binary
200 Darstellungstyp ist Imageftp> put d:\JVWR1A1.pax.Z
200 Port request OK.
125 Datensätze speichern @zfs_path@/JVWR1A1.pax.Z
250 Transfer completed successfully.
ftp: 96768 Bytes in 1.26 Sek. gesendet. (1115,22 Kb/s)ftp> quit
221 Quit-Befehl empfangen. Auf Wiedersehen.

Komprimierte SMPMCS und RELFILEs extrahieren

Dieser Abschnitt gilt nur, wenn ADFzCC aus dem Internet heruntergeladen wird. Er ist nicht zutreffend, wenn es über Shopz bestellt wird.
Wählen Sie diesen Link aus, um die Schritte zum Herunterladen im Web zu überspringen: "Beispieljobs"

Die im vorherigen Schritt hochgeladenen Dateien HVWR1A0.readme.txt und JVWR1A1.readme.txt enthalten jeweils eine JCL-Probe, um die komprimierten SMPMCS- und RELFILEs aus den hochgeladenen Dateien HVWR1A0.pax.Z und JVWR1A1.pax.Z in Datensätze zur Verwendung durch den SMP/E-RECEIVE-Job zu erweitern. Die JCLs werden hier aus Gründen der Benutzerfreundlichkeit wiederholt.

• @zfs_path@ stimmt mit der Variablen überein, die Sie im vorherigen Schritt angegeben haben.

• Wenn der 'oshell'-Befehl RC=256 und die Nachricht "pax: checksum error on tape (got ee2e, expected 0)" zurückgibt, dann wurde die Archivdatei nicht im Binärformat auf den Host hochgeladen.

• GIMUNZIP ordnet Dateien zu, die den Definitionen der Originaldateien entsprechen sollen. Es können Fehler auftreten, wenn Ihre SMS ACS-Routinen die von GIMUNZIP verwendeten Attribute ändern. Wenn das passiert, geben Sie einen nicht mit SMS verwalteten Datenträger für die GIMUNZIP-Zuordnung der Dateien an. Beispiel:
  <ARCHDEF archid="..."
  storclas="storage_class" volume="data_set_volume"
  newname="..."/>

Passen Sie diese JCL an und senden Sie sie, um die ADFzCC -Datenbank zu erweitern:

//EXTRACT JOB <job information>
//*
//* - Geben Sie gültige Jobkarteninformationen an
//* - Ändern Sie:
//*       @PREFIX@
//*       ----+----1----+----2----+
//*                  - In das gewünschte Präfix für den Datasetnamen
//*                  - Die max. Länge beträgt 25 Zeichen
//*                  - Dieser Wert wird für die Namen der Datasets verwendet,
//*                    die aus dem Downloadpaket extrahiert wurden
//*   @zfs_path@
//*   ----+----1----+----2----+----3----+----4----+----5
//*                  - To the absolute z/OS UNIX path for the
//*                    download-package (starting with /)
//*              - Die max. Länge beträgt 50 Zeichen
//*                  - Geben Sie keinen abschließenden / ein
//*
//UNPAX    EXEC PGM=IKJEFT01,REGION=0M,COND=(0,LT)
//SYSEXEC  DD DISP=SHR,DSN=SYS1.SBPXEXEC
//SYSTSPRT DD SYSOUT=*
//SYSTSIN DD *
  oshell cd @zfs_path@/ ; +
    pax -rvf HVWR1A0.pax.Z
//*
//GIMUNZIP EXEC PGM=GIMUNZIP,REGION=0M,COND=(0,LT)
//*STEPLIB  DD DISP=SHR,DSN=SYS1.MIGLIB
//SYSUT3   DD UNIT=SYSALLDA,SPACE=(CYL,(50,10))
//SYSUT4   DD UNIT=SYSALLDA,SPACE=(CYL,(25,5))
//SMPOUT   DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SMPDIR   DD PATHDISP=KEEP,
// PATH='@zfs_path@/'
//SYSIN    DD *

< GIMUNZIP>
<ARCHDEF archid="IBM.HVWR1A0.SMPMCS"
         newname="@PREFIX@.IBM.HVWR1A0.SMPMCS"/>
<ARCHDEF archid="IBM.HVWR1A0.F1 "
         newname="@PREFIX@.IBM.HVWR1A0.F1"/>
<ARCHDEF archid="IBM.HVWR1A0.F2 "
         newname="@PREFIX@.IBM.HVWR1A0.F2"/>
<ARCHDEF archid="IBM.HVWR1A0.F3 "
         newname="@PREFIX@.IBM.HVWR1A0.F3"/>
<ARCHDEF archid="IBM.HVWR1A0.F4 "
         newname="@PREFIX@.IBM.HVWR1A0.F4"/>
<ARCHDEF archid="IBM.HVWR1A0.F5 "
         newname="@PREFIX@.IBM.HVWR1A0.F5"/>
<ARCHDEF archid="IBM.HVWR1A0.F6 "
         newname="@PREFIX@.IBM.HVWR1A0.F6"/>
<ARCHDEF archid="IBM.HVWR1A0.F7 "
         newname="@PREFIX@.IBM.HVWR1A0.F7"/>
<ARCHDEF archid="IBM.HVWR1A0.F8 "
         newname="@PREFIX@.IBM.HVWR1A0.F8"/>
<ARCHDEF archid="IBM.HVWR1A0.F9 "
         newname="@PREFIX@.IBM.HVWR1A0.F9"/>
< /GIMUNZIP>
//*

Passen Sie diese JCL an und senden Sie sie ein, um die japanische Funktion von ADFzCC zu erweitern:

//EXTRACT JOB <job information>
//*
//* - Geben Sie gültige Jobkarteninformationen an
//* - Ändern Sie:
//*       @PREFIX@
//*       ----+----1----+----2----+
//*                  - In das gewünschte Präfix für den Datasetnamen
//*                  - Die max. Länge beträgt 25 Zeichen
//*                  - Dieser Wert wird für die Namen der Datasets verwendet,
//*                    die aus dem Downloadpaket extrahiert wurden
//*   @zfs_path@
//*   ----+----1----+----2----+----3----+----4----+----5
//*                  - To the absolute z/OS UNIX path for the
//*                    download-package (starting with /)
//*              - Die max. Länge beträgt 50 Zeichen
//*                  - Geben Sie keinen abschließenden / ein
//*
//UNPAX    EXEC PGM=IKJEFT01,REGION=0M,COND=(0,LT)
//SYSEXEC  DD DISP=SHR,DSN=SYS1.SBPXEXEC
//SYSTSPRT DD SYSOUT=*
//SYSTSIN DD *
  oshell cd @zfs_path@/ ; +
    pax -rvf JVWR1A1.pax.Z
//*
//GIMUNZIP EXEC PGM=GIMUNZIP,REGION=0M,COND=(0,LT)
//*STEPLIB  DD DISP=SHR,DSN=SYS1.MIGLIB
//SYSUT3   DD UNIT=SYSALLDA,SPACE=(CYL,(50,10))
//SYSUT4   DD UNIT=SYSALLDA,SPACE=(CYL,(25,5))
//SMPOUT   DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SMPDIR   DD PATHDISP=KEEP,
// PATH='@zfs_path@/'
//SYSIN    DD *

< GIMUNZIP>
<ARCHDEF archid="IBM.JVWR1A1.SMPMCS"
         newname="@PREFIX@.IBM.JVWR1A1.SMPMCS"/>
<ARCHDEF archid="IBM.JVWR1A1.F1 "
         newname="@PREFIX@.IBM.JVWR1A1.F1"/>
<ARCHDEF archid="IBM.JVWR1A1.F2 "
         newname="@PREFIX@.IBM.JVWR1A1.F2"/>
<ARCHDEF archid="IBM.JVWR1A1.F3 "
         newname="@PREFIX@.IBM.JVWR1A1.F3"/>
<ARCHDEF archid="IBM.JVWR1A1.F4 "
         newname="@PREFIX@.IBM.JVWR1A1.F4"/>
<ARCHDEF archid="IBM.JVWR1A1.F5 "
         newname="@PREFIX@.IBM.JVWR1A1.F5"/>
<ARCHDEF archid="IBM.JVWR1A1.F6 "
         newname="@PREFIX@.IBM.JVWR1A1.F6"/>
< /GIMUNZIP>
//*

Beispieljobs

Die folgenden Beispielinstallationsjobs sind Teil des Produkts, um Ihnen bei der Installation von ADFzCC: zu helfen

Tabelle 17. Beispielinstallationsjobs -- BASE

Tabelle 18. Beispiele für Installationsjobs – JPN

Der Rest dieses Abschnitts gilt nur, wenn ADFzCC über Shopz bestellt wird. Er ist nicht zutreffend, wenn Sie es aus dem Web heruntergeladen haben.
Wählen Sie diesen Link aus, um zum nächsten Abschnitt zu gelangen: "SMP/E-Umgebung erstellen (optional)"

Sie können auf die Beispielinstallationsjobs zugreifen, indem Sie eine SMP/E-Anweisung RECEIVE ausführen (siehe "SMP/E RECEIVE ausführen") und anschließend die Jobs aus den SMPTLIB-Dateien in eine Arbeitsdatei kopieren, die für die Bearbeitung und die Übergabe definiert ist. Informationen zum Suchen der entsprechenden Datei finden Sie unter Tabelle 17.

Sie können die Beispielinstallationsjobs auch aus den Produktdateien kopieren, indem Sie den folgenden Job übergeben. Bevor Sie den Job übergeben, fügen Sie eine Jobkarte hinzu und ändern die kleingeschriebenen Parameter in großgeschriebene Werte, um die Anforderungen Ihrer Site zu erfüllen.

Um die Beispieljobs für ADFzCC Base zu kopieren, verwenden Sie diese JCL:

//STEP1    EXEC PGM=IEBCOPY
//SYSPRINT DD SYSOUT=*
//IN DD DSN=IBM.HVWR1A0.F2,
//            DISP=SHR,
//*           VOL=SER=filevol,
//            UNIT=SYSALLDA
//OUT      DD DSNAME=jcl-library-name,
//            DISP=(NEW,CATLG,DELETE),
//            SPACE=(TRK,(5,5,5)),
//*           VOL=SER=dasdvol,
//            UNIT=SYSALLDA
//SYSUT3   DD UNIT=SYSALLDA,SPACE=(CYL,(1,1))
//SYSIN    DD *
    COPY INDD=IN,OUTDD=OUT
    AUSGEWÄHLTE MITGLIEDER = (IPVWSMPE, IPVWRECV, IPVWALOC)
    AUSGEWÄHLTE MITGLIEDER = (IPVWDDEF, IPVWAPLY, IPVWACPT)
/*

Verwenden Sie diese JCL, um die Beispieljobs für die ADFzCC JPN-Funktion zu kopieren:

//STEP1    EXEC PGM=IEBCOPY
//SYSPRINT DD SYSOUT=*
//IN DD DSN=IBM.HVWR1A0.F2,
//            DISP=SHR,
//*           VOL=SER=filevol,
//            UNIT=SYSALLDA
//OUT      DD DSNAME=jcl-library-name,
//            DISP=(NEW,CATLG,DELETE),
//            SPACE=(TRK,(5,5,5)),
//*           VOL=SER=dasdvol,
//            UNIT=SYSALLDA
//SYSUT3   DD UNIT=SYSALLDA,SPACE=(CYL,(1,1))
//SYSIN    DD *
    COPY INDD=IN,OUTDD=OUT
    AUSGEWÄHLTE MITGLIEDER = (IPVWRCVJ,IPVWALOJ)
    AUSGEWÄHLTE MITGLIEDER = (IPVWDDFJ, IPVWAPLJ, IPVWACPJ)
/*

IN:

filevol ist die Datenträgerfolgenummer der DASD-Einheit, auf der sich die heruntergeladenen Dateien befinden.

OUT:

jcl-library-name ist der Name der Ausgabedatei, in der die Beispieljobs gespeichert werden.

dasdvol ist die Datenträgerfolgenummer der DASD-Einheit, auf der sich die Ausgabedateien befinden. Entfernen Sie die Kommentarzeichen der Anweisung, wenn eine Datenträgerfolgenummer angegeben werden muss.

SMP/E-Umgebung erstellen (optional)

Wenn Sie ein vorhandenes CSI verwenden, führen Sie den Beispielauftrag IPVWSMPE nicht aus.

Wenn Sie eine neue SMP/E-Umgebung für diese Installation erstellen möchten, wird ein Beispieljob bereitgestellt oder Sie können Ihre eigene JCL verwenden. Wenn Sie den bereitgestellten Musterjob verwenden möchten, bearbeiten und senden Sie IPVWSMPE. Weitere Informationen enthalten die Anweisungen im Beispieljob.

Erwartete Rückgabecodes und Nachrichten: Sie erhalten den Rückgabecode 0 zurück, wenn dieser Job korrekt ausgeführt wird.

SMP/E RECEIVE ausführen

Wenn Sie ADFzCC als Teil einer CBPDO erhalten haben, verwenden Sie den RCVPDO-Auftrag im CBPDO-RIMLIB-Datensatz, um die ADFzCC -FMIDs, den Dienst und die HOLDDATA zu erhalten, die im CBPDO-Paket enthalten sind. Weitere Informationen finden Sie in der Dokumentation, die in CBPDO enthalten ist.

Sie können auch die Probeaufgabe IPVWRECV bearbeiten und einreichen, um den SMP/E-RECEIVE-Befehl für ADFzCC auszuführen. Weitere Informationen enthalten die Anweisungen im Beispieljob.

Wenn Ihre Bestellung die japanische Funktion enthält, bearbeiten und senden Sie den Beispielauftrag IPVWRCVJ, um den SMP/E-RECEIVE-Befehl für diese Funktion auszuführen. Weitere Informationen enthalten die Anweisungen im Beispieljob.

Erwartete Rückgabecodes und Nachrichten: Sie erhalten den Rückgabecode 0 zurück, wenn dieser Job korrekt ausgeführt wird.

SMP/E-Ziel- und Verteilungsbibliotheken zuordnen

Bearbeiten und senden Sie den Beispielauftrag IPVWALOC, um die SMP/E-Ziel- und Verteilerbibliotheken für ADFzCC zuzuweisen. Weitere Informationen enthalten die Anweisungen im Beispieljob.

Wenn Ihre Bestellung die japanische Funktion enthält, bearbeiten und senden Sie den Beispielauftrag IPVWALOJ, um die SMP/E-Ziel- und Verteilungsbibliotheken für diese Funktion zuzuweisen. Weitere Informationen enthalten die Anweisungen im Beispieljob.

Erwartete Rückgabecodes und Nachrichten: Sie erhalten den Rückgabecode 0 zurück, wenn dieser Job korrekt ausgeführt wird.

DDDEF-Einträge erstellen

Bearbeiten und senden Sie den Beispielauftrag IPVWDDEF, um DDDEF-Einträge für die SMP/E-Ziel- und Verteilerbibliotheken für ADFzCC zu erstellen. Weitere Informationen enthalten die Anweisungen im Beispieljob.

Wenn Ihre Bestellung die japanische Funktion enthält, bearbeiten und senden Sie den Beispielauftrag IPVWDDFJ, um DDDEF-Einträge für die SMP/E-Ziel- und Verteilungsbibliotheken für diese Funktion zu erstellen. Weitere Informationen enthalten die Anweisungen im Beispieljob.

Erwartete Rückgabecodes und Nachrichten: Sie erhalten den Rückgabecode 0 zurück, wenn dieser Job korrekt ausgeführt wird.

SMP/E APPLY ausführen

1. Stellen Sie sicher, dass Sie über die neueste HOLDDATA verfügen. Bearbeiten und senden Sie dann die Beispielaufgabe IPVWAPLY, um einen SMP/E APPLY CHECK für ADFzCC durchzuführen. Weitere Informationen enthalten die Anweisungen im Beispieljob.

   Wenn Ihre Bestellung die japanische Funktion enthält, bearbeiten und senden Sie den Beispielauftrag IPVWAPLJ, um einen SMP/E APPLY CHECK für diese Funktion durchzuführen. Weitere Informationen enthalten die Anweisungen im Beispieljob.

   Die neueste HOLDDATA-Version ist über verschiedene Portale verfügbar, darunter https://public.dhe.ibm.com/s390/assigns/ oder https://www.ibm.com/support/pages/enhanced-holddata-zos für Nutzungshinweise. Das neueste HOLDDATA kann HIPER und FIXCAT APARs für die FMIDs ermitteln, die Sie installieren. Mit APPLY CHECK können Sie bestimmen, ob HIPER oder FIXCAT APARs auf die FMIDs anwendbar sind, die Sie installieren. Wenn es anwendbare HIPER oder FIXCAT APARs gibt, ermitteln APPLY CHECK auch Fixing-PTFs, die die APARs auflösen, wenn eine Fixing-PTF verfügbar ist.

   Sie sollten die FMIDs unabhängig vom Status der unaufgelösten HIPER oder FIXCAT APARs installieren. Stellen Sie jedoch erst die Software bereit, wenn die unaufgelösten HIPER und FIXCAT APARs analysiert wurden, um deren Anwendbarkeit zu bestimmen. Stellen Sie also vor der Bereitstellung der Software sicher, dass entweder Fixing-PTFs angewendet werden, um alle HIPER oder FIXCAT APARs aufzulösen, oder dass die Probleme, die von allen HIPER oder FIXCAT APARs gemeldet werden, nicht für Ihre Umgebung zutreffend sind.

   Um den SMP/E Causer SYSMOD-Ergebnisbericht voll zu nutzen, umgehen Sie nicht PRE, ID, REQ und IFREQ beim APPLY CHECK. Die SMP/E-Ursachenanalyse erkennt die Ursache nur von Fehlern und nicht von Warnungen (SMP/E behandelt umgangene PRE-, ID-, REQ- und IFREQ-Bedingungen als Warnungen und nicht als Fehler).

   Hier sind Beispiele von APPLY-Befehlen:

   1. Um sicherzustellen, dass alle empfohlenen und kritischen Services mit den FMIDs installiert werden, rufen Sie das neueste HOLDDATA ab und verwenden Sie den APPLY CHECK-Befehl wie folgt:

      APPLY S(fmid,fmid,...) CHECK
      FORFMID(fmid,fmid,...)
      SOURCEID(RSU*)
      FIXCAT(IBM.PRODUCTINSTALL-REQUIREDSERVICE)
      GROUPEXTEND .
      

      
      

      Einige HIPER APARs haben unter Umständen noch keine Fixing-PTFs. Sie sollten die Symptom-Flags für die unaufgelösten HIPER APARs analysieren, um zu ermitteln, ob das gemeldete Problem für Ihre Umgebung zutreffend ist und ob Sie die spezifischen ERROR HOLDs umgehen sollen, um die Installation der FMIDs fortzusetzen.

      Diese Methode erfordert mehr Vorlaufforschung, kann aber die Auflösung aller HIPERs ermöglichen, für die Fixing-PTFs verfügbar sind und die nicht in einer PE-Kette sind. Unaufgelöste PEs oder HIPERs können noch vorhanden sein und die Verwendung von BYPASS erfordern.

   2. Um die FMIDs unabhängig von unaufgelösten HIPER APARs zu installieren, können Sie den Operanden BYPASS(HOLDCLASS(HIPER)) zum APPLY CHECK-Befehl hinzufügen. So können Sie FMIDs installieren, auch wenn ein oder mehrere unaufgelöste HIPER APARs vorhanden sind. Nachdem die FMIDs installiert sind, verwenden Sie den SMP/E REPORT ERRSYSMODS-Befehl, um unaufgelöste HIPER APARs und Fixing-PTFs zu ermitteln.

      APPLY S(fmid,fmid,...) CHECK
      FORFMID(fmid,fmid,...)
      SOURCEID(RSU*)
      FIXCAT(IBM.PRODUCTINSTALL-REQUIREDSERVICE)
      GROUPEXTEND
      BYPASS(HOLDCLASS(HIPER)) .
       .. alle anderen Parameter, die im Programmverzeichnis dokumentiert sind
      

      Diese Methode ist schneller, erfordert aber eine nachfolgende Prüfung des Exception SYSMOD-Berichts, der vom REPORT ERRSYSMODS-Befehl generiert wird, um unaufgelöste HIPERs zu ermitteln. Wenn Sie das neueste HOLDDATA abgerufen haben, können Sie auch den REPORT MISSINGFIX- Befehl verwenden und die Fixkategorie IBM.PRODUCTINSTALL-REQUIREDSERVICE angeben, um fehlende empfohlene Services zu ermitteln.

      Wenn Sie HOLDs bei der Installation der FMIDs umgehen, weil noch keine Fixing-PTFs verfügbar sind, können Sie benachrichtigt werden, wenn die Fixing-PTFs verfügbar sind, indem Sie die APAR Status Tracking (AST)- Funktion von ServiceLink oder die APAR Tracking-Funktion von ResourceLink verwenden.

2. Nachdem Sie die von APPLY CHECK angegebenen Aktionen ausgeführt haben, entfernen Sie den CHECK-Operanden und führen den Job erneut aus, um den APPLY-Befehl auszuführen.

   Hinweis: Der GROUPEXTEND-Operand gibt an, dass SMP/E alle Anforderungs- SYSMODs anwendet. Die Anforderungs-SYSMODS sind unter Umständen auf andere Funktionen anwendbar.

   Erwartete Rückgabecodes und Nachrichten von APPLY CHECK: Sie erhalten den Rückgabecode 0 zurück, wenn dieser Job korrekt ausgeführt wird.

   Erwartete Rückgabecodes und Nachrichten von APPLY: Sie erhalten den Rückgabecode 0 zurück, wenn dieser Job korrekt ausgeführt wird.

SMP/E ACCEPT ausführen

Bearbeiten und senden Sie den Beispielauftrag IPVWACPT, um einen SMP/E ACCEPT CHECK für ADFzCC durchzuführen. Weitere Informationen enthalten die Anweisungen im Beispieljob.

Wenn Ihre Bestellung die japanische Funktion enthält, bearbeiten und senden Sie den Beispielauftrag IPVWACPJ, um eine SMP/E ACCEPT CHECK für diese Funktion durchzuführen. Weitere Informationen enthalten die Anweisungen im Beispieljob.

Um den SMP/E Causer SYSMOD-Ergebnisbericht voll zu nutzen, umgehen Sie nicht PRE, ID, REQ und IFREQ bei ACCEPT CHECK. Die SMP/E-Ursachenanalyse erkennt die Ursache nur von Fehlern, aber nicht von Warnungen (SMP/E behandelt umgangene PRE-, ID-, REQ- und IFREQ-Bedingungen als Warnungen und nicht als Fehler).

Bevor Sie mit SMP/E neue Verteilungsbibliotheken laden, wird empfohlen, den ACCJCLIN-Indikator in der Verteilerzone zu setzen. So können Sie die Einträge speichern, die von JCLIN in der Verteilerzone immer dann generiert werden, wenn ein SYSMOD, der Inline-JCLIN enthält, akzeptiert wird. Weitere Informationen über den ACCJCLIN-Indikator finden Sie in der Beschreibung von Inline-JCLIN im Handbuch mit SMP/E-Befehlen.

Nachdem Sie die von ACCEPT CHECK angegebenen Aktionen ausgeführt haben, entfernen Sie den CHECK-Operanden und führen den Job erneut aus, um den ACCEPT-Befehl auszuführen.

Hinweis: Der GROUPEXTEND-Operand gibt an, dass SMP/E alle Anforderungs- SYSMODs akzeptiert. Die Anforderungs-SYSMODS sind unter Umständen auf andere Funktionen anwendbar.

Erwartete Rückgabecodes und Nachrichten von ACCEPT CHECK: Sie erhalten den Rückgabecode 0 zurück, wenn dieser Job korrekt ausgeführt wird.

Wenn PTFs akzeptiert werden, die Ersatzmodule enthalten, stellt die SMP/E ACCEPT-Verarbeitung Programmverbindungen her oder bindet die Module in die Verteilungsbibliotheken. Während dieser Verarbeitung können der Linkage-Editor oder der Binder Nachrichten ausgeben, die unaufgelöste externe Referenzen angeben, die den Rückgabecode 4 während der ACCEPT-Phase zur Folge haben. Sie können diese Nachrichten ignorieren, weil die Verteilungsbibliotheken nicht ausführbar sind und die unaufgelösten externen Referenzen sich nicht auf die ausführbaren Systembibliotheken auswirken.

Erwartete Rückgabecodes und Nachrichten von ACCEPT: Sie erhalten den Rückgabecode 0 zurück, wenn dieser Job korrekt ausgeführt wird.

REPORT CROSSZONE ausführen

Der SMP/E REPORT CROSSZONE-Befehl ermittelt zusätzlich erforderliche Software für Produkte, die in separaten Zonen installiert sind. Dieser Befehl erstellt zudem APPLY- und ACCEPT-Befehle in der SMPPUNCH-Datei. Sie können mit den APPLY- und ACCEPT-Befehlen diese zonenübergreifende zusätzlich erforderliche Software installieren, die der SMP/E REPORT CROSSZONE-Befehl ermittelt.

Nach der Installation von ADFzCC, wird empfohlen, REPORT CROSSZONE für die neuen oder aktualisierten Ziel- und Verteilungszonen auszuführen. REPORT CROSSZONE erfordert eine globale Zone mit ZONEINDEX-Einträgen, die alle Ziel- und Verteilungsbibliotheken beschreiben, für die Berichte erstellt werden sollen.

Weitere Informationen über REPORT CROSSZONE finden Sie in den SMP/E-Handbüchern.

Veraltete Dateien, Pfade und DDDEFs bereinigen

Die in Tabelle 13 aufgeführten Webdownloaddateien (Abschnitt "DASD-Speicheranforderungen") sind temporäre Dateien. Sie können diese Dateien nach Abschluss der Installation von SMP/E löschen.

Produktanpassung

Die Publikation IBM Application Delivery Foundation for z/OS "Common Components Customization and User's Guide" enthält die erforderlichen Informationen zur Anpassung und Verwendung von ADFzCC.

Bemerkungen

Die vorliegenden Informationen wurden für Produkte und Services entwickelt, die auf dem deutschen Markt angeboten werden. Möglicherweise bietet IBM die in dieser Dokumentation beschriebenen Produkte, Services oder Funktionen in anderen Ländern nicht an. Informationen über die gegenwärtig im jeweiligen Land verfügbaren Produkte und Services sind beim zuständigen IBM Ansprechpartner erhältlich. Hinweise auf IBM Lizenzprogramme oder andere IBM Produkte bedeuten nicht, dass nur Programme, Produkte oder Services von IBM verwendet werden können. Anstelle der IBM Produkte, Programme oder Services können auch andere, ihnen äquivalente Produkte, Programme oder Services verwendet werden, solange diese keine gewerblichen oder anderen Schutzrechte von IBM verletzen. Die Verantwortung für den Betrieb von Produkten, Programmen und Services anderer Anbieter liegt beim Kunden.

APAR-Nummern sind in diesem Dokument angegeben, um bei der Suche nach vielleicht erforderlichen PTFs zu helfen. Durch kontinuierliche Problemmeldung können weitere APARs erstellt werden. Daher sind die APAR-Listen in diesem Dokument möglicherweise nicht vollständig. Um aktuelle Serviceempfehlungen zu erhalten und die aktuellen Anforderungen an den Produktservice zu ermitteln, lesen Sie immer die Anweisungen in den Abschnitten "Service Recommendation Summary" und "Service Recommendations and Cross Product Dependencies" der PSP-Bucket-Informationen für IBM Z -Produkte unter https://www.ibm.com/support/pages/node/7127792, um sicherzustellen, dass Sie alle erforderlichen Services erhalten.

Für die Erzeugnisse und Verfahren in diesem Handbuch kann es IBM Patente oder Patentanmeldungen geben. Mit der Auslieferung dieser Dokumentation ist keine Lizenzierung dieser Patente verbunden. Lizenzanforderungen sind schriftlich an folgende Adresse zu richten (Anfragen an diese Adresse müssen auf Englisch formuliert werden):

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

Marken

IBM, das IBM Logo und andere IBM Marken, die auf der IBM Markenliste aufgeführt sind, sind Marken oder eingetragene Marken der International Business Machines Corporation in den USA und/oder anderen Ländern. Weitere Produkt- und Servicenamen können Marken von IBM oder anderen Unternehmen sein. Eine aktuelle Liste der IBM Marken finden Sie auf der Website ibm.com/trademark.

Antwortschreiben

Programmverzeichnis für IBM Application Delivery Foundation for z/OS Gemeinsame Komponenten, Oktober 2024

Wir freuen uns über Ihre Meinung zu dieser Veröffentlichung. Schreiben Sie uns einen Kommentar zu Übersichtlichkeit, Genauigkeit und Vollständigkeit der Informationen oder geben Sie uns anderweitig Ihr Feedback.

Senden Sie Ihre Kommentare per E-Mail an ibmdocs@us.ibm.com und geben Sie dabei folgende Informationen an:

1. Ihr Name und Ihre Adresse

2. Ihre E-Mail-Adresse

3. Ihre Telefon- oder Faxnummer

4. Titel oder Bestellnummer der Veröffentlichung

5. Thema und Seitenzahl, auf die sich Ihr Kommentar bezieht

6. Text Ihres Kommentars

Werden an IBM Informationen eingesandt, gewährt der Einsender IBM ein nicht ausschließliches Recht zur beliebigen Verwendung oder Verteilung dieser Informationen, ohne dass eine Verpflichtung gegenüber dem Einsender entsteht.

IBM oder alle anderen Organisationen verwenden diese von Ihnen angegeben personenbezogenen Daten nur, um Sie zu den von Ihnen gemeldeten Problemen zu kontaktieren.

Vielen Dank für Ihre Mitarbeit. oben.