AWS Mainframe Modernization Referenz zur Anwendungsdefinition

In AWS Mainframe Modernization konfigurieren Sie migrierte Mainframe-Anwendungen in einer JSON Anwendungsdefinitionsdatei, die für die von Ihnen gewählte Runtime-Engine spezifisch ist. Eine Anwendungsdefinition enthält sowohl allgemeine als auch modulspezifische Informationen. In diesem Thema werden sowohl die Anwendungsdefinitionen von AWS Blu Age als auch von Micro Focus beschrieben und alle erforderlichen und optionalen Elemente beschrieben.

Allgemeiner Kopfbereich

Jede Anwendungsdefinition beginnt mit allgemeinen Informationen über die Vorlagenversion und die Quellverzeichnisse. Die aktuelle Version der Anwendungsdefinition ist 2.0.

Verwenden Sie die folgende Struktur, um die Vorlagenversion und die Quellverzeichnisse anzugeben.

"template-version": "2.0",
    "source-locations": [
        {
            "source-id": "s3-source",
            "source-type": "s3",
            "properties": {
                "s3-bucket": "mainframe-deployment-bucket",
                "s3-key-prefix": "v1"
            }
        }
    ]

"template-version": "2.0",
  "source-locations": [
      {
          "source-id": "s3-source",
          "source-type": "s3",
          "properties": {
              "s3-bucket": "arn:aws:s3:::mainframe-deployment-bucket",
              "s3-key-prefix": "v1"
          }
      }
  ]

Überblick über den Definitionsbereich

Gibt die Ressourcendefinitionen der Dienste, Einstellungen, Daten und anderer typischer Ressourcen an, die die Anwendung zum Ausführen benötigt. Wenn Sie eine Anwendungsdefinition aktualisieren, AWS Mainframe Modernization erkennt es Änderungen, indem es die source-locations definition UND-Listen der vorherigen und der aktuellen Version der JSON Anwendungsdefinitionsdatei vergleicht.

Der Definitionsabschnitt ist modulspezifisch und kann sich ändern. In den folgenden Abschnitten werden beispielhafte Engine-spezifische Anwendungsdefinitionen für beide Engines gezeigt.

AWS Beispiel für eine Blu-Age-Anwendungsdefinition

{
 "template-version": "2.0",
 "source-locations": [
        {
            "source-id": "s3-source",
            "source-type": "s3",
            "properties": {
                "s3-bucket": "mainframe-deployment-bucket-aaa",
                "s3-key-prefix": "v1"
            }
        }
    ],
    "definition" : {
        "listeners": [{
            "port": 8194,
            "type": "http"
        }],
        "ba-application": {
            "app-location": "${s3-source}/murachs-v6/"
        },
        "blusam": {
            "db": {
                "nb-threads": 8,
                "batch-size": 10000,
                "name": "blusam",
                "secret-manager-arn": "arn:aws:secretsmanager:us-west-2:111122223333:secret:blusam-FfmXLG"
            },
            "redis": {
                "hostname": "blusam.c3geul.ng.0001.usw2.cache.amazonaws.com",
                "port": 6379,
                "useSsl": true,
                "secret-manager-arn": "arn:aws:secretsmanager:us-west-2:111122223333:secret:bluesamredis-nioefm"
            }
        }
    }
}

AWS Einzelheiten zur Blu Age-Definition

Zuhörer — erforderlich

Geben Sie den Port an, den Sie für den Zugriff auf die Anwendung über das von AWS Mainframe Modernization-erstellte Elastic Load Balancing verwenden möchten. Verwenden Sie die folgende Struktur:

"listeners": [{
            "port": 8194,
            "type": "http"
}],

AWS Blu Age-Anwendung — erforderlich

Geben Sie mithilfe der folgenden Struktur den Speicherort an, an dem die Engine die Anwendungs-Image-Datei abruft.

"ba-application": {
            "app-location": "${s3-source}/murachs-v6/",
            "files-directory": "/m2/mount/myfolder", 
            "enable-jics": <true|false>,
            "shared-app-location": "${s3-source}/shared/"
},

Blu SAM — fakultativ

Geben Sie die SAM Blu-Datenbank und den Redis-Cache mithilfe der folgenden Struktur an.

"blusam": {
            "db": {
                "nb-threads": 8,
                "batch-size": 10000,
                "name": "blusam",
                "secret-manager-arn": "arn:aws:secretsmanager:us-west-2:111122223333:secret:blusam-FfmXLG"
            },
            "redis": {
                "hostname": "blusam.c3geul.ng.0001.usw2.cache.amazonaws.com",
                "port": 6379,
                "useSsl": true,
                "secret-manager-arn": "arn:aws:secretsmanager:us-west-2:111122223333:secret:bluesamredis-nioefm"
            }
}

