Zugriff AWS-Services von IBM z/OS aus durch Installation des AWS CLI

Erstellt von Souma Ghosh (AWS), Phil de Valence (AWS) und Paulo Vitor Pereira (AWS)

Übersicht

The AWS Command Line Interface (AWS CLI) ist ein Open-Source-Tool zur Verwaltung mehrerer AWS Dienste mithilfe von Befehlen in einer Befehlszeilen-Shell. Mit minimaler Konfiguration können Sie Befehle von Befehlszeilensitzungen wie der Befehlszeile, dem Terminal und der Bash-Shell aus ausführen, um Funktionen zu implementieren, die der browserbasierten AWS Management Console Version entsprechen.

Alle Administrations-, Management- und Zugriffsfunktionen von AWS Infrastructure as a Service (IaaS) in der AWS Management Console sind in der AWS API und AWS CLI verfügbar. Sie können den AWS CLI auf einem IBM z/OS-Mainframe installieren, um von z/OS aus direkt darauf zuzugreifen, ihn zu verwalten und mit AWS-Services ihm zu interagieren. Das AWS CLI ermöglicht es Benutzern und Anwendungen, verschiedene Aufgaben auszuführen, wie z. B.:

• Übertragung von Dateien oder Datensätzen zwischen z/OS und dem Objektspeicher von Amazon Simple Storage Service (Amazon S3) und Anzeigen des Inhalts von Buckets

• Starten und Stoppen verschiedener AWS Ressourcen, z. B. Starten eines Batch-Jobs in einer Umgebung AWS Mainframe Modernization

• Aufruf einer AWS Lambda Funktion zur Implementierung allgemeiner Geschäftslogik

• Integration mit Diensten für künstliche Intelligenz und maschinelles Lernen (AI/ML) sowie Analysedienste

Dieses Muster beschreibt, wie Sie das AWS CLI auf z/OS installieren, konfigurieren und verwenden. Sie können es global installieren, sodass es für alle z/OS-Benutzer verfügbar ist, oder auf Benutzerebene. Das Muster beschreibt auch, wie der AWS CLI in einer interaktiven Befehlszeilensitzung von z/OS Unix System Services (USS) oder als Batch-Job verwendet wird.

Voraussetzungen und Einschränkungen

Voraussetzungen

• Netzwerkkommunikation von z/OS zu AWS

  Standardmäßig AWS CLI sendet der Anfragen unter Verwendung AWS-Services von HTTPS an TCP-Port 443. Um das AWS CLI erfolgreich verwenden zu können, müssen Sie in der Lage sein, ausgehende Verbindungen über den TCP-Port 443 herzustellen. Sie können jeden der folgenden z/OS USS-Befehle (einige davon sind möglicherweise nicht in Ihrer Umgebung installiert) verwenden, um die Netzwerkkonnektivität von z/OS zu testen: AWS

  ping amazonaws.com
  dig amazonaws.com
  traceroute amazonaws.com
  curl -k https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-welcome.html

• AWS Anmeldedaten

  Um mit AWS Cloud Services von z/OS kommunizieren zu können, AWS CLI müssen Sie einige Anmeldeinformationen mit Zugriffsrechten auf das Ziel konfigurieren. AWS-Konto Für programmatische Befehle können Sie Zugriffsschlüssel verwenden, die aus einer Zugriffsschlüssel-ID und einem geheimen Zugriffsschlüssel bestehen. AWS Wenn Sie noch keine Zugriffsschlüssel besitzen, können Sie diese über die AWS Management Console erstellen. Es hat sich bewährt, die Zugriffsschlüssel für den AWS-Konto Root-Benutzer für keine Aufgabe zu verwenden, es sei denn, der Root-Benutzer ist erforderlich. Erstellen Sie stattdessen einen neuen Administrator-IAM-Benutzer und bereiten Sie sich auf die Berechtigungen mit den geringsten Rechten vor, um den Benutzer mit Zugriffsschlüsseln einzurichten. Nachdem Sie den Benutzer erstellt haben, können Sie eine Zugriffsschlüssel-ID und einen geheimen Zugriffsschlüssel für diesen Benutzer erstellen.

  Warnung AWS Identity and Access Management (IAM) -Benutzer verfügen über langfristige Anmeldeinformationen, die ein Sicherheitsrisiko darstellen. Um dieses Risiko zu minimieren, empfehlen wir, diesen Benutzern nur die Berechtigungen zu gewähren, die sie für die Ausführung der Aufgabe benötigen, und diese Benutzer zu entfernen, wenn sie nicht mehr benötigt werden.

