View a markdown version of this page

Abilita proprietà per AWS Transform for mainframe Runtime - AWS Modernizzazione del mainframe

Dopo un'attenta valutazione, abbiamo deciso di chiudere l'accesso dei nuovi clienti all'esperienza autogestita di AWS Mainframe Modernization, a partire dal 30 giugno 2026. I clienti esistenti possono continuare a utilizzare il servizio normalmente.AWS continua a investire in miglioramenti della sicurezza e della disponibilità per l'esperienza di autogestione della modernizzazione del AWS mainframe, ma non abbiamo intenzione di introdurre nuove funzionalità. Per ulteriori informazioni, consulta Modifica della disponibilità di AWS Mainframe Modernization.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AWS Il servizio di modernizzazione del mainframe (esperienza Managed Runtime Environment) non è più aperto a nuovi clienti. Per funzionalità simili a AWS Mainframe Modernization Service (esperienza Managed Runtime Environment), esplora AWS Mainframe Modernization Service (Experience). Self-Managed I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta Modifica della disponibilità di AWS Mainframe Modernization.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Abilita proprietà per AWS Transform for mainframe Runtime

Nelle applicazioni Spring Boot application-main.yml c'è il file di configurazione in cui definiamo diversi tipi di proprietà come la porta di ascolto, la connettività del database e molte altre. È possibile utilizzare questa pagina per conoscere le proprietà disponibili per AWS Transform for mainframe Runtime e come abilitarle.

Notazione YML

Nella seguente documentazione, una proprietà come questa parent.child1.child2=true è scritta come segue in formato YAML.

parent: child1: child2: true

Avvio rapido/Casi d'uso

I seguenti casi d'uso mostrano esempi delle chiavi e dei valori applicabili.

  • Application-main.yml predefinito

    ---- #### 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 ----
  • Usa file a lunghezza variabile con i comandi 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)
  • Fornisci un valore dell'indicatore Null Byte nell'utilità LOAD/UNLOAD

    # 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

Proprietà disponibili per l'applicazione principale

Questa tabella fornisce una panoramica esaustiva dei key/values parametri.

Nota

Se stai migrando alla versione 5.1.0 o successiva e utilizzi bluesam con il comportamento di apertura predefinito: WarmUp

  • Il valore predefinito di è cambiato da a bluesam.openWarmUp true false

  • Per mantenere il comportamento esistente, è necessario impostare in modo esplicito bluesam.openWarmUp=true

Chiave Tipo Valore predefinito Description Versione di rilascio

blockSizeDefault

numero

32760

La dimensione del blocco predefinita da utilizzare per i byte BDW.

blu4iv.dataaccess.useOldDaoDesign

booleano

false

Un flag globale che determina se l'applicazione deve utilizzare la vecchia architettura DAO o la nuova. Ciò dipende dal fatto che i DAO siano stati generati utilizzando un design vecchio o nuovo.

blu4iv.userspace.batchThreshold

int

1

Speciifica il numero di operazioni di aggiornamento o impostazione su uno spazio utente dopo le quali lo spazio utente viene mantenuto in un archivio di dati esterno.

5.75.0

blu4iv.userspace.pageSize

int

4096

Speciifica la dimensione della pagina utilizzata per allocare lo spazio di archiviazione per gli spazi utente. La dimensione dello spazio utente in un dato momento è sempre un multiplo di questo numero specificato.

4.10.0

blu4iv.userspace.redis.*

Proprietà Redis supportate

Specifica le proprietà di configurazione per gli spazi utente redis store, vedi. Proprietà della cache Redis disponibili in AWS Transform for mainframe Runtime

4.10.0

blu4iv.userspace.store-type

stringa

memory

Speciifica il tipo di archivio utilizzato per il registro dello spazio utente. I valori supportati sono memory e redis. Se non viene fornito alcun tipo di archivio, per impostazione predefinita viene utilizzata la memoria.

4.10.0

bluesam.bluesamStatusPollingInterval

numero

1000

Speciifica il tempo (in millisecondi) di attesa tra ogni iterazione durante il polling di bluesam status per verificare le attività online.

4.5.0

bluesam.cache

stringa

Se non è impostata, la cache non verrà utilizzata. Blusam I valori possibili (implementazioni della cache) sono ehcache e redis (). Proprietà della cache Redis

bluesam.checkBluesamStatus

booleano

false

Speciifica se controllare o meno lo stato del set di dati bluesam prima di accedervi.

4.5.0

bluesam.datasetPrefetchWindowSize

stringa []

Specifica le sostituzioni delle dimensioni della finestra di prefetch per set di dati. Ogni "datasetName:size" formato di immissione:. Se un set di dati non è elencato, torna al bluesam.prefetchWindowSize valore globale.

Nota:

- Non aggiungete spazi attorno al separatore di due punti.

