

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.

# Verwaltete AWS Mainframe Modernization Integration mit Control-M
<a name="aws-mainframe-modernization-managed"></a>

In diesem Abschnitt wird beschrieben, wie Control-M in Batch-Jobs integriert ist und diese unterstützt, die in einer verwalteten AWS Mainframe Modernization Umgebung ausgeführt werden, die mit einer Micro Focus Runtime Engine bereitgestellt wird. Wenn Sie eine benutzerdefinierte AWS Replatform with Micro Focus-Umgebung auf Amazon EC2 implementieren, lesen Sie den AWS Mainframe Modernization Abschnitt zur Amazon [EC2 EC2-Integration mit](aws-mainframe-modernization-ec2.md) Control-M.

In diesem Abschnitt werden die folgenden Voraussetzungen vorausgesetzt:
+ Ein aktiver AWS-Konto.
+ Die Mainframe-Anwendung wird migriert und in einer von AWS Replatform with Micro Focus verwalteten Laufzeitumgebung mit mehreren definierten Batch-Jobs ausgeführt.
+ Für dieses Pilotprojekt ist die BankDemo Beispielanwendung in eingerichtet. AWS Mainframe Modernization Anweisungen zur Einrichtung finden Sie unter [Tutorial: Managed Runtime for Micro Focus](https://docs.aws.amazon.com/m2/latest/userguide/tutorial-runtime.html).

In den folgenden Themen wird die step-by-step Einrichtung beschrieben, die für die Integration zwischen Control-M Scheduler und der AWS Mainframe Modernization Umgebung für verschiedene Arten von Integrations-Workflows erforderlich ist:
+ [Stellen Sie Control-M-Ressourcen bereit](deploy-control-m-resources.md)
+ [Ein Control-M-Verbindungsprofil für die AWS Mainframe Modernization erstellen](connection-profile.md)
+ [Aufträge und Zeitpläne in Control-M Planning erstellen](jobs-schedules-control-m.md)
+ [Aufträge überwachen](monitor-jobs.md)

# Stellen Sie Control-M-Ressourcen bereit
<a name="deploy-control-m-resources"></a>

Die ersten beiden Schritte bei der Integration von AWS Mainframe Modernization mit Control-M sind die Bereitstellung des Plug-ins und des Jobtyps.

## Stellen Sie das Control-M-Plug-In bereit AWS Mainframe Modernization
<a name="deploy-plug-in"></a>

Plug-ins bieten Integration und Unterstützung für die Anwendungen und Dienste, die von Control-M orchestriert werden. Stellen Sie für den verwalteten AWS Mainframe Modernization Dienst das Plug-In bereit. AWS Mainframe Modernization 

Die Bereitstellung des Plug-ins ist eine seltene Aktivität. Wenn Sie das Plug-in zum ersten Mal installieren, folgen Sie den Schritten in der [Control-M-Dokumentation](https://docs.bmc.com/docs/ctm_integrations/control-m-for-aws-mainframe-modernization-1244652367.html). Wenn Sie über ein vorhandenes Plug-in verfügen, das Sie verwenden möchten, überspringen Sie diesen Schritt und [erstellen Sie ein Verbindungsprofil](connection-profile.md).

## Stellen Sie einen AWS Mainframe Modernization Jobtyp in Control-M Application Integrator bereit
<a name="deploy-job-type"></a>

Die Bereitstellung des Auftragstyps ist normalerweise eine einmalige Aktivität. Wenn Sie bereits einen vorhandenen Auftragstyp haben, den Sie verwenden möchten, überspringen Sie diesen Schritt, und fahren Sie mit [ein Verbindungsprofil erstellen](connection-profile.md) fort.

Das Beispiel für den Auftragstyp [AIJOB.ctmai](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration/blob/main/assets/AIJOB.ctmai) wird im Git-Repository bereitgestellt. [Um einen Jobtyp bereitzustellen, müssen Sie die folgenden Schritte mit Application Integrator ausführen:](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Application_Integrator.htm)

1. Klonen Sie das [aws-mainframe-modernization-controlm GitHub -integration-Repository](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration) und laden Sie die `AIJOB.ctmai` Datei in ein Dateisystemverzeichnis herunter, auf das Application Integrator zugreifen kann.

1. Melden Sie sich bei Application Integrator an.

1. Auf dem **Home**-Tab, wählen Sie **Auftragstyp aus Datei importieren** und den Speicherort von `AIJOB.ctmai`.

1. Wenn Sie Änderungen an dem mitgelieferten Beispiel vornehmen möchten, machen Sie sich mit Application Integrator vertraut.

1. Stellen Sie den Auftragstyp bereit, und folgen Sie den Anweisungen in der [Control-M-Dokumentation](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Deploying_and_Publishing_a_Plug-in.htm).

# Erstellen Sie ein Control-M-Verbindungsprofil für AWS Mainframe Modernization
<a name="connection-profile"></a>

Verbindungsprofile definieren Verbindungsattribute und Sicherheitsanmeldeinformationen für eine bestimmte Instance einer Anwendung. Auf jedes Verbindungsprofil können mehrere Aufträge verweisen. Sie können separate Profile für jede eindeutige Kombination aus Anwendung und Anmeldeinformationen einrichten.

[Um [Verbindungsprofile zu definieren](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_centralized_connection_profile.htm), können Sie die grafische Benutzeroberfläche (GUI) verwenden, die in der **Konfigurationsdomäne** der Control-M-Weboberfläche verfügbar ist, oder Sie können JSON verwenden.](https://docs.bmc.com/docs/automation-api/monthly/connection-profiles-1116950312.html) Informationen zum Verbindungsprofil des AWS Mainframe Modernization Plug-ins finden Sie in der [Control-M-Dokumentation](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Mainframe_Modernization_Connection_Profiles.htm#AWSMainframeModernizationConnectionProfileParameters).

Der folgende Code ist ein Beispiel für die Verwendung von JSON:

```
{
  "MANAGED-M2-REPLATFORM": {
    "Type": "ConnectionProfile:AWS Mainframe Modernization",
    "Mainframe Modernization URL": "https://m2.{{AwsRegion}}.amazonaws.com",
    "Connection Timeout": "30",
    "AWS Region": "us-west-2",
    "Authentication": "NoSecret",
    "IAM Role": "--- IAM Role name ---",
    "AWS Logs URL": "https://logs.{{AwsRegion}}.amazonaws.com",
    "Description": "",
    "Centralized": true
  }
}
```

Erstellen Sie eine JSON-Datei, die dem Beispiel ähnelt, und stellen Sie sie mithilfe des [Control-M Automation API-Bereitstellungsdienstes](https://docs.bmc.com/docs/automation-api/monthly/deploy-service-1116950327.html) bereit. Wenn der JSON-Code beispielsweise in einer Datei mit dem Namen gespeichert wird`cp-MANAGED-M2-REPLATFORM.json`, lautet die `ctm` CLI-Syntax für die Bereitstellung dieses Verbindungsprofils wie folgt:

```
 ctm deploy cp-MANAGED-M2-REPLATFORM.json
```

Die Antwort der Control-M Automation API wird wie folgt aussehen:

```
[
  {
    "deploymentFile": "cp-Managed-M2-REPLATFORM.json",
    "deploymentState": "DEPLOYED_CONNECTION_PROFILES",
    "deploymentStatus": "ENDED_OK",
    "successfulFoldersCount": 0,
    "successfulSmartFoldersCount": 0,
    "successfulSubFoldersCount": 0,
    "successfulJobsCount": 0,
    "successfulConnectionProfilesCount": 1,
    "successfulDriversCount": 0,
    "isDeployDescriptorValid": false,
    "deployedConnectionProfiles": [
      "MANAGED-M2-REPLATFORM"
    ]
  }
]
```

# Aufträge und Zeitpläne in Control-M Planning erstellen
<a name="jobs-schedules-control-m"></a>

Nachdem Sie den Auftragstyp und ein Verbindungsprofil für AWS-Konnektivität bereitgestellt haben, können Sie mit der Erstellung und Ausführung von Aufträgen beginnen.

Jeder AWS Mainframe Modernization Serviceauftrag besteht aus einer Reihe von Attributen, die in vier Abschnitte unterteilt sind. Jeder Abschnitt kann viele Attribute haben. Die folgende Liste zeigt einige der am häufigsten verwendeten Attribute.
+ Allgemeines:
  + Der Name des Auftrags
  + Die Anwendung und Unteranwendung, zu der der Auftrag gehört
  + Die JCL für die Übertragung
  + Ein Link zur Dokumentation
+ Planung:
  + Monate und Tage, an denen dieser Auftrag ausgeführt werden kann
  + Kalender wie Geschäftsbuchhaltungsperioden, Feiertage oder andere besondere Daten, die nicht algorithmisch definiert werden können
  + Zeitfenster
  + Zyklisches Verhalten
+ Voraussetzungen:
  + Upstream-Abhängigkeiten (normalerweise Aufträge, die erfolgreich abgeschlossen werden müssen, bevor dieser Auftrag ausgeführt werden kann)
  + Ressourcen, die möglicherweise erforderlich sind
  + Benutzeraktion, die möglicherweise erforderlich ist
+ Aktionen, die von Control-M nach Abschluss des Auftrags ausgeführt werden:
  + Feststellung des Erfolgs oder Misserfolgs eines Auftrags (in der Regel auf der Grundlage der Abschlusscodes des Auftrags, aber Sie können diese Einstellung überschreiben, um Ausgabetext oder Prüfungen für einen bestimmten Status zu verwenden)
  + Benachrichtigungen, z. B. per E-Mail, über Fehler oder Erfolg
  + Veröffentlichungsstatus für nachgelagerte Abhängigkeiten

Wie bei Verbindungsprofilen können Aufträge erstellt und bereitgestellt [in der GUI](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_Job.htm) oder [im JSON-Format](https://docs.bmc.com/docs/automation-api/monthly/code-reference-1116950299.html) und mithilfe der Control-M Automation API werden.

In den folgenden Abschnitten werden einige gängige Workflow-Szenarien untersucht:
+ [Aufträge auf der Grundlage des Statuscodes früherer Aufträge initiieren](status-code.md)
+ [Die Ausführung von Aufträgen mit einer geplanten Frequenz automatisieren](scheduled.md)
+ [Basisauftragsläufe bei Ereignissen](event-based.md)

# Aufträge auf der Grundlage des Status früherer Aufträge initiieren
<a name="status-code"></a>

Erstellen Sie einen Auftragsablauf, der als Workflow bezeichnet wird. Aufträge im Workflow sind miteinander verknüpft und hängen davon ab, ob die vorherigen Aufträge erfolgreich abgeschlossen wurden.

## Verwenden der Control-M-Web-GUI
<a name="using-gui"></a>

Gehen Sie wie folgt vor, um einen Job von der Control-M-Benutzeroberfläche aus zu starten:

1. **Fügen Sie in der **Planning-Domäne** einen neuen Workspace hinzu.** Dadurch wird eine Arbeitsfläche mit einem leeren Ordnerobjekt geöffnet.

1. Wählen Sie den AWS Mainframe Modernization Jobtyp aus (wenn Sie die mitgelieferte Job-Typ-Vorlage verwenden, wird diese als [M2JOB](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration/blob/main/assets/AWS-jobs.json) bezeichnet), und ziehen Sie ihn in den Ordner.

1. Wenn sich die Farbe des Auftragstyps zu Grün geändert hat, legen Sie ihn ab. Der Bereich auf der rechten Seite enthält die Abschnitte „**Allgemein**“, „**Planung**“, „**Voraussetzungen**“ und „**Aktionen**“. Informationen zum Erstellen des Jobs finden Sie in den Standardanweisungen in der [Control-M-Dokumentation.](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_Job.htm)

1. Als Nächstes benötigen Sie die **Job-Name-Werte**, um die Jobtypen zu konfigurieren. Sie finden die Werte für den **Jobnamen** auf dem Bildschirm mit der **Anwendungsdefinition** der AWS Mainframe Modernization Konsole oder indem Sie die [ListBatchJobDefinitions API](https://docs.aws.amazon.com/m2/latest/APIReference/API_ListBatchJobDefinitions.html) ausführen. Wiederholen Sie für dieses Pilotprojekt die Schritte 2—4 für mehrere Jobs und benennen Sie jeden Auftrag mit einem beliebigen Namen. Beispielnamen sind`CBANK`,`CURRENCY`, I`NVFUNDS`, `BROKERAGE``RISKMGMT`, und`BANK-SERVICE-Managed-M2`.

1. Um diese Jobs mit dem gewünschten Flow zu verbinden, wählen Sie das Bedingungsdreieck unter dem Auftragsobjekt aus und ziehen Sie es auf den nächsten Job. Wählen Sie beispielsweise das Bedingungsdreieck unter `CBANK` aus und ziehen Sie es auf`CURRENCY`. Diese Aktion macht `CBANK` den Vorgänger von`CURRENCY`. Standardmäßig `CBANK` muss sie jetzt erfolgreich abgeschlossen werden, bevor CURRENCY ausgeführt werden kann.

Der folgende Screenshot zeigt die Control-M-Planungsansicht des grundlegenden Auftragsablaufs.



![\[Auftragsablauf auf der linken Seite und Eigenschaften auf der rechten Seite.\]](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/control-m-batch-scheduler/images/workflow-control-m-web-1.png)


*Bild mit freundlicher Genehmigung von BMC Software, Inc. ©2022*

## Verwendung von JSON:
<a name="using-json"></a>

Derselbe Ablauf kann in JSON codiert werden:

```
{
  "Defaults": {
    "Application": "AWSM2",
    "SubApplication": "Replatform-Managed",
    "Job": {
      "Host": "ctm-worker",
      "Output": {}
    }
  },
  "jog-managed-m2": {
    "Type": "Folder",
    "ControlmServer": "psctm",
    "OrderMethod": "Manual",
    "SiteStandard": "_z_DemoBusinessFlows",
    "CBANK": {
      "Type": "Job:AWS Mainframe Modernization",
      "ConnectionProfile": "MANAGED-M2-REPLATFORM",
      "JCL Name": "iefbr14",
      "Retrieve CloudWatch Logs": "checked",
      "Action": "Start Batch Job",
      "Application Version": "1"
    },
    "CURRENCY": {
      "Type": "Job:AWS Mainframe Modernization",
      "ConnectionProfile": "MANAGED-M2-REPLATFORM",
      "JCL Name": "iefbr14",
      "Retrieve CloudWatch Logs": "checked",
      "Action": "Start Batch Job",
      "Application Version": "1"
    },
    "BROKERAGE": {
      "Type": "Job:AWS Mainframe Modernization",
      "ConnectionProfile": "MANAGED-M2-REPLATFORM",
      "JCL Name": "iefbr14",
      "Retrieve CloudWatch Logs": "checked",
      "Action": "Start Batch Job",
      "Application Version": "1"
    },
    "INVFUNDS": {
      "Type": "Job:AWS Mainframe Modernization",
      "ConnectionProfile": "MANAGED-M2-REPLATFORM",
      "JCL Name": "iefbr14",
      "Retrieve CloudWatch Logs": "checked",
      "Action": "Start Batch Job",
      "Application Version": "1"
    },
    "RISKMGMT": {
      "Type": "Job:AWS Mainframe Modernization",
      "ConnectionProfile": "MANAGED-M2-REPLATFORM",
      "JCL Name": "iefbr14",
      "Retrieve CloudWatch Logs": "checked",
      "Action": "Start Batch Job",
      "Application Version": "1"
    },
    "BANK-SERVICE-Managed-M2": {
      "Type": "Job:SLAManagement",
      "ServiceName": "Bank Service - Managed M2",
      "RunAs": "ctmagent",
      "CompleteBy": {
        "Time": "12:00",
        "Days": "0"
      }
    },
    "leftbranch": {
      "Type": "Flow",
      "Sequence": [
        "CURRENCY",
        "RISKMGMT",
        "BANK-SERVICE-Managed-M2"
      ]
    },
    "middlebranch": {
      "Type": "Flow",
      "Sequence": [
        "CBANK",
        "CURRENCY",
        "INVFUNDS",
        "BANK-SERVICE-Managed-M2"
      ]
    },
    "rightbranch": {
      "Type": "Flow",
      "Sequence": [
        "CURRENCY",
        "BROKERAGE",
        "BANK-SERVICE-Managed-M2"
      ]
    }
  }
}
```

Verwenden Sie den Deploy-Service, um diesen Flow bereitzustellen:

```
ctm deploy folder-MANAGED-M2-REPLATFORM.json
```

# Die Ausführung von Aufträgen mit einer geplanten Frequenz automatisieren
<a name="scheduled"></a>

Mit dem Flow, den Sie in den vorherigen Schritten erstellt haben, können Sie die Basis- und Laufzeit-Planung hinzufügen.
+ Die grundlegende Terminplanung definiert, an welchen Tagen ein Auftrag ausgeführt werden kann (z. B. an jedem Wochentag, nur an Arbeitstagen, am Monatsende oder am Quartalsende).
+ Die Laufzeitplanung bestimmt, wann ein Job an dem Tag ausgeführt wird, an dem er ausgeführt werden kann (z. B. jede Stunde, nachdem bestimmte Ressourcen verfügbar sind, oder erst nach manueller Bestätigung).

Sie können die grundlegende Planung und die Laufzeitplanung in der Registerkarte **Planung**.

# Basisauftragsläufe bei Ereignissen
<a name="event-based"></a>

Control-M Managed File Transfer (MFT) ist ein FTP/SFTP Client und Server, mit dem Sie Dateien überwachen und zwischen einem lokalen Host und einem Remote-Host übertragen können. Weitere Informationen zum Definieren eines File-Transfer-Auftrags finden Sie in der [Control-M-Dokumentation](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/File_Transfer_Job.htm).

Dieser Pilot verwendet den File-Transfer-Auftrag, um auf ein Dateierzeugungsereignis einer Datei mit der Erweiterung .poc im Ordner `/bmcfile` in einem S3-Bucket mit dem Namen `bmc-poc-bucket` zu achten. Wenn dieses Ereignis eintritt, wird der Control-M-Auftrag initiiert, um den nächsten Auftrag auszuführen. Sie können optional den vollständigen Pfad einschließlich des Bucket-Namens übergeben.

# Aufträge überwachen
<a name="monitor-jobs"></a>

Sie können die Verarbeitung von Jobs innerhalb der Control-M Monitoring-Domäne und über die überwachen und validieren AWS-Managementkonsole, wodurch eine umfassende Überwachung und Überprüfung auf beiden Plattformen gewährleistet wird.

## Control-M Monitoring
<a name="control-m-monitoring"></a>

Auftragseinreichungen und -ausführungen können überwacht werden in der *Domain Control-M Monitoring.* Standardmäßig werden AWS Mainframe Modernization Serviceaufträge zusammen mit allen anderen Control-M-Aufgaben angezeigt. *Wenn Sie nur die AWS Mainframe Modernization Serviceaufträge ohne weitere Arbeitslast (oder andere Filteranforderungen) sehen möchten, können Sie einen Viewpoint erstellen.*

Viewpoints zeigen nicht nur Auftragsinformationen, sondern auch Beziehungen zu Abhängigkeiten vor- und nachgelagerter Vorgänge. Wenn Ihr Workflow auch andere Control-M-Auftragstypen umfasst AWS Mainframe Modernization , können Sie außerdem den gesamten Ablauf in der Monitoring-Domäne anzeigen und verwalten.

Die detaillierten Schritte finden Sie in der Control-M-Dokumentation im [Abschnitt „Betrachtungspunkte“ unter „Überwachung](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Viewpoints.htm)“.

Der folgende Screenshot zeigt die Ergebnisse von zwei Workflows. Auf der linken Seite wurde der Workflow erfolgreich abgeschlossen, wobei alle Jobs grün markiert sind. Auf der rechten Seite ist der Workflow nur teilweise erfolgreich, da der Job den Status **Fehlgeschlagen `CURRRENCY`** zurückgegeben hat, was durch die rote Farbe gekennzeichnet ist. Der Workflow wurde dort angehalten, sodass sich die verbleibenden Jobs im Status **Wartezeitplan** befinden.



![\[Diagramme der Workflows auf der linken Seite, Auftragseigenschaften auf der rechten Seite.\]](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/control-m-batch-scheduler/images/monitor-jobs.png)


*Bild mit freundlicher Genehmigung von BMC Software, Inc. ©2022*

## Überwachung auf der Konsole
<a name="console"></a>

Um Job- und Protokollinformationen zu sehen AWS, melden Sie sich bei der AWS-Managementkonsole an und navigieren Sie dann zur [AWS Mainframe Modernization Konsole](https://console.aws.amazon.com/m2/home?region=us-east-1#/applications). 



![\[Jobs und Status, die in der AWS Mainframe Modernization Console aufgeführt sind.\]](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/control-m-batch-scheduler/images/monitor-jobs-aws-management-console.png)


Diese Ansicht beinhaltet weder Abhängigkeiten noch Workloads, die nicht vom Service verwaltet werden. AWS Mainframe Modernization 