• IBM Python für z/OS

  Das AWS CLI erfordert Python 3.8 oder höher. IBM hat Python mit IBM Open Enterprise Python for z/OS für die Ausführung auf z/OS aktiviert. IBM Open Enterprise Python ist kostenlos über Shopz SMP/E erhältlich, oder Sie können die PAX-Datei von der IBM-Website herunterladen. Anweisungen finden Sie in der Installations- und Konfigurationsdokumentation für IBM Open Enterprise Python for z/OS.

Einschränkungen

• Die in diesem Muster enthaltenen Installationsanweisungen gelten nur für AWS CLI Version 1. Die neueste Version von AWS CLI ist Version 2. Dieses Muster verwendet jedoch die ältere Version, da die Installationsmethoden für Version 2 unterschiedlich sind und die für Version 2 verfügbaren binären ausführbaren Dateien nicht mit dem z/OS-System kompatibel sind.

Produktversionen

• AWS CLI Version 1

• Python 3.8 oder höher

Architektur

Technologie-Stack

• Mainframe, auf dem z/OS ausgeführt wird

• Mainframe z/OS UNIX-Systemdienste (USS)

• Mainframe Open MVS (OMVS) — Befehlsschnittstelle für die z/OS UNIX-Shell-Umgebung

• Mainframe-Festplatte, z. B. ein Direct-Access-Speichergerät (DASD)

• AWS CLI

Zielarchitektur

Das folgende Diagramm zeigt eine AWS CLI Bereitstellung auf IBM z/OS. Sie können die AWS CLI in einer interaktiven Benutzersitzung wie SSH- und Telnet-Sitzungen aufrufen. Sie können ihn auch von einem Batch-Job aus aufrufen, indem Sie die Job Control Language (JCL) verwenden, oder von einem beliebigen Programm aus, das einen z/OS Unix-Shell-Befehl aufrufen kann.

Der AWS CLI kommuniziert mit AWS-Service Endpunkten über ein TCP/IP-Netzwerk. Diese Netzwerkverbindung kann über das Internet oder über eine private AWS Direct Connect Verbindung vom Kundenrechenzentrum zu den Rechenzentren erfolgen. AWS Cloud Die Kommunikation wird mit AWS Anmeldeinformationen authentifiziert und verschlüsselt.

Automatisierung und Skalierung

Sie können die Funktionen von und AWS-Service mit dem erkunden AWS CLI und USS-Shell-Skripte entwickeln, um Ihre AWS Ressourcen von z/OS aus zu verwalten. Sie können auch AWS CLI Befehle und Shell-Skripte in der z/OS-Batch-Umgebung ausführen und durch die Integration mit Mainframe-Schedulern Batch-Jobs automatisieren, sodass sie nach einem bestimmten Zeitplan ausgeführt werden. AWS CLI Befehle oder Skripten können innerhalb von Parametern (PARMs) und Prozeduren (PROCs) codiert und skaliert werden, indem man dem Standardansatz folgt, den PARM oder PROC von verschiedenen Batch-Jobs mit unterschiedlichen Parametern aus aufzurufen.

Tools

• AWS Command Line Interface (AWS CLI) ist ein Open-Source-Tool, mit dem Sie AWS-Services über Befehle in Ihrer Befehlszeilen-Shell interagieren können.

Bewährte Methoden

• Beschränken Sie aus Sicherheitsgründen die Zugriffsberechtigungen auf das USS-Verzeichnis, in dem die AWS Zugangsschlüsseldetails gespeichert sind. Erlauben Sie den Zugriff nur Benutzern oder Programmen, die den verwenden AWS CLI.

• Verwenden Sie die AWS-Konto Root-Benutzerzugriffstasten für keine Aufgabe. Erstellen Sie stattdessen einen neuen Administrator-IAM-Benutzer für sich selbst und richten Sie ihn mit Zugriffsschlüsseln ein.

Warnung IAM-Benutzer verfügen über langfristige Anmeldeinformationen, die ein Sicherheitsrisiko darstellen. Um dieses Risiko zu minimieren, empfehlen wir, diesen Benutzern nur die Berechtigungen zu gewähren, die sie für die Ausführung der Aufgabe benötigen, und diese Benutzer zu entfernen, wenn sie nicht mehr benötigt werden.

Epen

Installieren Sie AWS CLI Version 1 auf z/OS USS

