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

PDF

Erstellt von Souma Ghosh (AWS), Phil de Valence () und Paulo Vitor Pereira (AWS) 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 im 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 einer allgemeinen 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 das AWS CLI in einer interaktiven Befehlszeilensitzung von z/OS Unix System Services (USS) aus oder als Batch-Job verwendet wird.

Voraussetzungen und Einschränkungen

Voraussetzungen

• Netzwerkkommunikation von z/OS zu AWS

  Standardmäßig AWS CLI sendet der Anfragen an AWS-Services HTTPS über TCP Port 443. Um den AWS CLI erfolgreich zu verwenden, müssen Sie in der Lage sein, ausgehende Verbindungen auf TCP Port 443 herzustellen. Sie können jeden der folgenden USS z/OS-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 den AWS Cloud Diensten von z/OS kommunizieren zu können, AWS CLI müssen Sie einige Anmeldeinformationen mit Rechten für den Zugriff 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 IAM Administratorbenutzer und bereiten Sie sich auf 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.

• IBMPython für z/OS

  Das AWS CLI erfordert Python 3.8 oder höher. IBMhat Python für die Ausführung auf z/OS mit IBMOpen Enterprise Python for 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 Installationsanweisungen in diesem Muster 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-Systemdienste UNIX () USS

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

• Mainframe-Festplatte, z. B. ein Speichergerät mit Direktzugriff () 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 aufrufen, z. B. SSH in Telnet-Sitzungen. Sie können ihn auch von einem Batchjob 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 /IP-Netzwerk. TCP Diese Netzwerkverbindung kann über das Internet oder über eine private AWS Direct Connect Verbindung vom Kundenrechenzentrum zu AWS Cloud den Rechenzentren erfolgen. 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-Skripts 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 der Standardansatz befolgt wird, bei dem die PARM oder PROC aus verschiedenen Batch-Jobs mit unterschiedlichen Parametern aufgerufen werden.

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 die Zugriffsberechtigungen aus Sicherheitsgründen 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 IAM Administratorbenutzer für sich selbst und richten Sie ihn mit Zugriffsschlüsseln ein.

Warnung IAMBenutzer 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 USS z/OS-Befehlszeilenschnittstelle an: Verwenden Sie den 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 cliuser wird davon ausgegangen, dass 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 IBMOpen 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 aus 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. Achten Sie darauf, das Platzhalterverzeichnis <python_installation_dir> mit Ihrem Python-Installationspfad zu 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 USS z/OS-Befehlszeilenschnittstelle an: Verwenden Sie den 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 cliuser wird davon ausgegangen, dass 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 IBMOpen 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 aus 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. Achten Sie darauf, das Platzhalterverzeichnis <python_installation_dir> mit Ihrem Python-Installationspfad zu 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.	AWSAdministrator, Mainframe z/OS-Administrator, Mainframe z/OS-Entwickler
AWS CLI Testen Sie das.	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 zu Amazon S3 USS zu übertragen. Sie können eine dieser beiden Optionen wählen: Option 1 (nächstes Epic): Interaktiv eine Datei mit EBCDIC kommagetrennten Werten (CSV) nach Amazon S3 übertragen und die Datei von Amazon Athena abfragen. Option 2: Übertragen Sie einen Datensatz EBCDIC 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.	AWSAdministrator, Mainframe z/OS-Administrator, Mainframe z/OS-Entwickler
AWS CLI Testen Sie das.	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 zu Amazon S3 USS zu übertragen. Sie können eine dieser beiden Optionen wählen: Option 1 (nächstes Epic): Interaktiv eine Datei mit EBCDIC kommagetrennten Werten (CSV) nach Amazon S3 übertragen und die Datei von Amazon Athena abfragen. Option 2: Übertragen Sie einen Datensatz EBCDIC mit fester Länge als Batch-Job an Amazon S3.	Mainframe z/OS-Administrator, Mainframe z/OS-Entwickler

Option 1 ‒ Daten interaktiv von einer USS Sitzung 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 Verkaufsaufzeichnungen. Übertragen Sie die Datei nach z/OSUSS. Stellen Sie mit einem Texteditor Ihrer Wahl sicher, dass die /u/cliuser/sales-records.csv Datei im EBCDIC Format in USS lesbar ist.	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 in USS den S3-Bucket hoch: aws s3 cp <csv_file_path> s3://<s3_bucket_name> Beispielsweise: 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> Beispielsweise: 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.	Allgemein 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 aus 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>; Beispielsweise: SELECT * FROM DOC-EXAMPLE-BUCKET; In der Ausgabe der SQL Abfrage wird der Inhalt Ihrer CSV Datei angezeigt.	AllgemeinAWS, App-Entwickler

