View a markdown version of this page

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

AWS L'esperienza autogestita di Mainframe Modernization non è più aperta a nuovi clienti. Per funzionalità simili all'esperienza autogestita di AWS Mainframe Modernization, esplora le funzionalità offerte direttamente dai fornitori e da. AWS Transform I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta Modifica della disponibilità di Mainframe Modernization. AWS

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 le proprietà per AWS Transform for mainframe Runtime

In Spring Boot le applicazioni application-main.yml sono il file di configurazione in cui definiamo diversi tipi di proprietà come la porta di ascolto, la connettività del database e molte altre. Puoi usare questa pagina per conoscere le proprietà disponibili per AWS Transform for mainframe Runtime e come abilitarle.

Notazione YML

Nella documentazione seguente, 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 predefinita

    ---- #### 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 il valore dell'indicatore a byte nullo 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 usi bluesam con un comportamento aperto 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

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

5.75.0

blu4iv.userspace.pageSize

int

4096

Specifica 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 del numero specificato.

4.10.0

blu4iv.userspace.redis.*

Proprietà Redis supportate

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

4.10.0

blu4iv.userspace.store-type

stringa

memory

Specifica 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

Specifica il tempo di attesa (in millisecondi) tra ogni iterazione durante il polling dello stato di bluesam per controllare 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

Specifica 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 precaricamento 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 aggiungere spazi attorno al separatore dei due punti.

- | Sono supportati i nomi dei set di dati che li contengono (utilizza gli ultimi due punti come delimitatore).

- Racchiudi le voci tra virgolette doppie o assicurati che non vi siano spazi nella voce.

- Esempio: "fileset1|MYFILE:10000"

bluesam.disabled

booleano

false

Se disabilitare Blusam completamente.

bluesam.externalDdlManagement

booleano

false

Se abilitato, BlueSAM non crea automaticamente le tabelle e adotta invece tabelle gestite esternamente registrando solo i metadati.

bluesam.fileList

stringa []

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

Nota:

- Questo parametro è efficace solo se è 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

Specifica il numero massimo di tentativi quando il polling dello stato di bluesam ha esito negativo.

4.5.0

bluesam.metadataWarmUpFileList

stringa []

Specifica l'elenco dei set di dati bluesam i cui metadati di indice verranno precaricati in una cache permanente in memoria 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 qualsiasi set di dati bluesam durante l'apertura.

Avvertenza: 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 di Redis quando bluesam.redis.enableBatchClear è abilitata.

bluesam.redis.clearStrategy

stringa

DEFAULT

Specifica la strategia per le operazioni di cancellazione della cache.

DEFAULTutilizza il RedisCache.clear() metodo Spring.

REDISSONutilizza il unlinkByPattern metodo Redisson, che è sicuro per i cluster ed evita errori di esaurimento della memoria.

REDISSON_BATCHEDutilizza un'operazione Redisson SCAN con chiamate di scadenza in batch, che offre il massimo controllo sul carico di Redis.

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 di 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 per set di dati di grandi dimensioni (largeKSDS, largeESDS) durante scritture multithread simultanee. Quando la mappa supera questa soglia, viene ridotta alle 10 voci più recenti per evitare l'esaurimento dell'heap e preservare un numero sufficiente di voci da evitare l'accesso simultaneo ai thread. NullPointerException Riduci questo valore se si osserva una pressione sull'heap durante il caricamento in massa di set di dati di grandi dimensioni e ad alto volume.

bluesam.warmUpMetadataCacheLimit

Long

0

Numero massimo di voci di indice consentite nella cache di riscaldamento dei metadati. Impostato 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 della scheda: 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 controllo se la dimensione del file è un multiplo della dimensione del record.

cl.configuration.context.encoding

stringa

CP297

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

cl.zonedMode

stringa

EBCDIC_STRICT

La modalità per codificare o decodificare i comandi del linguaggio di controllo (CL). I valori consentiti sonoEBCDIC_STRICT//EBCDIC_MODIFIED. AS400

clcommand.rtvmbrd.hasHeader

stringa

true

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

cleanTempFilesDirectoryAtStartup

booleano

true

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

context.preconstruct.enable

booleano

false

Specifica 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'operazione di regolazione.

database.cursor.overflow.allowed

booleano

true

Specifica se consentire l'overflow del cursore. Impostato su true per eseguire una chiamata successiva sul cursore indipendentemente dalla sua posizione. Impostato su 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 (SENSIBILE o INSENSIBILE).

database.cursor.raise.already.opened.error

booleano

false