Aufgabe	Beschreibung	Erforderliche Fähigkeiten
Installieren Sie Python 3.8 oder höher.	Melden Sie sich mit einer der folgenden Methoden bei der z/OS USS-Befehlszeilenschnittstelle an: Verwenden Sie einen OMVS-Befehl (Time Sharing Option) (TSO) im Bereich Interactive System Productivity Facility (ISPF), oder Verwenden Sie SSH oder Telnet, um eine Verbindung zur IP der logischen Mainframe-Partition (LPAR) herzustellen. Bei diesem Muster wird davon ausgegangen, dass cliuser es sich um die Benutzer-ID handelt, die für die Anmeldung in der USS-Umgebung verwendet wird, und dass es sich um das Home-Verzeichnis für den Benutzer /u/cliuser/ handelt. Sie können das Benutzer-Home-Verzeichnis in Ihrer z/OS-Umgebung je nach Ihren Installationsanforderungen unterschiedlich einrichten. Folgen Sie der Installationsanleitung für IBM Open Enterprise Python for z/OS, um Python 3.8 oder höher zu installieren, falls es noch nicht installiert ist.	Mainframe-z/OS-Administrator
Legen Sie USS-Umgebungsvariablen fest.	Fügen Sie dem Profil Umgebungsvariablen hinzu. Sie können diese entweder der /u/cliuser/.profile Datei für einen einzelnen Benutzer (cliuser) oder der /etc/profile Datei für alle Benutzer hinzufügen. Anmerkung Dieses Muster geht davon aus, dass Python im /u/awscli/python Verzeichnis installiert wurde. Wenn Ihr Installationsverzeichnis anders ist, aktualisieren Sie den Code entsprechend. # Python configuration export BPXKAUTOCVT='ON' export CEERUNOPTS='FILETAG(AUTOCVT,AUTOTAG) POSIX(ON)' export TAGREDIR_ERR=txt export TAGREDIR_IN=txt export TAGREDIR_OUT=txt # AWS CLI configuration export PATH=/u/cliuser/python/bin:$PATH export PYTHONPATH=/u/cliuser/python:$PYTHONPATH	Mainframe-z/OS-Administrator
Testen Sie die Python-Installation.	Führen Sie den Python-Befehl aus: python --version Die Ausgabe sollte bestätigen, dass Sie Python 3.8 oder höher korrekt installiert haben.	Mainframe-z/OS-Administrator
Überprüfen oder installieren Sie Pip.	Der Befehl pip wird normalerweise automatisch installiert, wenn Sie Python von der IBM-Website installieren. Führen Sie zur Überprüfung den folgenden Befehl aus: pip —-version Wenn pip installiert ist, sollte dieser Befehl die installierte Version anzeigen. Wenn der Befehl pip nicht gefunden wird, installieren Sie pip, indem Sie den folgenden Befehl ausführen: python -m ensurepip --upgrade Weitere Installationsoptionen finden Sie in der Pip-Dokumentation.	Mainframe-z/OS-Administrator
Installieren Sie AWS CLI Version 1.	Um das zu installieren AWS CLI, führen Sie den folgenden Befehl aus: python -m pip install awscli Die Ausgabe sollte folgendermaßen oder ähnlich aussehen. Successfully installed PyYAML-6.0.1 awscli-1.32.23 botocore-1.34.23 colorama-0.4.4 docutils-0.16 jmespath-1.0.1 pyasn1-0.5.1 python-dateutil-2.8.2 rsa-4.7.2 s3transfer-0.10.0 urllib3-2.0.7 Ändern Sie die Berechtigungen der ausführbaren AWS-Datei, indem Sie den folgenden Befehl ausführen. Stellen Sie sicher, dass Sie das Platzhalterverzeichnis <python_installation_dir> mit Ihrem Python-Installationspfad aktualisieren. chmod 744 <python_installation_dir>/bin/aws Führen Sie den folgenden Befehl aus, um die AWS CLI Installation zu testen: aws --version Die Ausgabe sollte die Versionen von Python und Botocore zeigen, ähnlich wie im Folgenden. AWS CLI aws-cli/1.32.3 Python/3.9.5 OS/390/27.00 botocore/1.34.3	Mainframe-z/OS-Administrator

Installieren Sie AWS CLI Version 1 auf z/OS USS

