AWS Mainframe Modernization 自我管理體驗不再開放給新客戶。如需類似 AWS Mainframe Modernization 自我管理體驗的功能,請從廠商導向產品和來源探索功能 AWS Transform。現有客戶可以繼續正常使用該服務。如需詳細資訊,請參閱AWS 大型主機現代化可用性變更。
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
AWS Mainframe Modernization Service (受管執行期環境體驗) 不再向新客戶開放。對於與 AWS Mainframe Modernization Service (受管執行期環境體驗) 類似的功能,請探索 AWS Mainframe Modernization Service (自我管理體驗)。現有客戶可以繼續正常使用該服務。如需詳細資訊,請參閱AWS 大型主機現代化可用性變更。
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
啟用大型主機執行期 AWS 轉換的屬性
在 Spring Boot 應用程式中,application-main.yml我們定義了不同類型的屬性,例如接聽連接埠、資料庫連線等。您可以使用此頁面來了解適用於大型主機執行期之 AWS Transform 的可用屬性,以及如何啟用這些屬性。
YML 表示法
在下列文件中, 等屬性parent.child1.child2=true會以 YAML 格式撰寫如下。
parent: child1: child2: true
快速入門/使用案例
下列使用案例顯示適用金鑰和值的範例。
-
預設 application-main.yml
---- #### DEFAULT APPLICATION-MAIN.YML FILE ##### #### SHOWING USEFUL CONFIGURATION ELEMENTS ##### #### SHOULD BE OVERRIDDEN AND EXTERNALIZED ##### ################################# ##### Logging configuration ##### ################################# logging: config: classpath:logback-main.xml level.org.springframework.beans.factory.support.DefaultListableBeanFactory : WARN ################################ ##### Spring configuration ##### ################################ spring: quartz: auto-startup: false scheduler-name: Default properties: org.quartz.threadPool.threadCount: 1 jta: enabled: false atomikos.properties.maxTimeout : 600000 atomikos.properties.default-jta-timeout : 100000 jpa: # DISABLE OpenEntityManagerInViewInterceptor open-in-view: false # Fix Postgres JPA Error: # Method org.postgresql.jdbc.PgConnection.createClob() is not yet implemented. properties.hibernate.temp.use_jdbc_metadata_defaults : false ##################################### ##### Jics tables configuration ##### ##################################### # The dialect should match the jics datasource choice database-platform : org.hibernate.dialect.PostgreSQLDialect # org.hibernate.dialect.PostgreSQLDialect, org.hibernate.dialect.SQLServerDialect # those properties can be used to create and initialize jics tables automatically. # properties: # hibernate: # globally_quoted_identifiers: true # hbm2ddl: # import_files_sql_extractor : org.hibernate.tool.hbm2ddl.MultipleLinesSqlCommandExtractor # import_files : file:./setup/initJics.sql # auto : create ########################## ###### Level 2 cache ##### ########################## # cache: # use_second_level_cache: true # use_query_cache: true # region: # factory_class: org.hibernate.cache.ehcache.EhCacheRegionFactory # javax: # persistence: # sharedCache: # mode: ENABLE_SELECTIVE ########################## ###### Redis settings ##### ########################## session: store-type: none #redis # Secret manager configuration for global Redis cache aws: client: gapwalk: redis: secret: arn:aws:secretsmanager:XXXX ######################################### ##### JICS datasource configuration ##### ######################################### datasource: jicsDs: driver-class-name : org.postgresql.Driver # org.postgresql.Driver, com.microsoft.sqlserver.jdbc.SQLServerDriver url: jdbc:postgresql://localhost/jics # jdbc:postgresql://localhost:5433/jics, jdbc:sqlserver://localhost\SQLEXPRESS:1434;databasename=jics; username: jics password: jics type : org.postgresql.ds.PGSimpleDataSource # org.postgresql.ds.PGSimpleDataSource, com.microsoft.sqlserver.jdbc.SQLServerDataSource ##################################################### ##### Embedded Bluesam datasource configuration ##### ##################################################### bluesamDs : driver-class-name : org.postgresql.Driver url : jdbc:postgresql://localhost/bluesam username : bluesam password : bluesam type : org.postgresql.ds.PGSimpleDataSource ########################################## ##### Embedded Bluesam configuration ##### ########################################## bluesam : cache : ehcache persistence : pgsql ehcache: resource-pool: size: 4GB write-behind: enabled: true pgsql : dataSource : bluesamDs ######################### ##### Jics settings ##### ######################### rabbitmq.host: localhost jics: cache: false #redis resource-definitions.store-type: jpa # default value: jpa, other possible value: redis jics.disableSyncpoint : false #jics.initList: #jics.parameters.datform: DDMMYY #jics.parameters.applid: VELOCITY #jics.parameters.sysid: CICS #jics.parameters.eibtrmid: TERM #jics.parameters.userid: MYUSERID #jics.parameters.username: MYUSERNAME #jics.parameters.opid: XXX #jics.parameters.cwa.length: 0 #jics.parameters.netname: MYNETNAME #jics.parameters.jobname: MJOBNAME #jics.parameters.sysname: SYSNAME ############################################## ##### Jics RunUnitLauncher pool settings ##### ############################################## #jics.runUnitLauncherPool.enable: false #jics.runUnitLauncherPool.size: 20 #jics.runUnitLauncherPool.validationInterval: 1000 ######################### ##### Jhdb settings ##### ######################### #jhdb.lterm: LTERMVAL #jhdb.identificationCardData: SomeIDData ################################### ##### DateHelper configuration #### ################################### #forcedDate: "2013-08-26T12:59:58+01:57" ############################# ##### Sort configuration #### ############################# #externalSort.threshold: 256MB ################################### ##### Server timeout (10 min) #### ################################### spring.mvc.async.request-timeout: 600000 ############################### ##### DATABASE STATISTICS #### ############################### databaseStatistics : false ###################### ##### CALLS GRAPH #### ###################### callGraph : false #################################### ##### SSL configuration ##### #################################### gapwalk.ssl.enabled : true gapwalk.ssl.trustStore : "./config/clientkey.jks" gapwalk.ssl.trustStorePassword : mysslcertifpassword ################################## ##### MQ settings ##### ################################## mq.queues: jmsmq mq.queues.jmsMQQueueManagers[0].jmsMQQueueManager: QM1 mq.queues.jmsMQQueueManagers[0].jmsMQAppName: Gapwalk mq.queues.jmsMQQueueManagers[0].jmsMQChannel: DEV.APP.SVRCONN mq.queues.jmsMQQueueManagers[0].jmsMQHost: localhost mq.queues.jmsMQQueueManagers[0].jmsMQPort: 1415 mq.queues.jmsMQQueueManagers[0].jmsMQUserid: app mq.queues.jmsMQQueueManagers[0].jmsMQSSLCipher: "*TLS12ORHIGHER" mq.queues.jmsMQQueueManagers[1].jmsMQQueueManager: QM2 mq.queues.jmsMQQueueManagers[1].jmsMQAppName: Gapwalk mq.queues.jmsMQQueueManagers[1].jmsMQChannel: DEV.APP.SVRCONN mq.queues.jmsMQQueueManagers[1].jmsMQHost: localhost mq.queues.jmsMQQueueManagers[1].jmsMQPort: 1415 mq.queues.jmsMQQueueManagers[1].jmsMQUserid: app ######################################################### ##### Configuration properties for JMS MQ connection #### ######################################################### mq.queues.jms.connectionfactory.borrow-connection-timeout: 31 # Timeout, in seconds, for borrowing connections from the pool. mq.queues.jms.connectionfactory.ignore-session-transacted-flag: true # Whether or not to ignore the transacted flag when creating a session. mq.queues.jms.connectionfactory.local-transaction-mode: false # Whether or not to include local transactions. mq.queues.jms.connectionfactory.maintenance-interval: 62 # The time, in seconds, between runs of the pool's maintenance thread. mq.queues.jms.connectionfactory.max-idle-time: 63 # The time, in seconds, after which connections are cleaned up from the pool. mq.queues.jms.connectionfactory.max-lifetime: 0 # The time, in seconds, that a connection can be pooled for before being destroyed. 0 denotes no limit. mq.queues.jms.connectionfactory.max-pool-size: 1 # The maximum size of the pool. This property will be overwritten by mq.queues.jmsMQQueueManagers[N].jmsMQMaxPoolSize property (if provided). mq.queues.jms.connectionfactory.min-pool-size: 1 # The minimum size of the pool. mq.queues.jms.connectionfactory.reap-timeout: 0 # The reap timeout, in seconds, for borrowed connections. 0 denotes no limit. ############################### ##### SQL SHIFT CODE POINT #### ############################### # Code point 384 match unicode character \u0180 sqlCodePointShift : 384 ############################### ##### LOCK TIMEOUT RECORD #### ############################### # Blu4IV record lock timeout lockTimeout : 100 ############################## ##### REPORTS OUTPUT PATH #### ############################## reportOutputPath: reports ############################## ##### TASK EXECUTOR #### ############################## taskExecutor: corePoolSize: 5 maxPoolSize: 10 queueCapacity: 50 allowCoreThreadTimeOut: false ############################## ##### PROGRAM NOT FOUND #### ############################## stopExecutionWhenProgNotFound: false ###################################################### ##### DISP DEFAULT VALUE (to be removed one day) #### ###################################################### defaultKeepExistingFiles: true ###################################################### ##### BLOCKSIZE DEFAULT VALUE #### ###################################################### #blockSizeDefault: 32760 ##################################### ##### JOBQUEUE CONFIGURATION #### ##################################### jobqueue: api.enabled: false impl: none # possible values: quartz, none schedulers: # list of schedulers - name: queue1 threadCount: 5 - name: queue2 threadCount: 5 ################################################################################ ##### QUERY BUILDING ## # useConcatCondition : false by default # if true, in the query, the where condition is build with key concatenation ## ################################################################################ # query.useConcatCondition: true ######################################## ##### JCL Batch Restart Mechanism #### ######################################## jcl: checkpoint: enabled: false #expireTimeout: -1 #expireTimeoutUnit: SECONDS # Supported values: java.util.concurrent.TimeUnit #provider: redis ############################## ##### System parameters #### ############################## system.date.format:MDY system.date.separator: "/" ############################################################# ##### Database metadata schema inclusion configuration #### ############################################################# gapwalk: database: metadata: schema-inclusion: enabled: false schemas: global: - "SCHEMA1" - "SCHEMA2" ############################## ##### URL configuration #### ############################## gapwalk.post.script.mediatype.json: false ######################################## ##### CBLQDA parameters #### ######################################## gapwalk.cobol.cblqda.enabled: false ---- -
搭配 LISTCAT 命令使用變數長度檔案
[**/*.*] encoding=IBM930 reencoding=false [global] listcat.variablelengthpreprocessor.enabled=true listcat.variablelengthpreprocessor.type=rdw # use "rdw" if your .listcat file contains a set of records (RDW) # use "bdw" if your .listcat file contains a set of blocks (bdw) -
在 LOAD/UNLOAD 公用程式中提供 Null 位元組指標值
# Unload properties # For date/time: if use database configuration is enabled, formats are ignored # For nbi; use hexadecimal syntax to specify the byte value # - When the value is null in database : the value dumped to the file is filled by low value characters and the NBI is # equal to the byte 6F (the ? character) # - When the value is not null in database and the column is nullable: the NBI is equal to the byte 00 (low value) and NOT # equal to the byte 40 (space) 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
主要應用程式的可用屬性
此表格提供金鑰/值參數的詳盡檢視。
注意
如果您要遷移至 5.1.0 版或更新版本,並使用具有預設 openWarmUp 行為的 bluesam:
的預設值
bluesam.openWarmUp已從 變更為truefalse若要維護現有的行為,您必須明確設定
bluesam.openWarmUp=true
| 金錀 | Type | 預設值 | 說明 | 發行版本 |
|---|---|---|---|---|
|
|
number |
32760 |
用於 BDW 位元組的預設區塊大小。 |
|
|
|
boolean |
false |
決定應用程式是使用舊 DAO 架構還是新架構的全域旗標。這取決於 DAO 是使用舊設計還是新設計產生。 |
|
|
|
int |
1 |
指定使用者空間上的更新或設定操作數量,之後使用者空間會保留在外部資料儲存庫中。 |
5.75.0 |
|
|
int |
4096 |
指定用於配置使用者空間儲存體的頁面大小。任何指定時間的使用者空間大小一律是指定此數字的倍數。 |
4.10.0 |
|
|
支援的 Redis 屬性 |
指定使用者空間 redis 存放區的組態屬性,請參閱 大型主機執行期 AWS 轉換中可用的 Redis 快取屬性。 |
4.10.0 | |
|
|
string |
memory |
指定用於使用者空間登錄檔的存放區類型。支援的值為記憶體和 redis。如果未提供儲存類型,預設會使用記憶體。 |
4.10.0 |
|
|
number |
1000 |
指定輪詢 bluesam 狀態以檢查線上活動時,每次反覆運算之間的等待時間 (以毫秒為單位)。 |
4.5.0 |
|
|
string |
如果未設定,則不會使用Blusam快取。可能的值 (快取實作) 為 ehcache 和 redis (Redis 快取屬性)。 |
||
|
|
boolean |
false |
指定是否要在存取 bluesam 資料集之前檢查其狀態。 |
4.5.0 |
|
|
string【】 |
指定每個資料集的預先擷取視窗大小覆寫。每個項目格式: 請注意: - 請勿在冒號分隔符號周圍新增空格。 - - 以雙引號括住項目,或確保項目中沒有空格。 - 範例: |
||
|
|
boolean |
false |
是否Blusam完全停用。 |
|
|
|
string【】 |
指定開啟期間要快取的 bluesam 資料集清單。 請注意: - 此參數僅在 |
5.1.0 |
|
|
|
number |
100000 |
bluesam 遞交間隔。 |
|
|
|
number |
10 |
指定用於停用 bluesam 資料集以進行批次處理的執行緒集區大小上限。 |
4.5.0 |
|
|
number |
3 |
指定輪詢 bluesam 狀態失敗時的重試次數上限。 |
4.5.0 |
|
|
string【】 |
指定在應用程式啟動時,將索引中繼資料預先載入至永久記憶體內快取的 bluesam 資料集清單。 請注意: - 索引會載入 ApplicationReadyEvent,並在整個應用程式生命週期中保留。 - 僅適用於大型資料集。 |
||
|
|
boolean |
false |
指定是否在開啟期間快取任何 bluesam 資料集。 警告:中斷 5.1.0 版的變更 - 預設值從 變更為 |
5.1.0 |
|
|
int |
5 |
指定預先擷取時段大小的乘數,以判斷預先擷取時段容量上限。最大容量的計算方式為 |
|
|
|
int |
1000 |
指定要在記憶體中預先擷取和快取以進行 Redis 快取最佳化的記錄數目。此屬性僅在使用 Redis 快取時有效。 |
|
|
|
boolean |
false |
啟用時,BlueSAM 不會自動建立資料表,而是僅透過註冊中繼資料來採用外部受管資料表。 |
|
|
|
int |
1000 |
啟用 |
|
|
|
int |
1500 |
Redis deleteAll操作。 |
|
|
|
boolean |
false |
使用大型資料集時,啟用 Redis 快取清除操作的批次處理。 |
|
|
|
int |
1500 |
Redis 快取讀取操作的批次大小 (依 IDs 從快取大量讀取)。 |
|
|
|
int |
1000 |
在並行多執行緒寫入期間,大型資料集 (LargeKSDS、 LargeESDS) 每個資料集的內部位移追蹤映射中保留的項目數量上限。當映射超過此閾值時,它會修剪為 10 個最近的項目,以防止堆積耗盡,同時保留足夠的項目以避免 NullPointerException 同時執行緒存取。如果在大量大型資料集大量載入期間觀察到堆積壓力,請降低此值。 |
|
|
|
long |
0 |
中繼資料暖機快取中允許的索引項目數目上限。設為 0 表示無限制。 請注意: - 這是在 中設定的所有資料集的全域限制 - 達到限制時,會使用警告日誌略過其他索引。 |
|
|
|
boolean |
true |
指定是否快取資料庫中繼資料。 |
|
|
|
string |
CP1145 |
卡片編碼:要與 搭配使用 |
|
|
|
boolean |
true |
指定是否要在註冊之前檢查 groovy 檔案內容。 |
|
|
|
boolean |
false |
指定如果檔案大小是記錄大小的倍數,是否釋出檢查。 |
|
|
|
string |
CP297 |
CL 檔案的編碼。預期有效的編碼 |
|
|
|
string |
EBCDIC_STRICT |
用於編碼或解碼控制語言 (CL) 命令的模式。允許的值為 |
|
|
|
string |
true |
指定檔案是否包含計數資料列時不應包含的標頭。 |
|
|
|
boolean |
true |
指定是否要在應用程式啟動時清除暫存檔案資料夾的內容。 |
|
|
|
boolean |
false |
指定是否啟用計劃內容的預先建構。 |
|
|
|
number |
100 |
調整集區大小之任務每次執行之間的間隔。 |
|
|
|
number |
2 |
第一次需要內容時要建立的執行個體數量。 |
|
|
|
number |
5 |
調整任務執行時,用於在佇列中產生遺失執行個體的執行緒數目。 |
|
|
|
boolean |
true |
指定是否允許游標溢位。設定為 |
|
|
|
boolean |
false |
指定在已開啟的游標開啟時是否啟用提升 SQLCODE 錯誤 502。 |
|
|
|
boolean |
false |
指定是否允許 SQL 建置器收集和顯示統計資料資訊。 |
|
|
|
boolean |
false |
設為 true 時,可確保不會使用不正確的值建立 ByteRange。預設值為 false。 |
|
|
|
boolean |
false |
設定為 true 時, 會啟用 |
|
|
|
string |
IEEE_754 |
雙浮點數是用來編碼和解碼浮點數的格式。允許的值為 |
4.7.0 |
|
|
string |
PFD |
numproc 編譯器規格。允許的值為 |
|
|
|
string |
拒絕 |
解碼無效數值資料時如何反應。允許的值為 |
|
|
|
boolean |
true |
設為 true 時,包含無效 BCD nibble 的位元組 (十六進位 |
|
|
|
具有子索引鍵的標準彈簧資料來源 |
包含Blusam資料庫的連線資訊。或者,強烈建議使用 AWS 秘密,如 中所述Blusam 資料庫。 |
||
|
|
具有子索引鍵的標準彈簧資料來源 |
包含 Jics 資料庫的連線資訊。或者,強烈建議使用 AWS 秘密,如中所述JICS 資料庫。 |
||
|
|
string |
ISO |
dateTimeFormat 說明如何將資料庫日期時間戳記類型溢出至資料簡化器實體。允許的值為 |
|
|
|
string |
yyyy-MM-dd |
db 目標日期格式。 |
|
|
|
string |
HH:mm:ss |
db 目標時間格式。 |
|
|
|
string |
yyyy-MM-dd HH:mm:ss.SSSSSS |
db 目標時間戳記格式。 |
|
|
|
boolean |
false |
指定是否設定資料集預設先前值。 |
|
|
|
boolean |
false |
指定是否針對具有 DISP SHR 或 OLD 的資料集,釋出檔案存在的檢查。 |
|
|
|
boolean |
false |
指定是否啟用作用中的程式 ID 本機快取。請謹慎使用此功能,因為 JICS 資源可以在計劃和使用者之間共用。任何管理員都可以在外部變更這些資源,且已設置的本機快取可能會失效。 |
|
|
|
string |
ASCII |
專案中使用的編碼 (而非 groovy 檔案)。預期有效的編碼 |
|
|
|
datasize (範例:12 MB) |
排序閾值:決定系統何時應使用檔案系統的暫存檔案,從記憶體內切換到外部合併排序。如果未指定 (default= |
||
|
|
number |
游標的 fetchSize 值。依載入/卸載 utils 使用區塊擷取資料時使用 。 |
||
|
|
boolean |
false |
指定是否要在預設 |
|
|
|
string |
批次輸入/輸出檔案的 目錄。 |
||
|
|
string |
如果有,將日期強制為提供的日期。 |
||
|
|
boolean |
false |
指定是否停用所有 sql 字串參數的修剪。 |
|
|
|
boolean |
false |
指定是否在主控台或檔案輸出上使用人類可讀 SYSPRINT。 |
|
|
|
boolean |
true |
指定是否要凍結日期。僅適用於同時設定 的 |
|
|
|
string |
指定強制日期模式。設為 時 |
||
|
|
string |
|
當 |
|
|
|
string |
|
當 |
|
|
|
string |
|
切換全域安全組態 (XSS、CORS、CSRF、OAUTH 身分驗證...)。允許的值為 |
|
|
|
string【】 |
|
要允許的原始伺服器清單。此選項 |
|
|
|
string【】 |
null |
要封鎖的 URIs清單。當 |
|
|
|
string |
|
包含使用者所屬所有群組清單的宣告屬性。將 |
|
|
|
string【】 |
null |
要允許的自訂標頭清單。此選項 |
4.8.0 |
|
|
string |
|
切換篩選 URIs組態。允許的值為 |
|
|
|
string |
null |
全域身分驗證方法。建議值為 |
|
|
|
string |
null |
身分提供者 (IdP) 的發行者 URI。當 |
|
|
|
string |
|
用於識別使用者請求的宣告屬性名稱。將 |
|
|
|
boolean |
false |
啟用 CBLQDA 功能,在 OPEN 陳述式期間控制 QSAM 檔案的動態配置。此組態有助於動態配置程式中宣告的暫存檔案,即使檔案未在 JCL 指令碼中定義。 |
|
|
|
boolean |
false |
啟用記憶體最佳化功能,以控制應用程式快取的資料庫結構描述。透過智慧管理結構描述中繼資料,此組態有助於減少記憶體使用量,同時維持系統穩定性。它會自動包含一些常見的資料庫系統結構描述,可能需要這些結構描述才能正常運作。 |
4.9.0 |
|
|
list<String> |
null |
定義應快取的結構描述清單。 |
4.9.0 |
|
|
boolean |
false |
在插入查詢上使用儲存點,在失敗時啟用交易復原。啟用此屬性可能會影響資料庫效能。您可以使用query-to-database映射組態覆寫特定查詢的此設定。 |
4.6.0 |
|
|
integer |
8192 |
設定讀取循序檔案 |
|
|
|
string |
null |
在 gapwalk 中指定行分隔符號類型。允許的值為 WIN (CRLF) / UNIX (LF) / LINUX (LF)。系統會忽略其他值,並使用 System line.sepatator 屬性。 |
|
|
|
boolean |
false |
指定來自端點的回應 |
|
|
|
boolean |
false |
如果應用程式啟動時尚未設定,則表示將下列 |
|
|
|
string |
null |
|
|
|
|
string |
null |
|
|
|
|
string |
null |
|
|
|
|
string |
null |
|
|
|
|
string |
null |
|
|
|
|
string |
null |
指定模擬 CVT (通訊向量表) 的系統名稱值。 |
5.202.0 |
|
|
string |
null |
指定模擬 CVT (通訊向量表) 的 sysplex 名稱值。 |
5.202.0 |
|
|
string |
|
GDG 目錄路徑是存放 gdg 檔案的目錄。 |
4.6.0 |
|
|
boolean |
false |
指定是否要在 IMS 訊息上設定擴展大小。 |
|
|
|
string |
要使用的 IMS 程式清單。以分號 ( |
||
|
|
boolean |
true |
指定是否容忍封裝類型的無效資料。 |
|
|
|
boolean |
false |
指定是否啟用 JCL 檢查點機制以允許任務重新啟動。JCL 檢查點會在每個步驟或主要程式調用開始時建立並儲存至記憶體內登錄檔。如果定義持久性提供者,則所有步驟層級檢查點都會保留在任務結束時。 |
|
|
|
number |
-1 |
指定在持久性提供者或記憶體內登錄檔中保留 JCL 檢查點的持續時間。 |
|
|
|
string |
秒 |
指定 |
|
|
|
string |
null |
指定 JCL 檢查點機制持續性提供者。允許的值為 |
|
|
|
支援的 Redis 屬性 |
指定 JCL 檢查點機制 REDIS 持續性提供者的組態屬性,請參閱 支援的 Redis 屬性。 |
||
|
|
boolean |
true |
指定任務執行期間如何處理 null JCL 陳述式 (//)。當為 true 時, // 會立即終止任務 (EOF 模式)。當 false 時, // 會被視為 null 陳述式,且執行會繼續 (IGNORE 模式)。 |
|
|
|
string |
file:./setup/ |
如果 |
|
|
|
string |
無 |
檢查點持續性模式。允許的值為 |
|
|
|
string |
CP297 |
JHDB (Java 階層式資料庫) 編碼。預期有效的編碼字串 |
|
|
|
string |
用來將一些「運算子識別卡資料」硬式編碼至 CARD 參數指定的 MID 欄位。根據預設,空白,沒有輸入限制。 |
||
|
|
string |
在 IMS 模擬的情況下,可讓您強制使用常見的邏輯終端機 ID。如果未設定,則會使用 sessionId。 |
||
|
|
string |
file:./setup/ |
組態參數,指定 psb 和 dbds 資料夾的額外執行時間特定根資料夾。 |
|
|
|
number |
5000 |
RDBMS 階層導覽中使用的快取持續時間 (以毫秒為單位)。 |
|
|
|
boolean |
true |
指定是否要在 RDBMS 圖形上使用限制聯結用量參數。 |
|
|
|
boolean |
true |
指定是否要在 RDBMS 的階層導覽中啟用資料庫字首。 |
|
|
|
string |
|||
|
|
string |
定義用於初始化 JICS 資料庫之 SQL 指令碼的路徑。接受以逗號分隔的檔案和目錄清單,允許指定多個指令碼和資料夾。 |
||
|
|
string |
包含單一 sql 查詢的 sql 指令碼位置,預期會傳回物件計數 (例如:計算 jics 程式資料表中的記錄數目)。如果計數等於 0,則會使用 |
||
|
|
string |
Jics DDL 指令碼位置。可讓您使用 .sql 指令碼啟動 Jics 資料庫結構描述。預設為空白。例如, |
||
|
|
string |
應包含唯一查詢的 sql 檔案位置,該查詢會傳回 jics 結構描述中的物件數目 (如果有的話)。 |
||
|
|
string |
初始化 JICS 清單,以逗號分隔。如果存在,它會定義清單的逗號分隔名稱,以便在 CICS 清單之間的 Apache Tomcat 啟動時啟用。範例值: |
||
|
|
string |
CP037 |
在專用 JICS 佇列中寫入的 JCL 指令碼編碼。 |
|
|
|
string |
JICS |
JCL 指令碼可在執行時間逐行寫入的佇列名稱。 |
|
|
|
string |
速度 |
套用以識別 JICS 中的應用程式 (至少 4 個字元,無長度上限)。 |
|
|
|
string |
CP037 |
JICS 全域使用的字元集。 |
|
|
|
number |
0 |
常見工作區域 (CWA) 的長度。 |
|
|
|
string |
MMDDYY |
日期表單。 |
|
|
|
string |
TERM |
終端機識別符 (最多 4 個字元,最少 1 個字元)。 |
|
|
|
string |
MJOBNAME |
任務名稱。 |
|
|
|
string |
MYNETNAME |
網路名稱 (最多 8 個字元,最少 1 個字元)。 |
|
|
|
string |
XXX |
3 字元運算子識別。 |
|
|
|
string |
CICS |
系統識別 (SYSID)。 |
|
|
|
string |
SYSNAME |
AS400 系統名稱 (sysname)。 |
|
|
|
string |
藍山 |
JICS 暫時儲存佇列 (TSQ) 實作 (允許的值為 |
|
|
|
string |
使用者 ID (最多 8 個字元,沒有最小值)。未提供任何值時 (預設為空白),HTTP 工作階段 ID 會用作使用者 ID。 |
||
|
|
string |
MYUSERNAME |
使用者名稱 (最多 10 個字元,最少 1 個字元)。 |
|
|
|
string |
eu-west-1 |
Amazon Simple Queue Service AWS 的區域,用於 JICS。 |
|
|
|
支援的 Redis 屬性 |
指定 JICS TS Queues Redis 伺服器的組態屬性,請參閱 支援的 Redis 屬性。 |
||
|
|
支援的 Redis 屬性 |
指定 JICS Redis 伺服器連線工廠的組態屬性,請參閱 支援的 Redis 屬性。 |
||
|
|
boolean |
false |
指定是否要在 JICS 中啟用執行單位啟動器集區。 |
|
|
|
number |
2 |
調整任務執行時,用於在佇列中產生遺失執行個體的執行緒數目。 |
|
|
|
number |
20 |
JICS 中的執行單位啟動器集區大小。 |
|
|
|
number |
1000 |
調整集區大小之任務每次執行之間的間隔。 |
|
|
|
boolean |
false |
指定 SMTP 伺服器的偵錯模式。 |
|
|
|
string |
null |
指定 SMTP 伺服器主機。範例: |
|
|
|
string |
null |
指定 SMTP 伺服器的登入密碼。 |
|
|
|
string |
null |
指定 SMTP 伺服器連接埠。範例:25 |
|
|
|
string |
null |
指定 SMTP 伺服器的使用者名稱。 |
|
|
|
number |
|||
|
|
string |
指定 Jildb 後端中使用的資料庫類型,例如 Oracle。 |
||
|
|
具有子索引鍵的標準彈簧資料來源 |
包含 Jics 資料庫的連線資訊。 |
||
|
|
int |
10000 |
指定 Jildb 中記錄保留機制的等待逾時期間,以毫秒為單位。 |
|
|
|
string |
CP1047 |
指定用於初始化任務層級儲存體的預設編碼。例如,BLU4IV 應用程式中的交換器使用此編碼初始化為零。 |
4.9.0 |
|
|
string |
|
執行 Groovy 批次指令碼時要新增至 MDC 的 URL 參數清單。 |
|
|
|
string |
本機日期格式的清單。使用 分隔每個格式 |
||
|
|
string |
本機時間格式的清單。使用 分隔每個格式 |
||
|
|
string |
本機時間戳記格式的清單。使用 分隔每個格式 |
||
|
|
number |
500 |
鎖定逾時,以毫秒為單位。 |
|
|
|
路徑 |
classpath:logback-main.xml |
參考 日誌傳回組態檔案的標準金鑰。您也可以使用其他標準日誌金鑰。 |
|
|
|
string |
&,@,%% |
轉換 controlM 變數時要使用的字首清單。每個以逗號分隔。 |
|
|
|
boolean |
true |
為 MF 自然行序列檔案啟用 null 插入。 |
4.4.0 |
|
|
boolean |
false |
啟用在 MF 自然行序列檔案中插入標籤字元。 |
4.4.0 |
|
|
boolean |
false |
指出是否要與相同的佇列管理員共用或重新建立 JMS 連線集區。 |
4.9.0 |
|
|
string |
|
指定 |
|
|
|
boolean |
false |
指定未設定 MQPMO_SYNCPOINT 或 MQPMO_NO_SYNCPOINT 時 MQ PUT 命令的預設行為。當設定為 true 時,它會充當 , |
|
|
|
支援的 Atomikos 連線原廠屬性 |
指定 JMS MQ 連線集區的組態屬性。 |
||
|
|
當 |
|||
|
|
string |
null |
IBMMQ 應用程式名稱。 |
|
|
|
string |
null |
IBMMQ 頻道名稱。 |
|
|
|
string |
null |
IBMMQ 主機名稱。 |
|
|
|
number |
0 |
IBMMQ 集區大小上限 。使用 0 時,會啟用無限數量的實體連線。 |
|
|
|
string |
null |
IBMMQ 使用者密碼。或者,強烈建議使用 AWS 秘密,如 中所述IBM MQ 密碼設定的秘密管理員。 |
|
|
|
number |
null |
IBMMQ 連接埠。 |
|
|
|
string |
null |
IBMMQ 佇列管理員名稱。 |
|
|
|
string |
null |
IBMMQ SSL 密碼套件。範例可以是 |
|
|
|
string |
null |
IBMMQ 使用者名稱。 |
|
|
|
boolean |
false |
指出傳送訊息的目標用戶端是否為非 JMS。原生 MQ 格式將用於非 JMS 用戶端,而 RFH2 格式將用於 JMS。 |
4.5.0 |
|
|
string |
null |
Rabbit MQ 主機名稱。 |
|
|
|
string |
null |
Rabbit MQ 密碼。 |
|
|
|
number |
null |
Rabbit MQ 連接埠。 |
|
|
|
string |
null |
Rabbit MQ 使用者。 |
|
|
|
string |
null |
Rabbit MQ 虛擬主機名稱。 |
|
|
|
string |
eu-west-3 |
AWS SQS MQ 服務的 AWS 區域。 |
|
|
|
string |
yyyy-MM-dd |
日期時間格式。 |
|
|
|
string |
HH.mm.ss |
用於 pgm (程式) 執行的時間格式。 |
|
|
|
string |
yyyy-MM-dd-HH.mm.ss.SSSSSS |
時間戳記格式。 |
|
|
|
number |
-1 |
指定任何程式/交易執行的逾時,以秒為單位。在此期間之後,系統會嘗試中斷程式。 |
|
|
|
number |
0 |
指定何時 |
|
|
|
boolean |
false |
是否啟用 QTEMP 資料庫記錄。 |
|
|
|
number |
9 |
QTEMP 唯一 ID 長度。 |
|
|
|
boolean |
false |
指定如果任務排程器處於待命模式,是否觸發任務執行。如果為 true,則啟用任務執行時不會觸發。 |
|
|
|
boolean |
false |
指定金鑰條件是否由金鑰串連建置。 |
|
|
|
string |
|
報告輸出路徑。 |
|
|
|
boolean |
false |
指定是否針對同步任務執行失敗,傳回 500 系列的 HTTP 回應碼。 |
4.10.0 |
|
|
boolean |
false |
指定是否要在執行時間例外狀況時轉返隱含執行單位交易。 |
|
|
|
long |
5 |
觸發指令碼的執行緒限制。 |
|
|
|
string |
30m |
指定工作階段逾時持續時間。範例: |
|
|
|
string |
Cookie |
指定要使用的工作階段追蹤模式。可能的值為 |
|
|
|
string |
null |
從 JICS 中的 AWS 登入資料設定檔載入登入資料。 |
|
|
|
string |
null |
指定 Bluesam 鎖定 Redis 快取的登入資料秘密 ARN,請參閱 AWS 大型主機執行期秘密的轉換。 |
|
|
|
string |
null |
指定 Bluesam Redis 快取的登入資料秘密 ARN,請參閱 AWS 大型主機執行期秘密的轉換。 |
|
|
|
string |
null |
指定 JCL 檢查點機制 Redis 持久性提供者的登入資料秘密 ARN,請參閱 AWS 大型主機執行期秘密的轉換。 |
|
|
|
string |
null |
指定 JICS TS Queues Redis 伺服器的登入資料秘密 ARN,請參閱 AWS 大型主機執行期秘密的轉換。 |
|
|
|
string |
null |
指定 JICS Redis 伺服器連線工廠的登入資料秘密 ARN,請參閱 AWS 大型主機執行期秘密的轉換。 |
|
|
|
boolean |
false |
標準金鑰。如果資料來源支援模式不是靜態 xa,則必須停用彈簧 JTA 交易自動設定。 |
|
|
|
string |
無 |
高可用性環境的工作階段快取。可能的值為 |
|
|
|
number |
選用。sql 程式碼點轉移。將舊版 RDBMS 資料遷移至現代 RDBMS 時可能遇到的控制角色的程式碼點轉移。例如,您可以指定 |
||
|
|
boolean |
true |
在連線重設操作期間啟用目前連線的自動遞交。啟用時, 在非 XA 環境中切換到新的資料來源連線之前, 會自動遞交目前的連線,以防止連線不穩定。停用時, 會在重設操作期間記錄有關潛在連線問題的警告訊息。 |
4.10.0 |
|
|
boolean |
false |
指定是否允許 SQL 整數溢位,表示是否允許在主機變數中放置較大的值。 |
|
|
|
string |
|
指定是否要在第一次交易時初始化預設任務。 |
|
|
|
boolean |
true |
指定在步驟失敗或完成執行時是否引發無效。 |
|
|
|
boolean |
true |
指定在找不到程式時是否停止執行。如果設定為 |
|
|
|
string |
MDY |
系統日期格式 DATFMT。 |
--- |
|
|
string |
/ |
系統日期分隔符號 DATSEP。 可能的值為斜線 (`/`)、破折號 (`–`)、句點 (`.`)、逗號 (`,`) 或空白 (` `)。值必須以雙引號 `""` 指定。 |
5.17.0 |
|
|
string |
|||
|
|
boolean |
false |
指定是否允許核心執行緒在 JCIS 中逾時。這可讓動態增長和縮減,即使與非零佇列結合 (因為最大集區大小只會在佇列已滿時增長)。 |
|
|
|
number |
5 |
當終端機中的交易透過 groovy 指令碼啟動時,就會建立新的執行緒。使用此參數來設定核心集區大小。 |
|
|
|
number |
10 |
當終端機中的交易透過 groovy 指令碼啟動時,就會建立新的執行緒。使用此參數來設定最大集區大小 (平行執行緒的數量上限)。 |
|
|
|
number |
50 |
當終端機中的交易透過 groovy 指令碼啟動時,就會建立新的執行緒。使用此參數來設定佇列大小。(= 達到 時 |
|
|
|
string |
null |
指定產生的暫存檔案的資料夾位置名稱。 |
|
|
|
string |
null |
指定模式,用來根據下列預先定義且可自訂的資訊,動態建置暫時資料夾的名稱。 HOST:主機名稱。 JOBID:任務的 ID。 HASHCODE:任務內容的雜湊碼。 TIMESTAMP:取得時間戳記時要使用的模式。暫時資料夾的目標名稱為 TMP_DIR_{tempFolderPattern}。例如,在下列模式的情況下,名稱將以任務 ID 開頭,並以 “timestamp”: tempFolderPattern: JOBID,HOST=xxxxx,HASHCODE,TIMESTAMP=yyyymmddhhmmsss 結尾。如果屬性 |
|
|
|
boolean |
true |
指定使用者輸入是否為大寫。 |
|
|
|
boolean |
false |
指定是否使用 control-M 規格取代變數。 |
|
|
|
boolean |
true |
決定 XmlGenerator 類別中產生的 XML 輸出格式樣式。設定為 時 |
4.8.0 |
選用 Web 應用程式的可用屬性
視您的現代化應用程式而定,您可能需要設定一或多個選用的 Web 應用程式,這些應用程式代表對 z/OS、AS/400 或 IMS/MFS 等相依性的支援。下表包含用於設定每個選用 Web 應用程式的可用金鑰/值參數清單。
gapwalk-utility-pgm.war
此選用的 Web 應用程式包含對 Z/OS 公用程式的支援。
此表格提供此應用程式金鑰/值參數的詳盡檢視。
| 金錀 | Type | 預設值 | 說明 | 發行版本 |
|---|---|---|---|---|
|
|
boolean |
true |
指定是否要將圖形資料轉換為完整寬度格式。 |
|
|
|
string |
ASCII |
公用程式中使用的編碼。預期有效的編碼 |
|
|
|
string |
|
如果有,將日期強制為提供的日期。 |
|
|
|
boolean |
true |
指定是否要凍結日期。僅適用於同時設定 的 |
|
|
|
string |
指定強制日期模式。設為 時 |
||
|
|
boolean |
false |
INFUTILB 公用程式是否需要處理 GRAPHIC DB2 資料欄。 |
|
|
|
boolean |
false |
IDCAMS DELETE 命令是否也應該從檔案目錄的每個子資料夾中移除相符的檔案。 |
5.155.0 |
|
|
string |
IDCAMS 公用程式程式中使用的編碼。預期有效的編碼 |
4.4.0 | |
|
|
boolean |
false |
如果設定為 true,如果遺失具有 SHR 或 OLD 處置的輸出 Blusam 資料集,IDCAMS REPRO 將提早失敗。 |
5.185.0 |
|
|
string |
mvs |
.jcl 檔案類型。允許的值為 |
|
|
|
boolean |
false |
將此參數設定為 , |
|
|
|
number |
0 |
負載公用程式批次大小。 |
|
|
|
string |
yyyy-MM-dd |
要使用的負載公用程式資料庫格式。 |
|
|
|
string |
HH:mm:ss |
要使用的負載公用程式資料庫時間。 |
|
|
|
string |
dd.MM.yyyy\dd/MM/yyyy\yyyy-MM-dd |
要使用的負載公用程式本機日期格式。 |
|
|
|
string |
HH:mm:ss\HH.mm.ss |
要使用的負載公用程式本機時間格式。 |
|
|
|
number |
0 秒 |
負載公用程式的 SQL 程式碼指標轉移。執行轉移字元程序。當您來自 DB2 的目標資料庫為 Postgresql 時為必要。 |
|
|
|
路徑 |
classpath:logback-utility.xml |
參考 日誌傳回組態檔案的標準金鑰。您也可以使用其他標準日誌金鑰。 |
|
|
|
具有子索引鍵的標準彈簧資料來源 |
|
如果不使用 JNDI,則包含應用程式資料庫的連線資訊。必須具有與現代化應用程式 YAML 檔案中相同的組態。 或者,強烈建議使用 AWS 秘密,如中所述用戶端資料庫。 |
|
|
|
string |
jdbc/primary |
如果使用 JNDI,則主要資料來源的 JNDI 名稱 (Java 命名和目錄界面)。 |
|
|
|
boolean |
false |
標準金鑰。如果資料來源支援模式不是靜態 xa,則必須停用彈簧 JTA 交易自動組態。 |
|
|
|
string |
ASCII |
syspunch 編碼字元集。預期有效的編碼 |
|
|
|
string |
ASCII |
SYSTIN 檔案資料集的編碼字元集。預期有效的編碼 |
4.5.0 |
|
|
boolean |
false |
指定是否將大型數字視為 |
|
|
|
boolean |
false |
指定是否要處理卸載公用程式的 INTO bmc 控制關鍵字。 |
|
|
|
number |
0 |
用於卸載公用程式的區塊大小。 |
|
|
|
string |
空格 |
卸載公用程式資料欄填充。 |
|
|
|
boolean |
false |
決定是否要計算未指定的記錄大小。如果指定,則值保持不變。 |
|
|
|
number |
0 |
可讓您在卸載公用程式中處理游標時調整擷取大小。 |
|
|
|
string |
MM/dd/yyyy |
如果 |
|
|
|
string |
HH.mm.ss |
如果 |
|
|
|
string |
yyyy-MM-dd-HH.mm.ss.SSSSSS |
如果 |
|
|
|
十六進位 |
00 |
當來自資料庫的值不是 null 時,要新增的 Null 位元組指標 (NBI) 值。 |
|
|
|
十六進位 |
6F |
當資料庫的值為 Null 時,要新增的 Null Byte Indicator (NBI) 值。 |
|
|
|
boolean |
false |
指定是否要在卸載輸出檔案中寫入 null 指標。 |
|
|
|
boolean |
true |
表示要卸載可變長度字元 (VARCHAR) 欄位,而不會填補到最大長度。 |
4.5.0 |
|
|
number |
0 |
卸載公用程式的 SQL 程式碼指標轉移。執行轉移字元程序。當您來自 DB2 的目標資料庫為 Postgresql 時為必要。 |
|
|
|
boolean |
false |
指定是否要在卸載公用程式中使用 application-main.yml 的日期或時間組態。 |
|
|
|
boolean |
false |
在 INFTILB 程式中使用此參數,如果設定為 |
|
|
|
string |
EBCDIC_STRICT |
編碼或解碼區域資料類型的模式。允許的值為 |
gapwalk-cl-command.war
此選用的 Web 應用程式包含對 AS/400 公用程式的支援。
此表格提供此應用程式金鑰/值參數的詳盡檢視。
| 金錀 | Type | 預設值 | Description |
|---|---|---|---|
|
|
string |
|
要關閉的命令清單,以逗號分隔。允許的值為 |
|
|
string |
ASCII |
公用程式中使用的編碼。預期有效的編碼 |
|
|
string |
|
如果有,將日期強制為提供的日期。 |
|
|
string |
|
指定強制日期模式。設為 時 |
|
|
路徑 |
classpath:logback-utility.xml |
參考 日誌傳回組態檔案的標準金鑰。您也可以使用其他標準日誌金鑰。 |
|
|
具有子索引鍵的標準彈簧資料來源 |
|
如果不使用 JNDI,則包含應用程式資料庫的連線資訊。必須具有與現代化應用程式 YAML 檔案中相同的組態。 或者,強烈建議使用 AWS 秘密,如中所述用戶端資料庫。 |
|
|
string |
jdbc/primary |
如果使用 JNDI,則主要資料來源的 JNDI 名稱 (Java 命名和目錄界面)。 |
|
|
boolean |
false |
標準金鑰。如果資料來源支援模式不是靜態 xa,則必須停用彈簧 JTA 交易自動組態。 |
|
|
string |
EBCDIC_STRICT |
編碼或解碼區域資料類型的模式。允許的值為 |
gapwalk-hierarchical-support.war
此選用的 Web 應用程式包含 IMS/MFS 交易支援。
此表格提供此應用程式金鑰/值參數的詳盡檢視。
| 金錀 | Type | 預設值 | Description |
|---|---|---|---|
|
|
string |
Jhdb 後端類型。預期值為 |
|
|
|
string |
無 |
檢查點持續性模式。允許的值為 |
|
|
string |
|
JHDB (Java 階層式資料庫) 編碼。預期有效的編碼字串 |
|
|
boolean |
false |
是否要在 IMS 插入期間保留 _parent 和 _logicalparent。設為 true 時,IMS ISRT 呼叫會將 _parent 和 _logicalparent 插入資料庫資料欄。 |
|
|
int |
-1 |
指定任何 jhdb 交易執行的逾時,以秒為單位。在此期間之後,系統會嘗試中斷程式。如果值為 -1 (預設),則不會設定逾時。 |
|
|
string |
要宣告為整個交易的程式清單。使用逗號 () 分隔每個程式 |
|
|
|
路徑 |
classpath:logback-utility.xml |
參考 日誌傳回組態檔案的標準金鑰。您也可以使用其他標準日誌金鑰。 |
|
|
string |
具有子索引鍵的標準彈簧資料來源 |
包含 jhdb 資料庫的中繼資料資訊,包括 psb、dbds、連線。或者,強烈建議使用 AWS 秘密。 |
|
|
boolean |
false |
標準金鑰。如果資料來源支援模式不是靜態 xa,則必須停用彈簧 JTA 交易自動組態。 |
gapwalk-gs21.war
使用此選用的 Web 應用程式,在您的 AWS Mainframe Modernization 環境中執行 Fujitsu GS21 平台程式。只有當您的現代化工作負載包含 GS21 程式時,才能安裝此應用程式。
下表說明此應用程式的鍵值參數。
| 金錀 | Type | 預設值 | 說明 |
|---|---|---|---|
|
|
標準 Spring 資料來源與子索引鍵 |
無 |
存放 GS21 資料庫的連線資訊。我們建議將 AWS Secrets Manager 用於資料庫登入資料。如需詳細資訊,請參閱用戶端資料庫。 |
|
|
列出 |
無 |
設定應用程式整合模組 (AIM) 通訊端連線。每個項目都是通訊端伺服器組態或通訊端用戶端組態。 通訊端伺服器項目金鑰: 通訊端用戶端項目金鑰: |
|
|
Spring 執行緒集區執行器組態 |
無 |
設定產生 AIM 程序的執行緒集區執行器 (例如 SMQNs、通訊端處理常式和訊息回覆處理常式)。 |
用戶端應用程式的可用屬性
您的現代化應用程式可能需要用戶端 Spring 應用程式的特定屬性組態。這些屬性會從執行時間 JAR 檔案中封裝的類別初始化 Bean。在應用程式產生期間設定設定檔值application-profile.yaml的檔案,可讓您設定這些屬性。下表列出可用於設定用戶端 Web 應用程式的金鑰/值參數,該應用程式使用來自 Gapwalk 執行時間中封裝類別的 Bean
| 金錀 | Type | 預設值 | 說明 | 發行版本 |
|---|---|---|---|---|
|
|
boolean |
false |
啟用記憶體內快取。 |
4.8.0 |
|
|
boolean |
false |
將追蹤請求數量新增至快取。 |
4.8.0 |
|
|
string |
要快取的資料庫資料表清單。 |
4.8.0 | |
|
|
string |
應針對指定資料表啟用快取的程式識別符。快取可供執行堆疊中的所有子程式使用。 |
4.8.0 | |
|
|
number |
10000 |
快取的大小。 |
4.8.0 |
|
|
number |
10 |
輸入 DAO 操作的內部快取大小。此快取存在於程式層級 (單一執行個體)。 |
4.9.0 |
|
|
string |
blu4iv 資料庫的排序函數名稱。 |
4.9.0 | |
|
|
string |
JPA |
指定要使用的資料存取實作 (JPA 或 JDBC)。 |
4.9.0 |
|
|
boolean |
false |
在資料區域操作的內容中控制程式庫的使用。如果設為 true,則會針對資料區域操作停用程式庫用量,但這不會影響 QTemp 的用量。如果設定為 false,則在執行資料區域的 CRUD 操作時,會考慮程式庫。 |
4.5.0 |
|
|
boolean |
false |
啟用使用程式庫清單來解析檔案庫。 |
4.10.0 |
|
|
string |
從左到右排序的程式庫初始清單。 |
4.10.0 |
設定 AS400 應用程式的記憶體內快取
記憶體內快取功能可讓使用者在記憶體內快取唯讀資料,大幅改善資料密集型程式的效能。快取系統以三種方式最佳化效能:僅在第一次存取時載入資料、隨需建立資料存取映射,以及有效率地在程式記憶體附近存放快取資料。此設計可最大限度地減少記憶體負荷,同時最大限度地提高速度。
################################################################### # Cache configuration for read operations called from DAO classes # ################################################################### blu4iv: dao: cache: enabled: true enabledHits: true initMaxResults: 100000 entries: - fileIds: [${TABLEA}] programIds: [${PROGRAM1}] - fileIds: [${TABLEB},${TABLEC}] programIds: [${PROGRAM2}] librarylist: enabled: true libraries: ["LIBA","LIBC","LIBE"]
設定 API 存取記錄
API 存取記錄功能會記錄對 BAC、JAC 和 Gapwalk 應用程式提出 API 請求的詳細資訊,透過追蹤存取內容的人員和時間,協助滿足安全需求。
| 金錀 | Type | 預設值 | 說明 | 發行版本 |
|---|---|---|---|---|
|
|
boolean |
false |
啟用 BAC、JAC 和 Gapwalk 應用程式的 API 存取記錄。啟用時, 會使用詳細資訊記錄所有 API 請求。 |
5.0.0 |
啟用時,使用者可以提供日誌傳回檔案組態,以使用記錄器名稱 ,在所選位置記錄 API 存取日誌api.access。日誌可以包含下列 MDC 欄位:
| MDC 欄位 | 說明 |
|---|---|
|
|
託管 API 的位置 |
|
|
提出 API 請求的日期和時間 |
|
|
處理 API 請求所需的時間 (毫秒) |
|
|
API 請求來自的來源地址 |
|
|
提出的 HTTP 請求類型 (例如 GET、POST、DELETE、...) |
|
|
存取的端點/URI |
|
|
API 請求完成後傳回的狀態碼 |
|
|
使用的傳輸通訊協定,例如 HTTP 或 HTTPS。 |
|
|
用於保護 API 呼叫的安全方法 (例如 OAuth2、權杖、匿名) |
|
|
使用者目前登入工作階段的唯一識別符 |
|
|
提出 API 請求的人員的使用者名稱或識別符 |
若要設定 API 存取日誌的專用日誌檔案,請將下列項目新增至您的日誌傳回組態:
<!-- File appender --> <appender name="ApiAccessFile" class="ch.qos.logback.core.FileAppender"> <file>logs/main/main-api-access.log</file> <immediateFlush>true</immediateFlush> <encoder> <pattern>%date %X{api-scheme} %X{api-host} %X{api-method} %X{api-name} - Return code: %X{api-retcode} - Start date: %X{api-date} - Duration: %X{api-duration} ms - User: %X{api-user} - SessionId: %X{api-sessionid} - SecureMethod: %X{api-secure} %n</pattern> </encoder> </appender> <logger name="api.access" level="info" additivity="false"> <appender-ref ref="ApiAccessFile" /> <appender-ref ref="CONSOLE" /> </logger>
日誌輸出範例:
2025-06-13 22:24:36,174 http 127.0.0.1 GET /bac/api/services/rest/bluesamservice/listDataSet - Return code: 200 - Start date: 06-13-2025 22:24:35.863+0200 - Duration: 308 ms - User: velocity_admin - SessionId: 1X1X1X1X1X1X1X1X1X1X1X1X1X1X1X1X- SecureMethod: Oauth2
設定分散式追蹤
分散式追蹤功能透過從 HTTP 請求傳播 traceId 和 spanId,啟用end-to-end請求追蹤,從而在整個請求生命週期之間相互關聯日誌。 GapWalk
| 金錀 | Type | 預設值 | 說明 | 發行版本 |
|---|---|---|---|---|
|
|
boolean |
false |
啟用 GapWalk 應用程式的分散式追蹤。啟用時,傳播 traceId 和 spanId 以進行批次任務執行。 |
啟用時,追蹤功能會傳播追蹤內容。日誌可以包含下列 MDC 欄位:
| MDC 欄位 | 說明 |
|---|---|
|
spanId |
追蹤內目前操作的唯一識別符 |
|
traceId |
所有服務和執行緒中整個請求流程的唯一識別符 |
若要設定分散式追蹤,請更新您的日誌傳回組態,以在日誌模式中包含 traceId 和 spanId。新增或更新下列屬性:
<property name="DEFAULT_LOG_PATTERN" value="%date{yyyy-MM-dd HH:mm:ss} %-15.15contextName %-5.5level [%X{traceId:-},%X{spanId:-}] - %-40.40logger{15} - %msg%n" />
日誌輸出範例:
2026-02-02 20:00:00 default INFO [6966b3c1dc96c2da73be7e2b6f9f25dc,73be7e2b6f9f25dc] - q.t.s.i.TestJobProcessImpl - Length is: 100