AWS Blu Age ランタイムのプロパティを有効にする - AWS Mainframe Modernization
YML 表記クイックスタート/ユースケースメインのアプリケーションで使用可能なプロパティオプションのウェブアプリケーションで使用可能なプロパティクライアントアプリケーションで使用可能なプロパティクライアントアプリケーションで使用可能なプロパティAPI アクセスのログ記録を設定する

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

AWS Blu Age ランタイムのプロパティを有効にする

Spring Boot アプリケーションでは、リスニングポートやデータベース接続など、さまざまな種類のプロパティを application-main.yml の設定ファイルに定義します。このページでは、 AWS Blu Age ランタイムのプロパティと、それらを有効化する方法について説明します。

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

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

メインのアプリケーションで使用可能なプロパティ

この表は、キー/バリューのパラメータを網羅的にまとめたものです。

キー タイプ デフォルト値 説明 リリースバージョン

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 データベース」で説明されているように、 AWS シークレットの使用を強くお勧めします。

jildb.datasource + -driver-class-name + -url + -username + -password

サブキー付きの標準 spring データソース

Jics データベースの接続情報が含まれています。

jildb.backend

文字列

Oracle など、Jildb バックエンドで使用されるデータベースタイプを指定します。

jildb.record-hold-timeout

int

10000

Jildb のレコード保持メカニズムの待機タイムアウト期間をミリ秒単位で指定します。

datasource.bluesamDs + -driver-class-name + -url + -username + -password + -type

サブキー付きの標準 spring データソース

Blusam データベースの接続情報が含まれます。または、「データベースの Blusam」で説明されているように、 AWS シークレットの使用を強くお勧めします。

blu4iv.userspace.pageSize

int

4096

ユーザースペースにストレージを割り当てるために使用されるページサイズを指定します。任意の時点でのユーザースペースのサイズは、常にこの数の倍数です。

 4.10.0

blu4iv.userspace.store-type

文字列

メモリ

ユーザースペースレジストリに使用されるストアタイプを指定します。サポートされている値はメモリと redis です。ストアタイプが指定されていない場合、メモリはデフォルトで使用されます。

 4.10.0

blu4iv.userspace.redis.*

サポートされる Redis プロパティ

ユーザースペース redis ストアの設定プロパティを指定します。「」を参照してくださいAWS Blu Age ランタイムで使用可能な Redis キャッシュプロパティ。

 4.10.0

blu4iv.dataaccess.useOldDaoDesign

boolean

false

アプリケーションが古い DAO アーキテクチャを使用するか新しい を使用するかを決定するグローバルフラグ。これは、DAO が古い設計と新しい設計のどちらを使用して生成されたかによって異なります。

bluesam.disabled

boolean

false

Blusam を完全に無効にするかどうか。

bluesam.cache

文字列

設定されていない場合、Blusamキャッシュは使用されません。指定できる値 (キャッシュ実装) は cache と redis です (Redis キャッシュプロパティ)。

bluesam.maxBluesamDisablingThreadpoolSize

数値

10

バッチ処理のために Bluesam データセットを無効にするために使用される最大スレッドプールサイズを指定します。

 4.5.0

bluesam.bluesamStatusPollingInterval

数値

1,000

Bluesam ステータスをポーリングしてオンラインアクティビティをチェックするときに、各反復の間に待機する時間 (ミリ秒単位) を指定します。

 4.5.0

bluesam.maxBluesamStatusPollingRetry

数値

3

Bluesam ステータスのポーリングが失敗した場合の最大再試行回数を指定します。

 4.5.0

bluesam.checkBluesamStatus

boolean

false

アクセスする前に bluesam データセットのステータスを確認するかどうかを指定します。

 4.5.0

spring.aws.client.bluesam.redis.secret

文字列

null

Bluesam Redis キャッシュの認証情報シークレット ARN を指定します。「AWS Blu Age ランタイムシークレット」を参照してください。

spring.aws.client.bluesam.locks.redis.secret

文字列

null

Bluesam が Redis キャッシュをロックするための認証情報シークレット ARN を指定します。「AWS Blu Age ランタイムシークレット」を参照してください。

forcedDate

文字列

指定された日付がある場合は、日付を強制的にその日付に合わせます。

clcommand.rtvmbrd.hasHeader

文字列

true

行をカウントするときに含めるべきではないヘッダーがファイルに含まれているかどうかを指定します。

frozenDate

boolean

true

日付を固定するかどうかを指定します。forcedDate も設定されている場合にのみ適用されます。

externalSort.threshold

データサイズ (例: 12 メガバイト)

ソートのしきい値: 外部 (マージ) ソートに切り替えるタイミング。

blockSizeDefault

数値

32760

BDW バイトに使用するデフォルトのブロックサイズ。

jics.parameters.datform

文字列

MMDDYY

日付形式。

jics.initList

文字列

カンマ区切りの、JICS 初期化リスト。存在する場合、Apache Tomcat の起動時に CICS リストの中でアクティブ化するリストの名前をカンマで区切って定義します。値の例: $UUU,DFH$IVPL,PEZ1 これはそれらのリストに含まれるグループとその基礎となるリソース定義にカスケードされ、ランタイムに表示されます。デフォルトでは空です。

jics.parameters.applid

文字列

VELOCITY

JICS でのアプリケーションの識別に適用されます (最低 4 文字、最大長なし)。

jics.parameters.sysid

文字列

CICS

システム識別子 (SYSID)。

jics.parameters.eibtrmid

文字列

TERM

ターミナル識別子 (最大 4 文字、最小 1 文字)。

jics.parameters.userid

