AWS 大型机现代化服务（托管运行时环境体验）不再向新客户开放。有关类似于 AWS 大型机现代化服务（托管运行时环境体验）的功能，请浏览 AWS 大型机现代化服务（自我管理体验）。现有客户可以继续正常使用该服务。有关更多信息，请参阅[AWS 大型机现代化可用性变更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)。

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

# 使用适用于大型机的 Transform 引擎为 AWS 托管应用程序添加配置属性
<a name="applications-m2-ba-config-props"></a>

您可以在重构后的应用程序的`config`文件夹中添加一个文件，这样您就可以访问适用于大型机的 T AWS ransform 运行时引擎中的新功能。您必须将此文件命名为 `user-properties.yml`。此文件不会替换应用程序定义，而是对其进行了扩展。本主题介绍可以在 `user-properties.yml` 文件中包含的属性。

**注意**  
您无法更改某些参数，因为它们要么由 AWS 大型机现代化控制，要么由应用程序定义控制。在应用程序定义中为应用程序定义的所有参数均比您在 `user-properties.yml` 中指定的参数优先级高。

有关重构应用程序结构的更多信息，请参阅[大型机托管应用程序的 AWS 转换结构](applications-m2-other-resources-structure.md)。

下图显示了在 Transform for 大型机示例 AWS 应用程序的结构中该`user-properties.yml`文件的位置。 PlanetsDemo

```
PlanetsDemo-v1/
   ├─ config/
   │  ├─ application-PlanetsDemo.yml
   │  ├─ user-properties.yml
   ├─ jics/
   ├─ webapps/
```

## 配置属性参考
<a name="ba-config-props"></a>

以下是可用属性的列表。所有参数都是可选的。

