AWS Der Mainframe Modernization Service (Managed Runtime Environment Experience) steht Neukunden nicht mehr zur Verfügung. Funktionen, die dem AWS Mainframe Modernization Service (Managed Runtime Environment-Erfahrung) ähneln, finden Sie unter AWS Mainframe Modernization Service (Self-Managed Experience). Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter Änderung der Verfügbarkeit von [AWS Mainframe Modernization](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).

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.

# Konfiguration für AWS Transform for Mainframe Runtime einrichten
<a name="ba-runtime-config"></a>

Die AWS Transform for Mainframe-Runtime und der Client-Code sind Webanwendungen, die das [Spring Boot-Framework](https://docs.spring.io/spring-boot/docs/2.5.14/reference/html/) verwenden. Es nutzt die Funktionen von Spring zur Bereitstellung von Konfigurationen mit mehreren möglichen Speicherorten und Prioritätsregeln. Es gibt auch ähnliche Prioritätsregeln für die Bereitstellung vieler anderer Dateien, wie Groovy-Skripte, SQL usw.

 AWS Transform for Mainframe Runtime enthält auch zusätzliche optionale Webanwendungen, die bei Bedarf aktiviert werden können.

**Topics**
+ [Grundlagen der Anwendungskonfiguration](#ba-runtime-config-app-basics)
+ [Vorrang der Anwendung](#ba-runtime-config-app-precedence)
+ [JNDI für Datenbanken](#ba-runtime-config-app-jndi)
+ [AWS Transformation für Mainframe-Runtime-Geheimnisse](ba-runtime-config-app-secrets.md)
+ [Andere Dateien (Groovy, SQL usw.)](#ba-runtime-config-app-files)
+ [Zusätzliche Webanwendung](#ba-runtime-config-app-webapp)
+ [Eigenschaften für AWS Transform for Mainframe Runtime aktivieren](ba-runtime-key-value.md)
+ [Verfügbare Redis-Cache-Eigenschaften in AWS Transform for Mainframe Runtime](ba-runtime-redis-configuration.md)
+ [Konfigurieren Sie die Sicherheit für Gapwalk-Anwendungen](ba-runtime-security.md)

## Grundlagen der Anwendungskonfiguration
<a name="ba-runtime-config-app-basics"></a>

Die Anwendungskonfiguration erfolgt standardmäßig über spezielle YAML-Dateien, die im `config` Ordner des Anwendungsservers bereitgestellt werden. Es gibt zwei Hauptkonfigurationsdateien für YAML:
+ `application-main.yaml`
+ `application-profile.yaml`(wobei der `profile` Wert während der Anwendungsgenerierung eingerichtet wird).

Die erste Datei konfiguriert das Framework`Gapwalk-application.war`, d. h. die zweite Datei enthält zusätzliche Optionen speziell für die Client-Anwendung. Dies funktioniert bei der Verwendung von Spring-Profilen: Die Gapwalk-Anwendung verwendet das `main` Profil, während die Client-Anwendung das Profil verwendet. `profile`

Das folgende Beispiel zeigt eine typische YAML-Hauptdatei.

![\[Auszug aus einer „Haupt“ -YAML-Datei.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/main-yaml.png)


Das folgende Beispiel zeigt eine typische Client-YAML-Datei.

![\[Beispiel für Client-YAML\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/client-yaml.png)


Hinweise zum Inhalt der YAML-Dateien finden Sie unter. [Eigenschaften für AWS Transform for Mainframe Runtime aktivieren](ba-runtime-key-value.md)

## Vorrang der Anwendung
<a name="ba-runtime-config-app-precedence"></a>

Für diese Konfigurationsdateien gelten die Spring-Prioritätsregeln. Insbesondere:
+ Die `application-main` YAML-Datei erscheint in der Gapwalk-War-Hauptdatei mit Standardwerten, und die Datei im `config` Ordner ersetzt sie.
+ Das Gleiche sollte für die Konfiguration der Client-Anwendung getan werden
+ Zusätzliche Parameter können beim Serverstart über die Befehlszeile übergeben werden. Sie würden die YAML-Werte überschreiben.

Weitere Informationen finden Sie in der [offiziellen Spring Boot-Dokumentation](https://docs.spring.io/spring-boot/docs/2.5.14/reference/html/features.html#features.external-config).

## JNDI für Datenbanken
<a name="ba-runtime-config-app-jndi"></a>

Die Datenbankkonfiguration wird möglicherweise mit JNDI in der Datei context.xml in Tomcat bereitgestellt. Jede solche Konfiguration würde die YAML-Konfiguration überschreiben. Beachten Sie jedoch, dass Sie damit Ihre Anmeldeinformationen nicht in einem geheimen Manager speichern können (siehe unten).

Das folgende Beispiel zeigt Beispielkonfigurationen für JICS und Blusam Datenbanken.

```
<Resource auth="Container" driverClassName="org.postgresql.Driver" initialSize="0" maxIdle="5" 
   maxOpenPreparedStatements="-1" maxTotal="10" maxWaitMillis="-1" name="jdbc/jics"
   poolPreparedStatements="true" testOnBorrow="false" type="javax.sql.DataSource" 		
   url="jdbc:postgresql://XXXX.rds.amazonaws.com:5432/XXXX" username="XXXX" password="XXXX" />
```

jdbc/jics  
Wäre `jdbc/jics` für die JICS-Datenbank und `jdbc/bluesam` (achten Sie auf das 'e') für die Datenbank. Blusam

url="jdbc:postgresql: //xxxx.rds.amazonaws.com:5432/XXXX“ username="XXXX“ password="XXXX“  
Die Datenbank-URL, der Benutzername und das Passwort.

## Andere Dateien (Groovy, SQL usw.)
<a name="ba-runtime-config-app-files"></a>

Die anderen vom Kundenprojekt verwendeten Dateien verwenden ähnliche Prioritätsregeln wie die für die Spring-Konfiguration. Beispiele:
+ Groovy-Skripte sind `.groovy` Dateien im `scripts` Ordner oder in Unterordnern. 
+ SQL-Skripten sind `.sql` Dateien im `sql` Ordner oder in Unterordnern.
+ Daemon-Skripten sind `.groovy` Dateien im `daemons` Ordner oder in Unterordnern. 
+ Abfragen Bei der Datenbankzuordnungsdatei handelt es sich um Dateien mit dem Namen `queries-database.mapping` Dateien in den `sql` Unterordnern des Ordners.
+ Jasper-Vorlagen sind `.jrxml` Dateien im `templates` Ordner oder in Unterordnern. 
+ Datensatzkataloge sind `.json` Dateien im Ordner. `catalog`
+ Lnk-Dateien sind `.json` Dateien im `lnk` Ordner.

All diese Speicherorte können mithilfe einer Systemeigenschaft oder einer Client-YAML-Eigenschaft außer Kraft gesetzt werden.
+ Für Groovy-Skripte: `configuration.scripts`
+ Für SQL-Skripte: `configuration.sql`
+ Für Daemon-Skripte: `configuration.daemons`
+ Für Abfragen: Datenbankzuordnungsdatei: `configuration.databaseMapping`
+ Für Jasper-Vorlagen: `configuration.templates`
+ Für Datensatz-Kataloge: `configuration.catalog`
+ Für Lnk-Dateien: `configuration.lnk`

Wenn die Eigenschaft nicht gefunden wird, werden die Dateien vom oben genannten Standardspeicherort übernommen. Die Suche erfolgt zunächst mit dem Tomcat-Arbeitsverzeichnis als Stammverzeichnis und zuletzt in der WAR-Datei der Anwendung.

## Zusätzliche Webanwendung
<a name="ba-runtime-config-app-webapp"></a>

Die AWS Transform for Mainframe-Runtime enthält zusätzliche Webanwendungen in ihrem `webapps-extra` Ordner. Diese Anwendungen werden standardmäßig nicht vom Tomcat-Server bedient.

Die Registrierung für diese Webanwendungen hängt vom Modernisierungsprojekt ab und erfolgt durch Verschieben der gewünschten WAR-Datei aus dem Ordner in den `webapps-extra` Ordner. `webapps` Danach wird der Krieg beim nächsten Start vom Tomcat-Server bedient.

Einige projektspezifische Zusatzkonfigurationen können auch in einer YAML-Konfigurationsdatei für jeden weiteren Krieg hinzugefügt werden, wie in der `application-main.yml` Datei beschrieben und oben erklärt. Die zusätzlichen Kriege sind:
+ `gapwalk-utility-pgm.war`: enthält Unterstützung für ZOS-Hilfsprogramme und wird `application-utility-pgm.yaml` als Konfiguration verwendet.
+ `gapwalk-cl-command.war`: enthält Unterstützung für AS/400-Hilfsprogramme und wird `application-cl-command.yaml` als Konfiguration verwendet.
+ `gapwalk-hierarchical-support.war`: enthält IMS/MFS Transaktionsunterstützung und wird `application-jhdb.yaml` als Konfiguration verwendet