Aufgabe	Beschreibung	Erforderliche Fähigkeiten
Installieren Sie Python 3.8 oder höher.	Melden Sie sich mit einer der folgenden Methoden bei der z/OS USS-Befehlszeilenschnittstelle an: Verwenden Sie einen OMVS-Befehl (Time Sharing Option) (TSO) im Bereich Interactive System Productivity Facility (ISPF), oder Verwenden Sie SSH oder Telnet, um eine Verbindung zur IP der logischen Mainframe-Partition (LPAR) herzustellen. Bei diesem Muster wird davon ausgegangen, dass cliuser es sich um die Benutzer-ID handelt, die für die Anmeldung in der USS-Umgebung verwendet wird, und dass es sich um das Home-Verzeichnis für den Benutzer /u/cliuser/ handelt. Sie können das Benutzer-Home-Verzeichnis in Ihrer z/OS-Umgebung je nach Ihren Installationsanforderungen unterschiedlich einrichten. Folgen Sie der Installationsanleitung für IBM Open Enterprise Python for z/OS, um Python 3.8 oder höher zu installieren, falls es noch nicht installiert ist.	Mainframe-z/OS-Administrator
Legen Sie USS-Umgebungsvariablen fest.	Fügen Sie dem Profil Umgebungsvariablen hinzu. Sie können diese entweder der /u/cliuser/.profile Datei für einen einzelnen Benutzer (cliuser) oder der /etc/profile Datei für alle Benutzer hinzufügen. Anmerkung Dieses Muster geht davon aus, dass Python im /u/awscli/python Verzeichnis installiert wurde. Wenn Ihr Installationsverzeichnis anders ist, aktualisieren Sie den Code entsprechend. # Python configuration export BPXKAUTOCVT='ON' export CEERUNOPTS='FILETAG(AUTOCVT,AUTOTAG) POSIX(ON)' export TAGREDIR_ERR=txt export TAGREDIR_IN=txt export TAGREDIR_OUT=txt # AWS CLI configuration export PATH=/u/cliuser/python/bin:$PATH export PYTHONPATH=/u/cliuser/python:$PYTHONPATH	Mainframe-z/OS-Administrator
Testen Sie die Python-Installation.	Führen Sie den Python-Befehl aus: python --version Die Ausgabe sollte bestätigen, dass Sie Python 3.8 oder höher korrekt installiert haben.	Mainframe-z/OS-Administrator
Überprüfen oder installieren Sie Pip.	Der Befehl pip wird normalerweise automatisch installiert, wenn Sie Python von der IBM-Website installieren. Führen Sie zur Überprüfung den folgenden Befehl aus: pip —-version Wenn pip installiert ist, sollte dieser Befehl die installierte Version anzeigen. Wenn der Befehl pip nicht gefunden wird, installieren Sie pip, indem Sie den folgenden Befehl ausführen: python -m ensurepip --upgrade Weitere Installationsoptionen finden Sie in der Pip-Dokumentation.	Mainframe-z/OS-Administrator
Installieren Sie AWS CLI Version 1.	Um das zu installieren AWS CLI, führen Sie den folgenden Befehl aus: python -m pip install awscli Die Ausgabe sollte folgendermaßen oder ähnlich aussehen. Successfully installed PyYAML-6.0.1 awscli-1.32.23 botocore-1.34.23 colorama-0.4.4 docutils-0.16 jmespath-1.0.1 pyasn1-0.5.1 python-dateutil-2.8.2 rsa-4.7.2 s3transfer-0.10.0 urllib3-2.0.7 Ändern Sie die Berechtigungen der ausführbaren AWS-Datei, indem Sie den folgenden Befehl ausführen. Stellen Sie sicher, dass Sie das Platzhalterverzeichnis <python_installation_dir> mit Ihrem Python-Installationspfad aktualisieren. chmod 744 <python_installation_dir>/bin/aws Führen Sie den folgenden Befehl aus, um die AWS CLI Installation zu testen: aws --version Die Ausgabe sollte die Versionen von Python und Botocore zeigen, ähnlich wie im Folgenden. AWS CLI aws-cli/1.32.3 Python/3.9.5 OS/390/27.00 botocore/1.34.3	Mainframe-z/OS-Administrator

Konfigurieren Sie den AWS CLI Zugriff von z/OS aus

