使用 AWS Blu Age 引擎新增受管應用程式的組態屬性 - AWS 大型主機現代化
組態屬性參考

AWS Mainframe Modernization Service （受管執行期環境體驗） 不再向新客戶開放。對於與 AWS Mainframe Modernization Service （受管執行期環境體驗） 類似的功能，請探索 AWS Mainframe Modernization Service （自我管理體驗）。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱AWS 大型主機現代化可用性變更。

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

使用 AWS Blu Age 引擎新增受管應用程式的組態屬性

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

注意

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

如需重構應用程式結構的詳細資訊，請參閱 AWS Blu Age 受管應用程式的結構。

下圖顯示如何在 AWS Blu Age 範例應用程式 PlanetsDemo 的結構中尋找user-properties.yml檔案。

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以檢查游標是否位於最後一個位置，再對游標執行下一個呼叫。只有在游標為 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

uppercaseUserInput

選用。指定使用者輸入是否為大寫。

類型：布林值

預設：true

useControlMVariable

選用。指定是否使用 control-M 規格取代變數。

類型：布林值

預設：false

jcl.checkpoint.expireTimeout

選用。指定在持久性提供者或記憶體內登錄檔中保留 JCL 檢查點的持續時間。

類型：數字

預設：-1

jcl.checkpoint.expireTimeoutUnit

選用。指定 jcl.checkpoint.expireTimeout 屬性的持續時間單位。支援的列舉常值：java.util.concurrent.TimeUnit。

類型：字串

預設：SECONDS

Gapwalk 批次指令碼屬性

編碼

選用。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、RTVJOBAADDLFM、ADDPFM、RCVF、OVRDBF、、DLTOVR、、CPYF、、SNDDTAQ。當您想要停用或覆寫現有程式時很有用。 PGM_BASIC 是專為偵錯目的而設計的特定 AWS Blu Age Runtime 程式。

類型：字串

預設：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

選用。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|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

選用。卸載公用程式資料欄填充。

類型：字串

預設：空格

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