本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
您可以在重构的应用程序的 config 文件夹中添加一个文件，以便访问 AWS Blu Age 运行时引擎中的新特征。您必须将此文件命名为 user-properties.yml。此文件不会替换应用程序定义，而是对其进行了扩展。本主题介绍可以在 user-properties.yml 文件中包含的属性。
注意
您无法更改某些参数，原因在于这些参数是由 AWS Mainframe Modernization 或应用程序定义控制的。在应用程序定义中为应用程序定义的所有参数均比您在 user-properties.yml 中指定的参数优先级高。
有关重构应用程序结构的更多信息，请参阅AWS Blu Age 托管应用程序的结构。
下图显示了 user-properties.yml 文件在 AWS Blu Age 示例应用程序 PlanetsDemo 结构中的位置。
PlanetsDemo-v1/
├─ config/
│ ├─ application-PlanetsDemo.yml
│ ├─ user-properties.yml
├─ jics/
├─ webapps/配置属性参考
以下是可用属性的列表。所有参数都是可选的。
主题
Gapwalk 应用程序属性
- bluesam.fileLoading.commitInterval
-
可选。BluSAM 提交间隔。
类型：数字
默认值：100000
- card.encoding
-
可选。卡片编码：与
useControlMVariable一起使用。类型：字符串
默认值：CP1145
- checkinputfilesize
-
可选。指定在文件大小为记录大小倍数的情况下是否要进行检查。
类型：布尔值
默认值：false
- database.cursor.overflow.allowed
-
可选。指定是否允许游标溢出。设置为
true时，无论游标位置如何，均可在游标处执行下一次调用。设置为false时，会在游标处执行下一次调用之前检查游标是否位于最后一个位置。仅在游标可滚动（敏感或不敏感）的情况下将其启用类型：布尔值
默认值：true
- dataSimplifier.onInvalidNumericData
-
可选。解码无效的数字数据时如何应对。允许的值包括：
reject、toleratespaces、toleratespaceslowvalues、toleratemost。类型：字符串
默认：reject
- defaultKeepExistingFiles
-
可选。指定是否设置数据集的默认先前值。
类型：布尔值
默认值：false
- disposition.checkexistence
-
可选。指定是否针对配置 DISP SHR 或 OLD 的数据集检查文件是否存在。
类型：布尔值
默认值：false
- externalSort.threshold
-
可选。排序阈值：何时切换到外部（合并）排序。
类型：字符串
默认值：null
externalSort.threshold: 12MB - blockSizeDefault
-
可选。用于 BDW 字节的默认区块大小。
类型：数字
默认值：32760
blockSizeDefault: 32760 - forceHR
-
可选。指定是否在控制台或文件输出上使用人类可读的 SYSPRINT。
类型：布尔值
默认值：false
- forcedDate
-
可选。在数据库中强制指定特定日期和时间。仅在开发和测试期间使用。
默认值：null
forcedDate: 2022-08-26T12:59:58.123456+01:57 - frozenDate
-
可选。冻结数据库中的日期和时间。仅在开发和测试期间使用。
默认值：false
frozenDate: false - ims.messages.extendedSize
-
可选。指定是否在 ims 消息上设置 extendedSize。
类型：布尔值
默认值：false
- lockTimeout
-
可选。无法在指定时间范围内获取锁时，事务的超时时间（单位为毫秒）。
类型：数字
默认值：500
- mapTransfo.prefixes
-
可选。转换 controlM 变量时要使用的前缀列表。每一个前缀均用逗号隔开。
类型：字符串
默认值：&,@,%%
- query.useConcatCondition
-
可选。指定键条件是否通过串联键来构建。
类型：布尔值
默认值：false
- rollbackOnRTE
-
可选。指定是否在运行时异常时回滚隐式运行单元事务。
类型：布尔值
默认值：false
- sctThreadLimit
-
可选。用于触发脚本的线程限值。
类型：数字
默认：5
- sqlCodePointShift
-
可选。sql 代码点转换。对在将遗留 rdbms 数据迁移到现代 rdbms 时可能遇到的控制字符的代码点进行转换。例如，您可以指定
384来匹配 unicode 字符\u0180。类型：数字
默认值：0
- sqlIntegerOverflowAllowed
-
可选。指定是否允许 SQL 整数溢出，即是否允许在主机变量中放置更大的值。
类型：布尔值
默认值：false
- stepFailWhenAbend
-
可选。指定在步骤失败或完成执行时是否引发异常中止。
类型：布尔值
默认值：true
- stopExecutionWhenProgNotFound
-
可选。指定在找不到程序时是否停止运行。如果设置为
true，则在找不到程序时中断运行。类型：布尔值
默认值：true
- uppercaseUserInput
-
可选。指定用户输入是否必须采用大写形式。
类型：布尔值
默认值：true
- useControlMVariable
-
可选。指定是否使用 control-M 规范进行变量替换。
类型：布尔值
默认值：false
- jcl.checkpoint.enabled
-
可选。指定是否启用 JCL 检查点机制以支持作业重启。在每个步骤或主程序调用开始时，都会创建 JCL 检查点并将其保存到内存中的注册表中。如果定义了持久性提供程序，则在作业结束时，所有步骤级别的检查点都将保留。
类型：布尔值
默认值：false
- jcl.checkpoint.expireTimeout
-
可选。指定在持久性提供程序或内存中的注册表中保留 JCL 检查点的持续时间。
类型：数字
默认值：-1
- jcl.checkpoint.expireTimeoutUnit
-
可选。指定
jcl.checkpoint.expireTimeout属性的持续时间单位。支持的枚举常量值：java.util.concurrent.TimeUnit。类型：字符串
默认值：SECONDS
- jcl.checkpoint.provider
-
可选。指定 JCL 检查点机制持久性提供程序。支持的值为
redis。类型：字符串
默认值：null
- jcl.checkpoint.redis.*
-
可选。指定 JCL 检查点机制的 REDIS 持久性提供程序的配置属性，请参阅支持的 Redis 属性。或者，强烈建议使用 AWS 密钥，如AWS 蓝光时代运行时的秘密中所述。
类型：支持的 Redis 属性
Gapwalk 批处理脚本属性
- encoding
-
可选。批处理脚本项目中使用的编码（不是 groovy）。预期的有效编码包含
CP1047、IBM930、ASCII、UTF-8...类型：字符串
默认值：ASCII
Gapwalk Blugen 属性
- managers.trancode
-
可选。对话管理器转码映射。允许您将 JICS 事务代码映射到对话管理器。预期格式为
trancode1:dialogManager1;trancode2:dialogManager2;。类型：字符串
默认值：null
managers.trancode: OR12:MYDIALOG1
Gapwalk CL 命令属性
- commands-off
-
可选。要关闭的命令列表，以逗号分隔。允许的值包括：
PGM_BASIC、RCVMSG、SNDRCVF、CHGVAR、QCLRDTAQ、RTVJOBA、ADDLFM、ADDPFM、RCVF、OVRDBF、DLTOVR、CPYF、SNDDTAQ。该键在禁用或覆盖现有程序时非常有用。PGM_BASIC是专为调试目的而设计的特定 AWS Blu Age 运行时程序。类型：字符串
默认值：null
- spring.datasource.primary.jndi-name
-
可选。主要 Java 命名和目录接口（JNDI）数据源。
类型：字符串
默认值：jdbc/primary
- zonedMode
-
可选。对分区数据类型进行编码或解码的模式。允许的值包括：
EBCDIC_STRICT、EBCDIC_MODIFIED、AS400。类型：字符串
默认值：EBCDIC_STRICT
Gapwalk CL 运行程序属性
- cl.configuration.context.encoding
-
可选。CL 文件的编码。预期的有效编码包含
CP1047、IBM930、ASCII、UTF-8...类型：字符串
默认值：CP297
- cl.zonedMode
-
可选。对控制语言 (CL) 命令进行编码或解码的模式。允许的值包括：
EBCDIC_STRICT、EBCDIC_MODIFIED、AS400。类型：字符串
默认值：EBCDIC_STRICT
Gapwalk JHDB 属性
- ims.programs
-
可选。要使用的 IMS 程序列表。用分号（
;）分隔每个参数，用逗号（,）分隔每个事务。例如：ims.programs: PCP008,PCT008;PCP054,PCT054;PCP066,PCT066;PCP068,PCT068;。类型：字符串
默认值：null
- jhdb.checkpointPath
-
可选。如果
jhdb.checkpointPersistence不是none，则此参数允许您设置检查点持久性路径（checkpoint.dat 文件存储位置），注册表中包含的所有检查点数据都将序列化并备份到所提供文件夹的文件 (checkpoint.dat) 中。请注意，此备份仅涉及检查点数据（scriptId、stepId、数据库位置和检查点区域）。类型：字符串
默认值：file:./setup/
- jhdb.checkpointPersistence
-
可选。检查点持久性模式。允许的值包括：
none、add、end。使用add可在创建新检查点并将其添加到注册表后保留该检查点。使用end可在服务器关闭时保留检查点。任何其他值都会禁用持久性。请注意，每次向注册表中添加新的检查点时，所有现有的检查点都将被序列化并且文件会被擦除，而不是添加到文件中现有数据中。因此，根据检查点的数量，可能会对性能产生一些影响。类型：字符串
默认值：none
- jhdb.configuration.context.encoding
-
可选。Java 分层数据库 (JHDB) 编码。预期的有效编码字符串包含
CP1047、IBM930、ASCII、UTF-8...类型：字符串
默认值：CP297
- jhdb.identificationCardData
-
可选。用于将某些“操作员识别卡数据”硬编码到 CARD 参数指定的 MID 字段。
类型：字符串
默认值：""
- jhdb.lterm
-
可选。允许您在进行 IMS 仿真的情况下强制使用通用的逻辑终端 ID。如果未设置，则使用会话 ID。
类型：字符串
默认值：null
- jhdb.metadata.extrapath
-
用于为 psbs 和 dbds 文件夹指定一个特定于运行时的额外根文件夹的配置参数。
类型：字符串
默认值：file:./setup/
注意
目前，对于部署限制，您必须将 dbds 和 psbs 目录复制到应用程序的配置目录或配置目录的子目录中，例如 config/setup
config |- setup |- dbds |- psbs并在 application-jhdb.yml 中设置
jhdb.metadata.extrapath: file: ./config/setup/ - jhdb.navigation.cachenexts
-
可选。RDBMS 分层导航中使用的缓存持续时间（以毫秒为单位）。
类型：数字
默认值：5000
- jhdb.query.limitJoinUsage
-
可选。指定是否在 RDBMS 图形上使用限制联接使用参数。
类型：布尔值
默认值：true
- jhdb.use-db-prefix
-
可选。指定是否在 RDBMS 的分层导航中启用数据库前缀。
类型：布尔值
默认值：true
Gapwalk JICS 属性
- jics.data.dataJsonInitLocation
-
可选。分析器在解析 CSD 时准备的 json 文件的位置，该文件用于初始化 jics 数据库。
类型：字符串
默认值：""
- jics.db.dataScriptLocation
-
可选。initJics.sql 脚本的位置，该脚本由 Analyzer 在解析大型机的 CSD 导出时准备。
类型：字符串
默认值：""
- jics.db.dataTestQueryLocation
-
可选。包含单个 sql 查询的 sql 脚本的位置，该查询应返回对象计数（例如：计算 jics 程序表中的记录数）。如果计数等于 0，则将使用
jics.db.dataScriptLocation脚本加载数据库，否则将跳过数据库加载。类型：字符串
默认值：""
- jics.db.ddlScriptLocation
-
可选。Jics ddl 脚本位置。支持您使用 .sql 脚本启动 jics 数据库架构。
类型：字符串
默认值：""
jics.db.ddlScriptLocation: ./jics/sql/jics.sql - jics.db.schemaTestQueryLocation
-
可选。sql 文件的位置，该文件应包含唯一查询，且该查询返回 jics 架构中对象的数量（如果有）。
类型：字符串
默认值：""
- jics.runUnitLauncherPool.enable
-
可选。指定是否在 JICS 中激活运行单元启动器池。
类型：布尔值
默认值：false
- jics.runUnitLauncherPool.size
-
可选。JICS 中的运行单元启动器池大小。
类型：数字
默认值：20
- jics.runUnitLauncherPool.validationInterval
-
可选：JICS 中运行单元启动器池的验证间隔，以毫秒为单位。
类型：数字
默认值：1000
- jics.queues.sqs.region
-
可选。JICS 中使用的适用于 Amazon SQS 的 AWS 区域。为了提高性能，建议将该属性设置为与已部署应用程序相同的区域，但并不强制。
类型：字符串
默认值：eu-west-1
- jics.xa.agent.timeout
-
可选。定义负责管理分布式事务的 xa 代理用于完成其操作的最长持续时间。
类型：数字
默认值：null
- mq.queues.sqs.region
-
可选。Amazon SQS MQ 服务的 AWS 区域。
类型：字符串
默认值：eu-west-3
- taskExecutor.allowCoreThreadTimeOut
-
可选。指定是否允许核心线程在 JCIS 中超时。即使与非零队列结合使用，也可以实现动态增长和缩小（因为只有在队列已满后，池最大大小才会增长）。
类型：布尔值
默认值：false
- taskExecutor.corePoolSize
-
可选。当通过 groovy 脚本启动终端中的事务时，会创建一个新线程。可以使用此参数设置核心池大小。
类型：数字
默认：5
- taskExecutor.maxPoolSize
-
可选。当通过 groovy 脚本启动终端中的事务时，会创建一个新线程。使用此参数设置池的最大大小（并行线程的最大数量）。
类型：数字
默认值：10
- taskExecutor.queueCapacity
-
可选。当通过 groovy 脚本启动终端中的事务时，会创建一个新线程。使用此参数设置队列大小。（= 达到
taskExecutor.maxPoolSize时待处理事务的最大数量）类型：数字
默认值：50
Gapwalk 运行时属性
- cacheMetadata
-
可选。指定是否缓存数据库元数据。
类型：布尔值
默认值：true
- check-groovy-file
-
可选。指定是否在注册前检查 groovy 文件内容。
类型：布尔值
默认值：true
- databaseStatistics
-
可选。指定是否允许 SQL 生成器收集和显示统计信息。
类型：布尔值
默认值：false
- dateTimeFormat
-
可选。dateTimeFormat 描述了如何将数据库日期时间戳类型溢出到数据简化器实体中。允许的值包括：
ISO、EUR、USA、LOCAL类型：字符串
默认值：ISO
- dbDateFormat
-
可选。数据库目标日期格式。
类型：字符串
默认值：yyyy-MM-dd
- dbTimeFormat
-
可选。数据库目标时间格式。
类型：字符串
默认值：HH:mm:ss
- dbTimestampFormat
-
可选。数据库目标时间戳格式。
类型：字符串
默认值：yyyy-MM-dd HH:mm:ss.SSSSSS
- fetchSize
-
可选。游标的 fetchSize 值。在通过加载/卸载 utils 使用区块获取数据时使用。
类型：数字
默认值：10
- forceDisableSQLTrimStringType
-
可选。指定是否禁用所有 sql 字符串参数的 TRIM。
类型：布尔值
默认值：false
- localDateFormat
-
可选。本地日期格式列表。使用
|分隔每种格式。类型：字符串
- localTimeFormat
-
可选。本地时间格式列表。使用
|分隔每种格式。类型：字符串
- localTimestampFormat
-
可选。本地时间戳格式列表。使用
|分隔每种格式。类型：字符串
默认值：
- pgmDateFormat
-
可选。程序中使用的日期时间格式。
类型：字符串
默认值：yyyy-MM-dd
- pgmTimeFormat
-
可选。程序 (pgm) 执行的时间格式。
类型：字符串
默认值：HH.mm.ss
- pgmTimestampFormat
-
可选。时间戳格式
类型：字符串
默认值：yyyy-MM-dd-HH.mm.ss.SSSSSS
Gapwalk 实用程序属性
- jcl.type
-
可选。
.jcl文件类型。允许的值包括：jcl、vse。如果非 vse jcl 的文件为空，IDCAMS 实用程序 PRINT/REPRO 命令将返回 4。类型：字符串
默认值：mvs
- listcat.variablelengthpreprocessor.enabled
-
可选。指定是否为 LISTCAT 命令启用可变长度预处理器。
类型：布尔值
默认值：false
- listcat.variablelengthpreprocessor.type
-
可选。listcat 文件中包含的对象的类型（如果启用
listcat.variablelengthpreprocessor.enabled）。允许的值包括：rdw、bdw。类型：字符串
默认为：rdw
- load.batchSize
-
可选。加载实用程序批次大小。
类型：数字
默认值：0
- load.format.dbDate
-
可选。要使用的加载实用程序数据库格式。
类型：字符串
默认值：yyyy-MM-dd
- load.format.dbTime
-
可选。要使用的加载实用程序数据库时间。
类型：字符串
默认值：HH:mm:ss
- load.format.localDate
-
可选。要使用的加载实用程序本地日期格式。
类型：字符串
默认值：dd.MM.yyyy|dd/MM/yyyy|yyyy-MM-dd
- load.format.localTime
-
可选。要使用的加载实用程序本地时间格式。
类型：字符串
默认值：HH:mm:ss|HH.mm.ss
- load.sqlCodePointShift
-
可选。加载实用程序的 SQL 代码点转换。运行字符转换进程。如果来自 DB2 目标数据库的是 Postgresql，则该属性是必需的。
类型：数字
默认值：0
- sysPunchEncoding
-
可选。syspunch 编码字符集。支持的值为
Cp1047、ASCII。类型：字符串
默认值：ASCII
- treatLargeNumberAsInteger
-
可选。指定是否将大数字作为
Integer处理。默认情况下，大数字作为BigDecimal处理。类型：布尔值
默认值：false
- unload.chunkSize
-
可选。卸载实用程序使用的区块大小。
类型：数字
默认值：0
- unload.columnFiller
-
可选。卸载实用程序列填充内容。
类型：字符串
默认值：space
- unload.fetchSize
-
可选。允许您在卸载实用程序中处理游标时调整提取大小。
类型：数字
默认值：0
- unload.format.date
-
可选。卸载实用程序中使用的日期格式（如果启用
unload.useDatabaseConfiguration）。类型：字符串
默认值：MM/dd/yyyy
- unload.format.time
-
可选。卸载实用程序中使用的时间格式（如果启用
unload.useDatabaseConfiguration）。类型：字符串
默认值：HH.mm.ss
- unload.format.timestamp
-
可选。卸载实用程序中使用的时间戳格式（如果启用
unload.useDatabaseConfiguration）。类型：字符串
默认值：yyyy-MM-dd-HH.mm.ss.SSSSSS
- unload.nbi.whenNotNull
-
可选。数据库中的值不为空时，要添加的空字节指示符 (nbi) 值。
类型：十六进制
默认值：00
- unload.nbi.whenNull
-
可选。数据库中的值为空时，要添加的空字节指示符 (nbi) 值。
类型：十六进制
默认值：6F
- unload.nbi.writeNullIndicator
-
可选。指定是否在卸载输出文件中写出空指示符。
类型：布尔值
默认值：false
- unload.sqlCodePointShift
-
可选。卸载实用程序的 SQL 代码点转换。运行字符转换进程。如果来自 DB2 目标数据库的是 Postgresql，则该属性是必需的。
类型：数字
默认值：0
- unload.useDatabaseConfiguration
-
可选。指定是否在卸载实用程序中使用 application-main.yml 中的日期或时间配置。
类型：布尔值
默认值：false
- unload.varCharIsNull
-
可选。在 INFTILB 程序中使用此参数，如果设置为
true，则所有具有空（空格）值的不可为空的字段都将返回一个空字符串。类型：布尔值
默认值：false
其他属性
- qtemp.cleanup.threshold.hours
-
可选。指定何时启用
qtemp.dblog。数据库分区的生命周期（以小时为单位）。类型：数字
默认值：0
- qtemp.dblog
-
可选。是否启用 QTEMP 数据库日志记录。
类型：布尔值
默认值：false
- qtemp.uuid.length
-
可选。QTEMP 的唯一 ID 长度。
类型：数字
默认值：9
- quartz.scheduler.stand-by-if-error
-
可选。指定当作业调度程序处于待机模式时是否触发作业执行。如果设置为 true，则启用时不会触发作业执行。
类型：布尔值
默认值：false
- warmUpCache
-
可选。指定是否在服务器启动时将所有数据通信表数据加载到预热缓存中。
类型：布尔值
默认值：false