Aufgabe	Beschreibung	Erforderliche Fähigkeiten
Konfigurieren Sie die AWS Zugriffstasten, die Standardregion und die Ausgabe.	In der AWS CLI Dokumentation werden verschiedene Optionen für die Einrichtung des AWS Zugriffs beschrieben. Sie können eine Konfiguration wählen, die den Standards Ihrer Organisation entspricht. In diesem Beispiel wird die Konfiguration mit kurzfristigen Anmeldeinformationen verwendet. Konfigurieren Sie das AWS CLI mit dem folgenden Befehl: aws configure Geben Sie die Details für die folgenden Elemente ein, wenn Sie dazu aufgefordert werden. Die Werte für die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel stammen aus den Schlüsseln, die Sie erhalten haben, als Sie die AWS Anmeldeinformationen in den Schritten „Voraussetzungen“ festgelegt haben. AWS Access Key ID [None]: ASIAIOSFODNN7EXAMPLE AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY Default region name [None]: us-east-1 Default output format [None]: aws configure set aws_session_token IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE Diese Konfiguration, einschließlich der Zugriffsschlüssel, wird in dem /u/cliuser/.aws Ordner gespeichert. Beschränken Sie diesen Ordner aus Sicherheitsgründen so, dass nur Benutzer oder Programme darauf zugreifen können, die den verwenden AWS CLI.	AWS-Administrator, Mainframe z/OS-Administrator, Mainframe z/OS-Entwickler
Testen Sie das. AWS CLI	Führen Sie den folgenden Befehl an der Eingabeaufforderung aus, um das AWS CLI mit einem einfachen Befehl zu testen: aws s3 ls Die Ausgabe sollte alle S3-Buckets für die Konfiguration AWS-Konto ohne Fehler auflisten. Folgen Sie den Anweisungen in den nächsten beiden Epen, um Daten von USS nach Amazon S3 zu übertragen. Sie können eine dieser beiden Optionen wählen: Option 1 (nächstes Epic): Interaktiv eine EBCDIC-Datei mit kommagetrennten Werten (CSV) nach Amazon S3 übertragen und die Datei von Amazon Athena abfragen. Option 2: Übertragen Sie einen EBCDIC-Datensatz mit fester Länge als Batch-Job an Amazon S3.	Mainframe z/OS-Administrator, Mainframe z/OS-Entwickler

Konfigurieren Sie den AWS CLI Zugriff von z/OS aus

Aufgabe	Beschreibung	Erforderliche Fähigkeiten
Konfigurieren Sie die AWS Zugriffstasten, die Standardregion und die Ausgabe.	In der AWS CLI Dokumentation werden verschiedene Optionen für die Einrichtung des AWS Zugriffs beschrieben. Sie können eine Konfiguration wählen, die den Standards Ihrer Organisation entspricht. In diesem Beispiel wird die Konfiguration mit kurzfristigen Anmeldeinformationen verwendet. Konfigurieren Sie das AWS CLI mit dem folgenden Befehl: aws configure Geben Sie die Details für die folgenden Elemente ein, wenn Sie dazu aufgefordert werden. Die Werte für die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel stammen aus den Schlüsseln, die Sie erhalten haben, als Sie die AWS Anmeldeinformationen in den Schritten „Voraussetzungen“ festgelegt haben. AWS Access Key ID [None]: ASIAIOSFODNN7EXAMPLE AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY Default region name [None]: us-east-1 Default output format [None]: aws configure set aws_session_token IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE Diese Konfiguration, einschließlich der Zugriffsschlüssel, wird in dem /u/cliuser/.aws Ordner gespeichert. Beschränken Sie diesen Ordner aus Sicherheitsgründen so, dass nur Benutzer oder Programme darauf zugreifen können, die den verwenden AWS CLI.	AWS-Administrator, Mainframe z/OS-Administrator, Mainframe z/OS-Entwickler
Testen Sie das. AWS CLI	Führen Sie den folgenden Befehl an der Eingabeaufforderung aus, um das AWS CLI mit einem einfachen Befehl zu testen: aws s3 ls Die Ausgabe sollte alle S3-Buckets für die Konfiguration AWS-Konto ohne Fehler auflisten. Folgen Sie den Anweisungen in den nächsten beiden Epen, um Daten von USS nach Amazon S3 zu übertragen. Sie können eine dieser beiden Optionen wählen: Option 1 (nächstes Epic): Interaktiv eine EBCDIC-Datei mit kommagetrennten Werten (CSV) nach Amazon S3 übertragen und die Datei von Amazon Athena abfragen. Option 2: Übertragen Sie einen EBCDIC-Datensatz mit fester Länge als Batch-Job an Amazon S3.	Mainframe z/OS-Administrator, Mainframe z/OS-Entwickler

Option 1 ‒ Daten interaktiv aus einer USS-Sitzung von USS zu Amazon S3 übertragen

