AWS Mainframe Modernization Service （受管執行期環境體驗） 不再開放給新客戶使用。對於與 AWS Mainframe Modernization Service （受管執行期環境體驗） 類似的功能，探索 AWS Mainframe Modernization Service （自我管理體驗）。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[AWS 大型主機現代化可用性變更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用適用於大型主機引擎的 AWS Transform 新增受管應用程式的組態屬性
<a name="applications-m2-ba-config-props"></a>

您可以在重構應用程式的 `config` 資料夾中新增檔案，讓您存取適用於大型主機執行期引擎的 AWS Transform 中的新功能。您必須將此檔案命名為 `user-properties.yml`。此檔案不會取代應用程式定義，但會將其擴展。本主題說明您可以在 `user-properties.yml` 檔案中包含的屬性。

**注意**  
您無法變更某些參數，因為它們是由 AWS Mainframe Modernization 或應用程式定義控制。您應用程式的應用程式定義中定義的所有參數，其優先順序高於您在 中指定的參數`user-properties.yml`。

如需重構應用程式結構的詳細資訊，請參閱 [大型主機受管應用程式的 AWS 轉換結構](applications-m2-other-resources-structure.md)。

下圖顯示如何在適用於大型主機範例應用程式的 AWS Transform 結構中尋找`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 batchscript 屬性](#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`以檢查游標是否位於最後一個位置，再對游標執行下一個呼叫。只有在游標為 SCROLLABLE (SENSITIVE 或 INSENSITIVE) 時才啟用  
類型：布林值  
預設：true

**dataSimplifier.onInvalidNumericData**  
選用。解碼無效數值資料時如何反應。允許的值為 `reject`、`toleratespaces`、`toleratespaceslowvalues`、`toleratemost`。  
類型：字串  
預設：拒絕

**defaultKeepExistingFiles**  
選用。指定是否設定資料集預設先前值。  
類型：布林值  
預設：false

**disposition.checkexistence**  
選用。指定是否針對具有 DISP SHR 或 OLD 的資料集，釋出檔案存在的檢查。  
類型：布林值  
預設：false

**externalSort.threshold**  
選用。排序閾值：決定系統何時應該從記憶體內切換到外部合併排序 （在檔案系統上使用暫存檔案）。如果未指定 (default=`null`)，則閾值會設定為每個新排序任務可用記憶體的一半。為了估計可用的記憶體，會執行對 System.gc() 的呼叫。  
類型：Datasize  
預設：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**  
選用。指定是否要設定 extendedSize on ims 訊息。  
類型：布林值  
預設：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

**system.date.format**  
選用。指定系統日期格式。  
類型：字串  
預設：MDY

**system.date.separator**  
選用。指定系統日期分隔符號。  
類型：字串  
預設：/

**uppercaseUserInput**  
選用。指定使用者輸入是否為大寫。  
類型：布林值  
預設：true

**useControlMVariable**  
選用。指定是否使用 control-M 規格取代變數。  
類型：布林值  
預設：false

**jcl.checkpoint.expireTimeout**  
選用。指定在持久性提供者或記憶體內登錄檔中保留 JCL 檢查點的持續時間。  
類型：數字  
預設：-1

**jcl.checkpoint.expireTimeoutUnit**  
選用。指定 `jcl.checkpoint.expireTimeout` 屬性的持續時間單位。支援的列舉常數值：`java.util.concurrent.TimeUnit`。  
類型：字串  
預設：SECONDS

### Gapwalk batchscript 屬性
<a name="gapwalk-batch-props"></a>

**編碼**  
選用。Batchscript 專案中使用的編碼 （而非 groovy)。預期有效的編碼 `CP1047`、`IBM930`、`ASCII`、`UTF-8`...  
類型：字串  
預設：ASCII

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

**manager.trancode**  
選用。對話方塊管理員轉錄碼映射。可讓您將 JICS 交易代碼映射至對話方塊管理員。預期的格式為 `trancode1:dialogManager1;trancode2:dialogManager2;`。  
類型：字串  
預設：null  
`managers.trancode: OR12:MYDIALOG1`

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

**command-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\$1STRICT

### 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\$1STRICT

