AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) は、新規のお客様に公開されなくなりました。 AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) と同様の機能については、 AWS Mainframe Modernization Service (セルフマネージドエクスペリエンス) をご覧ください。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、[AWS 「 Mainframe Modernization の可用性の変更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS Transform for mainframe Runtime で使用可能な Redis キャッシュプロパティ
<a name="ba-runtime-redis-configuration"></a>

このドキュメントを使用して、メインフレームランタイムの AWS 変換の Redis キャッシュと、Gapwalk 設定、サポートされている Redis プロパティ、および`application-main.yml`ファイルが Redis キャッシュのシークレット ARN を参照する方法について説明します。

## Transform for mainframe Runtime の Redis AWS キャッシュ
<a name="ba-redis-caches-in-runtime"></a>

Redis サーバーは、メインフレーム Gapwalk アプリケーションの AWS 変換で、次のようなさまざまな機能のキャッシュとして使用できます。


****  

| AWS Redis キャッシュを使用するメインフレームランタイム機能の変換 | 説明 | 
| --- | --- | 
| Blusam キャッシュ | 書き込みビハインド戦略を使用してレコードを効率的に読み取り、バッチペイロードで発生する書き込み負荷の高いワークロードを最適化するための Redis Blusamキャッシュ。 | 
| Blusam ロック | データセットとレコードの分散型ロックのためのキャッシュ。 | 
| データセットカタログ | カタログデータセットのキャッシュ。 | 
| セッションキャッシュ | HttpSession の Redis キャッシュ。キャッシュには、ユーザー名、Angular フロントエンドによるダイアログの状態、および特定の "ダイアレクト" (BMS、MFS、AS400) の情報が保存されます。 | 
| セッショントラッカー | アクティブなセッションのキャッシュ。セッションのユーザー名と作成時刻の情報が保存されます。 | 
| JICS キャッシュ | JICS リソース定義のキャッシュ。 | 
| TS キュー | TS キューのストレージ。 | 
| JCL チェックポイント |  JCL チェックポイントキャッシュ。 | 
| Gapwalk ファイルロック | ジョブによる分散型ファイルロックのキャッシュ。 | 
| Blu4iv ロック | Blu4iv レコードロックのストレージ。 | 

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

グローバル Redis 設定は、キャッシュメカニズムに `redis` が指定され、かつ Redis 設定が特定の機能に指定されていない場合に使用されます。この設定により、複数の Redis キャッシュで同じ設定を同時に使用できます。

次の例では、Blusamデータセットキャッシュと JICS キャッシュは `gapwalk.redis` (`redis.server1`) 設定を使用します。これは、キャッシュタイプが に設定され`redis`、暗黙的な Redis プロパティが [JICS リソース定義](#ba-runtime-redis-jics-cache)および で指定されていないためです[JICS リソース定義](#ba-runtime-redis-jics-cache)。ただし、Blusamロックキャッシュは Redis プロパティが明示的に定義されているため、別の Redis 設定 (`redis.server2`) を使用します。

```
...
 
 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
 ...
```

 グローバル Redis 設定を有効にするには、`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
```

## サポートされる Redis プロパティ
<a name="ba-runtime-redis-supported-properties"></a>

次の表は、メインフレームランタイムの AWS 変換でグローバルおよび特定の Redis キャッシュでサポートされている Redis プロパティを示しています。


****  

| プロパティ名 | 必須? | 説明 | 値 | デフォルト | 
| --- | --- | --- | --- | --- | 
| mode | いいえ | Redis の実行モード。 | standalone \$1 cluster | standalone | 
| hostname | はい | Redis サーバーのホスト名または IP アドレス。 | string | null | 
| port | はい | Redis サーバーが接続をリッスするポート番号。 | int | null | 
| username | いいえ | 認証のユーザー名。 | string | null | 
| password | いいえ | 認証に使用するパスワード。 | string | 空の文字列 | 
| useSsl  | いいえ | Redis 接続で SSL/TLS 暗号化を有効にするかどうかを指定します。 | boolean | false | 
| database | いいえ | 使用する Redis データベース番号。Redis は複数の論理データベースをサポートしているため、どれを使用するかをこのプロパティで指定します。 | int | 0 | 
| maxTotal | いいえ | Redis 接続プールで許可される接続の最大数。 | int  | 128 | 
| maxIdle | いいえ | Redis 接続プールで許可されるアイドル接続の最大数。 | int | 128 | 
| minIdle | いいえ | Redis 接続プールで保持するアイドル接続の最小数。 | int | 16 | 
| testOnBorrow  | いいえ | プールから接続を借りる前に接続を検証するかどうかを示すブール値。 | boolean | true | 
| testOnReturn  | いいえ | プールに接続を返す前に接続を検証するかどうかを示すブール値。 | boolean | true | 
| testWhileIdle  | いいえ | プール内のアイドル接続を定期的に検証するかどうかを示すブール値。 | boolean | true | 
| testOnCreate  | いいえ | 作成時に接続を検証するかどうかを示すブール値。 | boolean | true | 
| minEvictableIdleTimeMillis  | いいえ | アイドル状態の接続が排除されるまでのプールに保持される時間 (ミリ秒単位) の最小値。 | long | 60000L  | 
| timeBetweenEvictionRunsMillis  | いいえ | アイドル状態の接続を排除するスレッドを定期的に実行する時間間隔 (ミリ秒単位)。 | long | 30000L | 
| numTestsPerEvictionRun  | いいえ | アイドル状態の接続を排除するスレッドの実行時にテストする接続の最大数。 | int | -1 | 
| blockWhenExhausted  | いいえ | プールの接続が枯渇した場合に、接続が使用可能になるまでブロックして待機するかどうかを示すブール値。 | boolean | true | 
| nettyThreads  | いいえ | Redis 接続の処理に使用する Netty スレッドの数。 | int | 32 | 
| subscriptionsPerConnection  | いいえ | Redis 接続ごとに許可されるサブスクリプションの最大数。 | int | 10 | 
| subscriptionConnectionPoolSize  | いいえ | Redis サブスクリプションの接続プールで許可される接続の最大数。 | int | 100 | 
| pageSizeInBytes  | いいえ | Redis 操作のデフォルトのページサイズ (バイト単位)。 | long | 262144000  | 
| readTimeout | いいえ | Redis 操作の読み取りタイムアウト (ミリ秒単位)。 | long | 2000 | 
| timeToLiveMillis | いいえ | キャッシュエントリがキャッシュに残り、有効期限が切れて削除されたと見なされるまでの時間 (ミリ秒単位）。このプロパティを指定しない場合、キャッシュエントリはデフォルトで自動的に期限切れになりません。 | long | -1 | 
| useAsyncBatch | いいえ | Redis 一括書き込みオペレーションの非同期実行を有効にして、パフォーマンスを向上させます。false に設定すると、 は同期実行モードに戻ります。 | boolean | true | 
| useBatchInMemoryAtomic | いいえ | Redis バッチ読み取りオペレーションのIn-memory-atomicモードを有効にします。false に設定すると、 はデフォルトのインメモリバッチモードに戻ります。 | ブール値 | false | 
| connectionPoolSize | いいえ | Redis サーバーへの Redisson クライアント接続に使用される接続プールのサイズ。 | int | 64 | 
| connectionMinimumIdleSize | いいえ | Redisson が接続プールに維持するアイドル状態の接続の最小数。 | int | 24 | 
| idleConnectionTimeout | いいえ | プール内のアイドル接続が閉じられるまでのミリ秒単位のタイムアウト。 | int | 10000 | 
| connectTimeout | いいえ | Redis サーバーへの接続を確立するためのミリ秒単位のタイムアウト。 | int | 10000 | 

## Redis キャッシュプロパティ
<a name="ba-runtime-redis-caches-properties"></a>

### Redis 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 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
```

### セッションキャッシュ
<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
```

### JICS リソース定義
<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 キュー
<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
```

### セッショントラッカー
<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 チェックポイント
<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
```

### Gapwalk ファイルロック
<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 ロック
<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
```

### データセットカタログ
<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
```

## Redis キャッシュのシークレットマネージャー
<a name="ba-runtime-redis-secrets-properties"></a>

`application-main.yaml` ファイルは、Redis キャッシュのシークレット ARN を参照できます。統合して実行時に Redis 接続の詳細 AWS Secrets Manager を安全に取得する方法については、「」を参照してください[AWS メインフレームランタイムシークレットの変換](ba-runtime-config-app-secrets.md)。