AWS A **experiência autogerenciada de modernização do mainframe** não está mais aberta a novos clientes. Para recursos semelhantes à experiência autogerenciada de modernização de AWS mainframe, explore os recursos das ofertas diretas do fornecedor e de. AWS Transform Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte Alteração na [disponibilidade AWS da modernização do mainframe](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
AWS O **Mainframe Modernization Service (experiência em Managed Runtime Environment)** não está mais aberto a novos clientes. Para recursos semelhantes ao AWS Mainframe Modernization Service (experiência em Managed Runtime Environment), explore o AWS Mainframe Modernization Service (Experience). Self-Managed Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte Alteração na [disponibilidade AWS da modernização do mainframe](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Habilitar propriedades para AWS Transformação para mainframe Runtime
Nas aplicações Spring Boot `application-main.yml`, há o arquivo de configuração no qual definimos diferentes tipos de propriedade, como porta de receptor, conectividade do banco de dados e muito mais. Você pode usar esta página para saber mais sobre as propriedades disponíveis do AWS Transform for mainframe Runtime e como habilitá-las.
**Topics**
+ [Notação YML](#ba-runtime-key-value-yml)
+ [Início rápido / Casos de uso](#ba-runtime-key-value-use-cases)
+ [Propriedades disponíveis para a aplicação principal](#ba-runtime-key-value-main)
+ [Propriedades disponíveis para aplicações web opcionais](#ba-runtime-key-value-web)
+ [Propriedades disponíveis para o aplicativo cliente](#ba-runtime-key-value-client)
+ [Configurar o registro de acesso à API](#ba-runtime-api-access-logging)
+ [Configurar o rastreamento distribuído](#ba-runtime-distributed-tracing)
## Notação YML
Na documentação a seguir, uma propriedade, como `parent.child1.child2=true`, é escrita da maneira a seguir no formato YAML.
```
parent:
child1:
child2: true
```
## Início rápido / Casos de uso
Os casos de uso a seguir mostram exemplos das chaves e valores aplicáveis.
+ application-main.yml padrão
```
----
#### 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
----
```
+ Use arquivos de comprimento variável com os comandos 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)
```
+ Forneça o valor do indicador de byte nulo no utilitário 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
```
## Propriedades disponíveis para a aplicação principal
Esta tabela fornece uma visão exaustiva dos key/values parâmetros.
**nota**
Se você estiver migrando para a versão 5.1.0 ou posterior e usando o bluesam com comportamento aberto padrão: WarmUp
O valor padrão de `bluesam.openWarmUp` foi alterado de `true` para `false`
Para manter o comportamento existente, você deve definir explicitamente `bluesam.openWarmUp=true`
| Chave | Tipo | Valor padrão | Description | Versão de lançamento |
| --- | --- | --- | --- | --- |
| `blockSizeDefault` | número | 32760 | O tamanho de bloco padrão a ser usado para bytes BDW. | |
| `blu4iv.dataaccess.useOldDaoDesign` | booleano | false | Um sinalizador global que determina se o aplicativo deve usar a arquitetura DAO antiga ou a nova. Isso depende se os DAO foram gerados usando um design antigo ou novo. | |
| `blu4iv.userspace.batchThreshold` | int | 1 | Especifica o número de operações de atualização ou configuração em um espaço de usuário após as quais o espaço de usuário é persistido em um repositório de dados externo. | 5.75.0 |
| `blu4iv.userspace.pageSize` | int | 4096 | Especifica o tamanho da página que é usado para alocar armazenamento para espaços de usuário. O tamanho do espaço do usuário em um determinado momento é sempre um múltiplo desse número especificado. | 4.10.0 |
| `blu4iv.userspace.redis.*` | Propriedades aceitas do Redis | | Especifica as propriedades de configuração para o armazenamento redis dos espaços de usuário, consulte. [Propriedades de cache do Redis disponíveis no AWS Transform for mainframe Runtime](ba-runtime-redis-configuration.md) | 4.10.0 |
| `blu4iv.userspace.store-type` | string | memória | Especifica o tipo de armazenamento usado para o registro do espaço do usuário. Os valores suportados são memória e redis. Se nenhum tipo de armazenamento for fornecido, a memória será usada por padrão. | 4.10.0 |
| `bluesam.bluesamStatusPollingInterval` | número | 1000 | Especifica o tempo de espera (em milissegundos) entre cada iteração ao pesquisar o status do bluesam para verificar as atividades online. | 4.5.0 |
| `bluesam.cache` | string | | Se não estiver definido, o Blusam cache não será usado. Os valores possíveis (implementações de cache) são ehcache e redis (). [Propriedades do cache do Redis](ba-runtime-redis-configuration.md#ba-runtime-redis-caches-properties) | |
| `bluesam.checkBluesamStatus` | booleano | false | Especifica se você deve ou não verificar o status do conjunto de dados bluesam antes de acessá-lo. | 4.5.0 |
| `bluesam.datasetPrefetchWindowSize` | string[] | | Especifica as substituições do tamanho da janela de pré-busca por conjunto de dados. Cada formato de entrada:`"datasetName:size"`. Se um conjunto de dados não estiver listado, ele retornará ao `bluesam.prefetchWindowSize` valor global.
**Observação:**
- Não adicione espaços ao redor do separador de dois pontos.
- Os nomes dos conjuntos de dados que contêm `\|` são suportados (usa os últimos dois pontos como delimitador).
- Coloque as entradas entre aspas duplas ou garanta que não haja espaços na entrada.
- Exemplo: `"fileset1\|MYFILE:10000"` | |
| `bluesam.disabled` | booleano | false | Se deve ser Blusam totalmente desativado. | |
| `bluesam.fileList` | string[] | | Especifica a lista do conjunto de dados bluesam a ser armazenados em cache durante a abertura.
**Observação:**
**- Esse parâmetro só é efetivo quando `bluesam.openWarmUp` definido como`false`.** | 5.1.0 |
| `bluesam.fileLoading.commitInterval` | número | 100000 | O intervalo de confirmação do bluesam. | |
| `bluesam.maxBluesamDisablingThreadpoolSize` | número | 10 | Especifica o tamanho máximo do threadpool usado para desativar conjuntos de dados bluesam para processamento em lote. | 4.5.0 |
| `bluesam.maxBluesamStatusPollingRetry` | número | 3 | Especifica o número máximo de novas tentativas quando o status do bluesam na sondagem está falhando. | 4.5.0 |
| `bluesam.metadataWarmUpFileList` | string[] | | Especifica a lista de conjuntos de dados bluesam cujos metadados de índice serão pré-carregados em um cache permanente na memória na inicialização do aplicativo.
**Observação:**
- Os índices são carregados ApplicationReadyEvent e persistem durante todo o ciclo de vida do aplicativo.
- Eficaz apenas para grandes conjuntos de dados. | |
| `bluesam.openWarmUp` | booleano | false | Especifica se algum conjunto de dados bluesam deve ser armazenado em cache durante a abertura.
**Aviso: alteração significativa na versão 5.1.0**
**- O valor padrão foi alterado de `true` para`false`.** | 5.1.0 |
| `bluesam.prefetchWindowMultiples` | int | 5 | Especifica o multiplicador do tamanho da janela de pré-busca para determinar a capacidade máxima da janela de pré-busca. A capacidade máxima é calculada como`prefetchWindowSize × prefetchWindowMultiples`. Essa propriedade só é efetiva ao usar o cache Redis. | |
| `bluesam.prefetchWindowSize` | int | 1000 | Especifica o número de registros a serem pré-buscados e armazenados em cache na memória para otimização do cache do Redis. Essa propriedade só é efetiva ao usar o cache Redis. | |
| `bluesam.externalDdlManagement` | booleano | false | Quando ativado, o BlueSam não cria tabelas automaticamente e, em vez disso, adota tabelas gerenciadas externamente registrando apenas metadados. | |
| `bluesam.redis.batchClearSize` | int | 1000 | O tamanho do lote para operações de limpeza do cache do `bluesam.redis.enableBatchClear` Redis quando ativado. | |
| `bluesam.redis.deleteAllBatchSize` | int | 1500 | Tamanho do lote para operações do Redis DeleteAll para otimizar o desempenho ao trabalhar com grandes conjuntos de dados. | |
| `bluesam.redis.enableBatchClear` | booleano | false | Ative o processamento em lote para operações de limpeza de cache do Redis ao trabalhar com grandes conjuntos de dados. | |
| `bluesam.redis.readBatchSize` | int | 1500 | Tamanho do lote para operações de leitura do cache do Redis (leitura em massa do cache por IDs). | |
| `bluesam.sizesCleanUpThreshold` | int | 1000 | Número máximo de entradas retidas no mapa interno de rastreamento de deslocamento por conjunto de dados para grandes conjuntos de dados (LargeKSDS, LargeESDS) durante gravações simultâneas de vários segmentos. Quando o mapa excede esse limite, ele é reduzido para as 10 entradas mais recentes para evitar o esgotamento da pilha e, ao mesmo tempo, preservar entradas suficientes para evitar o acesso simultâneo ao encadeamento. NullPointerException Reduza esse valor se a pressão da pilha for observada durante cargas em massa de grandes volumes de conjuntos de dados. | |
| `bluesam.warmUpMetadataCacheLimit` | longo | 0 | Número máximo de entradas de índice permitidas no cache de aquecimento de metadados. Defina como 0 para ilimitado.
**Observação:**
- Esse é um limite global em todos os conjuntos de dados configurados em`bluesam.metadataWarmUpFileList`.
- Quando o limite é atingido, índices adicionais são ignorados com um registro de advertências. | |
| `cacheMetadata` | booliano | true | Especifica se os metadados do banco de dados devem ser armazenados em cache. | |
| `card.encoding` | string | CP1145 | Codificação do cartão: para ser usado com `useControlMVariable`. | |
| `check-groovy-file` | booliano | true | Especifica se o conteúdo dos arquivos groovy deve ser verificado antes do registro. | |
| `checkinputfilesize` | booleano | false | Especifica se um cheque deve ser liberado se o tamanho do arquivo for múltiplo do tamanho do registro. | |
| `cl.configuration.context.encoding` | string | CP297 | A codificação dos arquivos CL. Espera uma codificação válida`CP1047`,`IBM930`,`ASCII`,`UTF-8`... O valor padrão é`CP297` | |
| `cl.zonedMode` | string | EBCDIC\_STRICT | O modo para codificar ou decodificar comandos da linguagem de controle (CL). Os valores permitidos são: `EBCDIC_STRICT`, `EBCDIC_MODIFIED` e `AS400`. | |
| `clcommand.rtvmbrd.hasHeader` | string | true | Especifique se os arquivos contêm cabeçalhos que não devem ser incluídos ao contar as linhas. | |
| `cleanTempFilesDirectoryAtStartup` | booliano | true | Especifica se o conteúdo da pasta de arquivos temporários deve ser limpo na inicialização da aplicação. | |
| `context.preconstruct.enable` | booleano | false | Especifica se a pré-construção do contexto do programa deve ser ativada. | |
| `context.preconstruct.frequencyInMillis` | número | 100 | O intervalo entre cada execução da tarefa que ajusta o tamanho do grupo. | |
| `context.preconstruct.minInstances` | número | 2 | O número de instâncias que serão criadas na primeira vez em que um contexto for necessário. | |
| `context.preconstruct.parallelism` | número | 5 | O número de threads usados para produzir as instâncias ausentes na fila quando a tarefa de ajuste é realizada. | |
| `database.cursor.overflow.allowed` | booliano | true | Especifica se é permitido que o cursor transborde. Defina como `true` para realizar uma próxima chamada no cursor, seja qual for sua posição. Defina como `false` para verificar se o cursor está na última posição antes de realizar uma próxima chamada no cursor. Ative somente se o cursor for SCROLLABLE (SENSITIVE ou INSENSITIVE). | |
| `database.cursor.raise.already.opened.error` | booleano | false | Especifica se é necessário habilitar o aumento do erro SQLCODE 502 quando um cursor já aberto está sendo aberto. | |
| `databaseStatistics` | booleano | false | Especifica se devem permitir que os construtores de SQL coletem e exibam informações estatísticas. | |
| `dataSimplifier.byteRangeBoundsCheck` | booleano | false | Quando definido como verdadeiro, ele garante que não ByteRange seja criado com valores impróprios. O padrão é falso. | |
| `dataSimplifier.cacheDefaultValues` | booleano | false | Quando definido como verdadeiro, permite o armazenamento em cache por instância de padrões de bytes de valor padrão computados em,, e subclasses. `RecordEntity` `ElementaryRange` `RangeType` O padrão é falso. | |
| `dataSimplifier.doubleFloatingType` | string | IEEE\_754 | O tipo flutuante duplo é o formato usado para codificar e decodificar um número de ponto flutuante. Os valores permitidos são`IEEE_754`/`HFP`(para formato de ponto flutuante hexadecimal). O valor padrão é `IEEE_754`. | 4.7.0 |
| `dataSimplifier.numproc` | string | PDF | especificação do compilador numproc. Os valores permitidos são`PFD`/`NOPFD`/`MIG`/. O padrão é`PFD`. | |
| `dataSimplifier.onInvalidNumericData` | string | reject | Como reagir ao decodificar dados numéricos inválidos. Os valores permitidos são: `reject`, `toleratespaces`, `toleratespaceslowvalues` e `toleratemost`. O padrão é `reject`. | |
| `dataSimplifier.zeroInvalidBcdNibbles` | booliano | true | Quando definidos como verdadeiros, os bytes contendo nibbles BCD inválidos (dígitos hexadecimais `A` - `F` em posições de dígitos) são tratados como durante a decodificação decimal compactada. `00` O padrão é true. | |
| `datasource.bluesamDs` \+ -`driver-class-name` \+ -`url` \+ -`username` \+ -`password` \+ -`type` | Fonte de dados Spring padrão com subchaves | | Contém as informações de conexão do Blusam banco de dados. Como alternativa, é altamente recomendável o uso de segredos da AWS , conforme explicado em [Banco de dados da Blusam](ba-runtime-config-app-secrets.md#blusam-database). | |
| `datasource.jicsDs` \+ -`driver-class-name` \+ -`url` \+ -`username` \+ -`password` \+ -`type` | Fonte de dados Spring padrão com subchaves | | Contém as informações de conexão do banco de dados do Jics. Como alternativa, é altamente recomendável o uso de segredos da AWS , conforme explicado em [Banco de dados JICS](ba-runtime-config-app-secrets.md#jics-database). | |
| `dateTimeFormat` | string | ISO | A data TimeFormat descreve como inserir o tipo de data e hora do banco de dados em entidades simplificadoras de dados. Os valores permitidos são: `ISO`, `EUR`, `EUR`, `USA` e `LOCAL`. | |
| `dbDateFormat` | string | aaaa- MM-dd | O formato da data alvo do banco de dados. | |
| `dbTimeFormat` | string | HH:mm:ss | O formato de hora alvo do banco de dados. | |
| `dbTimestampFormat` | string | aaaa- MM-dd HH:mm:ss.SSSSSS | O formato de carimbo de data/hora de destino do banco de dados. | |
| `defaultKeepExistingFiles` | booleano | false | Especifica se o valor anterior padrão do conjunto de dados deve ser definido. | |
| `disposition.checkexistence` | booleano | false | Especifica se deve liberar uma verificação da existência do arquivo para o conjunto de dados com DISP SHR ou OLD. | |
| `enableActivePgmIdCache` | booleano | false | Especifica se o cache local do ID do programa ativo deve ser habilitado. Use esse recurso com cuidado porque os recursos do JICS podem ser compartilhados entre programas e usuários. Esses recursos podem ser alterados externamente por qualquer administrador e o cache local instalado pode ser invalidado. | |
| `encoding` | string | ASCII | A codificação usada em projetos (não em arquivos groovy). Espera uma codificação válida `CP1047`, `IBM930`, `ASCII`, `UTF-8`... | |
| `externalSort.threshold` | tamanho dos dados (por exemplo: 12 MB) | | O limite de classificação: determina quando o sistema deve mudar da classificação por mesclagem na memória para a externa usando arquivos temporários no sistema de arquivos. Se não for especificado (default=`null`), o limite será definido como metade da memória disponível em cada nova tarefa de classificação. Para estimar a memória disponível, uma chamada para System.gc () é executada. | |
| `fetchSize` | número | | O valor fetchSize para cursores. Use ao buscar dados usando fragmentos por utilitários. load/unload | |
| `file.stdoutIntoLogger` | booleano | false | Especifica se a gravação no registrador deve ser habilitada em vez do fluxo de saída padrão do sistema nos arquivos padrão `SYSPRINT` e `SYSPUNCH`. | |
| `filesDirectory` | string | | O diretório para input/output arquivos em lotes. | |
| `forcedDate` | string | | Força a data até a data fornecida, se houver uma. | |
| `forceDisableSQLTrimStringType` | booleano | false | Especifica se o corte de todos os parâmetros da string sql deve ser desativado. | |
| `forceHR` | booleano | false | Especifica se o SYSPRINT legível por humanos deve ser usado no console ou na saída do arquivo. | |
| `frozenDate` | booliano | true | Especifica se a data deve ser congelada. Aplica-se somente se `forcedDate` também estiver definido. | |
| `forcedDateMode` | string | | Especifica o modo de data forçada. Quando definida como`HYBRID`, a parte da data é a data forçada configurada, mas a parte da hora reflete a hora real do sistema. Aplica-se somente se também `forcedDate` estiver definido. | |
| `gapwalk-application.defaultSuperAdminUserName` | string | `sadmin` | Quando `gapwalk-application.security` está desabilitado, especifica o nome de superusuário local padrão. | |
| `gapwalk-application.defaultSuperAdminUserPwd` | string | `sadmin` | Quando `gapwalk-application.security` está desabilitado, especifica o nome de superusuário local padrão. | |
| `gapwalk-application.security` | string | `disabled` | Alterne a configuração de segurança global (autenticação XSS, CORS, CSRF, OAUTH...). Os valores permitidos são `disabled` e `enabled`. | |
| `gapwalk-application.security.allowedOrigins` | string[] | `null` | A lista de origens a serem permitidas. Essa opção exige que `gapwalk-application.identity` seja definida como `oauth`. | |
| `gapwalk-application.security.blockedURIs` | string[] | nulo | A lista de URIs a serem bloqueados. Essa opção é necessária quando `gapwalk-application.security.filterURIs` é `enabled`. | |
| `gapwalk-application.security.claimGroupName` | string | `cognito:groups` | O atributo de declaração que contém a lista de todos os grupos aos quais um usuário pertence. Use `cognito:groups` para o Amazon Cognito ou qualquer outra string para um IdP externo. | |
| `gapwalk-application.security.customAllowedHeaders` | string[] | nulo | A lista de cabeçalhos personalizados a serem permitidos. Essa opção exige que `gapwalk-application.identity` seja definida como `oauth`. | 4.8.0 |
| `gapwalk-application.security.filterURIs` | string | `disabled` | Alterne a configuração de URIs de filtragem. Os valores permitidos são `disabled` e `enabled`. | |
| `gapwalk-application.security.identity` | string | nulo | Método de autenticação global. O valor recomendado é `oauth`. Os valores permitidos são `json` e `oauth`. Essa opção é necessária quando `gapwalk-application.security` é `enabled`. | |
| `gapwalk-application.security.issuerUri` | string | nulo | O URI do emissor é o provedor de identidades (IdP). Essa opção é necessária quando `gapwalk-application.identity` é `oauth`. | |
| `gapwalk-application.security.userAttributeName` | string | `username` | O nome do atributo de declaração usado para identificar uma solicitação do usuário. Use `username` para Amazon Cognito, `preferred_username` para Keycloak ou qualquer outra string para um IdP externo. | |
| `gapwalk.cobol.cblqda.enabled` | booleano | false | Ativa um recurso CBLQDA que controla a alocação dinâmica dos arquivos QSAM durante uma instrução OPEN. Essa configuração ajuda a alocar dinamicamente os arquivos temporários declarados no programa, mesmo que os arquivos não estejam definidos no script JCL. | |
| `gapwalk.database.metadata.schema-inclusion.enabled` | booleano | false | Ativa um recurso de otimização de memória que controla quais esquemas de banco de dados são armazenados em cache por um aplicativo. Essa configuração ajuda a reduzir o consumo de memória enquanto mantém a estabilidade do sistema, gerenciando de forma inteligente os metadados do esquema. Ele inclui automaticamente alguns esquemas comuns do sistema de banco de dados que podem ser necessários para uma operação adequada. | 4.9.0 |
| `gapwalk.database.metadata.schema-inclusion.schemas.global` | lista | nulo | Define uma lista de esquemas que devem ser armazenados em cache. | 4.9.0 |
| `gapwalk.database.support.useSavePointToRestoreFail` | booleano | false | Permite a recuperação de transações em caso de falha usando pontos de salvamento nas consultas de inserção. A ativação dessa propriedade pode afetar o desempenho do banco de dados. Você pode substituir essa configuração para consultas específicas usando a configuração de mapeamento de consulta para banco de dados. | 4.6.0 |
| `gapwalk.io.sequential.readBufferSize` | integer | 8192 | Define o tamanho do buffer (em bytes) para a `BufferedInputStream` leitura de arquivos sequenciais. Aumentar esse valor reduz o número de operações de I/O leitura, o que pode melhorar o desempenho ao ler arquivos grandes do armazenamento conectado à rede, como o Amazon EFS. | |
| `gapwalk.line.separator` | string | nulo | Especifica o tipo de separador de linha no gapwalk. Os valores permitidos são WIN (CRLF)/UNIX (LF)/LINUX (LF). Outros valores são ignorados e a propriedade line.sepatator do sistema é usada. | |
| `gapwalk.post.script.mediatype.json` | booleano | false | Especifica se o `Content-Type` cabeçalho da resposta do endpoint `/post/script/{scriptId:.+}` está definido como`application/json`, dependendo do valor de uma variável booleana. Se definido como false, o padrão é`text/plain; charset=utf-8`. | |
| `gapwalk.ssl.enabled` | booleano | false | Indicado para definir as propriedades `gapwalk.ssl.*` a seguir para as propriedades atuais do sistema JVM, caso ainda não tenham sido definidas no início da aplicação. | |
| `gapwalk.ssl.keyStore` | string | nulo | Defina o valor como a propriedade do sistema `javax.net.ssl.keyStore` se ainda não tiver sido definido no início da aplicação. | |
| `gapwalk.ssl.keyStorePassword` | string | nulo | Defina o valor como a propriedade do sistema `javax.net.ssl.keyStorePassword` se ainda não tiver sido definido no início da aplicação. Como alternativa, o uso de AWS segredos é fortemente incentivado, conforme explicado em. [Gerenciador de segredos para configurações de senha SSL.](ba-runtime-config-app-secrets.md#ba-runtime-ssl-secrets-properties) | |
| `gapwalk.ssl.trustStore` | string | nulo | Defina o valor como a propriedade do sistema `javax.net.ssl.trustStore` se ainda não tiver sido definido no início da aplicação. | |
| `gapwalk.ssl.trustStorePassword` | string | nulo | Defina o valor como a propriedade do sistema `javax.net.ssl.trustStorePassword` se ainda não tiver sido definido no início da aplicação. Como alternativa, o uso de AWS segredos é fortemente incentivado, conforme explicado em. [Gerenciador de segredos para configurações de senha SSL.](ba-runtime-config-app-secrets.md#ba-runtime-ssl-secrets-properties) | |
| `gapwalk.ssl.trustStoreType` | string | nulo | Defina o valor como a propriedade do sistema `javax.net.ssl.trustStoreType` se ainda não tiver sido definido no início da aplicação. | |
| `gapwalk.zos.systemName` | string | nulo | Especifica o valor do nome do sistema para o CVT emulado (Tabela de vetores de comunicações). | 5.202.0 |
| `gapwalk.zos.sysplexName` | string | nulo | Especifica o valor do nome do sysplex para o CVT emulado (Tabela de vetores de comunicações). | 5.202.0 |
| `gdgDirectoryPath` | string | `output/gdg` | O caminho do diretório GDG é o diretório em que os arquivos gdg são armazenados. | 4.6.0 |
| `ims.messages.extendedSize` | booleano | false | Especifica se é necessário definir o tamanho estendido nas mensagens do IMS. | |
| `ims.programs` | string | | Lista de programas IMS a serem usados. Separe cada parâmetro com um ponto e vírgula (`;`) e cada transação com uma vírgula (`,`). Por exemplo:`PCP008,PCT008;PCP054,PCT054;PCP066,PCT066;PCP068,PCT068;` | |
| `invalidDataTolerence` | booliano | true | Especifica se dados inválidos são tolerados para o tipo empacotado. | |
| `jcl.checkpoint.enabled` | booleano | false | Especifica se o mecanismo de ponto de verificação JCL está habilitado para permitir a reinicialização do trabalho. Os pontos de verificação de JCL são criados e salvos no registro na memória no início de cada etapa ou invocação do programa principal. Todos os pontos de verificação em nível de etapa serão mantidos no final do trabalho, se o provedor de persistência for definido. | |
| `jcl.checkpoint.expireTimeout` | número | -1 | Especifica a duração do tempo para reter os pontos de verificação de JCL no provedor de persistência ou no registro na memória. | |
| `jcl.checkpoint.expireTimeoutUnit` | string | SECONDS | Especifica a unidade de duração de tempo para a propriedade `jcl.checkpoint.expireTimeout`. Valores constantes de enumeração suportados: java.util.concurrent. TimeUnit. | |
| `jcl.checkpoint.provider` | string | nulo | Especifica o provedor de persistência do mecanismo de ponto de verificação de JCL. Os valores permitidos são `redis`. | |
| `jcl.checkpoint.redis.*` | Propriedades aceitas do Redis | | Especifica as propriedades de configuração para o provedor de persistência REDIS do mecanismo de ponto de verificação de JCL. Consulte [Propriedades aceitas do Redis](ba-runtime-redis-configuration.md#ba-runtime-redis-supported-properties). | |
| `jcl.nullJclEof` | booliano | true | Especifica como as instruções JCL nulas (//) são tratadas durante a execução do trabalho. Quando verdadeiro,//encerra o trabalho imediatamente (modo EOF). Quando falso,//é tratado como uma instrução nula e a execução continua (modo IGNORE). | |
| `jhdb.checkpointPath` | string | file:./setup/ | Se `jhdb.checkpointPersistence` não for `none`, esse parâmetro permitirá que você configure o caminho de persistência do ponto de verificação (local de armazenamento do arquivo checkpoint.dat); todos os dados de pontos de verificação contidos no registro são serializados e armazenados em um arquivo (checkpoint.dat) localizado na pasta fornecida. Observe que somente os dados do ponto de verificação (scriptId, stepId, posição do banco de dados e área do ponto de verificação) são afetados por esse backup. | |
| `jhdb.checkpointPersistence` | string | nenhuma | O modo de persistência do ponto de verificação. Os valores permitidos são: `none`, `add` e `end`. Use `add` para manter os pontos de verificação quando um novo for criado e adicionado ao registro. Use `end` para manter o ponto de verificação no desligamento do servidor. Quaisquer outros valores desativam a persistência. Observe que sempre que um novo ponto de verificação for adicionado ao registro, todos os pontos de verificação existentes serão serializados e o arquivo será apagado. Não é um acréscimo aos dados existentes no arquivo. Portanto, dependendo do número de pontos de verificação, isso pode ter alguns efeitos no desempenho. | |
| `jhdb.configuration.context.encoding` | string | CP297 | A codificação JHDB (Java Hierarchical Database). Espera uma string de codificação válida `CP1047`, `IBM930`, `ASCII`, `UTF-8`... | |
| `jhdb.identificationCardData` | string | | Usado para codificar alguns “dados do cartão de identificação do operador” no campo MID designado pelo parâmetro CARD. Em branco por padrão, sem restrição de entrada. | |
| `jhdb.lterm` | string | | Permite que você force um ID de terminal lógico comum no caso de uma emulação de IMS. Se não for definido, o sessionId será usado. | |
| `jhdb.metadata.extrapath` | string | file:./setup/ | Um parâmetro de configuração que especifica uma pasta raiz extra específica do runtime para as pastas psbs e dbds. | |
| `jhdb.navigation.cachenexts` | número | 5000 | A duração do cache (em milissegundos) usada na navegação hierárquica para um RDBMS. | |
| `jhdb.query.limitJoinUsage` | booliano | true | Especifica se o parâmetro limite de uso de junção deve ser usado em gráficos RDBMS. | |
| `jhdb.use-db-prefix` | booliano | true | Especifica se um prefixo de banco de dados deve ser ativado na navegação hierárquica para um RDBMS. | |
| `jics.data.dataJsonInitLocation` | string | | | |
| `jics.db.dataScriptLocation` | string | | Define o caminho para os scripts SQL usados para inicializar o banco de dados JICS. Aceita uma lista de arquivos e diretórios separados por vírgulas, permitindo que vários scripts e pastas sejam especificados. | |
| `jics.db.dataTestQueryLocation` | string | | Localização de um script sql contendo uma única consulta sql que deve retornar uma contagem de objetos (por exemplo: contagem do número de registros na tabela do programa jics). Se a contagem for igual a 0, o banco de dados será carregado usando o script`jics.db.dataScriptLocation`, caso contrário, o carregamento do banco de dados será ignorado. | |
| `jics.db.ddlScriptLocation` | string | | A localização do script DDL Jics. Permite que você inicie o esquema do banco de dados Jics usando um script .sql. Em branco por padrão. Por exemplo, `./jics/sql/jics.sql`. | |
| `jics.db.schemaTestQueryLocation` | string | | Localização do arquivo sql que deve conter uma consulta exclusiva que retorna o número de objetos no esquema jics (se houver). | |
| `jics.initList` | string | | A lista inicialize JICS, separada por vírgulas. Se presente, ele define nomes de listas separados por vírgula a serem ativados na inicialização do Apache Tomcat entre as listas do CICS. Valor de exemplo: `$UUU,DFH$IVPL,PEZ1`. Isso será transmitido em cascata para os grupos contidos nessas listas e suas definições de recursos subjacentes, que serão então visíveis para o runtime. Vazio por padrão. | |
| `jics.jcl.rt.encoding` | string | CP037 | A codificação dos scripts JCL escritos na fila dedicada do JICS. | |
| `jics.jcl.rt.queue` | string | JICS | O nome da fila na qual os scripts JCL podem ser gravados linha por linha em tempo de execução. | |
| `jics.parameters.applid` | string | VELOCITY | Eles se aplicam para identificar a aplicação no JICS (pelo menos quatro caracteres, sem tamanho máximo). | |
| `jics.parameters.charset` | string | CP037 | O conjunto de caracteres usado globalmente pelo JICS. | |
| `jics.parameters.cwa.length` | número | 0 | A extensão da área de trabalho comum (CWA). | |
| `jics.parameters.datform` | string | MMDDAA | O formato de data. | |
| `jics.parameters.eibtrmid` | string | PRAZO | O identificador do terminal (máximo de 4 caracteres, mínimo 1). | |
| `jics.parameters.jobname` | string | MJOBNAME | O nome do trabalho. | |
| `jics.parameters.netname` | string | MYNETNAME | O nome da rede (máximo de oito caracteres, um, no mínimo). | |
| `jics.parameters.opid` | string | XXX | A identificação do operador de 3 caracteres. | |
| `jics.parameters.sysid` | string | CICS | A identificação do sistema (SYSID). | |
| `jics.parameters.sysname` | string | SYSNAME | O nome do sistema AS400 (sysname). | |
| `jics.parameters.tsqimpl` | string | bluesam | Implementação da fila de armazenamento temporário (TSQ) do JICS (os valores permitidos são`bluesam` /`memory` /`redis`) | |
| `jics.parameters.userid` | string | | O ID do usuário (máximo de 8 caracteres, sem mínimo). Quando nenhum valor é fornecido (em branco por padrão), o ID da sessão HTTP é usado como o ID do usuário. | |
| `jics.parameters.username` | string | MYUSERNAME | O nome de usuário (máximo de 10 caracteres, mínimo 1). | |
| `jics.queues.sqs.region` | string | eu-west-1 | A AWS região do Amazon Simple Queue Service, usada no JICS. | |
| `jics.queues.ts.redis.*` | Propriedades aceitas do Redis | | Especifica as propriedades de configuração do servidor Redis do JICS TS Queues; consulte [Propriedades aceitas do Redis](ba-runtime-redis-configuration.md#ba-runtime-redis-supported-properties). | |
| `jics.redis.*` | Propriedades aceitas do Redis | | Especifica as propriedades de configuração da fábrica de conexão do servidor Redis do JICS; consulte [Propriedades aceitas do Redis](ba-runtime-redis-configuration.md#ba-runtime-redis-supported-properties). | |
| `jics.runUnitLauncherPool.enable` | booleano | false | Especifica se o pool do lançador de unidades de execução deve ser ativado no JICS. | |
| `jics.runUnitLauncherPool.parallelism` | número | 2 | O número de threads usados para produzir as instâncias ausentes na fila quando a tarefa de ajuste é realizada. | |
| `jics.runUnitLauncherPool.size` | número | 20 | O tamanho do pool do lançador da unidade de execução no JICS. | |
| `jics.runUnitLauncherPool.validationInterval` | número | 1000 | O intervalo entre cada execução da tarefa que ajusta o tamanho do grupo. | |
| `jics.spool.smtp.debug` | booleano | false | Especifica o modo de depuração para o servidor SMTP. | |
| `jics.spool.smtp.hostname` | string | nulo | Especifica o host do servidor SMTP. Exemplo: `smtp.xxx.com` | |
| `jics.spool.smtp.password` | string | nulo | Especifica a senha de login do servidor SMTP. | |
| `jics.spool.smtp.port` | string | nulo | Especifica a porta do servidor SMTP. Exemplo: 25 | |
| `jics.spool.smtp.username` | string | nulo | Especifica o nome de usuário do servidor SMTP. | |
| `jics.xa.agent.timeout` | número | | | |
| `jildb.backend` | string | | Especifica o tipo de banco de dados usado no back-end do Jildb, por exemplo, Oracle. | |
| `jildb.datasource` \+ -`driver-class-name` \+ -`url` \+ -`username` \+ -`password` | Fonte de dados Spring padrão com subchaves | | Contém as informações de conexão do banco de dados do Jics. | |
| `jildb.record-hold-timeout` | int | 10000 | Especifica o período de espera, em milissegundos, para o mecanismo de retenção de registros no Jildb. | |
| `job.default.encoding` | string | CP1047 | Especifica a codificação padrão usada para inicializar o armazenamento no nível do trabalho. Por exemplo, os switches no aplicativo BLU4IV usam essa codificação para inicializar com zeros. | 4.9.0 |
| `listOfMDCUrlParams` | string | `null` | A lista de parâmetros de URL a serem adicionados ao MDC ao executar o script em lote do Groovy. | |
| `localDateFormat` | string | | Lista de formatos de data locais. Separe cada formato com `\`. | |
| `localTimeFormat` | string | | Lista de formatos de horário local. Separe cada formato com `\` | |
| `localTimestampFormat` | string | | Lista de formatos de carimbo de data/hora locais. Separe cada formato com `\`. | |
| `lockTimeout` | número | 500 | O tempo limite do bloqueio, em milissegundos. | |
| `logging.config` | Path | caminho de classe: logback-main.xml | Chave padrão para a referência ao arquivo de configuração de logback. Outras chaves de log padrão também estão disponíveis. | |
| `mapTransfo.prefixes` | string | &,@,%% | Lista de prefixos a serem usados ao transformar variáveis controlM. Cada um separado por vírgula. | |
| `mf.runtime.switch.N` | booliano | true | Permite a inserção nula para arquivos sequenciais de linhas naturais MF. | 4.4.0 |
| `mf.runtime.switch.T` | booleano | false | Permite a inserção de caracteres de tabulação em arquivos sequenciais de linhas naturais MF. | 4.4.0 |
| `mq.connection.pool.share` | booleano | false | Indique se deseja compartilhar ou recriar o pool de conexões JMS com o mesmo Gerenciador de Filas. | 4.9.0 |
| `mq.queues` | string | `sqs` | Especifica qual agente de filas compatível usar entre o `sqs` utilizando o Amazon SQS, o `rabbitmq` utilizando o Rabbit MQ ou `jms` usando o IBMMQ on-premises. | |
| `mq.queues.default.syncpoint` | booleano | false | Especifica o comportamento padrão dos comandos MQ PUT quando nem MQPMO\_SYNCPOINT nem MQPMO\_NO\_SYNCPOINT estão definidos. Quando definido como verdadeiro, age como `MQPMO_SYNCPOINT` e as mensagens NÃO são confirmadas diretamente durante o comando PUT. Quando definido como falso, age como `MQPMO_NO_SYNCPOINT` e as mensagens são confirmadas diretamente durante o comando PUT. | |
| `mq.queues.jms.connectionfactory.*` | Propriedades de fábrica de conexão Atomikos suportadas | | Especifica as propriedades de configuração para o pool de conexões do JMS MQ. | |
| `mq.queues.jmsMQQueueManagers[N]` | | | Quando `mq.queues` é `jms`, possibilita especificar uma lista de conexões do IBM MQ. `mq.queues.jmsMQQueueManagers[0]` para a primeira conexão, `mq.queues.jmsMQQueueManagers[1]` para a segunda e assim por diante. | |
| `mq.queues.jmsMQQueueManagers[N].jmsMQAppName` | string | nulo | O nome da aplicação IBMMQ. | |
| `mq.queues.jmsMQQueueManagers[N].jmsMQChannel` | string | nulo | O nome do canal IBMMQ. | |
| `mq.queues.jmsMQQueueManagers[N].jmsMQHost` | string | nulo | Nome do host do IBMMQ. | |
| `mq.queues.jmsMQQueueManagers[N].jmsMQMaxPoolSize` | número | 0 | O tamanho máximo do grupo do IBMMQ. Com 0, um número infinito de conexões físicas é habilitado. | |
| `mq.queues.jmsMQQueueManagers[N].jmsMQPassword` | string | nulo | A senha do usuário do IBMMQ. Como alternativa, o uso de AWS segredos é fortemente incentivado, conforme explicado em. [Gerenciador de segredos para configurações de senha do IBM MQ.](ba-runtime-config-app-secrets.md#ba-runtime-IBMMQ-secrets-properties) | |
| `mq.queues.jmsMQQueueManagers[N].jmsMQPort` | número | nulo | A porta do IBMMQ. | |
| `mq.queues.jmsMQQueueManagers[N].jmsMQQueueManager` | string | nulo | O nome do gerenciador de filas IBMMQ. | |
| `mq.queues.jmsMQQueueManagers[N].jmsMQSSLCipher` | string | nulo | O pacote de criptografia SSL do IBMMQ. Um exemplo pode ser `"*TLS12ORHIGHER"`. Consulte a documentação oficial [TLS CipherSpecs e CipherSuites nas classes IBM MQ para JMS para obter](https://www.ibm.com/docs/en/ibm-mq/9.2?topic=jms-tls-cipherspecs-ciphersuites-in-mq-classes) mais detalhes. | |
| `mq.queues.jmsMQQueueManagers[N].jmsMQUserid` | string | nulo | Nome do usuário do IBMMQ. | |
| `mq.queues.non.jms.client` | booleano | false | Indique se o cliente de destino para o qual enviar mensagens não é JMS. O formato MQ nativo será usado para clientes não JMS, enquanto o formato RFH2 será usado para JMS. | 4.5.0 |
| `mq.queues.rabbitMQHost` | string | nulo | O nome do host do Rabbit MQ. | |
| `mq.queues.rabbitMQPassword` | string | nulo | A senha do Rabbit MQ. | |
| `mq.queues.rabbitMQPort` | número | nulo | A porta do Rabbit MQ. | |
| `mq.queues.rabbitMQUsername` | string | nulo | O usuário do Rabbit MQ. | |
| `mq.queues.rabbitMQVirtualHost` | string | nulo | O nome do host virtual do Rabbit MQ. | |
| `mq.queues.sqs.region` | string | eu-west-3 | A AWS região do serviço AWS SQS MQ. | |
| `pgmDateFormat` | string | aaaa- MM-dd | O formato de data e hora. | |
| `pgmTimeFormat` | string | HH.mm.ss | O formato de hora usado para execução de pgm (programas). | |
| `pgmTimestampFormat` | string | aaaa- MM-dd-HH.mm.ss.SSSSSS | O formato do carimbo de data e hora. | |
| `program.timeout` | número | -1 | Especifica um tempo limite para qualquer program/transaction execução em segundos. Após esse período, o sistema tentará interromper o programa. | |
| `qtemp.cleanup.threshold.hours` | número | 0 | Para especificar quando `qtemp.dblog` está ativado. A vida útil da partição db (em horas). | |
| `qtemp.dblog` | booleano | false | Se deve habilitar o log do banco de dados QTEMP. | |
| `qtemp.uuid.length` | número | 9 | O comprimento de identificação exclusivo do QTEMP. | |
| `quartz.scheduler.stand-by-if-error` | booleano | false | Especifica se a execução do trabalho deve ser acionado se o agendador de trabalhos estiver no modo de espera. Se verdadeiro, quando ativada, a execução do trabalho não é acionada. | |
| `query.useConcatCondition` | booleano | false | Especifica se a condição da chave é criada por concatenação de chaves ou não. | |
| `reportOutputPath` | string | `/reports` | O caminho de saída do relatório. | |
| `returnHttp5xxResponseForFailedSyncJob` | booleano | false | Especifica se o código de resposta HTTP da série 500 deve ser retornado para a execução malsucedida do trabalho sincronizado. | 4.10.0 |
| `rollbackOnRTE` | booleano | false | Especifica se a transação de unidade de execução implícita deve ser revertida em exceções de runtime. | |
| `sctThreadLimit` | longo | 5 | O limite de threads para acionar scripts. | |
| `server.servlet.session.timeout` | string | 30 m | Especifica a duração do tempo limite da sessão. Exemplos: `60s` (60 segundos), `4m` (4 minutos), `4h` (4 horas). | |
| `server.servlet.session.tracking-modes` | string | cookie | Especifica os modos de rastreamento de sessão a serem usados. Os valores possíveis são`url`,`cookie`,`ssl`. Vários valores podem ser especificados separados por vírgulas. Nota: Ao implantar no Tomcat, você precisa configurar `cookies=false` em context.xml porque o Tomcat tem precedência na configuração do modo de rastreamento. | |
| `spring.aws.application.credentials` | string | nulo | Carregue as AWS credenciais do arquivo de perfis de credenciais no JICS. | |
| `spring.aws.client.bluesam.locks.redis.secret` | string | nulo | Especifica o ARN de segredo da credencial para o cache do Bluesam Redis, consulte [AWS Transforme os segredos do Runtime para mainframe](ba-runtime-config-app-secrets.md). | |
| `spring.aws.client.bluesam.redis.secret` | string | nulo | Especifica o ARN de segredo da credencial para o cache do Bluesam Redis, consulte [AWS Transforme os segredos do Runtime para mainframe](ba-runtime-config-app-secrets.md). | |
| `spring.aws.client.jcl.checkpoint.redis.secret` | string | nulo | Especifica o ARN de segredo da credencial para o provedor de persistência do Redis do mecanismo de ponto de verificação JCL. Consulte [AWS Transforme os segredos do Runtime para mainframe](ba-runtime-config-app-secrets.md). | |
| `spring.aws.client.jics.queues.ts.redis.secret` | string | nulo | Especifica o ARN do segredo da credencial para o servidor Redis do JICS TS Queues; consulte [AWS Transforme os segredos do Runtime para mainframe](ba-runtime-config-app-secrets.md). | |
| `spring.aws.client.jics.redis.secret` | string | nulo | Especifica o ARN de segredo da credencial para a fábrica de conexão do servidor Redis do JICS; consulte [AWS Transforme os segredos do Runtime para mainframe](ba-runtime-config-app-secrets.md). | |
| `spring.jta.enabled` | booleano | false | Chave Padrão. Se o modo de suporte da fonte de dados não for static-xa, a configuração automática das transações do Spring JTA deverá ser desativada. | |
| `spring.session.store-type` | string | nenhuma | O cache da sessão para ambientes de alta disponibilidade. Os valores possíveis são: `none` ou `redis`. O padrão é `none`. | |
| `sqlCodePointShift` | número | | Opcional. A mudança de ponto do código sql. Muda o ponto de código dos caracteres de controle que podemos encontrar ao migrar-se dados RDBMS legados para um RDBMS moderno. Por exemplo, é possível especificar `384` para corresponder ao caractere Unicode `\u0180`. | |
| `sqlConnectionAutoCommitEnabled` | booliano | true | Permite a confirmação automática da conexão atual durante as operações de redefinição da conexão. Quando ativado, confirma automaticamente a conexão atual antes de mudar para uma nova conexão de fonte de dados em ambientes não XA para evitar a instabilidade da conexão. Quando desativado, registra uma mensagem de aviso sobre possíveis problemas de conexão durante as operações de redefinição. | 4.10.0 |
| `sqlIntegerOverflowAllowed` | booleano | false | Especifica se é permitido o estouro de números inteiros SQL, ou seja, se é permitido colocar valores maiores na variável do host. | |
| `startDefaultJob` | string | `false` | Especifique se deseja inicializar o trabalho padrão na primeira transação. | |
| `stepFailWhenAbend` | booliano | true | Especifica se a suspensão deve ser levantada se uma etapa falhar ou concluir a execução. | |
| `stopExecutionWhenProgNotFound` | booliano | true | Especifica se a execução deve ser interrompida se um programa não for encontrado. Se definido como`true`, interrompe a execução se um programa não for encontrado. | |
| `system.date.format` | string | LAMA | O formato de data do sistema DATFMT. | --- |
| `system.date.separator` | string | / | O separador de data do sistema DATSEP.
Os valores possíveis são barra (`/`), traço (`—`), ponto (`.`), vírgula (`,`) ou branco (``). O valor precisa ser especificado entre aspas duplas `""`. | 5.17.0 |
| `system.qdecfmt` | string | | | |
| `taskExecutor.allowCoreThreadTimeOut` | booleano | false | Especifica se os threads principais devem atingir o tempo limite no JCIS. Isso permite o crescimento e a redução dinâmicos, mesmo em combinação com uma fila diferente de zero (já que o tamanho máximo do pool só aumentará quando a fila estiver cheia). | |
| `taskExecutor.corePoolSize` | número | 5 | Quando uma transação em um terminal é iniciada por meio de um script groovy, um thread é criado. Use esse parâmetro para configurar o tamanho do pool principal. | |
| `taskExecutor.maxPoolSize` | número | 10 | Quando uma transação em um terminal é iniciada por meio de um script groovy, um thread é criado. Use esse parâmetro para configurar o tamanho máximo do grupo (número máximo de threads paralelos). | |
| `taskExecutor.queueCapacity` | número | 50 | Quando uma transação em um terminal é iniciada por meio de um script groovy, um thread é criado. Use esse parâmetro para configurar o tamanho da fila. (= número máximo de transações pendentes quando `taskExecutor.maxPoolSize` atingido) | |
| `tempFilesDirectory` | string | nulo | Especifica o nome da localização da pasta dos arquivos temporários que são gerados. | |
| `tempFolderPattern` | string | nulo | Especifica um padrão que será usado para criar dinamicamente o nome da pasta temporária com base nas informações predefinidas e personalizáveis a seguir.
HOST: o nome do host.
JOBID: o ID do trabalho.
HASHCODE: o código hash do contexto do trabalho.
TIMESTAMP: o padrão a ser usado ao obter-se o carimbo de data/hora. O nome de destino da pasta temporária é TMP\_DIR\_ {temp}. FolderPattern Por exemplo, no caso do padrão a seguir, o nome começará com o ID do trabalho e terminará com o “timestamp”: tempFolderPattern: JOBID, host=XXXXX, HASHCODE, timestamp=YYYYMMDDHHMMSS. Se a propriedade não `tempFolderPattern` for adicionada ao arquivo YAML ou estiver vazia, o nome da pasta temporária será “TMP\_DIR\_” \+ this.hashCode () (). DefaultJobContext | |
| `uppercaseUserInput` | booliano | true | Especifica se a entrada do usuário deve estar em maiúsculas. | |
| `useControlMVariable` | booleano | false | Especifica se a especificação Control-m deve ser usada para substituição de variáveis. | |
| `xmlGeneratorPrettyFormat` | booliano | true | Determina o estilo de formatação da saída XML gerada dentro da XmlGenerator classe. Quando definida como`true`, a saída XML é formatada em uma estrutura recuada e legível por humanos (bem impressa). Quando definida como`false`, a saída está em um formato compacto de linha única sem espaço em branco adicional. | 4.8.0 |
## Propriedades disponíveis para aplicações web opcionais
Dependendo do seu aplicativo modernizado, talvez seja necessário configurar um ou mais aplicativos web opcionais que representem suporte para dependências como z/OS AS/400, ou. IMS/MFS As tabelas a seguir contêm listas dos key/value parâmetros disponíveis para configurar cada aplicativo web opcional.
### gapwalk-utility-pgm.war
Esse aplicativo web opcional contém suporte para programas Z/OS utilitários.
Esta tabela fornece uma visão exaustiva dos key/values parâmetros desse aplicativo.
| Chave | Tipo | Valor padrão | Description | Versão de lançamento |
| --- | --- | --- | --- | --- |
| `convertGraphicDataToFullWidth` | booliano | true | Especifica se os dados gráficos devem ser convertidos em formato de largura total. | |
| `encoding` | string | ASCII | A codificação usada em programas utilitários. Espera uma codificação válida`CP1047`,, `IBM930``ASCII`,`UTF-8`. | |
| `forcedDate` | string | | Força a data até a data fornecida, se houver uma. | |
| `frozenDate` | booliano | true | Especifica se a data deve ser congelada. Aplica-se somente se `forcedDate` também estiver definido. | |
| `forcedDateMode` | string | | Especifica o modo de data forçada. Quando definida como`HYBRID`, a parte da data é a data forçada configurada, mas a parte da hora reflete a hora real do sistema. Aplica-se somente se também `forcedDate` estiver definido. | |
| `hasGraphic` | booleano | false | Se o utilitário INFUTILB precisa lidar com colunas GRAPHIC DB2. | |
| `idcams.deleteFromAllSubfolders` | booleano | false | Se o comando IDCAMS DELETE também deve remover os arquivos correspondentes de cada subpasta do diretório de arquivos. | 5.15.0 |
| `idcams.encoding.forced` | string | | A codificação usada no programa utilitário IDCAMS. Espera uma codificação válida`CP1047`,, `IBM930``ASCII`,`UTF-8`. | 4.4.0 |
| `idcams.repro.failOnMissingOutput` | booleano | false | Se definido como verdadeiro, o IDCAMS REPRO falhará precocemente se um conjunto de dados Blusam de saída, com disposição SHR ou OLD, estiver ausente. | 5.185,0 |
| `jcl.type` | string | mvs | Tipo de arquivo.jcl. Os valores permitidos são: `jcl` e `vse`. Os PRINT/REPRO comandos do utilitário IDCAMS retornam 4 se o arquivo estiver vazio para um jcl que não seja vse. | |
| `load.applyRollback` | booleano | false | Defina esse parâmetro como `true` para indicar que você deseja que o serviço reverta as alterações da tabela caso encontre um erro ao carregar-se dados no banco de dados. | |
| `load.batchSize` | número | 0 | O tamanho do lote do utilitário de carga. | |
| `load.format.dbDate` | string | aaaa- MM-dd | O formato do banco de dados do utilitário de carga a ser usado. | |
| `load.format.dbTime` | string | HH:mm:ss | O tempo de uso do banco de dados do utilitário de carregamento. | |
| `load.format.localDate` | string | adicionar. MM.yyyy\\ dd/MM /aaaa\\ aaaa- MM-dd | O formato de data local do utilitário de carregamento a ser usado. | |
| `load.format.localTime` | string | HH:mm:ss\\HH.mm.ss | O formato de hora local do utilitário de carregamento a ser usado. | |
| `load.sqlCodePointShift` | número | 0s | A mudança de pontos do código SQL para o utilitário de carregamento. Executa o processo de mudança de caracteres. Obrigatório quando seu banco de dados de destino do DB2 é o Postgresql. | |
| `logging.config` | Path | classpath:logback-utility.xml | Chave padrão para a referência ao arquivo de configuração de logback. Outras chaves de log padrão também estão disponíveis. | |
| `primary.datasource` -`driver-class-name` -`url` -`username` -`password` | Fonte de dados Spring padrão com subchaves | | Contém as informações de conexão do banco de dados da aplicação, se não estiver usando o JNDI. Deve ter a mesma configuração que do arquivo YAML da aplicação modernizada.
Como alternativa, o uso de AWS segredos é fortemente incentivado, conforme explicado em. [Banco de dados de clientes](ba-runtime-config-app-secrets.md#client-database) | |
| `spring.datasource.primary.jndi-name` | string | jdbc/primary | O nome JNDI (Java Naming And Directory Interface) da fonte de dados primária, se estiver usando JNDI. | |
| `spring.jta.enabled` | booleano | false | Chave Padrão. Se o modo de suporte da fonte de dados não for static-xa, a configuração automática das transações do spring JTA deverá ser desabilitada. | |
| `sysPunchEncoding` | string | ASCII | O conjunto de caracteres de codificação syspunch. Espera uma codificação válida`CP1047`,, `IBM930``ASCII`,`UTF-8`. | |
| `systin.encoding` | string | ASCII | O conjunto de caracteres de codificação do conjunto de dados do arquivo SYSTIN. Espera uma codificação válida`CP1047`,, `IBM930``ASCII`,`UTF-8`. | 4.5.0 |
| `treatLargeNumberAsInteger` | booleano | false | Especifica se os números grandes devem ser tratados como `Integer`. Eles são tratados como `BigDecimal` padrão. | |
| `unload.bmc.useInto` | booleano | false | Especifica se a palavra-chave de controle INTO bmc deve ser processada para o utilitário de descarga. | |
| `unload.chunkSize` | número | 0 | Tamanho do pedaço usado para o utilitário de descarga. | |
| `unload.columnFiller` | string | espaço | O preenchedor de colunas do utilitário de descarga. | |
| `unload.computeRecordSizeIfNull` | booleano | false | Determina se o tamanho do registro deve ser calculado se não for especificado. Se especificado, o valor permanece inalterado. | |
| `unload.fetchSize` | número | 0 | Permite ajustar o tamanho da busca ao manipular cursores no utilitário de descarga. | |
| `unload.format.date` | string | MM/dd/yyyy | Se `unload.useDatabaseConfiguration` estiver ativado, o formato de data a ser usado no utilitário de descarga. | |
| `unload.format.time` | string | HH.mm.ss | Se `unload.useDatabaseConfiguration` estiver ativado, o formato de hora a ser usado no utilitário de descarga. | |
| `unload.format.timestamp` | string | aaaa- MM-dd-HH.mm.ss.SSSSSS | Se `unload.useDatabaseConfiguration` estiver ativado, o formato de carimbo de data/hora a ser usado no utilitário de descarga. | |
| `unload.nbi.whenNotNull` | hexadecimais | 00 | O valor do Indicador de Byte Nulo (NBI) a ser adicionado quando o valor do banco de dados não for nulo. | |
| `unload.nbi.whenNull` | hexadecimais | 6F | O valor do Indicador de Byte Nulo (NBI) a ser adicionado quando o valor do banco de dados for nulo. | |
| `unload.nbi.writeNullIndicator` | booleano | false | Especifica se o indicador nulo deve ser gravado no arquivo de saída de descarga. | |
| `unload.noPad` | booliano | true | Indica que os campos de caracteres de comprimento variável (VARCHAR) devem ser descarregados sem qualquer preenchimento até o tamanho máximo. | 4.5.0 |
| `unload.sqlCodePointShift` | número | 0 | O utilitário de mudança de pontos do código SQL para descarga. Executa o processo de mudança de caracteres. Obrigatório quando seu banco de dados de destino do DB2 é o Postgresql. | |
| `unload.useDatabaseConfiguration` | booleano | false | Especifica se a configuração de data ou hora do application-main.yml deve ser usada no utilitário de descarregamento. | |
| `unload.varCharIsNull` | booleano | false | Use esse parâmetro no programa INFTILB, se definido como`true`, todos os campos não anuláveis com valores em branco (espaço) retornarão uma string vazia. | |
| `zonedMode` | string | EBCDIC\_STRICT | O modo para codificar ou decodificar tipos de dados zoneados. Os valores permitidos são: `EBCDIC_STRICT`, `EBCDIC_MODIFIED` e `AS400`. | |
### gapwalk-cl-command.war
Esse aplicativo web opcional contém suporte para programas AS/400 utilitários.
Esta tabela fornece uma visão exaustiva dos key/values parâmetros desse aplicativo.
| Chave | Tipo | Valor padrão | Description |
| --- | --- | --- | --- |
| `commands-off` | string | | Lista de comandos a serem desativados, separados por vírgula. Os valores permitidos são: `PGM_BASIC`,`RCVMSG`,`SNDRCVF`,`CHGVAR`,`QCLRDTAQ`,`RTVJOBA`,`ADDLFM`,`ADDPFM`,`RCVF`,`OVRDBF`,`DLTOVR`,`CPYF` e `SNDDTAQ`. Útil quando você deseja desativar ou substituir um programa existente. `PGM_BASIC`é um programa AWS Transform for mainframe Runtime específico projetado para fins de depuração. |
| `encoding` | string | ASCII | A codificação usada em programas utilitários. Espera uma codificação válida `CP1047`, `IBM930`, `ASCII`, `UTF-8`... |
| `forcedDate` | string | | Força a data até a data fornecida, se houver uma. |
| `forcedDateMode` | string | | Especifica o modo de data forçada. Quando definida como`HYBRID`, a parte da data é a data forçada configurada, mas a parte da hora reflete a hora real do sistema. Aplica-se somente se também `forcedDate` estiver definido. |
| `logging.config` | Path | classpath:logback-utility.xml | Chave padrão para a referência ao arquivo de configuração de logback. Outras chaves de log padrão também estão disponíveis. |
| `primary.datasource` \+ -`driver-class-name` \+ -`url` \+ -`username` \+ -`password` | Fonte de dados Spring padrão com subchaves | | Contém as informações de conexão do banco de dados da aplicação, se não estiver usando o JNDI. Deve ter a mesma configuração que do arquivo YAML da aplicação modernizada.
Como alternativa, o uso de AWS segredos é fortemente incentivado, conforme explicado em. [Banco de dados de clientes](ba-runtime-config-app-secrets.md#client-database) |
| `spring.datasource.primary.jndi-name` | string | jdbc/primary | O nome JNDI (Java Naming And Directory Interface) da fonte de dados primária, se estiver usando JNDI. |
| `spring.jta.enabled` | booleano | false | Chave Padrão. Se o modo de suporte da fonte de dados não for static-xa, a configuração automática das transações do spring JTA deverá ser desabilitada. |
| `zonedMode` | string | EBCDIC\_STRICT | O modo para codificar ou decodificar tipos de dados zoneados. Os valores permitidos são: `EBCDIC_STRICT`, `EBCDIC_MODIFIED` e `AS400`. |
### gapwalk-hierarchical-support.war
Esse aplicativo web opcional contém suporte a IMS/MFS transações.
Esta tabela fornece uma visão exaustiva dos key/values parâmetros desse aplicativo.
| Chave | Tipo | Valor padrão | Description |
| --- | --- | --- | --- |
| `jhdb.backend` | string | | Tipo de back-end Jhdb. O valor esperado é `rdbms` |
| `jhdb.checkpointPersistence` | string | nenhuma | O modo de persistência do ponto de verificação. Os valores permitidos são: `none`, `add` e `end`. Use `add` para manter os pontos de verificação quando um novo for criado e adicionado ao registro. Use `end` para manter o ponto de verificação no desligamento do servidor. Quaisquer outros valores desativam a persistência. Observe que sempre que um novo ponto de verificação for adicionado ao registro, todos os pontos de verificação existentes serão serializados e o arquivo será apagado. Não é um acréscimo aos dados existentes no arquivo. Portanto, dependendo do número de pontos de verificação, isso pode ter alguns efeitos no desempenho. |
| `jhdb.configuration.context.encoding` | string | | A codificação JHDB (Java Hierarchical Database). Espera uma string de codificação válida `CP1047`, `IBM930`, `ASCII`, `UTF-8`... |
| `jhdb.keepParent` | booleano | false | Se deve manter \_parent e \_logicalparent durante a inserção do IMS. Quando definida como verdadeira, a chamada IMS ISRT inserirá \_parent e \_logicalparent nas colunas do banco de dados. |
| `jhdb.query.timeout` | int | -1 | Especifica um tempo limite para a execução de qualquer transação jhdb em segundos. Após esse período, o sistema tentará interromper o programa. Nenhum tempo limite é definido se o valor for -1 (padrão). |
| `jhdb.transaction.scope.programs` | string | | lista de programas a serem declarados como uma transação completa. Separe cada programa com uma vírgula (`,`). Por exemplo:`PCP008,PCT008` |
| `logging.config` | Path | classpath:logback-utility.xml | Chave padrão para a referência ao arquivo de configuração de logback. Outras chaves de log padrão também estão disponíveis. |
| `metadata.datasource` \+ -`driver-class-name` \+ -`url` \+ -`username` \+ -`password` \+ -`type` | string | Fonte de dados Spring padrão com subchaves | Contém as informações de metadados do banco de dados jhdb, incluindo psbs, dbds e conexões. Como alternativa, o uso de AWS segredos é fortemente encorajado. |
| `spring.jta.enabled` | booleano | false | Chave Padrão. Se o modo de suporte da fonte de dados não for static-xa, a configuração automática das transações do spring JTA deverá ser desabilitada. |
### gapwalk-gs21.war
Use esse aplicativo web opcional para executar programas da plataforma Fujitsu GS21 em seu ambiente de modernização do AWS Mainframe. Instale esse aplicativo somente se sua carga de trabalho modernizada incluir programas GS21.
A tabela a seguir descreve os parâmetros de valor-chave para esse aplicativo.
| Chave | Tipo | Valor padrão | Description |
| --- | --- | --- | --- |
| `datasource.gs21Ds` \+ -`driver-class-name` \+ -`url` \+ -`username` \+ -`password` \+ -`type` | Fonte de dados Spring padrão com subchaves | Nenhum | Armazena as informações de conexão do banco de dados GS21. Recomendamos usar o AWS Secrets Manager para credenciais de banco de dados. Para obter mais informações, consulte [Banco de dados de clientes](ba-runtime-config-app-secrets.md#client-database). |
| `aim.sockets.socketConfigurations` | listar | Nenhum | Configura as conexões de soquete do Application Integration Module (AIM). Cada entrada é uma configuração de servidor de soquete ou uma configuração de cliente de soquete.
Chaves de entrada do servidor de soquete: `remote` (nome da conexão), `smqn` (nome da fila de mensagens estruturadas (SMQN)), `port` (porta do soquete).
Chaves de entrada do cliente de soquete: `remote` (nome do servidor remoto), `targetName` (nome do servidor de destino), `smqn` (nome da fila SMQN), `port` (porta local), (porta de destino), `targetPort` (IP de destino). `targetHost` |
| `taskExecutor` \+ -`corePoolSize` \+ -`maxPoolSize` \+ -`queueCapacity` \+ -`allowCoreThreadTimeOut` | Configuração do executor do pool de threads do Spring | Nenhum | Configura o executor do pool de threads que gera processos AIM (como SMQNs, manipuladores de soquete e manipuladores de resposta de mensagens). |
## Propriedades disponíveis para o aplicativo cliente
Seu aplicativo modernizado pode exigir configurações de propriedades específicas para o aplicativo Spring do cliente. Essas propriedades inicializam beans a partir de classes empacotadas em arquivos JAR de tempo de execução. O `application-profile.yaml` arquivo, no qual o valor do perfil é definido durante a geração do aplicativo, permite que você configure essas propriedades. A tabela a seguir lista os key/value parâmetros disponíveis para configurar o aplicativo web cliente que usa beans de classes empacotadas no tempo de execução do Gapwalk.
| Chave | Tipo | Valor padrão | Description | Versão de lançamento |
| --- | --- | --- | --- | --- |
| `blu4iv.dao.cache.enabled` | booleano | false | Ative o In-memory cache. | 4.8.0 |
| `blu4iv.dao.cache.enabledHits` | booleano | false | Adicione o rastreamento do número de solicitações ao cache. | 4.8.0 |
| `blu4iv.dao.cache.entries.fileIds` | string | | A lista de tabelas do banco de dados a serem armazenadas em cache. | 4.8.0 |
| `blu4iv.dao.cache.entries.programIds` | string | | Os identificadores do programa em que o cache deve ser ativado para as tabelas especificadas. O cache está disponível para todos os subprogramas nas pilhas de execução. | 4.8.0 |
| `blu4iv.dao.cache.initMaxResults` | número | 10000 | O tamanho do cache. | 4.8.0 |
| `blu4iv.dao.data.max` | número | 10 | O tamanho do cache interno para operações DAO de entrada. Esse cache existe no nível do programa (instância única). | 4.9.0 |
| `blu4iv.dao.sort.function` | string | | O nome da função de classificação para o banco de dados blu4iv. | 4.9.0 |
| `blu4iv.dao.support` | string | JPA | Especifica a implementação de acesso a dados a ser usada (JPA ou JDBC). | 4.9.0 |
| `blu4iv.dtaara.library.disable` | booleano | false | Controla o uso da biblioteca no contexto das operações da área de dados. Se definido como verdadeiro, o uso da biblioteca é desativado para operações de área de dados, mas isso não afeta o uso do QTemp. Se definido como false, a biblioteca é considerada ao realizar operações CRUD para a área de dados. | 4.5.0 |
| `blu4iv.librarylist.enabled` | booleano | false | Habilite o uso da lista de bibliotecas para resolver uma biblioteca de arquivos. | 4.10.0 |
| `blu4iv.librarylist.libraries` | string | | A lista inicial de bibliotecas ordenadas da esquerda para a direita. | 4.10.0 |
### Configurar o In-Memory cache para aplicativos AS400
O recurso de cache na memória permite que os usuários armazenem dados somente para leitura na memória, melhorando significativamente o desempenho de programas com uso intenso de dados. O sistema de cache otimiza o desempenho de três maneiras: carregando dados somente no primeiro acesso, criando mapas de acesso a dados sob demanda e armazenando dados em cache de forma eficiente perto da memória do programa. Esse design minimiza a sobrecarga de memória e maximiza as melhorias de velocidade.
```
###################################################################
# 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"]
```
## Configurar o registro de acesso à API
O recurso de registro de acesso à API registra informações detalhadas sobre solicitações de API para aplicativos BAC, JAC e Gapwalk, ajudando a atender aos requisitos de segurança rastreando quem acessou o quê e quando.
| Chave | Tipo | Valor padrão | Description | Versão de lançamento |
| --- | --- | --- | --- | --- |
| `api.logging.enabled` | booleano | false | Permite o registro de acesso à API para aplicativos BAC, JAC e Gapwalk. Quando ativado, registra todas as solicitações de API com detalhes. | 5.0.0 |
Quando ativado, o usuário pode fornecer a configuração do arquivo de logback para registrar os registros de acesso à API no local escolhido usando o nome do registrador. `api.access` Os registros podem incluir os seguintes campos do MDC:
| Campo MDC | Description |
| --- | --- |
| `api-context` | Onde a API está hospedada |
| `api-date` | A data e a hora em que a solicitação da API foi feita |
| `api-duration` | Quanto tempo foi necessário para processar a solicitação da API (milissegundos) |
| `api-host` | O endereço de origem de onde veio a solicitação da API |
| `api-method` | O tipo de solicitação HTTP feita (por exemplo, GET, POST, DELETE,...) |
| `api-name` | O endpoint/URI que foi acessado |
| `api-retcode` | O código de status retornado após a conclusão da solicitação da API |
| `api-scheme` | O protocolo de transferência usado, por exemplo, HTTP ou HTTPS. |
| `api-secure` | O método de segurança usado para proteger a chamada da API (por exemplo, OAuth2, Token, Anonymous) |
| `api-sessionid` | Um identificador exclusivo para a sessão de login atual do usuário |
| `api-user` | O nome de usuário ou identificador da pessoa que está fazendo a solicitação da API |
Para configurar um arquivo de log dedicado para registros de acesso à API, adicione o seguinte à sua configuração de 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
```
Exemplo de saída do log:
```
2025-06-13 22:24:36,174 http 127.0.0.1 GET /bac/api/services/rest/bluesamservice/listDataSet - Return code: 200 - Start date: 06-13-2025 22:24:35.863+0200 - Duration: 308 ms - User: velocity_admin - SessionId:
1X1X1X1X1X1X1X1X1X1X1X1X1X1X1X1X- SecureMethod: Oauth2
```
## Configurar o rastreamento distribuído
O recurso de rastreamento distribuído permite o rastreamento de solicitações de ponta a ponta em todos os GapWalk aplicativos, propagando o TraceID e o SpanID a partir de solicitações HTTP, permitindo a correlação de registros em todo o ciclo de vida da solicitação.
| Chave | Tipo | Valor padrão | Description | Versão de lançamento |
| --- | --- | --- | --- | --- |
| `gapwalk.tracing.enabled` | booleano | false | Permite o rastreamento distribuído para GapWalk aplicativos. Quando ativado, propaga TraceID e SpanID para execução de trabalhos em lote. | |
Quando ativado, o recurso de rastreamento propaga o contexto de rastreamento. Os registros podem incluir os seguintes campos do MDC:
| Campo MDC | Description |
| --- | --- |
| ID da Espanha | Identificador exclusivo para a operação atual dentro do rastreamento |
| traceId | Identificador exclusivo para todo o fluxo de solicitações em todos os serviços e segmentos |
Para configurar o rastreamento distribuído, atualize sua configuração de logback para incluir traceID e spanID no padrão de log. Adicione ou atualize a seguinte propriedade:
```
```
Exemplo de saída do log:
```
2026-02-02 20:00:00 default INFO [6966b3c1dc96c2da73be7e2b6f9f25dc,73be7e2b6f9f25dc] - q.t.s.i.TestJobProcessImpl - Length is: 100
```