View a markdown version of this page

Habilitar propriedades para AWS Transformação para mainframe Runtime - AWS Mainframe Modernization

Após uma análise cuidadosa, tomamos a decisão de fechar o acesso de novos clientes à experiência autogerenciada de modernização de AWS mainframe, a partir de 30 de junho de 2026. Os clientes existentes podem continuar usando o serviço normalmente.AWS continua investindo em melhorias de segurança e disponibilidade para a experiência autogerenciada de modernização de AWS mainframe, mas não planejamos introduzir novos recursos. Para obter mais informações, consulte Alteração na disponibilidade AWS da modernização do mainframe.

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.

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.

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

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

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 está definido comofalse.

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 parafalse.

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 comoprefetchWindowSize × 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.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 embluesam.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álidaCP1047,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.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ãoIEEE_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ãoPFD/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.

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.

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 comoHYBRID, 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 <String>

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 comoapplication/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.

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.

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.

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 scriptjics.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ãobluesam /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.

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.

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.

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 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ãourl,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.

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.

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.

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.

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.

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 comotrue, 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 comotrue, a saída XML é formatada em uma estrutura recuada e legível por humanos (bem impressa). Quando definida comofalse, 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álidaCP1047,, IBM930ASCII,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 comoHYBRID, 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álidaCP1047,, IBM930ASCII,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

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álidaCP1047,, IBM930ASCII,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álidaCP1047,, IBM930ASCII,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 comotrue, 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 comoHYBRID, 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

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.

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:

<!-- File appender --> <appender name="ApiAccessFile" class="ch.qos.logback.core.FileAppender"> <file>logs/main/main-api-access.log</file> <immediateFlush>true</immediateFlush> <encoder> <pattern>%date %X{api-scheme} %X{api-host} %X{api-method} %X{api-name} - Return code: %X{api-retcode} - Start date: %X{api-date} - Duration: %X{api-duration} ms - User: %X{api-user} - SessionId: %X{api-sessionid} - SecureMethod: %X{api-secure} %n</pattern> </encoder> </appender> <logger name="api.access" level="info" additivity="false"> <appender-ref ref="ApiAccessFile" /> <appender-ref ref="CONSOLE" /> </logger>

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 entre 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:

<property name="DEFAULT_LOG_PATTERN" value="%date{yyyy-MM-dd HH:mm:ss} %-15.15contextName %-5.5level [%X{traceId:-},%X{spanId:-}] - %-40.40logger{15} - %msg%n" />

Exemplo de saída do log:

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