Aufgabe	Beschreibung	Erforderliche Fähigkeiten
Laden Sie die CSV-Beispieldatei herunter und übertragen Sie sie.	Laden Sie sie sales-records.csv aus dem Bereich Anlagen herunter. Diese Datei enthält eine CSV-Beispieldatei mit Verkaufsdatensätzen. Übertragen Sie die Datei nach z/OS USS. Stellen Sie sicher, dass die /u/cliuser/sales-records.csv Datei in USS im EBCDIC-Format lesbar ist, indem Sie einen Texteditor Ihrer Wahl verwenden.	App-Entwickler, Mainframe z/OS-Entwickler
Erstellen Sie einen S3-Bucket und laden Sie die CSV-Datei hoch.	Erstellen Sie einen S3-Bucket zum Speichern der CSV-Datei. aws s3 mb s3://<s3_bucket_name> wo <s3_bucket_name> ist der eindeutige Name für einen Bucket; zum Beispiel: aws s3 mb s3://DOC-EXAMPLE-BUCKET1 Laden Sie die CSV-Datei von z/OS USS in den S3-Bucket hoch: aws s3 cp <csv_file_path> s3://<s3_bucket_name> Zum Beispiel: aws s3 cp /u/cliuser/sales-records.csv s3://DOC-EXAMPLE-BUCKET1 Listen Sie den Inhalt des S3-Buckets auf und vergewissern Sie sich, dass er die hochgeladene Datei enthält: aws s3 ls s3://<s3_bucket_name> Zum Beispiel: aws s3 ls s3://DOC-EXAMPLE-BUCKET1	App-Entwickler, Mainframe z/OS-Entwickler
Sehen Sie sich den S3-Bucket und die hochgeladene Datei an.	Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon S3 S3-Konsole. Navigieren Sie, um den neuen S3-Bucket und das hochgeladene Objekt zu sehen. Weitere Informationen zum Hochladen von Objekten finden Sie unter Erste Schritte mit Amazon S3 in der Amazon S3 S3-Dokumentation.	Allgemeines AWS
Führen Sie eine SQL-Abfrage für eine Amazon Athena Athena-Tabelle aus.	Öffnen Sie die Amazon-Athena-Konsole. Erstellen Sie eine neue Tabelle (z. B.DOC-EXAMPLE-BUCKET) mithilfe der CSV-Daten von Amazon S3. Weitere Informationen finden Sie unter Abfragen von Amazon S3 S3-Inventar mit Amazon Athena in der Amazon S3 S3-Dokumentation. Führen Sie die SELECT Abfrage anhand der Tabelle aus, um die Daten anzuzeigen. SELECT * FROM <table_name>; Zum Beispiel: SELECT * FROM DOC-EXAMPLE-BUCKET; In der Ausgabe der SQL-Abfrage wird der Inhalt Ihrer CSV-Datei angezeigt.	Allgemein AWS, App-Entwickler

Option 1 ‒ Daten interaktiv aus einer USS-Sitzung von USS zu Amazon S3 übertragen

