启用 AWS Blu Age 运行时的属性 - AWS 大型机现代化
YML 表示法快速入门/用例主应用程序的可用属性可选 Web 应用程序的可用属性客户端应用程序的可用属性

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

启用 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 :
  remote : false
  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

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

----

  • 在 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 实用程序中提供空字节指示符值

    
# 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

路径

classpath:logback-main.xml

用于引用 logback 配置文件的标准密钥。其他标准日志记录密钥也可用。

spring.jta.enabled

布尔值

false

标准密钥。如果数据源支持模式不是 static-xa，则必须禁用 Spring JTA 事务自动配置。

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

带子键的标准 Spring 数据源

包含 Jics 数据库的连接信息。或者，强烈建议使用 AWS 密钥，如JICS 数据库中所述。

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

带子键的标准 Spring 数据源

包含 Blusam 数据库的连接信息。或者，强烈建议使用 AWS 密钥，如Blusam 数据库中所述。

bluesam.disabled

布尔值

false

是否完全禁用 Blusam。

bluesam.cache

字符串

如果未设置，则不会使用 Blusam 缓存。可能的值（缓存实现）为 cache 和 redis（Redis 缓存属性）。

bluesam.maxBluesamDisablingThreadpoolSize

数字

10

指定用于禁用 bluesam 数据集进行批处理的最大线程池大小。

 4.5.0

bluesam.bluesamStatusPollingInterval

数字

1000

指定轮询 bluesam 状态以检查在线活动时，每次迭代之间等待的时间（以毫秒为单位）。

 4.5.0

bluesam.maxBluesamStatusPollingRetry

数字

3

指定轮询 bluesam 状态失败时的最大重试次数。

 4.5.0

bluesam.checkBluesamStatus

布尔值

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

字符串

强制将日期（如果有）更改为提供的日期。

frozenDate

布尔值

true

指定是否冻结日期。仅在设置了 forcedDate 时适用。

externalSort.threshold

数据大小（例如：12 MB）

排序阈值：何时切换到外部（合并）排序。

blockSizeDefault

数字

32760

用于 BDW 字节的默认区块大小。

jics.parameters.datform

字符串

MMDDYY

日期形式。

jics.initList

字符串

初始化 JICS 列表，用逗号分隔。指定时，该键定义列表中以逗号分隔的名称，以便在 Apache Tomcat 启动时在 CICS 列表中激活。示例值：$UUU,DFH$IVPL,PEZ1。这将级联到这些列表中包含的组及其基础资源定义，之后会对运行时可见。默认为空。

jics.parameters.applid

字符串

VELOCITY

用于标识 JICS 中的应用程序的 appid（至少 4 个字符，无最大长度限制）。

jics.parameters.sysid

字符串

CICS

系统标识 (SYSID)。

jics.parameters.eibtrmid

字符串

TERM

终端标识符（最多 4 个字符，最少 1 个字符）。

jics.parameters.userid

字符串

用户 ID（最多 8 个字符，无最小字符数限制）。如果未提供任何值（默认为空白），则使用 HTTP 会话 ID 作为用户 ID。

jics.parameters.username

字符串

MYUSERNAME

用户 ID（最多 10 个字符，最少 1 个字符）。

jics.parameters.netname

字符串

MYNETNAME

网络名称（最多 8 个字符，最少 1 个字符）。

jics.parameters.opid

字符串

XXX

3 个字符的操作员标识。

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 队列 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 时可能遇到的控制字符的代码点进行转换。例如，您可以指定 384 来匹配 Unicode 字符 \u0180。

sqlIntegerOverflowAllowed

布尔值

false

指定是否允许 SQL 整数溢出，即是否允许在主机变量中放置更大的值。

database.cursor.overflow.allowed

布尔值

true

指定是否允许游标溢出。设置为 true 时，无论游标位置如何，均可在游标处执行下一次调用。设置为 false 时，会在游标处执行下一次调用之前检查游标是否位于最后一个位置。仅在游标可滚动（敏感或不敏感）的情况下将其启用。

reportOutputPath

字符串

/reports

报告输出路径。

spring.session.store-type

字符串

none

高可用性环境的会话缓存。可能的值为 none 或 redis。默认值为 none。

stopExecutionWhenProgNotFound

布尔值

true

指定在找不到程序时是否停止运行。如果设置为 true，则在找不到程序时中断运行。

forceHR

布尔值

false

指定是否在控制台或文件输出上使用人类可读的 SYSPRINT。

rollbackOnRTE

