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 変換のプロパティを有効にする Spring Boot アプリケーションでは、リスニングポートやデータベース接続など、さまざまな種類のプロパティを `application-main.yml` の設定ファイルに定義します。このページでは、メインフレームランタイムの AWS 変換で使用可能なプロパティとその有効化方法について説明します。 **Topics** + [YML 表記](#ba-runtime-key-value-yml) + [クイックスタート/ユースケース](#ba-runtime-key-value-use-cases) + [メインのアプリケーションで使用可能なプロパティ](#ba-runtime-key-value-main) + [オプションのウェブアプリケーションで使用可能なプロパティ](#ba-runtime-key-value-web) + [クライアントアプリケーションで使用可能なプロパティ](#ba-runtime-key-value-client) + [API アクセスのログ記録を設定する](#ba-runtime-api-access-logging) ## YML 表記 以下のドキュメントでは、`parent.child1.child2=true` のようなプロパティは YAML 形式で次のように記述されています。 ``` parent: child1: child2: true ``` ## クイックスタート/ユースケース 以下のユースケースは、適用可能なキーと値の例を示しています。 + デフォルトの application-main.yml ``` ---- #### DEFAULT APPLICATION-MAIN.YML FILE ##### #### SHOWING USEFUL CONFIGURATION ELEMENTS ##### #### SHOULD BE OVERRIDDEN AND EXTERNALIZED ##### ################################# ##### Logging configuration ##### ################################# logging: config: classpath:logback-main.xml level.org.springframework.beans.factory.support.DefaultListableBeanFactory : WARN ################################ ##### Spring configuration ##### ################################ spring: quartz: auto-startup: false scheduler-name: Default properties: org.quartz.threadPool.threadCount: 1 jta: enabled: false atomikos.properties.maxTimeout : 600000 atomikos.properties.default-jta-timeout : 100000 jpa: # DISABLE OpenEntityManagerInViewInterceptor open-in-view: false # Fix Postgres JPA Error: # Method org.postgresql.jdbc.PgConnection.createClob() is not yet implemented. properties.hibernate.temp.use_jdbc_metadata_defaults : false ##################################### ##### Jics tables configuration ##### ##################################### # The dialect should match the jics datasource choice database-platform : org.hibernate.dialect.PostgreSQLDialect # org.hibernate.dialect.PostgreSQLDialect, org.hibernate.dialect.SQLServerDialect # those properties can be used to create and initialize jics tables automatically. # properties: # hibernate: # globally_quoted_identifiers: true # hbm2ddl: # import_files_sql_extractor : org.hibernate.tool.hbm2ddl.MultipleLinesSqlCommandExtractor # import_files : file:./setup/initJics.sql # auto : create ########################## ###### Level 2 cache ##### ########################## # cache: # use_second_level_cache: true # use_query_cache: true # region: # factory_class: org.hibernate.cache.ehcache.EhCacheRegionFactory # javax: # persistence: # sharedCache: # mode: ENABLE_SELECTIVE ########################## ###### Redis settings ##### ########################## session: store-type: none #redis # Secret manager configuration for global Redis cache aws: client: gapwalk: redis: secret: arn:aws:secretsmanager:XXXX ######################################### ##### JICS datasource configuration ##### ######################################### datasource: jicsDs: driver-class-name : org.postgresql.Driver # org.postgresql.Driver, com.microsoft.sqlserver.jdbc.SQLServerDriver url: jdbc:postgresql://localhost/jics # jdbc:postgresql://localhost:5433/jics, jdbc:sqlserver://localhost\SQLEXPRESS:1434;databasename=jics; username: jics password: jics type : org.postgresql.ds.PGSimpleDataSource # org.postgresql.ds.PGSimpleDataSource, com.microsoft.sqlserver.jdbc.SQLServerDataSource ##################################################### ##### Embedded Bluesam datasource configuration ##### ##################################################### bluesamDs : driver-class-name : org.postgresql.Driver url : jdbc:postgresql://localhost/bluesam username : bluesam password : bluesam type : org.postgresql.ds.PGSimpleDataSource ########################################## ##### Embedded Bluesam configuration ##### ########################################## bluesam : cache : ehcache persistence : pgsql ehcache: resource-pool: size: 4GB write-behind: enabled: true pgsql : dataSource : bluesamDs ######################### ##### Jics settings ##### ######################### rabbitmq.host: localhost jics: cache: false #redis resource-definitions.store-type: jpa # default value: jpa, other possible value: redis jics.disableSyncpoint : false #jics.initList: #jics.parameters.datform: DDMMYY #jics.parameters.applid: VELOCITY #jics.parameters.sysid: CICS #jics.parameters.eibtrmid: TERM #jics.parameters.userid: MYUSERID #jics.parameters.username: MYUSERNAME #jics.parameters.opid: XXX #jics.parameters.cwa.length: 0 #jics.parameters.netname: MYNETNAME #jics.parameters.jobname: MJOBNAME #jics.parameters.sysname: SYSNAME ############################################## ##### Jics RunUnitLauncher pool settings ##### ############################################## #jics.runUnitLauncherPool.enable: false #jics.runUnitLauncherPool.size: 20 #jics.runUnitLauncherPool.validationInterval: 1000 ######################### ##### Jhdb settings ##### ######################### #jhdb.lterm: LTERMVAL #jhdb.identificationCardData: SomeIDData ################################### ##### DateHelper configuration #### ################################### #forcedDate: "2013-08-26T12:59:58+01:57" ############################# ##### Sort configuration #### ############################# #externalSort.threshold: 256MB ################################### ##### Server timeout (10 min) #### ################################### spring.mvc.async.request-timeout: 600000 ############################### ##### DATABASE STATISTICS #### ############################### databaseStatistics : false ###################### ##### CALLS GRAPH #### ###################### callGraph : false #################################### ##### SSL configuration ##### #################################### gapwalk.ssl.enabled : true gapwalk.ssl.trustStore : "./config/clientkey.jks" gapwalk.ssl.trustStorePassword : mysslcertifpassword ################################## ##### MQ settings ##### ################################## mq.queues: jmsmq mq.queues.jmsMQQueueManagers[0].jmsMQQueueManager: QM1 mq.queues.jmsMQQueueManagers[0].jmsMQAppName: Gapwalk mq.queues.jmsMQQueueManagers[0].jmsMQChannel: DEV.APP.SVRCONN mq.queues.jmsMQQueueManagers[0].jmsMQHost: localhost mq.queues.jmsMQQueueManagers[0].jmsMQPort: 1415 mq.queues.jmsMQQueueManagers[0].jmsMQUserid: app mq.queues.jmsMQQueueManagers[0].jmsMQSSLCipher: "*TLS12ORHIGHER" mq.queues.jmsMQQueueManagers[1].jmsMQQueueManager: QM2 mq.queues.jmsMQQueueManagers[1].jmsMQAppName: Gapwalk mq.queues.jmsMQQueueManagers[1].jmsMQChannel: DEV.APP.SVRCONN mq.queues.jmsMQQueueManagers[1].jmsMQHost: localhost mq.queues.jmsMQQueueManagers[1].jmsMQPort: 1415 mq.queues.jmsMQQueueManagers[1].jmsMQUserid: app ######################################################### ##### Configuration properties for JMS MQ connection #### ######################################################### mq.queues.jms.connectionfactory.borrow-connection-timeout: 31 # Timeout, in seconds, for borrowing connections from the pool. mq.queues.jms.connectionfactory.ignore-session-transacted-flag: true # Whether or not to ignore the transacted flag when creating a session. mq.queues.jms.connectionfactory.local-transaction-mode: false # Whether or not to include local transactions. mq.queues.jms.connectionfactory.maintenance-interval: 62 # The time, in seconds, between runs of the pool's maintenance thread. mq.queues.jms.connectionfactory.max-idle-time: 63 # The time, in seconds, after which connections are cleaned up from the pool. mq.queues.jms.connectionfactory.max-lifetime: 0 # The time, in seconds, that a connection can be pooled for before being destroyed. 0 denotes no limit. mq.queues.jms.connectionfactory.max-pool-size: 1 # The maximum size of the pool. This property will be overwritten by mq.queues.jmsMQQueueManagers[N].jmsMQMaxPoolSize property (if provided). mq.queues.jms.connectionfactory.min-pool-size: 1 # The minimum size of the pool. mq.queues.jms.connectionfactory.reap-timeout: 0 # The reap timeout, in seconds, for borrowed connections. 0 denotes no limit. ############################### ##### SQL SHIFT CODE POINT #### ############################### # Code point 384 match unicode character \u0180 sqlCodePointShift : 384 ############################### ##### LOCK TIMEOUT RECORD #### ############################### # Blu4IV record lock timeout lockTimeout : 100 ############################## ##### REPORTS OUTPUT PATH #### ############################## reportOutputPath: reports ############################## ##### TASK EXECUTOR #### ############################## taskExecutor: corePoolSize: 5 maxPoolSize: 10 queueCapacity: 50 allowCoreThreadTimeOut: false ############################## ##### PROGRAM NOT FOUND #### ############################## stopExecutionWhenProgNotFound: false ###################################################### ##### DISP DEFAULT VALUE (to be removed one day) #### ###################################################### defaultKeepExistingFiles: true ###################################################### ##### BLOCKSIZE DEFAULT VALUE #### ###################################################### #blockSizeDefault: 32760 ##################################### ##### JOBQUEUE CONFIGURATION #### ##################################### jobqueue: api.enabled: false impl: none # possible values: quartz, none schedulers: # list of schedulers - name: queue1 threadCount: 5 - name: queue2 threadCount: 5 ################################################################################ ##### QUERY BUILDING ## # useConcatCondition : false by default # if true, in the query, the where condition is build with key concatenation ## ################################################################################ # query.useConcatCondition: true ######################################## ##### JCL Batch Restart Mechanism #### ######################################## jcl: checkpoint: enabled: false #expireTimeout: -1 #expireTimeoutUnit: SECONDS # Supported values: java.util.concurrent.TimeUnit #provider: redis ############################## ##### System parameters #### ############################## system.date.format:MDY system.date.separator: "/" ############################################################# ##### Database metadata schema inclusion configuration #### ############################################################# gapwalk: database: metadata: schema-inclusion: enabled: false schemas: global: - "SCHEMA1" - "SCHEMA2" ############################## ##### URL configuration #### ############################## gapwalk.post.script.mediatype.json: false ######################################## ##### CBLQDA parameters #### ######################################## gapwalk.cobol.cblqda.enabled: false ---- ``` + LISTCAT コマンドで可変長ファイルを使用する ``` [**/*.*] encoding=IBM930 reencoding=false [global] listcat.variablelengthpreprocessor.enabled=true listcat.variablelengthpreprocessor.type=rdw # use "rdw" if your .listcat file contains a set of records (RDW) # use "bdw" if your .listcat file contains a set of blocks (bdw) ``` + LOAD/UNLOAD ユーティリティで Null バイトインジケータ値を指定します。 ``` # Unload properties # For date/time: if use database configuration is enabled, formats are ignored # For nbi; use hexadecimal syntax to specify the byte value # - When the value is null in database : the value dumped to the file is filled by low value characters and the NBI is # equal to the byte 6F (the ? character) # - When the value is not null in database and the column is nullable: the NBI is equal to the byte 00 (low value) and NOT # equal to the byte 40 (space) unload: sqlCodePointShift: 0 nbi: whenNull: "6F" whenNotNull: "00" useDatabaseConfiguration: false format: date: MM/dd/yyyy time: HH.mm.ss timestamp: yyyy-MM-dd-HH.mm.ss.SSSSSS ``` ## メインのアプリケーションで使用可能なプロパティ この表は、キー/バリューのパラメータを網羅的にまとめたものです。 **注記** バージョン 5.1.0 以降に移行し、デフォルトの openWarmUp 動作で bluesam を使用する場合: のデフォルト値`bluesam.openWarmUp`が から `true`に変更されました `false` 既存の動作を維持するには、明示的に を設定する必要があります。 `bluesam.openWarmUp=true` | キー | タイプ | デフォルトの値 | 説明 | リリースバージョン | | --- | --- | --- | --- | --- | | `system.date.format` | string | MDY | システム日付形式 DATFMT。 | --- | | `system.date.separator` | string | / | システム日付区切り文字 DATSEP。
指定できる値は、スラッシュ (`/`)、ダッシュ (`–`)、ピリオド (`.`)、カンマ (`,`)、または空白 (``) です。値は二重引用符「"」で指定する必要があります。 | 5.17.0 | | `logging.config` | パス | クラスパス: logback-main.xml | logback 設定ファイルへの参照用の標準キー。他の標準ログ記録キーも使用できます。 | | | `spring.jta.enabled` | ブール値 | false | 標準キー。データソースサポートモードが static-xa でない場合は、spring JTA トランザクションの自動設定を無効にする必要があります。 | | | `datasource.jicsDs` \+ -`driver-class-name` \+ -`url` \+ -`username` \+ -`password` \+ -`type` | サブキー付きの標準 spring データソース | | Jics データベースの接続情報が含まれています。または、「[JICS データベース](ba-runtime-config-app-secrets.md#jics-database)」で説明されているように、 AWS シークレットの使用を強くお勧めします。 | | | `jildb.datasource` \+ -`driver-class-name` \+ -`url` \+ -`username` \+ -`password` | サブキー付きの標準 spring データソース | | Jics データベースの接続情報が含まれています。 | | | `jildb.backend` | string | | Oracle など、Jildb バックエンドで使用されるデータベースタイプを指定します。 | | | `jildb.record-hold-timeout` | int | 10000 | Jildb のレコード保持メカニズムの待機タイムアウト期間をミリ秒単位で指定します。 | | | `datasource.bluesamDs` \+ -`driver-class-name` \+ -`url` \+ -`username` \+ -`password` \+ -`type` | サブキー付きの標準 spring データソース | | Blusam データベースの接続情報が含まれます。または、「[データベースの Blusam](ba-runtime-config-app-secrets.md#blusam-database)」で説明されているように、 AWS シークレットの使用を強くお勧めします。 | | | `blu4iv.userspace.pageSize` | int | 4096 | ユーザースペースにストレージを割り当てるために使用されるページサイズを指定します。任意の時点でのユーザースペースのサイズは、常にこの数の倍数です。 | 4.10.0 | | `blu4iv.userspace.store-type` | string | メモリ | ユーザースペースレジストリに使用されるストアタイプを指定します。サポートされている値はメモリと redis です。ストアタイプが指定されていない場合、メモリはデフォルトで使用されます。 | 4.10.0 | | `blu4iv.userspace.redis.*` | サポートされる Redis プロパティ | | ユーザースペース redis ストアの設定プロパティを指定します。「」を参照してください[AWS Transform for mainframe Runtime で使用可能な Redis キャッシュプロパティ](ba-runtime-redis-configuration.md)。 | 4.10.0 | | `blu4iv.userspace.batchThreshold` | int | 1 | ユーザースペースの更新または設定オペレーションの数を指定します。その後、ユーザースペースは外部データリポジトリに保持されます。 | 5.75.0 | | `blu4iv.dataaccess.useOldDaoDesign` | ブール値 | false | アプリケーションが古い DAO アーキテクチャを使用するか新しいアーキテクチャを使用するかを決定するグローバルフラグ。これは、DAO が古い設計と新しい設計のどちらを使用して生成されたかによって異なります。 | | | `bluesam.disabled` | ブール値 | false | Blusam を完全に無効にするかどうか。 | | | `bluesam.cache` | string | | 設定されていない場合、Blusamキャッシュは使用されません。指定できる値 (キャッシュ実装) は、ehcache と redis () です[Redis キャッシュプロパティ](ba-runtime-redis-configuration.md#ba-runtime-redis-caches-properties)。 | | | `bluesam.openWarmUp` | ブール値 | false | オープン中に Bluesam データセットをキャッシュするかどうかを指定します。
**警告: バージョン 5.1.0 の大幅な変更**
**- デフォルト値`true`が から に変更されました`false`。** | 5.1.0 | | `bluesam.fileList` | String[] | | オープン中にキャッシュする Bluesam データセットのリストを指定します。
**メモ:**
**- このパラメータは、 `bluesam.openWarmUp` が に設定されている場合にのみ有効です`false`。** | 5.1.0 | | `bluesam.maxBluesamDisablingThreadpoolSize` | 数値 | 10 | バッチ処理のために Bluesam データセットを無効にするために使用される最大スレッドプールサイズを指定します。 | 4.5.0 | | `bluesam.bluesamStatusPollingInterval` | 数値 | 1,000 | Bluesam ステータスをポーリングしてオンラインアクティビティをチェックするときに、各反復の間に待機する時間 (ミリ秒単位) を指定します。 | 4.5.0 | | `bluesam.maxBluesamStatusPollingRetry` | 数値 | 3 | Bluesam ステータスのポーリングが失敗した場合の最大再試行回数を指定します。 | 4.5.0 | | `bluesam.checkBluesamStatus` | ブール値 | false | アクセスする前に bluesam データセットのステータスを確認するかどうかを指定します。 | 4.5.0 | | `bluesam.prefetchWindowSize` | int | 1,000 | Redis キャッシュ最適化のためにプリフェッチしてメモリにキャッシュするレコードの数を指定します。このプロパティは、Redis キャッシュを使用する場合にのみ有効です。 | | | `bluesam.prefetchWindowMultiples` | int | 5 | プリフェッチウィンドウの最大容量を決定するプリフェッチウィンドウサイズの乗数を指定します。最大容量は として計算されます`prefetchWindowSize × prefetchWindowMultiples`。このプロパティは、Redis キャッシュを使用する場合にのみ有効です。 | | | `bluesam.sizesCleanUpThreshold` | int | 1,000 | 同時マルチスレッド書き込み中の大規模データセット (LargeKSDS、LargeESDS) のデータセットあたりの内部オフセット追跡マップに保持されるエントリの最大数。マップがこのしきい値を超えると、NullPointerException の同時スレッドアクセスを回避するために十分なエントリを保持しながら、ヒープの枯渇を防ぐために、最新の 10 個のエントリに切り捨てられます。大量の大規模なデータセットの一括ロード中にヒーププレッシャーが観察された場合は、この値を減らします。 | | | `spring.aws.client.bluesam.redis.secret` | string | null | Bluesam Redis キャッシュの認証情報シークレット ARN を指定します。「[AWS メインフレームランタイムシークレットの変換](ba-runtime-config-app-secrets.md)」を参照してください。 | | | `spring.aws.client.bluesam.locks.redis.secret` | string | null | Bluesam が Redis キャッシュをロックするための認証情報シークレット ARN を指定します。「[AWS メインフレームランタイムシークレットの変換](ba-runtime-config-app-secrets.md)」を参照してください。 | | | `forcedDate` | string | | 指定された日付がある場合は、日付を強制的にその日付に合わせます。 | | | `clcommand.rtvmbrd.hasHeader` | string | true | 行をカウントするときに含めるべきではないヘッダーがファイルに含まれているかどうかを指定します。 | | | `frozenDate` | boolean | true | 日付を固定するかどうかを指定します。`forcedDate` も設定されている場合にのみ適用されます。 | | | `externalSort.threshold` | データサイズ (例: 12 メガバイト) | | ソートしきい値: ファイルシステムの一時ファイルを使用して、システムがインメモリから外部マージソートに切り替えるタイミングを決定します。指定しない場合 (デフォルト=`null`)、しきい値は新しいソートタスクごとに使用可能なメモリの半分に設定されます。使用可能なメモリを推定するために、System.gc() への呼び出しが実行されます。 | | | `blockSizeDefault` | 数値 | 32760 | BDW バイトに使用するデフォルトのブロックサイズ。 | | | `jics.parameters.datform` | string | MMDDYY | 日付形式。 | | | `jics.initList` | string | | カンマ区切りの、JICS 初期化リスト。存在する場合、Apache Tomcat の起動時に CICS リストの中でアクティブ化するリストの名前をカンマで区切って定義します。値の例: `$UUU,DFH$IVPL,PEZ1` これはそれらのリストに含まれるグループとその基礎となるリソース定義にカスケードされ、ランタイムに表示されます。デフォルトでは空です。 | | | `jics.parameters.applid` | string | VELOCITY | JICS でのアプリケーションの識別に適用されます (最低 4 文字、最大長なし)。 | | | `jics.parameters.sysid` | string | CICS | システム識別子 (SYSID)。 | | | `jics.parameters.eibtrmid` | string | TERM | ターミナル識別子 (最大 4 文字、最小 1 文字)。 | | | `jics.parameters.userid` | string | | ユーザー ID (最大 8 文字、最小文字数なし)。値が指定されていない場合 (デフォルトでは空白)、HTTP セッション ID がユーザー ID として使用されます。 | | | `jics.parameters.username` | string | MYUSERNAME | ユーザー名 (最大 10 文字、最小 1 文字)。 | | | `jics.parameters.netname` | string | MYNETNAME | ネットワーク名 (最大 8 文字、最小 1 文字)。 | | | `jics.parameters.opid` | string | XXX | 3 文字のオペレータ ID。 | | | `jics.parameters.jobname` | string | MJOBNAME | ジョブの名前。 | | | `jics.parameters.sysname` | string | SYSNAME | AS400 システム名 (sysname)。 | | | `jics.parameters.cwa.length` | 数値 | 0 | 共通ワークエリア (CWA) の長さ。 | | | `jics.parameters.charset` | string | CP037 | JICS がグローバルに使用する文字セット。 | | | `jics.parameters.tsqimpl` | string | bluesam | JICS 一時ストレージキュー (TSQ) の実装 (指定できる値は `bluesam`/`memory`/`redis`) | | | `jics.queues.ts.redis.*` | サポートされる Redis プロパティ | | JICS TS Queues Redis サーバーの設定プロパティを指定します。「[サポートされる Redis プロパティ](ba-runtime-redis-configuration.md#ba-runtime-redis-supported-properties)」を参照してください。 | | | `spring.aws.client.jics.queues.ts.redis.secret` | string | null | JICS TS Queues Redis サーバーの認証情報シークレット ARN を指定します。「[AWS メインフレームランタイムシークレットの変換](ba-runtime-config-app-secrets.md)」を参照してください。 | | | `lockTimeout` | 数値 | 500 | ロックタイムアウト (ミリ秒単位)。 | | | `sqlCodePointShift` | 数値 | | オプション。SQL コードポイントのシフト。レガシー RDBMS データを最新の RDBMS に移行する際に発生する可能性のある制御文字のコードポイントをシフトします。例えば、Unicode 文字 `\u0180` と一致するように `384` を指定できます。 | | | `sqlIntegerOverflowAllowed` | ブール値 | false | SQL 整数のオーバーフローを許可するかどうか、つまり、ホスト変数に大きな値を入れることを許可するかどうかを指定します。 | | | `database.cursor.overflow.allowed` | boolean | true | カーソルのオーバーフローを許可するかどうかを指定します。`true` に設定すると、カーソルの位置に関係なく、カーソル上で次の呼び出しが実行されます。`false` に設定すると、次のカーソル呼び出しを実行する前に、カーソルが最後の位置にあるかどうかを確認できます。カーソルが SCROLLABLE (SENSITIVE または INSENSITIVE) の場合にのみ有効になります。 | | | `reportOutputPath` | string | `/reports` | レポート出力パス。 | | | `server.servlet.session.tracking-modes` | string | Cookie | 使用するセッション追跡モードを指定します。指定できる値は `url`、`cookie`、 です`ssl`。複数の値をカンマで区切って指定できます。注: Tomcat にデプロイする場合、追跡モード設定が Tomcat が優先されるため、context.xml `cookies=false`で を設定する必要があります。 | | | `server.servlet.session.timeout` | string | 30m | セッションタイムアウト期間を指定します。例: `60s` (60 秒）、 `4m` (4 分）、 `4h` (4 時間）。 | | | `spring.session.store-type` | string | なし | 高可用性環境用のセッションキャッシュ。想定される値は、`none` または `redis` です。デフォルトは `none` です。 | | | `stopExecutionWhenProgNotFound` | boolean | true | プログラムが見つからない場合に実行を停止するかどうかを指定します。`true` に設定すると、プログラムが見つからなかった場合に実行が中断されます。 | | | `forceHR` | ブール値 | false | コンソール出力またはファイル出力のいずれかで、人間が読める形式の SYSPRINT を使用するかどうかを指定します。 | | | `rollbackOnRTE` | ブール値 | false | ランタイムの例外時に暗黙的な実行ユニットトランザクションをロールバックするかどうかを指定します。 | | | `sctThreadLimit` | long | 5 | スクリプトをトリガーするスレッドの上限。 | | | `dataSimplifier.onInvalidNumericData` | string | 拒否 | 無効な数値データをデコードしたときの対処方法。許可される値は、`reject`/`toleratespaces`/`toleratespaceslowvalues`/`toleratemost` です。デフォルトは `reject` です。 | | | `dataSimplifier.numproc` | string | PFD | numproc コンパイラの仕様。使用できる値は `PFD`/`NOPFD`/`MIG`/ です。デフォルトは `PFD` です。 | | | `dataSimplifier.doubleFloatingType` | string | IEEE\_754 | 二重浮動小数点型は、浮動小数点数のエンコードとデコードに使用される形式です。使用できる値は `IEEE_754` / `HFP`(16 進浮動小数点形式の場合) です。デフォルト値は `IEEE_754` です。 | 4.7.0 | | `filesDirectory` | string | | 入出力ファイルをバッチ処理するディレクトリ。 | | | `ims.messages.extendedSize` | ブール値 | false | IMS メッセージに拡張したサイズを設定するかどうかを指定します。 | | | `defaultKeepExistingFiles` | ブール値 | false | データセットのデフォルトの以前の値を設定するかどうかを指定します。 | | | `jics.db.ddlScriptLocation` | string | | Jics DDL スクリプトの場所。.sql スクリプトを使用して Jics データベーススキーマを開始できます。デフォルトでは空白。例えば、`./jics/sql/jics.sql`。 | | | `jics.db.schemaTestQueryLocation` | string | | jics スキーマ内のオブジェクト数 (存在する場合) を返す一意のクエリを含む必要がある sql ファイルの場所。 | | | `jics.db.dataScriptLocation` | string | | JICS データベースの初期化に使用される SQL スクリプトへのパスを定義します。ファイルとディレクトリのカンマ区切りリストを受け入れ、複数のスクリプトとフォルダを指定できます。 | | | `jics.db.dataTestQueryLocation` | string | | オブジェクト数を返すと予想される 1 つの sql クエリを含む sql スクリプトの場所 (例: jics プログラムテーブル内のレコード数のカウント)。カウントが 0 の場合、データベースは `jics.db.dataScriptLocation` スクリプトを使用してロードされます。それ以外の場合は、データベースのロードはスキップされます。 | | | `jics.data.dataJsonInitLocation` | string | | | | | `jics.xa.agent.timeout` | 数値 | | | | | `query.useConcatCondition` | ブール値 | false | キー条件がキー連結によって構築されるかどうかを指定します。 | | | `system.qdecfmt` | string | | | | | `disposition.checkexistence` | ブール値 | false | DISP SHR または OLD のデータセットのファイル存在確認を解除するかどうかを指定します。 | | | `useControlMVariable` | ブール値 | false | 変数置換に Control-M 仕様を使用するかどうかを指定します。 | | | `card.encoding` | string | CP1145 | カードのエンコーディング: `useControlMVariable` で使用します。 | | | `mapTransfo.prefixes` | string | &,@,%% | controlM 変数を変換するときに使用するプレフィックスのリスト。それぞれをカンマで区切ります。 | | | `checkinputfilesize` | ブール値 | false | ファイルサイズがレコードサイズの倍数である場合にチェックを解除するかどうかを指定します。 | | | `stepFailWhenAbend` | boolean | true | ステップが失敗した場合や実行が完了した場合に、異常終了を発生させるかどうかを指定します。 | | | `returnHttp5xxResponseForFailedSyncJob` | ブール値 | false | 同期ジョブの実行に失敗した場合に HTTP レスポンスコード 500 シリーズを返すかどうかを指定します。 | 4.10.0 | | `bluesam.fileLoading.commitInterval` | 数値 | 100000 | bluesam のコミット間隔。 | | | `uppercaseUserInput` | boolean | true | ユーザー入力を大文字にする必要があるかどうかを指定します。 | | | `jhdb.lterm` | string | | IMS エミュレーションの場合に共通の論理ターミナル ID を強制的に使用できます。設定されていない場合は、sessionId が使用されます。 | | | `jhdb.identificationCardData` | string | | 一部の「オペレータ ID カードデータ」を CARD パラメータで指定された MID フィールドにハードコードするために使用されます。デフォルトでは空白、入力制限なし。 | | | `encoding` | string | ASCII | プロジェクトで使われているエンコードです (groovy ファイルには使用されていません)。有効なエンコーディング `CP1047`、`IBM930`、`ASCII`、`UTF-8` などが必要です。 | | | `cl.configuration.context.encoding` | string | CP297 | CL ファイルのエンコーディング。有効なエンコーディング `CP1047`、`IBM930`、`ASCII`、`UTF-8` などが必要です。デフォルト値は `CP297` です | | | `cl.zonedMode` | string | EBCDIC\_STRICT | 制御言語 (CL) コマンドをエンコードまたはデコードするためのモード。許可される値は、`EBCDIC_STRICT`/`EBCDIC_MODIFIED`/`AS400` です。 | | | `ims.programs` | string | | 使用する IMS プログラムのリスト。各パラメータはセミコロン (`;`) で、各トランザクションはカンマ (`,`) で区切ります。以下に例を示します。`PCP008,PCT008;PCP054,PCT054;PCP066,PCT066;PCP068,PCT068;` | | | `jhdb.configuration.context.encoding` | string | CP297 | JHDB (Java 階層型データベース) のエンコーディング。有効なエンコーディング文字列 `CP1047`、`IBM930`、`ASCII`、`UTF-8` などが必要です。 | | | `jhdb.metadata.extrapath` | string | file:./setup/ | psbs フォルダと dbds フォルダ用に、ランタイム固有の追加のルートフォルダを指定する設定パラメータ。 | | | `jhdb.checkpointPersistence` | string | なし | チェックポイント永続化モード。許可される値は、`none`/`add`/`end` です。新しいチェックポイントが作成されてレジストリに追加されたときに、チェックポイントを永続化するために `add` を使用します。サーバーのシャットダウン時にチェックポイントを永続化するために `end` を使用します。それ以外の値は永続化を無効にします。新しいチェックポイントがレジストリに追加されるたびに、既存のチェックポイントはすべてシリアル化され、ファイルは消去されることに注意してください。ファイル内の既存のデータへの追加ではありません。そのため、チェックポイントの数によっては、パフォーマンスに何らかの影響を与える可能性があります。 | | | `jhdb.checkpointPath` | string | file:./setup/ | `jhdb.checkpointPersistence` が `none` ではない場合、このパラメータを使用してチェックポイント永続化パス (checkpoint.dat ファイルの保存場所) を設定できます。レジストリに含まれるすべてのチェックポイントデータがシリアル化され、指定されたフォルダにあるファイル (checkpoint.dat) にバックアップされます。このバックアップの対象となるのはチェックポイントデータ (scriptId、stepId、データベース位置、チェックポイントエリア) のみであることに注意してください。 | | | `jhdb.navigation.cachenexts` | 数値 | 5000 | RDBMS の階層ナビゲーションに使用されるキャッシュ時間 (ミリ秒単位)。 | | | `jhdb.use-db-prefix` | boolean | true | RDBMS の階層ナビゲーションでデータベースプレフィックスを有効にするかどうかを指定します。 | | | `jhdb.query.limitJoinUsage` | boolean | true | RDBMS グラフで結合使用制限パラメータを使用するかどうかを指定します。 | | | `taskExecutor.corePoolSize` | 数値 | 5 | ターミナルのトランザクションが groovy スクリプトによって開始されると、新しいスレッドが作成されます。このパラメータは、コアプールサイズを設定するために使用します。 | | | `taskExecutor.maxPoolSize` | 数値 | 10 | ターミナルのトランザクションが groovy スクリプトによって開始されると、新しいスレッドが作成されます。このパラメータを使用して、最大プールサイズ (並列スレッドの最大数) を設定します。 | | | `taskExecutor.queueCapacity` | 数値 | 50 | ターミナルのトランザクションが groovy スクリプトによって開始されると、新しいスレッドが作成されます。このパラメータを使用してキューサイズ (= `taskExecutor.maxPoolSize` に到達したときの保留中のトランザクションの最大数) を設定します。 | | | `taskExecutor.allowCoreThreadTimeOut` | ブール値 | false | JCIS でコアスレッドのタイムアウトを許可するかどうかを指定します。これにより、0 以外のキューと組み合わせた場合でも動的な拡大と縮小が可能になります (最大プールサイズはキューがいっぱいになった場合のみ増加するため)。 | | | `jics.runUnitLauncherPool.enable` | ブール値 | false | JICS で実行ユニットランチャープールを有効にするかどうかを指定します。 | | | `jics.runUnitLauncherPool.size` | 数値 | 20 | JICS 内の実行ユニットランチャープールサイズ。 | | | `jics.runUnitLauncherPool.validationInterval` | 数値 | 1,000 | プールのサイズを調整するタスクの実行間隔。 | | | `jics.runUnitLauncherPool.parallelism` | 数値 | 2 | 調整タスクの実行時にキューに欠落しているインスタンスを生成するために使用されるスレッドの数。 | | | `context.preconstruct.enable` | ブール値 | false | プログラムコンテキストを構築する前にアクティブ化するかどうかを指定します。 | | | `context.preconstruct.frequencyInMillis` | 数値 | 100 | プールのサイズを調整するタスクの実行間隔。 | | | `context.preconstruct.parallelism` | 数値 | 5 | 調整タスクの実行時にキューに欠落しているインスタンスを生成するために使用されるスレッドの数。 | | | `context.preconstruct.minInstances` | 数値 | 2 | コンテキストが初めて必要になったときに作成されるインスタンスの数。 | | | `spring.aws.application.credentials` | string | null | JICS の AWS 認証情報プロファイルファイルから認証情報をロードします。 | | | `jics.queues.sqs.region` | string | eu-west-1 | JICS で使用される Amazon Simple Queue Service の AWS リージョン。 | | | `jics.jcl.rt.encoding` | string | CP037 | 専用 JICS キューに書き込まれた JCL スクリプトのエンコード。 | | | `jics.jcl.rt.queue` | string | JICS | 実行時に JCL スクリプトを行ごとに書き込むことができるキューの名前。 | | | `mq.queues.sqs.region` | string | eu-west-3 | AWS SQS MQ サービスの AWS リージョン。 | | | `quartz.scheduler.stand-by-if-error` | ブール値 | false | ジョブスケジューラがスタンバイモードの場合にジョブの実行をトリガーするかどうかを指定します。「true」の場合、有効になってもジョブの実行はトリガーされません。 | | | `databaseStatistics` | ブール値 | false | SQL ビルダーに統計情報の収集と表示を許可するかどうかを指定します。 | | | `dbDateFormat` | string | yyyy-MM-dd | db ターゲットの日付形式。 | | | `dbTimeFormat` | string | HH:mm:ss | db ターゲット時間形式。 | | | `dbTimestampFormat` | string | yyyy-MM-dd HH:mm:ss.SSSSSS | db ターゲットのタイムスタンプ形式。 | | | `dateTimeFormat` | string | ISO | dateTimeFormat は、データベースの日付/時刻/タイムスタンプタイプをデータ簡略化エンティティに渡す方法を説明しています。許可される値は、`ISO`/`EUR`/`EUR`/`USA`/`LOCAL` です。 | | | `localDateFormat` | string | | ローカル日付形式のリスト。各形式は `\` で区切ります。 | | | `localTimeFormat` | string | | ローカルの時刻形式のリスト。各形式は `\` で区切ります | | | `localTimestampFormat` | string | | ローカルのタイムスタンプ形式のリスト。各形式は `\` で区切ります。 | | | `pgmDateFormat` | string | yyyy-MM-dd | 日付時刻形式 | | | `pgmTimeFormat` | string | HH.mm.ss | pgm (プログラム) の実行に使用される時刻形式。 | | | `pgmTimestampFormat` | string | yyyy-MM-dd-HH.mm.ss.SSSSSS | タイムスタンプ形式。 | | | `cacheMetadata` | boolean | true | データベースメタデータをキャッシュするかどうかを指定します。 | | | `forceDisableSQLTrimStringType` | ブール値 | false | すべての sql 文字列パラメータのトリミングを無効にするかどうかを指定します。 | | | `fetchSize` | 数値 | | カーソルの fetchSize 値。ロード/アンロードユーティリティでチャンクを使用してデータを取得するときに使用します。 | | | `check-groovy-file` | boolean | true | 登録する前に groovy ファイルの内容をチェックするかどうかを指定します。 | | | `qtemp.uuid.length` | 数値 | 9 | QTEMP の固有の ID の長さ。 | | | `qtemp.dblog` | ブール値 | false | QTEMP データベースログ記録を有効にするかどうか。 | | | `qtemp.cleanup.threshold.hours` | 数値 | 0 | `qtemp.dblog` をいつ有効にするかを指定します。DB パーティションの有効期間 (時間単位)。 | | | `invalidDataTolerence` | boolean | true | パック型に無効なデータを許可するかどうかを指定します。 | | | `program.timeout` | 数値 | -1 | プログラム/トランザクション実行のタイムアウトを秒単位で指定します。この時間が経過すると、システムはプログラムを中断します。 | | | `gapwalk.line.separator` | string | null | gapwalk の行区切りタイプを指定します。WIN (CRLF)/UNIX (LF)/LINUX (LF) を指定できます。その他の値は無視され、System line.sepatator プロパティが使用されます。 | | | `enableActivePgmIdCache` | ブール値 | false | アクティブなプログラム ID ローカルキャッシュを有効にするかどうかを指定します。JICS リソースはプログラムとユーザー間で共有できるため、この機能は慎重に使用してください。これらのリソースは、任意の管理者が外部から変更できるため、配置されたローカルキャッシュが無効になる可能性があります。 | | | `mq.queues.default.syncpoint` | ブール値 | false | MQPMO\_SYNCPOINT も MQPMO\_NO\_SYNCPOINT も設定されていない場合の MQ PUT コマンドのデフォルトの動作を指定します。true に設定すると `MQPMO_SYNCPOINT` として動作し、PUT コマンド中にメッセージが直接コミットされません。false に設定すると、`MQPMO_NO_SYNCPOINT` として動作し、PUT コマンド中にメッセージが直接コミットされます。 | | | `dataSimplifier.byteRangeBoundsCheck` | ブール値 | false | true に設定すると、ByteRange が不適切な値で作成されなくなります。デフォルトは False です。 | | | `file.stdoutIntoLogger` | ブール値 | false | デフォルトの `SYSPRINT` および `SYSPUNCH` ファイルで、デフォルトのシステム出力ストリームではなく、ロガーへの書き込みを有効にするかどうかを指定します。 | | | `tempFilesDirectory` | string | null | 生成される一時ファイルのフォルダの場所の名前を指定します。 | | | `cleanTempFilesDirectoryAtStartup` | boolean | true | アプリケーションの起動時に一時ファイルフォルダの内容を消去するかどうかを指定します。 | | | `tempFolderPattern` | string | null | 事前に定義される以下の情報 (カスタマイズ可能) に基づいて、一時フォルダの名前を動的に作成する際に使用するパターンを指定します。　
ホスト: ホスト名。
JOBID: ジョブの ID。
HASHCODE: ジョブコンテキストのハッシュコード。
TIMESTAMP: タイムスタンプを取得するときに使用するパターン。一時フォルダのターゲット名は TMP\_DIR\_{tempFolderPattern} です。例えば、次のパターンの場合、名前はジョブ ID で始まり、"timestamp" で終わります: tempFolderPattern: JOBID,HOST=xxxxx,HASHCODE,TIMESTAMP=yyyymmddhhmmss。プロパティ `tempFolderPattern` が YAML ファイルに追加されていない場合、または空の場合、一時フォルダの名前は "TMP\_DIR\_" \+ this.hashCode() (DefaultJobContext) になります。 | | | `database.cursor.raise.already.opened.error` | ブール値 | false | 既に開いているカーソルを開くときに「SQLCODE エラー 502」の生成を有効にするかどうかを指定します。 | | | `jics.spool.smtp.hostname` | string | null | SMTP サーバーホストを指定します。例: `smtp.xxx.com` | | | `jics.spool.smtp.port` | string | null | SMTP サーバーポートを指定します。例: 25 | | | `jics.spool.smtp.password` | string | null | SMTP サーバーのログインパスワードを指定します。 | | | `jics.spool.smtp.username` | string | null | SMTP サーバーのユーザー名を指定します。 | | | `jics.spool.smtp.debug` | ブール値 | false | SMTP サーバーのデバッグモードを指定します。 | | | `gapwalk-application.security` | string | `disabled` | グローバルセキュリティ設定 (XSS、CORS、CSRF、OAUTH 認証...) を切り替えます。指定できる値は `disabled` と `enabled` です。 | | | `gapwalk-application.security.identity` | string | null | グローバル認証方法。推奨値は `oauth` です。指定できる値は `json` と `oauth` です。このプロパティは、`gapwalk-application.security` が `enabled` の場合に必須です。 | | | `gapwalk-application.security.issuerUri` | string | null | ID プロバイダー (IdP) の発行者の URI です。このプロパティは、`gapwalk-application.identity` が `oauth` の場合に必須です。 | | | `gapwalk-application.security.allowedOrigins` | String[] | `null` | 許可するオリジンのリスト。このオプションでは `gapwalk-application.identity` を `oauth` に設定する必要があります。 | | | `gdgDirectoryPath` | string | `output/gdg` | GDG ディレクトリパスは、gdg ファイルが保存されているディレクトリです。 | 4.6.0 | | `gapwalk-application.security.customAllowedHeaders` | String[] | null | 許可するカスタムヘッダーのリスト。このオプションでは `gapwalk-application.identity` を `oauth` に設定する必要があります。 | 4.8.0 | | `listOfMDCUrlParams` | string | `null` | Groovy バッチスクリプトの実行時に MDC に追加する URL パラメータのリスト。 | | | `gapwalk-application.security.claimGroupName` | string | `cognito:groups` | ユーザーが属するすべてのグループのリストを含むクレーム属性。Amazon Cognito の場合は `cognito:groups`、外部 IdP の場合は他の文字列を指定します。 | | | `gapwalk-application.security.userAttributeName` | string | `username` | ユーザーリクエストを識別するために使用されるクレーム属性名。Amazon Cognito の場合は `username`、Keycloak の場合は `preferred_username`、外部 IdP の場合はその他の文字列を指定します。 | | | `gapwalk-application.defaultSuperAdminUserName` | string | `sadmin` | `gapwalk-application.security` が無効である場合、デフォルトのローカルスーパーユーザー名を指定します。 | | | `gapwalk-application.defaultSuperAdminUserPwd` | string | `sadmin` | `gapwalk-application.security` が無効である場合、デフォルトのローカルスーパーユーザーパスワードを指定します。 | | | `gapwalk-application.security.filterURIs` | string | `disabled` | URI のフィルター設定を切り替えます。指定できる値は `disabled` と `enabled` です。 | | | `gapwalk-application.security.blockedURIs` | String[] | null | ブロックする URI のリスト。このプロパティは、`gapwalk-application.security.filterURIs` が `enabled` の場合に必須です。 | | | `jics.redis.*` | サポートされる Redis プロパティ | | JICS Redis サーバー接続ファクトリの設定プロパティを指定します。「[サポートされる Redis プロパティ](ba-runtime-redis-configuration.md#ba-runtime-redis-supported-properties)」を参照してください。 | | | `spring.aws.client.jics.redis.secret` | string | null | JICS Redis サーバー接続ファクトリの認証情報シークレット ARN を指定します。「[AWS メインフレームランタイムシークレットの変換](ba-runtime-config-app-secrets.md)」を参照してください。 | | | `jcl.checkpoint.enabled` | ブール値 | false | JCL チェックポイントメカニズムを有効にしてジョブの再起動を許可するかどうかを指定します。JCL チェックポイントは、各ステップまたはメインプログラム呼び出しの開始時に作成され、メモリ内レジストリに保存されます。永続化プロバイダーが定義されている場合、すべてのステップレベルのチェックポイントはジョブの最後に保持されます。 | | | `jcl.checkpoint.expireTimeout` | 数値 | -1 | 永続化プロバイダーまたはインメモリレジストリに JCL チェックポイントを保持する期間を指定します。 | | | `jcl.checkpoint.expireTimeoutUnit` | string | 秒 | `jcl.checkpoint.expireTimeout` プロパティの時間単位を指定します。サポートされている列挙定数値: java.util.concurrent.TimeUnit。 | | | `jcl.checkpoint.provider` | string | null | JCL チェックポイントメカニズムの永続化プロバイダーを指定します。値は `redis` を指定できます。 | | | `jcl.checkpoint.redis.*` | サポートされる Redis プロパティ | | JCL チェックポイントメカニズムの REDIS 永続化プロバイダーの設定プロパティを指定します。「[サポートされる Redis プロパティ](ba-runtime-redis-configuration.md#ba-runtime-redis-supported-properties)」を参照してください。 | | | `jcl.nullJclEof` | boolean | true | ジョブの実行中に null JCL ステートメント (//) を処理する方法を指定します。true の場合、// はジョブをすぐに終了します (EOF モード）。false の場合、// は null ステートメントとして扱われ、実行は続行されます (IGNORE モード）。 | | | `job.default.encoding` | string | CP1047 | ジョブレベルのストレージの初期化に使用されるデフォルトのエンコードを指定します。例えば、BLU4IV アプリケーションのスイッチは、このエンコーディングを使用してゼロに初期化します。 | 4.9.0 | | `spring.aws.client.jcl.checkpoint.redis.secret` | string | null | JCL チェックポイントメカニズムの Redis 永続化プロバイダーの認証情報シークレット ARN を指定します。「[AWS メインフレームランタイムシークレットの変換](ba-runtime-config-app-secrets.md)」を参照してください。 | | | `gapwalk.ssl.enabled` | ブール値 | false | JVM システムプロパティに、アプリケーション起動時にまだ設定されていないものが見つかった場合は、次の `gapwalk.ssl.*` プロパティを設定することを示します。 | | | `gapwalk.ssl.trustStore` | string | null | 設定システムプロパティ `javax.net.ssl.trustStore` が、アプリケーション開始時にまだ設定されていない場合に設定する値を指定します。 | | | `gapwalk.ssl.trustStorePassword` | string | null | 設定システムプロパティ `javax.net.ssl.trustStorePassword` が、アプリケーション開始時にまだ設定されていない場合に設定する値を指定します。または、「」で説明されているように、 AWS シークレットを使用することを強くお勧めします[SSL パスワード設定のシークレットマネージャー](ba-runtime-config-app-secrets.md#ba-runtime-ssl-secrets-properties)。 | | | `gapwalk.ssl.trustStoreType` | string | null | 設定システムプロパティ `javax.net.ssl.trustStoreType` が、アプリケーション開始時にまだ設定されていない場合に設定する値を指定します。 | | | `gapwalk.ssl.keyStore` | string | null | 設定システムプロパティ `javax.net.ssl.keyStore` が、アプリケーション開始時にまだ設定されていない場合に設定する値を指定します。 | | | `gapwalk.ssl.keyStorePassword` | string | null | 設定システムプロパティ `javax.net.ssl.keyStorePassword` が、アプリケーション開始時にまだ設定されていない場合に設定する値を指定します。または、「」で説明されているように、 AWS シークレットを使用することを強くお勧めします[SSL パスワード設定のシークレットマネージャー](ba-runtime-config-app-secrets.md#ba-runtime-ssl-secrets-properties)。 | | | `mq.queues` | string | `sqs` | サポートされるキューブロッカーのうちどれを使用するかを、Amazon SQS を使用した `sqs`、オンプレミスの Rabbit MQ を使用した `rabbitmq`、またはオンプレミスの IBMMQ を使用した `jms`から指定します。 | | | `mq.queues.jmsMQQueueManagers[N]` | | | `mq.queues` が `jms` の場合は IBM MQ 接続リストを指定します。最初の接続であれば `mq.queues.jmsMQQueueManagers[0]`、2 番目の接続であれば `mq.queues.jmsMQQueueManagers[1]`、のように指定します。 | | | `mq.queues.jmsMQQueueManagers[N].jmsMQQueueManager` | string | null | IBMMQ キューマネージャー名。 | | | `mq.queues.jmsMQQueueManagers[N].jmsMQAppName` | string | null | IBMMQ アプリケーション名。 | | | `mq.queues.jmsMQQueueManagers[N].jmsMQChannel` | string | null | IBMMQ チャネル名。 | | | `mq.queues.jmsMQQueueManagers[N].jmsMQHost` | string | null | IBMMQ ホスト名。 | | | `mq.queues.jmsMQQueueManagers[N].jmsMQPort` | 数値 | null | IBMMQ ポート。 | | | `mq.queues.jmsMQQueueManagers[N].jmsMQUserid` | string | null | IBMMQ ユーザー名。 | | | `mq.queues.jmsMQQueueManagers[N].jmsMQPassword` | string | null | IBMMQ ユーザーパスワード。または、「」で説明されているように、 AWS シークレットを使用することを強くお勧めします[IBM MQ パスワード設定のシークレットマネージャー](ba-runtime-config-app-secrets.md#ba-runtime-IBMMQ-secrets-properties)。 | | | `mq.queues.jmsMQQueueManagers[N].jmsMQMaxPoolSize` | 数値 | 0 | IBMMQ 最大プールサイズ。0 にすると、物理的な接続が数に制限なく有効になります。 | | | `mq.queues.jmsMQQueueManagers[N].jmsMQSSLCipher` | string | null | IBMMQ SSL 暗号スイート。例えば `"*TLS12ORHIGHER"` などを指定します。公式ドキュメント、[「IBM MQ classes for JMS での TLS CipherSpecs および CipherSuites」](https://www.ibm.com/docs/en/ibm-mq/9.2?topic=jms-tls-cipherspecs-ciphersuites-in-mq-classes) を参照してください。 | | | `mq.queues.non.jms.client` | ブール値 | false | にメッセージを送信するターゲットクライアントが非 JMS かどうかを示します。JMS 以外のクライアントにはネイティブ MQ 形式が使用され、JMS には RFH2 形式が使用されます。 | 4.5.0 | | `mq.connection.pool.share` | ブール値 | false | 同じキューマネージャーと JMS 接続プールを共有または再作成するかどうかを指定します。 | 4.9.0 | | `mq.queues.rabbitMQHost` | string | null | Rabbit MQ のホスト名。 | | | `mq.queues.rabbitMQVirtualHost` | string | null | Rabbit MQ の仮想ホスト名。 | | | `mq.queues.rabbitMQPort` | 数値 | null | Rabbit MQ のポート。 | | | `mq.queues.rabbitMQUsername` | string | null | Rabbit MQ のユーザー。 | | | `mq.queues.rabbitMQPassword` | string | null | Rabbit MQ のパスワード。 | | | `mf.runtime.switch.N` | boolean | true | MF 自然の行連続ファイルの null 挿入を有効にします。 | 4.4.0 | | `mf.runtime.switch.T` | ブール値 | false | MF 自然の行連続ファイルにタブ文字を挿入できるようにします。 | 4.4.0 | | `gapwalk.database.support.useSavePointToRestoreFail` | ブール値 | false | 挿入クエリでセーブポイントを使用して、障害発生時のトランザクション復旧を有効にします。このプロパティを有効にすると、データベースのパフォーマンスに影響する可能性があります。クエリquery-to-databaseマッピング設定を使用して、特定のクエリに対してこの設定を上書きできます。 | 4.6.0 | | `xmlGeneratorPrettyFormat` | boolean | true | XmlGenerator クラス内で生成された XML 出力のフォーマットスタイルを決定します。に設定すると`true`、XML 出力は人間が読み取り可能なインデント構造 (プリティプリント) でフォーマットされます。に設定すると`false`、出力は空白を追加せずにコンパクトな単一行形式になります。 | 4.8.0 | | `gapwalk.database.metadata.schema-inclusion.enabled` | ブール値 | false | アプリケーションによってキャッシュされるデータベーススキーマを制御するメモリ最適化機能を有効にします。この設定は、スキーマメタデータをインテリジェントに管理することで、システムの安定性を維持しながらメモリフットプリントを削減するのに役立ちます。これには、適切なオペレーションに必要な一般的なデータベースシステムスキーマが自動的に含まれます。 | 4.9.0 | | `gapwalk.database.metadata.schema-inclusion.schemas.global` | list | null | キャッシュするスキーマのリストを定義します。 | 4.9.0 | | `sqlConnectionAutoCommitEnabled` | boolean | true | 接続リセットオペレーション中に現在の接続の自動コミットを有効にします。有効にすると、XA 以外の環境で新しいデータソース接続に切り替える前に、 は自動的に現在の接続をコミットし、接続の不安定さを防ぎます。無効にすると、 はリセットオペレーション中に発生する可能性のある接続の問題に関する警告メッセージをログに記録します。 | 4.10.0 | | `gapwalk.post.script.mediatype.json` | ブール値 | false | ブール変数の値に応じて`application/json`、エンドポイントからのレスポンスの`Content-Type`ヘッダーを `/post/script/{scriptId:.+}`に設定するかどうかを指定します。false に設定すると、デフォルトは です`text/plain; charset=utf-8`。 | | | `startDefaultJob` | string | `false` | 最初のトランザクションでデフォルトのジョブを初期化するかどうかを指定します。 | | | `gapwalk.cobol.cblqda.enabled` | ブール値 | false | OPEN ステートメント中の QSAM ファイルの動的割り当てを制御する CBLQDA 機能を有効にします。この設定は、ファイルが JCL スクリプトで定義されていない場合でも、プログラムで宣言された一時ファイルを動的に割り当てるのに役立ちます。 | | | `mq.queues.jms.connectionfactory.*` | サポートされている Atomikos 接続ファクトリのプロパティ | | JMS MQ 接続プールの設定プロパティを指定します。 | | ## オプションのウェブアプリケーションで使用可能なプロパティ モダナイズされたアプリケーションによっては、z/OS、AS/400、IMS/MFS などの依存関係をサポートするオプションのウェブアプリケーションを 1 つ以上設定する必要がある場合があります。以下の表には、各オプションのウェブアプリケーションの設定に使用できるキー/値パラメータの一覧が記載されています。 ### gapwalk-utility-pgm.war このオプションのウェブアプリケーションには Z/OS ユーティリティプログラムのサポートが含まれています。 この表は、このアプリケーションのキー/値パラメータのすべてをまとめたものです。 | キー | タイプ | デフォルトの値 | 説明 | リリースバージョン | | --- | --- | --- | --- | --- | | `logging.config` | パス | classpath:logback-utility.xml | logback 設定ファイルへの参照用の標準キー。他の標準ログ記録キーも使用できます。 | | | `spring.jta.enabled` | ブール値 | false | 標準キー。データソースサポートモードが static-xa でない場合は、spring JTA トランザクションの自動設定を無効にする必要があります。 | | | `spring.datasource.primary.jndi-name` | string | jdbc/primary | JNDI を使用する場合の、プライマリデータソースの JNDI 名 (Java Naming And Directory Interface)。 | | | `primary.datasource` -`driver-class-name` -`url` -`username` -`password` | サブキー付きの標準 spring データソース | | JNDI を使用していない場合、アプリケーションデータベースの接続情報が含まれます。モダナイズされたアプリケーションの YAML ファイルと同じ設定にする必要があります。
または、「」で説明されているように、 AWS シークレットの使用を強くお勧めします[クライアントデータベース](ba-runtime-config-app-secrets.md#client-database)。 | | | `encoding` | string | ASCII | ユーティリティプログラムで使用されるエンコーディング。有効なエンコーディング `CP1047`、`IBM930`、`ASCII`、 が必要です`UTF-8`。 | | | `sysPunchEncoding` | string | ASCII | syspunch エンコーディング文字セット。有効なエンコーディング`CP1047`、`IBM930`、`ASCII`、が必要です`UTF-8`。 | | | `systin.encoding` | string | ASCII | SYSTIN ファイルデータセットのエンコード文字セット。有効なエンコーディング`CP1047`、`IBM930`、`ASCII`、が必要です`UTF-8`。 | 4.5.0 | | `zonedMode` | string | EBCDIC\_STRICT | ゾーンデータ型をエンコードまたはデコードするためのモード。許可される値は、`EBCDIC_STRICT`/`EBCDIC_MODIFIED`/`AS400` です。 | | | `idcams.encoding.forced` | string | | IDCAMS ユーティリティプログラムで使用されるエンコード。有効なエンコード `CP1047`、`IBM930`、`ASCII`、 が必要です`UTF-8`。 | 4.4.0 | | `unload.chunkSize` | 数値 | 0 | アンロードユーティリティに使用されるチャンクサイズ。 | | | `unload.computeRecordSizeIfNull` | ブール値 | false | 指定しない場合、レコードサイズを計算するかどうかを決定します。指定した場合、値は変更されません。 | | | `unload.sqlCodePointShift` | 数値 | 0 | アンロードユーティリティの SQL コードポイントシフト。文字シフト処理を実行します。DB2 のターゲットデータベースが PostgreSQL の場合に必要です。 | | | `unload.columnFiller` | string | スペース | アンロードユーティリティの列フィラー。 | | | `unload.varCharIsNull` | ブール値 | false | INFTILB プログラムでこのパラメータを使用します。このパラメータを `true` に設定すると、空白 (スペース) の値を持つ NULL が許容されないフィールドはすべて空の文字列を返します。 | | | `unload.useDatabaseConfiguration` | ブール値 | false | アンロードユーティリティで application-main.yml の日付設定と時刻設定のどちらを使用するかを指定します。 | | | `unload.format.date` | string | MM/dd/yyyy | `unload.useDatabaseConfiguration` が有効な場合、アンロードユーティリティで使用する日付形式です。 | | | `unload.format.time` | string | HH.mm.ss | `unload.useDatabaseConfiguration` が有効な場合、アンロードユーティリティで使用する時間形式。 | | | `unload.format.timestamp` | string | yyyy-MM-dd-HH.mm.ss.SSSSSS | `unload.useDatabaseConfiguration` が有効な場合、アンロードユーティリティで使用するタイムスタンプ形式。 | | | `unload.nbi.whenNull` | 16 進数 | 6F | データベースからの値が NULL の場合に追加される Null バイトインジケータ (NBI) 値。 | | | `unload.nbi.whenNotNull` | 16 進数 | 00 | データベースの値が NULL でない場合に追加される NULL バイトインジケータ (NBI) 値。 | | | `unload.nbi.writeNullIndicator` | ブール値 | false | アンロード出力ファイルに NULL インジケータを書き出すかどうかを指定します。 | | | `unload.bmc.useInto` | ブール値 | false | アンロードユーティリティの INTO bmc コントロールキーワードを処理するかどうかを指定します。 | | | `unload.fetchSize` | 数値 | 0 | アンロードユーティリティでカーソルを処理する際にフェッチサイズを調整できます。 | | | `unload.noPad` | boolean | true | 可変長文字 (VARCHAR) フィールドは、最大長までパディングなしでアンロードされることを示します。 | 4.5.0 | | `treatLargeNumberAsInteger` | ブール値 | false | 大きな数値を `Integer` として扱うかどうかを指定します。デフォルトでは、`BigDecimal` のように扱われます。 | | | `load.batchSize` | 数値 | 0 | ロードユーティリティのバッチサイズ。 | | | `load.format.localDate` | string | dd.MM.yyyy\\dd/MM/yyyy\\yyyy-MM-dd | 使用するロードユーティリティのローカルの日付形式。 | | | `load.format.localTime` | string | HH:mm:ss\\HH.mm.ss | 使用するロードユーティリティのローカルの時刻形式。 | | | `load.format.dbDate` | string | yyyy-MM-dd | 使用するロードユーティリティデータベース形式。 | | | `load.format.dbTime` | string | HH:mm:ss | ロードユーティリティデータベースの使用時間。 | | | `load.sqlCodePointShift` | 数値 | 0s | ロードユーティリティの SQL コードポイントシフト。文字シフト処理を実行します。DB2 のターゲットデータベースが PostgreSQL の場合に必要です。 | | | `load.applyRollback` | ブール値 | false | データベースへのデータの読み込み中にエラーが発生した場合にテーブルの変更をロールバックする場合は、このパラメータを `true` に設定します。 | | | `forcedDate` | string | | 指定された日付がある場合は、日付を強制的にその日付に合わせます。 | | | `frozenDate` | boolean | true | 日付を固定するかどうかを指定します。`forcedDate` も設定されている場合にのみ適用されます。 | | | `jcl.type` | string | mvs | .jcl ファイルタイプ。許可される値は、`jcl`/`vse` です。IDCAMS ユーティリティの PRINT/REPRO コマンドは、vse jcl 以外のファイルが空の場合、4 を返します。 | | | `hasGraphic` | ブール値 | false | INFUTILB ユーティリティが GRAPHIC DB2 列を処理する必要があるかどうか。 | | | `convertGraphicDataToFullWidth` | boolean | true | グラフィックデータを全幅形式に変換するかどうかを指定します。 | | ### gapwalk-cl-command.war このオプションのウェブアプリケーションには AS/400 ユーティリティプログラムのサポートが含まれています。 この表は、このアプリケーションのキー/値パラメータのすべてをまとめたものです。 | キー | タイプ | デフォルトの値 | 説明 | | --- | --- | --- | --- | | `logging.config` | パス | classpath:logback-utility.xml | logback 設定ファイルへの参照用の標準キー。他の標準ログ記録キーも使用できます。 | | `spring.jta.enabled` | ブール値 | false | 標準キー。データソースサポートモードが static-xa でない場合は、spring JTA トランザクションの自動設定を無効にする必要があります。 | | `spring.datasource.primary.jndi-name` | string | jdbc/primary | JNDI を使用する場合の、プライマリデータソースの JNDI 名 (Java Naming And Directory Interface)。 | | `primary.datasource` \+ -`driver-class-name` \+ -`url` \+ -`username` \+ -`password` | サブキー付きの標準 spring データソース | | JNDI を使用していない場合、アプリケーションデータベースの接続情報が含まれます。モダナイズされたアプリケーションの YAML ファイルと同じ設定にする必要があります。
または、「」で説明されているように、 AWS シークレットの使用を強くお勧めします[クライアントデータベース](ba-runtime-config-app-secrets.md#client-database)。 | | `encoding` | string | ASCII | ユーティリティプログラムで使用されるエンコーディング。有効なエンコーディング `CP1047`、`IBM930`、`ASCII`、`UTF-8` などが必要です。 | | `zonedMode` | string | EBCDIC\_STRICT | ゾーンデータ型をエンコードまたはデコードするためのモード。許可される値は、`EBCDIC_STRICT`/`EBCDIC_MODIFIED`/`AS400` です。 | | `commands-off` | string | | 無効にするコマンドのリスト。カンマで区切られています。許可される値は、`PGM_BASIC`、`RCVMSG`、`SNDRCVF`、`CHGVAR`、`QCLRDTAQ`、`RTVJOBA`、`ADDLFM`、`ADDPFM`、`RCVF`、`OVRDBF`、`DLTOVR`、`CPYF`、`SNDDTAQ` です。既存のプログラムを無効化または上書きする場合に役立ちます。 `PGM_BASIC`は、デバッグ用に設計されたメインフレームランタイムプログラム用の特定の AWS 変換です。 | | `forcedDate` | string | | 指定された日付がある場合は、日付を強制的にその日付に合わせます。 | ### gapwalk-hierarchical-support.war このオプションのウェブアプリケーションには IMS/MFS トランザクションサポートが含まれています。 この表は、このアプリケーションのキー/値パラメータのすべてをまとめたものです。 | キー | タイプ | デフォルトの値 | 説明 | | --- | --- | --- | --- | | `logging.config` | パス | classpath:logback-utility.xml | logback 設定ファイルへの参照用の標準キー。他の標準ログ記録キーも使用できます。 | | `spring.jta.enabled` | ブール値 | false | 標準キー。データソースサポートモードが static-xa でない場合は、spring JTA トランザクションの自動設定を無効にする必要があります。 | | `jhdb.configuration.context.encoding` | string | | JHDB (Java 階層型データベース) のエンコーディング。有効なエンコーディング文字列 `CP1047`、`IBM930`、`ASCII`、`UTF-8` などが必要です。 | | `jhdb.checkpointPersistence` | string | なし | チェックポイント永続化モード。許可される値は、`none`/`add`/`end` です。新しいチェックポイントが作成されてレジストリに追加されたときに、チェックポイントを永続化するために `add` を使用します。サーバーのシャットダウン時にチェックポイントを永続化するために `end` を使用します。それ以外の値は永続化を無効にします。新しいチェックポイントがレジストリに追加されるたびに、既存のチェックポイントはすべてシリアル化され、ファイルは消去されることに注意してください。ファイル内の既存のデータへの追加ではありません。そのため、チェックポイントの数によっては、パフォーマンスに何らかの影響を与える可能性があります。 | | `jhdb.keepParent` | ブール値 | false | IMS 挿入中に \_parent と \_logicalparent を保持するかどうか。true に設定すると、IMS ISRT 呼び出しはデータベース列に \_parent と \_logicalparent を挿入します。 | | `jhdb.query.timeout` | int | -1 | jhdb トランザクション実行のタイムアウトを秒単位で指定します。この時間が経過すると、システムはプログラムを中断します。値が -1 (デフォルト) の場合、タイムアウトは設定されません。 | | `jhdb.backend` | string | | Jhdb バックエンドタイプ。予想される値は です `rdbms` | | `jhdb.transaction.scope.programs` | string | | トランザクション全体として宣言されるプログラムのリスト。各プログラムはカンマ () で区切ります`,`。以下に例を示します。`PCP008,PCT008` | | `metadata.datasource` \+ -`driver-class-name` \+ -`url` \+ -`username` \+ -`password` \+ -`type` | string | サブキー付きの標準 spring データソース | psbs、dbds、接続など、jhdb データベースのメタデータ情報が含まれます。または、 AWS シークレットを使用することを強くお勧めします。 | ## クライアントアプリケーションで使用可能なプロパティ モダナイズされたアプリケーションでは、クライアント Spring アプリケーションの特定のプロパティ設定が必要になる場合があります。これらのプロパティは、ランタイム JAR ファイルでパッケージ化されたクラスから Bean を初期化します。アプリケーションの生成中にプロファイル値が設定される `application-profile.yaml` ファイルでは、これらのプロパティを設定できます。次の表に、Gapwalk ランタイムにパッケージ化されたクラスの Bean を使用するクライアントウェブアプリケーションの設定に使用できるキー/値パラメータを示します。 | キー | タイプ | デフォルトの値 | 説明 | リリースバージョン | | --- | --- | --- | --- | --- | | `blu4iv.dtaara.library.disable` | ブール値 | false | データエリアオペレーションのコンテキストでのライブラリの使用を制御します。true に設定すると、データエリアオペレーションではライブラリの使用が無効になりますが、QTemp の使用には影響しません。false に設定すると、データエリアに対して CRUD オペレーションを実行するときにライブラリが考慮されます。 | 4.5.0 | | `blu4iv.dao.data.max` | 数値 | 10 | 入力 DAO オペレーションの内部キャッシュのサイズ。このキャッシュはプログラムレベル (単一インスタンス) に存在します。 | 4.9.0 | | `blu4iv.dao.sort.function` | string | | blu4iv データベースのソート関数名。 | 4.9.0 | | `blu4iv.dao.support` | string | JPA | 使用するデータアクセス実装 (JPA または JDBC) を指定します。 | 4.9.0 | | `blu4iv.dao.cache.enabled` | ブール値 | false | インメモリキャッシュを有効にします。 | 4.8.0 | | `blu4iv.dao.cache.enabledHits` | ブール値 | false | キャッシュへのリクエスト数の追跡を追加します。 | 4.8.0 | | `blu4iv.dao.cache.initMaxResults` | 数値 | 10000 | キャッシュのサイズ。 | 4.8.0 | | `blu4iv.dao.cache.entries.fileIds` | string | | キャッシュするデータベーステーブルのリスト。 | 4.8.0 | | `blu4iv.dao.cache.entries.programIds` | string | | 指定されたテーブルに対してキャッシュをアクティブ化するプログラムの識別子。キャッシュは、実行スタック内のすべてのサブプログラムで使用できます。 | 4.8.0 | | `blu4iv.librarylist.enabled` | ブール値 | false | ライブラリリストを使用してファイルライブラリを解決します。 | 4.10.0 | | `blu4iv.librarylist.libraries` | string | | 左から右に順序付けられたライブラリの初期リスト。 | 4.10.0 | ### AS400 アプリケーションのインメモリキャッシュを設定する インメモリキャッシュ機能により、ユーザーは読み取り専用データをメモリ内にキャッシュできるため、データ集約型プログラムのパフォーマンスが大幅に向上します。キャッシュシステムは、初回アクセス時にのみデータをロードする、オンデマンドでデータアクセスマップを作成する、キャッシュされたデータをプログラムメモリの近くに効率的に保存するという 3 つの方法でパフォーマンスを最適化します。この設計により、メモリのオーバーヘッドを最小限に抑えながら、速度の向上を最大化できます。 ``` ################################################################### # Cache configuration for read operations called from DAO classes # ################################################################### blu4iv: dao: cache: enabled: true enabledHits: true initMaxResults: 100000 entries: - fileIds: [${TABLEA}] programIds: [${PROGRAM1}] - fileIds: [${TABLEB},${TABLEC}] programIds: [${PROGRAM2}] librarylist: enabled: true libraries: ["LIBA","LIBC","LIBE"] ``` ## API アクセスのログ記録を設定する API アクセスログ記録機能は、BAC、JAC、Gapwalk アプリケーションへの API リクエストに関する詳細情報を記録し、誰がいつ何にアクセスしたかを追跡することで、セキュリティ要件を満たすのに役立ちます。 | キー | タイプ | デフォルトの値 | 説明 | リリースバージョン | | --- | --- | --- | --- | --- | | `api.logging.enabled` | ブール値 | false | BAC、JAC、Gapwalk アプリケーションの API アクセスログ記録を有効にします。有効にすると、 はすべての API リクエストの詳細を記録します。 | 5.0.0 | 有効にすると、ユーザーはログファイル設定を指定して、ロガー名 を使用して選択した場所で API アクセスログを記録できます`api.access`。ログには、次の MDC フィールドを含めることができます。 | MDC フィールド | 説明 | | --- | --- | | `api-date` | API リクエストが行われた日時 | | `api-duration` | API リクエストの処理にかかった時間 (ミリ秒) | | `api-host` | API リクエストの送信元アドレス | | `api-context` | API がホストされている場所 | | `api-user` | API リクエストを行うユーザーのユーザー名または識別子 | | `api-sessionid` | ユーザーの現在のログインセッションの一意の識別子 | | `api-scheme` | HTTP や HTTPS など、使用される転送プロトコル。 | | `api-name` | アクセスされたエンドポイント/URI | | `api-retcode` | API リクエストの完了後に返されるステータスコード | | `api-secure` | API コールの保護に使用されるセキュリティ方法 (OAuth2、トークン、匿名など) | | `api-method` | 行われた HTTP リクエストのタイプ (GET、POST、DELETE など) | API アクセスログ専用のログファイルを設定するには、ログバック設定に以下を追加します。 ``` logs/main/main-api-access.log true %date %X{api-scheme} %X{api-host} %X{api-method} %X{api-name} - Return code: %X{api-retcode} - Start date: %X{api-date} - Duration: %X{api-duration} ms - User: %X{api-user} - SessionId: %X{api-sessionid} - SecureMethod: %X{api-secure} %n ``` サンプルログ出力: ``` 2025-06-13 22:24:36,174 http 127.0.0.1 GET /bac/api/services/rest/bluesamservice/listDataSet - Return code: 200 - Start date: 06-13-2025 22:24:35.863+0200 - Duration: 308 ms - User: velocity_admin - SessionId: 1X1X1X1X1X1X1X1X1X1X1X1X1X1X1X1X- SecureMethod: Oauth2 ```