Option 1 ‒ Daten interaktiv von einer USS Sitzung 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 Verkaufsaufzeichnungen. Übertragen Sie die Datei nach z/OSUSS. Stellen Sie mit einem Texteditor Ihrer Wahl sicher, dass die /u/cliuser/sales-records.csv Datei im EBCDIC Format in USS lesbar ist.	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 in USS den S3-Bucket hoch: aws s3 cp <csv_file_path> s3://<s3_bucket_name> Beispielsweise: 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> Beispielsweise: 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.	Allgemein 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 aus 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>; Beispielsweise: SELECT * FROM DOC-EXAMPLE-BUCKET; In der Ausgabe der SQL Abfrage wird der Inhalt Ihrer CSV Datei angezeigt.	AllgemeinAWS, App-Entwickler

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

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 physisch sequentiellen Datensatz (PS) mit einer Länge von 256 Datensätzen () mit fester Blockierung (FBLRECL) nach z/OS. Überprüfen Sie mithilfe des Dienstprogramms für die Datensatzliste, ob der USER.DATA.FIXED Datensatz im EBCDIC Format unter Option 3.4 lesbar ist. ISPF Ein Beispiel für die Ausgabe finden Sie im Abschnitt Zusätzliche Informationen.	Mainframe z/OS-Entwickler
Stapel erstellen. JCL	Codieren Sie den Stapel JCL wie folgt, um den Ziel-S3-Bucket zu erstellen, den Datensatz hochzuladen und den Bucket-Inhalt aufzulisten. Achten Sie darauf, den Verzeichnisnamen, die Dateinamen und den Bucket-Namen durch Ihre eigenen Werte zu 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 JCL Batch-Job ein.	Reichen Sie den JCL Job ein, den Sie im vorherigen Schritt codiert haben. Überprüfen Sie den Status des Jobs in der Systemanzeige und Suchfunktion (SDSF). Bei Erfolg sollte der Job mit dem Rückgabecode 0 enden. Die Standardausgabe (STDOUT) aus dem Jobprotokoll 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 zu der hochgeladenen Datei im Test-Bucket. Sie können die USER.DATA.FIXED Datei weiter verarbeiten oder mithilfe von Analysediensten wie Amazon Redshift analysieren.	Allgemein AWS

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

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 physisch sequentiellen Datensatz (PS) mit einer Länge von 256 Datensätzen () mit fester Blockierung (FBLRECL) nach z/OS. Überprüfen Sie mithilfe des Dienstprogramms für die Datensatzliste, ob der USER.DATA.FIXED Datensatz im EBCDIC Format unter Option 3.4 lesbar ist. ISPF Ein Beispiel für die Ausgabe finden Sie im Abschnitt Zusätzliche Informationen.	Mainframe z/OS-Entwickler
Stapel erstellen. JCL	Codieren Sie den Stapel JCL wie folgt, um den Ziel-S3-Bucket zu erstellen, den Datensatz hochzuladen und den Bucket-Inhalt aufzulisten. Achten Sie darauf, den Verzeichnisnamen, die Dateinamen und den Bucket-Namen durch Ihre eigenen Werte zu 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 JCL Batch-Job ein.	Reichen Sie den JCL Job ein, den Sie im vorherigen Schritt codiert haben. Überprüfen Sie den Status des Jobs in der Systemanzeige und Suchfunktion (SDSF). Bei Erfolg sollte der Job mit dem Rückgabecode 0 enden. Die Standardausgabe (STDOUT) aus dem Jobprotokoll 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 zu der hochgeladenen Datei im Test-Bucket. Sie können die USER.DATA.FIXED Datei weiter verarbeiten oder mithilfe von Analysediensten wie Amazon Redshift analysieren.	Allgemein AWS

Zugehörige Ressourcen

• AWS CLI Dokumentation zu Version 1

• AWS Mainframe Modernization CLI Befehlsreferenz

• AWS Mainframe Modernization

Zusätzliche Informationen

USER. DATA. FIXEDin ISPF Option 3.4 (Hilfsprogramm zur Datensatzliste)

SYSOUTdes eingereichten Batch-Jobs

Anlagen

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