AWS Blu Age-Nachrichtenwarteschlangen — optional

Geben Sie die JMS -MQ-Verbindungsdetails für die AWS Blu Age-Anwendung an.

"message-queues": [ 
  {
      "product-type": "JMS-MQ",
      "queue-manager": "QMgr1",
      "channel": "mqChannel1",
      "hostname": "mqserver-host1",
      "port": 1414,
      "user-id": "app-user1",
      "secret-manager-arn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:sample/mq/test-279PTa"
  },
  {
      "product-type": "JMS-MQ",
      "queue-manager": "QMgr2",
      "channel": "mqChannel2",
      "hostname": "mqserver-host2",
      "port": 1412,
      "user-id": "app-user2",
      "secret-manager-arn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:sample/mq/test-279PTa"
  }
]

AWS EFSSpeicherkonfiguration der Blu Age-Anwendung — optional

Geben Sie die Details des EFS Zugriffspunkts für den Anwendungsspeicher mithilfe der folgenden Struktur an.

"ba-application": {
            "file-permission-mask": "UMASK002"
},
"efs-configs": [
           {
            "file-system-id": "fs-01376dfsvfvrsvsr",
            "mount-point": "/m2/mount/efs-ap2", 
            "access-point-id": fsap-0eaesefvrefrewgv8"
           }
]

Micro Focus-Anwendungsdefinition

Der folgende Abschnitt mit einer Beispieldefinition bezieht sich auf die Micro Focus Runtime Engine und enthält sowohl erforderliche als auch optionale Elemente.

{
 "template-version": "2.0",
 "source-locations": [
        {
            "source-id": "s3-source",
            "source-type": "s3",
            "properties": {
                "s3-bucket": "mainframe-deployment-bucket-aaa",
                "s3-key-prefix": "v1"
            }
        }
    ],
    "definition" : {
        "listeners": [{
            "port": 5101,
            "type": "tn3270"
        }],
        "dataset-location": {
            "db-locations": [{
                "name": "Database1",
                "secret-manager-arn": "arn:aws:secrets:1234:us-east-1:secret:123456"
            }]
        },
        "cognito-auth-handler": {
            "user-pool-id": "cognito-idp.us-west-2.amazonaws.com/us-west-2_rvYFnQIxL",
            "client-id": "58k05jb8grukjjsudm5hhn1v87",
            "identity-pool-id": "us-west-2:64464b12-0bfb-4dea-ab35-5c22c6c245f6"
        },
        "ldap-ad-auth-handler": {
            "ldap-ad-connection-secrets": [LIST OF AD-SECRETS]
        },
        "batch-settings": {
            "initiators": [{
                "classes": ["A", "B"],
                "description": "initiator...."
            }],
            "jcl-file-location": "${s3-source}/batch/jcl",
            "program-path": "/m2/mount/libs/loadlib:$EFS_MOUNT/emergency/loadlib",
            "system-procedure-libraries":"SYS1.PROCLIB;SYS2.PROCLIB",
            "aliases": [
               {"alias": "FDSSORT", "program": "SORT"},
               {"alias": "MFADRDSU", "program": "ADRDSSU"}
            ]
        },
        "cics-settings": {
            "binary-file-location": "${s3-source}/cics/binaries",
            "csd-file-location": "${s3-source}/cics/def",
            "system-initialization-table": "BNKCICV"
        },
        "jes-printers": [
           {
             "name": "printerName",
              "classes": [
                 "A",
                 "B"
             ],
             "description": "printer desc....",
             "exit-module": {
                 "name": "lrsprte6"
                }
             } 
         ],
        "xa-resources" : [{
            "name": "XASQL",
            "secret-manager-arn": "arn:aws:secrets:1234:us-east-1:secret:123456",
            "xa-connection-type": "postgres",
            "module": "${s3-source}/xa/ESPGSQLXA64.so"
        }],
        "runtime-settings": {
          "environment-variables": {
            "ES_JES_RESTART": "N",
            "EFS_MOUNT": "/m2/mount/efs",
            "LRSQ_ADDRESS": "<lrsq-address>"
          }
        }
    }
}

Einzelheiten zur Micro Focus-Definition

Der Inhalt des Definitionsabschnitts der Micro Focus-Anwendungsdefinitionsdatei variiert je nach den Ressourcen, die Ihre migrierte Mainframe-Anwendung zur Laufzeit benötigt.