布尔值

false

指定是否在运行时异常时回滚隐式运行单元事务。

sctThreadLimit

长整数

5

用于触发脚本的线程限值。

dataSimplifier.onInvalidNumericData

字符串

reject

解码无效的数字数据时如何应对。允许的值包括：reject、toleratespaces、toleratespaceslowvalues、toleratemost。默认值为 reject。

filesDirectory

字符串

批处理输入/输出文件的目录。

ims.messages.extendedSize

布尔值

false

指定是否在 IMS 消息上设置扩展的大小。

defaultKeepExistingFiles

布尔值

false

指定是否设置数据集的默认先前值。

jics.db.ddlScriptLocation

字符串

Jics DDL 脚本位置。支持您使用 .sql 脚本启动 Jics 数据库架构。默认情况下为空。例如 ./jics/sql/jics.sql。

jics.db.schemaTestQueryLocation

字符串

sql 文件的位置，该文件应包含唯一查询，且该查询返回 jics 架构中对象的数量（如果有）。

jics.db.dataScriptLocation

字符串

定义用于初始化 JICS 数据库的 SQL 脚本的路径。接受以逗号分隔的文件和目录列表，允许指定多个脚本和文件夹。

jics.db.dataTestQueryLocation

字符串

包含单个 sql 查询的 sql 脚本的位置，该查询应返回对象计数（例如：计算 jics 程序表中的记录数）。如果计数等于 0，则将使用 jics.db.dataScriptLocation 脚本加载数据库，否则将跳过数据库加载。

jics.data.dataJsonInitLocation

字符串

jics.xa.agent.timeout

数字

query.useConcatCondition

布尔值

false

指定键条件是否通过串联键来构建。

system.qdecfmt

字符串

disposition.checkexistence

布尔值

false

指定是否针对配置 DISP SHR 或 OLD 的数据集检查文件是否存在。

useControlMVariable

布尔值

false

指定是否使用 control-M 规范进行变量替换。

card.encoding

字符串

CP1145

卡片编码：与 useControlMVariable 一起使用。

mapTransfo.prefixes

字符串

&,@,%%

转换 controlM 变量时要使用的前缀列表。每一个前缀均用逗号隔开。

checkinputfilesize

布尔值

false

指定在文件大小为记录大小倍数的情况下是否要进行检查。

stepFailWhenAbend

布尔值

true

指定在步骤失败或完成执行时是否引发异常中止。

bluesam.fileLoading.commitInterval

数字

100000

bluesam 提交间隔。

uppercaseUserInput

布尔值

true

指定用户输入是否必须采用大写形式。

jhdb.lterm

字符串

允许您在进行 IMS 仿真的情况下强制使用通用的逻辑终端 ID。如果未设置，则使用会话 ID。

jhdb.identificationCardData

字符串

用于将某些“操作员识别卡数据”硬编码到 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

Java 分层数据库 (JHDB) 编码。预期的有效编码字符串包含 CP1047、IBM930、ASCII、UTF-8...

jhdb.metadata.extrapath

字符串

file:./setup/

用于为 psbs 和 dbds 文件夹指定一个特定于运行时的额外根文件夹的配置参数。

jhdb.checkpointPersistence

字符串

none

检查点持久性模式。允许的值包括：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

布尔值

true

指定是否在 RDBMS 的分层导航中启用数据库前缀。

jhdb.query.limitJoinUsage

布尔值

true

指定是否在 RDBMS 图形上使用限制联接使用参数。

taskExecutor.corePoolSize

数字

5

当通过 groovy 脚本启动终端中的事务时，会创建一个新线程。可以使用此参数设置核心池大小。

taskExecutor.maxPoolSize

数字

10

当通过 groovy 脚本启动终端中的事务时，会创建一个新线程。使用此参数设置池的最大大小（并行线程的最大数量）。

taskExecutor.queueCapacity

数字

50

当通过 groovy 脚本启动终端中的事务时，会创建一个新线程。使用此参数设置队列大小。（= 达到 taskExecutor.maxPoolSize 时待处理事务的最大数量）

taskExecutor.allowCoreThreadTimeOut

布尔值

false

指定是否允许核心线程在 JCIS 中超时。即使与非零队列结合使用，也可以实现动态增长和缩小（因为只有在队列已满后，池最大大小才会增长）。

jics.runUnitLauncherPool.enable

布尔值

false

指定是否在 JICS 中激活运行单元启动器池。

jics.runUnitLauncherPool.size

数字

20

