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 (Self-Managed Experience). I clienti esistenti possono continuare a utilizzare il servizio normalmente. [Per ulteriori informazioni, consulta AWS Modifica della disponibilità di Mainframe Modernization.](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html) 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 Nelle applicazioni Spring Boot `application-main.yml` c'è il file di configurazione in cui definiamo diversi tipi di proprietà come la porta di ascolto, la connettività del database e molte altre. È possibile utilizzare questa pagina per conoscere le proprietà disponibili per AWS Transform for mainframe Runtime e come abilitarle. **Topics** + [Notazione YML](#ba-runtime-key-value-yml) + [Avvio rapido/Casi d'uso](#ba-runtime-key-value-use-cases) + [Proprietà disponibili per l'applicazione principale](#ba-runtime-key-value-main) + [Proprietà disponibili per applicazioni Web opzionali](#ba-runtime-key-value-web) + [Proprietà disponibili per l'applicazione client](#ba-runtime-key-value-client) + [Configura la registrazione degli accessi alle API](#ba-runtime-api-access-logging) ## Notazione YML Nella seguente documentazione, una proprietà come questa `parent.child1.child2=true` è scritta come segue in formato YAML. ``` parent: child1: child2: true ``` ## Avvio rapido/Casi d'uso I seguenti casi d'uso mostrano esempi delle chiavi e dei valori applicabili. + Application-main.yml predefinito ``` ---- #### DEFAULT APPLICATION-MAIN.YML FILE ##### #### SHOWING USEFUL CONFIGURATION ELEMENTS ##### #### SHOULD BE OVERRIDDEN AND EXTERNALIZED ##### ################################# ##### Logging configuration ##### ################################# logging: config: classpath:logback-main.xml level.org.springframework.beans.factory.support.DefaultListableBeanFactory : WARN ################################ ##### Spring configuration ##### ################################ spring: quartz: auto-startup: false scheduler-name: Default properties: org.quartz.threadPool.threadCount: 1 jta: enabled: false atomikos.properties.maxTimeout : 600000 atomikos.properties.default-jta-timeout : 100000 jpa: # DISABLE OpenEntityManagerInViewInterceptor open-in-view: false # Fix Postgres JPA Error: # Method org.postgresql.jdbc.PgConnection.createClob() is not yet implemented. properties.hibernate.temp.use_jdbc_metadata_defaults : false ##################################### ##### Jics tables configuration ##### ##################################### # The dialect should match the jics datasource choice database-platform : org.hibernate.dialect.PostgreSQLDialect # org.hibernate.dialect.PostgreSQLDialect, org.hibernate.dialect.SQLServerDialect # those properties can be used to create and initialize jics tables automatically. # properties: # hibernate: # globally_quoted_identifiers: true # hbm2ddl: # import_files_sql_extractor : org.hibernate.tool.hbm2ddl.MultipleLinesSqlCommandExtractor # import_files : file:./setup/initJics.sql # auto : create ########################## ###### Level 2 cache ##### ########################## # cache: # use_second_level_cache: true # use_query_cache: true # region: # factory_class: org.hibernate.cache.ehcache.EhCacheRegionFactory # javax: # persistence: # sharedCache: # mode: ENABLE_SELECTIVE ########################## ###### Redis settings ##### ########################## session: store-type: none #redis # Secret manager configuration for global Redis cache aws: client: gapwalk: redis: secret: arn:aws:secretsmanager:XXXX ######################################### ##### JICS datasource configuration ##### ######################################### datasource: jicsDs: driver-class-name : org.postgresql.Driver # org.postgresql.Driver, com.microsoft.sqlserver.jdbc.SQLServerDriver url: jdbc:postgresql://localhost/jics # jdbc:postgresql://localhost:5433/jics, jdbc:sqlserver://localhost\SQLEXPRESS:1434;databasename=jics; username: jics password: jics type : org.postgresql.ds.PGSimpleDataSource # org.postgresql.ds.PGSimpleDataSource, com.microsoft.sqlserver.jdbc.SQLServerDataSource ##################################################### ##### Embedded Bluesam datasource configuration ##### ##################################################### bluesamDs : driver-class-name : org.postgresql.Driver url : jdbc:postgresql://localhost/bluesam username : bluesam password : bluesam type : org.postgresql.ds.PGSimpleDataSource ########################################## ##### Embedded Bluesam configuration ##### ########################################## bluesam : cache : ehcache persistence : pgsql ehcache: resource-pool: size: 4GB write-behind: enabled: true pgsql : dataSource : bluesamDs ######################### ##### Jics settings ##### ######################### rabbitmq.host: localhost jics: cache: false #redis resource-definitions.store-type: jpa # default value: jpa, other possible value: redis jics.disableSyncpoint : false #jics.initList: #jics.parameters.datform: DDMMYY #jics.parameters.applid: VELOCITY #jics.parameters.sysid: CICS #jics.parameters.eibtrmid: TERM #jics.parameters.userid: MYUSERID #jics.parameters.username: MYUSERNAME #jics.parameters.opid: XXX #jics.parameters.cwa.length: 0 #jics.parameters.netname: MYNETNAME #jics.parameters.jobname: MJOBNAME #jics.parameters.sysname: SYSNAME ############################################## ##### Jics RunUnitLauncher pool settings ##### ############################################## #jics.runUnitLauncherPool.enable: false #jics.runUnitLauncherPool.size: 20 #jics.runUnitLauncherPool.validationInterval: 1000 ######################### ##### Jhdb settings ##### ######################### #jhdb.lterm: LTERMVAL #jhdb.identificationCardData: SomeIDData ################################### ##### DateHelper configuration #### ################################### #forcedDate: "2013-08-26T12:59:58+01:57" ############################# ##### Sort configuration #### ############################# #externalSort.threshold: 256MB ################################### ##### Server timeout (10 min) #### ################################### spring.mvc.async.request-timeout: 600000 ############################### ##### DATABASE STATISTICS #### ############################### databaseStatistics : false ###################### ##### CALLS GRAPH #### ###################### callGraph : false #################################### ##### SSL configuration ##### #################################### gapwalk.ssl.enabled : true gapwalk.ssl.trustStore : "./config/clientkey.jks" gapwalk.ssl.trustStorePassword : mysslcertifpassword ################################## ##### MQ settings ##### ################################## mq.queues: jmsmq mq.queues.jmsMQQueueManagers[0].jmsMQQueueManager: QM1 mq.queues.jmsMQQueueManagers[0].jmsMQAppName: Gapwalk mq.queues.jmsMQQueueManagers[0].jmsMQChannel: DEV.APP.SVRCONN mq.queues.jmsMQQueueManagers[0].jmsMQHost: localhost mq.queues.jmsMQQueueManagers[0].jmsMQPort: 1415 mq.queues.jmsMQQueueManagers[0].jmsMQUserid: app mq.queues.jmsMQQueueManagers[0].jmsMQSSLCipher: "*TLS12ORHIGHER" mq.queues.jmsMQQueueManagers[1].jmsMQQueueManager: QM2 mq.queues.jmsMQQueueManagers[1].jmsMQAppName: Gapwalk mq.queues.jmsMQQueueManagers[1].jmsMQChannel: DEV.APP.SVRCONN mq.queues.jmsMQQueueManagers[1].jmsMQHost: localhost mq.queues.jmsMQQueueManagers[1].jmsMQPort: 1415 mq.queues.jmsMQQueueManagers[1].jmsMQUserid: app ######################################################### ##### Configuration properties for JMS MQ connection #### ######################################################### mq.queues.jms.connectionfactory.borrow-connection-timeout: 31 # Timeout, in seconds, for borrowing connections from the pool. mq.queues.jms.connectionfactory.ignore-session-transacted-flag: true # Whether or not to ignore the transacted flag when creating a session. mq.queues.jms.connectionfactory.local-transaction-mode: false # Whether or not to include local transactions. mq.queues.jms.connectionfactory.maintenance-interval: 62 # The time, in seconds, between runs of the pool's maintenance thread. mq.queues.jms.connectionfactory.max-idle-time: 63 # The time, in seconds, after which connections are cleaned up from the pool. mq.queues.jms.connectionfactory.max-lifetime: 0 # The time, in seconds, that a connection can be pooled for before being destroyed. 0 denotes no limit. mq.queues.jms.connectionfactory.max-pool-size: 1 # The maximum size of the pool. This property will be overwritten by mq.queues.jmsMQQueueManagers[N].jmsMQMaxPoolSize property (if provided). mq.queues.jms.connectionfactory.min-pool-size: 1 # The minimum size of the pool. mq.queues.jms.connectionfactory.reap-timeout: 0 # The reap timeout, in seconds, for borrowed connections. 0 denotes no limit. ############################### ##### SQL SHIFT CODE POINT #### ############################### # Code point 384 match unicode character \u0180 sqlCodePointShift : 384 ############################### ##### LOCK TIMEOUT RECORD #### ############################### # Blu4IV record lock timeout lockTimeout : 100 ############################## ##### REPORTS OUTPUT PATH #### ############################## reportOutputPath: reports ############################## ##### TASK EXECUTOR #### ############################## taskExecutor: corePoolSize: 5 maxPoolSize: 10 queueCapacity: 50 allowCoreThreadTimeOut: false ############################## ##### PROGRAM NOT FOUND #### ############################## stopExecutionWhenProgNotFound: false ###################################################### ##### DISP DEFAULT VALUE (to be removed one day) #### ###################################################### defaultKeepExistingFiles: true ###################################################### ##### BLOCKSIZE DEFAULT VALUE #### ###################################################### #blockSizeDefault: 32760 ##################################### ##### JOBQUEUE CONFIGURATION #### ##################################### jobqueue: api.enabled: false impl: none # possible values: quartz, none schedulers: # list of schedulers - name: queue1 threadCount: 5 - name: queue2 threadCount: 5 ################################################################################ ##### QUERY BUILDING ## # useConcatCondition : false by default # if true, in the query, the where condition is build with key concatenation ## ################################################################################ # query.useConcatCondition: true ######################################## ##### JCL Batch Restart Mechanism #### ######################################## jcl: checkpoint: enabled: false #expireTimeout: -1 #expireTimeoutUnit: SECONDS # Supported values: java.util.concurrent.TimeUnit #provider: redis ############################## ##### System parameters #### ############################## system.date.format:MDY system.date.separator: "/" ############################################################# ##### Database metadata schema inclusion configuration #### ############################################################# gapwalk: database: metadata: schema-inclusion: enabled: false schemas: global: - "SCHEMA1" - "SCHEMA2" ############################## ##### URL configuration #### ############################## gapwalk.post.script.mediatype.json: false ######################################## ##### CBLQDA parameters #### ######################################## gapwalk.cobol.cblqda.enabled: false ---- ``` + Usa file a lunghezza variabile con i comandi LISTCAT ``` [**/*.*] encoding=IBM930 reencoding=false [global] listcat.variablelengthpreprocessor.enabled=true listcat.variablelengthpreprocessor.type=rdw # use "rdw" if your .listcat file contains a set of records (RDW) # use "bdw" if your .listcat file contains a set of blocks (bdw) ``` + Fornisci un valore dell'indicatore Null Byte nell'utilità LOAD/UNLOAD ``` # Unload properties # For date/time: if use database configuration is enabled, formats are ignored # For nbi; use hexadecimal syntax to specify the byte value # - When the value is null in database : the value dumped to the file is filled by low value characters and the NBI is # equal to the byte 6F (the ? character) # - When the value is not null in database and the column is nullable: the NBI is equal to the byte 00 (low value) and NOT # equal to the byte 40 (space) unload: sqlCodePointShift: 0 nbi: whenNull: "6F" whenNotNull: "00" useDatabaseConfiguration: false format: date: MM/dd/yyyy time: HH.mm.ss timestamp: yyyy-MM-dd-HH.mm.ss.SSSSSS ``` ## Proprietà disponibili per l'applicazione principale Questa tabella fornisce una panoramica esaustiva dei key/values parametri. **Nota** Se stai migrando alla versione 5.1.0 o successiva e utilizzi bluesam con il comportamento predefinito: openWarmUp 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 | | --- | --- | --- | --- | --- | | `system.date.format` | stringa | MDY | Il formato della data di sistema DATFMT. | --- | | `system.date.separator` | stringa | / | Il separatore di data di sistema DATSEP. I valori possibili sono slash (`/`), dash (`—`), period (`.`), comma (`,`) o blank (``). Il valore deve essere specificato tra virgolette `""`. | 5.17.0 | | `logging.config` | Path | classpath: logback-main.xml | Chiave standard per il riferimento al file di configurazione logback. Sono disponibili anche altre chiavi di registrazione standard. | | | `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. | | | `datasource.jicsDs` \$1 -`driver-class-name` \$1 -`url` \$1 -`username` \$1 -`password` \$1 -`type` | Fonte di dati Spring standard con sottochiavi | | Contiene le informazioni di connessione per il database Jics. In alternativa, l'uso dei AWS segreti è fortemente incoraggiato, come spiegato in. [Database JICS](ba-runtime-config-app-secrets.md#jics-database) | | | `jildb.datasource` \$1 -`driver-class-name` \$1 -`url` \$1 -`username` \$1 -`password` | Fonte di dati Spring standard con sottochiavi | | Contiene le informazioni di connessione per il database Jics. | | | `jildb.backend` | stringa | | Speciifica il tipo di database utilizzato nel backend Jildb, ad esempio Oracle. | | | `jildb.record-hold-timeout` | int | 10000 | Speciifica il periodo di timeout di attesa, in millisecondi, per il meccanismo di conservazione dei record in Jildb. | | | `datasource.bluesamDs` \$1 -`driver-class-name` \$1 -`url` \$1 -`username` \$1 -`password` \$1 -`type` | Fonte di dati Spring standard con sottochiavi | | Contiene le informazioni di connessione per il database. Blusam In alternativa, l'uso dei AWS segreti è fortemente incoraggiato, come spiegato in[Database Blusam](ba-runtime-config-app-secrets.md#blusam-database). | | | `blu4iv.userspace.pageSize` | int | 4096 | Speciifica la dimensione della pagina utilizzata per allocare lo spazio di archiviazione per gli spazi utente. La dimensione dello spazio utente in un dato momento è sempre un multiplo di questo numero specificato. | 4.10.0 | | `blu4iv.userspace.store-type` | stringa | memory | Speciifica il tipo di archivio utilizzato per il registro dello spazio utente. I valori supportati sono memory e redis. Se non viene fornito alcun tipo di archivio, per impostazione predefinita viene utilizzata la memoria. | 4.10.0 | | `blu4iv.userspace.redis.*` | Proprietà Redis supportate | | Specifica le proprietà di configurazione per gli spazi utente redis store, vedi. [Proprietà della cache Redis disponibili in AWS Transform for mainframe Runtime](ba-runtime-redis-configuration.md) | 4.10.0 | | `blu4iv.userspace.batchThreshold` | int | 1 | Speciifica il numero di operazioni di aggiornamento o impostazione su uno spazio utente dopo le quali lo spazio utente viene mantenuto in un archivio di dati esterno. | 5.75.0 | | `blu4iv.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. | | | `bluesam.disabled` | booleano | false | Se disabilitarlo Blusam completamente. | | | `bluesam.cache` | stringa | | Se non è impostata, la Blusam cache non verrà utilizzata. I valori possibili (implementazioni della cache) sono ehcache e redis (). [Proprietà della cache Redis](ba-runtime-redis-configuration.md#ba-runtime-redis-caches-properties) | | | `bluesam.openWarmUp` | booleano | false | Speciifica se memorizzare nella cache eventuali set di dati bluesam durante l'apertura. **Avviso: Breaking Change nella versione 5.1.0** **- Il valore predefinito è cambiato da `true` a. `false`** | 5.1.0 | | `bluesam.fileList` | stringa [] | | Speciifica l'elenco dei set di dati bluesam da memorizzare nella cache durante l'apertura. **Nota:****- Questo parametro è efficace solo quando è impostato su. `bluesam.openWarmUp` `false`** | 5.1.0 | | `bluesam.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.bluesamStatusPollingInterval` | numero | 1000 | Speciifica il tempo (in millisecondi) di attesa tra ogni iterazione durante il polling di bluesam status per verificare le attività online. | 4.5.0 | | `bluesam.maxBluesamStatusPollingRetry` | numero | 3 | Speciifica il numero massimo di tentativi quando il polling di bluesam status ha esito negativo. | 4.5.0 | | `bluesam.checkBluesamStatus` | booleano | false | Speciifica se controllare o meno lo stato del set di dati bluesam prima di accedervi. | 4.5.0 | | `bluesam.prefetchWindowSize` | int | 1000 | Specifica il numero di record da prerecuperare e memorizzare nella cache per l'ottimizzazione della cache Redis. Questa proprietà è efficace solo quando si utilizza la cache Redis. | | | `bluesam.prefetchWindowMultiples` | int | 5 | Specificate 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. | | | `spring.aws.client.bluesam.redis.secret` | stringa | null | Specifica l'ARN segreto delle credenziali per la cache Bluesam Redis, vedere. [AWS I segreti di Transform for mainframe Runtime](ba-runtime-config-app-secrets.md) | | | `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](ba-runtime-config-app-secrets.md) | | | `forcedDate` | stringa | | Impone la data alla data fornita, se presente. | | | `clcommand.rtvmbrd.hasHeader` | stringa | true | Specificate se i file contengono intestazioni che non devono essere incluse nel conteggio delle righe. | | | `frozenDate` | booleano | true | Specifica se congelare la data. Si applica solo se `forcedDate` è impostata anche. | | | `externalSort.threshold` | dimensione dei dati (esempio: 12 MB) | | La soglia di ordinamento: determina quando il sistema deve passare dall'ordinamento in memoria a quello di unione esterna utilizzando file temporanei sul file system. Se non viene specificata (default=`null`), la soglia viene impostata sulla metà della memoria disponibile per ogni nuova operazione di ordinamento. Per stimare la memoria disponibile, viene eseguita una chiamata a System.gc (). | | | `blockSizeDefault` | numero | 32760 | La dimensione del blocco predefinita da utilizzare per i byte BDW. | | | `jics.parameters.datform` | stringa | MMDDYY | Il modulo della data. | | | `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,PEZ1`Valore di esempio:. Questo verrà trasferito a cascata ai gruppi contenuti in tali elenchi e alle relative definizioni di risorse sottostanti, che saranno quindi visibili al runtime. Vuoto per impostazione predefinita. | | | `jics.parameters.applid` | stringa | VELOCITÀ | Applicato per identificare l'applicazione in JICS (almeno 4 caratteri, nessuna lunghezza massima). | | | `jics.parameters.sysid` | stringa | CICS | L'identificazione del sistema (SYSID). | | | `jics.parameters.eibtrmid` | stringa | TERMINE | L'identificatore del terminale (massimo 4 caratteri, minimo 1). | | | `jics.parameters.userid` | stringa | | L'id utente (massimo 8 caratteri, nessun minimo). Quando non viene fornito alcun valore (vuoto per impostazione predefinita), l'ID di sessione HTTP viene utilizzato come ID utente. | | | `jics.parameters.username` | stringa | IL MIO NOME UTENTE | Il nome utente (massimo 10 caratteri, minimo 1). | | | `jics.parameters.netname` | stringa | IL MIO NOME DI RETE | Il nome della rete (massimo 8 caratteri, minimo 1). | | | `jics.parameters.opid` | stringa | XXX | L'identificazione dell'operatore a 3 caratteri. | | | `jics.parameters.jobname` | stringa | NOME DEL LAVORO | Il nome del lavoro. | | | `jics.parameters.sysname` | stringa | SYSNAME | Il nome AS400 del sistema (sysname). | | | `jics.parameters.cwa.length` | numero | 0 | La lunghezza dell'area di lavoro comune (CWA). | | | `jics.parameters.charset` | stringa | CP037 | Set di caratteri JICS utilizzato a livello globale. | | | `jics.parameters.tsqimpl` | stringa | bluesam | Implementazione JICS Temporary Storage Queue (TSQ) (i valori consentiti sono//) `bluesam` `memory` `redis` | | | `jics.queues.ts.redis.*` | Proprietà Redis supportate | | Specifica le proprietà di configurazione per il server Redis JICS TS Queues, vedi. [Proprietà Redis supportate](ba-runtime-redis-configuration.md#ba-runtime-redis-supported-properties) | | | `spring.aws.client.jics.queues.ts.redis.secret` | stringa | null | Specificare l'ARN segreto delle credenziali per il server Redis JICS TS Queues, vedere. [AWS I segreti di Transform for mainframe Runtime](ba-runtime-config-app-secrets.md) | | | `lockTimeout` | numero | 500 | Il timeout di blocco, in millisecondi. | | | `sqlCodePointShift` | numero | | Opzionale. Lo spostamento dei punti del codice sql. Sposta il codepoint per i caratteri di controllo che potremmo incontrare durante la migrazione dei dati RDBMS legacy a un RDBMS moderno. Ad esempio, puoi specificare che corrisponda al carattere Unicode. `384` `\u0180` | | | `sqlIntegerOverflowAllowed` | booleano | false | Speciifica se consentire l'overflow di numeri interi SQL, ovvero se è consentito inserire valori più grandi nella variabile host. | | | `database.cursor.overflow.allowed` | booleano | true | Specifica se consentire l'overflow del cursore. Imposta per `true` eseguire una chiamata successiva sul cursore indipendentemente dalla sua posizione. Imposta `false` per verificare se il cursore si trova nell'ultima posizione prima di eseguire una chiamata successiva sul cursore. Abilita solo se il cursore è SCORREVOLE (SENSITIVE o INSENSITIVE). | | | `reportOutputPath` | stringa | `/reports` | Il percorso di output del report. | | | `server.servlet.session.tracking-modes` | stringa | biscotto | Specifica le modalità di tracciamento della sessione da utilizzare. I valori possibili sono `url``cookie`,`ssl`. È possibile specificare più valori separati da virgole. Nota: quando si esegue la distribuzione su Tomcat, è necessario impostarlo `cookies=false` in context.xml perché Tomcat ha la precedenza per la configurazione della modalità di tracciamento. | | | `server.servlet.session.timeout` | stringa | 30 m | Speciifica la durata del timeout della sessione. Esempi: `60s` (60 secondi), `4m` (4 minuti), `4h` (4 ore). | | | `spring.session.store-type` | stringa | nessuno | La cache della sessione per ambienti ad alta disponibilità. I valori possibili sono `none` o`redis`. L'impostazione predefinita è`none`. | | | `stopExecutionWhenProgNotFound` | booleano | true | Speciifica se interrompere l'esecuzione se non viene trovato un programma. Se impostato su`true`, interrompe l'esecuzione se non viene trovato un programma. | | | `forceHR` | booleano | false | Speciifica se utilizzare Human Readable SYSPRINT, sulla console o sull'output del file. | | | `rollbackOnRTE` | booleano | false | Specifica se eseguire il rollback della transazione implicita dell'unità di esecuzione sulle eccezioni di runtime. | | | `sctThreadLimit` | Long | 5 | Il limite dei thread per l'attivazione degli script. | | | `dataSimplifier.onInvalidNumericData` | stringa | rifiutare | Come reagire quando si decodificano dati numerici non validi. I valori consentiti sono`reject`///`toleratespaces`. `toleratespaceslowvalues` `toleratemost` L'impostazione predefinita è`reject`. | | | `dataSimplifier.numproc` | stringa | PDF | specificazione del compilatore numproc. I valori consentiti sono//`PFD`/. `NOPFD` `MIG` Il valore predefinito è `PFD`. | | | `dataSimplifier.doubleFloatingType` | stringa | IEEE\$1754 | Il tipo a doppia virgola mobile è il formato usato per codificare e decodificare un numero a virgola mobile. I valori consentiti sono`IEEE_754`/`HFP`(per il formato esadecimale a virgola mobile). Il valore predefinito è `IEEE_754`. | 4.7.0 | | `filesDirectory` | stringa | | La directory per i file batch. input/output | | | `ims.messages.extendedSize` | booleano | false | Speciifica se impostare la dimensione estesa dei messaggi IMS. | | | `defaultKeepExistingFiles` | booleano | false | Speciifica se impostare il valore precedente predefinito del set di dati. | | | `jics.db.ddlScriptLocation` | stringa | | La posizione dello script DDL di Jics. Consente di avviare lo schema del database Jics utilizzando uno script.sql. Vuoto per impostazione predefinita. Ad esempio,`./jics/sql/jics.sql`. | | | `jics.db.schemaTestQueryLocation` | stringa | | Posizione del file sql che dovrebbe contenere una query univoca che restituisce il numero di oggetti nello schema jics (se presente). | | | `jics.db.dataScriptLocation` | stringa | | Definisce il percorso degli script SQL utilizzati per inizializzare il database JICS. Accetta un elenco separato da virgole di file e directory, che consente di specificare più script e cartelle. | | | `jics.db.dataTestQueryLocation` | stringa | | Posizione di uno script sql contenente una singola query sql che dovrebbe restituire un numero di oggetti (ad esempio: conteggio del numero di record nella tabella del programma jics). Se il conteggio è uguale a 0, il database verrà caricato utilizzando `jics.db.dataScriptLocation` lo script, altrimenti il caricamento del database verrà saltato. | | | `jics.data.dataJsonInitLocation` | stringa | | | | | `jics.xa.agent.timeout` | numero | | | | | `query.useConcatCondition` | booleano | false | Speciifica se la condizione della chiave è creata o meno mediante la concatenazione di chiavi. | | | `system.qdecfmt` | stringa | | | | | `disposition.checkexistence` | booleano | false | Speciifica se rilasciare un controllo sull'esistenza dei file per Dataset with DISP SHR o OLD. | | | `useControlMVariable` | booleano | false | Specifica se utilizzare la specifica Control-M per la sostituzione delle variabili. | | | `card.encoding` | stringa | CP1145 | Codifica delle carte: da utilizzare con. `useControlMVariable` | | | `mapTransfo.prefixes` | stringa | &,@,%% | Elenco di prefissi da utilizzare per la trasformazione delle variabili ControlM. Ciascuno separato da una virgola. | | | `checkinputfilesize` | booleano | false | Specifica se rilasciare un segno di spunta se la dimensione del file è un multiplo della dimensione del record. | | | `stepFailWhenAbend` | booleano | true | Specifica se alzare un abend se un passaggio ha esito negativo o completa l'esecuzione. | | | `returnHttp5xxResponseForFailedSyncJob` | 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 | | `bluesam.fileLoading.commitInterval` | numero | 100000 | L'intervallo di commit di bluesam. | | | `uppercaseUserInput` | booleano | true | Speciifica se l'input dell'utente deve essere in maiuscolo. | | | `jhdb.lterm` | stringa | | Consentono di forzare un ID di terminale logico comune nel caso di un'emulazione IMS. Se non è impostato, viene utilizzato SessionID. | | | `jhdb.identificationCardData` | stringa | | Utilizzato per codificare alcuni «dati della carta di identificazione dell'operatore» nel campo MID indicato dal parametro CARD. Vuoto per impostazione predefinita, nessuna restrizione di input. | | | `encoding` | stringa | ASCII | La codifica utilizzata nei progetti (non nei file groovy). Prevede una codifica `CP1047` valida,,,... `IBM930` `ASCII` `UTF-8` | | | `cl.configuration.context.encoding` | stringa | CP297 | La codifica dei file CL. Prevede una codifica valida`CP1047`,,`IBM930`... `ASCII` `UTF-8` Il valore predefinito è `CP297` | | | `cl.zonedMode` | stringa | EBCDIC\$1STRICT | La modalità per la codifica o la decodifica dei comandi del linguaggio di controllo (CL). I valori consentiti sono`EBCDIC_STRICT`//`EBCDIC_MODIFIED`. `AS400` | | | `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;` | | | `jhdb.configuration.context.encoding` | stringa | CP297 | La codifica JHDB (Java Hierarchical Database). Prevede una stringa di codifica valida,,,... `CP1047` `IBM930` `ASCII` `UTF-8` | | | `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.checkpointPersistence` | stringa | nessuno | La modalità di persistenza del checkpoint. I valori consentiti sono`none`//`add`. `end` Si usa `add` per mantenere i checkpoint quando ne viene creato uno nuovo e aggiunto al registro. Usa per `end` persistere il checkpoint alla chiusura del server. Qualsiasi altro valore disabilita la persistenza. Tieni presente che ogni volta che viene aggiunto un nuovo checkpoint al registro, tutti i checkpoint esistenti verranno serializzati e il file verrà cancellato. Non è un'aggiunta ai dati esistenti nel file. Quindi, a seconda del numero di checkpoint, può avere alcuni effetti sulle prestazioni. | | | `jhdb.checkpointPath` | stringa | file:. /configurazione/ | In caso contrario`jhdb.checkpointPersistence`, questo parametro consente di impostare il percorso di persistenza del checkpoint (posizione di archiviazione del file checkpoint.dat), tutti i dati dei checkpoint contenuti nel registro vengono serializzati e sottoposti a backup in un file (checkpoint.dat) situato nella cartella fornita. `none` Nota che solo i dati del checkpoint (scriptID, StepID, posizione del database e area del checkpoint) sono interessati da questo backup. | | | `jhdb.navigation.cachenexts` | numero | 5000 | La durata della cache (in millisecondi) utilizzata nella navigazione gerarchica per un RDBMS. | | | `jhdb.use-db-prefix` | booleano | true | Speciifica se abilitare un prefisso di database nella navigazione gerarchica per un RDBMS. | | | `jhdb.query.limitJoinUsage` | booleano | true | Speciifica se utilizzare il parametro limit join usage sui grafici RDBMS. | | | `taskExecutor.corePoolSize` | numero | 5 | Quando una transazione in un terminale viene avviata tramite uno script groovy, viene creato un nuovo thread. Utilizzate questo parametro per configurare la dimensione del pool principale. | | | `taskExecutor.maxPoolSize` | numero | 10 | Quando una transazione in un terminale viene avviata tramite uno script groovy, viene creato un nuovo thread. Utilizzate questo parametro per impostare la dimensione massima del pool (numero massimo di thread paralleli). | | | `taskExecutor.queueCapacity` | numero | 50 | Quando una transazione in un terminale viene avviata tramite uno script groovy, viene creato un nuovo thread. Utilizzate questo parametro per impostare la dimensione della coda. (= numero massimo di transazioni in sospeso quando viene raggiunto) `taskExecutor.maxPoolSize` | | | `taskExecutor.allowCoreThreadTimeOut` | 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). | | | `jics.runUnitLauncherPool.enable` | booleano | false | Specifica se attivare il run unit launcher pool in JICS. | | | `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 la dimensione del pool. | | | `jics.runUnitLauncherPool.parallelism` | numero | 2 | Il numero di thread utilizzati per produrre le istanze mancanti nella coda durante l'esecuzione dell'attività di regolazione. | | | `context.preconstruct.enable` | booleano | false | Speciifica se attivare la precostruzione del contesto del programma. | | | `context.preconstruct.frequencyInMillis` | numero | 100 | L'intervallo tra ogni esecuzione dell'attività che regola le dimensioni del pool. | | | `context.preconstruct.parallelism` | numero | 5 | Il numero di thread utilizzati per produrre le istanze mancanti nella coda durante l'esecuzione dell'attività di regolazione. | | | `context.preconstruct.minInstances` | numero | 2 | Il numero di istanze che verranno create la prima volta che è necessario un contesto. | | | `spring.aws.application.credentials` | stringa | null | Carica le AWS credenziali dal file dei profili delle credenziali in JICS. | | | `jics.queues.sqs.region` | stringa | eu-west-1 | La AWS regione per Amazon Simple Queue Service, utilizzata in JICS. | | | `jics.jcl.rt.encoding` | stringa | CP037 | La codifica degli script JCL scritti nella coda JICS dedicata. | | | `jics.jcl.rt.queue` | stringa | JICS | Il nome della coda in cui è possibile scrivere gli script JCL riga per riga in fase di esecuzione. | | | `mq.queues.sqs.region` | stringa | eu-west-3 | La AWS regione per il servizio AWS SQS MQ. | | | `quartz.scheduler.stand-by-if-error` | booleano | false | Speciifica se attivare l'esecuzione del lavoro se lo scheduler del lavoro è in modalità standby. Se vero, quando è abilitata l'esecuzione del lavoro non viene attivata. | | | `databaseStatistics` | booleano | false | Speciifica se consentire ai costruttori di SQL di raccogliere e visualizzare informazioni statistiche. | | | `dbDateFormat` | stringa | yyyy-MM-dd | Il formato della data di destinazione del db. | | | `dbTimeFormat` | stringa | HH: mm: ss | Il formato dell'ora di destinazione del db. | | | `dbTimestampFormat` | stringa | yyyy-MM-dd HH: mm: ss.ssssss | Il formato del timestamp di destinazione del db. | | | `dateTimeFormat` | stringa | ISO | dateTimeFormat Descrive come trasferire il tipo di data, ora e ora del database in entità semplificatrici di dati. I valori consentiti sono///`ISO``EUR``EUR``USA``LOCAL` | | | `localDateFormat` | stringa | | Elenco di formati di data locali. Separa ogni formato con. `\` | | | `localTimeFormat` | stringa | | Elenco dei formati dell'ora locale. Separa ogni formato con `\` | | | `localTimestampFormat` | stringa | | Elenco dei formati di timestamp locali. Separa ogni formato con. `\` | | | `pgmDateFormat` | stringa | yyyy-MM-dd | Il formato della data e dell'ora. | | | `pgmTimeFormat` | stringa | HH.mm.ss | Il formato dell'ora usato per l'esecuzione di pgm (programmi). | | | `pgmTimestampFormat` | stringa | yyyy-MM-GD-hh.mm.ss.ssssss | Il formato del timestamp. | | | `cacheMetadata` | booleano | true | Specifica se memorizzare nella cache i metadati del database. | | | `forceDisableSQLTrimStringType` | booleano | false | Speciifica se disabilitare il taglio di tutti i parametri della stringa sql. | | | `fetchSize` | numero | | Il valore fetchSize per i cursori. Da utilizzare quando si recuperano dati utilizzando blocchi tramite utilità load/unload. | | | `check-groovy-file` | booleano | true | Specifica se controllare il contenuto dei file Groovy prima della registrazione. | | | `qtemp.uuid.length` | numero | 9 | La lunghezza dell'ID univoco di QTEMP. | | | `qtemp.dblog` | booleano | false | Se abilitare la registrazione del database QTEMP. | | | `qtemp.cleanup.threshold.hours` | numero | 0 | Per specificare quando è abilitato`qtemp.dblog`. La durata della partizione db (in ore). | | | `invalidDataTolerence` | booleano | true | Speciifica se i dati non validi sono tollerati per il tipo compresso. | | | `program.timeout` | numero | -1 | Specifica un timeout per qualsiasi esecuzione in secondi. program/transaction Trascorso questo tempo, il sistema proverà a interrompere il programma. | | | `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. | | | `enableActivePgmIdCache` | booleano | false | Speciifica se abilitare la cache locale dell'ID del programma attivo. Utilizzate con attenzione questa funzionalità perché le risorse JICS possono essere condivise tra programmi e utenti. Tali risorse possono essere modificate esternamente da qualsiasi amministratore e la cache locale installata potrebbe essere invalidata. | | | `mq.queues.default.syncpoint` | booleano | false | Speciifica il comportamento predefinito per i comandi MQ PUT quando non sono impostati né MQPMO\$1SYNCPOINT né MQPMO\$1NO\$1SYNCPOINT. Quando è impostato su true, agisce come se i messaggi NON venissero salvati direttamente durante il comando PUT. `MQPMO_SYNCPOINT` Quando è impostato su false, agisce come se `MQPMO_NO_SYNCPOINT` i messaggi venissero salvati direttamente durante il comando PUT. | | | `dataSimplifier.byteRangeBoundsCheck` | booleano | false | Se impostato su true, assicura che non ByteRange venga creato nessun valore con valori errati. Il valore predefinito è false. | | | `file.stdoutIntoLogger` | booleano | false | Speciifica se abilitare la scrittura su logger anziché sul flusso di output di sistema predefinito in default `SYSPRINT` and files. `SYSPUNCH` | | | `tempFilesDirectory` | stringa | null | Speciifica il nome della posizione della cartella dei file temporanei generati. | | | `cleanTempFilesDirectoryAtStartup` | booleano | true | Speciifica se eliminare il contenuto della cartella dei file temporanei all'avvio dell'applicazione. | | | `tempFolderPattern` | stringa | null | Speciifica uno schema che verrà utilizzato per creare dinamicamente il nome della cartella temporanea in base alle seguenti informazioni predefinite e personalizzabili. HOST: il nome dell'host. JOBID: l'ID del lavoro. HASHCODE: il codice hash del contesto lavorativo. TIMESTAMP: lo schema da utilizzare per ottenere il timestamp. Il nome di destinazione della cartella temporanea è TMP\$1DIR\$1 \$1\$1. 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 `tempFolderPattern` viene aggiunta al file YAML o è vuota, il nome della cartella temporanea sarà «TMP\$1DIR\$1» \$1 this.hashCode () (DefaultJobContext). | | | `database.cursor.raise.already.opened.error` | booleano | false | Speciifica se abilitare la generazione dell'errore SQLCODE 502 quando si apre un cursore già aperto. | | | `jics.spool.smtp.hostname` | stringa | null | Speciifica l'host del server SMTP. Ad esempio: `smtp.xxx.com` | | | `jics.spool.smtp.port` | stringa | null | Speciifica la porta del server SMTP. Esempio: 25 | | | `jics.spool.smtp.password` | stringa | null | Speciifica la password di accesso del server SMTP. | | | `jics.spool.smtp.username` | stringa | null | Speciifica il nome utente del server SMTP. | | | `jics.spool.smtp.debug` | booleano | false | Speciifica la modalità di debug per il server SMTP. | | | `gapwalk-application.security` | stringa | `disabled` | Attiva la configurazione di sicurezza globale (autenticazione XSS, CORS, CSRF, OAUTH...). I valori consentiti sono `disabled` e `enabled`. | | | `gapwalk-application.security.identity` | stringa | null | Metodo di autenticazione globale. Il valore consigliato è`oauth`. I valori consentiti sono `json` e `oauth`. Questa opzione è obbligatoria quando `gapwalk-application.security` è`enabled`. | | | `gapwalk-application.security.issuerUri` | stringa | null | L'URI dell'emittente del provider di identità (IdP). Questa opzione è obbligatoria quando `gapwalk-application.identity` è. `oauth` | | | `gapwalk-application.security.allowedOrigins` | stringa [] | `null` | L'elenco delle origini da consentire. Questa opzione deve `gapwalk-application.identity` essere impostata su`oauth`. | | | `gdgDirectoryPath` | stringa | `output/gdg` | Il percorso della directory GDG è la directory in cui sono archiviati i file gdg. | 4.6.0 | | `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 | | `listOfMDCUrlParams` | stringa | `null` | L'elenco dei parametri URL da aggiungere all'MDC durante l'esecuzione dello script batch Groovy. | | | `gapwalk-application.security.claimGroupName` | stringa | `cognito:groups` | L'attributo claim che contiene l'elenco di tutti i gruppi a cui appartiene un utente. `cognito:groups`Utilizzalo per Amazon Cognito o qualsiasi altra stringa per un IdP esterno. | | | `gapwalk-application.security.userAttributeName` | stringa | `username` | Il nome dell'attributo claim utilizzato per identificare una richiesta dell'utente. Utilizzalo `username` per Amazon Cognito, `preferred_username` per Keycloak o qualsiasi altra stringa per un IdP esterno. | | | `gapwalk-application.defaultSuperAdminUserName` | stringa | `sadmin` | Quando `gapwalk-application.security` è disabilitato, specifica il nome utente privilegiato locale predefinito. | | | `gapwalk-application.defaultSuperAdminUserPwd` | stringa | `sadmin` | Quando `gapwalk-application.security` è disabilitato, specifica la password di super utente locale predefinita. | | | `gapwalk-application.security.filterURIs` | stringa | `disabled` | Attiva la configurazione del filtro. URIs I valori consentiti sono `disabled` e `enabled`. | | | `gapwalk-application.security.blockedURIs` | stringa [] | null | L'elenco di URIs da bloccare. Questa opzione è obbligatoria quando `gapwalk-application.security.filterURIs` è`enabled`. | | | `jics.redis.*` | Proprietà Redis supportate | | Specifica le proprietà di configurazione per il Connection Factory del server JICS Redis, vedere. [Proprietà Redis supportate](ba-runtime-redis-configuration.md#ba-runtime-redis-supported-properties) | | | `spring.aws.client.jics.redis.secret` | stringa | null | Specifica l'ARN segreto delle credenziali per la fabbrica di connessioni al server JICS Redis, vedere. [AWS I segreti di Transform for mainframe Runtime](ba-runtime-config-app-secrets.md) | | | `jcl.checkpoint.enabled` | booleano | false | Speciifica se il meccanismo di checkpoint JCL è abilitato per consentire il riavvio del lavoro. I checkpoint JCL vengono creati e salvati nel registro in memoria all'inizio di ogni passaggio o chiamata principale del programma. Tutti i checkpoint a livello di fase vengono mantenuti alla fine del processo, se è definito il provider di persistenza. | | | `jcl.checkpoint.expireTimeout` | numero | -1 | Speciifica la durata del periodo di conservazione dei checkpoint JCL nel provider di persistenza o nel registro in memoria. | | | `jcl.checkpoint.expireTimeoutUnit` | stringa | SECONDI | Speciifica l'unità di durata temporale per la `jcl.checkpoint.expireTimeout` proprietà. Valori costanti enum supportati: java.util.concurrent. TimeUnit. | | | `jcl.checkpoint.provider` | stringa | null | Specifica il provider di persistenza del meccanismo di checkpoint JCL. I valori consentiti sono. `redis` | | | `jcl.checkpoint.redis.*` | Proprietà Redis supportate | | Specifica le proprietà di configurazione per il provider di persistenza REDIS del meccanismo di checkpoint JCL, vedi. [Proprietà Redis supportate](ba-runtime-redis-configuration.md#ba-runtime-redis-supported-properties) | | | `jcl.nullJclEof` | booleano | true | Speciifica come vengono gestite le istruzioni JCL nulle (//) durante l'esecuzione del lavoro. Se impostato su true,//termina immediatamente il processo (modalità EOF). Se false,//viene considerata un'istruzione nulla e l'esecuzione continua (modalità IGNORE). | | | `job.default.encoding` | stringa | CP1047 | Specifica 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 | | `spring.aws.client.jcl.checkpoint.redis.secret` | stringa | null | Speciifica l'ARN segreto delle credenziali per il provider di persistenza Redis del meccanismo di checkpoint JCL, vedi. [AWS I segreti di Transform for mainframe Runtime](ba-runtime-config-app-secrets.md) | | | `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.trustStore` | stringa | null | Imposta il valore sulla proprietà di sistema `javax.net.ssl.trustStore` se non è già impostato all'avvio dell'applicazione. | | | `gapwalk.ssl.trustStorePassword` | stringa | null | Impostate il valore sulla proprietà di sistema `javax.net.ssl.trustStorePassword` se non è già configurata all'avvio dell'applicazione. In alternativa, l'uso dei AWS segreti è fortemente incoraggiato, come spiegato in[Gestore segreto per le impostazioni delle password SSL](ba-runtime-config-app-secrets.md#ba-runtime-ssl-secrets-properties). | | | `gapwalk.ssl.trustStoreType` | stringa | null | Imposta il valore sulla proprietà di sistema `javax.net.ssl.trustStoreType` se non è già configurata all'avvio dell'applicazione. | | | `gapwalk.ssl.keyStore` | stringa | null | Imposta il valore sulla proprietà di sistema `javax.net.ssl.keyStore` se non è già configurata all'avvio dell'applicazione. | | | `gapwalk.ssl.keyStorePassword` | stringa | null | Imposta il valore sulla proprietà di sistema `javax.net.ssl.keyStorePassword` se non è già configurata all'avvio dell'applicazione. In alternativa, l'uso dei AWS segreti è fortemente incoraggiato, come spiegato in[Gestore segreto per le impostazioni delle password SSL](ba-runtime-config-app-secrets.md#ba-runtime-ssl-secrets-properties). | | | `mq.queues` | stringa | `sqs` | Speciifica quale queue brocker supportato da utilizzare tra Amazon `sqs` SQS, Rabbit MQ locale o `rabbitmq` IBMMQ locale. `jms` | | | `mq.queues.jmsMQQueueManagers[N]` | | | In caso `mq.queues` `jms` affermativo, consente di specificare un elenco di connessioni IBM MQ. `mq.queues.jmsMQQueueManagers[0]`per la prima connessione, `mq.queues.jmsMQQueueManagers[1]` per la seconda e così via. | | | `mq.queues.jmsMQQueueManagers[N].jmsMQQueueManager` | stringa | null | Il nome del gestore di code IBMMQ. | | | `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].jmsMQPort` | numero | null | La porta IBMMQ. | | | `mq.queues.jmsMQQueueManagers[N].jmsMQUserid` | stringa | null | Il nome utente IBMMQ. | | | `mq.queues.jmsMQQueueManagers[N].jmsMQPassword` | stringa | null | La password utente IBMMQ. In alternativa, l'uso dei AWS segreti è fortemente consigliato, come spiegato in. [Gestore segreto per le impostazioni delle password di IBM MQ](ba-runtime-config-app-secrets.md#ba-runtime-IBMMQ-secrets-properties) | | | `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].jmsMQSSLCipher` | stringa | null | La suite di crittografia SSL IBMMQ. Un esempio potrebbe essere. `"*TLS12ORHIGHER"` Per maggiori dettagli, consulta la documentazione ufficiale [TLS CipherSpecs e CipherSuites nelle classi IBM MQ per JMS](https://www.ibm.com/docs/en/ibm-mq/9.2?topic=jms-tls-cipherspecs-ciphersuites-in-mq-classes). | | | `mq.queues.non.jms.client` | booleano | false | Indica se il client di destinazione a cui inviare messaggi non è JMS. Il formato MQ nativo verrà utilizzato per client non JMS mentre il RFH2 formato verrà utilizzato per JMS. | 4.5.0 | | `mq.connection.pool.share` | booleano | false | Indica se condividere o ricreare il pool di connessioni JMS con lo stesso Queue Manager. | 4.9.0 | | `mq.queues.rabbitMQHost` | stringa | null | Il nome host di Rabbit MQ. | | | `mq.queues.rabbitMQVirtualHost` | stringa | null | L'hostname virtuale Rabbit MQ. | | | `mq.queues.rabbitMQPort` | numero | null | La porta Rabbit MQ. | | | `mq.queues.rabbitMQUsername` | stringa | null | L'utente Rabbit MQ. | | | `mq.queues.rabbitMQPassword` | stringa | null | La password di Rabbit MQ. | | | `mf.runtime.switch.N` | booleano | true | Abilita l'inserimento nullo per i file sequenziali di linea MF Nature. | 4.4.0 | | `mf.runtime.switch.T` | booleano | false | Consente l'inserimento di caratteri di tabulazione nei file sequenziali di linee MF Nature. | 4.4.0 | | `gapwalk.database.support.useSavePointToRestoreFail` | booleano | false | Consente il ripristino delle transazioni in caso di errore utilizzando i savepoint nelle query di inserimento. L'attivazione di questa proprietà può influire sulle prestazioni del database. È possibile sovrascrivere questa impostazione per query specifiche utilizzando la configurazione di query-to-database mappatura. | 4.6.0 | | `xmlGeneratorPrettyFormat` | booleano | true | Determina lo stile di formattazione dell'output XML generato all'interno della classe. XmlGenerator Se impostato su`true`, l'output XML viene formattato in una struttura rientrata leggibile dall'uomo (stampata in modo carino). Se impostato su`false`, l'output è in un formato compatto a riga singola senza spazi bianchi aggiuntivi. | 4.8.0 | | `gapwalk.database.metadata.schema-inclusion.enabled` | booleano | false | Abilita una funzionalità di ottimizzazione della memoria che controlla quali schemi di database vengono memorizzati nella cache da un'applicazione. Questa configurazione aiuta a ridurre l'ingombro della memoria mantenendo al contempo la stabilità del sistema gestendo in modo intelligente i metadati dello schema. Include automaticamente alcuni schemi di sistema di database comuni che potrebbero essere necessari per il corretto funzionamento. | 4.9.0 | | `gapwalk.database.metadata.schema-inclusion.schemas.global` | elenco | null | Definisce un elenco di schemi che devono essere memorizzati nella cache. | 4.9.0 | | `sqlConnectionAutoCommitEnabled` | booleano | true | Abilita il commit automatico della connessione corrente durante le operazioni di ripristino della connessione. Se abilitato, esegue automaticamente il commit della connessione corrente prima di passare a una nuova connessione all'origine dati in ambienti non XA per prevenire l'instabilità della connessione. Se disattivata, registra un messaggio di avviso sui potenziali problemi di connessione durante le operazioni di ripristino. | 4.10.0 | | `gapwalk.post.script.mediatype.json` | booleano | false | Speciifica se l'`Content-Type`intestazione della risposta da endpoint `/post/script/{scriptId:.+}` è impostata su`application/json`, a seconda del valore di una variabile booleana. Se impostato su false, l'impostazione predefinita è. `text/plain; charset=utf-8` | | | `startDefaultJob` | stringa | `false` | Specificare se inizializzare il processo predefinito alla prima transazione. | | | `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. | | | `mq.queues.jms.connectionfactory.*` | 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 | Description | Versione di rilascio | | --- | --- | --- | --- | --- | | `logging.config` | Path | classpath: logback-utility.xml | Chiave standard per il riferimento al file di configurazione logback. Sono disponibili anche altre chiavi di registrazione standard. | | | `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.datasource.primary.jndi-name` | stringa | jdbc/primario | Il nome JNDI (Java Naming And Directory Interface) per l'origine dati principale, se si utilizza JNDI. | | | `primary.datasource` -`driver-class-name` -`url` -`username` -`password` | 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](ba-runtime-config-app-secrets.md#client-database) | | | `encoding` | stringa | ASCII | La codifica utilizzata nei programmi di utilità. Prevede una codifica valida`CP1047`,,`IBM930`. `ASCII` `UTF-8` | | | `sysPunchEncoding` | stringa | ASCII | Il set di caratteri di codifica syspunch. Prevede una codifica valida,,. `CP1047` `IBM930` `ASCII` `UTF-8` | | | `systin.encoding` | stringa | ASCII | Il set di caratteri di codifica del set di dati del file SYSTIN. Prevede una codifica `CP1047` valida,,. `IBM930` `ASCII` `UTF-8` | 4.5.0 | | `zonedMode` | stringa | EBCDIC\$1STRICT | La modalità per codificare o decodificare i tipi di dati suddivisi in zone. I valori consentiti sono//`EBCDIC_STRICT`. `EBCDIC_MODIFIED` `AS400` | | | `idcams.encoding.forced` | stringa | | La codifica utilizzata nel programma di utilità IDCAMS. Prevede una codifica `CP1047` valida,,. `IBM930` `ASCII` `UTF-8` | 4.4.0 | | `unload.chunkSize` | numero | 0 | Dimensione del blocco utilizzata per l'utilità di scarico. | | | `unload.computeRecordSizeIfNull` | booleano | false | Determina se calcolare la dimensione del record se non specificata. Se specificato, il valore rimane invariato. | | | `unload.sqlCodePointShift` | numero | 0 | Il codice SQL pointshift per l'utilità unload. Esegue il processo di cambio dei caratteri. Richiesto quando il database di destinazione DB2 è Postgresql. | | | `unload.columnFiller` | stringa | spazio | Il riempitivo di colonne dell'utilità unload. | | | `unload.varCharIsNull` | booleano | false | Usa questo parametro nel programma INFTILB, se impostato su `true` allora tutti i campi non annullabili con valori vuoti (spazio) restituiscono una stringa vuota. | | | `unload.useDatabaseConfiguration` | booleano | false | Speciifica se utilizzare la configurazione di data o ora da application-main.yml nell'utilità unload. | | | `unload.format.date` | stringa | MM/dd/yyyy | Se abilitato, `unload.useDatabaseConfiguration` il formato della data da utilizzare nell'utilità di scarico. | | | `unload.format.time` | stringa | H.mm.ss | Se `unload.useDatabaseConfiguration` abilitato, il formato dell'ora da utilizzare nell'utilità di scaricamento. | | | `unload.format.timestamp` | stringa | yyyy-MM-dd-HH.mm.ss.ssssss | Se abilitato, `unload.useDatabaseConfiguration` il formato del timestamp da utilizzare nell'utilità di scaricamento. | | | `unload.nbi.whenNull` | esadecimale | 6F | Il valore Null Byte Indicator (NBI) da aggiungere quando il valore del database è nullo. | | | `unload.nbi.whenNotNull` | esadecimale | 00 | Il valore Null Byte Indicator (NBI) da aggiungere quando il valore del database non è nullo. | | | `unload.nbi.writeNullIndicator` | booleano | false | Speciifica se scrivere l'indicatore null nel file di output di scaricamento. | | | `unload.bmc.useInto` | booleano | false | Speciifica se gestire la parola chiave di controllo INTO bmc per l'utilità unload. | | | `unload.fetchSize` | numero | 0 | Consente di regolare la dimensione del recupero quando si gestiscono i cursori nell'utilità unload. | | | `unload.noPad` | 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 | | `treatLargeNumberAsInteger` | booleano | false | Speciifica se trattare i numeri grandi come. `Integer` Per impostazione predefinita, vengono `BigDecimal` trattati come tali. | | | `load.batchSize` | numero | 0 | La dimensione del batch dell'utilità di caricamento. | | | `load.format.localDate` | stringa | gg.mm.aaaa\$1\$1 aaaa-MM-gg dd/MM/yyyy | Il formato di data locale dell'utilità di caricamento da utilizzare. | | | `load.format.localTime` | stringa | HH:mm:ss\$1 hh.mm.ss | Il formato dell'ora locale dell'utilità di caricamento da utilizzare. | | | `load.format.dbDate` | stringa | yyyy-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.sqlCodePointShift` | numero | 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. | | | `load.applyRollback` | booleano | false | Imposta questo parametro `true` per indicare che desideri che il servizio ripristini le modifiche alla tabella se riscontra un errore durante il caricamento dei dati nel database. | | | `forcedDate` | stringa | | Impone la data alla data fornita, se presente. | | | `frozenDate` | booleano | true | Specifica se congelare la data. Si applica solo se `forcedDate` è impostata anche. | | | `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. | | | `hasGraphic` | booleano | false | Se l'utilità INFUTILB deve gestire le colonne GRAPHIC. DB2 | | | `convertGraphicDataToFullWidth` | 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 | Description | | --- | --- | --- | --- | | `logging.config` | Path | classpath:logback-utility.xml | Chiave standard per il riferimento al file di configurazione logback. Sono disponibili anche altre chiavi di registrazione standard. | | `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.datasource.primary.jndi-name` | stringa | jdbc/primario | Il nome JNDI (Java Naming And Directory Interface) per l'origine dati principale, se si utilizza JNDI. | | `primary.datasource` \$1 -`driver-class-name` \$1 -`url` \$1 -`username` \$1 -`password` | 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](ba-runtime-config-app-secrets.md#client-database) | | `encoding` | stringa | ASCII | La codifica utilizzata nei programmi di utilità. Prevede una codifica valida`CP1047`,,`IBM930`... `ASCII` `UTF-8` | | `zonedMode` | stringa | EBCDIC\$1STRICT | La modalità per codificare o decodificare i tipi di dati suddivisi in zone. I valori consentiti sono//`EBCDIC_STRICT`. `EBCDIC_MODIFIED` `AS400` | | `commands-off` | stringa | | Elenco di comandi da disattivare, separati da virgole. I valori consentiti sono `PGM_BASIC` `RCVMSG``SNDRCVF`,`CHGVAR`,`QCLRDTAQ`,`RTVJOBA`,`ADDLFM`,`ADDPFM`,`RCVF`,`OVRDBF`,`DLTOVR`,`CPYF`,`SNDDTAQ`. Utile quando si desidera disabilitare o sovrascrivere un programma esistente. `PGM_BASIC`è un programma AWS Transform for mainframe Runtime specifico progettato per scopi di debug. | | `forcedDate` | stringa | | Forza l'inserimento della 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 | Description | | --- | --- | --- | --- | | `logging.config` | Path | classpath:logback-utility.xml | Chiave standard per il riferimento al file di configurazione logback. Sono disponibili anche altre chiavi di registrazione standard. | | `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. | | `jhdb.configuration.context.encoding` | stringa | | La codifica JHDB (Java Hierarchical Database). Prevede una stringa di codifica valida,,,... `CP1047` `IBM930` `ASCII` `UTF-8` | | `jhdb.checkpointPersistence` | stringa | nessuno | La modalità di persistenza del checkpoint. I valori consentiti sono`none`//`add`. `end` Si usa `add` per mantenere i checkpoint quando ne viene creato uno nuovo e aggiunto al registro. Usa per `end` persistere il checkpoint alla chiusura del server. Qualsiasi altro valore disabilita la persistenza. Tieni presente che ogni volta che viene aggiunto un nuovo checkpoint al registro, tutti i checkpoint esistenti verranno serializzati e il file verrà cancellato. Non è un'aggiunta ai dati esistenti nel file. Quindi, a seconda del numero di checkpoint, può avere alcuni effetti sulle prestazioni. | | `jhdb.keepParent` | booleano | false | Se mantenere \$1parent e \$1logicalparent durante l'inserimento di IMS. Se impostata su true, la chiamata ISRT IMS inserirà \$1parent e \$1logicalparent nelle colonne del database. | | `jhdb.query.timeout` | int | -1 | Specifica un timeout per l'esecuzione di qualsiasi transazione jhdb in secondi. Trascorso questo tempo, il sistema proverà a interrompere il programma. Non viene impostato alcun timeout se il valore è -1 (impostazione predefinita). | | `jhdb.backend` | stringa | | Tipo di backend Jhdb. Il valore previsto è `rdbms` | | `jhdb.transaction.scope.programs` | stringa | | elenco di programmi da dichiarare come transazione completa. Separare ogni programma con una virgola (`,`). Ad esempio:`PCP008,PCT008` | | `metadata.datasource` \$1 -`driver-class-name` \$1 -`url` \$1 -`username` \$1 -`password` \$1 -`type` | stringa | Fonte di dati Spring standard con sottochiavi | Contiene le informazioni sui metadati per il database jhdb, inclusi psbs, dbds, connections. In alternativa, l'uso dei segreti è fortemente incoraggiato. AWS | ## Proprietà disponibili per l'applicazione client L'applicazione modernizzata potrebbe richiedere configurazioni di proprietà specifiche per l'applicazione client Spring. Queste proprietà inizializzano i bean dalle classi incluse nei file JAR di runtime. Il `application-profile.yaml` file, in cui viene impostato il valore del profilo durante la generazione dell'applicazione, consente di configurare queste proprietà. La tabella seguente elenca i key/value parametri disponibili per la configurazione dell'applicazione web client che utilizza i bean delle classi incluse nel runtime Gapwalk | Chiave | Tipo | Valore predefinito | Description | Versione di rilascio | | --- | --- | --- | --- | --- | | `blu4iv.dtaara.library.disable` | booleano | false | Controlla l'utilizzo della libreria nel contesto delle operazioni dell'area dati. Se impostato su true, l'utilizzo della libreria è disabilitato per le operazioni sull'area dati, ma ciò non influisce sull'utilizzo di QTemp. Se impostato su false, la libreria viene considerata quando si eseguono operazioni CRUD per l'area dati. | 4.5.0 | | `blu4iv.dao.data.max` | numero | 10 | La dimensione della cache interna per le operazioni DAO di input. Questa cache esiste a livello di programma (istanza singola). | 4.9.0 | | `blu4iv.dao.sort.function` | stringa | | Il nome della funzione di ordinamento per il database blu4iv. | 4.9.0 | | `blu4iv.dao.support` | stringa | JPA | Speciifica l'implementazione di accesso ai dati da utilizzare (JPA o JDBC). | 4.9.0 | | `blu4iv.dao.cache.enabled` | booleano | false | Abilita la cache in memoria. | 4.8.0 | | `blu4iv.dao.cache.enabledHits` | booleano | false | Aggiungi il tracciamento del numero di richieste alla cache. | 4.8.0 | | `blu4iv.dao.cache.initMaxResults` | numero | 10000 | La dimensione della cache. | 4.8.0 | | `blu4iv.dao.cache.entries.fileIds` | stringa | | L'elenco delle tabelle del database da inserire nella cache. | 4.8.0 | | `blu4iv.dao.cache.entries.programIds` | stringa | | Gli identificatori del programma in cui deve essere attivata la cache per le tabelle specificate. La cache è disponibile per tutti i sottoprogrammi negli stack di esecuzione. | 4.8.0 | | `blu4iv.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 | ### Configura la cache in memoria 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 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 | Description | Versione di rilascio | | --- | --- | --- | --- | --- | | `api.logging.enabled` | booleano | false | Abilita la registrazione degli accessi alle API per le applicazioni BAC, JAC e Gapwalk. Se abilitato, registra tutte le richieste API con dettagli. | 5.0.0 | Se abilitato, l'utente può fornire la configurazione del file di logback per registrare i log di accesso all'API nella posizione prescelta utilizzando il nome del logger. `api.access` I log possono includere i seguenti campi MDC: | Campo MDC | Description | | --- | --- | | `api-date` | La data e l'ora in cui è stata effettuata la richiesta API | | `api-duration` | Quanto tempo è stato impiegato per elaborare la richiesta API (millisecondi) | | `api-host` | L'indirizzo di origine da cui proviene la richiesta API | | `api-context` | Dove è ospitata l'API | | `api-user` | Il nome utente o l'identificatore della persona che effettua la richiesta API | | `api-sessionid` | Un identificatore univoco per la sessione di accesso corrente dell'utente | | `api-scheme` | Il protocollo di trasferimento utilizzato, ad esempio, HTTP o HTTPS. | | `api-name` | A endpoint/URI cui è stato effettuato l'accesso | | `api-retcode` | Il codice di stato restituito dopo il completamento della richiesta API | | `api-secure` | Il metodo di sicurezza utilizzato per proteggere la chiamata API (ad esempio, Token OAuth2, Anonymous) | | `api-method` | 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: ``` logs/main/main-api-access.log true %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 ``` 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 ```