文字列

ユーザー ID (最大 8 文字、最小文字数なし)。値が指定されていない場合 (デフォルトでは空白)、HTTP セッション ID がユーザー ID として使用されます。

jics.parameters.username

文字列

MYUSERNAME

ユーザー名 (最大 10 文字、最小 1 文字)。

jics.parameters.netname

文字列

MYNETNAME

ネットワーク名 (最大 8 文字、最小 1 文字)。

jics.parameters.opid

文字列

XXX

3 文字のオペレータ ID。

jics.parameters.jobname

文字列

MJOBNAME

ジョブの名前。

jics.parameters.sysname

文字列

SYSNAME

AS400 システム名 (sysname)。

jics.parameters.cwa.length

数値

0

共通ワークエリア (CWA) の長さ。

jics.parameters.charset

文字列

CP037

JICS がグローバルに使用する文字セット。

jics.parameters.tsqimpl

文字列

bluesam

JICS 一時ストレージキュー (TSQ) の実装 (指定できる値は bluesam/memory/redis)

jics.queues.ts.redis.*

サポートされる Redis プロパティ

JICS TS Queues Redis サーバーの設定プロパティを指定します。「サポートされる Redis プロパティ」を参照してください。

spring.aws.client.jics.queues.ts.redis.secret

文字列

null

JICS TS Queues Redis サーバーの認証情報シークレット ARN を指定します。「AWS Blu Age ランタイムシークレット」を参照してください。

lockTimeout

数値

500

ロックタイムアウト (ミリ秒単位)。

sqlCodePointShift

数値

オプション。SQL コードポイントのシフト。レガシー RDBMS データを最新の RDBMS に移行する際に発生する可能性のある制御文字のコードポイントをシフトします。例えば、Unicode 文字 \u0180 と一致するように 384 を指定できます。

sqlIntegerOverflowAllowed

boolean

false

SQL 整数のオーバーフローを許可するかどうか、つまり、ホスト変数に大きな値を入れることを許可するかどうかを指定します。

database.cursor.overflow.allowed

boolean

true

カーソルのオーバーフローを許可するかどうかを指定します。true に設定すると、カーソルの位置に関係なく、カーソル上で次の呼び出しが実行されます。false に設定すると、次のカーソル呼び出しを実行する前に、カーソルが最後の位置にあるかどうかを確認できます。カーソルが SCROLLABLE (SENSITIVE または INSENSITIVE) の場合にのみ有効になります。

reportOutputPath

文字列

/reports

レポート出力パス。

server.servlet.session.tracking-modes

文字列

Cookie

使用するセッション追跡モードを指定します。指定できる値は url、cookie、 ですssl。複数の値をカンマで区切って指定できます。注: Tomcat にデプロイする場合、追跡モード設定が Tomcat が優先されるため、context.xml cookies=falseで を設定する必要があります。

server.servlet.session.timeout

文字列

30m