Aufgabe	Beschreibung	Erforderliche Fähigkeiten
Laden Sie die CSV-Beispieldatei herunter und übertragen Sie sie.	Laden Sie sie sales-records.csv aus dem Bereich Anlagen herunter. Diese Datei enthält eine CSV-Beispieldatei mit Verkaufsdatensätzen. Übertragen Sie die Datei nach z/OS USS. Stellen Sie sicher, dass die /u/cliuser/sales-records.csv Datei in USS im EBCDIC-Format lesbar ist, indem Sie einen Texteditor Ihrer Wahl verwenden.	App-Entwickler, Mainframe z/OS-Entwickler
Erstellen Sie einen S3-Bucket und laden Sie die CSV-Datei hoch.	Erstellen Sie einen S3-Bucket zum Speichern der CSV-Datei. aws s3 mb s3://<s3_bucket_name> wo <s3_bucket_name> ist der eindeutige Name für einen Bucket; zum Beispiel: aws s3 mb s3://DOC-EXAMPLE-BUCKET1 Laden Sie die CSV-Datei von z/OS USS in den S3-Bucket hoch: aws s3 cp <csv_file_path> s3://<s3_bucket_name> Zum Beispiel: aws s3 cp /u/cliuser/sales-records.csv s3://DOC-EXAMPLE-BUCKET1 Listen Sie den Inhalt des S3-Buckets auf und vergewissern Sie sich, dass er die hochgeladene Datei enthält: aws s3 ls s3://<s3_bucket_name> Zum Beispiel: aws s3 ls s3://DOC-EXAMPLE-BUCKET1	App-Entwickler, Mainframe z/OS-Entwickler
Sehen Sie sich den S3-Bucket und die hochgeladene Datei an.	Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon S3 S3-Konsole. Navigieren Sie, um den neuen S3-Bucket und das hochgeladene Objekt zu sehen. Weitere Informationen zum Hochladen von Objekten finden Sie unter Erste Schritte mit Amazon S3 in der Amazon S3 S3-Dokumentation.	Allgemeines AWS
Führen Sie eine SQL-Abfrage für eine Amazon Athena Athena-Tabelle aus.	Öffnen Sie die Amazon-Athena-Konsole. Erstellen Sie eine neue Tabelle (z. B.DOC-EXAMPLE-BUCKET) mithilfe der CSV-Daten von Amazon S3. Weitere Informationen finden Sie unter Abfragen von Amazon S3 S3-Inventar mit Amazon Athena in der Amazon S3 S3-Dokumentation. Führen Sie die SELECT Abfrage anhand der Tabelle aus, um die Daten anzuzeigen. SELECT * FROM <table_name>; Zum Beispiel: SELECT * FROM DOC-EXAMPLE-BUCKET; In der Ausgabe der SQL-Abfrage wird der Inhalt Ihrer CSV-Datei angezeigt.	Allgemein AWS, App-Entwickler

Option 2 ‒ Daten mithilfe von Batch-JCL von USS nach Amazon S3 übertragen

Aufgabe	Beschreibung	Erforderliche Fähigkeiten
Laden Sie die Beispieldatei hoch.	Laden Sie sie sales-records-fixed.txt aus dem Bereich Anlagen herunter. Dies ist eine Beispieldatei mit Verkaufsaufzeichnungen. Benennen Sie die Textdatei um, z. B. inUSER.DATA.FIXED. Übertragen Sie die Datei als festblockierten (FB) Datensatz mit 256 Datensätzen (LRECL) und physikalischer sequentieller Datenmenge (PS) nach z/OS. Verwenden Sie das Programm zur Datensatzliste, um zu überprüfen, ob der USER.DATA.FIXED Datensatz unter ISPF-Option 3.4 im EBCDIC-Format lesbar ist. Ein Beispiel für die Ausgabe finden Sie im Abschnitt Zusätzliche Informationen.	Mainframe z/OS-Entwickler
Erstellen Sie eine Batch-JCL.	Codieren Sie die Batch-JCL wie folgt, um den Ziel-S3-Bucket zu erstellen, den Datensatz hochzuladen und den Bucket-Inhalt aufzulisten. Stellen Sie sicher, dass Sie den Verzeichnisnamen, die Dateinamen und den Bucket-Namen durch Ihre eigenen Werte ersetzen. //AWSCLICP JOB ACTINFO1,'IBMUSER',CLASS=A,MSGCLASS=H,MSGLEVEL=(1,1), // NOTIFY=&SYSUID,TIME=1440 //*--------------------------------------------------------- //* Sample job for AWS CLI //*--------------------------------------------------------- //USSCMD EXEC PGM=BPXBATCH //STDERR DD SYSOUT=* //STDOUT DD SYSOUT=* //STDENV DD * export PATH=/u/cliuser/python/bin:$PATH //STDPARM DD * SH export _BPXK_AUTOCVT=ON; aws s3 mb s3://DOC-EXAMPLE-BUCKET2; cp "//'USER.DATA.FIXED'" /tmp/tmpfile; aws s3 cp /tmp/tmpfile s3://DOC-EXAMPLE-BUCKET2/USER.DATA.FIXED; rm /tmp/tmpfile; aws s3 ls s3://DOC-EXAMPLE-BUCKET2; /*	Mainframe-z/OS-Entwickler
Reichen Sie den Batch-JCL-Job ein.	Reichen Sie den JCL-Job ein, den Sie im vorherigen Schritt codiert haben. Überprüfen Sie den Status des Jobs in der System Display and Search Facility (SDSF). Bei Erfolg sollte der Job mit dem Rückgabecode 0 enden. Die Standardausgabe (STDOUT) aus dem Job-Log zeigt die erfolgreiche Bucket-Erstellung, den Upload des Datensatzes und die Liste der Bucket-Inhalte. Ein Beispiel für eine Bildschirmdarstellung finden Sie im Abschnitt Zusätzliche Informationen.	Mainframe z/OS-Entwickler
Sehen Sie sich den Datensatz an, der in den S3-Bucket hochgeladen wurde.	Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon S3 S3-Konsole. Navigieren Sie, um die hochgeladene Datei im Test-Bucket zu sehen. Sie können die USER.DATA.FIXED Datei weiter verarbeiten oder mithilfe von Analysediensten wie Amazon Redshift analysieren.	Allgemeines AWS

