

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.

# Verfügbare Redis-Cache-Eigenschaften in AWS Transform for Mainframe Runtime
<a name="ba-runtime-redis-configuration"></a>

In diesem Dokument erfahren Sie mehr über die Redis-Caches in AWS Transform for Mainframe Runtime sowie über die Gapwalk-Konfiguration, die unterstützten Redis-Eigenschaften und darüber, wie die `application-main.yml` Datei auf den geheimen ARN für Redis-Caches verweisen kann.

## Redis-Caches in Transform für Mainframe Runtime AWS
<a name="ba-redis-caches-in-runtime"></a>

Redis-Server können als Caches für verschiedene Funktionen in der Gapwalk-Anwendung AWS Transform for Mainframe verwendet werden, z. B.:


****  

| AWS Funktionen von Transform for Mainframe Runtime, die Redis-Caching verwenden | Description | 
| --- | --- | 
| BlusamCache | Ein Blusam Redis-Cache zum effizienten Lesen von Datensätzen mithilfe einer Write-Behind-Strategie zur Optimierung schreibintensiver Workloads, die bei Batch-Payloads auftreten.  | 
| BlusamSperren | Ein Cache für verteilte Sperren für Datensätze und Datensätze. | 
| Datensatz-Katalog | Der Catalog-Dataset-Cache. | 
| Sitzungs-Cache | Ein Redis-Cache für HttpSession. Der Cache speichert den Benutzernamen, den Status des Dialogs mit dem Angular-Frontend und spezifische Dialektinformationen (BMS, MFS). AS400 | 
| Sitzungs-Tracker | Ein Cache mit aktiven Sitzungen mit zugehörigem Benutzernamen und session-creation-time Informationen. | 
| JICS-Cache | Ein Cache für JICS-Ressourcendefinitionen. | 
| TS-Warteschlangen | Speicher für TS-Warteschlangen. | 
| JCL-Checkpoint |  JCL-Checkpoint-Cache. | 
| Gapwalk-Dateisperren | Ein Cache für verteilte Dateisperren nach Job. | 
| Blu4IV-Sperren | Speicher für Blu4IV-Datensatzsperren. | 

## Redis Gapwalk-Konfiguration
<a name="ba-runtime-redis-gapwalk-configuration"></a>

Die globale Redis-Konfiguration wird verwendet, wenn sie als Caching-Mechanismus angegeben `redis` ist und keine Redis-Konfiguration für die spezifische Funktion bereitgestellt wird. Diese Konfiguration ermöglicht es Ihnen, dieselbe Konfiguration für mehrere Redis-Caches gleichzeitig zu verwenden.

