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 轉換 您可以設定應用程式以包含對舊版公用程式的存取。您也可以自訂其他屬性。為了了解您可以設定的內容和位置，請參閱 [大型主機受管應用程式的 AWS 轉換結構](applications-m2-other-resources-structure.md)一節以了解大型主機現代化應用程式 AWS 轉換的整體結構。 **Topics** + [ # 大型主機受管應用程式的 AWS 轉換結構 ](applications-m2-other-resources-structure.md) + [ # 設定受管應用程式的公用程式存取權 ](applications-m2-ba-utilities.md) + [ # 使用適用於大型主機引擎的 AWS Transform 新增受管應用程式的組態屬性 ](applications-m2-ba-config-props.md) # 大型主機受管應用程式的 AWS 轉換結構 如果您將 AWS Transform 用於大型主機重構模式， AWS 則 Transform for 主機執行期引擎預期應用程式定義中 所指定資料夾中`app-location`的結構如下： ![\[Application-name 資料夾中的預期結構。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ba-app-structure.png) **config** 包含專案的 YAML 檔案。這些是應用程式特有的 YAML 檔案，通常命名如下`application-planetsdemo.yaml`，而不是 AWS 大型主機現代化為您自動提供和設定`application-main.yaml`的檔案。 **Web 應用程式** 包含您應用程式`war`的檔案。這些檔案是現代化程序的輸出。 應用程式也可以有下列選用資料夾： jics/sql 包含為您的應用程式初始化 JICS 資料庫的`initJics.sql`指令碼。 指令碼 包含應用程式指令碼，您也可以直接在`war`檔案內提供。 sql 包含應用程式 SQL 檔案，您也可以直接在`war`檔案內提供。 lnk 包含應用程式 LNK 檔案，您也可以直接在`war`檔案內提供。 額外 包含 jar，可為現代化應用程式提供額外的功能。 ## 管理應用程式的 Java 選項 若要管理應用程式的特定 Java 選項，`tomcat.properties`請將名為 的屬性檔案新增至 指定的資料夾`app-location`。此檔案可以有三個屬性： `xms`，指定 Java 記憶體耗用下限， `xmx`，指定 Java 記憶體耗用上限，以及 `dnscachettl`，管理 dns 解析度的快取持續時間。以下是有效`tomcat.properties`檔案內容的範例。 ``` xms=512M xmx=1G dnscachettl=5 ``` 您為前兩個屬性指定的值可以是下列任何單位： + 位元組：請勿指定單位。 + Kilobytes：將 K 附加至 值。 + MB：將 M 附加至 值。 + Gigabytes：將 G 附加至 值。 第三個屬性的值代表以秒為單位的快取持續時間，值可以是 -1 （永遠快取），也可以介於 0 （從未快取） 到 999 之間。在受管應用程式部署的內容中，預設值為 -1。 # 設定受管應用程式的公用程式存取權 當您使用適用於大型主機的 AWS Transform 重構大型主機應用程式時，如果您的應用程式依賴於 IDCAMS、INFUTILB、SORT 等各種舊版平台公用程式，您可能需要提供支援。適用於大型主機重構的 AWS Transform 提供此存取權，其中包含與現代化應用程式一起部署的專用 Web 應用程式。此 Web 應用程式需要`application-utility-pgm.yml`您必須提供的組態檔案 。如果您不提供此組態檔案，則 Web 應用程式無法與您的應用程式一起部署，也無法使用。 **Topics** + [ ## 組態屬性 ](#applications-m2-ba-utilities-props) 本主題說明您可以在`application-utility-pgm.yml`組態檔案中指定的所有可能屬性，以及其預設值。主題說明必要和選用屬性。下列範例是完整的組態檔案。它依我們建議的順序列出屬性。您可以使用此範例做為您自己的組態檔案的起點。 ``` # If the datasource support mode is not static-xa, spring JTA transactions autoconfiguration must be disabled spring.jta.enabled: false logging.config: 'classpath:logback-utility.xml' # Encoding encoding: cp1047 # Encoding to be used by INFUTILB and DSNUTILB to generate and read SYSPUNCH files sysPunchEncoding: cp1047 # Utility database access spring.aws.client.datasources.primary.secret: `arn:aws:secretsmanager:us-west-2:111122223333:secret:business-FfmXLG` treatLargeNumberAsInteger: false # Zoned mode : valid values = EBCDIC_STRICT, EBCDIC_MODIFIED, AS400 zonedMode: EBCDIC_STRICT jcl.type: mvs # Unload properties # For date/time: if use database configuration is enabled, formats are ignored # For nbi; use hexadecimal syntaxe to specify the byte value unload: sqlCodePointShift: 384 nbi: whenNull: "6F" whenNotNull: "00" useDatabaseConfiguration: false format: date: MM/dd/yyyy time: HH.mm.ss timestamp: yyyy-MM-dd-HH.mm.ss.SSSSSS chunkSize:500 fetchSize: 500 varCharIsNull: false columnFiller: space # Load properties # Batch size for DSNUTILB Load Task load: sqlCodePointShift: 384 batchSize: 500 format: localDate: dd.MM.yyyy|dd/MM/yyyy|yyyy-MM-dd dbDate: yyyy-MM-dd localTime: 'HH:mm:ss|HH.mm.ss' dbTime: 'HH:mm:ss' table-mappings: TABLE_1_NAME : LEGACY_TABLE_1_NAME TABLE_2_NAME : LEGACY_TABLE_2_NAME ``` ## 組態屬性 您可以在組態檔案中指定下列屬性。 **spring.jta.enabled** （選用） 控制是否啟用 JTA 支援。對於公用程式，我們建議您將此值設定為 `false`。 ``` spring.jta.enabled : false ``` **logging.config** （必要） 指定專用記錄器組態檔案的路徑。我們建議您使用 名稱`logback-utility.xml`，並提供此檔案做為現代化應用程式的一部分。組織這些檔案的常見方法是將所有記錄器組態檔案放在相同位置，通常是在子資料夾中`/config/logback`，其中 `/config` 是包含 YAML 組態檔案的資料夾。如需詳細資訊，請參閱 [Logback 文件中的第 3 章：Logback 組態](https://logback.qos.ch/manual/configuration.html)。 ``` logging.config : classpath:logback-utility.xml ``` **編碼** （必要） 指定公用程式使用的字元集。在大多數情況下，當您從 z/OS 平台遷移時，此字元集是 EBCDIC 變體，且應與針對現代化應用程式設定的字元集相符。如果未設定 ，則預設為 `ASCII`。 ``` encoding : cp1047 ``` **sysPunchEncoding** （選用） 指定 INFUTILB 和 DSNUTILB 用來產生和讀取 SYSPUNCH 檔案的字元集。如果您使用舊版平台中的 SYSPUNCH 檔案，則此值應為 EBCDIC 變體。如果未設定 ，則預設為 `ASCII`。 ``` sysPunchEncoding : cp1047 ``` ### 資料來源組態 有些資料庫相關的公用程式，例如 LOAD 和 UNLOAD，需要透過資料來源存取目標資料庫。如同 AWS 大型主機現代化中的其他資料來源定義，此存取需要您使用 AWS Secrets Manager。指向 Secrets Manager 中適當秘密的屬性如下： #### 主要資料來源 這是主要商業應用程式資料庫。 **spring.aws.client.datasources.primary.secret** （選用） 在 Secrets Manager 中指定包含資料來源屬性的秘密。 ``` spring.aws.client.datasources.primary.secret: datasource-secret-ARN ``` **spring.aws.client.datasources.primary.dbname** （選用） 如果資料庫名稱未直接在資料庫秘密中提供，請使用 `dbname` 屬性指定目標資料庫名稱。 ``` spring.aws.client.datasources.primary.dbname: target-database-name ``` **spring.aws.client.datasources.primary.type** （選用） 指定要使用的連線集區實作的完整名稱。預設值為 `com.zaxxer.hikari.HikariDataSource`。 ``` spring.aws.client.datasources.primary.type: target-datasource-type ``` 如果主要資料來源的類型為 `com.zaxxer.hikari.HikariDataSource`，您可以指定其他屬性，如下所示： **spring.datasource.primary.【property\$1name】** （選用） 您可以使用此格式來指定額外的屬性，以設定主要資料來源連線集區實作。 以下是類型 之主要資料來源的範例`com.zaxxer.hikari.HikariDataSource`。 ``` spring: datasource: primary: autoCommit: XXXX maximumPoolSize: XXXX keepaliveTime: XXXX minimumIdle: XXXX idleTimeout: XXXX connectionTimeout: XXXX maxLifetime: XXXX ``` #### 其他公用程式資料來源 除了主要資料來源之外，您還可以提供其他公用程式資料來源。 **spring.aws.client.utility.pgm.datasources.names** （選用） 指定公用程式資料來源名稱的清單。 ``` spring.aws.client.utility.pgm.datasources.names: dsname1, dsname2, dsname3 ``` **spring.aws.client.utility.pgm.datasources.【dsname】.secret** （選用） 指定 SSM 中託管資料來源屬性的秘密 ARN。在 中指定的名稱清單中提供 【dsname】`spring.aws.client.utility.pgm.datasources.names`。 ``` spring.aws.client.utility.pgm.datasources.dsname1.secret: datasource-secret-ARN ``` **spring.aws.client.utility.pgm.datasources.【dsname】.dbname** （選用） 如果資料庫名稱未使用 `dbname` 屬性直接在資料庫秘密中提供，則指定目標資料庫名稱。在 中指定的名稱清單中提供 【dsname】`spring.aws.client.utility.pgm.datasources.names`。 ``` spring.aws.client.utility.pgm.datasources.dsname1.dbname: target-database-name ``` **spring.aws.client.utility.pgm.datasources.【dsname】.type** （選用） 指定要使用的連線集區實作的完整名稱。預設值為 `com.zaxxer.hikari.HikariDataSource`。在 中指定的名稱清單中提供 【dsname】`spring.aws.client.utility.pgm.datasources.names`。 ``` spring.aws.client.utility.pgm.datasources.dsname1.type: target-datasource-type ``` 如果公用程式資料來源類型為 `com.zaxxer.hikari.HikariDataSource`，您可以提供其他屬性，如下所示： **spring.datasource.【dsname】.【property\$1name】** （選用） 指定額外屬性的集合，以設定公用程式資料來源連線集區實作。在 中指定的名稱清單中提供 【dsname】`spring.aws.client.utility.pgm.datasources.names`。以下列格式指定屬性： `property_name : value` 以下是 類型之其他公用程式資料來源的範例`com.zaxxer.hikari.HikariDataSource`： ``` spring: datasource: dsname1: connectionTimeout: XXXX maxLifetime: XXXX dsname2: connectionTimeout: XXXX maxLifetime: XXXX dsname3: connectionTimeout: XXXX maxLifetime: XXXX ``` **treatLargeNumberAsInteger** （選用） 與 Oracle 資料庫引擎詳細資訊和 DSNTEP2/DSNTEP4 公用程式用量相關。如果您將此旗標設定為 true，則來自 Oracle 資料庫 (NUMBER (38，0)) 的大型數字會視為整數。預設：`false` ``` treatLargeNumberAsInteger : false ``` **zonedMode** （選用） 設定分區模式來編碼或解碼分區的資料類型。此設定會影響符號數字的表示方式。有效值如下： + *EBCDIC\$1STRICT*：預設。對符號處理使用嚴格定義。根據字元集是 EBCDIC 還是 ASCII，符號位數表示會使用下列字元： + 對應至位元組 (`Cn+Dn`) 的 EBCDIC 字元，代表正負位數範圍 (`+0` 到 `+9`、 `-0`到 `-9`)。字元顯示為 `{`、`A` 到 `}`、、 `I``J`到 `R` + 對應至位元組 (`3n+7n`) 的 ASCII 字元，代表正負位數範圍 (`+0` 到 `+9`、 `-0`到 `-9`)。字元顯示為 `0` 到 `9`，`p`顯示為 `y` + *EBCDIC\$1MODIFIED*：使用修改後的符號處理定義。對於 EBDIC 和 ASCII，相同的字元清單代表符號數字，即`+0``+9`映射至 `{` \$1 `A`至 ，`I`以及`-0``-9`映射至 `}` \$1 `J`至 `R`。 \$1 + *AS400*：用於來自 iSeries (AS400) 平台的現代化舊版資產。 ``` zonedMode:EBCDIC_STRICT ``` **jcl.type** （選用） 指出現代化 JCL 指令碼的舊版類型。如果叫用 JCL 的類型為 ，IDCAMS 公用程式會使用此設定來量身打造傳回碼`vse`。有效值如下： + `mvs` (預設值) + `vse` ``` jcl.type : mvs ``` ### 資料庫卸載公用程式相關屬性 使用這些屬性來設定公用程式，將資料庫資料表卸載至資料集。下列所有屬性都是選用的。 此範例顯示所有可能的卸載屬性。 ``` # Unload properties # For date/time: if use database configuration is enabled, formats are ignored # For nbi; use hexadecimal syntaxe to specify the byte value 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 chunkSize: 0 fetchSize: 0 varCharIsNull: false columnFiller: space ``` **sqlCodePointShift** （選用） 指定整數值，代表資料上使用的 SQL 程式碼點轉移。預設值為 0。這表示不會進行程式碼點轉移。將此設定與用於現代化應用程式的 SQL 程式碼點轉移參數對齊。使用程式碼點轉移時，此參數最常見的值為 384。 ``` unload.sqlCodePointShift: 0 ``` **nbi** （選用） 指定 null 指標位元組。這是新增至資料值右側的十六進位值 （做為字串）。兩個可能的值如下所示： + *whenNull*：當資料值為 null 時新增十六進位值。預設值為 `6``。有時候`FF`會改用高值。 ``` unload.nbi.whenNull: "6F" ``` + *whenNotNull*：當資料值不是 null 但資料欄為 null 時，新增十六進位值。預設值為 `00`（低值）。 ``` unload.nbi.whenNotNull: "00" ``` **useDatabaseConfiguration** （選用） 指定日期和時間格式屬性。這用於處理 UNLOAD 查詢中的日期/時間物件。預設值為 `false`。 + 如果設定為 `true`， 會使用主組態檔案 () 中的 `pgmDateFormat``pgmTimeFormat`、 和 `pgmTimestampFormat` 屬性`application-main.yml`。 + 如果設定為 `false`， 會使用下列日期和時間格式屬性： + `unload.format.date`：指定日期格式模式。預設值為 `MM/dd/yyyy`。 + `unload.format.time`：指定時間格式模式。預設值為 `HH.mm.ss`。 + `unload.format.timestamp`：指定時間戳記格式模式。預設值為 `yyyy-MM-dd-HH.mm.ss.SSSSSS`。 **chunkSize** （選用） 指定用於建立 SYSREC 資料集的資料區塊大小。這些資料集是具有平行操作的資料集卸載操作的目標。預設為 `0`（無區塊）。 ``` unload.chunkSize:0 ``` **fetchSize** （選用） 指定資料擷取大小。此值是使用資料區塊策略時，一次要擷取的記錄數目。預設：`0`。 ``` unload.fetchSize:0 ``` **varCharIsNull** （選用） 指定如何處理含空白內容的非 null varchar 資料欄。預設值為 `false`。 如果您將此值設定為 `true`，資料欄內容會被視為空字串以用於卸載，而非單一空格字串。將此旗標設定為 ，僅適用於 `true` Oracle 資料庫引擎案例。 ``` unload.varCharIsNull: false ``` **columnFiller** （選用） 指定用於填補 varchar 資料欄中卸載資料欄的值。可能的值為空格或低值。預設為空格。 ``` unload.columnFiller: space ``` ### 資料庫載入相關屬性 使用這些屬性來設定公用程式，將資料集記錄載入目標資料庫，例如 DSNUTILB。下列所有屬性都是選用的。 此範例顯示所有可能的負載屬性。 ``` # Load properties # Batch size for DSNUTILB Load Task load: sqlCodePointShift: 384 batchSize: 500 format: localDate: dd.MM.yyyy|dd/MM/yyyy|yyyy-MM-dd dbDate: yyyy-MM-dd localTime: HH:mm:ss|HH.mm.ss dbTime: HH:mm:ss table-mappings: TABLE_1_NAME : LEGACY_TABLE_1_NAME TABLE_2_NAME : LEGACY_TABLE_2_NAME ``` **sqlCodePointShift** （選用） 指定整數值，代表用於資料上的 SQL 程式碼點轉移。預設為 0，這表示應用程式不會轉移程式碼點。將此設定與用於現代化應用程式的 SQL 程式碼點轉移參數對齊。當您使用程式碼點轉移時，此參數最常見的值為 384。 ``` load.sqlCodePointShift : 384 ``` **batchSize** （選用） 指定整數值，代表在將實際批次陳述式傳送至資料庫之前要處理的記錄數。預設為 0。 ``` load.batchSize: 500 ``` **格式** （選用） 指定資料庫載入操作期間用於日期/時間轉換的日期和時間格式模式。 + `load.format.localDate`：本機日期格式模式。預設值為 `dd.MM.yyyy|dd/MM/yyyy|yyyy-MM-dd`。 + `load.format.dbDate`：資料庫日期格式模式。預設值為 `yyyy-MM-dd`。 + `load.format.localTime`：本機時間格式模式。預設值為 `HH:mm:ss|HH.mm.ss`。 + `load.format.dbTime`：資料庫時間格式模式。預設值為 `HH:mm:ss`。 **資料表映射** （選用） 指定舊版和現代資料表名稱之間客戶提供的映射集合。DSNUTILB 公用程式會使用這些映射。 以下列格式指定值：*MODERN\$1TABLE\$1NAME：LEGACY\$1TABLE\$1NAME* 請見此處範例： ``` table-mappings: TABLE_1_NAME : LEGACY_TABLE_1_NAME TABLE_2_NAME : LEGACY_TABLE_2_NAME ... TABLE_*N*_NAME : LEGACY_TABLE_*N*_NAME ``` 當公用程式應用程式啟動時，它會明確記錄所有提供的映射。 # 使用適用於大型主機引擎的 AWS Transform 新增受管應用程式的組態屬性 您可以在重構應用程式的 `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/ ``` ## 組態屬性參考 這是可用屬性的清單。所有參數都是選用的。 **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 應用程式屬性 **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 屬性 **編碼** 選用。Batchscript 專案中使用的編碼 （而非 groovy)。預期有效的編碼 `CP1047`、`IBM930`、`ASCII`、`UTF-8`... 類型：字串 預設：ASCII ### Gapwalk Blugen 屬性 **manager.trancode** 選用。對話方塊管理員轉錄碼映射。可讓您將 JICS 交易代碼映射至對話方塊管理員。預期的格式為 `trancode1:dialogManager1;trancode2:dialogManager2;`。 類型：字串 預設：null `managers.trancode: OR12:MYDIALOG1` ### Gapwalk CL 命令屬性 **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 執行器屬性 **cl.configuration.context.encoding** 選用。CL 檔案的編碼。預期有效的編碼 `CP1047`、`IBM930`、`ASCII`、`UTF-8`... 類型：字串 預設：CP297 **cl.zonedMode** 選用。用於編碼或解碼控制語言 (CL) 命令的模式。允許的值為 `EBCDIC_STRICT` / `EBCDIC_MODIFIED` / `AS400`。 類型：字串 預設：EBCDIC\$1STRICT ### 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** 選用。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 屬性 **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 執行期屬性 **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 公用程式程式屬性 **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 ### 其他屬性 **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