JICS 中的运行单元启动器池大小。

jics.runUnitLauncherPool.validationInterval

数字

1000

每次运行调整池大小的任务之间的间隔。

jics.runUnitLauncherPool.parallelism

数字

2

当调整任务运行时，用于在队列中生成缺失实例的线程数。

context.preconstruct.enable

布尔值

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 简单队列服务的 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

布尔值

false

指定当作业调度程序处于待机模式时是否触发作业执行。如果设置为 true，则启用时不会触发作业执行。

databaseStatistics

布尔值

false

指定是否允许 SQL 生成器收集和显示统计信息。

dbDateFormat

字符串

yyyy-MM-dd

数据库目标日期格式。

dbTimeFormat

字符串

HH:mm:ss

数据库目标时间格式。

dbTimestampFormat

字符串

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

数据库目标时间戳格式。

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

布尔值

true

指定是否缓存数据库元数据。

forceDisableSQLTrimStringType

布尔值

false

指定是否禁用所有 sql 字符串参数的 TRIM。

fetchSize

数字

游标的 fetchSize 值。在通过加载/卸载 utils 使用区块获取数据时使用。

check-groovy-file

布尔值

true

指定是否在注册前检查 groovy 文件内容。

qtemp.uuid.length

数字

9

QTEMP 的唯一 ID 长度。

qtemp.dblog

布尔值

false

是否启用 QTEMP 数据库日志记录。

qtemp.cleanup.threshold.hours

数字

0

指定何时启用 qtemp.dblog。数据库分区的生命周期（以小时为单位）。

sort.function

字符串

blu4iv 数据库的排序函数名称。

invalidDataTolerence

布尔值

true

指定打包类型是否支持无效数据。

program.timeout

数字

–1

指定任何程序/事务执行的超时时间（以秒为单位）。在这段时间之后，系统将尝试中断程序。

gapwalk.line.separator

字符串

null

在 gapwalk 中指定行分隔符类型。支持的值为 WIN (CRLF)/UNIX (LF)/LINUX (LF)。其他值将被忽略，并使用 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 时，它可确保使用不正确的值创建 no ByteRange 。默认值为 false。

file.stdoutIntoLogger

布尔值

false

指定是否启用写入记录器，而不是 SYSPRINT 和 SYSPUNCH 文件中的默认系统输出流。

tempFilesDirectory

字符串

null

指定生成的临时文件所在文件夹位置的名称。

cleanTempFilesDirectoryAtStartup

布尔值

true

指定是否在应用程序启动时清除临时文件文件夹的内容。

tempFolderPattern

字符串

null

指定一种模式，该模式将用于根据以下预定义的和可自定义的信息动态构建临时文件夹的名称。

HOST：主机名。

JOBID：作业 ID。

HASHCODE：作业上下文的哈希码。

TIMESTAMP：获取时间戳时使用的模式。临时文件夹的目标名称是 TMP_DIR_ {}。tempFolderPattern例如，在以下模式中，名称将以作业 ID 开头并以 “时间戳” 结尾： tempFolderPattern: JOBID、host=xxxx、HASHCODE、timestamp=yyymmddhhmss。如果该属性未添加到 YAML 文件中或该属性为空，tempFolderPattern则临时文件夹的名称将为 “TMP_DIR_” + this.hashCode () ()。DefaultJobContext

database.cursor.raise.already.opened.error

布尔值

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

布尔值

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

身份提供者（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.claimGroupName

字符串

cognito:groups

声明属性，包含用户所属的所有组的列表。对于 Amazon cognito，请使用 cognito:groups；对于外部 IdP，请使用任何其他字符串。

gapwalk-application.security.userAttributeName

字符串

username

用于标识用户请求的声明属性名称。对于 Amazon cognito，请使用 username；对于 Keycloak，请使用 preferred_username；对于外部 IdP，请使用任何其他字符串。

gapwalk-application.security.localhostWhitelistingEnabled

布尔值

true

指定是否为任何 localhost 请求启用身份验证。

gapwalk-application.defaultSuperAdminUserName

字符串

sadmin

禁用 gapwalk-application.security 时，请指定默认的本地超级用户名。

gapwalk-application.defaultSuperAdminUserPwd

字符串

sadmin

禁用 gapwalk-application.security 时，指定默认的本地超级用户密码。

gapwalk-application.security.filterURIs

字符串

disabled

切换过滤 URIs 配置。支持的值包括 disabled 和 enabled。

gapwalk-application.security.blockedURIs

String[]

null

