Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Migrieren und replizieren Sie VSAM-Dateien mit Connect von Precisely zu Amazon RDS oder Amazon MSK
*Prachi Khanna und Biopathie GOPALSAMY, Amazon Web Services*
## Zusammenfassung
Dieses Muster zeigt Ihnen, wie Sie mithilfe von [Connect](https://www.precisely.com/product/precisely-connect/connect) from Precisely VSAM-Dateien (Virtual Storage Access Method) von einem Mainframe in eine Zielumgebung in der AWS-Cloud migrieren und replizieren. Zu den Zielumgebungen, die in diesem Muster behandelt werden, gehören Amazon Relational Database Service (Amazon RDS) und Amazon Managed Streaming for Apache Kafka (Amazon MSK). Connect verwendet [Change Data Capture (CDC)](https://www.precisely.com/resource-center/productsheets/change-data-capture-with-connect), um Aktualisierungen Ihrer VSAM-Quelldateien kontinuierlich zu überwachen und diese Updates dann in eine oder mehrere Ihrer AWS-Zielumgebungen zu übertragen. Sie können dieses Muster verwenden, um Ihre Ziele im Bereich Anwendungsmodernisierung oder Datenanalyse zu erreichen. Beispielsweise können Sie Connect verwenden, um Ihre VSAM-Anwendungsdateien mit geringer Latenz in die AWS-Cloud zu migrieren, oder Ihre VSAM-Daten zu einem AWS-Data Warehouse oder Data Lake für Analysen migrieren, die Synchronisationslatenzen tolerieren können, die höher sind als für die Anwendungsmodernisierung erforderlich.
## Voraussetzungen und Einschränkungen
**Voraussetzungen**
+ [IBM V2R1 oder höher z/OS ](https://www-40.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosv2r1-pdf-download?OpenDocument)
+ [CICS Transaction Server für z/OS (CICS TS) V5.1 oder höher (CICS/VSAM-Datenerfassung)](https://www.ibm.com/support/pages/cics-transaction-server-zos-51-detailed-system-requirements)
+ [IBM MQ 8.0 oder höher](https://www.ibm.com/support/pages/downloading-ibm-mq-80)
+ Einhaltung der [z/OS-Sicherheitsanforderungen](https://help.precisely.com/r/Connect-CDC-SQData/4.1.43/en-US/Connect-CDC-SQData-Help/Installation/Install-Connect-CDC-SQData-on-zOS/Prerequisites-for-z/OS/Security-authorization-requirements-for-z/OS) (z. B. APF-Autorisierung für SQData Ladebibliotheken)
+ Die VSAM-Wiederherstellungsprotokolle sind aktiviert
+ (Optional) [CICS VSAM Recovery Version (CICS VR) zur automatischen Erfassung von CDC-Protokollen](https://www.ibm.com/docs/en/cics-vr/5.1?topic=started-introducing-cics-vr)
+ Ein aktives AWS-Konto
+ Eine [Amazon Virtual Private Cloud (VPC)](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-getting-started.html) mit einem Subnetz, das über Ihre Legacy-Plattform erreichbar ist
+ Eine VSAM Connect-Lizenz von Precisely
**Einschränkungen**
+ Connect unterstützt keine automatische Erstellung von Zieltabellen auf der Grundlage von Quell-VSAM-Schemas oder Copybooks. Sie müssen die Zieltabellenstruktur zum ersten Mal definieren.
+ Für Nicht-Streaming-Ziele wie Amazon RDS müssen Sie die Zuordnung von Konvertierungsquelle zu Ziel im Apply Engine-Konfigurationsskript angeben.
+ Protokollierungs-, Überwachungs- und Warnfunktionen werden über externe Komponenten (wie Amazon CloudWatch) implementiert APIs und erfordern, dass sie voll funktionsfähig sind.
**Produktversionen**
+ SQData 40134 für z/OS
+ SQData 4.0.43 für das Amazon Linux Amazon Machine Image (AMI) auf Amazon Elastic Compute Cloud (Amazon) EC2
## Architektur
**Quelltechnologie-Stack**
+ Sprache zur Jobkontrolle (JCL)
+ z/OS Unix-Shell und Interactive System Productivity Facility (ISPF)
+ VSAM-Dienstprogramme (IDCAMS)
**Zieltechnologie-Stack**
+ Amazon EC2
+ Amazon MSK
+ Amazon RDS
+ Amazon VPC
**Zielarchitektur**
*Migrieren von VSAM-Dateien zu Amazon RDS*
Das folgende Diagramm zeigt, wie VSAM-Dateien in Echtzeit oder nahezu in Echtzeit in eine relationale Datenbank wie Amazon RDS migriert werden, indem das CDC agent/publisher in der Quellumgebung (lokaler Mainframe) und die [Apply Engine](https://help.precisely.com/r/Connect-CDC-SQData/4.1.43/en-US/Connect-CDC-SQData-Help/Source-and-Target-Configuration/Apply-engine) in der Zielumgebung (AWS Cloud) verwendet werden.
Das Diagramm zeigt den folgenden Batch-Workflow:
1. Connect erfasst Änderungen an einer Datei, indem es VSAM-Dateien mit Backupdateien vergleicht, um Änderungen zu identifizieren, und sendet die Änderungen dann an den Logstream.
1. Der Herausgeber verwendet Daten aus dem System-Logstream.
1. Der Herausgeber übermittelt die erfassten Datenänderungen über TCP/IP an eine Ziel-Engine. Der Controller-Daemon authentifiziert die Kommunikation zwischen der Quell- und der Zielumgebung.
1. Die Apply Engine in der Zielumgebung empfängt die Änderungen vom Publisher-Agent und wendet sie auf eine relationale oder nicht-relationale Datenbank an.
Das Diagramm zeigt den folgenden Online-Workflow:
1. Connect erfasst Änderungen in der Online-Datei mithilfe einer Protokollreplikation und streamt dann die erfassten Änderungen in einen Logstream.
1. Der Herausgeber verwendet Daten aus dem System-Logstream.
1. Der Herausgeber übermittelt die erfassten Datenänderungen über TCP/IP an die Ziel-Engine. Der Controller-Daemon authentifiziert die Kommunikation zwischen der Quell- und der Zielumgebung.
1. Die Apply Engine in der Zielumgebung empfängt die Änderungen vom Publisher-Agent und wendet sie dann auf eine relationale oder nicht-relationale Datenbank an.
*Migrieren von VSAM-Dateien zu Amazon MSK*
Das folgende Diagramm zeigt, wie Sie VSAM-Datenstrukturen im Hochleistungsmodus von einem Mainframe zu Amazon MSK streamen und automatisch JSON- oder AVRO-Schemakonvertierungen generieren, die in Amazon MSK integriert werden.
Das Diagramm zeigt den folgenden Batch-Workflow:
1. Connect erfasst Änderungen an einer Datei mithilfe von CICS VR oder durch den Vergleich von VSAM-Dateien mit Backupdateien, um Änderungen zu identifizieren. Erfasste Änderungen werden an den Logstream gesendet.
1. Der Herausgeber verwendet Daten aus dem System-Logstream.
1. Der Herausgeber übermittelt die erfassten Datenänderungen über TCP/IP an die Ziel-Engine. Der Controller-Daemon authentifiziert die Kommunikation zwischen der Quell- und der Zielumgebung.
1. Die Replicator Engine, die im Parallelverarbeitungsmodus arbeitet, teilt die Daten in eine Arbeitseinheit auf.
1. Worker-Threads erfassen die Daten aus dem Cache.
1. Daten werden aus den Worker-Threads in Amazon MSK-Themen veröffentlicht.
1. [Benutzer wenden mithilfe von Konnektoren Änderungen von Amazon MSK auf Ziele wie Amazon DynamoDB, Amazon Simple Storage Service (Amazon S3) oder Amazon OpenSearch Service an.](https://docs.aws.amazon.com/msk/latest/developerguide/msk-connect-connectors.html)
Das Diagramm zeigt den folgenden Online-Workflow:
1. Änderungen in der Online-Datei werden mithilfe eines Protokollreplikats erfasst. Erfasste Änderungen werden in den Logstream gestreamt.
1. Der Herausgeber verwendet Daten aus dem System-Logstream.
1. Der Herausgeber übermittelt die erfassten Datenänderungen über TCP/IP an die Ziel-Engine. Der Controller-Daemon authentifiziert die Kommunikation zwischen der Quell- und der Zielumgebung.
1. Die Replicator Engine, die im Parallelverarbeitungsmodus arbeitet, teilt die Daten in eine Arbeitseinheit auf.
1. Worker-Threads erfassen die Daten aus dem Cache.
1. Daten werden aus den Worker-Threads in Amazon MSK-Themen veröffentlicht.
1. [Benutzer wenden Änderungen von Amazon MSK mithilfe von Konnektoren auf Ziele wie DynamoDB, Amazon S3 oder OpenSearch Service an.](https://docs.aws.amazon.com/msk/latest/developerguide/msk-connect-connectors.html)
## Tools
+ [Amazon Managed Streaming for Apache Kafka (Amazon MSK)](https://docs.aws.amazon.com/msk/latest/developerguide/what-is-msk.html) ist ein vollständig verwalteter Service, der Sie beim Erstellen und Ausführen von Anwendungen unterstützt, die Apache Kafka zur Verarbeitung von Streaming-Daten verwenden.
+ [Amazon Relational Database Service (Amazon RDS)](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Welcome.html) unterstützt Sie bei der Einrichtung, dem Betrieb und der Skalierung einer relationalen Datenbank in der AWS-Cloud.
## Epen
### Bereiten Sie die Quellumgebung (Mainframe) vor
| Aufgabe | Description | Erforderliche Fähigkeiten |
| --- | --- | --- |
| Installieren Sie Connect CDC 4.1. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/migrate-and-replicate-vsam-files-to-amazon-rds-or-amazon-msk-using-connect-from-precisely.html) | IBM Mainframe-Entwickler/Administrator |
| Richten Sie das ZFS-Verzeichnis ein. | Um ein ZFS-Verzeichnis einzurichten, folgen Sie den Anweisungen unter [ZFS-Variablenverzeichnisse](https://help.precisely.com/r/Connect-CDC-SQData/4.1.43/en-US/Connect-CDC-SQData-Help/Installation/Install-Connect-CDC-SQData-on-zOS/Prerequisites-for-z/OS/Security-authorization-requirements-for-z/OS/zFS-variable-directories) in der Dokumentation Precisely.Controller-Daemon- und Capture/Publisher Agentenkonfigurationen werden im Dateisystem der z/OS UNIX Systems Services (als ZFS bezeichnet) gespeichert. Die Agenten Controller Daemon, Capture, Storage und Publisher benötigen eine vordefinierte ZfS-Verzeichnisstruktur zum Speichern einer kleinen Anzahl von Dateien. | IBM Mainframe-Entwickler/Administrator |
| TCP/IP Ports konfigurieren. | Folgen Sie zur Konfiguration von TCP/IP Ports den Anweisungen unter [TCP/IP-Ports](https://help.precisely.com/r/Connect-CDC-SQData/4.1.43/en-US/Connect-CDC-SQData-Help/Installation/Install-Connect-CDC-SQData-on-UNIX/Prerequisites-for-UNIX/Security-authorization-requirements-for-UNIX/TCP/IP-ports) in der Dokumentation Precisely.Der Controller-Daemon benötigt TCP/IP Ports auf den Quellsystemen. Die Ports werden von den Engines auf den Zielsystemen referenziert (auf denen die erfassten Änderungsdaten verarbeitet werden). | IBM Mainframe-Entwickler/Administrator |
| Erstellen Sie einen Logstream. z/OS | Um einen [z/OS-Logstream](https://www.ibm.com/docs/en/was/8.5.5?topic=SSEQTP_8.5.5/com.ibm.websphere.installation.zseries.doc/ae/cins_logstrm.html) zu erstellen, folgen Sie den Anweisungen unter [Create z/OS system LogStreams](https://help.precisely.com/r/Connect-CDC-SQData/4.1.43/en-US/Connect-CDC-SQData-Help/Source-and-Target-Configuration/Setup-and-configure-sources/IMS-z/OS/IMS-TM-EXIT-capture/Prepare-environment/Create-z/OS-system-logStreams?tocId=wy6243SXlIiEczwR8JE8WA) in der Dokumentation Precisely.Connect verwendet den Logstream, um während der Migration Daten zwischen Ihrer Quell- und Zielumgebung zu erfassen und zu streamen.
Ein Beispiel für eine JCL, die eine erstellt z/OS LogStream, finden Sie unter [Create z/OS system LogStreams](https://help.precisely.com/r/Connect-CDC-SQData/4.1.43/en-US/Connect-CDC-SQData-Help/Source-and-Target-Configuration/Setup-and-configure-sources/IMS-z/OS/IMS-TM-EXIT-capture/Prepare-environment/Create-z/OS-system-logStreams?tocId=wy6243SXlIiEczwR8JE8WA) in der Dokumentation Precisely. | IBM Mainframe-Entwickler |
| Identifizieren und autorisieren Sie IDs für ZFS-Benutzer und gestartete Aufgaben. | Verwenden Sie RACF, um Zugriff auf das OMVS ZfS-Dateisystem zu gewähren. Ein Beispiel für eine JCL finden Sie in der Dokumentation Precisely unter [Identifizieren und Autorisieren des ZFS-Benutzers und der gestarteten Aufgabe](https://help.precisely.com/r/Connect-CDC-SQData/4.1.43/en-US/Connect-CDC-SQData-Help/Source-and-Target-Configuration/Setup-and-configure-sources/IMS-z/OS/IMS-log-reader-capture/Prepare-environment/Identify-and-authorize-zFS-user-and-started-task-IDs?tocId=MrBXpFu~N0iAy~8VTrH0tQ). IDs | IBM Mainframe-Entwickler/Administrator |
| Generieren Sie z/OS öffentliche/private Schlüssel und die autorisierte Schlüsseldatei. | Führen Sie die JCL aus, um das key pair zu generieren. Ein Beispiel finden Sie unter *Schlüsselpaar-Beispiel* im Abschnitt *Zusätzliche Informationen* dieses Musters.
Anweisungen finden Sie in der Dokumentation Precisely unter [Generieren z/OS öffentlicher und privater Schlüssel und autorisierter Schlüsseldatei](https://help.precisely.com/r/Connect-CDC-SQData/4.1.43/en-US/Connect-CDC-SQData-Help/Source-and-Target-Configuration/Setup-and-configure-sources/Db2-z/OS/Prepare-the-environment/Generate-z/OS-public-and-private-keys-and-authorized-key-file?tocId=fceE77dWT8smZsSaE~FeMQ). | IBM Mainframe-Entwickler/Administrator |
| Aktivieren Sie das CICS VSAM Log Replicate und hängen Sie es an den Logstream an. | Führen Sie das folgende JCL-Skript aus: //STEP1 EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
ALTER SQDATA.CICS.FILEA -
LOGSTREAMID(SQDATA.VSAMCDC.LOG1) -
LOGREPLICATE
| IBM Mainframe-Entwickler/Administrator |
| Aktivieren Sie das VSAM-Dateiwiederherstellungsprotokoll über ein FCT. | Ändern Sie die File Control Table (FCT), um die folgenden Parameteränderungen widerzuspiegeln: Configure FCT Parms
CEDA ALT FILE(name) GROUP(groupname)
DSNAME(data set name)
RECOVERY(NONE|BACKOUTONLY|ALL)
FWDRECOVLOG(NO|1–99)
BACKUPTYPE(STATIC|DYNAMIC)
RECOVERY PARAMETERS
RECOVery : None | Backoutonly | All
Fwdrecovlog : No | 1-99
BAckuptype : Static | Dynamic
| IBM Mainframe-Entwickler/Administrator |
| Richten Sie CDCz Log für den Publisher-Agent ein. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/migrate-and-replicate-vsam-files-to-amazon-rds-or-amazon-msk-using-connect-from-precisely.html) | IBM Mainframe-Entwickler/Administrator |
| Aktivieren Sie den Controller-Daemon. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/migrate-and-replicate-vsam-files-to-amazon-rds-or-amazon-msk-using-connect-from-precisely.html) | IBM Mainframe-Entwickler/Administrator |
| Aktivieren Sie den Herausgeber. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/migrate-and-replicate-vsam-files-to-amazon-rds-or-amazon-msk-using-connect-from-precisely.html) | IBM Mainframe-Entwickler/Administrator |
| Aktivieren Sie den Logstream. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/migrate-and-replicate-vsam-files-to-amazon-rds-or-amazon-msk-using-connect-from-precisely.html) | IBM Mainframe-Entwickler/Administrator |
### Bereiten Sie die Zielumgebung vor (AWS)
| Aufgabe | Description | Erforderliche Fähigkeiten |
| --- | --- | --- |
| Genau auf einer EC2 Instanz installieren. | Um Connect von Precisely auf dem Amazon Linux AMI für Amazon zu installieren EC2, folgen Sie den Anweisungen unter [Connect CDC (SQData) unter UNIX installieren](https://help.precisely.com/r/Connect-CDC-SQData/4.1.43/en-US/Connect-CDC-SQData-Help/Installation/Install-Connect-CDC-SQData-on-UNIX) in der Dokumentation Precisely. | Allgemeines AWS |
| TCP/IP Ports öffnen. | Um die Sicherheitsgruppe so zu ändern, dass sie die Controller-Daemon-Ports für eingehenden und ausgehenden Zugriff enthält, folgen Sie den Anweisungen unter [TCP/IP](https://help.precisely.com/r/Connect-CDC-SQData/4.1.43/en-US/Connect-CDC-SQData-Help/Source-and-Target-Configuration/Setup-and-configure-sources/Change-data-capture/Transient-storage-and-publishing/TCP/IP) in der Dokumentation von Precisely. | Allgemeines AWS |
| Erstellen Sie Dateiverzeichnisse. | Um Dateiverzeichnisse zu erstellen, folgen Sie den Anweisungen unter [Prepare target apply environment](https://help.precisely.com/r/Connect-CDC-SQData/4.1.43/en-US/Connect-CDC-SQData-Help/Source-and-Target-Configuration/Setup-and-configure-targets/Kafka/Prepare-target-apply-environment) in der Dokumentation Precisely. | Allgemeines AWS |
| Erstellen Sie die Apply Engine-Konfigurationsdatei. | Erstellen Sie die Apply Engine-Konfigurationsdatei im Arbeitsverzeichnis der Apply Engine. Die folgende Beispielkonfigurationsdatei zeigt Apache Kafka als Ziel:builtin.features=SASL_SCRAM
security.protocol=SASL_SSL
sasl.mechanism=SCRAM-SHA-512
sasl.username=
sasl.password=
metadata.broker.list=
Weitere Informationen finden Sie unter [Sicherheit](https://kafka.apache.org/documentation/#security) in der Apache Kafka-Dokumentation. | Allgemeines AWS |
| Erstellen Sie Skripts für die Apply Engine-Verarbeitung. | Erstellen Sie die Skripts für die Apply Engine, um Quelldaten zu verarbeiten und Quelldaten auf das Ziel zu replizieren. Weitere Informationen finden Sie in der Dokumentation Precisely unter [Erstellen eines Apply-Engine-Skripts](https://help.precisely.com/r/Connect-CDC-SQData/4.1.43/en-US/Connect-CDC-SQData-Help/Source-and-Target-Configuration/Apply-engine/Apply-engine-script-development/Create-an-apply-engine-script). | Allgemeines AWS |
| Führen Sie die Skripte aus. | Verwenden Sie die `SQDENG` Befehle `SQDPARSE` und, um das Skript auszuführen. Weitere Informationen finden Sie unter [Parse a script for zOS](https://help.precisely.com/r/Connect-CDC-SQData/4.1.43/en-US/Connect-CDC-SQData-Help/Source-and-Target-Configuration/Apply-engine/Apply-engine-script-development/Parse-a-script/Parse-a-script-for-zOS) in der Precisely Dokumentation. | Allgemeines AWS |
### Validieren Sie die Umgebung
| Aufgabe | Description | Erforderliche Fähigkeiten |
| --- | --- | --- |
| Überprüfen Sie die Liste der VSAM-Dateien und Zieltabellen für die CDC-Verarbeitung. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/migrate-and-replicate-vsam-files-to-amazon-rds-or-amazon-msk-using-connect-from-precisely.html) | Allgemein AWS, Mainframe |
| Stellen Sie sicher, dass das Connect SQData CDC-Produkt verknüpft ist. | Führen Sie einen Testauftrag aus und stellen Sie sicher, dass der Rückgabecode für diesen Job 0 (erfolgreich) lautet.Die Statusmeldungen der Connect CDC SQData Apply Engine sollten aktive Verbindungsmeldungen anzeigen. | Allgemein AWS, Mainframe |
### Testfälle ausführen und validieren (Batch)
| Aufgabe | Description | Erforderliche Fähigkeiten |
| --- | --- | --- |
| Führen Sie den Batch-Job auf dem Mainframe aus. | Führen Sie den Batch-Anwendungsauftrag mit einer modifizierten JCL aus. Fügen Sie Schritte in die modifizierte JCL ein, die Folgendes bewirken:[See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/migrate-and-replicate-vsam-files-to-amazon-rds-or-amazon-msk-using-connect-from-precisely.html) | Allgemein AWS, Mainframe |
| Überprüfen Sie den Logstream. | Überprüfen Sie den Logstream, um sicherzustellen, dass Sie die Änderungsdaten für den abgeschlossenen Mainframe-Batch-Job sehen können. | Allgemein AWS, Mainframe |
| Überprüfen Sie die Anzahl der Quell-Delta-Änderungen und der Zieltabelle. | Gehen Sie wie folgt vor, um zu überprüfen, ob die Datensätze gezählt wurden:[See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/migrate-and-replicate-vsam-files-to-amazon-rds-or-amazon-msk-using-connect-from-precisely.html) | Allgemein AWS, Mainframe |
### Testfälle ausführen und validieren (online)
| Aufgabe | Description | Erforderliche Fähigkeiten |
| --- | --- | --- |
| Führen Sie die Online-Transaktion in einer CICS-Region aus. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/migrate-and-replicate-vsam-files-to-amazon-rds-or-amazon-msk-using-connect-from-precisely.html) | IBM Mainframe-Entwickler |
| Überprüfen Sie den Logstream. | Vergewissern Sie sich, dass der Logstream mit bestimmten Änderungen auf Datensatzebene gefüllt ist. | AWS-Mainframe-Entwickler |
| Überprüfen Sie die Anzahl in der Zieldatenbank. | Überwachen Sie die Apply Engine auf Zählungen auf Datensatzebene. | Genau, Linux |
| Überprüfen Sie die Anzahl der Datensätze und Datensätze in der Zieldatenbank. | Fragen Sie die Zieldatenbank ab, um die Anzahl der Datensätze und Datensätze zu überprüfen. | Allgemeines AWS |
## Zugehörige Ressourcen
+ [VSAM z/OS (Genaue](https://help.precisely.com/r/Connect-CDC-SQData/4.1.43/en-US/Connect-CDC-SQData-Help/Source-and-Target-Configuration/Setup-and-configure-sources/VSAM-z/OS) Dokumentation)
+ [Engine anwenden](https://help.precisely.com/r/Connect-CDC-SQData/4.1.43/en-US/Connect-CDC-SQData-Help/Source-and-Target-Configuration/Apply-engine) (Präzise Dokumentation)
+ [Replicator-Engine](https://help.precisely.com/r/Connect-CDC-SQData/4.1.43/en-US/Connect-CDC-SQData-Help/Source-and-Target-Configuration/Replicator-engine) (Präzise Dokumentation)
+ [Der Log-Stream](https://www.ibm.com/docs/en/zos/2.3.0?topic=logger-log-stream) (IBM-Dokumentation)
## Zusätzliche Informationen
**Beispiel für eine Konfigurationsdatei**
Dies ist eine Beispielkonfigurationsdatei für einen Logstream, bei dem die Quellumgebung ein Mainframe und die Zielumgebung Amazon MSK ist:
```
-- JOBNAME -- PASS THE SUBSCRIBER NAME
-- REPORT progress report will be produced after "n" (number) of Source records processed.
JOBNAME VSMTOKFK;
--REPORT EVERY 100;
-- Change Op has been ‘I’ for insert, ‘D’ for delete , and ‘R’ for Replace. For RDS it is 'U' for update
-- Character Encoding on z/OS is Code Page 1047, on Linux and UNIX it is Code Page 819 and on Windows, Code Page 1252
OPTIONS
CDCOP('I', 'U', 'D'),
PSEUDO NULL = NO,
USE AVRO COMPATIBLE NAMES,
APPLICATION ENCODING SCHEME = 1208;
-- SOURCE DESCRIPTIONS
BEGIN GROUP VSAM_SRC;
DESCRIPTION COBOL ../copybk/ACCOUNT AS account_file;
END GROUP;
-- TARGET DESCRIPTIONS
BEGIN GROUP VSAM_TGT;
DESCRIPTION COBOL ../copybk/ACCOUNT AS account_file;
END GROUP;
-- SOURCE DATASTORE (IP & Publisher name)
DATASTORE cdc://10.81.148.4:2626/vsmcdct/VSMTOKFK
OF VSAMCDC
AS CDCIN
DESCRIBED BY GROUP VSAM_SRC ACCEPT ALL;
-- TARGET DATASTORE(s) - Kafka and topic name
DATASTORE 'kafka:///MSKTutorialTopic/key'
OF JSON
AS CDCOUT
DESCRIBED BY GROUP VSAM_TGT FOR INSERT;
-- MAIN SECTION
PROCESS INTO
CDCOUT
SELECT
{
SETURL(CDCOUT, 'kafka:///MSKTutorialTopic/key')
REMAP(CDCIN, account_file, GET_RAW_RECORD(CDCIN, AFTER), GET_RAW_RECORD(CDCIN, BEFORE))
REPLICATE(CDCOUT, account_file)
}
FROM CDCIN;
```
**Beispiel für ein Schlüsselpaar**
Dies ist ein Beispiel dafür, wie die JCL ausgeführt wird, um das key pair zu generieren:
```
//SQDUTIL EXEC PGM=SQDUTIL //SQDPUBL DD DSN=&USER..NACL.PUBLIC, // DCB=(RECFM=FB,LRECL=80,BLKSIZE=21200), // DISP=(,CATLG,DELETE),UNIT=SYSDA, // SPACE=(TRK,(1,1)) //SQDPKEY DD DSN=&USER..NACL.PRIVATE, // DCB=(RECFM=FB,LRECL=80,BLKSIZE=21200), // DISP=(,CATLG,DELETE),UNIT=SYSDA, // SPACE=(TRK,(1,1)) //SQDPARMS DD keygen //SYSPRINT DD SYSOUT= //SYSOUT DD SYSOUT=* //SQDLOG DD SYSOUT=* //*SQDLOG8 DD DUMMY
```