Specifica se abilitare la generazione dell'errore SQLCODE 502 all'apertura di un cursore già aperto.

databaseStatistics

booleano

false

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

dataSimplifier.byteRangeBoundsCheck

booleano

false

Se impostato su true, garantisce che no ByteRange venga creato con valori errati. Il valore predefinito è false.

dataSimplifier.cacheDefaultValues

booleano

false

Se impostato su true, abilita la memorizzazione nella cache per istanza dei modelli di byte calcolati con valori predefiniti nelle sottoclassi e nelle sottoclassi. RecordEntity ElementaryRange RangeType Il valore predefinito è false.

dataSimplifier.doubleFloatingType

stringa

IEEE_754

Il tipo double floating è il formato utilizzato per codificare e decodificare un numero in 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

specifiche 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 in posizioni numeriche) 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 primaverile 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 primaverile 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 inserire il tipo di data e ora del database in entità di semplificazione dei dati. I valori consentiti sono////ISOEUREURUSALOCAL

dbDateFormat

stringa

aaaa- MM-dd

Il formato della data di destinazione db.

dbTimeFormat

stringa

HH:mm:ss

Il formato orario di destinazione db.

dbTimestampFormat

stringa

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

Il formato timestamp di destinazione del db.

defaultKeepExistingFiles

booleano

false

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

disposition.checkexistence

booleano

false

Specifica se rilasciare un controllo dell'esistenza del file per il set di dati con DISP SHR o OLD.

enableActivePgmIdCache

booleano

false

Specifica se abilitare la cache locale dell'ID di programma attivo. Usate 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). Si aspetta 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 di unione in memoria a quello esterno utilizzando i 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 blocchi per utilità. load/unload

file.stdoutIntoLogger

booleano

false

Specifica se abilitare la scrittura su logger anziché sul flusso di output di sistema predefinito nei file predefiniti e. SYSPRINT SYSPUNCH

filesDirectory

stringa

La directory per i file batch input/output .

forcedDate

stringa

Forza la data a quella 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.

forceDisableSQLTrimStringType

booleano

false

Specifica se disabilitare il taglio di tutti i parametri delle stringhe sql.

forceHR

booleano

false

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

frozenDate

booleano

true

Specifica se bloccare la data. Si applica solo se forcedDate è impostato anche.

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 locale predefinita per l'utente privilegiato.

gapwalk-application.security

stringa

disabled

Attiva o disattiva 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 emittente dell'identity provider (IdP). Questa opzione è obbligatoria quando gapwalk-application.identity lo è. oauth

gapwalk-application.security.userAttributeName

stringa

username

Il nome dell'attributo claim utilizzato per identificare una richiesta 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 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 punti di salvataggio 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 da query a 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 in 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

Specifica 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à impostato all'avvio dell'applicazione.

gapwalk.ssl.keyStorePassword

stringa

null

Impostate il valore sulla proprietà di sistema javax.net.ssl.keyStorePassword se non è già stata 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à stata impostata 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à impostato all'avvio dell'applicazione.

gapwalk.zos.sysplexName

stringa

null

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

5.202.0

gapwalk.zos.systemName

stringa

null

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

5.202.0

gdgDirectoryPath

stringa

output/gdg

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

4.6.0

ims.messages.extendedSize

booleano

false

Specifica 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

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

jcl.checkpoint.enabled

booleano

false

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

jcl.checkpoint.expireTimeout

numero

-1

Specifica la durata del tempo per conservare i checkpoint JCL nel provider di persistenza o nel registro in memoria.

jcl.checkpoint.expireTimeoutUnit

stringa

SECONDI

Specifica 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 fornitore 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 controllo JCL, vedere. Proprietà Redis supportate

jcl.nullJclEof

booleano

true

