

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.

# AWS Mainframe Modernization auf Amazon EC2 EC2-Integration mit Control-M
<a name="aws-mainframe-modernization-ec2"></a>

In diesem Abschnitt wird beschrieben, wie Control-M in Batch-Jobs integriert ist und diese unterstützt, die in einer benutzerdefinierten AWS Mainframe Modernization Runtime-Umgebung ausgeführt werden, die auf einer EC2-Instance bereitgestellt wird. Wenn Sie die vollständig verwaltete AWS Replatform with Micro Focus-Laufzeitumgebung implementieren, finden Sie weitere Informationen im Abschnitt [Verwaltete AWS Mainframe Modernization Integration mit Control-M](aws-mainframe-modernization-managed.md).

In diesem Abschnitt werden die folgenden Voraussetzungen vorausgesetzt:
+ Ein aktives AWS-Konto.
+ Eine virtuelle private Cloud (VPC), in der die EC2-Instanzen erstellt werden.
+ Die Mainframe-Anwendung wird migriert und in einer AWS Replatform with Micro Focus-Umgebung auf einer EC2-Instance ausgeführt. Sie unterstützt die Micro Focus Runtime Engine mit mehreren definierten Batch-Jobs. Folgen Sie für dieses Pilotprojekt den Anweisungen unter [Replatforming](https://docs.aws.amazon.com/m2/latest/userguide/replatforming-m2.html) applications with Micro Focus. Die Dokumentation enthält alle Aufgaben und zusätzliche Informationen zur Konfiguration und zum Betrieb der AWS Replatform with Micro Focus-Laufzeitumgebung auf Amazon EC2.

Die folgenden Themen behandeln die Einrichtung, die für die Integration zwischen Control-M und der AWS Replatform with Micro Focus-Umgebung erforderlich ist:
+ [Stellen Sie Control-M- und Micro Focus-Ressourcen bereit](deploy-resources-environment.md)
+ [Erstellen Sie ein Control-M-Verbindungsprofil](create-control-m-connection-profile.md)
+ [Aufträge und Zeitpläne in Control-M Planning erstellen](create-jobs-schedules-control-m-planning.md)
+ [Verwalten Sie Jobläufe in Control-M mithilfe von Monitoring](monitor.md)

# Stellen Sie Control-M- und Micro Focus-Ressourcen bereit
<a name="deploy-resources-environment"></a>

Die ersten beiden Schritte bei der Integration von AWS Mainframe Modernization mit Control-M sind die Bereitstellung eines Control-M-Agenten und anschließend die Bereitstellung eines Plug-ins auf dem Agenten. Der dritte Schritt besteht darin, den Jobtyp in Control-M Application Integrator bereitzustellen.

## Stellen Sie einen Control-M-Agenten auf einer EC2-Instanz bereit
<a name="deploy-agent"></a>

Wenn Sie eine benutzerdefinierte AWS Replatform mit Micro Focus in der Amazon EC2 EC2-Laufzeitumgebung verwenden, wird das `MFBSIFJCL` Hilfsprogramm aufgerufen. Das Hilfsprogramm läuft auf dem Host, der mit dem Micro Focus Enterprise Server-Angebot von gestartet wurde. AWS Marketplace Um das `MFBSIFJCL` Utility auszuführen, müssen Sie auch einen Control-M-Agent auf diesem Host bereitstellen. Anweisungen finden Sie in der [Control-M-Dokumentation](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Agent_Installation.htm).

**Anmerkung**  
Sie können die erforderlichen Installationsmedien von der [BMC Electronic Product](https://www.bmc.com/support/resources/product-downloads.html) Download-Website herunterladen.

## Stellen Sie das Micro Focus Plug-in auf dem Control-M-Agent bereit
<a name="deploy-plug-in"></a>

Plug-ins bieten Integration und Support für die Anwendungen und Dienste, die von Control-M orchestriert werden.

Die Bereitstellung von Plug-ins ist eine seltene Aktivität. Wenn Sie bereits über ein vorhandenes Plug-in verfügen, das Sie verwenden möchten, überspringen Sie diesen Schritt und erstellen Sie ein Verbindungsprofil.

Auf Amazon EC2 macht der Service AWS Mainframe Modernization Replatform with Micro Focus die Micro Focus-Engine verfügbar. Für die Integration verwendet Control-M AWS Mainframe Modernization das Micro Focus-Plug-In. Weitere Informationen finden Sie in der [Control-M-Dokumentation](https://docs.bmc.com/docs/ctm_integrations/control-m-for-micro-focus-1193641959.html).

Sie müssen dieses Plug-in auf einem Agenten bereitstellen, der auf einem Host installiert ist, auf dem Micro Focus Enterprise Server ausgeführt wird.

## Stellen Sie einen AWS Mainframe Modernization Jobtyp in Control-M Application Integrator bereit
<a name="application-integrator"></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](create-control-m-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)
+ 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.
+ Melden Sie sich bei Application Integrator an.
+ Auf dem **Home**-Tab, wählen Sie **Auftragstyp aus Datei importieren** und den Speicherort von `AIM2JOB.ctmai`.
+ Wenn Sie Änderungen an dem mitgelieferten Beispiel vornehmen möchten, machen Sie sich mit Application Integrator vertraut.
+ 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
<a name="create-control-m-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, können Sie die [Konfigurationsdomäne](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_centralized_connection_profile.htm) der Control-M-Weboberfläche oder JSON verwenden. Der folgende Code ist ein Beispiel für die Verwendung von JSON:

```
{
  "MICROFOCUS-WINDOWS": {

  "Type": "ConnectionProfile:Micro Focus Windows",
  "Centralized": true,
  "Description": "Micro Focus on Windows Connection Profile - file locations refer to the Enterprise Server host", "MFBSI Config Path": "C:\\microfocus\\ES\\mfbsi\\MFWIN\\mfbsi.cfg",
  "MFBSI Directory Path": "c:\\microfocus\\es\\mfbsi\\MFWIN",
  "Runtime Environment": "\"C:\\Program Files (x86)\\Micro Focus\\Enterprise Developer\\createenv.bat\"", "Run As": "dbauser",
  "RunAs-Pass": "*****"
  }
}
```

Der Beispielcode befindet sich in der Datei `ConnectionProfile-Custom-M2-Replatform.json` im GitHub Repo. Verwenden Sie den Control-M Automation API-Bereitstellungsdienst, um den Code bereitzustellen:

```
ctm deploy ConnectionProfile-Custom-M2-Replatform.json
```

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

```
[ 
 {
    "deploymentFile": "cp-JOG-MF-WINDOWS.json", 
    "deploymentState": "DEPLOYED_CONNECTION_PROFILES", 
    "deploymentStatus": "ENDED_OK", 
    "successfulFoldersCount": 0, 
    "successfulSmartFoldersCount": 0, 
    "successfulSubFoldersCount": 0,
    "successfulJobsCount": 0, 
    "successfulConnectionProfilesCount": 1, 
    "successfulDriversCount": 0, 
    "isDeployDescriptorValid": false, 
    "deployedConnectionProfiles": [ " MICROFOCUS-WINDOWS " ]
  }
]
```

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

Nachdem Sie das Plug-in und ein Verbindungsprofil für die Micro Focus-Konnektivität bereitgestellt haben, können Sie mit der Erstellung und Ausführung von Jobs beginnen.

Jeder Control-M-Auftrag für Micro Focus 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 vor Ort bereitgestellten Betriebsdokumentation
+ 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, z. B. stündliches Laufen
+ 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 zu verwenden oder nach einem bestimmten Status zu suchen)
  + Benachrichtigungen, z. B. per E-Mail, über Fehler oder Erfolg
  + Veröffentlichungsstatus für nachgelagerte Abhängigkeiten

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

In den folgenden Abschnitten werden einige gängige Workflow-Szenarien untersucht:
+ [Initiieren Sie Jobs mithilfe eines Workflows](initiate-jobs.md)
+ [Die Ausführung von Aufträgen mit einer geplanten Frequenz automatisieren](automate-jobs.md)

# Initiieren Sie Jobs mithilfe eines Workflows
<a name="initiate-jobs"></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 von Control-M Web
<a name="control-m-web"></a>

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

1. In der Planning-Domain einen neuen Workspace hinzufügen. Dadurch wird eine Arbeitsfläche mit einem leeren Ordnerobjekt geöffnet.

1. Wählen Sie in der Menüleiste **Job hinzufügen**, wählen Sie den Micro Focus Windows- oder Micro Focus Linux-Job und ziehen Sie ihn auf die Vorderseite des Ordners.

1. Wenn sich die Farbe des Auftrags zu Grün geändert hat, lassen Sie ihn fallen. 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. [Anweisungen zum Erstellen eines Control-M-Auftrags für Micro Focus finden Sie in der Control-M-Dokumentation.](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Jobs_for_Mainframe_Modernization.htm#MicroFocusJob) Wiederholen Sie für dieses Pilotprojekt die Schritte 2—4 für fünf Jobs und benennen Sie jeden Auftrag von bis. `aws-mf-job1` `aws-mf-job5`

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 `aws-mf-job1` unter und ziehen Sie es auf`aws-mf-job2`. Diese Aktion macht `aws-mf-job1` den Vorgänger von`aws-mf-job2`. Standardmäßig `aws-mf-job1` muss sie jetzt erfolgreich abgeschlossen werden, bevor `aws-mf-job2` sie ausgeführt werden kann.

Das folgende Diagramm zeigt die Control-M-Planungsansicht des grundlegenden Auftragsablaufs.



![\[Workflow-Diagramm mit Eigenschaften im rechten Bereich.\]](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/control-m-batch-scheduler/images/control-m-web-planning.png)


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

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

Derselbe Flow kann in JSON codiert werden. Im GitHub Repo befindet sich der Beispielcode in der Datei`Folder-Custom-M2-Replatform.json`:

```
{
  "aws-custom-m2": {
    "Type": "Folder",
    "ControlmServer": "psctm",
    "OrderMethod": "Manual",
    "Application": "AWSM2",
    "SubApplication": "Replatform-Custom",
    "aws-mf-job1": {
      "Type": "Job:Micro Focus Windows",
      "ConnectionProfile": "MICROFOCUS-WINDOWS",
      "Enable JCL Variables": "unchecked",
      "Restart on Rerun": "unchecked",
      "Recapture ABEND Codes": "Ignore",
      "Recapture COND Codes": "Ignore",
      "Auto Adjust Restart": "Ignore",
      "Set MF_UCC11": "Ignore",
      "Restart with Modified JCL": "No",
      "Application": "AWSM2",
      "SubApplication": "Replatform-Custom",
      "Host": "microfocus-es-host",
      "Output": {}
    },
    "aws-mf-job2": {
      "Type": "Job:Micro Focus Windows",
      "ConnectionProfile": "MICROFOCUS-WINDOWS",
      "Enable JCL Variables": "unchecked",
      "Restart on Rerun": "unchecked",
      "Recapture ABEND Codes": "Ignore",
      "Recapture COND Codes": "Ignore",
      "Auto Adjust Restart": "Ignore",
      "Set MF_UCC11": "Ignore",
      "Restart with Modified JCL": "No",
      "Application": "AWSM2",
      "SubApplication": "Replatform-Custom",
      "Host": "microfocus-es-host",
      "Output": {}
    },
    "aws-mf-job3": {
      "Type": "Job:Micro Focus Windows",
      "ConnectionProfile": "MICROFOCUS-WINDOWS",
      "Enable JCL Variables": "unchecked",
      "Restart on Rerun": "unchecked",
      "Recapture ABEND Codes": "Ignore",
      "Recapture COND Codes": "Ignore",
      "Auto Adjust Restart": "Ignore",
      "Set MF_UCC11": "Ignore",
      "Restart with Modified JCL": "No",
      "Application": "AWSM2",
      "SubApplication": "Replatform-Custom",
      "Host": "microfocus-es-host",
      "Output": {}
    },
    "aws-mf-job4": {
      "Type": "Job:Micro Focus Windows",
      "ConnectionProfile": "MICROFOCUS-WINDOWS",
      "Enable JCL Variables": "unchecked",
      "Restart on Rerun": "unchecked",
      "Recapture ABEND Codes": "Ignore",
      "Recapture COND Codes": "Ignore",
      "Auto Adjust Restart": "Ignore",
      "Set MF_UCC11": "Ignore",
      "Restart with Modified JCL": "No",
      "Application": "AWSM2",
      "SubApplication": "Replatform-Custom",
      "Host": "microfocus-es-host",
      "Output": {}
    },
    "aws-mf-job5": {
      "Type": "Job:Micro Focus Windows",
      "ConnectionProfile": "MICROFOCUS-WINDOWS",
      "Enable JCL Variables": "unchecked",
      "Restart on Rerun": "unchecked",
      "Recapture ABEND Codes": "Ignore",
      "Recapture COND Codes": "Ignore",
      "Auto Adjust Restart": "Ignore",
      "Set MF_UCC11": "Ignore",
      "Restart with Modified JCL": "No",
      "Application": "AWSM2",
      "SubApplication": "Replatform-Custom",
      "Host": "microfocus-es-host",
      "Output": {}
    },
    "leftbranch": {
      "Type": "Flow",
      "Sequence": [
        "aws-mf-job1",
        "aws-mf-job2",
        "aws-mf-job3",
        "aws-mf-job5"
      ]
    },
    "rightbranch": {
      "Type": "Flow",
      "Sequence": [
        "aws-mf-job2",
        "aws-mf-job4",
        "aws-mf-job5"
      ]
    }
  }
}
```

Verwenden Sie die Control-M Automation API, um diesen Flow bereitzustellen:

```
ctm deploy Folder-Custom-M2-Replatform.json
```

# Die Ausführung von Aufträgen mit einer geplanten Frequenz automatisieren
<a name="automate-jobs"></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 Job ausgeführt werden kann (z. B. an jedem Wochentag, nur an Arbeitstagen, am Monatsende oder am Quartalsende). Sie können die grundlegende Terminplanung auf der Registerkarte [Terminplanung](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Job_scheduling.htm) festlegen.
+ Die Laufzeitplanung bestimmt, wann ein Job an dem Tag ausgeführt wird, an dem er ausgeführt werden kann (z. B. nach Abschluss der Vorgängerjobs, stündlich, nachdem bestimmte Ressourcen verfügbar sind oder erst nach manueller Bestätigung).

Sie können einige Laufzeitpläne im Abschnitt **Planung** und andere im Abschnitt **Voraussetzungen** definieren.

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

Sie können Jobs in der Control-M Monitoring-Domäne und in der [Micro Focus Enterprise Server Common Web](https://www.microfocus.com/documentation/visual-cobol/vc70/CSWin/GUID-C7A333B6-1DFB-49AC-8DB3-4023C6FCDEFB.html) Administration-Benutzeroberfläche überwachen und verifizieren.

## Control-M Monitoring
<a name="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 Arten von Control-M-Aufträgen umfasst AWS Mainframe Modernization , können Sie außerdem den gesamten Ablauf in der Monitoring-Domäne anzeigen und verwalten.

Sie können die detaillierten Schritte im [Abschnitt Viewpoints unter Monitoring in der Control-M-Dokumentation](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Viewpoints.htm) nachverfolgen.

Der folgende Screenshot zeigt die Ergebnisse von zwei Workflows. Auf der linken Seite wurde der Workflow erfolgreich abgeschlossen, wobei alle fünf Aufträge grün markiert sind. Auf der rechten Seite ist der Workflow nur teilweise erfolgreich, da der Status **Fehlgeschlagen `aws-mf-job3`** zurückgegeben wurde und der Workflow dort angehalten wurde, sodass der Status **Warteplan `aws-mf-job5`** beibehalten wurde.



![\[Workflow-Diagramme auf der linken Seite, Überwachung der Ausgabe auf der Registerkarte Ausgabe im rechten Bereich.\]](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/control-m-batch-scheduler/images/monitor-jobs-2.png)


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