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 Blu Age 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. Puoi usare questa pagina per conoscere le proprietà disponibili per AWS Blu Age Runtime e come abilitarle.
Argomenti
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 ############################################################# ##### 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.
Chiave | Tipo | Valore predefinito | Descrizione | Versione di rilascio |
---|---|---|---|---|
|
Path |
classpath: logback-main.xml |
Chiave standard per il riferimento al file di configurazione logback. Sono disponibili anche altre chiavi di registrazione standard. |
|
|
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. |
|
|
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 |
||
|
Fonte di dati Spring standard con sottochiavi |
Contiene le informazioni di connessione per il database Jics. |
||
|
string |
Speciifica il tipo di database utilizzato nel backend Jildb, ad esempio Oracle. |
||
|
int |
10000 |
Speciifica il periodo di timeout di attesa, in millisecondi, per il meccanismo di conservazione dei record in Jildb. |
|
|
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. |
||
|
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 |
|
string |
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 |
|
Proprietà Redis supportate |
Specifica le proprietà di configurazione per gli spazi utente redis store, vedi. Proprietà della cache Redis disponibili in AWS Blu Age Runtime |
4.10.0 | |
|
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. |
|
|
booleano |
false |
Se disabilitarlo Blusam completamente. |
|
|
string |
Se non è impostata, la Blusam cache non verrà utilizzata. I valori possibili (implementazioni della cache) sono cache e redis (Proprietà della cache Redis). |
||
|
number |
10 |
Specifica la dimensione massima del threadpool utilizzata per disabilitare i set di dati bluesam per l'elaborazione in batch. |
4.5.0 |
|
number |
1000 |
Speciifica il tempo (in millisecondi) di attesa tra ogni iterazione quando si esegue il polling di bluesam status per verificare le attività online. |
4.5.0 |
|
number |
3 |
Speciifica il numero massimo di tentativi quando il polling di bluesam status ha esito negativo. |
4.5.0 |
|
booleano |
false |
Speciifica se controllare o meno lo stato del set di dati bluesam prima di accedervi. |
4.5.0 |
|
string |
null |
Specifica l'ARN segreto delle credenziali per la cache Bluesam Redis, vedere. AWS I segreti di Blu Age Runtime |
|
|
string |
null |
Specifica l'ARN segreto delle credenziali per Bluesam blocca la cache Redis, vedi. AWS I segreti di Blu Age Runtime |
|
|
string |
Impone la data alla data fornita, se presente. |
||
|
string |
true |
Specificate se i file contengono intestazioni che non devono essere incluse nel conteggio delle righe. |
|
|
booleano |
true |
Specifica se congelare la data. Si applica solo se |
|
|
dimensione dei dati (esempio: 12 MB) |
La soglia di ordinamento: quando passare all'ordinamento esterno (unione). |
||
|
number |
32760 |
La dimensione del blocco predefinita da utilizzare per i byte BDW. |
|
|
string |
MMDDYY |
Il modulo della data. |
|
|
string |
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. |
||
|
string |
VELOCITÀ |
Applicato per identificare l'applicazione in JICS (almeno 4 caratteri, nessuna lunghezza massima). |
|
|
string |
CICS |
L'identificazione del sistema (SYSID). |
|
|
string |
TERMINE |
L'identificatore del terminale (massimo 4 caratteri, minimo 1). |
|
|
string |
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. |
||
|
string |
IL MIO NOME UTENTE |
Il nome utente (massimo 10 caratteri, minimo 1). |
|
|
string |
IL MIO NOME DI RETE |
Il nome della rete (massimo 8 caratteri, minimo 1). |
|
|
string |
XXX |
L'identificazione dell'operatore a 3 caratteri. |
|
|
string |
NOME DEL LAVORO |
Il nome del lavoro. |
|
|
string |
SYSNAME |
Il nome del sistema AS4 00 (sysname). |
|
|
number |
0 |
La lunghezza dell'area di lavoro comune (CWA). |
|
|
string |
CP-037 |
Set di caratteri JICS utilizzato a livello globale. |
|
|
string |
bluesam |
Implementazione JICS Temporary Storage Queue (TSQ) (i valori consentiti sono//) |
|
|
Proprietà Redis supportate |
Specifica le proprietà di configurazione per il server Redis JICS TS Queues, vedi. Proprietà Redis supportate |
||
|
string |
null |
Specificare l'ARN segreto delle credenziali per il server Redis JICS TS Queues, vedere. AWS I segreti di Blu Age Runtime |
|
|
number |
500 |
Il timeout di blocco, in millisecondi. |
|
|
number |
Facoltativo. 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. |
||
|
booleano |
false |
Speciifica se consentire l'overflow di numeri interi SQL, ovvero se è consentito inserire valori più grandi nella variabile host. |
|
|
booleano |
true |
Specifica se consentire l'overflow del cursore. Imposta per |
|
|
string |
|
Il percorso di output del report. |
|
|
string |
biscotto |
Specifica le modalità di tracciamento della sessione da utilizzare. I valori possibili sono |
|
|
string |
30 m |
Speciifica la durata del timeout della sessione. Esempi: |
|
|
string |
nessuno |
La cache della sessione per ambienti ad alta disponibilità. I valori possibili sono |
|
|
booleano |
true |
Speciifica se interrompere l'esecuzione se non viene trovato un programma. Se impostato su |
|
|
booleano |
false |
Speciifica se utilizzare Human Readable SYSPRINT, sulla console o sull'output del file. |
|
|
booleano |
false |
Specifica se eseguire il rollback della transazione implicita dell'unità di esecuzione sulle eccezioni di runtime. |
|
|
Long |
5 |
Il limite dei thread per l'attivazione degli script. |
|
|
string |
rifiutare |
Come reagire quando si decodificano dati numerici non validi. I valori consentiti sono |
|
|
string |
IEEE_754 |
Il tipo a doppia virgola mobile è il formato usato per codificare e decodificare un numero a virgola mobile. I valori consentiti sono |
4.7.0 |
|
string |
La directory per i file batch. input/output |
||
|
booleano |
false |
Speciifica se impostare la dimensione estesa dei messaggi IMS. |
|
|
booleano |
false |
Speciifica se impostare il valore precedente predefinito del set di dati. |
|
|
string |
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, |
||
|
string |
Posizione del file sql che dovrebbe contenere una query univoca che restituisce il numero di oggetti nello schema jics (se presente). |
||
|
string |
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. |
||
|
string |
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 |
||
|
string |
|||
|
number |
|||
|
booleano |
false |
Speciifica se la condizione della chiave è creata o meno mediante la concatenazione di chiavi. |
|
|
string |
|||
|
booleano |
false |
Speciifica se rilasciare un controllo sull'esistenza dei file per Dataset with DISP SHR o OLD. |
|
|
booleano |
false |
Specifica se utilizzare la specifica Control-M per la sostituzione delle variabili. |
|
|
string |
CP1145 |
Codifica delle carte: da utilizzare con. |
|
|
string |
&,@,%% |
Elenco di prefissi da utilizzare per la trasformazione delle variabili ControlM. Ciascuno separato da una virgola. |
|
|
booleano |
false |
Specifica se rilasciare un segno di spunta se la dimensione del file è un multiplo della dimensione del record. |
|
|
booleano |
true |
Specifica se alzare un abend se un passaggio ha esito negativo o completa l'esecuzione. |
|
|
booleano |
false |
Speciifica se restituire il codice di risposta HTTP della serie 500 per l'esecuzione non riuscita di un processo sincronizzato. |
4.10.0 |
|
number |
100000 |
L'intervallo di commit di bluesam. |
|
|
booleano |
true |
Speciifica se l'input dell'utente deve essere in maiuscolo. |
|
|
string |
Consentono di forzare un ID di terminale logico comune nel caso di un'emulazione IMS. Se non è impostato, viene utilizzato SessionID. |
||
|
string |
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. |
||
|
string |
ASCII |
La codifica utilizzata nei progetti (non nei file groovy). Prevede una codifica |
|
|
string |
CP297 |
La codifica dei file CL. Prevede una codifica valida |
|
|
string |
EBCDIC_STRICT |
La modalità per la codifica o la decodifica dei comandi del linguaggio di controllo (CL). I valori consentiti sono |
|
|
string |
Elenco dei programmi IMS da utilizzare. Separare ogni parametro con un punto e virgola ( |
||
|
string |
CP297 |
La codifica JHDB (Java Hierarchical Database). Prevede una stringa di codifica valida,,,... |
|
|
string |
file:. /configurazione/ |
Un parametro di configurazione che specifica una cartella principale aggiuntiva, specifica per il runtime, per le cartelle psbs e dbds. |
|
|
string |
nessuno |
La modalità di persistenza del checkpoint. I valori consentiti sono |
|
|
string |
file:. /configurazione/ |
In caso contrario |
|
|
number |
5000 |
La durata della cache (in millisecondi) utilizzata nella navigazione gerarchica per un RDBMS. |
|
|
booleano |
true |
Speciifica se abilitare un prefisso di database nella navigazione gerarchica per un RDBMS. |
|
|
booleano |
true |
Speciifica se utilizzare il parametro limit join usage sui grafici RDBMS. |
|
|
number |
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. |
|
|
number |
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). |
|
|
number |
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) |
|
|
booleano |
false |
Speciifica 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). |
|
|
booleano |
false |
Specifica se attivare il run unit launcher pool in JICS. |
|
|
number |
20 |
La dimensione del pool di avvio dell'unità di esecuzione in JICS. |
|
|
number |
1000 |
L'intervallo tra ogni esecuzione dell'attività che regola la dimensione del pool. |
|
|
number |
2 |
Il numero di thread utilizzati per produrre le istanze mancanti nella coda durante l'esecuzione dell'attività di regolazione. |
|
|
booleano |
false |
Speciifica se attivare la precostruzione del contesto del programma. |
|
|
number |
100 |
L'intervallo tra ogni esecuzione dell'attività che regola le dimensioni del pool. |
|
|
number |
5 |
Il numero di thread utilizzati per produrre le istanze mancanti nella coda durante l'esecuzione dell'attività di regolazione. |
|
|
number |
2 |
Il numero di istanze che verranno create la prima volta che è necessario un contesto. |
|
|
string |
null |
Carica le AWS credenziali dal file dei profili delle credenziali in JICS. |
|
|
string |
eu-west-1 |
La AWS regione per Amazon Simple Queue Service, utilizzata in JICS. |
|
|
string |
CP037 |
La codifica degli script JCL scritti nella coda JICS dedicata. |
|
|
string |
JICS |
Il nome della coda in cui è possibile scrivere gli script JCL riga per riga in fase di esecuzione. |
|
|
string |
eu-west-3 |
La AWS regione per il servizio AWS SQS MQ. |
|
|
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. |
|
|
booleano |
false |
Speciifica se consentire ai costruttori di SQL di raccogliere e visualizzare informazioni statistiche. |
|
|
string |
yyyy-MM-dd |
Il formato della data di destinazione del db. |
|
|
string |
HH: mm: ss |
Il formato dell'ora di destinazione del db. |
|
|
string |
yyyy-MM-dd HH: mm: ss.ssssss |
Il formato del timestamp di destinazione del db. |
|
|
string |
ISO |
dateTimeFormat Descrive come trasferire il tipo di data, ora e ora del database in entità semplificatrici di dati. I valori consentiti sono/// |
|
|
string |
Elenco di formati di data locali. Separa ogni formato con. |
||
|
string |
Elenco dei formati dell'ora locale. Separa ogni formato con |
||
|
string |
Elenco dei formati di timestamp locali. Separa ogni formato con. |
||
|
string |
yyyy-MM-dd |
Il formato della data e dell'ora. |
|
|
string |
HH.mm.ss |
Il formato dell'ora usato per l'esecuzione di pgm (programmi). |
|
|
string |
yyyy-MM-GD-hh.mm.ss.ssssss |
Il formato del timestamp. |
|
|
booleano |
true |
Specifica se memorizzare nella cache i metadati del database. |
|
|
booleano |
false |
Specifica se disabilitare il taglio di tutti i parametri della stringa sql. |
|
|
number |
Il valore fetchSize per i cursori. Da utilizzare quando si recuperano dati utilizzando blocchi tramite utilità load/unload. |
||
|
booleano |
true |
Specifica se controllare il contenuto dei file Groovy prima della registrazione. |
|
|
number |
9 |
La lunghezza dell'ID univoco di QTEMP. |
|
|
booleano |
false |
Se abilitare la registrazione del database QTEMP. |
|
|
number |
0 |
Per specificare quando è abilitato |
|
|
booleano |
true |
Speciifica se i dati non validi sono tollerati per il tipo compresso. |
|
|
number |
-1 |
Specifica un timeout per qualsiasi esecuzione in secondi. program/transaction Trascorso questo tempo, il sistema proverà a interrompere il programma. |
|
|
string |
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. |
|
|
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. |
|
|
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. |
|
|
booleano |
false |
Se impostato su true, assicura che non ByteRange venga creato nessun valore con valori errati. Il valore predefinito è false. |
|
|
booleano |
false |
Specifica se abilitare la scrittura su logger anziché sul flusso di output di sistema predefinito in default |
|
|
string |
null |
Speciifica il nome della posizione della cartella dei file temporanei generati. |
|
|
booleano |
true |
Speciifica se eliminare il contenuto della cartella dei file temporanei all'avvio dell'applicazione. |
|
|
string |
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_ {}. tempFolderPattern 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 |
|
|
booleano |
false |
Speciifica se abilitare la generazione dell'errore SQLCODE 502 quando si apre un cursore già aperto. |
|
|
string |
null |
Speciifica l'host del server SMTP. Esempio: |
|
|
string |
null |
Speciifica la porta del server SMTP. Esempio: 25 |
|
|
string |
null |
Speciifica la password di accesso del server SMTP. |
|
|
string |
null |
Speciifica il nome utente del server SMTP. |
|
|
booleano |
false |
Speciifica la modalità di debug per il server SMTP. |
|
|
string |
|
Attiva la configurazione di sicurezza globale (autenticazione XSS, CORS, CSRF, OAUTH...). I valori consentiti sono |
|
|
string |
null |
Metodo di autenticazione globale. Il valore consigliato è |
|
|
string |
null |
L'URI dell'emittente del provider di identità (IdP). Questa opzione è obbligatoria quando |
|
|
stringa [] |
|
L'elenco delle origini da consentire. Questa opzione deve |
|
|
string |
|
Il percorso della directory GDG è la directory in cui sono archiviati i file gdg. |
4.6.0 |
|
stringa [] |
null |
L'elenco delle intestazioni personalizzate da consentire. Questa opzione deve |
4.8.0 |
|
string |
|
L'elenco dei parametri URL da aggiungere all'MDC durante l'esecuzione dello script batch Groovy. |
|
|
string |
|
L'attributo claim che contiene l'elenco di tutti i gruppi a cui appartiene un utente. |
|
|
string |
|
Il nome dell'attributo claim utilizzato per identificare una richiesta dell'utente. Utilizzalo |
|
|
string |
|
Quando |
|
|
string |
|
Quando |
|
|
string |
|
Attiva/disattiva la configurazione del filtro. URIs I valori consentiti sono |
|
|
stringa [] |
null |
L'elenco di URIs da bloccare. Questa opzione è obbligatoria quando |
|
|
Proprietà Redis supportate |
Specifica le proprietà di configurazione per il Connection Factory del server JICS Redis, vedere. Proprietà Redis supportate |
||
|
string |
null |
Speciifica l'ARN segreto delle credenziali per la fabbrica di connessioni al server JICS Redis, vedere. AWS I segreti di Blu Age Runtime |
|
|
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. |
|
|
number |
-1 |
Speciifica la durata del periodo di conservazione dei checkpoint JCL nel provider di persistenza o nel registro in memoria. |
|
|
string |
SECONDI |
Speciifica l'unità di durata temporale per la |
|
|
string |
null |
Specifica il provider di persistenza del meccanismo di checkpoint JCL. I valori consentiti sono. |
|
|
Proprietà Redis supportate |
Specifica le proprietà di configurazione per il provider di persistenza REDIS del meccanismo di checkpoint JCL, vedi. Proprietà Redis supportate |
||
|
string |
CP1047 |
Speciifica la codifica predefinita utilizzata per inizializzare la memorizzazione a livello di processo. Ad esempio, gli switch nell'applicazione BLU4 IV utilizzano questa codifica per l'inizializzazione a zeri. |
4.9.0 |
|
string |
null |
Speciifica l'ARN segreto delle credenziali per il provider di persistenza Redis del meccanismo di checkpoint JCL, vedi. AWS I segreti di Blu Age Runtime |
|
|
booleano |
false |
Indicato per impostare le seguenti |
|
|
string |
null |
Imposta il valore sulla proprietà di sistema |
|
|
string |
null |
Impostate il valore sulla proprietà di sistema |
|
|
string |
null |
Imposta il valore sulla proprietà di sistema |
|
|
string |
null |
Imposta il valore sulla proprietà di sistema |
|
|
string |
null |
Imposta il valore sulla proprietà di sistema |
|
|
string |
|
Speciifica quale queue brocker supportato da utilizzare tra Amazon |
|
|
In caso |
|||
|
string |
null |
Il nome del gestore di code IBMMQ. |
|
|
string |
null |
Il nome dell'applicazione IBMMQ. |
|
|
string |
null |
Il nome del canale IBMMQ. |
|
|
string |
null |
Il nome host IBMMQ. |
|
|
number |
null |
La porta IBMMQ. |
|
|
string |
null |
Il nome utente IBMMQ. |
|
|
string |
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 |
|
|
number |
0 |
La dimensione massima del pool IBMMQ. Con 0, è abilitato un numero infinito di connessioni fisiche. |
|
|
string |
null |
La suite di crittografia SSL IBMMQ. Un esempio potrebbe essere. |
|
|
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 RFH2 formato verrà utilizzato per JMS. |
4.5.0 |
|
string |
null |
Il nome host di Rabbit MQ. |
|
|
string |
null |
L'hostname virtuale Rabbit MQ. |
|
|
number |
null |
La porta Rabbit MQ. |
|
|
string |
null |
L'utente Rabbit MQ. |
|
|
string |
null |
La password di Rabbit MQ. |
|
|
booleano |
true |
Abilita l'inserimento nullo per i file sequenziali di linea MF Nature. |
4.4.0 |
|
booleano |
false |
Consente l'inserimento di caratteri di tabulazione nei file sequenziali di linee MF Nature. |
4.4.0 |
|
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 query-to-database mappatura. |
4.6.0 |
|
booleano |
true |
Determina lo stile di formattazione dell'output XML generato all'interno della classe. XmlGenerator Se impostato su |
4.8.0 |
|
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 |
|
elenco <String> |
null |
Definisce un elenco di schemi che devono essere memorizzati nella cache. |
4.9.0 |
|
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 |
|
booleano |
false |
Speciifica se l' |
|
|
string |
|
Specificare se inizializzare il processo predefinito alla prima transazione. |
|
|
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. |
|
|
Proprietà di fabbrica di connessione Atomikos supportate |
Specifica le proprietà di configurazione per il pool di connessioni JMS MQ. |
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, ad esempio z/OS, AS/400, or IMS/MFS. The following tables contain lists of the available key/value i parametri per la configurazione di ciascuna applicazione Web opzionale.
gapwalk-utility-pgm.guerra
Questa applicazione web opzionale contiene il supporto per i programmi di Z/OS utilità.
Questa tabella fornisce una panoramica esaustiva dei key/values parametri di questa applicazione.
Chiave | Tipo | Valore predefinito | Descrizione | Versione di rilascio |
---|---|---|---|---|
|
Path |
classpath: logback-utility.xml |
Chiave standard per il riferimento al file di configurazione logback. Sono disponibili anche altre chiavi di registrazione standard. |
|
|
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. |
|
|
string |
jdbc/primario |
Il nome JNDI (Java Naming And Directory Interface) per l'origine dati principale, se si utilizza JNDI. |
|
|
Fonte 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 |
|
|
string |
ASCII |
La codifica utilizzata nei programmi di utilità. Prevede una codifica valida |
|
|
string |
ASCII |
Il set di caratteri di codifica syspunch. Prevede una codifica valida,,. |
|
|
string |
ASCII |
Il set di caratteri di codifica del set di dati del file SYSTIN. Prevede una codifica |
4.5.0 |
|
string |
EBCDIC_STRICT |
La modalità per codificare o decodificare i tipi di dati suddivisi in zone. I valori consentiti sono// |
|
|
string |
La codifica utilizzata nel programma di utilità IDCAMS. Prevede una codifica |
4.4.0 | |
|
number |
0 |
Dimensione del blocco utilizzata per l'utilità di scarico. |
|
|
booleano |
false |
Determina se calcolare la dimensione del record se non specificata. Se specificato, il valore rimane invariato. |
|
|
number |
0 |
Il codice SQL pointshift per l'utilità unload. Esegue il processo di cambio dei caratteri. Richiesto quando il database di destinazione DB2 è Postgresql. |
|
|
string |
spazio |
Il riempitivo di colonne dell'utilità unload. |
|
|
booleano |
false |
Usa questo parametro nel programma INFTILB, se impostato su |
|
|
booleano |
false |
Speciifica se utilizzare la configurazione di data o ora da application-main.yml nell'utilità unload. |
|
|
string |
MM/dd/yyyy |
Se abilitato, |
|
|
string |
H.mm.ss |
Se |
|
|
string |
yyyy-MM-dd-HH.mm.ss.ssssss |
Se abilitato, |
|
|
esadecimale |
6F |
Il valore Null Byte Indicator (NBI) da aggiungere quando il valore del database è nullo. |
|
|
esadecimale |
00 |
Il valore Null Byte Indicator (NBI) da aggiungere quando il valore del database non è nullo. |
|
|
booleano |
false |
Speciifica se scrivere l'indicatore null nel file di output di scaricamento. |
|
|
booleano |
false |
Speciifica se gestire la parola chiave di controllo INTO bmc per l'utilità unload. |
|
|
number |
0 |
Consente di regolare la dimensione del recupero quando si gestiscono i cursori nell'utilità unload. |
|
|
booleano |
true |
Indica che i campi con caratteri a lunghezza variabile (VARCHAR) devono essere scaricati senza alcuna imbottitura fino alla lunghezza massima. |
4.5.0 |
|
booleano |
false |
Speciifica se trattare i numeri grandi come. |
|
|
number |
0 |
La dimensione del batch dell'utilità di caricamento. |
|
|
string |
gg.mm.aaaa\\ aaaa-MM-gg dd/MM/yyyy |
Il formato di data locale dell'utilità di caricamento da utilizzare. |
|
|
string |
HH:mm:ss\ hh.mm.ss |
Il formato dell'ora locale dell'utilità di caricamento da utilizzare. |
|
|
string |
yyyy-MM-dd |
Il formato del database dell'utilità di caricamento da utilizzare. |
|
|
string |
HH:mm:ss |
Il tempo di utilizzo del database dell'utilità di caricamento. |
|
|
number |
0 s |
Il codice SQL pointshift per l'utilità di caricamento. Esegue il processo di cambio dei caratteri. Richiesto quando il database di destinazione DB2 è Postgresql. |
|
|
booleano |
false |
Imposta questo parametro |
|
|
string |
|
Impone la data alla data fornita, se presente. |
|
|
booleano |
true |
Specifica se congelare la data. Si applica solo se |
|
|
string |
mvs |
tipo di file.jcl. I valori consentiti sono/ |
|
|
booleano |
false |
Se l'utilità INFUTILB deve gestire le colonne GRAPHIC. DB2 |
|
|
booleano |
true |
Speciifica se convertire i dati grafici in formato a larghezza intera. |
gapwalk-cl-command.guerra
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 | Descrizione |
---|---|---|---|
|
Path |
classpath:logback-utility.xml |
Chiave standard per il riferimento al file di configurazione logback. Sono disponibili anche altre chiavi di registrazione standard. |
|
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. |
|
string |
jdbc/primario |
Il nome JNDI (Java Naming And Directory Interface) per l'origine dati principale, se si utilizza JNDI. |
|
Fonte 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 |
|
string |
ASCII |
La codifica utilizzata nei programmi di utilità. Prevede una codifica valida |
|
string |
EBCDIC_STRICT |
La modalità per codificare o decodificare i tipi di dati suddivisi in zone. I valori consentiti sono// |
|
string |
|
Elenco di comandi da disattivare, separati da virgole. I valori consentiti sono |
|
string |
|
Forza la data alla data fornita, se presente. |
gapwalk-hierarchical-support.guerra
Questa applicazione web opzionale contiene il supporto per le IMS/MFS transazioni.
Questa tabella fornisce una visualizzazione esaustiva dei key/values parametri di questa applicazione.
Chiave | Tipo | Valore predefinito | Descrizione |
---|---|---|---|
|
Path |
classpath:logback-utility.xml |
Chiave standard per il riferimento al file di configurazione logback. Sono disponibili anche altre chiavi di registrazione standard. |
|
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. |
|
string |
|
La codifica JHDB (Java Hierarchical Database). Prevede una stringa di codifica valida,,,... |
|
string |
nessuno |
La modalità di persistenza del checkpoint. I valori consentiti sono |
|
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. |
|
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). |
|
string |
Tipo di backend Jhdb. Il valore previsto è |
|
|
string |
elenco di programmi da dichiarare come transazione completa. Separare ogni programma con una virgola ( |
|
|
string |
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 |
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 | Descrizione | Versione di rilascio |
---|---|---|---|---|
|
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 |
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 | Descrizione | Versione di rilascio |
---|---|---|---|---|
|
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 |
|
number |
10 |
La dimensione della cache interna per le operazioni DAO di input. Questa cache esiste a livello di programma (istanza singola). |
4.9.0 |
|
string |
Il nome della funzione di ordinamento per il database blu4iv. |
4.9.0 | |
|
string |
JPA |
Speciifica l'implementazione di accesso ai dati da utilizzare (JPA o JDBC). |
4.9.0 |
|
booleano |
false |
Abilita la cache in memoria. |
4.8.0 |
|
booleano |
false |
Aggiungi il tracciamento del numero di richieste alla cache. |
4.8.0 |
|
number |
10000 |
La dimensione della cache. |
4.8.0 |
|
string |
L'elenco delle tabelle del database da inserire nella cache. |
4.8.0 | |
|
string |
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 | |
|
booleano |
false |
Abilita l'uso dell'elenco delle librerie per risolvere una libreria di file. |
4.10.0 |
|
string |
L'elenco iniziale delle librerie ordinate da sinistra a destra. |
4.10.0 |
Configura la cache in memoria per AS4 00 applicazioni
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 a 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 | Descrizione | Versione di rilascio |
---|---|---|---|---|
|
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 | Descrizione |
---|---|
|
La data e l'ora in cui è stata effettuata la richiesta API |
|
Quanto tempo è stato impiegato per elaborare la richiesta API (millisecondi) |
|
L'indirizzo di origine da cui proviene la richiesta API |
|
Dove è ospitata l'API |
|
Il nome utente o l'identificatore della persona che effettua la richiesta API |
|
Un identificatore univoco per la sessione di accesso corrente dell'utente |
|
Il protocollo di trasferimento utilizzato, ad esempio, HTTP o HTTPS. |
|
A endpoint/URI cui è stato effettuato l'accesso |
|
Il codice di stato restituito dopo il completamento della richiesta API |
|
Il metodo di sicurezza utilizzato per proteggere la chiamata API (ad esempio, Token OAuth2, Anonymous) |
|
Il tipo di richiesta HTTP effettuata (ad esempio, GET, POST, DELETE,...) |
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