URIs 要屏蔽的列表。当 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

布尔值

false

指定是否启用 JCL 检查点机制以支持作业重启。在每个步骤或主程序调用开始时，都会创建 JCL 检查点并将其保存到内存中的注册表中。如果定义了持久性提供程序，则在作业结束时，所有步骤级别的检查点都将保留。

jcl.checkpoint.expireTimeout

数字

–1

指定在持久性提供程序或内存中的注册表中保留 JCL 检查点的持续时间。

jcl.checkpoint.expireTimeoutUnit

字符串

SECONDS

指定 jcl.checkpoint.expireTimeout 属性的持续时间单位。支持的枚举常量值：java.util.concurrent。 TimeUnit。

jcl.checkpoint.provider

字符串

null

指定 JCL 检查点机制持久性提供程序。支持的值为 redis。

jcl.checkpoint.redis.*

支持的 Redis 属性

指定 JCL 检查点机制的 REDIS 持久性提供程序的配置属性，请参阅支持的 Redis 属性。

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

字符串

null

指定 JCL 检查点机制的 Redis 持久性提供程序的凭证密钥 ARN，请参阅 AWS Blu Age 运行时赛。
gapwalk.ssl.enabled 布尔值 false 指示将以下 gapwalk.ssl.* 属性设置为当前 JVM 系统属性（如果应用程序启动时尚未设置）。
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 指定使用哪个受支持的队列代理：sqs（使用 Amazon SQS）、rabbitmq（使用本地 Rabbit MQ）或 jms（使用本地 IBMMQ）。
mq.queues.jmsMQQueueManagers[N] 如果 mq.queues 为 jms，则支持指定 IBM MQ 连接列表。对于第一个连接为 mq.queues.jmsMQQueueManagers[0]，对于第二个连接为 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"。有关更多详细信息，请参阅官方文档 TLS CipherSpecs 和 IBM MQ 类 CipherSuites 中的 JMS。
mq.queues.non.jms.client 布尔值 false 指明发送消息的目标客户端是否为非 JMS。非 JMS 客户端将使用原生 MQ 格式，而 JMS 将使用 RFH2 格式。 4.5.0
当 mq.queues 为 rabbitmq 时，表示 IBMMQ 主机名。
mq.queues.rabbitMQHost Rabbit MQ 主机名。
mq.queues.rabbitMQVirtualHost Rabbit MQ 虚拟主机名。
mq.queues.rabbitMQPort Rabbit MQ 端口。
mq.queues.rabbitMQUsername Rabbit MQ 用户。
mq.queues.rabbitMQPassword Rabbit MQ 密码。
mf.runtime.switch.N

布尔值

true

为 MF 自然行序文件启用空插入。

 4.4.0
mf.runtime.switch.T

布尔值

false

允许在 MF 自然行序文件中插入制表符。

 4.4.0
gapwalk.database.support.useSavePointToRestoreFail

布尔值

false

通过在插入查询中使用 savePoints，在出现故障时启用事务恢复。启用此属性可能会影响数据库性能。您可以使用 query-to-database映射配置为特定查询覆盖此设置。

 4.6.0

可选 Web 应用程序的可用属性

根据您的现代化应用程序，您可能需要配置一个或多个可选 Web 应用程序，这些应用程序代表对依赖关系（例如 z/OS、AS/400）的支持，或者用于配置每个可选 Web 应用程序的IMS/MFS. The following tables contain lists of the available key/value参数。

gapwalk-utility-pgm.war

此可选的 Web 应用程序包含对 Z/OS 实用程序的支持。

下表提供了该应用程序键/值参数的详细信息。

键 类型 默认值 描述 发行版

logging.config

路径

classpath:logback-utility.xml

用于引用 logback 配置文件的标准密钥。其他标准日志记录密钥也可用。

spring.jta.enabled

布尔值

false

标准密钥。如果数据源支持模式不是 static-xa，则必须禁用 Spring JTA 事务自动配置。

spring.datasource.primary.jndi-name

字符串

jdbc/primary

主要数据源的 Java 命名和目录接口（JNDI）名称（如果使用 JNDI）。

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

布尔值

false

如果未指定，则确定是否计算记录大小。如果指定，则该值保持不变。

unload.sqlCodePointShift

数字

0

卸载实用程序的 SQL 代码点转换。运行字符转换进程。如果您的目标数据库来自 DB2 于 Postgresql，则为必填项。

unload.columnFiller

字符串

space

卸载实用程序列填充内容。

unload.varCharIsNull