- I nomi dei set di dati contenenti | sono supportati (utilizza l'ultimo punto come delimitatore).

- Raccogli le voci tra virgolette doppie o assicurati che non ci siano spazi nella voce.

- Esempio: "fileset1|MYFILE:10000"

bluesam.disabled

booleano

false

Se disabilitare Blusam completamente.

bluesam.fileList

stringa []

Speciifica l'elenco dei set di dati bluesam da memorizzare nella cache durante l'apertura.

Nota:

- Questo parametro è efficace solo quando è impostato su. bluesam.openWarmUp false

5.1.0

bluesam.fileLoading.commitInterval

numero

100000

L'intervallo di commit di bluesam.

bluesam.maxBluesamDisablingThreadpoolSize

numero

10

Specifica la dimensione massima del threadpool utilizzata per disabilitare i set di dati bluesam per l'elaborazione in batch.

4.5.0

bluesam.maxBluesamStatusPollingRetry

numero

3

Speciifica il numero massimo di tentativi quando il polling bluesam status non riesce.

4.5.0

bluesam.metadataWarmUpFileList

stringa []

Specifica l'elenco dei set di dati bluesam i cui metadati dell'indice verranno precaricati in una cache in memoria permanente all'avvio dell'applicazione.

Nota:

- Gli indici vengono caricati e persistono per l'intero ciclo di vita dell'applicazione. ApplicationReadyEvent

- Efficace solo per set di dati di grandi dimensioni.

bluesam.openWarmUp

booleano

false

Specifica se memorizzare nella cache eventuali set di dati bluesam durante l'apertura.

Avviso: Breaking Change nella versione 5.1.0

- Il valore predefinito è cambiato da true a. false

5.1.0

bluesam.prefetchWindowMultiples

int

5

Specifica il moltiplicatore per la dimensione della finestra di prefetch per determinare la capacità massima della finestra di prefetch. La capacità massima viene calcolata come. prefetchWindowSize × prefetchWindowMultiples Questa proprietà è efficace solo quando si utilizza la cache Redis.

bluesam.prefetchWindowSize

int

1000

Specifica il numero di record da precaricare e memorizzare nella cache per l'ottimizzazione della cache Redis. Questa proprietà è efficace solo quando si utilizza la cache Redis.

bluesam.redis.batchClearSize

int

1000

La dimensione del batch per le operazioni di cancellazione della cache Redis quando bluesam.redis.enableBatchClear è abilitata.

bluesam.redis.deleteAllBatchSize

int

1500

Dimensione del batch per le operazioni Redis DeleteAll per ottimizzare le prestazioni quando si lavora con set di dati di grandi dimensioni.

bluesam.redis.enableBatchClear

booleano

false

Abilita l'elaborazione in batch per le operazioni di cancellazione della cache Redis quando lavori con set di dati di grandi dimensioni.

bluesam.redis.readBatchSize

int

1500

Dimensione del batch per le operazioni di lettura della cache Redis (lettura in blocco dalla cache tramite ID).

bluesam.sizesCleanUpThreshold

int

1000

Numero massimo di voci conservate nella mappa interna di tracciamento dell'offset per set di dati di grandi dimensioni (LargeKSD, LargeeSD) durante le scritture multithread simultanee. Quando la mappa supera questa soglia, viene ridotta alle 10 voci più recenti per evitare l'esaurimento dell'heap, preservando al contempo un numero sufficiente di voci per evitare l'accesso simultaneo ai thread. NullPointerException Riduci questo valore se si osserva la pressione dell'heap durante carichi di grandi quantità di set di dati ad alto volume.

bluesam.warmUpMetadataCacheLimit

Long

0

Numero massimo di voci di indice consentite nella cache di riscaldamento dei metadati. Imposta su 0 per un numero illimitato.

Nota:

- Si tratta di un limite globale per tutti i set di dati configurati inbluesam.metadataWarmUpFileList.

- Quando viene raggiunto il limite, gli indici aggiuntivi vengono ignorati con un registro degli avvisi.

cacheMetadata

booleano

true

Specifica se memorizzare nella cache i metadati del database.

card.encoding

stringa

CP1145

Codifica delle carte: da utilizzare con. useControlMVariable

check-groovy-file

booleano

true

Specifica se controllare il contenuto dei file Groovy prima della registrazione.

checkinputfilesize

booleano

false

Specifica se rilasciare un segno di spunta se la dimensione del file è un multiplo della dimensione del record.

cl.configuration.context.encoding

stringa

CP297

La codifica dei file CL. Prevede una codifica validaCP1047,,IBM930... ASCII UTF-8 Il valore predefinito è CP297

cl.zonedMode

stringa

EBCDIC_STRICT

La modalità per la codifica o la decodifica dei comandi del linguaggio di controllo (CL). I valori consentiti sonoEBCDIC_STRICT//EBCDIC_MODIFIED. AS400

clcommand.rtvmbrd.hasHeader

stringa

true

Specificate se i file contengono intestazioni che non devono essere incluse nel conteggio delle righe.

cleanTempFilesDirectoryAtStartup

booleano

true

Speciifica se eliminare il contenuto della cartella dei file temporanei all'avvio dell'applicazione.

context.preconstruct.enable

booleano

false

Speciifica se attivare la precostruzione del contesto del programma.

context.preconstruct.frequencyInMillis

numero

100

L'intervallo tra ogni esecuzione dell'attività che regola le dimensioni del pool.

context.preconstruct.minInstances

numero

2

Il numero di istanze che verranno create la prima volta che è necessario un contesto.

context.preconstruct.parallelism

numero

5

Il numero di thread utilizzati per produrre le istanze mancanti nella coda durante l'esecuzione dell'attività di regolazione.

database.cursor.overflow.allowed

booleano

true

Speciifica se consentire l'overflow del cursore. Imposta per true eseguire una chiamata successiva sul cursore indipendentemente dalla sua posizione. Imposta false per verificare se il cursore si trova nell'ultima posizione prima di eseguire una chiamata successiva sul cursore. Abilita solo se il cursore è SCORREVOLE (SENSITIVE o INSENSITIVE).

database.cursor.raise.already.opened.error

booleano

false

Specifica se abilitare la generazione dell'errore SQLCODE 502 quando si apre un cursore già aperto.

databaseStatistics

booleano

false

Speciifica se consentire ai costruttori di SQL di raccogliere e visualizzare informazioni statistiche.

dataSimplifier.byteRangeBoundsCheck

booleano

false

Se impostato su true, assicura che non ByteRange venga creato nessun valore con valori errati. Il valore predefinito è false.

dataSimplifier.doubleFloatingType

stringa

IEEE_754

Il tipo a doppia virgola mobile è il formato usato per codificare e decodificare un numero a virgola mobile. I valori consentiti sonoIEEE_754/HFP(per il formato esadecimale a virgola mobile). Il valore predefinito è IEEE_754.

4.7.0

dataSimplifier.numproc

stringa

PDF

specificazione del compilatore numproc. I valori consentiti sono//PFD/. NOPFD MIG Il valore predefinito è PFD.

dataSimplifier.onInvalidNumericData

stringa

rifiutare

Come reagire quando si decodificano dati numerici non validi. I valori consentiti sonoreject///toleratespaces. toleratespaceslowvalues toleratemost L'impostazione predefinita èreject.

dataSimplifier.zeroInvalidBcdNibbles

booleano

true

Se impostato su true, i byte contenenti nibble BCD non validi (cifre esadecimali, F nelle posizioni delle cifre) vengono A trattati come durante la decodifica decimale compressa. 00 Il valore predefinito è true.

datasource.bluesamDs + -driver-class-name + -url + -username + -password + -type

Fonte di dati Spring standard con sottochiavi

Contiene le informazioni di connessione per il database. Blusam In alternativa, l'uso dei AWS segreti è fortemente incoraggiato, come spiegato inDatabase Blusam.

datasource.jicsDs + -driver-class-name + -url + -username + -password + -type

Fonte di dati Spring standard con sottochiavi

Contiene le informazioni di connessione per il database Jics. In alternativa, l'uso dei AWS segreti è fortemente incoraggiato, come spiegato in. Database JICS

dateTimeFormat

stringa

ISO

La data TimeFormat descrive come trasferire la data, l'ora e il tipo di timestamp del database in entità semplificatrici di dati. I valori consentiti sono///ISOEUREURUSALOCAL

dbDateFormat

stringa

yyyy- MM-dd

Il formato della data di destinazione del db.

dbTimeFormat

stringa

HH:mm:ss

Il formato dell'ora di destinazione del db.

dbTimestampFormat

stringa

yyyy- MM-dd HH:mm:ss.SSSSSS

Il formato del timestamp di destinazione di db.

defaultKeepExistingFiles

booleano

false

Speciifica se impostare il valore precedente predefinito del set di dati.

disposition.checkexistence

booleano

false

Speciifica se rilasciare un controllo sull'esistenza dei file per Dataset with DISP SHR o OLD.

enableActivePgmIdCache

booleano

false

Speciifica se abilitare la cache locale dell'ID del programma attivo. Utilizzate con attenzione questa funzionalità perché le risorse JICS possono essere condivise tra programmi e utenti. Tali risorse possono essere modificate esternamente da qualsiasi amministratore e la cache locale installata potrebbe essere invalidata.

encoding

stringa

ASCII

La codifica utilizzata nei progetti (non nei file groovy). Prevede una codifica CP1047 valida,,... IBM930 ASCII UTF-8

externalSort.threshold

dimensione dei dati (esempio: 12 MB)

La soglia di ordinamento: determina quando il sistema deve passare dall'ordinamento in memoria a quello di unione esterna utilizzando file temporanei sul file system. Se non viene specificata (default=null), la soglia viene impostata sulla metà della memoria disponibile per ogni nuova operazione di ordinamento. Per stimare la memoria disponibile, viene eseguita una chiamata a System.gc ().

fetchSize

numero

Il valore fetchSize per i cursori. Da utilizzare quando si recuperano dati utilizzando chunks by utils. load/unload

file.stdoutIntoLogger

booleano

false

Speciifica se abilitare la scrittura su logger anziché sul flusso di output di sistema predefinito in default and files. SYSPRINT SYSPUNCH

filesDirectory

stringa

La directory per i file batch input/output .

forcedDate

stringa

Impone la data alla data fornita, se presente.

forceDisableSQLTrimStringType

booleano

false

Speciifica se disabilitare il taglio di tutti i parametri della stringa sql.

forceHR

booleano

false

Speciifica se utilizzare Human Readable SYSPRINT, sulla console o sull'output del file.

frozenDate

booleano

true

Speciifica se bloccare la data. Si applica solo se forcedDate è impostata anche.

forcedDateMode

stringa

Specifica la modalità di data forzata. Se impostata suHYBRID, la parte relativa alla data è la data forzata configurata, ma la parte relativa all'ora riflette l'ora effettiva del sistema. Si applica solo se forcedDate è impostata anche questa opzione.

gapwalk-application.defaultSuperAdminUserName

stringa

sadmin

Quando gapwalk-application.security è disabilitato, specifica il nome utente privilegiato locale predefinito.

gapwalk-application.defaultSuperAdminUserPwd

stringa

sadmin

Quando gapwalk-application.security è disabilitato, specifica la password di super utente locale predefinita.

gapwalk-application.security

stringa

disabled

Attiva la configurazione di sicurezza globale (autenticazione XSS, CORS, CSRF, OAUTH...). I valori consentiti sono disabled e enabled.

gapwalk-application.security.allowedOrigins

stringa []

null

L'elenco delle origini da consentire. Questa opzione deve gapwalk-application.identity essere impostata suoauth.

gapwalk-application.security.blockedURIs

stringa []

null

L'elenco degli URI da bloccare. Questa opzione è obbligatoria quando gapwalk-application.security.filterURIs èenabled.

gapwalk-application.security.claimGroupName

stringa

cognito:groups

L'attributo claim che contiene l'elenco di tutti i gruppi a cui appartiene un utente. cognito:groupsUtilizzalo per Amazon Cognito o qualsiasi altra stringa per un IdP esterno.

gapwalk-application.security.customAllowedHeaders

stringa []

null

L'elenco delle intestazioni personalizzate da consentire. Questa opzione deve gapwalk-application.identity essere impostata su. oauth

4.8.0

gapwalk-application.security.filterURIs

stringa

disabled

Attiva la configurazione degli URI di filtraggio. I valori consentiti sono disabled e enabled.

gapwalk-application.security.identity

stringa

null

Metodo di autenticazione globale. Il valore consigliato èoauth. I valori consentiti sono json e oauth. Questa opzione è obbligatoria quando gapwalk-application.security èenabled.

gapwalk-application.security.issuerUri

stringa

null

L'URI dell'emittente del provider di identità (IdP). Questa opzione è obbligatoria quando gapwalk-application.identity è. oauth

gapwalk-application.security.userAttributeName

stringa

username

Il nome dell'attributo claim utilizzato per identificare una richiesta dell'utente. Utilizzalo username per Amazon Cognito, preferred_username per Keycloak o qualsiasi altra stringa per un IdP esterno.

gapwalk.cobol.cblqda.enabled

booleano

false

Abilita una funzionalità CBLQDA che controlla l'allocazione dinamica dei file QSAM durante un'istruzione OPEN. Questa configurazione aiuta ad allocare dinamicamente i file temporanei dichiarati nel programma, anche se i file non sono definiti nello script JCL.

gapwalk.database.metadata.schema-inclusion.enabled

booleano

false

Abilita una funzionalità di ottimizzazione della memoria che controlla quali schemi di database vengono memorizzati nella cache da un'applicazione. Questa configurazione aiuta a ridurre l'ingombro della memoria mantenendo al contempo la stabilità del sistema gestendo in modo intelligente i metadati dello schema. Include automaticamente alcuni schemi di sistema di database comuni che potrebbero essere necessari per il corretto funzionamento.

4.9.0

gapwalk.database.metadata.schema-inclusion.schemas.global

elenco <String>

null

Definisce un elenco di schemi che devono essere memorizzati nella cache.

4.9.0

gapwalk.database.support.useSavePointToRestoreFail

booleano

false

Consente il ripristino delle transazioni in caso di errore utilizzando i savepoint nelle query di inserimento. L'attivazione di questa proprietà può influire sulle prestazioni del database. È possibile sovrascrivere questa impostazione per query specifiche utilizzando la configurazione di mappatura tra query e database.

4.6.0

gapwalk.io.sequential.readBufferSize

intero

8192

Imposta la dimensione del buffer (in byte) per la lettura di file sequenziali. BufferedInputStream L'aumento di questo valore riduce il numero di operazioni di I/O lettura, il che può migliorare le prestazioni durante la lettura di file di grandi dimensioni da sistemi di storage collegati alla rete come Amazon EFS.

gapwalk.line.separator

stringa

null

Specifica il tipo di separatore di riga in gapwalk. I valori consentiti sono WIN (CRLF)/UNIX (LF)/LINUX (LF). Gli altri valori vengono ignorati e viene utilizzata la proprietà System line.sepatator.

gapwalk.post.script.mediatype.json

booleano

false

Speciifica se l'Content-Typeintestazione della risposta da endpoint /post/script/{scriptId:.+} è impostata suapplication/json, a seconda del valore di una variabile booleana. Se impostato su false, l'impostazione predefinita è. text/plain; charset=utf-8

gapwalk.ssl.enabled

booleano

false

Indicato per impostare le seguenti gapwalk.ssl.* proprietà sulle proprietà correnti del sistema JVM se non sono già impostate all'avvio dell'applicazione.

gapwalk.ssl.keyStore

stringa

null

Imposta il valore sulla proprietà di sistema javax.net.ssl.keyStore se non è già configurata all'avvio dell'applicazione.

gapwalk.ssl.keyStorePassword

stringa

null

Imposta il valore sulla proprietà di sistema javax.net.ssl.keyStorePassword se non è già configurata all'avvio dell'applicazione. In alternativa, l'uso dei AWS segreti è fortemente incoraggiato, come spiegato inGestore segreto per le impostazioni delle password SSL.

gapwalk.ssl.trustStore

stringa

null

Imposta il valore sulla proprietà di sistema javax.net.ssl.trustStore se non è già impostato all'avvio dell'applicazione.

gapwalk.ssl.trustStorePassword

stringa

null

Impostate il valore sulla proprietà di sistema javax.net.ssl.trustStorePassword se non è già configurata all'avvio dell'applicazione. In alternativa, l'uso dei AWS segreti è fortemente incoraggiato, come spiegato inGestore segreto per le impostazioni delle password SSL.

gapwalk.ssl.trustStoreType

stringa

null

Imposta il valore sulla proprietà di sistema javax.net.ssl.trustStoreType se non è già configurata all'avvio dell'applicazione.

gapwalk.zos.systemName

stringa

null

Specifica il valore del nome di sistema per il CVT (Communications Vector Table) emulato.

5.202.0

gapwalk.zos.sysplexName

stringa

null

Specifica il valore del nome sysplex per il CVT (Communications Vector Table) emulato.

5.202.0

gdgDirectoryPath

stringa

output/gdg

Il percorso della directory GDG è la directory in cui sono archiviati i file gdg.

4.6.0

ims.messages.extendedSize

booleano

false

Speciifica se impostare la dimensione estesa dei messaggi IMS.

ims.programs

stringa

Elenco dei programmi IMS da utilizzare. Separare ogni parametro con un punto e virgola (;) e ogni transazione con una virgola (,). Ad esempio:PCP008,PCT008;PCP054,PCT054;PCP066,PCT066;PCP068,PCT068;

invalidDataTolerence

booleano

true

Speciifica se i dati non validi sono tollerati per il tipo compresso.

jcl.checkpoint.enabled

booleano

false

Speciifica se il meccanismo di checkpoint JCL è abilitato per consentire il riavvio del lavoro. I checkpoint JCL vengono creati e salvati nel registro in memoria all'inizio di ogni passaggio o chiamata principale del programma. Tutti i checkpoint a livello di fase vengono mantenuti alla fine del processo, se è definito il provider di persistenza.

jcl.checkpoint.expireTimeout

numero

-1

Speciifica la durata del periodo di conservazione dei checkpoint JCL nel provider di persistenza o nel registro in memoria.

jcl.checkpoint.expireTimeoutUnit

stringa

SECONDI

Speciifica l'unità di durata temporale per la jcl.checkpoint.expireTimeout proprietà. Valori costanti enum supportati: java.util.concurrent. TimeUnit.

jcl.checkpoint.provider

stringa

null

Specifica il provider di persistenza del meccanismo di checkpoint JCL. I valori consentiti sono. redis

jcl.checkpoint.redis.*

Proprietà Redis supportate

Specifica le proprietà di configurazione per il provider di persistenza REDIS del meccanismo di checkpoint JCL, vedi. Proprietà Redis supportate

jcl.nullJclEof

booleano

true

Speciifica come vengono gestite le istruzioni JCL nulle (//) durante l'esecuzione del lavoro. Se impostato su true,//termina immediatamente il processo (modalità EOF). Se false,//viene considerata un'istruzione nulla e l'esecuzione continua (modalità IGNORE).

jhdb.checkpointPath

stringa

file:. /configurazione/

In caso contrariojhdb.checkpointPersistence, questo parametro consente di impostare il percorso di persistenza del checkpoint (posizione di archiviazione del file checkpoint.dat), tutti i dati dei checkpoint contenuti nel registro vengono serializzati e sottoposti a backup in un file (checkpoint.dat) situato nella cartella fornita. none Nota che solo i dati del checkpoint (ScriptID, StepID, posizione del database e area del checkpoint) sono interessati da questo backup.

jhdb.checkpointPersistence

stringa

nessuno

La modalità di persistenza del checkpoint. I valori consentiti sononone//add. end Si usa add per mantenere i checkpoint quando ne viene creato uno nuovo e aggiunto al registro. Usa per end persistere il checkpoint alla chiusura del server. Qualsiasi altro valore disabilita la persistenza. Tieni presente che ogni volta che viene aggiunto un nuovo checkpoint al registro, tutti i checkpoint esistenti verranno serializzati e il file verrà cancellato. Non è un'aggiunta ai dati esistenti nel file. Quindi, a seconda del numero di checkpoint, può avere alcuni effetti sulle prestazioni.

jhdb.configuration.context.encoding

stringa

CP297

La codifica JHDB (Java Hierarchical Database). Prevede una stringa di codifica valida,,,... CP1047 IBM930 ASCII UTF-8

jhdb.identificationCardData

stringa

Utilizzato per codificare alcuni «dati della carta di identificazione dell'operatore» nel campo MID indicato dal parametro CARD. Vuoto per impostazione predefinita, nessuna restrizione di input.

jhdb.lterm

stringa

Consentono di forzare un ID di terminale logico comune nel caso di un'emulazione IMS. Se non è impostato, viene utilizzato SessionID.

jhdb.metadata.extrapath

stringa

file:. /configurazione/

Un parametro di configurazione che specifica una cartella principale aggiuntiva, specifica per il runtime, per le cartelle psbs e dbds.

jhdb.navigation.cachenexts

numero

5000

La durata della cache (in millisecondi) utilizzata nella navigazione gerarchica per un RDBMS.

jhdb.query.limitJoinUsage

booleano

true

Speciifica se utilizzare il parametro limit join usage sui grafici RDBMS.

jhdb.use-db-prefix

booleano

true

Speciifica se abilitare un prefisso di database nella navigazione gerarchica per un RDBMS.

jics.data.dataJsonInitLocation

stringa

jics.db.dataScriptLocation

stringa

Definisce il percorso degli script SQL utilizzati per inizializzare il database JICS. Accetta un elenco separato da virgole di file e directory, che consente di specificare più script e cartelle.

jics.db.dataTestQueryLocation

stringa

Posizione di uno script sql contenente una singola query sql che dovrebbe restituire un numero di oggetti (ad esempio: conteggio del numero di record nella tabella del programma jics). Se il conteggio è uguale a 0, il database verrà caricato utilizzando jics.db.dataScriptLocation lo script, altrimenti il caricamento del database verrà saltato.

jics.db.ddlScriptLocation

stringa

La posizione dello script DDL di Jics. Consente di avviare lo schema del database Jics utilizzando uno script.sql. Vuoto per impostazione predefinita. Ad esempio,./jics/sql/jics.sql.

jics.db.schemaTestQueryLocation

stringa

Posizione del file sql che dovrebbe contenere una query univoca che restituisce il numero di oggetti nello schema jics (se presente).

jics.initList

stringa

L'elenco JICS di inizializzazione, separato da virgole. Se presente, definisce i nomi degli elenchi separati da virgole da attivare all'avvio di Apache Tomcat tra gli elenchi CICS. $UUU,DFH$IVPL,PEZ1Valore di esempio:. Questo verrà trasferito a cascata ai gruppi contenuti in tali elenchi e alle relative definizioni di risorse sottostanti, che saranno quindi visibili al runtime. Vuoto per impostazione predefinita.

jics.jcl.rt.encoding

stringa

CP-037

La codifica degli script JCL scritti nella coda JICS dedicata.

jics.jcl.rt.queue

stringa

JICS

Il nome della coda in cui è possibile scrivere gli script JCL riga per riga in fase di esecuzione.

jics.parameters.applid

stringa

VELOCITÀ

Applicato per identificare l'applicazione in JICS (almeno 4 caratteri, nessuna lunghezza massima).

jics.parameters.charset

stringa

CP037

Set di caratteri JICS utilizzato a livello globale.

jics.parameters.cwa.length

numero

0

La lunghezza dell'area di lavoro comune (CWA).

jics.parameters.datform

stringa

MMDDYY

Il modulo della data.

jics.parameters.eibtrmid

stringa

TERMINE

L'identificatore del terminale (massimo 4 caratteri, minimo 1).

jics.parameters.jobname

stringa

NOMELAVORO

Il nome del lavoro.

jics.parameters.netname

stringa

IL MIO NOME DI RETE

Il nome della rete (massimo 8 caratteri, minimo 1).

jics.parameters.opid

stringa

XXX

L'identificazione dell'operatore a 3 caratteri.

jics.parameters.sysid

stringa

CICS

L'identificazione del sistema (SYSID).

jics.parameters.sysname

stringa

SYSNAME

Il nome del sistema AS400 (sysname).

jics.parameters.tsqimpl

stringa

bluesam

Implementazione JICS Temporary Storage Queue (TSQ) (i valori consentiti sono//) bluesam memory redis

jics.parameters.userid

stringa

L'id utente (massimo 8 caratteri, nessun minimo). Quando non viene fornito alcun valore (vuoto per impostazione predefinita), l'ID di sessione HTTP viene utilizzato come ID utente.

jics.parameters.username

stringa

IL MIO NOME UTENTE

Il nome utente (massimo 10 caratteri, minimo 1).

jics.queues.sqs.region

stringa

eu-west-1

La AWS regione per Amazon Simple Queue Service, utilizzata in JICS.

jics.queues.ts.redis.*

Proprietà Redis supportate

Specifica le proprietà di configurazione per il server Redis JICS TS Queues, vedi. Proprietà Redis supportate

jics.redis.*

Proprietà Redis supportate

Specifica le proprietà di configurazione per il Connection Factory del server JICS Redis, vedere. Proprietà Redis supportate

jics.runUnitLauncherPool.enable

booleano

false

Speciifica se attivare il pool di avvio dell'unità di esecuzione in JICS.

jics.runUnitLauncherPool.parallelism

numero

2

Il numero di thread utilizzati per produrre le istanze mancanti nella coda durante l'esecuzione dell'attività di regolazione.

jics.runUnitLauncherPool.size

numero

20

La dimensione del pool di run unit launcher in JICS.

jics.runUnitLauncherPool.validationInterval

numero

1000

L'intervallo tra ogni esecuzione dell'attività che regola la dimensione del pool.

jics.spool.smtp.debug

booleano

false

Speciifica la modalità di debug per il server SMTP.

jics.spool.smtp.hostname

stringa

null

Speciifica l'host del server SMTP. Ad esempio: smtp.xxx.com

jics.spool.smtp.password

stringa

null

Speciifica la password di accesso del server SMTP.

jics.spool.smtp.port

stringa

null

Speciifica la porta del server SMTP. Esempio: 25

jics.spool.smtp.username

stringa

null

Speciifica il nome utente del server SMTP.

jics.xa.agent.timeout

numero

jildb.backend

stringa

Speciifica il tipo di database utilizzato nel backend Jildb, ad esempio Oracle.

jildb.datasource + -driver-class-name + -url + -username + -password

Origine dati Spring standard con sottochiavi

Contiene le informazioni di connessione per il database Jics.

jildb.record-hold-timeout

int

10000

Speciifica il periodo di timeout di attesa, in millisecondi, per il meccanismo di conservazione dei record in Jildb.

job.default.encoding

stringa

CP1047

Speciifica la codifica predefinita utilizzata per inizializzare la memorizzazione a livello di processo. Ad esempio, gli switch nell'applicazione BLU4IV utilizzano questa codifica per l'inizializzazione a zero.

4.9.0

listOfMDCUrlParams

stringa

null

L'elenco dei parametri URL da aggiungere all'MDC durante l'esecuzione dello script batch Groovy.

localDateFormat

stringa

Elenco dei formati di data locali. Separa ogni formato con. \

localTimeFormat

stringa

Elenco dei formati dell'ora locale. Separa ogni formato con \

localTimestampFormat

stringa

Elenco dei formati di timestamp locali. Separa ogni formato con. \

lockTimeout

numero

500

Il timeout di blocco, in millisecondi.

logging.config

Path

percorso di classe: logback-main.xml

Chiave standard per il riferimento al file di configurazione logback. Sono disponibili anche altre chiavi di registrazione standard.

mapTransfo.prefixes

stringa

&,@,%%

Elenco di prefissi da utilizzare per la trasformazione delle variabili ControlM. Ciascuno separato da una virgola.

mf.runtime.switch.N

booleano

true

Abilita l'inserimento nullo per i file sequenziali di linea MF Nature.

4.4.0

mf.runtime.switch.T

booleano

false

Consente l'inserimento di caratteri di tabulazione nei file sequenziali di linee MF Nature.

4.4.0

mq.connection.pool.share

booleano

false

Indica se condividere o ricreare il pool di connessioni JMS con lo stesso Queue Manager.

4.9.0

mq.queues

stringa

sqs

Speciifica quale queue brocker supportato da utilizzare tra Amazon sqs SQS, Rabbit MQ locale o rabbitmq IBMMQ locale. jms

mq.queues.default.syncpoint

booleano

false

Speciifica il comportamento predefinito per i comandi MQ PUT quando non sono impostati né MQPMO_SYNCPOINT né MQPMO_NO_SYNCPOINT. Quando è impostato su true, agisce come se i messaggi NON venissero salvati direttamente durante il comando PUT. MQPMO_SYNCPOINT Quando è impostato su false, agisce come se MQPMO_NO_SYNCPOINT i messaggi venissero salvati direttamente durante il comando PUT.

mq.queues.jms.connectionfactory.*

Proprietà di fabbrica di connessione Atomikos supportate

Specifica le proprietà di configurazione per il pool di connessioni JMS MQ.

mq.queues.jmsMQQueueManagers[N]

In caso mq.queues jms affermativo, consente di specificare un elenco di connessioni IBM MQ. mq.queues.jmsMQQueueManagers[0]per la prima connessione, mq.queues.jmsMQQueueManagers[1] per la seconda e così via.

mq.queues.jmsMQQueueManagers[N].jmsMQAppName

stringa

null

Il nome dell'applicazione IBMMQ.

mq.queues.jmsMQQueueManagers[N].jmsMQChannel

stringa

null

Il nome del canale IBMMQ.

mq.queues.jmsMQQueueManagers[N].jmsMQHost

stringa

null

Il nome host IBMMQ.

mq.queues.jmsMQQueueManagers[N].jmsMQMaxPoolSize

numero

0

La dimensione massima del pool IBMMQ. Con 0, è abilitato un numero infinito di connessioni fisiche.

mq.queues.jmsMQQueueManagers[N].jmsMQPassword

stringa

null

La password utente IBMMQ. In alternativa, l'uso dei AWS segreti è fortemente consigliato, come spiegato in. Gestore segreto per le impostazioni delle password di IBM MQ

mq.queues.jmsMQQueueManagers[N].jmsMQPort

numero

null

La porta IBMMQ.

mq.queues.jmsMQQueueManagers[N].jmsMQQueueManager

stringa

null

Il nome del gestore di code IBMMQ.

mq.queues.jmsMQQueueManagers[N].jmsMQSSLCipher

stringa

null

La suite di crittografia SSL IBMMQ. Un esempio potrebbe essere. "*TLS12ORHIGHER" Per maggiori dettagli, consulta la documentazione ufficiale TLS CipherSpecs e CipherSuites nelle classi IBM MQ per JMS.

mq.queues.jmsMQQueueManagers[N].jmsMQUserid

stringa

null

Il nome utente IBMMQ.

mq.queues.non.jms.client

booleano

false

Indica se il client di destinazione a cui inviare messaggi non è JMS. Il formato MQ nativo verrà utilizzato per client non JMS mentre il formato RFH2 verrà utilizzato per JMS.

4.5.0

mq.queues.rabbitMQHost

stringa

null

Il nome host di Rabbit MQ.

mq.queues.rabbitMQPassword

stringa

null

La password di Rabbit MQ.

mq.queues.rabbitMQPort

numero

null

La porta Rabbit MQ.

mq.queues.rabbitMQUsername

stringa

null

L'utente Rabbit MQ.

mq.queues.rabbitMQVirtualHost

stringa

null

L'hostname virtuale Rabbit MQ.

mq.queues.sqs.region

stringa

eu-west-3

La AWS regione per il servizio AWS SQS MQ.

pgmDateFormat

stringa

yyyy- MM-dd

Il formato della data e dell'ora.

pgmTimeFormat

stringa

HH.mm.ss

Il formato dell'ora usato per l'esecuzione di pgm (programmi).

pgmTimestampFormat

stringa

yyyy- MM-dd-HH.mm.ss.SSSSSS

Il formato del timestamp.

program.timeout

numero

-1

Specifica un timeout per qualsiasi program/transaction esecuzione in secondi. Trascorso questo tempo, il sistema proverà a interrompere il programma.

qtemp.cleanup.threshold.hours

numero

0

Per specificare quando qtemp.dblog è abilitato. La durata della partizione db (in ore).

qtemp.dblog

booleano

false

Se abilitare la registrazione del database QTEMP.

qtemp.uuid.length

numero

9

La lunghezza dell'ID univoco di QTEMP.

quartz.scheduler.stand-by-if-error

booleano

false

Speciifica se attivare l'esecuzione del lavoro se lo scheduler del lavoro è in modalità standby. Se vero, quando è abilitata l'esecuzione del lavoro non viene attivata.

query.useConcatCondition

booleano

false

Speciifica se la condizione chiave è creata dalla concatenazione di chiavi o meno.

reportOutputPath

stringa

/reports

Il percorso di output del report.

returnHttp5xxResponseForFailedSyncJob

booleano

false

Speciifica se restituire il codice di risposta HTTP della serie 500 per l'esecuzione non riuscita del processo sincronizzato.

4.10.0

rollbackOnRTE

booleano

false

Speciifica se eseguire il rollback della transazione implicita dell'unità di esecuzione sulle eccezioni di runtime.

sctThreadLimit

Long

5

Il limite dei thread per l'attivazione degli script.

server.servlet.session.timeout

stringa

30 m

Speciifica la durata del timeout della sessione. Esempi: 60s (60 secondi), 4m (4 minuti), 4h (4 ore).

server.servlet.session.tracking-modes

stringa

biscotto

Specifica le modalità di tracciamento della sessione da utilizzare. I valori possibili sono urlcookie,ssl. È possibile specificare più valori separati da virgole. Nota: quando si esegue la distribuzione su Tomcat, è necessario impostarlo cookies=false in context.xml perché Tomcat ha la precedenza per la configurazione della modalità di tracciamento.

spring.aws.application.credentials

stringa

null

Carica AWS le credenziali dal file dei profili delle credenziali in JICS.

spring.aws.client.bluesam.locks.redis.secret

stringa

null

Specifica l'ARN segreto delle credenziali per Bluesam blocca la cache Redis, vedi. AWS I segreti di Transform for mainframe Runtime

spring.aws.client.bluesam.redis.secret

stringa

null

Specifica l'ARN segreto delle credenziali per la cache Bluesam Redis, vedere. AWS I segreti di Transform for mainframe Runtime

spring.aws.client.jcl.checkpoint.redis.secret

stringa

null

Speciifica l'ARN segreto delle credenziali per il provider di persistenza Redis del meccanismo di checkpoint JCL, vedi. AWS I segreti di Transform for mainframe Runtime

spring.aws.client.jics.queues.ts.redis.secret

stringa

null

Specifica l'ARN segreto delle credenziali per il server Redis JICS TS Queues, vedere. AWS I segreti di Transform for mainframe Runtime

spring.aws.client.jics.redis.secret

stringa

null

Specifica l'ARN segreto delle credenziali per la fabbrica di connessioni al server JICS Redis, vedere. AWS I segreti di Transform for mainframe Runtime

spring.jta.enabled

booleano

false

Chiave standard. Se la modalità di supporto dell'origine dati non è static-xa, la configurazione automatica delle transazioni Spring JTA deve essere disabilitata.

spring.session.store-type

stringa

nessuno

La cache della sessione per ambienti ad alta disponibilità. I valori possibili sono none oredis. L'impostazione predefinita ènone.

sqlCodePointShift

numero

Opzionale. Lo spostamento dei punti del codice sql. Sposta il codepoint per i caratteri di controllo che potremmo incontrare durante la migrazione dei dati RDBMS legacy a un RDBMS moderno. Ad esempio, puoi specificare che corrisponda al carattere Unicode. 384 \u0180

sqlConnectionAutoCommitEnabled

booleano

true

Abilita il commit automatico della connessione corrente durante le operazioni di ripristino della connessione. Se abilitato, esegue automaticamente il commit della connessione corrente prima di passare a una nuova connessione all'origine dati in ambienti non XA per prevenire l'instabilità della connessione. Se disattivata, registra un messaggio di avviso sui potenziali problemi di connessione durante le operazioni di ripristino.

4.10.0

sqlIntegerOverflowAllowed

booleano

false

Speciifica se consentire l'overflow di numeri interi SQL, ovvero se è consentito inserire valori più grandi nella variabile host.

startDefaultJob

stringa

false

Specificare se inizializzare il processo predefinito alla prima transazione.

stepFailWhenAbend

booleano

true

Specifica se alzare un abend se un passaggio fallisce o completa l'esecuzione.

stopExecutionWhenProgNotFound

booleano

true

Speciifica se interrompere l'esecuzione se non viene trovato un programma. Se impostato sutrue, interrompe l'esecuzione se non viene trovato un programma.

system.date.format

stringa

MDY

Il formato della data di sistema DATFMT.

---

system.date.separator

stringa

/

Il separatore di data di sistema DATSEP.

I valori possibili sono slash (`/`), dash (`—`), period (`.`), comma (`,`) o blank (``). Il valore deve essere specificato tra virgolette `""`.

5.17.0

system.qdecfmt

stringa

taskExecutor.allowCoreThreadTimeOut

booleano

false

Specifica se consentire il timeout dei thread principali in JCIS. Ciò consente l'aumento e la riduzione dinamici anche in combinazione con una coda diversa da zero (poiché la dimensione massima del pool aumenterà solo quando la coda sarà piena).

taskExecutor.corePoolSize

numero

5

Quando una transazione in un terminale viene avviata tramite uno script groovy, viene creato un nuovo thread. Utilizzate questo parametro per configurare la dimensione del pool principale.

taskExecutor.maxPoolSize

numero

10

Quando una transazione in un terminale viene avviata tramite uno script groovy, viene creato un nuovo thread. Utilizzate questo parametro per impostare la dimensione massima del pool (numero massimo di thread paralleli).

taskExecutor.queueCapacity

numero

50

Quando una transazione in un terminale viene avviata tramite uno script groovy, viene creato un nuovo thread. Utilizzate questo parametro per impostare la dimensione della coda. (= numero massimo di transazioni in sospeso quando viene raggiunto) taskExecutor.maxPoolSize

tempFilesDirectory

stringa

null

Speciifica il nome della cartella in cui si trovano i file temporanei generati.

tempFolderPattern

stringa

null

Speciifica uno schema che verrà utilizzato per creare dinamicamente il nome della cartella temporanea in base alle seguenti informazioni predefinite e personalizzabili.

HOST: il nome dell'host.

JOBID: l'ID del lavoro.

HASHCODE: il codice hash del contesto lavorativo.

TIMESTAMP: lo schema da utilizzare per ottenere il timestamp. Il nome di destinazione della cartella temporanea è TMP_DIR_ {temp}. FolderPattern Ad esempio, nel caso dello schema seguente, il nome inizierà con l'ID del lavoro e terminerà con il «timestamp»: tempFolderPattern: JOBID, host=XXXXX, HASHCODE, timestamp=YYYYMMDDHHMMSS. Se la proprietà non tempFolderPattern viene aggiunta al file YAML o è vuota, il nome della cartella temporanea sarà «TMP_DIR_» + this.hashCode () (DefaultJobContext).

uppercaseUserInput

booleano

true

Speciifica se l'input dell'utente deve essere in maiuscolo.

useControlMVariable

booleano

false

Specifica se utilizzare la specifica Control-M per la sostituzione delle variabili.

xmlGeneratorPrettyFormat

booleano

true

Determina lo stile di formattazione dell'output XML generato all'interno della classe. XmlGenerator Se impostato sutrue, l'output XML viene formattato in una struttura rientrata leggibile dall'uomo (stampata in modo carino). Se impostato sufalse, l'output è in un formato compatto a riga singola senza spazi bianchi aggiuntivi.

4.8.0

Proprietà disponibili per applicazioni Web opzionali

A seconda dell'applicazione modernizzata in uso, potrebbe essere necessario configurare una o più applicazioni Web opzionali che supportino dipendenze come z/OS AS/400, o. IMS/MFS Le tabelle seguenti contengono elenchi dei key/value parametri disponibili per la configurazione di ogni applicazione Web opzionale.

gapwalk-utility-pgm.war

Questa applicazione web opzionale contiene il supporto per i programmi di utilità. Z/OS

Questa tabella fornisce una panoramica esaustiva dei key/values parametri di questa applicazione.

Chiave Tipo Valore predefinito Description Versione di rilascio

convertGraphicDataToFullWidth

booleano

true

Speciifica se convertire i dati grafici in formato a larghezza intera.

encoding

stringa

ASCII

La codifica utilizzata nei programmi di utilità. Prevede una codifica validaCP1047,,IBM930. ASCII UTF-8

forcedDate

stringa

Forza la data alla data fornita, se presente.

frozenDate

booleano

true

Specifica se congelare la data. Si applica solo se forcedDate è impostata anche.

forcedDateMode

stringa

Specifica la modalità di data forzata. Se impostata suHYBRID, la parte relativa alla data è la data forzata configurata, ma la parte relativa all'ora riflette l'ora effettiva del sistema. Si applica solo se forcedDate è impostata anche questa opzione.

hasGraphic

booleano

false

Se l'utilità INFUTILB deve gestire le colonne GRAPHIC DB2.

idcams.deleteFromAllSubfolders

booleano

false

Se il comando IDCAMS DELETE deve rimuovere anche i file corrispondenti da ogni sottocartella della directory dei file.

5.15.0

idcams.encoding.forced

stringa

La codifica utilizzata nel programma di utilità IDCAMS. Prevede una codifica CP1047 valida,,. IBM930 ASCII UTF-8

4.4.0

idcams.repro.failOnMissingOutput

booleano

false

Se impostato su true, IDCAMS REPRO fallirà immediatamente se manca un set di dati Blusam di output con disposizione SHR o OLD.

5.185.0

jcl.type

stringa

mvs

tipo di file.jcl. I valori consentiti sono/jcl. vse I PRINT/REPRO comandi dell'utilità IDCAMS restituiscono 4 se il file è vuoto per jcl non vse.

load.applyRollback

booleano

false

Impostate questo parametro true per indicare che desiderate che il servizio ripristini le modifiche alla tabella se riscontra un errore durante il caricamento dei dati nel database.

load.batchSize

numero

0

La dimensione del batch dell'utilità di caricamento.

load.format.dbDate

stringa

yyyy- MM-dd

Il formato del database dell'utilità di caricamento da utilizzare.

load.format.dbTime

stringa

HH:mm:ss

L'ora di utilizzo del database dell'utilità di caricamento.

load.format.localDate

stringa

Aggiungi. MM.yyyy\ dd/MM /yyyy\ yyyy- MM-dd

Il formato di data locale dell'utilità di caricamento da utilizzare.

load.format.localTime

stringa

HH:mm:ss\HH.mm.ss

Il formato dell'ora locale dell'utilità di caricamento da utilizzare.

load.sqlCodePointShift

numero

0 s

Il codice SQL pointshift per l'utilità di caricamento. Esegue il processo di spostamento dei caratteri. Richiesto quando il database di destinazione di DB2 è Postgresql.

logging.config

Path

classpath:logback-utility.xml

Chiave standard per il riferimento al file di configurazione logback. Sono disponibili anche altre chiavi di registrazione standard.

primary.datasource -driver-class-name -url -username -password

Fonte di dati Spring standard con sottochiavi

Contiene le informazioni di connessione per il database dell'applicazione, se non si utilizza JNDI. Deve avere la stessa configurazione del file YAML dell'applicazione modernizzata.

In alternativa, l'uso dei AWS segreti è fortemente incoraggiato, come spiegato in. Database client

spring.datasource.primary.jndi-name

stringa

jdbc/primary

Il nome JNDI (Java Naming And Directory Interface) per l'origine dati principale, se si utilizza JNDI.

spring.jta.enabled

booleano

false

Chiave standard. Se la modalità di supporto dell'origine dati non è static-xa, la configurazione automatica delle transazioni Spring JTA deve essere disabilitata.

sysPunchEncoding

stringa

ASCII

Il set di caratteri di codifica syspunch. Prevede una codifica valida,,. CP1047 IBM930 ASCII UTF-8

systin.encoding

stringa

ASCII

Il set di caratteri di codifica del set di dati del file SYSTIN. Prevede una codifica CP1047 valida,,. IBM930 ASCII UTF-8

4.5.0

treatLargeNumberAsInteger

booleano

false

Speciifica se trattare i numeri grandi come. Integer Per impostazione predefinita, vengono BigDecimal trattati come tali.

unload.bmc.useInto

booleano

false

Speciifica se gestire la parola chiave di controllo INTO bmc per l'utilità unload.

unload.chunkSize

numero

0

Dimensione del blocco utilizzata per l'utilità di scarico.

unload.columnFiller

stringa

spazio

Il riempitivo per colonne dell'utilità di scarico.

unload.computeRecordSizeIfNull

booleano

false

Determina se calcolare la dimensione del record se non specificata. Se specificato, il valore rimane invariato.

unload.fetchSize

numero

0

Consente di regolare la dimensione del recupero quando si gestiscono i cursori nell'utilità unload.

unload.format.date

stringa

MM/dd/yyyy

Se unload.useDatabaseConfiguration abilitato, il formato della data da utilizzare nell'utilità di scarico.

unload.format.time

stringa

HH.mm.ss

Se unload.useDatabaseConfiguration abilitato, il formato dell'ora da utilizzare nell'utilità di scarico.

unload.format.timestamp

stringa

yyyy- MM-dd-HH.mm.ss.SSSSSS

Se unload.useDatabaseConfiguration abilitato, il formato del timestamp da utilizzare nell'utilità di scaricamento.

unload.nbi.whenNotNull

esadecimale

00

Il valore Null Byte Indicator (NBI) da aggiungere quando il valore del database non è nullo.

unload.nbi.whenNull

esadecimale

6F

Il valore Null Byte Indicator (NBI) da aggiungere quando il valore del database è nullo.

unload.nbi.writeNullIndicator

booleano

false

Speciifica se scrivere l'indicatore null nel file di output di scaricamento.

unload.noPad

booleano

true

Indica che i campi con caratteri a lunghezza variabile (VARCHAR) devono essere scaricati senza che venga raggiunta la lunghezza massima.

4.5.0

unload.sqlCodePointShift

numero

0

L'utilità pointshift for unload del codice SQL. Esegue il processo di spostamento dei caratteri. Richiesto quando il database di destinazione di DB2 è Postgresql.

unload.useDatabaseConfiguration

booleano

false

Speciifica se utilizzare la configurazione di data o ora da application-main.yml nell'utilità unload.

unload.varCharIsNull

booleano

false

Usa questo parametro nel programma INFTILB, se impostato su true allora tutti i campi non annullabili con valori vuoti (spazi) restituiscono una stringa vuota.

zonedMode

stringa

EBCDIC_STRICT

La modalità per codificare o decodificare i tipi di dati suddivisi in zone. I valori consentiti sono//EBCDIC_STRICT. EBCDIC_MODIFIED AS400

gapwalk-cl-command.war

Questa applicazione web opzionale contiene il supporto per i programmi di utilità. AS/400

Questa tabella fornisce una panoramica esaustiva dei key/values parametri di questa applicazione.

Chiave Tipo Valore predefinito Description

commands-off

stringa

Elenco di comandi da disattivare, separati da virgole. I valori consentiti sono PGM_BASIC RCVMSGSNDRCVF,CHGVAR,QCLRDTAQ,RTVJOBA,ADDLFM,ADDPFM,RCVF,OVRDBF,DLTOVR,CPYF,SNDDTAQ. Utile quando si desidera disabilitare o sovrascrivere un programma esistente. PGM_BASICè un programma AWS Transform for mainframe Runtime specifico progettato per scopi di debug.

encoding

stringa

ASCII

La codifica utilizzata nei programmi di utilità. Prevede una codifica validaCP1047,,IBM930... ASCII UTF-8

forcedDate

stringa

Impone la data alla data fornita, se presente.

forcedDateMode

stringa

Specifica la modalità di data forzata. Se impostata suHYBRID, la parte relativa alla data è la data forzata configurata, ma la parte relativa all'ora riflette l'ora effettiva del sistema. Si applica solo se forcedDate è impostata anche questa opzione.

logging.config

Path

classpath:logback-utility.xml

Chiave standard per il riferimento al file di configurazione logback. Sono disponibili anche altre chiavi di registrazione standard.

primary.datasource + -driver-class-name + -url + -username + -password

Fonte di dati Spring standard con sottochiavi

Contiene le informazioni di connessione per il database dell'applicazione, se non si utilizza JNDI. Deve avere la stessa configurazione del file YAML dell'applicazione modernizzata.

In alternativa, l'uso dei AWS segreti è fortemente incoraggiato, come spiegato in. Database client

spring.datasource.primary.jndi-name

stringa

jdbc/primary

Il nome JNDI (Java Naming And Directory Interface) per l'origine dati principale, se si utilizza JNDI.

spring.jta.enabled

booleano

false

Chiave standard. Se la modalità di supporto dell'origine dati non è static-xa, la configurazione automatica delle transazioni Spring JTA deve essere disabilitata.

zonedMode

stringa

EBCDIC_STRICT

La modalità per codificare o decodificare i tipi di dati suddivisi in zone. I valori consentiti sono//EBCDIC_STRICT. EBCDIC_MODIFIED AS400

gapwalk-hierarchical-support.war

Questa applicazione web opzionale contiene il supporto per le transazioni. IMS/MFS

Questa tabella fornisce una visualizzazione esaustiva dei key/values parametri di questa applicazione.

Chiave Tipo Valore predefinito Description

jhdb.backend

stringa

Tipo di backend Jhdb. Il valore previsto è rdbms

jhdb.checkpointPersistence

stringa

nessuno

La modalità di persistenza del checkpoint. I valori consentiti sononone//add. end Si usa add per mantenere i checkpoint quando ne viene creato uno nuovo e aggiunto al registro. Usa per end persistere il checkpoint alla chiusura del server. Qualsiasi altro valore disabilita la persistenza. Tieni presente che ogni volta che viene aggiunto un nuovo checkpoint al registro, tutti i checkpoint esistenti verranno serializzati e il file verrà cancellato. Non è un'aggiunta ai dati esistenti nel file. Quindi, a seconda del numero di checkpoint, può avere alcuni effetti sulle prestazioni.

jhdb.configuration.context.encoding

stringa

La codifica JHDB (Java Hierarchical Database). Prevede una stringa di codifica valida,,,... CP1047 IBM930 ASCII UTF-8

jhdb.keepParent

booleano

false

Se mantenere _parent e _logicalparent durante l'inserimento di IMS. Se impostata su true, la chiamata ISRT IMS inserirà _parent e _logicalparent nelle colonne del database.

jhdb.query.timeout

int

-1

Specifica un timeout per l'esecuzione di qualsiasi transazione jhdb in secondi. Trascorso questo tempo, il sistema proverà a interrompere il programma. Non viene impostato alcun timeout se il valore è -1 (impostazione predefinita).

jhdb.transaction.scope.programs

stringa

elenco di programmi da dichiarare come transazione completa. Separare ogni programma con una virgola (,). Ad esempio:PCP008,PCT008

logging.config

Path

classpath: logback-utility.xml

Chiave standard per il riferimento al file di configurazione logback. Sono disponibili anche altre chiavi di registrazione standard.

metadata.datasource + -driver-class-name + -url + -username + -password + -type

stringa

Fonte di dati Spring standard con sottochiavi

Contiene le informazioni sui metadati per il database jhdb, inclusi psbs, dbds, connections. In alternativa, l'uso dei segreti è fortemente incoraggiato.AWS

spring.jta.enabled

booleano

false

Chiave standard. Se la modalità di supporto dell'origine dati non è static-xa, la configurazione automatica delle transazioni Spring JTA deve essere disabilitata.

gapwalk-gs21.war

Usa questa applicazione Web opzionale per eseguire i programmi della piattaforma Fujitsu GS21 nel tuo ambiente di modernizzazione del mainframe AWS. Installa questa applicazione solo se il tuo carico di lavoro modernizzato include programmi GS21.

La tabella seguente descrive i parametri chiave-valore per questa applicazione.

Chiave Tipo Valore predefinito Description

datasource.gs21Ds + -driver-class-name + -url + -username + -password + -type

Origine dati Spring standard con sottochiavi

Nessuno

Memorizza le informazioni di connessione per il database GS21. Consigliamo di utilizzare AWS Secrets Manager per le credenziali del database. Per ulteriori informazioni, consulta Database client.

aim.sockets.socketConfigurations

elenco

Nessuno

Configura le connessioni socket dell'Application Integration Module (AIM). Ogni voce è una configurazione del server socket o una configurazione del client socket.

Chiavi di ingresso del server socket: remote (nome della connessione), smqn (nome della coda SMQN (Structured Message Queue Name), port (porta socket).

Chiavi di immissione del client socket: remote (nome del server remoto), targetName (nome del server di destinazione), smqn (nome della coda SMQN), (porta locale), port (porta di destinazione), targetPort (IP di destinazione). targetHost

taskExecutor + -corePoolSize + -maxPoolSize + -queueCapacity + -allowCoreThreadTimeOut

Configurazione dell'esecutore del pool di thread Spring

Nessuno

Configura l'esecutore del pool di thread che genera i processi AIM (come SMQN, gestori di socket e gestori di risposta ai messaggi).

Proprietà disponibili per l'applicazione client

L'applicazione modernizzata potrebbe richiedere configurazioni di proprietà specifiche per l'applicazione client Spring. Queste proprietà inizializzano i bean dalle classi incluse nei file JAR di runtime. Il application-profile.yaml file, in cui viene impostato il valore del profilo durante la generazione dell'applicazione, consente di configurare queste proprietà. La tabella seguente elenca i key/value parametri disponibili per la configurazione dell'applicazione web client che utilizza i bean delle classi incluse nel runtime Gapwalk

Chiave Tipo Valore predefinito Description Versione di rilascio

blu4iv.dao.cache.enabled

booleano

false

Abilita la In-memory cache.

4.8.0

blu4iv.dao.cache.enabledHits

booleano

false

Aggiungi il tracciamento del numero di richieste alla cache.

4.8.0

blu4iv.dao.cache.entries.fileIds

stringa

L'elenco delle tabelle del database da memorizzare nella cache.

4.8.0

blu4iv.dao.cache.entries.programIds

stringa

Gli identificatori del programma in cui deve essere attivata la cache per le tabelle specificate. La cache è disponibile per tutti i sottoprogrammi negli stack di esecuzione.

4.8.0

blu4iv.dao.cache.initMaxResults

numero

10000

La dimensione della cache.

4.8.0

blu4iv.dao.data.max

numero

10

La dimensione della cache interna per le operazioni DAO di input. Questa cache esiste a livello di programma (istanza singola).

4.9.0

blu4iv.dao.sort.function

stringa

Il nome della funzione di ordinamento per il database blu4iv.

4.9.0

blu4iv.dao.support

stringa

JPA

Speciifica l'implementazione di accesso ai dati da utilizzare (JPA o JDBC).

4.9.0

blu4iv.dtaara.library.disable

booleano

false

Controlla l'utilizzo della libreria nel contesto delle operazioni dell'area dati. Se impostato su true, l'utilizzo della libreria è disabilitato per le operazioni sull'area dati, ma ciò non influisce sull'utilizzo di QTemp. Se impostato su false, la libreria viene considerata quando si eseguono operazioni CRUD per l'area dati.

4.5.0

blu4iv.librarylist.enabled

booleano

false

Abilita l'uso dell'elenco delle librerie per risolvere una libreria di file.

4.10.0

blu4iv.librarylist.libraries

stringa

L'elenco iniziale delle librerie ordinate da sinistra a destra.

4.10.0

Configurare la In-Memory cache per le applicazioni AS400

La funzionalità di cache in memoria consente agli utenti di memorizzare nella cache i dati di sola lettura all'interno della memoria, migliorando significativamente le prestazioni per i programmi che richiedono un uso intensivo di dati. Il sistema di cache ottimizza le prestazioni in tre modi: caricamento dei dati solo al primo accesso, creazione di mappe di accesso ai dati su richiesta e archiviazione efficiente dei dati memorizzati nella cache vicino alla memoria del programma. Questo design riduce al minimo il sovraccarico di memoria massimizzando al contempo i miglioramenti della velocità.

################################################################### # 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"]

Configura la registrazione degli accessi alle API

La funzione di registrazione degli accessi alle API registra informazioni dettagliate sulle richieste API alle applicazioni BAC, JAC e Gapwalk, contribuendo a soddisfare i requisiti di sicurezza tracciando chi ha effettuato l'accesso a cosa e quando.

Chiave Tipo Valore predefinito Description Versione di rilascio

api.logging.enabled

booleano

false

Abilita la registrazione degli accessi alle API per le applicazioni BAC, JAC e Gapwalk. Se abilitato, registra tutte le richieste API con dettagli.

5.0.0

Se abilitato, l'utente può fornire la configurazione del file di logback per registrare i log di accesso all'API nella posizione prescelta utilizzando il nome del logger. api.access I log possono includere i seguenti campi MDC:

Campo MDC Description

api-context

Dove è ospitata l'API

api-date

La data e l'ora in cui è stata effettuata la richiesta API

api-duration

Quanto tempo è stato impiegato per elaborare la richiesta API (millisecondi)

api-host

L'indirizzo di origine da cui proviene la richiesta API

api-method

Il tipo di richiesta HTTP effettuata (ad esempio, GET, POST, DELETE,...)

api-name

A endpoint/URI cui è stato effettuato l'accesso

api-retcode

Il codice di stato restituito dopo il completamento della richiesta API

api-scheme

Il protocollo di trasferimento utilizzato, ad esempio, HTTP o HTTPS.

api-secure

Il metodo di sicurezza utilizzato per proteggere la chiamata API (ad esempio, OAuth2, Token, Anonymous)

api-sessionid

Un identificatore univoco per la sessione di accesso corrente dell'utente

api-user

Il nome utente o l'identificatore della persona che effettua la richiesta API

Per configurare un file di registro dedicato per i log di accesso alle API, aggiungi quanto segue alla tua configurazione di logback:

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

Esempio di output del registro:

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

Configurare il tracciamento distribuito

La funzionalità di tracciamento distribuito consente il tracciamento end-to-end delle richieste tra GapWalk le applicazioni propagando TraceID e SpanID dalle richieste HTTP, consentendo la correlazione dei log durante l'intero ciclo di vita della richiesta.

Chiave Tipo Valore predefinito Description Versione di rilascio

gapwalk.tracing.enabled

booleano

false

Abilita il tracciamento distribuito per GapWalk le applicazioni. Se abilitato, propaga traceID e spanID per l'esecuzione di processi in batch.

Se abilitata, la funzione di tracciamento propaga il contesto di traccia. I registri possono includere i seguenti campi MDC:

Campo MDC Description

Spagna (ID)

Identificatore univoco per l'operazione corrente all'interno della traccia

traceId

Identificatore univoco per l'intero flusso di richieste su tutti i servizi e i thread

Per configurare il tracciamento distribuito, aggiorna la configurazione del logback per includere traceID e spanID nel modello di registro. Aggiungi o aggiorna la seguente proprietà:

<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" />

Esempio di output del registro:

2026-02-02 20:00:00 default INFO [6966b3c1dc96c2da73be7e2b6f9f25dc,73be7e2b6f9f25dc] - q.t.s.i.TestJobProcessImpl - Length is: 100