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 (experiência autogerenciada). 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á. # Ativar propriedades do AWS Transform for 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) ## 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 o comportamento padrão: openWarmUp 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 | | --- | --- | --- | --- | --- | | `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 | | `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. | | | `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. | | | `datasource.jicsDs` \$1 -`driver-class-name` \$1 -`url` \$1 -`username` \$1 -`password` \$1 -`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). | | | `jildb.datasource` \$1 -`driver-class-name` \$1 -`url` \$1 -`username` \$1 -`password` | Fonte de dados Spring padrão com subchaves | | Contém as informações de conexão do banco de dados do Jics. | | | `jildb.backend` | string | | Especifica o tipo de banco de dados usado no back-end do Jildb, por exemplo, Oracle. | | | `jildb.record-hold-timeout` | int | 10000 | Especifica o período de espera, em milissegundos, para o mecanismo de retenção de registros no Jildb. | | | `datasource.bluesamDs` \$1 -`driver-class-name` \$1 -`url` \$1 -`username` \$1 -`password` \$1 -`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). | | | `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.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 | | `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.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.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. | | | `bluesam.disabled` | booleano | false | Se deve ser Blusam totalmente desativado. | | | `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.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.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 como`false`.** | 5.1.0 | | `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.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.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.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.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.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. | | | `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.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). | | | `forcedDate` | string | | Força a data até a data fornecida, se houver uma. | | | `clcommand.rtvmbrd.hasHeader` | string | true | Especifique se os arquivos contêm cabeçalhos que não devem ser incluídos ao contar as linhas. | | | `frozenDate` | booliano | true | Especifica se a data deve ser congelada. Aplica-se somente se `forcedDate` também estiver definido. | | | `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. | | | `blockSizeDefault` | número | 32760 | O tamanho de bloco padrão a ser usado para bytes BDW. | | | `jics.parameters.datform` | string | MMDDAA | O formato de data. | | | `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.parameters.applid` | string | VELOCITY | Eles se aplicam para identificar a aplicação no JICS (pelo menos quatro caracteres, sem tamanho máximo). | | | `jics.parameters.sysid` | string | CICS | A identificação do sistema (SYSID). | | | `jics.parameters.eibtrmid` | string | PRAZO | O identificador do terminal (máximo de 4 caracteres, mínimo 1). | | | `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.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.jobname` | string | MJOBNAME | O nome do trabalho. | | | `jics.parameters.sysname` | string | SYSNAME | O nome AS400 do sistema (sysname). | | | `jics.parameters.cwa.length` | número | 0 | A extensão da área de trabalho comum (CWA). | | | `jics.parameters.charset` | string | CP037 | O conjunto de caracteres usado globalmente pelo JICS. | | | `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.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). | | | `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). | | | `lockTimeout` | número | 500 | O tempo limite do bloqueio, em milissegundos. | | | `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`. | | | `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. | | | `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). | | | `reportOutputPath` | string | `/reports` | O caminho de saída do relatório. | | | `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. | | | `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). | | | `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`. | | | `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. | | | `forceHR` | booleano | false | Especifica se o SYSPRINT legível por humanos deve ser usado no console ou na saída do arquivo. | | | `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. | | | `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.numproc` | string | PDF | especificação do compilador numproc. Os valores permitidos são`PFD`/`NOPFD`/`MIG`/. O padrão é`PFD`. | | | `dataSimplifier.doubleFloatingType` | string | IEEE\$1754 | 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 | | `filesDirectory` | string | | O diretório para input/output arquivos em lotes. | | | `ims.messages.extendedSize` | booleano | false | Especifica se é necessário definir o tamanho estendido nas mensagens do IMS. | | | `defaultKeepExistingFiles` | booleano | false | Especifica se o valor anterior padrão do conjunto de dados deve ser definido. | | | `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.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.data.dataJsonInitLocation` | string | | | | | `jics.xa.agent.timeout` | número | | | | | `query.useConcatCondition` | booleano | false | Especifica se a condição da chave é criada por concatenação de chaves ou não. | | | `system.qdecfmt` | string | | | | | `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. | | | `useControlMVariable` | booleano | false | Especifica se a especificação Control-m deve ser usada para substituição de variáveis. | | | `card.encoding` | string | CP1145 | Codificação do cartão: para ser usado com `useControlMVariable`. | | | `mapTransfo.prefixes` | string | &,@,%% | Lista de prefixos a serem usados ao transformar variáveis controlM. Cada um separado por vírgula. | | | `checkinputfilesize` | booleano | false | Especifica se um cheque deve ser liberado se o tamanho do arquivo for múltiplo do tamanho do registro. | | | `stepFailWhenAbend` | booliano | true | Especifica se a suspensão deve ser levantada se uma etapa falhar ou concluir a execução. | | | `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 | | `bluesam.fileLoading.commitInterval` | número | 100000 | O intervalo de confirmação do bluesam. | | | `uppercaseUserInput` | booliano | true | Especifica se a entrada do usuário deve estar em maiúsculas. | | | `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.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. | | | `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`... | | | `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\$1STRICT | O modo para codificar ou decodificar comandos da linguagem de controle (CL). Os valores permitidos são: `EBCDIC_STRICT`, `EBCDIC_MODIFIED` e `AS400`. | | | `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;` | | | `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.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.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.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.navigation.cachenexts` | número | 5000 | A duração do cache (em milissegundos) usada na navegação hierárquica para um 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. | | | `jhdb.query.limitJoinUsage` | booliano | true | Especifica se o parâmetro limite de uso de junção deve ser usado em gráficos RDBMS. | | | `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) | | | `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). | | | `jics.runUnitLauncherPool.enable` | booleano | false | Especifica se o pool do lançador de unidades de execução deve ser ativado no JICS. | | | `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.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. | | | `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.parallelism` | número | 5 | O número de threads usados para produzir as instâncias ausentes na fila quando a tarefa de ajuste é realizada. | | | `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. | | | `spring.aws.application.credentials` | string | nulo | Carregue as AWS credenciais do arquivo de perfis de credenciais no JICS. | | | `jics.queues.sqs.region` | string | eu-west-1 | A AWS região do Amazon Simple Queue Service, usada no JICS. | | | `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. | | | `mq.queues.sqs.region` | string | eu-west-3 | A AWS região do serviço AWS SQS MQ. | | | `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. | | | `databaseStatistics` | booleano | false | Especifica se devem permitir que os construtores de SQL coletem e exibam informações estatísticas. | | | `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 | yyyy-MM-dd HH: MM: ss.ssssss | O formato de carimbo de data/hora de destino do banco de dados. | | | `dateTimeFormat` | string | ISO | dateTimeFormat 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`. | | | `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 `\`. | | | `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. | | | `cacheMetadata` | booliano | true | Especifica se os metadados do banco de dados devem ser armazenados em cache. | | | `forceDisableSQLTrimStringType` | booleano | false | Especifica se o corte de todos os parâmetros da string sql deve ser desativado. | | | `fetchSize` | número | | O valor fetchSize para cursores. Use ao buscar dados usando fragmentos por meio de utilitários de carregamento/descarregamento. | | | `check-groovy-file` | booliano | true | Especifica se o conteúdo dos arquivos groovy deve ser verificado antes do registro. | | | `qtemp.uuid.length` | número | 9 | O comprimento de identificação exclusivo do QTEMP. | | | `qtemp.dblog` | booleano | false | Se deve habilitar o log do banco de dados QTEMP. | | | `qtemp.cleanup.threshold.hours` | número | 0 | Para especificar quando `qtemp.dblog` está ativado. A vida útil da partição db (em horas). | | | `invalidDataTolerence` | booliano | true | Especifica se dados inválidos são tolerados para o tipo empacotado. | | | `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. | | | `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. | | | `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. | | | `mq.queues.default.syncpoint` | booleano | false | Especifica o comportamento padrão dos comandos MQ PUT quando nem MQPMO\$1SYNCPOINT nem MQPMO\$1NO\$1SYNCPOINT 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. | | | `dataSimplifier.byteRangeBoundsCheck` | booleano | false | Quando definido como verdadeiro, ele garante que não ByteRange seja criado com valores impróprios. O padrão é falso. | | | `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`. | | | `tempFilesDirectory` | string | nulo | Especifica o nome da localização da pasta dos arquivos temporários que são gerados. | | | `cleanTempFilesDirectoryAtStartup` | booliano | true | Especifica se o conteúdo da pasta de arquivos temporários deve ser limpo na inicialização da aplicação. | | | `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\$1DIR\$1 \$1\$1. tempFolderPattern 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\$1DIR\$1” \$1 this.hashCode () (). DefaultJobContext | | | `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. | | | `jics.spool.smtp.hostname` | string | nulo | Especifica o host do servidor SMTP. Exemplo: `smtp.xxx.com` | | | `jics.spool.smtp.port` | string | nulo | Especifica a porta do servidor SMTP. Exemplo: 25 | | | `jics.spool.smtp.password` | string | nulo | Especifica a senha de login do servidor SMTP. | | | `jics.spool.smtp.username` | string | nulo | Especifica o nome de usuário do servidor SMTP. | | | `jics.spool.smtp.debug` | booleano | false | Especifica o modo de depuração para o servidor SMTP. | | | `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.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.allowedOrigins` | string[] | `null` | A lista de origens a serem permitidas. Essa opção exige que `gapwalk-application.identity` seja definida como `oauth`. | | | `gdgDirectoryPath` | string | `output/gdg` | O caminho do diretório GDG é o diretório em que os arquivos gdg são armazenados. | 4.6.0 | | `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 | | `listOfMDCUrlParams` | string | `null` | A lista de parâmetros de URL a serem adicionados ao MDC ao executar o script em lote do Groovy. | | | `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.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-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.filterURIs` | string | `disabled` | Alterne a configuração de filtragem URIs . Os valores permitidos são `disabled` e `enabled`. | | | `gapwalk-application.security.blockedURIs` | string[] | nulo | A lista de URIs a serem bloqueados. Essa opção é necessária quando `gapwalk-application.security.filterURIs` é `enabled`. | | | `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). | | | `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). | | | `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). | | | `job.default.encoding` | string | CP1047 | Especifica a codificação padrão usada para inicializar o armazenamento no nível do trabalho. Por exemplo, switches no aplicativo BLU4 IV usam essa codificação para inicializar com zeros. | 4.9.0 | | `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). | | | `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.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.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) | | | `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.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].jmsMQQueueManager` | string | nulo | O nome do gerenciador de filas IBMMQ. | | | `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].jmsMQPort` | número | nulo | A porta do IBMMQ. | | | `mq.queues.jmsMQQueueManagers[N].jmsMQUserid` | string | nulo | Nome do usuário do IBMMQ. | | | `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].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].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.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 RFH2 formato será usado para JMS. | 4.5.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.rabbitMQHost` | string | nulo | O nome do host do Rabbit MQ. | | | `mq.queues.rabbitMQVirtualHost` | string | nulo | O nome do host virtual 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.rabbitMQPassword` | string | nulo | A senha do Rabbit MQ. | | | `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 | | `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 query-to-database mapeamento. | 4.6.0 | | `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 | | `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 | | `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 | | `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`. | | | `startDefaultJob` | string | `false` | Especifique se deseja inicializar o trabalho padrão na primeira transação. | | | `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. | | | `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. | | ## 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, or IMS/MFS. The following tables contain lists of the available key/value parâmetros para configurar cada aplicativo web opcional. ### gapwalk-utility-pgm.guerra 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 | | --- | --- | --- | --- | --- | | `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. | | | `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. | | | `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. | | | `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) | | | `encoding` | string | ASCII | A codificação usada em programas utilitários. Espera uma codificação válida`CP1047`,, `IBM930``ASCII`,`UTF-8`. | | | `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 | | `zonedMode` | string | EBCDIC\$1STRICT | O modo para codificar ou decodificar tipos de dados zoneados. Os valores permitidos são: `EBCDIC_STRICT`, `EBCDIC_MODIFIED` e `AS400`. | | | `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 | | `unload.chunkSize` | número | 0 | Tamanho do pedaço usado para o 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.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 DB2 é o Postgresql. | | | `unload.columnFiller` | string | espaço | O preenchedor de colunas do utilitário de descarga. | | | `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. | | | `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.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 | yyyy-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.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.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.writeNullIndicator` | booleano | false | Especifica se o indicador nulo deve ser gravado no arquivo de saída de descarga. | | | `unload.bmc.useInto` | booleano | false | Especifica se a palavra-chave de controle INTO bmc deve ser processada para o utilitário de descarga. | | | `unload.fetchSize` | número | 0 | Permite ajustar o tamanho da busca ao manipular cursores no utilitário 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 | | `treatLargeNumberAsInteger` | booleano | false | Especifica se os números grandes devem ser tratados como `Integer`. Eles são tratados como `BigDecimal` padrão. | | | `load.batchSize` | número | 0 | O tamanho do lote do utilitário de carga. | | | `load.format.localDate` | string | dd.mm.aaaa\$1\$1 AAA-MM-dd dd/MM/yyyy | O formato de data local do utilitário de carregamento a ser usado. | | | `load.format.localTime` | string | HH:mm:ss\$1HH.mm.ss | O formato de hora local do utilitário de carregamento a ser usado. | | | `load.format.dbDate` | string | yyyy-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.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 DB2 é o Postgresql. | | | `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. | | | `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. | | | `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. | | | `hasGraphic` | booleano | false | Se o utilitário INFUTILB precisa lidar com colunas GRÁFICAS. DB2 | | | `convertGraphicDataToFullWidth` | booliano | true | Especifica se os dados gráficos devem ser convertidos em formato de largura total. | | ### gapwalk-cl-command.guerra Essa aplicação web opcional contém suporte para programas utilitários AS/400. Esta tabela fornece uma visão exaustiva dos key/values parâmetros desse aplicativo. | Chave | Tipo | Valor padrão | Description | | --- | --- | --- | --- | | `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. | | `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. | | `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. | | `primary.datasource` \$1 -`driver-class-name` \$1 -`url` \$1 -`username` \$1 -`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) | | `encoding` | string | ASCII | A codificação usada em programas utilitários. Espera uma codificação válida `CP1047`, `IBM930`, `ASCII`, `UTF-8`... | | `zonedMode` | string | EBCDIC\$1STRICT | O modo para codificar ou decodificar tipos de dados zoneados. Os valores permitidos são: `EBCDIC_STRICT`, `EBCDIC_MODIFIED` e `AS400`. | | `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 sobrescrever um programa existente. `PGM_BASIC`é um programa AWS Transform for mainframe Runtime específico projetado para fins de depuração. | | `forcedDate` | string | | Força a data até a data fornecida, se houver uma. | ### gapwalk-hierarchical-support.guerra 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 | | --- | --- | --- | --- | | `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. | | `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. | | `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.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.keepParent` | booleano | false | Se deve manter \$1parent e \$1logicalparent durante a inserção do IMS. Quando definida como verdadeira, a chamada IMS ISRT inserirá \$1parent e \$1logicalparent 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.backend` | string | | Tipo de back-end Jhdb. O valor esperado é `rdbms` | | `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` | | `metadata.datasource` \$1 -`driver-class-name` \$1 -`url` \$1 -`username` \$1 -`password` \$1 -`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. | ## 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 do 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.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 de QTemp. Se definido como false, a biblioteca é considerada ao realizar operações CRUD para a área de dados. | 4.5.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.dao.cache.enabled` | booleano | false | Ative o cache na memória. | 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.initMaxResults` | número | 10000 | O tamanho do 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.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 cache na memória 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-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-context` | Onde a API está hospedada | | `api-user` | O nome de usuário ou identificador da pessoa que está fazendo a solicitação da API | | `api-sessionid` | Um identificador exclusivo para a sessão de login atual do usuário | | `api-scheme` | O protocolo de transferência usado, por exemplo, HTTP ou HTTPS. | | `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-secure` | O método de segurança usado para proteger a chamada da API (por exemplo, Token OAuth2, Anonymous) | | `api-method` | O tipo de solicitação HTTP feita (por exemplo, GET, POST, DELETE,...) | 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 ```