布尔值

false

在 INFTILB 程序中使用此参数，如果设置为 true，则所有具有空（空格）值的不可为空的字段都将返回一个空字符串。

unload.useDatabaseConfiguration

布尔值

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

十六进制

6F

数据库中的值为空时，要添加的空字节指示符（NBI）值。

unload.nbi.whenNotNull

十六进制

00

数据库中的值不为空时，要添加的空字节指示符（NBI）值。

unload.nbi.writeNullIndicator

布尔值

false

指定是否在卸载输出文件中写出空指示符。

unload.bmc.useInto

布尔值

false

指定是否处理卸载实用程序的 INTO bmc 控制关键字。

unload.fetchSize

数字

0

允许您在卸载实用程序中处理游标时调整提取大小。

unload.noPad

布尔值

true

表示要卸载可变长度字符 (VARCHAR) 字段，而不会对最大长度进行任何填充。

 4.5.0

treatLargeNumberAsInteger

布尔值

false

指定是否将大数字作为 Integer 处理。默认情况下，大数字作为 BigDecimal 处理。

load.batchSize

数字

0

加载实用程序批次大小。

load.format.localDate

字符串

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

要使用的加载实用程序本地日期格式。

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

布尔值

false

将此参数设置为 true，表示您希望服务在将数据加载到数据库遇到错误时回滚表更改。

forcedDate

字符串

强制将日期（如果有）更改为提供的日期。

frozenDate

布尔值

true

指定是否冻结日期。仅在设置了 forcedDate 时适用。

jcl.type

字符串

MV

.jcl 文件类型。允许的值包括：jcl、vse。如果非 vse jcl 的文件为空，IDCAMS 实用程序 PRINT/REPRO 命令将返回 4。

hasGraphic

布尔值

false

INFUTILB 实用程序是否需要处理图形列。 DB2

convertGraphicDataToFullWidth

布尔值

true

指定是否将图形数据转换为全角格式。

gapwalk-cl-command.war

此可选的 Web 应用程序包含对 AS/400 实用程序的支持。

下表提供了该应用程序键/值参数的详细信息。

键 类型 默认值 描述

logging.config

路径

classpath:logback-utility.xml

用于引用 logback 配置文件的标准密钥。其他标准日志记录密钥也可用。

spring.jta.enabled

布尔值

false

标准密钥。如果数据源支持模式不是 static-xa，则必须禁用 Spring JTA 事务自动配置。

spring.datasource.primary.jndi-name

字符串

jdbc/primary

主要数据源的 Java 命名和目录接口（JNDI）名称（如果使用 JNDI）。

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

此可选 Web 应用程序包含 IMS/MFS 事务支持。

下表提供了该应用程序键/值参数的详细信息。

键 类型 默认值 描述

logging.config

路径

classpath:logback-utility.xml

用于引用 logback 配置文件的标准密钥。其他标准日志记录密钥也可用。

spring.jta.enabled

布尔值

false

标准密钥。如果数据源支持模式不是 static-xa，则必须禁用 Spring JTA 事务自动配置。

jhdb.configuration.context.encoding

字符串

Java 分层数据库 (JHDB) 编码。预期的有效编码字符串包含 CP1047、IBM930、ASCII、UTF-8...

jhdb.checkpointPersistence

字符串

none

检查点持久性模式。允许的值包括：none、add、end。使用 add 可在创建新检查点并将其添加到注册表后保留该检查点。使用 end 可在服务器关闭时保留检查点。任何其他值都会禁用持久性。请注意，每次向注册表中添加新的检查点时，所有现有的检查点都将被序列化并且文件会被擦除，而不是添加到文件中现有数据中。这样可能会对性能产生一些影响，具体取决于检查点的数量。

客户端应用程序的可用属性

您的现代化应用程序可能需要对客户端 Spring 应用程序进行特定的属性配置。这些属性从运行时 JAR 文件中打包的类初始化 Bean。在该application-profile.yaml文件中，配置文件值是在应用程序生成期间设置的，允许您配置这些属性。下表列出了可用于配置客户端 Web 应用程序的键/值参数，该应用程序使用 Gapwalk 运行时中打包的类中的 Bean

键 类型 默认值 描述 发行版

blu4iv.dtaara.library.disable

 布尔值 false 控制数据区操作上下文中库的使用。如果设置为 true，则数据区操作将禁用库的使用，但这不会影响的使用 QTemp。如果设置为 false，则在对数据区域执行 CRUD 操作时会考虑库。 4.5.0