Specifica come vengono gestite le istruzioni JCL nulle (//) durante l'esecuzione del processo. Se è vero,//termina immediatamente il lavoro (modalità EOF). Se false,//viene considerato 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 dei checkpoint (ScriptID, StepID, posizione del database e area dei checkpoint) sono interessati da questo backup.

jhdb.checkpointPersistence

stringa

nessuno

La modalità di persistenza del checkpoint. I valori consentiti sononone//add. end addConsente di mantenere i checkpoint quando ne viene creato uno nuovo e aggiunto al registro. Da utilizzare per end mantenere il checkpoint all'arresto del server. Qualsiasi altro valore disabilita la persistenza. Nota 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). Si aspetta 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 designato dal parametro CARD. Vuoto per impostazione predefinita, nessuna restrizione di immissione.

jhdb.lterm

stringa

Consentono di forzare un ID logico comune del terminale 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.optim.cacheRetention

booleano

false

Specifica se conservare la cache del nodo per operazioni di lettura consecutive. Se abilitate, le letture sequenziali riutilizzano la cache e solo le operazioni di scrittura (commit o rollback) la cancellano.

jhdb.query.limitJoinUsage

booleano

true

Specifica se utilizzare il parametro limit join usage nei grafici RDBMS.

jhdb.use-db-prefix

booleano

true

Specifica se abilitare un prefisso del 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, consentendo di specificare più script e cartelle.

jics.db.dataTestQueryLocation

stringa

Posizione di uno script sql contenente una singola query sql che dovrebbe restituire un conteggio 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 deve 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 si estenderà 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

CP037

La codifica degli script JCL scritti nella coda JICS dedicata.

jics.jcl.rt.queue

stringa

MICROFONI

Il nome della coda in cui gli script JCL possono essere scritti riga per riga in fase di esecuzione.

jics.parameters.applid

stringa

VELOCITÀ

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

jics.parameters.charset

stringa

CP037

Set di caratteri utilizzato a livello globale da JICS.

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

NOME DELLA MIA 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 della 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 JICS TS Queues Redis, vedere. 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

Specifica se attivare il pool di avvio delle unità di esecuzione in JICS.

jics.runUnitLauncherPool.parallelism

numero

2

Il numero di thread utilizzati per produrre le istanze mancanti nella coda quando viene eseguita l'operazione di regolazione.

jics.runUnitLauncherPool.size

numero

20

La dimensione del pool di avvio dell'unità di esecuzione in JICS.

jics.runUnitLauncherPool.validationInterval

numero

1000

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

jics.spool.smtp.debug

booleano

false

Specifica la modalità di debug per il server SMTP.

jics.spool.smtp.hostname

stringa

null

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

jics.spool.smtp.password

stringa

null

Specifica la password di accesso del server SMTP.

jics.spool.smtp.port

stringa

null

Specifica la porta del server SMTP. Esempio: 25

jics.spool.smtp.username

stringa

null

Specifica il nome utente del server SMTP.

jics.xa.agent.timeout

numero

jildb.backend

stringa

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

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

Fonte dati primaverile standard con sottochiavi

Contiene le informazioni di connessione per il database Jics.

jildb.record-hold-timeout

int

10000

Specifica il periodo di timeout di attesa, in millisecondi, per il meccanismo di registrazione in Jildb.

job.default.encoding

stringa

CP1047

Specifica la codifica predefinita utilizzata per inizializzare l'archiviazione a livello di lavoro. Ad esempio, gli switch dell'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. Separare ogni formato con. \

localTimeFormat

stringa

Elenco dei formati di ora locale. Separa ogni formato con \

localTimestampFormat

stringa

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

lockTimeout

numero

500

Il timeout del blocco, in millisecondi.

logging.config

Path

percorso di classe: logback-main.xml

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

mapTransfo.prefixes

stringa

&,@,%%

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

mf.runtime.switch.N

booleano

true

Consente l'inserimento nullo per i file sequenziali lineari di natura MF.

4.4.0

mf.runtime.switch.T

booleano

false

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

4.4.0

mq.connection.pool.share

booleano

false

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

4.9.0

mq.queues

stringa

sqs

Specifica il broker di code supportato da sqs utilizzare tra Amazon SQS, Rabbit MQ locale o IBMMQ locale. rabbitmq jms

mq.queues.default.syncpoint

booleano

false

Specifica il comportamento predefinito per i comandi MQ PUT quando non sono impostati né MQPMO_SYNCPOINT né MQPMO_NO_SYNCPOINT. Se impostato su true, agisce come se i messaggi NON vengano salvati direttamente durante il comando PUT. MQPMO_SYNCPOINT Se 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 della connessione Atomikos supportate

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

mq.queues.jmsMQQueueManagers[N]

Quando mq.queues èjms, 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 incoraggiato, 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 delle code IBMMQ.

mq.queues.jmsMQQueueManagers[N].jmsMQSSLCipher

stringa

null

La suite di crittografia SSL IBMMQ. Un esempio potrebbe essere. "*TLS12ORHIGHER" Fai riferimento alla documentazione ufficiale TLS CipherSpecs e CipherSuites alle classi IBM MQ per JMS per maggiori dettagli.

mq.queues.jmsMQQueueManagers[N].jmsMQUserid

stringa

null

Il nome utente IBMMQ.

mq.queues.non.jms.client

booleano

false

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

4.5.0

mq.queues.rabbitMQHost

stringa

null

Il nome host Rabbit MQ.

mq.queues.rabbitMQPassword

stringa

null

La password 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

aaaa- MM-dd

Il formato della data e dell'ora.

pgmTimeFormat

stringa

HH.mm.ss

Il formato dell'ora utilizzato 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 tenterà di 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 QTEMP.

quartz.scheduler.stand-by-if-error

booleano

false

Specifica se attivare l'esecuzione del lavoro se il job scheduler è in modalità standby. Se impostato su true, quando è abilitata l'esecuzione del job non viene attivata.

query.useConcatCondition

booleano

false

Specifica se la condizione chiave è generata dalla concatenazione di chiavi o meno.

reportOutputPath

stringa

/reports

Il percorso di output del report.

returnHttp5xxResponseForFailedSyncJob

booleano

false

Specifica se restituire il codice di risposta HTTP della serie 500 in caso di esecuzione non riuscita del processo sincronizzato.

4.10.0

rollbackOnRTE

booleano

false

Specifica se eseguire il rollback della transazione di run unit implicita sulle eccezioni di runtime.

sctThreadLimit

Long

5

Il limite di thread per l'attivazione degli script.

server.servlet.session.timeout

stringa

30 m

Specifica 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 sonourl,cookie,ssl. È possibile specificare più valori separati da virgole. Nota: quando si esegue la distribuzione su Tomcat, è necessario impostare cookies=false context.xml perché Tomcat ha la precedenza per la configurazione della modalità di tracciamento.

spring.aws.application.credentials

stringa

null

Carica le AWS 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 di Bluesam Redis, vedi. AWS I segreti di Transform for mainframe Runtime

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

stringa

null

Specifica l'ARN segreto delle credenziali per il provider di persistenza Redis del meccanismo di controllo 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, vedi. AWS I segreti di Transform for mainframe Runtime

spring.aws.client.jics.redis.secret

stringa

null

Specifica l'ARN segreto delle credenziali per JICS Redis server Connection Factory, vedi. 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 di sessione per ambienti ad alta disponibilità. I valori possibili sono none o. redis 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 di dati RDBMS legacy a un RDBMS moderno. Ad esempio, è possibile 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 abilitata, esegue automaticamente il commit della connessione corrente prima di passare a una nuova connessione all'origine dati in ambienti non XA per evitare l'instabilità della connessione. Se disabilitato, registra un messaggio di avviso relativo a potenziali problemi di connessione durante le operazioni di ripristino.

4.10.0

sqlIntegerOverflowAllowed

booleano

false

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

startDefaultJob

stringa

false

Specifica se inizializzare il processo predefinito alla prima transazione.

stepFailWhenAbend

booleano

true

Specifica se generare un termine di attesa se un passaggio non riesce o completa l'esecuzione.

stopExecutionWhenProgNotFound

booleano

true

Specifica 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 del sistema DATSEP.

I valori possibili sono barra (`/`), trattino (`—`), punto (`.`), virgola (`,`) o vuoto (``). Il valore deve essere specificato tra virgolette doppie «».

5.17.0

system.qdecfmt

stringa

taskExecutor.allowCoreThreadTimeOut

booleano

false

Specifica se consentire il timeout dei thread principali in JCIS. Ciò consente la crescita e la riduzione dinamiche 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 impostare 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. Usa questo parametro per impostare la dimensione della coda. (= numero massimo di transazioni in sospeso quando viene raggiunto) taskExecutor.maxPoolSize

tempFilesDirectory

stringa

null

Specifica il nome della posizione della cartella dei file temporanei generati.

tempFolderPattern

stringa

null

Specifica 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: il pattern 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

Specifica se l'input dell'utente deve essere in lettere maiuscole.

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 è formattato in una struttura rientrata leggibile dall'uomo (ben stampata). 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, potrebbe essere necessario configurare una o più applicazioni Web opzionali che rappresentino il supporto per dipendenze come z/OS AS/400, o. IMS/MFS Le tabelle seguenti contengono gli elenchi dei key/value parametri disponibili per la configurazione di ciascuna 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 completa dei key/values parametri di questa applicazione.

Chiave Tipo Valore predefinito Description Versione di rilascio

convertGraphicDataToFullWidth

booleano

true

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

encoding

stringa

ASCII

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

forcedDate

stringa

Forza la data a quella 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.

frozenDate

booleano

true

Specifica se bloccare la data. Si applica solo se forcedDate è impostato anche.

hasGraphic

booleano

false

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

idcams.deleteFromAllSubfolders

booleano

false

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

5.155.0

idcams.encoding.forced

stringa

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

4.4.0

idcams.repro.failOnMissingOutput

booleano

false

Se impostato su true, IDCAMS REPRO fallirà anticipatamente 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 apportate 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

aaaa- MM-dd

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

load.format.dbTime

stringa

HH:mm:ss

Il tempo di utilizzo del database dell'utilità di caricamento.

load.format.localDate

stringa

dd. MM.yyyy\ dd/MM /aaaa\ aaaa- 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

0s

L'utilità pointshift for load in codice SQL. Esegue il processo di spostamento dei caratteri. Obbligatorio quando il database di destinazione di DB2 è Postgresql.

logging.config

Path

percorso di classe: logback-utility.xml

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

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

Fonte di dati primaverile 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 primaria, 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. Si aspetta 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. Si aspetta una codifica CP1047 valida,,,. IBM930 ASCII UTF-8

4.5.0

treatLargeNumberAsInteger

booleano

false

Specifica se trattare i numeri grandi come. Integer Vengono trattati come di BigDecimal default.

unload.bmc.useInto

booleano

false

Specifica se gestire la parola chiave di controllo INTO bmc per l'utilità di scarico.

unload.chunkSize

numero

0

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

unload.columnFiller

stringa

spazio

Il riempitivo della colonna dell'utilità di scarico.

unload.computeRecordSizeIfNull

booleano

false

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

unload.fetchSize

numero

0

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

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

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

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

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

Specifica se scrivere l'indicatore nullo nel file di output di scaricamento.

unload.noPad

booleano

true

Indica che i campi con caratteri a lunghezza variabile (VARCHAR) devono essere scaricati senza alcun riempimento fino alla lunghezza massima.

4.5.0

unload.sqlCodePointShift

numero

0

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

unload.useDatabaseConfiguration

booleano

false

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

unload.varCharIsNull

booleano

false

Usa questo parametro nel programma INFTILB, se impostato su, tutti i campi non annullabili con valori true vuoti (spazio) 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 completa dei key/values parametri di questa applicazione.

Chiave Tipo Valore predefinito Description

commands-off

stringa

Elenco dei 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 disattivare o sovrascrivere un programma esistente. PGM_BASICè un programma AWS Transform specifico per mainframe Runtime progettato per scopi di debug.

encoding

stringa

ASCII

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

forcedDate

stringa

Forza la data a quella 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

percorso di classe: logback-utility.xml

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

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

Fonte di dati primaverile 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 primaria, 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 panoramica esaustiva dei key/values parametri per 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 addConsente di mantenere i checkpoint quando ne viene creato uno nuovo e aggiunto al registro. Da utilizzare per end mantenere il checkpoint all'arresto del server. Qualsiasi altro valore disabilita la persistenza. Nota 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). Si aspetta 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 IMS ISRT 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 tenterà di interrompere il programma. Non è 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

percorso di classe: logback-utility.xml

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

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

stringa

Fonte di dati primaverile 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 AWS Mainframe Modernization. Installa questa applicazione solo se il carico di lavoro modernizzato include programmi GS21.

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

Chiave Tipo Valore predefinito Description

aim.sockets.socketConfigurations

elenco

Nessuno

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

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

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

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

Fonte di 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.

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 Spring client. Queste proprietà inizializzano i bean dalle classi impacchettate in 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 configurare l'applicazione web client che utilizza i bean delle classi impacchettate 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 attivare 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

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

4.9.0

blu4iv.dtaara.library.disable

booleano

false

Controlla l'uso della libreria nel contesto delle operazioni nell'area dati. Se impostato su true, l'utilizzo della libreria è disabilitato per le operazioni nell'area dati, ma ciò non influisce sull'utilizzo di QTemp. Se impostata 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 ad alta intensità 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 della memoria massimizzando 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, aiutando a soddisfare i requisiti di sicurezza monitorando chi ha effettuato l'accesso 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 i dettagli.

5.0.0

Se abilitato, l'utente può fornire la configurazione del file di logback per registrare i log di accesso alle 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 necessario 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

La a endpoint/URI cui si è 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 configurazione del 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 log:

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 la traccia distribuita

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 lungo l'intero ciclo di vita delle richieste.

Chiave Tipo Valore predefinito Description Versione di rilascio

gapwalk.tracing.enabled

booleano

false

Abilita la traccia distribuita per GapWalk le applicazioni. Se abilitato, propaga traceID e SpanID per l'esecuzione di processi in batch.

Se abilitata, la funzionalità di tracciamento propaga il contesto di traccia. I log possono includere i seguenti campi MDC:

Campo MDC Description

Span 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 pattern di log. 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