**Topics**
+ [Gapwalk 应用程序属性](#gapwalk-app-props)
+ [Gapwalk 批处理脚本属性](#gapwalk-batch-props)
+ [Gapwalk Blugen 属性](#gapwalk-blugen-props)
+ [Gapwalk CL 命令属性](#gapwalk-cl-props)
+ [Gapwalk CL 运行程序属性](#gapwalk-cl-runner-props)
+ [Gapwalk JHDB 属性](#gapwalk-jhdb-props)
+ [Gapwalk JICS 属性](#gapwalk-jics-props)
+ [Gapwalk 运行时属性](#gapwalk-runtime-props)
+ [Gapwalk 实用程序属性](#gapwalk-utility-props)
+ [其他属性](#other-props)

### Gapwalk 应用程序属性
<a name="gapwalk-app-props"></a>

**bluesam.fileLoading.commitInterval**  
可选。Blusam提交间隔。  
类型：数字  
默认值：100000

**card.encoding**  
可选。卡片编码：与 `useControlMVariable` 一起使用。  
类型：字符串  
默认： CP1145

**checkinputfilesize**  
可选。指定在文件大小为记录大小倍数的情况下是否要进行检查。  
类型：布尔值  
默认值：false

**database.cursor.overflow.allowed**  
可选。指定是否允许游标溢出。设置为 `true` 时，无论游标位置如何，均可在游标处执行下一次调用。设置为 `false` 时，会在游标处执行下一次调用之前检查游标是否位于最后一个位置。仅在游标可滚动（敏感或不敏感）的情况下将其启用  
类型：布尔值  
默认：True

**数据简化器。 onInvalidNumeric数据**  
可选。解码无效的数字数据时如何应对。允许的值包括：`reject`、`toleratespaces`、`toleratespaceslowvalues`、`toleratemost`。  
类型：字符串  
默认：reject

**defaultKeepExisting文件**  
可选。指定是否设置数据集的默认先前值。  
类型：布尔值  
默认：false

**disposition.checkexistence**  
可选。指定是否针对配置 DISP SHR 或 OLD 的数据集检查文件是否存在。  
类型：布尔值  
默认：false

**externalSort.threshold**  
可选。排序阈值：确定系统何时应从内存中切换到外部合并排序（使用文件系统上的临时文件）。如果未指定 (default=`null`)，则将阈值设置为每个新排序任务中可用内存的一半。为了估计可用内存，需要调用 system.gc ()。  
类型：数据大小  
默认值：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 变量时要使用的前缀列表。每一个前缀均用逗号隔开。  
类型：字符串  
默认值：&,@,%%

**查询。 useConcatCondition**  
可选。指定键条件是否通过键连接构建。  
类型：布尔值  
默认：false

**rollbackOnRTE**  
可选。指定是否在运行时异常时回滚隐式运行单元事务。  
类型：布尔值  
默认：false

**sctThreadLimit**  
可选。用于触发脚本的线程限值。  
类型：数字  
默认：5

**sqlCodePoint移动**  
可选。sql 代码点转换。对在将遗留 rdbms 数据迁移到现代 rdbms 时可能遇到的控制字符的代码点进行转换。例如，您可以指定 `384` 来匹配 unicode 字符 `\u0180`。  
类型：数字  
默认值：0

**sqlIntegerOverflow已允许**  
可选。指定是否允许 SQL 整数溢出，即是否允许在主机变量中放置更大的值。  
类型：布尔值  
默认：false

**stepFailWhenAbend**  
可选。指定在步骤失败或完成执行时是否引发异常中止。  
类型：布尔值  
默认：True

**stopExecutionWhenProgNotFound**  
可选。指定在找不到程序时是否停止运行。如果设置为 `true`，则在找不到程序时中断运行。  
类型：布尔值  
默认：True

**系统.date.format**  
可选。指定系统日期格式。  
类型：字符串  
默认：MDY

**系统日期分隔符**  
可选。指定系统日期分隔符。  
类型：字符串  
默认：/

**uppercaseUserInput**  
可选。指定用户输入是否必须采用大写形式。  
类型：布尔值  
默认：True

**useControl MVariable**  
可选。指定是否使用 control-M 规范进行变量替换。  
类型：布尔值  
默认：false

**jcl.checkpoint.expireTimeout**  
可选。指定在持久性提供程序或内存中的注册表中保留 JCL 检查点的持续时间。  
类型：数字  
默认值：-1

**jcl.checkpoint expireTimeoutUnit**  
可选。指定 `jcl.checkpoint.expireTimeout` 属性的持续时间单位。支持的枚举常量值：`java.util.concurrent.TimeUnit`。  
类型：字符串  
默认值：SECONDS

### Gapwalk 批处理脚本属性
<a name="gapwalk-batch-props"></a>

**encoding**  
可选。批处理脚本项目中使用的编码（不是 groovy）。预期的有效编码包含 `CP1047`、`IBM930`、`ASCII`、`UTF-8`...  
类型：字符串  
默认值：ASCII

### Gapwalk Blugen 属性
<a name="gapwalk-blugen-props"></a>

**managers.trancode**  
可选。对话管理器转码映射。允许您将 JICS 事务代码映射到对话管理器。预期格式为 `trancode1:dialogManager1;trancode2:dialogManager2;`。  
类型：字符串  
默认值：null  
`managers.trancode: OR12:MYDIALOG1`

### Gapwalk CL 命令属性
<a name="gapwalk-cl-props"></a>

**commands-off**  
可选。要关闭的命令列表，以逗号分隔。允许的值包括：`PGM_BASIC`、`RCVMSG`、`SNDRCVF`、`CHGVAR`、`QCLRDTAQ`、`RTVJOBA`、`ADDLFM`、`ADDPFM`、`RCVF`、`OVRDBF`、`DLTOVR`、`CPYF`、`SNDDTAQ`。当你想禁用或覆盖现有程序时很有用。 `PGM_BASIC`是专为调试目的而设计的大型机运行时专用 AWS 转换程序。  
类型：字符串  
默认值：null

**spring.datasource.primary.jndi-name**  
可选。主要 Java 命名和目录接口（JNDI）数据源。  
类型：字符串  
默认值：jdbc/primary

**zonedMode**  
可选。对分区数据类型进行编码或解码的模式。允许的值包括：`EBCDIC_STRICT`、`EBCDIC_MODIFIED`、`AS400`。  
类型：字符串  
默认值：EBCDIC\_STRICT

### Gapwalk CL 运行程序属性
<a name="gapwalk-cl-runner-props"></a>

**cl.configuration.context.encoding**  
可选。CL 文件的编码。预期的有效编码包含 `CP1047`、`IBM930`、`ASCII`、`UTF-8`...  
类型：字符串  
默认： CP297

**cl.zonedMode**  
可选。对控制语言 (CL) 命令进行编码或解码的模式。允许的值包括：`EBCDIC_STRICT`、`EBCDIC_MODIFIED`、`AS400`。  
类型：字符串  
默认值：EBCDIC\_STRICT

### Gapwalk JHDB 属性
<a name="gapwalk-jhdb-props"></a>

**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 属性
<a name="gapwalk-jics-props"></a>

**jics.data。 dataJsonInit地点**  
可选。分析器在解析 CSD 时准备的 json 文件的位置，该文件用于初始化 jics 数据库。  
类型：字符串  
默认值：""

**jics.db。 dataScriptLocation**  
可选。initJics.sql 脚本的位置，该脚本由 Analyzer 在解析大型机的 CSD 导出时准备。  
类型：字符串  
默认值：""

**jics.db。 dataTestQuery地点**  
可选。包含单个 sql 查询的 sql 脚本的位置，该查询应返回对象计数（例如：计算 jics 程序表中的记录数）。如果计数等于 0，则将使用 `jics.db.dataScriptLocation` 脚本加载数据库，否则将跳过数据库加载。  
类型：字符串  
默认值：""

**jics.db。 ddlScriptLocation**  
可选。Jics ddl 脚本位置。支持您使用 .sql 脚本启动 jics 数据库架构。  
类型：字符串  
默认值：""  
`jics.db.ddlScriptLocation: ./jics/sql/jics.sql`

**jics.db。 schemaTestQuery地点**  
可选。sql 文件的位置，该文件应包含唯一查询，且该查询返回 jics 架构中对象的数量（如果有）。  
类型：字符串  
默认值：""

**jics。 runUnitLauncher池. 启用**  
可选。指定是否在 JICS 中激活运行单元启动器池。  
类型：布尔值  
默认：false

**jics。 runUnitLauncher泳池大小**  
可选。JICS 中的运行单元启动器池大小。  
类型：数字  
默认值：20

**jics。 runUnitLauncherpool. 验证间隔**  
可选：JICS 中运行单元启动器池的验证间隔，以毫秒为单位。  
类型：数字  
默认值：1000

**jics.queues.sqs.region**  
可选。 AWS 区域 适用于 Amazon SQS 的，在 JICS 中使用。为了提高性能，建议将该属性设置为与已部署应用程序相同的区域，但并不强制。  
类型：字符串  
默认值：eu-west-1

**jics.xa.agent.timeout**  
可选。定义负责管理分布式事务的 xa 代理用于完成其操作的最长持续时间。  
类型：数字  
默认值：null

**mq.queues.sqs.region**  
可选。 AWS 区域 适用于亚马逊 SQS MQ 服务。  
类型：字符串  
默认值：eu-west-3

**任务执行器。 allowCoreThreadTimeOut**  
可选。指定是否允许核心线程在 JCIS 中超时。即使与非零队列结合使用，也可以实现动态增长和缩小（因为只有在队列已满后，池最大大小才会增长）。  
类型：布尔值  
默认：false

**任务执行器。 corePoolSize**  
可选。当通过 groovy 脚本启动终端中的事务时，会创建一个新线程。可以使用此参数设置核心池大小。  
类型：数字  
默认：5

**任务执行器。 maxPoolSize**  
可选。当通过 groovy 脚本启动终端中的事务时，会创建一个新线程。使用此参数设置池的最大大小（并行线程的最大数量）。  
类型：数字  
默认值：10

**taskExecutor.queueCapacity**  
可选。当通过 groovy 脚本启动终端中的事务时，会创建一个新线程。使用此参数设置队列大小。（= 达到 `taskExecutor.maxPoolSize` 时待处理事务的最大数量）  
类型：数字  
默认值：50

### Gapwalk 运行时属性
<a name="gapwalk-runtime-props"></a>

**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-ddhh: mm: ss.sssssss

**fetchSize**  
可选。游标的 fetchSize 值。在 utils 使用区块获取数据时使用。 load/unload   
类型：数字  
默认值：10

**强制禁用 SQLTrim StringType**  
可选。指定是否禁用所有 sql 字符串参数的 TRIM。  
类型：布尔值  
默认：false

**localDateFormat**  
可选。本地日期格式列表。使用 `|` 分隔每种格式。  
类型：字符串

**localTimeFormat**  
可选。本地时间格式列表。使用 `|` 分隔每种格式。  
类型：字符串

**localTimestampFormat**  
可选。本地时间戳格式列表。使用 `|` 分隔每种格式。  
类型：字符串  
默认值：

**pgmDateFormat**  
可选。程序中使用的日期时间格式。  
类型：字符串  
默认： yyyy-MM-dd

**pgmTimeFormat**  
可选。程序 (pgm) 执行的时间格式。  
类型：字符串  
默认值：HH.mm.ss

**pgmTimestampFormat**  
可选。时间戳格式  
类型：字符串  
默认： yyyy-MM-dd-HH.mm.ss.ssssss

### Gapwalk 实用程序属性
<a name="gapwalk-utility-props"></a>

**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\| \|yyyy-mm-dd dd/MM/yyyy

**load.format.localTime**  
可选。要使用的加载实用程序本地时间格式。  
类型：字符串  
默认值：HH:mm:ss\|HH.mm.ss

**加载。 sqlCodePoint移动**  
可选。加载实用程序的 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

**卸载。 sqlCodePoint移动**  
可选。卸载实用程序的 SQL 代码点转换。运行字符转换进程。如果您的目标数据库来自 DB2 于 Postgresql，则为必填项。  
类型：数字  
默认值：0

**卸载。 useDatabaseConfiguration**  
可选。指定是否在卸载实用程序中使用 application-main.yml 中的日期或时间配置。  
类型：布尔值  
默认：false

**卸载。 varCharIs空**  
可选。在 INFTILB 程序中使用此参数，如果设置为 `true`，则所有具有空（空格）值的不可为空的字段都将返回一个空字符串。  
类型：布尔值  
默认：false

### 其他属性
<a name="other-props"></a>

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