Listener — erforderlich

Geben Sie einen Listener mit der folgenden Struktur an:

"listeners": [{
    "port": 5101,
    "type": "tn3270"
}],

Speicherorte von Datensätzen — erforderlich

Geben Sie den Speicherort des Datensatzes anhand der folgenden Struktur an.

"dataset-location": {
            "db-locations": [{
                "name": "Database1",
                "secret-manager-arn": "arn:aws:secrets:1234:us-east-1:secret:123456"
            }],
 }

Amazon Cognito Cognito-Authentifizierungs- und Autorisierungshandler — optional

AWS Mainframe Modernization verwendet Amazon Cognito für die Authentifizierung und Autorisierung für migrierte Anwendungen. Geben Sie den Amazon Cognito Cognito-Authentifizierungshandler mithilfe der folgenden Struktur an.

"cognito-auth-handler": {
            "user-pool-id": "cognito-idp.Region.amazonaws.com/Region_rvYFnQIxL",
            "client-id": "58k05jb8grukjjsudm5hhn1v87",
            "identity-pool-id": "Region:64464b12-0bfb-4dea-ab35-5c22c6c245f6"
}

LDAPund Active Directory-Handler — optional

Sie können Ihre Anwendung in Active Directory (AD) oder einen beliebigen LDAP Servertyp integrieren, sodass Benutzer der Anwendung ihre LDAP /AD-Anmeldeinformationen für die Autorisierung und Authentifizierung verwenden können.

Wenn die Anwendung integriert ist LDAP und gestartet wurde, müssen Sie Anmeldeinformationen angeben, um mindestens einen anwendungsbezogenen Vorgang ausführen zu können, der in der Liste der unterstützten Autorisierungen aufgeführt ist.

Der LDAP /AD-Authentifizierungshandler ist für Micro Focus 8.0.11 und spätere Versionen verfügbar.

Hier ist die Liste der Anwendungsoperationen, die derzeit die Autorisierung unterstützen:

Batch-Einstellungen — erforderlich

Geben Sie anhand der folgenden Struktur die Details an, die für die Batch-Jobs erforderlich sind, die als Teil der Anwendung ausgeführt werden.

"batch-settings": {
            "initiators": [{
                "classes": ["A", "B"],
                "description": "initiator...."
            }],
            "jcl-file-location": "${s3-source}/batch/jcl",
            "program-path": "/m2/mount/libs/loadlib:$EFS_MOUNT/emergency/loadlib",
            "system-procedure-libraries":"SYS1.PROCLIB;SYS2.PROCLIB",
            "aliases": [
               {"alias": "FDSSORT", "program": "SORT"},
               {"alias": "MFADRDSU", "program": "ADRDSSU"}
    ]
}

CICSEinstellungen — erforderlich

Geben Sie die Details, die für die CICS Transaktionen erforderlich sind, die als Teil der Anwendung ausgeführt werden, mithilfe der folgenden Struktur an.

"cics-settings": {
            "binary-file-location": "${s3-source}/cics/binaries",
            "csd-file-location": "${s3-source}/cics/def",
            "system-initialization-table": "BNKCICV"
}

Drucker — optional

Geben Sie einen JES-Drucker mit der folgenden Struktur an.

"jes-printers": [
    {
        "name": "printerName",
        "classes": [
            "A", 
            "B"
        ],
        "description": "printer desc....",
        "exit-module": {
            "name": "lrsprte6",
            "module" : "program"
        }
    }
],

Weitere Beispiele für die Definition des Exit-Moduls finden Sie im Drucker Abschnitt.

XA-Ressourcen — optional

Geben Sie mithilfe der folgenden Struktur die erforderlichen Details für die XA-Ressourcen an, die die Anwendung benötigt.

"xa-resources" : [{
            "name": "XASQL",
            "secret-manager-arn": "arn:aws:secrets:1234:us-east-1:secret:123456",
            "xa-connection-type": "postgres",
            "module": "${s3-source}/xa/ESPGSQLXA64.so"
}]

Laufzeiteinstellungen — optional

Geben Sie die Details an, die für die Laufzeiteinstellungen zur Verwaltung zulässiger Umgebungsvariablen erforderlich sind, indem Sie die folgende Struktur verwenden.

"runtime-settings": {
          "environment-variables": {
            "ES_JES_RESTART": "N",
            "EFS_MOUNT": "/m2/mount/efs"
    }
} 

Als UNIXAnleitung können Sie auf alle Micro Focus-Umgebungsvariablen im Micro Focus Enterprise Server zugreifen.