Option 2 ‒ Daten mithilfe von Batch-JCL von USS nach Amazon S3 übertragen

Aufgabe	Beschreibung	Erforderliche Fähigkeiten
Laden Sie die Beispieldatei hoch.	Laden Sie sie sales-records-fixed.txt aus dem Bereich Anlagen herunter. Dies ist eine Beispieldatei mit Verkaufsaufzeichnungen. Benennen Sie die Textdatei um, z. B. inUSER.DATA.FIXED. Übertragen Sie die Datei als festblockierten (FB) Datensatz mit 256 Datensätzen (LRECL) und physikalischer sequentieller Datenmenge (PS) nach z/OS. Verwenden Sie das Programm zur Datensatzliste, um zu überprüfen, ob der USER.DATA.FIXED Datensatz unter ISPF-Option 3.4 im EBCDIC-Format lesbar ist. Ein Beispiel für die Ausgabe finden Sie im Abschnitt Zusätzliche Informationen.	Mainframe z/OS-Entwickler
Erstellen Sie eine Batch-JCL.	Codieren Sie die Batch-JCL wie folgt, um den Ziel-S3-Bucket zu erstellen, den Datensatz hochzuladen und den Bucket-Inhalt aufzulisten. Stellen Sie sicher, dass Sie den Verzeichnisnamen, die Dateinamen und den Bucket-Namen durch Ihre eigenen Werte ersetzen. //AWSCLICP JOB ACTINFO1,'IBMUSER',CLASS=A,MSGCLASS=H,MSGLEVEL=(1,1), // NOTIFY=&SYSUID,TIME=1440 //*--------------------------------------------------------- //* Sample job for AWS CLI //*--------------------------------------------------------- //USSCMD EXEC PGM=BPXBATCH //STDERR DD SYSOUT=* //STDOUT DD SYSOUT=* //STDENV DD * export PATH=/u/cliuser/python/bin:$PATH //STDPARM DD * SH export _BPXK_AUTOCVT=ON; aws s3 mb s3://DOC-EXAMPLE-BUCKET2; cp "//'USER.DATA.FIXED'" /tmp/tmpfile; aws s3 cp /tmp/tmpfile s3://DOC-EXAMPLE-BUCKET2/USER.DATA.FIXED; rm /tmp/tmpfile; aws s3 ls s3://DOC-EXAMPLE-BUCKET2; /*	Mainframe-z/OS-Entwickler
Reichen Sie den Batch-JCL-Job ein.	Reichen Sie den JCL-Job ein, den Sie im vorherigen Schritt codiert haben. Überprüfen Sie den Status des Jobs in der System Display and Search Facility (SDSF). Bei Erfolg sollte der Job mit dem Rückgabecode 0 enden. Die Standardausgabe (STDOUT) aus dem Job-Log zeigt die erfolgreiche Bucket-Erstellung, den Upload des Datensatzes und die Liste der Bucket-Inhalte. Ein Beispiel für eine Bildschirmdarstellung finden Sie im Abschnitt Zusätzliche Informationen.	Mainframe z/OS-Entwickler
Sehen Sie sich den Datensatz an, der in den S3-Bucket hochgeladen wurde.	Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon S3 S3-Konsole. Navigieren Sie, um die hochgeladene Datei im Test-Bucket zu sehen. Sie können die USER.DATA.FIXED Datei weiter verarbeiten oder mithilfe von Analysediensten wie Amazon Redshift analysieren.	Allgemeines AWS

Zugehörige Ressourcen

• AWS CLI Dokumentation zu Version 1

• AWS Mainframe Modernization CLI-Befehlsreferenz

• AWS Mainframe Modernization

Zusätzliche Informationen

USER.DATA.FIXED in der ISPF-Option 3.4 (Hilfsprogramm zur Datensatzliste)

SYSOUT des übermittelten Batch-Jobs

Anlagen

Um auf zusätzliche Inhalte zuzugreifen, die mit diesem Dokument verknüpft sind, entpacken Sie die folgende Datei: attachment.zip