### 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**  
選用。JHDB (Java 階層式資料庫） 編碼。預期有效的編碼字串 `CP1047`、`IBM930`、`ASCII`、`UTF-8`...  
類型：字串  
預設：CP297

**jhdb.identificationCardData**  
選用。用來將一些「運算子識別卡資料」硬式編碼至 CARD 參數指定的 MID 欄位。  
類型：字串  
預設: ""

**jhdb.lterm**  
選用。在 IMS 模擬的情況下，可讓您強制使用常見的邏輯終端機 ID。如果未設定，則會使用 sessionId。  
類型：字串  
預設：null

**jhdb.metadata.extrapath**  
組態參數，指定 psb 和 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.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**  
選用。 AWS 區域 適用於 JICS 的 Amazon SQS。建議為效能設定已部署應用程式的相同區域，但不是強制性的。  
類型：字串  
預設：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 執行期屬性
<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-dd HH：mm：ss.SSSSSS

**fetchSize**  
選用。游標的 fetchSize 值。依載入/卸載 utils 使用區塊擷取資料時使用 。  
類型：數字  
預設：10

**forceDisableSQLTrimStringType**  
選用。指定是否停用所有 sql 字串參數的修剪。  
類型：布林值  
預設：false

**localDateFormat**  
選用。本機日期格式的清單。使用 分隔每個格式`|`。  
類型：字串

**localTimeFormat**  
選用。本機時間格式的清單。使用 `|` 分隔每個格式。  
類型：字串

**localTimestampFormat**  
選用。本機時間戳記格式的清單。使用 分隔每個格式`|`。  
類型：字串  
預設：

**pgmDateFormat**  
選用。程式中使用的日期時間格式。  
類型：字串  
預設：yyyy-MM-dd

**pgmTimeFormat**  
選用。用於 pgm （程式） 執行的時間格式。  
類型：字串  
預設：https：//HH.mm.ss

**pgmTimestampFormat**  
選用。時間戳記格式。  
類型：字串  
預設：yyyy-MM-dd-HH.mm.ss.SSSSSS

### Gapwalk 公用程式程式屬性
<a name="gapwalk-utility-props"></a>

**jcl.type**  
Optional. `.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\$1dd/MM/yyyy\$1yyyy-MM-dd

**load.format.localTime**  
選用。要使用的負載公用程式本機時間格式。  
類型：字串  
預設：HH：mm：ss\$1HH.mm.ss

**load.sqlCodePointShift**  
選用。負載公用程式的 SQL 程式碼指標轉移。執行轉移字元程序。當您的目標資料庫來自 DB2 為 Postgresql 時為必要。  
類型：數字  
預設：0

**sysPunchEncoding**  
選用。syspunch 編碼字元集。支援的值為 `Cp1047` / `ASCII`。  
類型：字串  
預設：ASCII

**treatLargeNumberAsInteger**  
選用。指定是否將大型數字視為 `Integer`。根據`BigDecimal`預設，它們會被視為 。  
類型：布林值  
預設：false

**unload.chunkSize**  
選用。用於卸載公用程式的區塊大小。  
類型：數字  
預設：0

**unload.columnFiller**  
選用。卸載公用程式資料欄填充。  
類型：字串  
預設：空格

**unload.fetchSize**  
選用。可讓您在卸載公用程式中處理游標時調整擷取大小。  
類型：數字  
預設：0

**unload.format.date**  
選用。如果`unload.useDatabaseConfiguration`已啟用，則在卸載公用程式中使用的日期格式。  
類型：字串  
預設值：MM/dd/yyyy

**unload.format.time**  
選用。如果`unload.useDatabaseConfiguration`已啟用 ，則在卸載公用程式中使用的時間格式。  
類型：字串  
預設：https：//HH.mm.ss

**unload.format.timestamp**  
選用。如果`unload.useDatabaseConfiguration`已啟用 ，則在卸載公用程式中使用的時間戳記格式。  
類型：字串  
預設：yyyy-MM-dd-HH.mm.ss.SSSSSS

**unload.nbi.whenNotNull**  
選用。當資料庫的值不是 Null 時，要新增的 Null Byte Indicator (nbi) 值。  
類型：十六進位  
預設：00

**unload.nbi.whenNull**  
選用。當資料庫的值為 Null 時，要新增的 Null Byte Indicator (nbi) 值。  
類型：十六進位  
預設：6F

**unload.nbi.writeNullIndicator**  
選用。指定是否要在卸載輸出檔案中寫入 null 指標。  
類型：布林值  
預設：false

**unload.sqlCodePointShift**  
選用。卸載公用程式的 SQL 程式碼指標轉移。執行轉移字元程序。當您的目標資料庫來自 DB2 為 Postgresql 時為必要。  
類型：數字  
預設：0

**unload.useDatabaseConfiguration**  
選用。指定是否要在卸載公用程式中使用 application-main.yml 的日期或時間組態。  
類型：布林值  
預設：false

**unload.varCharIsNull**  
選用。在 INFTILB 程式中使用此參數，如果設定為 `true` ，則所有具有空白 （空格） 值的非 null 欄位都會傳回空字串。  
類型：布林值  
預設：false

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

**qtemp.cleanup.threshold.hours**  
選用。指定 `qtemp.dblog` 何時啟用。db 分割區生命週期 （小時）。  
類型：數字  
預設：0

**qtemp.dblog**  
選用。是否啟用 QTEMP 資料庫記錄。  
類型：布林值  
預設：false

**qtemp.uuid.length**  
選用。QTEMP 唯一 ID 長度。  
類型：數字  
預設：9

**quartz.scheduler.stand-by-if-error**  
選用。指定如果任務排程器處於待命模式，是否觸發任務執行。如果為 true，則啟用任務執行時不會觸發。  
類型：布林值  
預設：false

**warmUpCache**  
選用。指定是否要在伺服器啟動時將所有 datacom 資料表資料載入暖機快取。  
類型：布林值  
預設：false