セッションタイムアウト期間を指定します。例: 60s (60 秒）、 4m (4 分）、 4h (4 時間）。

spring.session.store-type

文字列

なし

高可用性環境用のセッションキャッシュ。想定される値は、none または redis です。デフォルトは none です。

stopExecutionWhenProgNotFound

boolean

true

プログラムが見つからない場合に実行を停止するかどうかを指定します。true に設定すると、プログラムが見つからなかった場合に実行が中断されます。

forceHR

boolean

false

コンソール出力またはファイル出力のいずれかで、人間が読める形式の SYSPRINT を使用するかどうかを指定します。

rollbackOnRTE

boolean

false

ランタイムの例外時に暗黙的な実行ユニットトランザクションをロールバックするかどうかを指定します。

sctThreadLimit

long

5

スクリプトをトリガーするスレッドの上限。

dataSimplifier.onInvalidNumericData

文字列

拒否

無効な数値データをデコードしたときの対処方法。許可される値は、reject/toleratespaces/toleratespaceslowvalues/toleratemost です。デフォルトは reject です。

dataSimplifier.doubleFloatingType

文字列

IEEE_754

二重浮動小数点型は、浮動小数点数のエンコードとデコードに使用される形式です。使用できる値は IEEE_754 / HFP(16 進浮動小数点形式の場合) です。デフォルト値は IEEE_754 です。

 4.7.0

filesDirectory

文字列

入出力ファイルをバッチ処理するディレクトリ。

ims.messages.extendedSize

boolean

false

IMS メッセージに拡張したサイズを設定するかどうかを指定します。

defaultKeepExistingFiles

boolean

false

データセットのデフォルトの以前の値を設定するかどうかを指定します。

jics.db.ddlScriptLocation

文字列

Jics DDL スクリプトの場所。.sql スクリプトを使用して Jics データベーススキーマを開始できます。デフォルトでは空白。例えば、./jics/sql/jics.sql。

jics.db.schemaTestQueryLocation

文字列

jics スキーマ内のオブジェクト数 (存在する場合) を返す一意のクエリを含む必要がある sql ファイルの場所。

jics.db.dataScriptLocation

文字列

JICS データベースの初期化に使用される SQL スクリプトへのパスを定義します。ファイルとディレクトリのカンマ区切りリストを受け入れ、複数のスクリプトとフォルダを指定できます。

jics.db.dataTestQueryLocation

文字列

オブジェクト数を返すと予想される 1 つの sql クエリを含む sql スクリプトの場所 (例: jics プログラムテーブル内のレコード数のカウント)。カウントが 0 の場合、データベースは jics.db.dataScriptLocation スクリプトを使用してロードされます。それ以外の場合は、データベースのロードはスキップされます。

jics.data.dataJsonInitLocation

文字列

jics.xa.agent.timeout

数値

query.useConcatCondition

boolean

false

キー条件がキー連結によって構築されるかどうかを指定します。

system.qdecfmt

文字列

disposition.checkexistence

boolean

false

DISP SHR または OLD のデータセットのファイル存在確認を解除するかどうかを指定します。

useControlMVariable

boolean

false

変数置換に Control-M 仕様を使用するかどうかを指定します。

card.encoding

文字列

CP1145

カードのエンコーディング: useControlMVariable で使用します。

mapTransfo.prefixes

文字列

&,@,%%

controlM 変数を変換するときに使用するプレフィックスのリスト。それぞれをカンマで区切ります。

checkinputfilesize

boolean

false

ファイルサイズがレコードサイズの倍数である場合にチェックを解除するかどうかを指定します。

stepFailWhenAbend

boolean

true

ステップが失敗した場合や実行が完了した場合に、異常終了を発生させるかどうかを指定します。

returnHttp5xxResponseForFailedSyncJob

boolean

false

同期ジョブの実行に失敗した場合に HTTP レスポンスコード 500 シリーズを返すかどうかを指定します。

 4.10.0

bluesam.fileLoading.commitInterval

数値

100000

bluesam のコミット間隔。

uppercaseUserInput

boolean

true

ユーザー入力を大文字にする必要があるかどうかを指定します。

jhdb.lterm

文字列

IMS エミュレーションの場合に共通の論理ターミナル ID を強制的に使用できます。設定されていない場合は、sessionId が使用されます。

jhdb.identificationCardData

文字列

一部の「オペレータ ID カードデータ」を CARD パラメータで指定された MID フィールドにハードコードするために使用されます。デフォルトでは空白、入力制限なし。

encoding

文字列

ASCII

プロジェクトで使われているエンコードです (groovy ファイルには使用されていません)。有効なエンコーディング CP1047、IBM930、ASCII、UTF-8 などが必要です。

cl.configuration.context.encoding

文字列

CP297

CL ファイルのエンコーディング。有効なエンコーディング CP1047、IBM930、ASCII、UTF-8 などが必要です。デフォルト値は CP297 です

cl.zonedMode

文字列

EBCDIC_STRICT

制御言語 (CL) コマンドをエンコードまたはデコードするためのモード。許可される値は、EBCDIC_STRICT/EBCDIC_MODIFIED/AS400 です。

ims.programs

文字列

使用する IMS プログラムのリスト。各パラメータはセミコロン (;) で、各トランザクションはカンマ (,) で区切ります。以下に例を示します。PCP008,PCT008;PCP054,PCT054;PCP066,PCT066;PCP068,PCT068;

jhdb.configuration.context.encoding

文字列

CP297

JHDB (Java 階層型データベース) のエンコーディング。有効なエンコーディング文字列 CP1047、IBM930、ASCII、UTF-8 などが必要です。

jhdb.metadata.extrapath

文字列

file:./setup/

psbs フォルダと dbds フォルダ用に、ランタイム固有の追加のルートフォルダを指定する設定パラメータ。

jhdb.checkpointPersistence

文字列

なし

チェックポイント永続化モード。許可される値は、none/add/end です。新しいチェックポイントが作成されてレジストリに追加されたときに、チェックポイントを永続化するために add を使用します。サーバーのシャットダウン時にチェックポイントを永続化するために end を使用します。それ以外の値は永続化を無効にします。新しいチェックポイントがレジストリに追加されるたびに、既存のチェックポイントはすべてシリアル化され、ファイルは消去されることに注意してください。ファイル内の既存のデータへの追加ではありません。そのため、チェックポイントの数によっては、パフォーマンスに何らかの影響を与える可能性があります。

jhdb.checkpointPath

文字列

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

boolean

false

JCIS でコアスレッドのタイムアウトを許可するかどうかを指定します。これにより、0 以外のキューと組み合わせた場合でも動的な拡大と縮小が可能になります (最大プールサイズはキューがいっぱいになった場合のみ増加するため)。

jics.runUnitLauncherPool.enable

boolean

false

JICS で実行ユニットランチャープールを有効にするかどうかを指定します。

jics.runUnitLauncherPool.size

数値

20

JICS 内の実行ユニットランチャープールサイズ。

jics.runUnitLauncherPool.validationInterval

数値

1,000

プールのサイズを調整するタスクの実行間隔。

jics.runUnitLauncherPool.parallelism

数値

2

調整タスクの実行時にキューに欠落しているインスタンスを生成するために使用されるスレッドの数。

context.preconstruct.enable

boolean

false

プログラムコンテキストを構築する前にアクティブ化するかどうかを指定します。

context.preconstruct.frequencyInMillis

数値

100

プールのサイズを調整するタスクの実行間隔。

context.preconstruct.parallelism

数値

5

調整タスクの実行時にキューに欠落しているインスタンスを生成するために使用されるスレッドの数。

context.preconstruct.minInstances

数値

2

コンテキストが初めて必要になったときに作成されるインスタンスの数。

spring.aws.application.credentials

文字列

null

JICS の AWS 認証情報プロファイルファイルから認証情報をロードします。

jics.queues.sqs.region

文字列

eu-west-1

JICS で使用される Amazon Simple Queue Service の AWS リージョン。

jics.jcl.rt.encoding

文字列

CP037

専用 JICS キューに書き込まれた JCL スクリプトのエンコード。

jics.jcl.rt.queue

文字列

JICS

実行時に JCL スクリプトを行ごとに書き込むことができるキューの名前。

mq.queues.sqs.region

文字列

eu-west-3

AWS SQS MQ サービスの AWS リージョン。

quartz.scheduler.stand-by-if-error

boolean

false

ジョブスケジューラがスタンバイモードの場合にジョブの実行をトリガーするかどうかを指定します。「true」の場合、有効になってもジョブの実行はトリガーされません。

databaseStatistics

boolean

false

SQL ビルダーに統計情報の収集と表示を許可するかどうかを指定します。

dbDateFormat

文字列

yyyy-MM-dd

db ターゲットの日付形式。

dbTimeFormat

文字列

HH:mm:ss

db ターゲット時間形式。

dbTimestampFormat

文字列

yyyy-MM-dd HH:mm:ss.SSSSSS

db ターゲットのタイムスタンプ形式。

dateTimeFormat

文字列

ISO

dateTimeFormat は、データベースの日付/時刻/タイムスタンプタイプをデータ簡略化エンティティに渡す方法を説明しています。許可される値は、ISO/EUR/EUR/USA/LOCAL です。

localDateFormat

文字列

ローカル日付形式のリスト。各形式は \ で区切ります。

localTimeFormat

文字列

ローカルの時刻形式のリスト。各形式は \ で区切ります

localTimestampFormat

文字列

ローカルのタイムスタンプ形式のリスト。各形式は \ で区切ります。

pgmDateFormat

文字列

yyyy-MM-dd

日付時刻形式

pgmTimeFormat

文字列

HH.mm.ss

pgm (プログラム) の実行に使用される時刻形式。

pgmTimestampFormat

文字列

yyyy-MM-dd-HH.mm.ss.SSSSSS

タイムスタンプ形式。

cacheMetadata

boolean

true

データベースメタデータをキャッシュするかどうかを指定します。

forceDisableSQLTrimStringType

boolean

false

すべての sql 文字列パラメータのトリミングを無効にするかどうかを指定します。

fetchSize

数値

カーソルの fetchSize 値。ロード/アンロードユーティリティでチャンクを使用してデータを取得するときに使用します。

check-groovy-file

boolean

true

登録する前に groovy ファイルの内容をチェックするかどうかを指定します。

qtemp.uuid.length

数値

9

QTEMP の固有の ID の長さ。

qtemp.dblog

boolean

false

QTEMP データベースログ記録を有効にするかどうか。

qtemp.cleanup.threshold.hours

数値

0

qtemp.dblog をいつ有効にするかを指定します。DB パーティションの有効期間 (時間単位)。

invalidDataTolerence

boolean

true

パック型に無効なデータを許可するかどうかを指定します。

program.timeout

数値

-1

プログラム/トランザクション実行のタイムアウトを秒単位で指定します。この時間が経過すると、システムはプログラムを中断します。

gapwalk.line.separator

文字列

null

gapwalk の行区切りタイプを指定します。WIN (CRLF)/UNIX (LF)/LINUX (LF) を指定できます。その他の値は無視され、System line.sepatator プロパティが使用されます。

enableActivePgmIdCache

boolean

false

アクティブなプログラム ID ローカルキャッシュを有効にするかどうかを指定します。JICS リソースはプログラムとユーザー間で共有できるため、この機能は慎重に使用してください。これらのリソースは、任意の管理者が外部から変更できるため、配置されたローカルキャッシュが無効になる可能性があります。

mq.queues.default.syncpoint

boolean

false

MQPMO_SYNCPOINT も MQPMO_NO_SYNCPOINT も設定されていない場合の MQ PUT コマンドのデフォルトの動作を指定します。true に設定すると MQPMO_SYNCPOINT として動作し、PUT コマンド中にメッセージが直接コミットされません。false に設定すると、MQPMO_NO_SYNCPOINT として動作し、PUT コマンド中にメッセージが直接コミットされます。

dataSimplifier.byteRangeBoundsCheck

boolean

false

true に設定すると、ByteRange が不適切な値で作成されなくなります。デフォルトは False です。

file.stdoutIntoLogger

boolean

false

デフォルトの SYSPRINT および SYSPUNCH ファイルで、デフォルトのシステム出力ストリームではなく、ロガーへの書き込みを有効にするかどうかを指定します。

tempFilesDirectory

文字列

null

生成される一時ファイルのフォルダの場所の名前を指定します。

cleanTempFilesDirectoryAtStartup

boolean

true

アプリケーションの起動時に一時ファイルフォルダの内容を消去するかどうかを指定します。

tempFolderPattern

文字列

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

boolean

false

既に開いているカーソルを開くときに「SQLCODE エラー 502」の生成を有効にするかどうかを指定します。

jics.spool.smtp.hostname

文字列

null

SMTP サーバーホストを指定します。例: smtp.xxx.com

jics.spool.smtp.port

文字列

null

SMTP サーバーポートを指定します。例: 25

jics.spool.smtp.password

文字列

null

SMTP サーバーのログインパスワードを指定します。

jics.spool.smtp.username

文字列

null

SMTP サーバーのユーザー名を指定します。

jics.spool.smtp.debug

boolean

false

SMTP サーバーのデバッグモードを指定します。

gapwalk-application.security

文字列

disabled

グローバルセキュリティ設定 (XSS、CORS、CSRF、OAUTH 認証...) を切り替えます。指定できる値は disabled と enabled です。

gapwalk-application.identity

文字列

null

グローバル認証方法。推奨値は oauth です。指定できる値は json と oauth です。このプロパティは、gapwalk-application.security が enabled の場合に必須です。

gapwalk-application.security.issuerUri

文字列

null

ID プロバイダー (IdP) の発行者の URI です。このプロパティは、gapwalk-application.identity が oauth の場合に必須です。

gapwalk-application.security.allowedOrigins

String[]

null

許可するオリジンのリスト。このオプションでは gapwalk-application.identity を oauth に設定する必要があります。

gdgDirectoryPath

文字列

output/gdg

GDG ディレクトリパスは、gdg ファイルが保存されているディレクトリです。

 4.6.0

gapwalk-application.security.customAllowedHeaders

String[]

null

許可するカスタムヘッダーのリスト。このオプションでは gapwalk-application.identity を oauth に設定する必要があります。

 4.8.0

listOfMDCUrlParams

文字列

null

Groovy バッチスクリプトの実行時に MDC に追加する URL パラメータのリスト。

gapwalk-application.security.claimGroupName

文字列

cognito:groups

ユーザーが属するすべてのグループのリストを含むクレーム属性。Amazon Cognito の場合は cognito:groups、外部 IdP の場合は他の文字列を指定します。

gapwalk-application.security.userAttributeName

文字列

username

ユーザーリクエストを識別するために使用されるクレーム属性名。Amazon Cognito の場合は username、Keycloak の場合は preferred_username、外部 IdP の場合はその他の文字列を指定します。

gapwalk-application.defaultSuperAdminUserName

文字列

sadmin

gapwalk-application.security が無効である場合、デフォルトのローカルスーパーユーザー名を指定します。

gapwalk-application.defaultSuperAdminUserPwd

文字列

sadmin

gapwalk-application.security が無効である場合、デフォルトのローカルスーパーユーザーパスワードを指定します。

gapwalk-application.security.filterURIs

文字列

disabled

URI のフィルター設定を切り替えます。指定できる値は disabled と enabled です。

gapwalk-application.security.blockedURIs

String[]

null

ブロックする URI のリスト。このプロパティは、gapwalk-application.security.filterURIs が enabled の場合に必須です。

jics.redis.*

サポートされる Redis プロパティ

JICS Redis サーバー接続ファクトリの設定プロパティを指定します。「サポートされる Redis プロパティ」を参照してください。

spring.aws.client.jics.redis.secret

文字列

null

JICS Redis サーバー接続ファクトリの認証情報シークレット ARN を指定します。「AWS Blu Age ランタイムシークレット」を参照してください。

jcl.checkpoint.enabled

boolean

false

JCL チェックポイントメカニズムを有効にしてジョブの再起動を許可するかどうかを指定します。JCL チェックポイントは、各ステップまたはメインプログラム呼び出しの開始時に作成され、メモリ内レジストリに保存されます。永続化プロバイダーが定義されている場合、すべてのステップレベルのチェックポイントはジョブの最後に保持されます。

jcl.checkpoint.expireTimeout

数値

-1

永続化プロバイダーまたはインメモリレジストリに JCL チェックポイントを保持する期間を指定します。

jcl.checkpoint.expireTimeoutUnit

文字列

秒

jcl.checkpoint.expireTimeout プロパティの時間単位を指定します。サポートされている列挙定数値: java.util.concurrent.TimeUnit。

jcl.checkpoint.provider

文字列

null

JCL チェックポイントメカニズムの永続化プロバイダーを指定します。値は redis を指定できます。

jcl.checkpoint.redis.*

サポートされる Redis プロパティ

JCL チェックポイントメカニズムの REDIS 永続化プロバイダーの設定プロパティを指定します。「サポートされる Redis プロパティ」を参照してください。

job.default.encoding

文字列

CP1047

ジョブレベルのストレージの初期化に使用されるデフォルトのエンコードを指定します。例えば、BLU4IV アプリケーションのスイッチは、このエンコーディングを使用してゼロに初期化します。

 4.9.0

spring.aws.client.jcl.checkpoint.redis.secret

文字列

null

JCL チェックポイントメカニズムの Redis 永続化プロバイダーの認証情報シークレット ARN を指定します。「AWS Blu Age ランタイムシークレット」を参照してください。

gapwalk.ssl.enabled

boolean

false

JVM システムプロパティに、アプリケーション起動時にまだ設定されていないものが見つかった場合は、次の gapwalk.ssl.* プロパティを設定することを示します。

gapwalk.ssl.trustStore

文字列

null

設定システムプロパティ javax.net.ssl.trustStore が、アプリケーション開始時にまだ設定されていない場合に設定する値を指定します。

gapwalk.ssl.trustStorePassword

文字列

null

設定システムプロパティ javax.net.ssl.trustStorePassword が、アプリケーション開始時にまだ設定されていない場合に設定する値を指定します。または、「」で説明されているように、 AWS シークレットを使用することを強くお勧めしますSSL パスワード設定のシークレットマネージャー。

gapwalk.ssl.trustStoreType

文字列

null

設定システムプロパティ javax.net.ssl.trustStoreType が、アプリケーション開始時にまだ設定されていない場合に設定する値を指定します。

gapwalk.ssl.keyStore

文字列

null

設定システムプロパティ javax.net.ssl.keyStore が、アプリケーション開始時にまだ設定されていない場合に設定する値を指定します。

gapwalk.ssl.keyStorePassword

文字列

null

設定システムプロパティ javax.net.ssl.keyStorePassword が、アプリケーション開始時にまだ設定されていない場合に設定する値を指定します。または、「」で説明されているように、 AWS シークレットを使用することを強くお勧めしますSSL パスワード設定のシークレットマネージャー。

mq.queues

文字列

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

文字列

null

IBMMQ キューマネージャー名。

mq.queues.jmsMQQueueManagers[N].jmsMQAppName

文字列

null

IBMMQ アプリケーション名。

mq.queues.jmsMQQueueManagers[N].jmsMQChannel

文字列

null

IBMMQ チャネル名。

mq.queues.jmsMQQueueManagers[N].jmsMQHost

文字列

null

IBMMQ ホスト名。

mq.queues.jmsMQQueueManagers[N].jmsMQPort

数値

null

IBMMQ ポート。

mq.queues.jmsMQQueueManagers[N].jmsMQUserid

文字列

null

IBMMQ ユーザー名。

mq.queues.jmsMQQueueManagers[N].jmsMQPassword

文字列

null

IBMMQ ユーザーパスワード。または、「」で説明されているように、 AWS シークレットを使用することを強くお勧めしますIBM MQ パスワード設定のシークレットマネージャー。

mq.queues.jmsMQQueueManagers[N].jmsMQMaxPoolSize

数値

0

IBMMQ 最大プールサイズ。0 にすると、物理的な接続が数に制限なく有効になります。

mq.queues.jmsMQQueueManagers[N].jmsMQSSLCipher

文字列

null

IBMMQ SSL 暗号スイート。例えば "*TLS12ORHIGHER" などを指定します。公式ドキュメント、「IBM MQ classes for JMS での TLS CipherSpecs および CipherSuites」 を参照してください。

mq.queues.non.jms.client

boolean

false

にメッセージを送信するターゲットクライアントが非 JMS かどうかを示します。ネイティブ MQ 形式は非 JMS クライアントに使用され、RFH2 形式は JMS に使用されます。

 4.5.0

mq.queues.rabbitMQHost

文字列

null

Rabbit MQ のホスト名。

mq.queues.rabbitMQVirtualHost

文字列

null

Rabbit MQ の仮想ホスト名。

mq.queues.rabbitMQPort

数値

null

Rabbit MQ のポート。

mq.queues.rabbitMQUsername

文字列

null

Rabbit MQ のユーザー。

mq.queues.rabbitMQPassword

文字列

null

Rabbit MQ のパスワード。

mf.runtime.switch.N

boolean

true

MF 自然の行連続ファイルの null 挿入を有効にします。

 4.4.0

mf.runtime.switch.T

boolean

false

MF 自然の行連続ファイルにタブ文字を挿入できるようにします。

 4.4.0

gapwalk.database.support.useSavePointToRestoreFail

boolean

false

挿入クエリでセーブポイントを使用して、障害発生時のトランザクション復旧を有効にします。このプロパティを有効にすると、データベースのパフォーマンスに影響する可能性があります。クエリquery-to-databaseマッピング設定を使用して、特定のクエリに対してこの設定を上書きできます。

 4.6.0

xmlGeneratorPrettyFormat

boolean

true

XmlGenerator クラス内で生成された XML 出力のフォーマットスタイルを決定します。に設定するとtrue、XML 出力は人間が読み取り可能なインデント構造 (プリティプリント) でフォーマットされます。に設定するとfalse、出力は空白を追加せずにコンパクトな単一行形式になります。

 4.8.0

gapwalk.database.metadata.schema-inclusion.enabled

boolean

false

アプリケーションによってキャッシュされるデータベーススキーマを制御するメモリ最適化機能を有効にします。この設定は、スキーマメタデータをインテリジェントに管理することで、システムの安定性を維持しながらメモリフットプリントを削減するのに役立ちます。これには、適切なオペレーションに必要な一般的なデータベースシステムスキーマが自動的に含まれます。

 4.9.0

gapwalk.database.metadata.schema-inclusion.schemas.global

list<String>

null

キャッシュするスキーマのリストを定義します。

 4.9.0

sqlConnectionAutoCommitEnabled

boolean

true

接続リセットオペレーション中に現在の接続の自動コミットを有効にします。有効にすると、XA 以外の環境で新しいデータソース接続に切り替える前に、 が自動的に現在の接続をコミットし、接続の不安定さを防ぎます。無効にすると、 はリセットオペレーション中に発生する可能性のある接続の問題に関する警告メッセージをログに記録します。

 4.10.0

gapwalk.post.script.mediatype.json

boolean

false

ブール変数の値に応じてapplication/json、エンドポイントからのレスポンスのContent-Typeヘッダーを /post/script/{scriptId:.+}に設定するかどうかを指定します。false に設定すると、デフォルトは ですtext/plain; charset=utf-8。

startDefaultJob

文字列

false

最初のトランザクションでデフォルトのジョブを初期化するかどうかを指定します。

gapwalk.cobol.cblqda.enabled

boolean

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

文字列

jdbc/primary

JNDI を使用する場合の、プライマリデータソースの JNDI 名 (Java Naming And Directory Interface)。

primary.datasource -driver-class-name -url -username -password

サブキー付きの標準 spring データソース

JNDI を使用していない場合、アプリケーションデータベースの接続情報が含まれます。モダナイズされたアプリケーションの YAML ファイルと同じ設定にする必要があります。

または、「」で説明されているように、 AWS シークレットの使用を強くお勧めしますクライアントデータベース。

encoding

文字列

ASCII

ユーティリティプログラムで使用されるエンコーディング。有効なエンコード CP1047、IBM930、ASCII、 が必要ですUTF-8。

sysPunchEncoding

文字列

ASCII

syspunch エンコーディング文字セット。有効なエンコーディングCP1047、IBM930、ASCII、が必要ですUTF-8。

systin.encoding

文字列

ASCII

SYSTIN ファイルデータセットのエンコード文字セット。有効なエンコーディングCP1047、IBM930、ASCII、が必要ですUTF-8。

 4.5.0

zonedMode

文字列

EBCDIC_STRICT

ゾーンデータ型をエンコードまたはデコードするためのモード。許可される値は、EBCDIC_STRICT/EBCDIC_MODIFIED/AS400 です。

idcams.encoding.forced

文字列

IDCAMS ユーティリティプログラムで使用されるエンコード。有効なエンコード CP1047、IBM930、ASCII、 が必要ですUTF-8。

 4.4.0

unload.chunkSize

数値

0

アンロードユーティリティに使用されるチャンクサイズ。

unload.computeRecordSizeIfNull

boolean

false

指定しない場合、レコードサイズを計算するかどうかを決定します。指定した場合、値は変更されません。

unload.sqlCodePointShift

数値

0

アンロードユーティリティの SQL コードポイントシフト。文字シフト処理を実行します。DB2 のターゲットデータベースが PostgreSQL の場合に必要です。

unload.columnFiller

文字列

スペース

アンロードユーティリティの列フィラー。

unload.varCharIsNull

boolean

false

INFTILB プログラムでこのパラメータを使用します。このパラメータを true に設定すると、空白 (スペース) の値を持つ NULL が許容されないフィールドはすべて空の文字列を返します。

unload.useDatabaseConfiguration

boolean

false

アンロードユーティリティで application-main.yml の日付設定と時刻設定のどちらを使用するかを指定します。

unload.format.date

文字列

MM/dd/yyyy

unload.useDatabaseConfiguration が有効な場合、アンロードユーティリティで使用する日付形式です。

unload.format.time

文字列

HH.mm.ss

unload.useDatabaseConfiguration が有効な場合、アンロードユーティリティで使用する時間形式。

unload.format.timestamp

文字列

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

boolean

false

アンロード出力ファイルに NULL インジケータを書き出すかどうかを指定します。

unload.bmc.useInto

boolean

false

アンロードユーティリティの INTO bmc コントロールキーワードを処理するかどうかを指定します。

unload.fetchSize

数値

0

アンロードユーティリティでカーソルを処理する際にフェッチサイズを調整できます。

unload.noPad

boolean

true

可変長文字 (VARCHAR) フィールドは、最大長までパディングなしでアンロードされることを示します。

 4.5.0

treatLargeNumberAsInteger

boolean

false

大きな数値を Integer として扱うかどうかを指定します。デフォルトでは、BigDecimal のように扱われます。

load.batchSize

数値

0

ロードユーティリティのバッチサイズ。

load.format.localDate

文字列

dd.MM.yyyy\dd/MM/yyyy\yyyy-MM-dd

使用するロードユーティリティのローカルの日付形式。

load.format.localTime

文字列

HH:mm:ss\HH.mm.ss

使用するロードユーティリティのローカルの時刻形式。

load.format.dbDate

文字列

yyyy-MM-dd

使用するロードユーティリティデータベース形式。

load.format.dbTime

文字列

HH:mm:ss

ロードユーティリティデータベースの使用時間。

load.sqlCodePointShift

数値

0s

ロードユーティリティの SQL コードポイントシフト。文字シフト処理を実行します。DB2 のターゲットデータベースが PostgreSQL の場合に必要です。

load.applyRollback

boolean

false

データベースへのデータの読み込み中にエラーが発生した場合にテーブルの変更をロールバックする場合は、このパラメータを true に設定します。

forcedDate

文字列

指定された日付がある場合は、日付を強制的にその日付に合わせます。

frozenDate

boolean

true

日付を固定するかどうかを指定します。forcedDate も設定されている場合にのみ適用されます。

jcl.type

文字列

mvs

.jcl ファイルタイプ。許可される値は、jcl/vse です。IDCAMS ユーティリティの PRINT/REPRO コマンドは、vse jcl 以外のファイルが空の場合、4 を返します。

hasGraphic

boolean

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

文字列

jdbc/primary

JNDI を使用する場合の、プライマリデータソースの JNDI 名 (Java Naming And Directory Interface)。

primary.datasource + -driver-class-name + -url + -username + -password

サブキー付きの標準 spring データソース

JNDI を使用していない場合、アプリケーションデータベースの接続情報が含まれます。モダナイズされたアプリケーションの YAML ファイルと同じ設定にする必要があります。

または、「」で説明されているように、 AWS シークレットの使用を強くお勧めしますクライアントデータベース。

encoding

文字列

ASCII

ユーティリティプログラムで使用されるエンコーディング。有効なエンコーディング CP1047、IBM930、ASCII、UTF-8 などが必要です。

zonedMode

文字列

EBCDIC_STRICT

ゾーンデータ型をエンコードまたはデコードするためのモード。許可される値は、EBCDIC_STRICT/EBCDIC_MODIFIED/AS400 です。

commands-off

文字列

無効にするコマンドのリスト。カンマで区切られています。許可される値は、PGM_BASIC、RCVMSG、SNDRCVF、CHGVAR、QCLRDTAQ、RTVJOBA、ADDLFM、ADDPFM、RCVF、OVRDBF、DLTOVR、CPYF、SNDDTAQ です。既存のプログラムを無効化または上書きする場合に役立ちます。 PGM_BASICは、デバッグ用に設計された特定の AWS Blu Age ランタイムプログラムです。

forcedDate

文字列

指定された日付がある場合は、日付を強制的にその日付に合わせます。

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

文字列

JHDB (Java 階層型データベース) のエンコーディング。有効なエンコーディング文字列 CP1047、IBM930、ASCII、UTF-8 などが必要です。

jhdb.checkpointPersistence

文字列

なし

チェックポイント永続化モード。許可される値は、none/add/end です。新しいチェックポイントが作成されてレジストリに追加されたときに、チェックポイントを永続化するために add を使用します。サーバーのシャットダウン時にチェックポイントを永続化するために end を使用します。それ以外の値は永続化を無効にします。新しいチェックポイントがレジストリに追加されるたびに、既存のチェックポイントはすべてシリアル化され、ファイルは消去されることに注意してください。ファイル内の既存のデータへの追加ではありません。そのため、チェックポイントの数によっては、パフォーマンスに何らかの影響を与える可能性があります。

jhdb.keepParent

boolean

false

IMS 挿入中に _parent と _logicalparent を保持するかどうか。true に設定すると、IMS ISRT 呼び出しはデータベース列に _parent と _logicalparent を挿入します。

jhdb.query.timeout

int

-1

jhdb トランザクション実行のタイムアウトを秒単位で指定します。この時間が経過すると、システムはプログラムを中断します。値が -1 (デフォルト) の場合、タイムアウトは設定されません。

jhdb.backend

文字列

Jhdb バックエンドタイプ。予想される値は です rdbms

jhdb.transaction.scope.programs

文字列

トランザクション全体として宣言されるプログラムのリスト。各プログラムはカンマ () で区切ります,。以下に例を示します。PCP008,PCT008

metadata.datasource + -driver-class-name + -url + -username + -password + -type

文字列

サブキー付きの標準 spring データソース

psbs、dbds、接続など、jhdb データベースのメタデータ情報が含まれます。または、 AWS シークレットを使用することを強くお勧めします。

クライアントアプリケーションで使用可能なプロパティ

モダナイズされたアプリケーションでは、クライアント Spring アプリケーションの特定のプロパティ設定が必要になる場合があります。これらのプロパティは、ランタイム JAR ファイルでパッケージ化されたクラスから Bean を初期化します。アプリケーションの生成中にプロファイル値が設定される application-profile.yaml ファイルでは、これらのプロパティを設定できます。次の表に、Gapwalk ランタイムにパッケージ化されたクラスの Bean を使用するクライアントウェブアプリケーションの設定に使用できるキー/値パラメータを示します。

キー タイプ デフォルト値 説明 リリースバージョン

blu4iv.dtaara.library.disable

boolean

false

データエリアオペレーションのコンテキストでのライブラリの使用を制御します。true に設定すると、データエリアオペレーションではライブラリの使用が無効になりますが、QTemp の使用には影響しません。false に設定すると、データエリアに対して CRUD オペレーションを実行するときにライブラリが考慮されます。

 4.5.0

クライアントアプリケーションで使用可能なプロパティ

モダナイズされたアプリケーションでは、クライアント Spring アプリケーションの特定のプロパティ設定が必要になる場合があります。これらのプロパティは、ランタイム JAR ファイルでパッケージ化されたクラスから Bean を初期化します。アプリケーションの生成中にプロファイル値が設定される application-profile.yaml ファイルでは、これらのプロパティを設定できます。次の表に、Gapwalk ランタイムにパッケージ化されたクラスの Bean を使用するクライアントウェブアプリケーションの設定に使用できるキー/値パラメータを示します。

キー タイプ デフォルト値 説明 リリースバージョン

blu4iv.dtaara.library.disable

boolean

false

データエリアオペレーションのコンテキストでのライブラリの使用を制御します。true に設定すると、データエリアオペレーションではライブラリの使用が無効になりますが、QTemp の使用には影響しません。false に設定すると、データエリアに対して CRUD オペレーションを実行するときにライブラリが考慮されます。

 4.5.0

blu4iv.dao.data.max

数値

10

入力 DAO オペレーションの内部キャッシュのサイズ。このキャッシュはプログラムレベル (単一インスタンス) に存在します。

 4.9.0

blu4iv.dao.sort.function

文字列

blu4iv データベースのソート関数名。

 4.9.0

blu4iv.dao.support

文字列

JPA

使用するデータアクセス実装 (JPA または JDBC) を指定します。

 4.9.0

blu4iv.dao.cache.enabled

boolean

false

インメモリキャッシュを有効にします。

 4.8.0

blu4iv.dao.cache.enabledHits

boolean

false

キャッシュへのリクエスト数の追跡を追加します。

 4.8.0

blu4iv.dao.cache.initMaxResults

数値

10000

キャッシュのサイズ。

 4.8.0

blu4iv.dao.cache.entries.fileIds

文字列

キャッシュするデータベーステーブルのリスト。

 4.8.0

blu4iv.dao.cache.entries.programIds

文字列

指定されたテーブルに対してキャッシュをアクティブ化するプログラムの識別子。キャッシュは、実行スタック内のすべてのサブプログラムで使用できます。

 4.8.0

blu4iv.librarylist.enabled

boolean

false

ライブラリリストを使用してファイルライブラリを解決します。

 4.10.0

blu4iv.librarylist.libraries

文字列

左から右に順序付けられたライブラリの初期リスト。

 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

boolean

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 アクセスログ専用のログファイルを設定するには、ログバック設定に以下を追加します。

<!-- File appender -->
<appender name="ApiAccessFile" class="ch.qos.logback.core.FileAppender">
    <file>logs/main/main-api-access.log</file>
    <immediateFlush>true</immediateFlush>
    <encoder>
        <pattern>%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</pattern>
    </encoder>
</appender>

<logger name="api.access" level="info" additivity="false">
    <appender-ref ref="ApiAccessFile" />
    <appender-ref ref="CONSOLE" />
</logger>

サンプルログ出力：

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