Im folgenden Beispiel verwenden der Blusam Cache und der JICS-Cache die Konfiguration `gapwalk.redis` (`redis.server1`), da ihr Cachetyp auf gesetzt ist und unter und keine impliziten Redis-Eigenschaften angegeben sind. `redis` [Definitionen von JICS-Ressourcen](#ba-runtime-redis-jics-cache) [Definitionen von JICS-Ressourcen](#ba-runtime-redis-jics-cache) Der Blusam Locks-Cache verwendet jedoch eine andere Redis-Konfiguration (`redis.server2`), da seine Redis-Eigenschaften explizit definiert sind.

```
...
 
 gapwalk:
   redis:
     hostName: redis.server1
 	port: 6379
 ...
 
 bluesam:
   # Redis bluesam cache
   cache: redis
   # Redis locks cache
   locks:
     cache: redis
 	hostName: redis.server2
 	port: 6379
 ...
 # Redis jics cache
 jics:
   resource-definitions:
     store-type: redis
 ...
```

 Um die globale Redis-Konfiguration zu aktivieren, fügen Sie die folgende Konfiguration unter hinzu. `main-application.yml` 

```
 gapwalk:
   redis:
     hostName: localhost
     port: 6379
     mode: standalone                        # Optional
     username:                               # Optional
     password: ""                            # Optional
     useSsl: false                           # Optional
     database: 0                             # Optional
     maxTotal: 128                           # Optional
     maxIdle: 128                            # Optional
     minIdle: 16                             # Optional
     testOnBorrow: true                      # Optional
     testOnReturn: true                      # Optional
     testWhileIdle: true                     # Optional
     testOnCreate: true                      # Optional
     minEvictableIdleTimeMillis: 60000       # Optional
     timeBetweenEvictionRunsMillis: 30000    # Optional
     numTestsPerEvictionRun: -1              # Optional
     blockWhenExhausted: true                # Optional
     nettyThreads: 32                        # Optional
     subscriptionsPerConnection: 10          # Optional
     subscriptionConnectionPoolSize: 100     # Optional
     pageSizeInBytes: 8192                   # Optional
     readTimeout: 2000                       # Optional
```

## Unterstützte Redis-Eigenschaften
<a name="ba-runtime-redis-supported-properties"></a>

Die folgende Tabelle zeigt die Redis-Eigenschaften, die für globale und spezifische Redis-Caches auf AWS Transform for Mainframe Runtime unterstützt werden.


****  

| Name der Eigenschaft | Erforderlich? | Description | Werte | Standard | 
| --- | --- | --- | --- | --- | 
| mode | Nein | Der Redis-Laufmodus. | standalone \$1 cluster | standalone | 
| hostname | Ja | Der Hostname oder die IP-Adresse des Redis-Servers. | Zeichenfolge | Null | 
| port | Ja | Die Portnummer, auf der der Redis-Server auf Verbindungen wartet. | int | Null | 
| username | Nein | Der Benutzername für die Authentifizierung. | Zeichenfolge | Null | 
| password | Nein | Das Passwort für die Authentifizierung. | Zeichenfolge | leere Zeichenfolge | 
| useSsl  | Nein | Gibt an, ob die SSL/TLS Verschlüsselung für die Redis-Verbindung aktiviert werden soll. | boolesch | false | 
| database | Nein | Die zu verwendende Redis-Datenbanknummer. Redis unterstützt mehrere logische Datenbanken, und diese Eigenschaft gibt an, welche verwendet werden soll. | int | 0 | 
| maxTotal | Nein | Die maximale Anzahl von Verbindungen, die im Redis-Verbindungspool zulässig sind. | int  | 128 | 
| maxIdle | Nein | Die maximale Anzahl inaktiver Verbindungen, die im Redis-Verbindungspool zulässig sind. | int | 128 | 
| minIdle | Nein | Die Mindestanzahl inaktiver Verbindungen, die im Redis-Verbindungspool aufrechterhalten werden sollen. | int | 16 | 
| testOnBorrow  | Nein | Ein boolescher Wert, der angibt, ob Verbindungen validiert werden sollen, bevor sie aus dem Pool ausgeliehen werden. | boolesch | true | 
| testOnReturn  | Nein | Ein boolescher Wert, der angibt, ob Verbindungen validiert werden sollen, bevor sie an den Pool zurückgegeben werden.  | boolesch | true | 
| testWhileIdle  | Nein | Ein boolescher Wert, der angibt, ob inaktive Verbindungen im Pool regelmäßig überprüft werden sollen. | boolesch | true | 
| testOnCreate  | Nein | Ein boolescher Wert, der angibt, ob Verbindungen bei ihrer Erstellung validiert werden sollen. | boolesch | true | 
| minEvictableIdleTimeMillis  | Nein | Die Mindestdauer (in Millisekunden), die eine inaktive Verbindung im Pool verbleiben muss, bevor sie entfernt werden kann. | long | 60000 L  | 
| timeBetweenEvictionRunsMillis  | Nein | Die Zeit (in Millisekunden) zwischen aufeinanderfolgenden Läufen des Verbindungs-Evictor-Threads im Leerlauf. | long | 30000L | 
| numTestsPerEvictionRun  | Nein | Die maximale Anzahl von Verbindungen, die bei jeder Ausführung des Verbindungs-Evictor-Threads im Leerlauf getestet werden sollen. | int | -1 | 
| blockWhenExhausted  | Nein | Ein boolescher Wert, der angibt, ob eine Verbindung blockiert und darauf gewartet werden soll, dass eine Verbindung verfügbar wird, wenn der Pool erschöpft ist. | boolesch | true | 
| nettyThreads  | Nein | Die Anzahl der Netty-Threads, die für die Verarbeitung von Redis-Verbindungen verwendet werden sollen. | int | 32 | 
| subscriptionsPerConnection  | Nein | Die maximale Anzahl von Abonnements, die pro Redis-Verbindung zulässig sind. | int | 10 | 
| subscriptionConnectionPoolSize  | Nein | Die maximale Anzahl von Verbindungen, die im Redis-Abonnement-Verbindungspool zulässig sind.  | int | 100 | 
| pageSizeInBytes  | Nein | Die Standard-Seitengröße in Byte für Redis-Operationen. | long | 262144000  | 
| readTimeout | Nein | Das Lese-Timeout in Millisekunden für Redis-Operationen. | long | 2000 | 
| timeToLiveMillis | Nein | Die Dauer (in Millisekunden), für die ein Cache-Eintrag im Cache verbleibt, bevor er als abgelaufen betrachtet und entfernt wird. Wenn diese Eigenschaft nicht angegeben ist, laufen Cache-Einträge standardmäßig nicht automatisch ab. | long | -1 | 
| useAsyncBatch | Nein | Ermöglicht die asynchrone Ausführung von Redis-Massenschreibvorgängen, um die Leistung zu verbessern. Wenn auf False gesetzt, wird auf den synchronen Ausführungsmodus zurückgegriffen. | boolesch | true | 
| useBatchInMemoryAtomic | Nein | Aktiviert In-memory-atomic den Modus für Redis-Batch-Lesevorgänge. Wenn auf False gesetzt, wird auf den standardmäßigen In-Memory-Batchmodus zurückgegriffen. | boolesch | false | 
| connectionPoolSize | Nein | Die Größe des Verbindungspools, der für Redisson-Client-Verbindungen zum Redis-Server verwendet wird. | int | 64 | 
| connectionMinimumIdleSize | Nein | Die Mindestanzahl inaktiver Verbindungen, die Redisson in seinem Verbindungspool unterhält. | int | 24 | 
| idleConnectionTimeout | Nein | Das Timeout in Millisekunden, nach dem eine inaktive Verbindung im Pool geschlossen wird. | int | 10000 | 
| connectTimeout | Nein | Das Timeout in Millisekunden für den Verbindungsaufbau zum Redis-Server. | int | 10000 | 

## Eigenschaften des Redis-Caches
<a name="ba-runtime-redis-caches-properties"></a>

### Redis-Cache Blusam
<a name="ba-runtime-redis-blusam-cache"></a>

```
bluesam:
   cache: redis
 # If the following redis properties are not specified gapwalk.redis configuration will be used for this cache 
   redis:
     hostName: localhost
     port: 6379
     mode: standalone                        # Optional
     username:                               # Optional
     password: ""                            # Optional
     useSsl: false                           # Optional
     database: 0                             # Optional
     maxTotal: 128                           # Optional
     maxIdle: 128                            # Optional
     minIdle: 16                             # Optional
     testOnBorrow: true                      # Optional
     testOnReturn: true                      # Optional
     testWhileIdle: true                     # Optional
     testOnCreate: true                      # Optional
     minEvictableIdleTimeMillis: 60000       # Optional
     timeBetweenEvictionRunsMillis: 30000    # Optional
     numTestsPerEvictionRun: -1              # Optional
     blockWhenExhausted: true                # Optional
     nettyThreads: 32                        # Optional
     subscriptionsPerConnection: 10          # Optional
     subscriptionConnectionPoolSize: 100     # Optional
     pageSizeInBytes: 8192                   # Optional
     readTimeout: 2000                       # Optional
     timeToLiveMillis: 60000                 # Optional
     connectionPoolSize: 64                  # Optional
     connectionMinimumIdleSize: 24           # Optional
     idleConnectionTimeout: 10000            # Optional
     connectTimeout: 10000                   # Optional
```

### Redis-Cache Blusam
<a name="ba-runtime-redis-blusame-locks"></a>

```
bluesam:
   locks:
     cache: redis
 # If the following redis properties are not specified gapwalk.redis configuration will be used for this cache 
       hostName: localhost
       port: 6379
       mode: standalone                        # Optional
       username:                               # Optional
       password: ""                            # Optional
       useSsl: false                           # Optional
       database: 0                             # Optional
       maxTotal: 128                           # Optional
       maxIdle: 128                            # Optional
       minIdle: 16                             # Optional
       testOnBorrow: true                      # Optional
       testOnReturn: true                      # Optional
       testWhileIdle: true                     # Optional
       testOnCreate: true                      # Optional
       minEvictableIdleTimeMillis: 60000       # Optional
       timeBetweenEvictionRunsMillis: 30000    # Optional
       numTestsPerEvictionRun: -1              # Optional
       blockWhenExhausted: true                # Optional
       nettyThreads: 32                        # Optional
       subscriptionsPerConnection: 10          # Optional
       subscriptionConnectionPoolSize: 100     # Optional
       pageSizeInBytes: 8192                   # Optional
       readTimeout: 2000                       # Optional
```

### Sitzungs-Cache
<a name="ba-runtime-redis-session-cache"></a>

```
 spring:
   session:
     store-type: redis
 # If the following redis properties are not specified gapwalk.redis configuration will be used for this cache 
 jics:
   redis:
     hostName: localhost
     port: 6379
     mode: standalone                        # Optional
     username:                               # Optional
     password: ""                            # Optional
     useSsl: false                           # Optional
     database: 0                             # Optional
     maxTotal: 128                           # Optional
     maxIdle: 128                            # Optional
     minIdle: 16                             # Optional
     testOnBorrow: true                      # Optional
     testOnReturn: true                      # Optional
     testWhileIdle: true                     # Optional
     testOnCreate: true                      # Optional
     minEvictableIdleTimeMillis: 60000       # Optional
     timeBetweenEvictionRunsMillis: 30000    # Optional
     numTestsPerEvictionRun: -1              # Optional
     blockWhenExhausted: true                # Optional
     nettyThreads: 32                        # Optional
     subscriptionsPerConnection: 10          # Optional
     subscriptionConnectionPoolSize: 100     # Optional
     pageSizeInBytes: 8192                   # Optional
     readTimeout: 2000                       # Optional
```

### Definitionen von JICS-Ressourcen
<a name="ba-runtime-redis-jics-cache"></a>

```
jics:
   resource-definitions:
     store-type: redis
 # If the following redis properties are not specified gapwalk.redis configuration will be used for this cache 
   redis:
     hostName: localhost
     port: 6379
     mode: standalone                        # Optional
     username:                               # Optional
     password: ""                            # Optional
     useSsl: false                           # Optional
     database: 0                             # Optional
     maxTotal: 128                           # Optional
     maxIdle: 128                            # Optional
     minIdle: 16                             # Optional
     testOnBorrow: true                      # Optional
     testOnReturn: true                      # Optional
     testWhileIdle: true                     # Optional
     testOnCreate: true                      # Optional
     minEvictableIdleTimeMillis: 60000       # Optional
     timeBetweenEvictionRunsMillis: 30000    # Optional
     numTestsPerEvictionRun: -1              # Optional
     blockWhenExhausted: true                # Optional
     nettyThreads: 32                        # Optional
     subscriptionsPerConnection: 10          # Optional
     subscriptionConnectionPoolSize: 100     # Optional
     pageSizeInBytes: 8192                   # Optional
     readTimeout: 2000                       # Optional
```

### JICS TS-Warteschlangen
<a name="ba-runtime-jics-ts-queues"></a>

```
jics:
   parameters:
     tsqimpl: redis
 # If the following redis properties are not specified gapwalk.redis configuration will be used for this cache 
   queues:
     ts:
       redis:
         hostName: localhost
         port: 6379
         mode: standalone                        # Optional
         username:                               # Optional
         password: ""                            # Optional
         useSsl: false                           # Optional
         database: 0                             # Optional
         maxTotal: 128                           # Optional
         maxIdle: 128                            # Optional
         minIdle: 16                             # Optional
         testOnBorrow: true                      # Optional
         testOnReturn: true                      # Optional
         testWhileIdle: true                     # Optional
         testOnCreate: true                      # Optional
         minEvictableIdleTimeMillis: 60000       # Optional
         timeBetweenEvictionRunsMillis: 30000    # Optional
         numTestsPerEvictionRun: -1              # Optional
         blockWhenExhausted: true                # Optional
         nettyThreads: 32                        # Optional
         subscriptionsPerConnection: 10          # Optional
         subscriptionConnectionPoolSize: 100     # Optional
         pageSizeInBytes: 8192                   # Optional
         readTimeout: 2000                       # Optional
```

### Sitzungsverfolgung
<a name="ba-runtime-session-tracker"></a>

```
session-tracker:
   store-type: redis
 # If the following redis properties are not specified gapwalk.redis configuration will be used for this cache 
   redis:
     hostName: localhost
     port: 6379
     mode: standalone                        # Optional
     username:                               # Optional
     password: ""                            # Optional
     useSsl: false                           # Optional
     database: 0                             # Optional
     maxTotal: 128                           # Optional
     maxIdle: 128                            # Optional
     minIdle: 16                             # Optional
     testOnBorrow: true                      # Optional
     testOnReturn: true                      # Optional
     testWhileIdle: true                     # Optional
     testOnCreate: true                      # Optional
     minEvictableIdleTimeMillis: 60000       # Optional
     timeBetweenEvictionRunsMillis: 30000    # Optional
     numTestsPerEvictionRun: -1              # Optional
     blockWhenExhausted: true                # Optional
     nettyThreads: 32                        # Optional
     subscriptionsPerConnection: 10          # Optional
     subscriptionConnectionPoolSize: 100     # Optional
     pageSizeInBytes: 8192                   # Optional
     readTimeout: 2000                       # Optional
```

### JCL-Checkpoint
<a name="ba-runtime-jcl-checkpoint"></a>

```
jcl:
   checkpoint:
     provider: redis
 # If the following redis properties are not specified gapwalk.redis configuration will be used for this cache 
   redis:
     hostname: localhost
     port: 6379
     mode: standalone                        # Optional
     username:                               # Optional
     password: ""                            # Optional
     useSsl: false                           # Optional
     database: 0                             # Optional
     maxTotal: 128                           # Optional
     maxIdle: 128                            # Optional
     minIdle: 16                             # Optional
     testOnBorrow: true                      # Optional
     testOnReturn: true                      # Optional
     testWhileIdle: true                     # Optional
     testOnCreate: true                      # Optional
     minEvictableIdleTimeMillis: 60000       # Optional
     timeBetweenEvictionRunsMillis: 30000    # Optional
   	 numTestsPerEvictionRun: -1              # Optional
     blockWhenExhausted: true                # Optional
     nettyThreads: 32                        # Optional
     subscriptionsPerConnection: 10          # Optional
     subscriptionConnectionPoolSize: 100     # Optional
     pageSizeInBytes: 8192                   # Optional
     readTimeout: 2000                       # Optional
```

### Sperren von Gapwalk-Dateien
<a name="ba-runtime-gapwalk-file-locks"></a>

```
filesLocks:
   enabled: true
   retryTime: 1000
   MaxRetry: 5
   provider: redis
 # If the following redis properties are not specified gapwalk.redis configuration will be used for this cache 
   redis:
     hostName: localhost
     port: 6379
     mode: standalone                          # Optional
     username:                                 # Optional
     password: ""                              # Optional
     useSsl: false                             # Optional
     database: 0                               # Optional
     pool:
       maxTotal: 128                           # Optional
       maxIdle: 128                            # Optional
       minIdle: 16                             # Optional
       testOnBorrow: true                      # Optional
       testOnReturn: true                      # Optional
       testWhileIdle: true                     # Optional
       testOnCreate: true                      # Optional
       minEvictableIdleTimeMillis: 60000       # Optional
       timeBetweenEvictionRunsMillis: 30000    # Optional
       numTestsPerEvictionRun: -1              # Optional
       blockWhenExhausted: true                # Optional
       nettyThreads: 32                        # Optional
       subscriptionsPerConnection: 10          # Optional
       subscriptionConnectionPoolSize: 100     # Optional
       pageSizeInBytes: 8192                   # Optional
       readTimeout: 2000                       # Optional
```

### Blu4IV-Schlösser
<a name="ba-runtime-blu4iv-locks"></a>

```
 blu4iv.lock: redis
 blu4iv.lock.timeout: 10 #(in millisecondes)
 	# If the following redis properties are not specified gapwalk.redis configuration will be used for this cache 
 blu4iv.lock.redis:
       hostName: localhost
       port: 6379
       mode: standalone                        # Optional
       username:                               # Optional
       password: ""                            # Optional
       useSsl: false                           # Optional
       database: 0                             # Optional
       maxTotal: 128                           # Optional
       maxIdle: 128                            # Optional
       minIdle: 16                             # Optional
       testOnBorrow: true                      # Optional
       testOnReturn: true                      # Optional
       testWhileIdle: true                     # Optional
       testOnCreate: true                      # Optional
       minEvictableIdleTimeMillis: 60000       # Optional
       timeBetweenEvictionRunsMillis: 30000    # Optional
       numTestsPerEvictionRun: -1              # Optional
       blockWhenExhausted: true                # Optional
       nettyThreads: 32                        # Optional
       subscriptionsPerConnection: 10          # Optional
       subscriptionConnectionPoolSize: 100     # Optional
       pageSizeInBytes: 8192                   # Optional
       readTimeout: 2000                       # Optional
```

### Datensatz-Katalog
<a name="ba-runtime-dataset-catalog"></a>

```
datasimplifier:   
   catalogImplementation: redis
   # If the following redis properties are not specified gapwalk.redis configuration will be used for this cache    
   redis:
     hostName: localhost
     port: 6379
     mode: standalone                        # Optional
     username:                               # Optional
     password: ""                            # Optional
     useSsl: false                           # Optional
     database: 0                             # Optional
     maxTotal: 128                           # Optional
     maxIdle: 128                            # Optional
     minIdle: 16                             # Optional
     testOnBorrow: true                      # Optional
     testOnReturn: true                      # Optional
     testWhileIdle: true                     # Optional
     testOnCreate: true                      # Optional
     minEvictableIdleTimeMillis: 60000       # Optional
     timeBetweenEvictionRunsMillis: 30000    # Optional
     numTestsPerEvictionRun: -1              # Optional
     blockWhenExhausted: true                # Optional
     nettyThreads: 32                        # Optional
     subscriptionsPerConnection: 10          # Optional
     subscriptionConnectionPoolSize: 100     # Optional
     pageSizeInBytes: 8192                   # Optional
     readTimeout: 2000                       # Optional
```

## Geheimer Manager für Redis-Caches
<a name="ba-runtime-redis-secrets-properties"></a>

Die `application-main.yaml` Datei kann auf den geheimen ARN für Redis-Caches verweisen. Informationen zur Integration AWS Secrets Manager zum sicheren Abrufen von Redis-Verbindungsdetails zur Laufzeit finden Sie unter. [AWS Transformation für Mainframe-Runtime-Geheimnisse](ba-runtime-config-app-secrets.md)