View a markdown version of this page

Activer les propriétés pour AWS Transform pour Mainframe Runtime - AWS Modernisation du mainframe

AWS L'expérience autogérée de modernisation des ordinateurs centraux n'est plus accessible aux nouveaux clients. Pour des fonctionnalités similaires à l'expérience autogérée de modernisation des ordinateurs AWS centraux, explorez les fonctionnalités proposées directement par les fournisseurs et proposées par. AWS Transform Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d'informations, consultez la section Modification de la disponibilité de la modernisation du AWS mainframe.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

AWS Le service de modernisation du mainframe (expérience Managed Runtime Environment) n'est plus ouvert aux nouveaux clients. Pour des fonctionnalités similaires à celles du AWS Mainframe Modernization Service (expérience Managed Runtime Environment), explorez AWS Mainframe Modernization Service (Self-ManagedExperience). Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d'informations, consultez la section Modification de la disponibilité de la modernisation du AWS mainframe.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Activer les propriétés pour AWS Transform pour Mainframe Runtime

Dans Spring Boot, les applications application-main.yml sont le fichier de configuration dans lequel nous définissons différents types de propriétés telles que le port d'écoute, la connectivité à la base de données, etc. Vous pouvez utiliser cette page pour en savoir plus sur les propriétés disponibles pour AWS Transform for mainframe Runtime et sur la manière de les activer.

Notation YML

Dans la documentation suivante, une propriété telle que parent.child1.child2=true est écrite comme suit au format YAML.

parent: child1: child2: true

Démarrage rapide/Cas d'utilisation

Les cas d'utilisation suivants présentent des exemples de clés et de valeurs applicables.

  • Par défaut application-main.yml

    ---- #### 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 ----
  • Utiliser des fichiers de longueur variable avec les commandes 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)
  • Fournir une valeur d'indicateur d'octet nul dans l'utilitaire 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

Propriétés disponibles pour l'application principale

Ce tableau fournit une vue exhaustive des key/values paramètres.

Note

Si vous migrez vers la version 5.1.0 ou ultérieure et que vous utilisez bluesam avec le comportement d'ouverture par défaut : WarmUp

  • La valeur par défaut de bluesam.openWarmUp est passée de true à false

  • Pour conserver le comportement existant, vous devez définir explicitement bluesam.openWarmUp=true

Clé Type Valeur par défaut Description Version de sortie

blockSizeDefault

number

32760

Taille de bloc par défaut à utiliser pour les octets BDW.

blu4iv.dataaccess.useOldDaoDesign

boolean

false

Un indicateur global qui détermine si l'application doit utiliser l'ancienne architecture DAO ou la nouvelle. Cela dépend du fait que les DAO ont été générés à l'aide d'un ancien ou d'un nouveau design.

blu4iv.userspace.batchThreshold

int

1

Spécifie le nombre d'opérations de mise à jour ou de définition sur un espace utilisateur, après quoi l'espace utilisateur est conservé dans un référentiel de données externe.

5,75,0

blu4iv.userspace.pageSize

int

4096

Spécifie le format de page utilisé pour allouer de l'espace de stockage pour les espaces utilisateur. La taille de l'espace utilisateur à un moment donné est toujours un multiple de ce nombre spécifié.

4.10.0

blu4iv.userspace.redis.*

Propriétés Redis prises en charge

Spécifie les propriétés de configuration pour les espaces utilisateur Redis Store, voirPropriétés du cache Redis disponibles dans AWS Transform for mainframe Runtime.

4.10.0

blu4iv.userspace.store-type

chaîne

memory

Spécifie le type de magasin utilisé pour le registre de l'espace utilisateur. Les valeurs prises en charge sont memory et redis. Si aucun type de stockage n'est fourni, la mémoire est utilisée par défaut.

4.10.0

bluesam.bluesamStatusPollingInterval

number

1 000

Spécifie le temps (en millisecondes) à attendre entre chaque itération lors de l'interrogation de l'état de Bluesam pour vérifier les activités en ligne.

4.5.0

bluesam.cache

chaîne

S'il n'est pas défini, le Blusam cache ne sera pas utilisé. Les valeurs possibles (implémentations du cache) sont ehcache et redis (). Propriétés du cache Redis

bluesam.checkBluesamStatus

boolean

false

Spécifie s'il faut vérifier ou non l'état du jeu de données Bluesam avant d'y accéder.

4.5.0

bluesam.datasetPrefetchWindowSize

chaîne []

Spécifie les remplacements de taille de fenêtre de prélecture par jeu de données. Format de chaque entrée :"datasetName:size". Si un jeu de données n'est pas répertorié, il revient à la bluesam.prefetchWindowSize valeur globale.

Remarque :

- N'ajoutez pas d'espaces autour du séparateur deux-points.

- Les noms des ensembles de données contenant | sont pris en charge (utilise le dernier deux-points comme délimiteur).

- Placez les entrées entre guillemets doubles ou veillez à ne pas les insérer d'espaces.

- Exemple : "fileset1|MYFILE:10000"

bluesam.disabled

boolean

false

S'il faut désactiver Blusam complètement.

bluesam.externalDdlManagement

boolean

false

Lorsque cette option est activée, BlueSam ne crée pas automatiquement de tables et adopte plutôt des tables gérées en externe en enregistrant uniquement les métadonnées.

bluesam.fileList

chaîne []

Spécifie la liste des jeux de données Bluesam à mettre en cache lors de l'ouverture.

Remarque :

- Ce paramètre n'est efficace que s'il bluesam.openWarmUp est défini surfalse.

5.1.0

bluesam.fileLoading.commitInterval

number

100 000

L'intervalle de validation de Bluesam.

bluesam.maxBluesamDisablingThreadpoolSize

number

10

Spécifie la taille maximale du pool de threads utilisée pour désactiver les ensembles de données Bluesam pour le traitement par lots.

4.5.0

bluesam.maxBluesamStatusPollingRetry

number

3

Spécifie le nombre maximum de tentatives lorsque l'interrogation de l'état de Bluesam échoue.

4.5.0

bluesam.metadataWarmUpFileList

chaîne []

Spécifie la liste des ensembles de données bluesam dont les métadonnées d'index seront préchargées dans un cache permanent en mémoire au démarrage de l'application.

Remarque :

- Les index sont chargés ApplicationReadyEvent et persistent pendant tout le cycle de vie de l'application.

- Efficace uniquement pour les grands ensembles de données.

bluesam.openWarmUp

boolean

false

Spécifie s'il faut mettre en cache des ensembles de données Bluesam lors de leur ouverture.

Avertissement : changement décisif dans la version 5.1.0

- La valeur par défaut est passée de true àfalse.

5.1.0

bluesam.prefetchWindowMultiples

int

5

Spécifie le multiplicateur pour la taille de la fenêtre de prélecture afin de déterminer la capacité maximale de la fenêtre de prélecture. La capacité maximale est calculée comme suitprefetchWindowSize × prefetchWindowMultiples. Cette propriété n'est effective que lors de l'utilisation du cache Redis.

bluesam.prefetchWindowSize

int

1 000

Spécifie le nombre d'enregistrements à préextraire et à mettre en cache en mémoire pour optimiser le cache Redis. Cette propriété n'est effective que lors de l'utilisation du cache Redis.

bluesam.redis.batchClearSize

int

1 000

Taille du lot pour les opérations d'effacement du cache Redis lorsque cette option bluesam.redis.enableBatchClear est activée.

bluesam.redis.clearStrategy

chaîne

DEFAULT

Spécifie la stratégie pour les opérations de vidage du cache.

DEFAULTutilise la RedisCache.clear() méthode Spring.

REDISSONutilise la unlinkByPattern méthode Redisson, qui est sûre pour les clusters et évite les erreurs de mémoire insuffisante.

REDISSON_BATCHEDutilise une opération Redisson SCAN avec des appels d'expiration par lots, ce qui vous donne un contrôle maximal sur la charge Redis.

bluesam.redis.deleteAllBatchSize

int

1 500

Taille du lot pour les opérations Redis DeleteAll afin d'optimiser les performances lorsque vous travaillez avec de grands ensembles de données.

bluesam.redis.enableBatchClear

boolean

false

Activez le traitement par lots pour les opérations d'effacement du cache Redis lorsque vous travaillez avec de grands ensembles de données.

bluesam.redis.readBatchSize

int

1 500

Taille du lot pour les opérations de lecture du cache Redis (lecture groupée depuis le cache par ID).

bluesam.sizesCleanUpThreshold

int

1 000

Nombre maximum d'entrées conservées dans la carte de suivi des décalages interne par ensemble de données pour les grands ensembles de données (LargeKSDS, LargeESDS) lors d'écritures multithread simultanées. Lorsque la carte dépasse ce seuil, elle est réduite aux 10 entrées les plus récentes pour éviter l'épuisement du tas tout en préservant suffisamment d'entrées pour éviter l'accès NullPointerException simultané aux threads. Réduisez cette valeur si une pression de tas est observée lors de chargements groupés de grands volumes de jeux de données volumineux.

bluesam.warmUpMetadataCacheLimit

long

0

Nombre maximum d'entrées d'index autorisées dans le cache de préchauffage des métadonnées. Réglez sur 0 pour un nombre illimité.

Remarque :

- Il s'agit d'une limite globale pour tous les ensembles de données configurés dansbluesam.metadataWarmUpFileList.

- Lorsque la limite est atteinte, les index supplémentaires sont ignorés avec un journal d'avertissements.

cacheMetadata

boolean

true

Spécifie s'il faut mettre en cache les métadonnées de base de données.

card.encoding

chaîne

CP1145

Encodage de la carte : à utiliser avecuseControlMVariable.

check-groovy-file

boolean

true

Spécifie s'il faut vérifier le contenu des fichiers groovy avant de les enregistrer.

checkinputfilesize

boolean

false

Spécifie s'il faut lancer une vérification si la taille du fichier est un multiple de la taille de l'enregistrement.

cl.configuration.context.encoding

chaîne

CP297

L'encodage des fichiers CL. S'attend à un encodage valide CP1047IBM930,ASCII,,UTF-8... La valeur par défaut est CP297

cl.zonedMode

chaîne

EBCDIC_STRICT

Mode d'encodage ou de décodage des commandes en langage de contrôle (CL). Les valeurs autorisées sontEBCDIC_STRICT/EBCDIC_MODIFIED/AS400.

clcommand.rtvmbrd.hasHeader

chaîne

true

Spécifiez si les fichiers contiennent des en-têtes qui ne doivent pas être inclus lors du comptage des lignes.

cleanTempFilesDirectoryAtStartup

boolean

true

Spécifie s'il faut purger le contenu du dossier de fichiers temporaires au démarrage de l'application.

context.preconstruct.enable

boolean

false

Spécifie s'il faut activer la pré-construction du contexte du programme.

context.preconstruct.frequencyInMillis

number

100

L'intervalle entre chaque exécution de la tâche qui ajuste la taille du pool.

context.preconstruct.minInstances

number

2

Le nombre d'instances qui seront créées la première fois qu'un contexte sera nécessaire.

context.preconstruct.parallelism

number

5

Le nombre de threads utilisés pour produire les instances manquantes dans la file d'attente lors de l'exécution de la tâche d'ajustement.

database.cursor.overflow.allowed

boolean

true

Spécifie s'il faut autoriser le dépassement du curseur. Réglez sur true pour effectuer un appel suivant sur le curseur, quelle que soit sa position. Réglez false sur pour vérifier si le curseur est en dernière position avant d'effectuer un appel suivant sur le curseur. Activez uniquement si le curseur peut défiler (SENSIBLE ou INSENSIBLE).

database.cursor.raise.already.opened.error

boolean

false

Spécifie s'il faut activer le déclenchement de l'erreur SQLCODE 502 lorsqu'un curseur déjà ouvert s'ouvre.

databaseStatistics

boolean

false

Spécifie si les générateurs SQL doivent être autorisés à collecter et à afficher des informations statistiques.

dataSimplifier.byteRangeBoundsCheck

boolean

false

Lorsqu'il est défini sur true, cela garantit que no n' ByteRange est créé avec des valeurs incorrectes. La valeur par défaut est false.

dataSimplifier.cacheDefaultValues

boolean

false

Lorsqu'il est défini sur true, active la mise en cache par instance des modèles d'octets calculés avec des valeurs par défaut dans, et les sous-classes. RecordEntity ElementaryRange RangeType La valeur par défaut est false.

dataSimplifier.doubleFloatingType

chaîne

IEEE_754

Le type flottant double est le format utilisé pour coder et décoder un nombre à virgule flottante. Les valeurs autorisées sontIEEE_754/HFP(pour le format hexadécimal à virgule flottante). La valeur par défaut est IEEE_754.

4.7.0

dataSimplifier.numproc

chaîne

PFD

spécification du compilateur numproc. Les valeurs autorisées sontPFD/NOPFD/MIG/. La valeur par défaut est PFD.

dataSimplifier.onInvalidNumericData

chaîne

rejeter

Comment réagir lors du décodage de données numériques non valides. Les valeurs autorisées sontreject/toleratespaces/toleratespaceslowvalues/toleratemost. La valeur par défaut estreject.

dataSimplifier.zeroInvalidBcdNibbles

boolean

true

Lorsqu'il est défini sur true, les octets contenant des valeurs BCD non valides (chiffres hexadécimaux A - F en position numérique) sont traités comme 00 lors du décodage décimal compressé. Par défaut, la valeur est true.

datasource.bluesamDs + -driver-class-name + -url + -username + -password + -type

Source de données Spring standard avec sous-clés

Contient les informations de connexion à la Blusam base de données. Alternativement, l'utilisation de AWS secrets est fortement encouragée, comme expliqué dansBase de données Blusam.

datasource.jicsDs + -driver-class-name + -url + -username + -password + -type

Source de données Spring standard avec sous-clés

Contient les informations de connexion pour la base de données Jics. Alternativement, l'utilisation de AWS secrets est fortement encouragée, comme expliqué dansBase de données JICS.

dateTimeFormat

chaîne

ISO

La date TimeFormat décrit comment transférer la date, l'heure et le type d'horodatage de la base de données dans des entités simplificatrices de données. Les valeurs autorisées sont ISOEUR/EUR/USA/LOCAL

dbDateFormat

chaîne

aaaa- MM-dd

Le format de date cible de la base de données.

dbTimeFormat

chaîne

HH:mm:ss

Le format d'heure cible de la base de données.

dbTimestampFormat

chaîne

aaaa- MM-dd HH:mm:ss.SSSSSS

Le format d'horodatage cible de la base de données.

defaultKeepExistingFiles

boolean

false

Spécifie s'il faut définir la valeur précédente par défaut de l'ensemble de données.

disposition.checkexistence

boolean

false

Spécifie s'il faut lancer une vérification de l'existence des fichiers pour Dataset avec DISP SHR ou OLD.

enableActivePgmIdCache

boolean

false

Spécifie s'il faut activer le cache local de l'ID de programme actif. Utilisez cette fonctionnalité avec précaution car les ressources JICS peuvent être partagées entre les programmes et les utilisateurs. Ces ressources peuvent être modifiées en externe par n'importe quel administrateur et le cache local mis en place risque d'être invalidé.

encoding

chaîne

ASCII

L'encodage utilisé dans les projets (pas dans les fichiers groovy). S'attend à un encodage valide CP1047IBM930,ASCII,,UTF-8...

externalSort.threshold

taille des données (exemple : 12 Mo)

Le seuil de tri : détermine à quel moment le système doit passer du tri en mémoire au tri par fusion externe à l'aide de fichiers temporaires sur le système de fichiers. S'il n'est pas spécifié (default=null), le seuil est défini sur la moitié de la mémoire disponible à chaque nouvelle tâche de tri. Pour estimer la mémoire disponible, un appel à System.gc () est effectué.

fetchSize

number

La valeur FetchSize pour les curseurs. À utiliser lors de la récupération de données à l'aide de segments par load/unload des utilitaires.

file.stdoutIntoLogger

boolean

false

Spécifie s'il faut activer l'écriture dans l'enregistreur au lieu du flux de sortie système par défaut dans les SYSPUNCH fichiers SYSPRINT et par défaut.

filesDirectory

chaîne

Le répertoire des input/output fichiers de lots.

forcedDate

chaîne

Force la date à la date indiquée, s'il y en a une.

forcedDateMode

chaîne

Spécifie le mode de date forcée. Lorsqu'elle est définie surHYBRID, la partie date est la date forcée configurée, mais la partie heure reflète l'heure réelle du système. S'applique uniquement si forcedDate cette option est également définie.

forceDisableSQLTrimStringType

boolean

false

Spécifie s'il faut désactiver le découpage de tous les paramètres de chaîne SQL.

forceHR

boolean

false

Spécifie s'il faut utiliser le SYSPRINT lisible par l'homme, que ce soit sur la console ou en sortie de fichier.

frozenDate

boolean

true

Spécifie s'il faut figer la date. S'applique uniquement si forcedDate cette option est également définie.

gapwalk-application.defaultSuperAdminUserName

chaîne

sadmin

Lorsque cette option gapwalk-application.security est désactivée, spécifie le nom de super utilisateur local par défaut.

gapwalk-application.defaultSuperAdminUserPwd

chaîne

sadmin

Lorsque cette option gapwalk-application.security est désactivée, spécifie le mot de passe du super utilisateur local par défaut.

gapwalk-application.security

chaîne

disabled

Activez la configuration de sécurité globale (authentification XSS, CORS, CSRF, OAUTH...). Les valeurs autorisées sont disabled et enabled.

gapwalk-application.security.allowedOrigins

chaîne []

null

La liste des origines à autoriser. Cette option doit gapwalk-application.identity être définie suroauth.

gapwalk-application.security.blockedURIs

chaîne []

null

La liste des URI à bloquer. Cette option est obligatoire lorsque c'gapwalk-application.security.filterURIsest le casenabled.

gapwalk-application.security.claimGroupName

chaîne

cognito:groups

L'attribut claim qui contient la liste de tous les groupes auxquels appartient un utilisateur. cognito:groupsÀ utiliser pour Amazon Cognito ou toute autre chaîne pour un IdP étranger.

gapwalk-application.security.customAllowedHeaders

chaîne []

null

La liste des en-têtes personnalisés à autoriser. Cette option doit gapwalk-application.identity être définie suroauth.

4.8.0

gapwalk-application.security.filterURIs

chaîne

disabled

Activer/désactiver la configuration des URI de filtrage. Les valeurs autorisées sont disabled et enabled.

gapwalk-application.security.identity

chaîne

null

Méthode d'authentification globale. La valeur recommandée estoauth. Les valeurs autorisées sont json et oauth. Cette option est obligatoire lorsque c'gapwalk-application.securityest le casenabled.

gapwalk-application.security.issuerUri

chaîne

null

L'URI émetteur du fournisseur d'identité (IdP). Cette option est obligatoire lorsque c'gapwalk-application.identityest le casoauth.

gapwalk-application.security.userAttributeName

chaîne

username

Le nom de l'attribut de réclamation utilisé pour identifier une demande utilisateur. usernameÀ utiliser pour Amazon Cognito, preferred_username pour Keycloak ou toute autre chaîne pour un IdP étranger.

gapwalk.cobol.cblqda.enabled

boolean

false

Active une fonctionnalité CBLQDA qui contrôle l'allocation dynamique des fichiers QSAM lors d'une instruction OPEN. Cette configuration permet d'allouer dynamiquement les fichiers temporaires déclarés dans le programme, même s'ils ne sont pas définis dans le script JCL.

gapwalk.database.metadata.schema-inclusion.enabled

boolean

false

Active une fonction d'optimisation de la mémoire qui contrôle les schémas de base de données mis en cache par une application. Cette configuration permet de réduire l'empreinte mémoire tout en préservant la stabilité du système grâce à une gestion intelligente des métadonnées du schéma. Il inclut automatiquement certains schémas de système de base de données courants qui peuvent être nécessaires pour un fonctionnement correct.

4.9.0

gapwalk.database.metadata.schema-inclusion.schemas.global

liste <String>

null

Définit une liste de schémas qui doivent être mis en cache.

4.9.0

gapwalk.database.support.useSavePointToRestoreFail

boolean

false

Permet de récupérer les transactions en cas d'échec en utilisant des points de sauvegarde sur les requêtes d'insertion. L'activation de cette propriété peut affecter les performances de la base de données. Vous pouvez modifier ce paramètre pour des requêtes spécifiques à l'aide de la configuration de mappage requête/base de données.

4.6.0

gapwalk.io.sequential.readBufferSize

entier

8192

Définit la taille de la mémoire tampon (en octets) pour BufferedInputStream la lecture de fichiers séquentiels. L'augmentation de cette valeur réduit le nombre d'opérations de I/O lecture, ce qui peut améliorer les performances lors de la lecture de fichiers volumineux depuis un stockage rattaché au réseau tel qu'Amazon EFS.

gapwalk.line.separator

chaîne

null

Spécifie le type de séparateur de lignes dans Gapwalk. Les valeurs autorisées sont WIN (CRLF)/UNIX (LF)/LINUX (LF). Les autres valeurs sont ignorées et la propriété System line.sepatator est utilisée.

gapwalk.post.script.mediatype.json

boolean

false

Spécifie si l'Content-Typeen-tête de la réponse du point de terminaison /post/script/{scriptId:.+} est défini surapplication/json, en fonction de la valeur d'une variable booléenne. S'il est défini sur false, la valeur par défaut esttext/plain; charset=utf-8.

gapwalk.ssl.enabled

boolean

false

Indiqué pour définir les gapwalk.ssl.* propriétés suivantes sur les propriétés actuelles du système JVM si elles ne sont pas déjà définies au démarrage de l'application.

gapwalk.ssl.keyStore

chaîne

null

Définissez la valeur sur la propriété système javax.net.ssl.keyStore si elle n'est pas déjà configurée au démarrage de l'application.

gapwalk.ssl.keyStorePassword

chaîne

null

Définissez la valeur sur la propriété système javax.net.ssl.keyStorePassword si elle n'est pas déjà configurée au démarrage de l'application. Alternativement, l'utilisation de AWS secrets est fortement encouragée, comme expliqué dansGestionnaire de secrets pour les paramètres de mot de passe SSL.

gapwalk.ssl.trustStore

chaîne

null

Définissez la valeur sur la propriété système javax.net.ssl.trustStore si elle n'est pas déjà définie au démarrage de l'application.

gapwalk.ssl.trustStorePassword

chaîne

null

Définissez la valeur sur la propriété système javax.net.ssl.trustStorePassword si elle n'est pas déjà configurée au démarrage de l'application. Alternativement, l'utilisation de AWS secrets est fortement encouragée, comme expliqué dansGestionnaire de secrets pour les paramètres de mot de passe SSL.

gapwalk.ssl.trustStoreType

chaîne

null

Définissez la valeur sur la propriété système javax.net.ssl.trustStoreType si elle n'est pas déjà configurée au démarrage de l'application.

gapwalk.zos.sysplexName

chaîne

null

Spécifie la valeur du nom du sysplex pour le CVT (Communications Vector Table) émulé.

5,202,0

gapwalk.zos.systemName

chaîne

null

Spécifie la valeur du nom du système pour la CVT (Communications Vector Table) émulée.

5,202,0

gdgDirectoryPath

chaîne

output/gdg

Le chemin du répertoire GDG est le répertoire dans lequel les fichiers GDG sont stockés.

4.6.0

ims.messages.extendedSize

boolean

false

Spécifie s'il faut définir la taille étendue des messages IMS.

ims.programs

chaîne

Liste des programmes IMS à utiliser. Séparez chaque paramètre par un point-virgule (;) et chaque transaction par une virgule (). , Exemples :PCP008,PCT008;PCP054,PCT054;PCP066,PCT066;PCP068,PCT068;

invalidDataTolerence

boolean

true

Spécifie si les données non valides sont tolérées pour le type compressé.

jcl.checkpoint.enabled

boolean

false

Spécifie si le mécanisme de point de contrôle JCL est activé pour permettre le redémarrage de la tâche. Les points de contrôle JCL sont créés et enregistrés dans le registre en mémoire au début de chaque étape ou de chaque appel principal du programme. Tous les points de contrôle au niveau de l'étape sont conservés à la fin de la tâche, si un fournisseur de persistance est défini.

jcl.checkpoint.expireTimeout

number

-1

Spécifie la durée pendant laquelle les points de contrôle JCL doivent être conservés dans le fournisseur de persistance ou dans le registre en mémoire.

jcl.checkpoint.expireTimeoutUnit

chaîne

SECONDES

Spécifie l'unité de durée de la jcl.checkpoint.expireTimeout propriété. Valeurs de constantes d'énumération prises en charge : java.util.concurrent. TimeUnit.

jcl.checkpoint.provider

chaîne

null

Spécifie le fournisseur de persistance du mécanisme de point de contrôle JCL. Les valeurs autorisées sontredis.

jcl.checkpoint.redis.*

Propriétés Redis prises en charge

Spécifie les propriétés de configuration du fournisseur de persistance REDIS du mécanisme de point de contrôle JCL, voir. Propriétés Redis prises en charge

jcl.nullJclEof

boolean

true

Spécifie la manière dont les instructions JCL nulles (//) sont gérées lors de l'exécution de la tâche. Lorsque c'est vrai,//met fin à la tâche immédiatement (mode EOF). Lorsque la valeur est fausse,//est traité comme une instruction nulle et l'exécution se poursuit (mode IGNORE).

jhdb.checkpointPath

chaîne

fichier :. /configuration/

Si ce n'jhdb.checkpointPersistenceest pas le casnone, ce paramètre vous permet de configurer le chemin de persistance des points de contrôle (emplacement de stockage du fichier checkpoint.dat). Toutes les données des points de contrôle contenues dans le registre sont sérialisées et sauvegardées dans un fichier (checkpoint.dat) situé dans le dossier fourni. Notez que seules les données des points de contrôle (ScriptID, StepID, position de la base de données et zone de point de contrôle) sont concernées par cette sauvegarde.

jhdb.checkpointPersistence

chaîne

Aucune

Mode de persistance des points de contrôle. Les valeurs autorisées sontnone/add/end. addUtilisez-le pour conserver les points de contrôle lorsqu'un nouveau est créé et ajouté au registre. Utilisez le point de contrôle end trop persistant à l'arrêt du serveur. Toute autre valeur désactive la persistance. Notez que chaque fois qu'un nouveau point de contrôle est ajouté au registre, tous les points de contrôle existants seront sérialisés et le fichier sera effacé. Il ne s'agit pas d'un ajout aux données existantes du fichier. Ainsi, selon le nombre de points de contrôle, cela peut avoir des effets sur les performances.

jhdb.configuration.context.encoding

chaîne

CP297

L'encodage JHDB (base de données hiérarchique Java). Attend une chaîne de codage valideCP1047,IBM930,ASCII,UTF-8...

jhdb.identificationCardData

chaîne

Utilisé pour coder en dur certaines « données de carte d'identification de l'opérateur » dans le champ MID désigné par le paramètre CARD. Vide par défaut, aucune restriction de saisie.

jhdb.lterm

chaîne

Vous permet de forcer un identifiant de terminal logique commun dans le cas d'une émulation IMS. S'il n'est pas défini, l'ID de session est utilisé.

jhdb.metadata.extrapath

chaîne

fichier :. /configuration/

Paramètre de configuration qui spécifie un dossier racine supplémentaire, spécifique à l'exécution, pour les dossiers psbs et dbds.

jhdb.navigation.cachenexts

number

5000

Durée du cache (en millisecondes) utilisée dans la navigation hiérarchique pour un SGBDR.

jhdb.optim.cacheRetention

boolean

false

Spécifie s'il faut conserver le cache du nœud pendant les opérations de lecture consécutives. Lorsque cette option est activée, les lectures séquentielles réutilisent le cache et seules les opérations d'écriture (validation ou restauration) l'effacent.

jhdb.query.limitJoinUsage

boolean

true

Spécifie s'il faut utiliser le paramètre d'utilisation des jointures limites sur les graphes SGBDR.

jhdb.use-db-prefix

boolean

true

Spécifie s'il faut activer un préfixe de base de données dans la navigation hiérarchique pour un SGBDR.

jics.data.dataJsonInitLocation

chaîne

jics.db.dataScriptLocation

chaîne

Définit le chemin d'accès aux scripts SQL utilisés pour initialiser la base de données JICS. Accepte une liste de fichiers et de répertoires séparés par des virgules, ce qui permet de spécifier plusieurs scripts et dossiers.

jics.db.dataTestQueryLocation

chaîne

Emplacement d'un script SQL contenant une seule requête SQL censée renvoyer un nombre d'objets (par exemple : compter le nombre d'enregistrements dans la table du programme jics). Si le nombre est égal à 0, la base de données sera chargée à l'aide du jics.db.dataScriptLocation script, sinon le chargement de la base de données sera ignoré.

jics.db.ddlScriptLocation

chaîne

Emplacement du script Jics DDL. Vous permet de lancer le schéma de base de données Jics à l'aide d'un script .sql. Vide par défaut. Par exemple,./jics/sql/jics.sql.

jics.db.schemaTestQueryLocation

chaîne

Emplacement du fichier SQL qui doit contenir une requête unique renvoyant le nombre d'objets dans le schéma jics (le cas échéant).

jics.initList

chaîne

La liste JICS d'initialisation, séparée par des virgules. S'il est présent, il définit les noms des listes séparés par des virgules à activer au démarrage d'Apache Tomcat parmi les listes CICS. Exemple de valeur :$UUU,DFH$IVPL,PEZ1. Cela se répercutera sur les groupes contenus dans ces listes et leurs définitions de ressources sous-jacentes, qui seront ensuite visibles pour le moteur d'exécution. Vide par défaut.

jics.jcl.rt.encoding

chaîne

CP037

L'encodage des scripts JCL écrits dans la file d'attente JICS dédiée.

jics.jcl.rt.queue

chaîne

JICS

Nom de la file d'attente dans laquelle les scripts JCL peuvent être écrits ligne par ligne lors de l'exécution.

jics.parameters.applid

chaîne

VÉLOCITÉ

L'application appliquée pour identifier l'application dans JICS (au moins 4 caractères, pas de longueur maximale).

jics.parameters.charset

chaîne

CP037

Jeu de caractères JICS utilisé dans le monde entier.

jics.parameters.cwa.length

number

0

La longueur de la zone de travail commune (CWA).

jics.parameters.datform

chaîne

MMDDYY

Le formulaire de date.

jics.parameters.eibtrmid

chaîne

TERME

L'identifiant du terminal (4 caractères maximum, 1 minimum).

jics.parameters.jobname

chaîne

NOM DE POSTE

Le nom du poste.

jics.parameters.netname

chaîne

MON NOM DE RÉSEAU

Le nom du réseau (8 caractères maximum, 1 minimum).

jics.parameters.opid

chaîne

XXX

Identification de l'opérateur à 3 caractères.

jics.parameters.sysid

chaîne

CICS

L'identification du système (SYSID).

jics.parameters.sysname

chaîne

SYSNAME

Le nom du système AS400 (sysname).

jics.parameters.tsqimpl

chaîne

bluesam

Implémentation de la file d'attente de stockage temporaire (TSQ) JICS (les valeurs autorisées sontbluesam//memory) redis

jics.parameters.userid

chaîne

L'identifiant utilisateur (8 caractères maximum, pas de minimum). Lorsqu'aucune valeur n'est fournie (vide par défaut), l'identifiant de session HTTP est utilisé comme identifiant utilisateur.

jics.parameters.username

chaîne

MON NOM D'UTILISATEUR

Le nom d'utilisateur (10 caractères maximum, 1 minimum).

jics.queues.sqs.region

chaîne

eu-west-1

La AWS région d'Amazon Simple Queue Service, utilisée dans JICS.

jics.queues.ts.redis.*

Propriétés Redis prises en charge

Spécifie les propriétés de configuration du serveur JICS TS Queues Redis, voir. Propriétés Redis prises en charge

jics.redis.*

Propriétés Redis prises en charge

Spécifie les propriétés de configuration de la fabrique de connexions au serveur JICS Redis, voir. Propriétés Redis prises en charge

jics.runUnitLauncherPool.enable

boolean

false

Spécifie s'il faut activer le pool de lanceurs d'unités d'exécution dans JICS.

jics.runUnitLauncherPool.parallelism

number

2

Le nombre de threads utilisés pour produire les instances manquantes dans la file d'attente lors de l'exécution de la tâche d'ajustement.

jics.runUnitLauncherPool.size

number

20

Taille du pool de lanceurs d'unités exécutées dans JICS.

jics.runUnitLauncherPool.validationInterval

number

1 000

L'intervalle entre chaque exécution de la tâche qui ajuste la taille du pool.

jics.spool.smtp.debug

boolean

false

Spécifie le mode de débogage pour le serveur SMTP.

jics.spool.smtp.hostname

chaîne

null

Spécifie l'hôte du serveur SMTP. Exemple : smtp.xxx.com

jics.spool.smtp.password

chaîne

null

Spécifie le mot de passe de connexion du serveur SMTP.

jics.spool.smtp.port

chaîne

null

Spécifie le port du serveur SMTP. Exemple : 25

jics.spool.smtp.username

chaîne

null

Spécifie le nom d'utilisateur du serveur SMTP.

jics.xa.agent.timeout

number

jildb.backend

chaîne

Spécifie le type de base de données utilisé dans le backend Jildb, par exemple Oracle.

jildb.datasource + -driver-class-name + -url + -username + -password

Source de données Spring standard avec sous-clés

Contient les informations de connexion pour la base de données Jics.

jildb.record-hold-timeout

int

10 000

Spécifie le délai d'attente, en millisecondes, pour le mécanisme de conservation des enregistrements dans Jildb.

job.default.encoding

chaîne

CP1047

Spécifie le codage par défaut utilisé pour initialiser le stockage au niveau de la tâche. Par exemple, les commutateurs de l'application BLU4IV utilisent ce codage pour s'initialiser à zéro.

4.9.0

listOfMDCUrlParams

chaîne

null

La liste des paramètres d'URL à ajouter au MDC lors de l'exécution du script batch Groovy.

localDateFormat

chaîne

Liste des formats de date locaux. Séparez chaque format par. \

localTimeFormat

chaîne

Liste des formats d'heure locaux. Séparez chaque format par \

localTimestampFormat

chaîne

Liste des formats d'horodatage locaux. Séparez chaque format par\.

lockTimeout

number

500

Le délai de verrouillage, en millisecondes.

logging.config

Chemin

chemin de classe : logback-main.xml

Clé standard pour la référence au fichier de configuration de logback. D'autres clés de journalisation standard sont également disponibles.

mapTransfo.prefixes

chaîne

&,@,%%

Liste des préfixes à utiliser lors de la transformation des variables ControlM. Chacune est séparée par une virgule.

mf.runtime.switch.N

boolean

true

Active l'insertion nulle pour les fichiers séquentiels de lignes MF Nature.

4.4.0

mf.runtime.switch.T

boolean

false

Permet l'insertion de caractères de tabulation dans les fichiers séquentiels de lignes MF Nature.

4.4.0

mq.connection.pool.share

boolean

false

Indiquez si vous souhaitez partager ou recréer le pool de connexions JMS avec le même gestionnaire de files d'attente.

4.9.0

mq.queues

chaîne

sqs

Spécifie quel brocker de files d'attente pris en charge doit être utilisé pour sqs utiliser Amazon SQS, rabbitmq Rabbit MQ sur site ou IBMMQ sur site. jms

mq.queues.default.syncpoint

boolean

false

Spécifie le comportement par défaut des commandes MQ PUT lorsque ni MQPMO_SYNCPOINT ni MQPMO_NO_SYNCPOINT ne sont définis. Lorsqu'il est défini sur true, il agit comme MQPMO_SYNCPOINT et les messages ne sont PAS directement validés pendant la commande PUT. Lorsqu'il est défini sur false, il agit comme MQPMO_NO_SYNCPOINT et les messages sont directement validés lors de la commande PUT.

mq.queues.jms.connectionfactory.*

Propriétés de l'usine de connexion Atomikos prises en charge

Spécifie les propriétés de configuration du pool de connexions JMS MQ.

mq.queues.jmsMQQueueManagers[N]

Quand mq.queues c'est jms le cas, permet de spécifier une liste de connexions IBM MQ. mq.queues.jmsMQQueueManagers[0]pour la première connexion, mq.queues.jmsMQQueueManagers[1] pour la seconde et ainsi de suite.

mq.queues.jmsMQQueueManagers[N].jmsMQAppName

chaîne

null

Le nom de l'application IBMMQ.

mq.queues.jmsMQQueueManagers[N].jmsMQChannel

chaîne

null

Le nom du canal IBMMQ.

mq.queues.jmsMQQueueManagers[N].jmsMQHost

chaîne

null

Le nom d'hôte IBMMQ.

mq.queues.jmsMQQueueManagers[N].jmsMQMaxPoolSize

number

0

Taille maximale du pool IBMMQ. Avec 0, un nombre infini de connexions physiques sont activées.

mq.queues.jmsMQQueueManagers[N].jmsMQPassword

chaîne

null

Le mot de passe utilisateur IBMMQ. Alternativement, l'utilisation de AWS secrets est fortement encouragée, comme expliqué dansGestionnaire de secrets pour les paramètres de mot de passe IBM MQ.

mq.queues.jmsMQQueueManagers[N].jmsMQPort

number

null

Le port IBMMQ.

mq.queues.jmsMQQueueManagers[N].jmsMQQueueManager

chaîne

null

Le nom du gestionnaire de files d'attente IBMMQ.

mq.queues.jmsMQQueueManagers[N].jmsMQSSLCipher

chaîne

null

La suite de chiffrement SSL IBMMQ. Un exemple pourrait être"*TLS12ORHIGHER". Reportez-vous à la documentation officielle TLS CipherSpecs et CipherSuites aux classes IBM MQ pour JMS pour plus de détails.

mq.queues.jmsMQQueueManagers[N].jmsMQUserid

chaîne

null

Le nom d'utilisateur IBMMQ.

mq.queues.non.jms.client

boolean

false

Indiquez si le client cible auquel envoyer des messages n'est pas JMS. Le format MQ natif sera utilisé pour les clients non-JMS tandis que le format RFH2 sera utilisé pour JMS.

4.5.0

mq.queues.rabbitMQHost

chaîne

null

Le nom d'hôte Rabbit MQ.

mq.queues.rabbitMQPassword

chaîne

null

Le mot de passe Rabbit MQ.

mq.queues.rabbitMQPort

number

null

Le port Rabbit MQ.

mq.queues.rabbitMQUsername

chaîne

null

L'utilisateur de Rabbit MQ.

mq.queues.rabbitMQVirtualHost

chaîne

null

Le nom d'hôte virtuel Rabbit MQ.

mq.queues.sqs.region

chaîne

eu-west-3

AWS Région du service AWS SQS MQ.

pgmDateFormat

chaîne

aaaa- MM-dd

Format de la date et de l'heure.

pgmTimeFormat

chaîne

HH.mm.ss

Le format horaire utilisé pour l'exécution des pgm (programmes).

pgmTimestampFormat

chaîne

aaaa- MM-dd-HH.mm.ss.SSSSSS

Format d'horodatage.

program.timeout

number

-1

Spécifie un délai d'attente en secondes pour toute program/transaction exécution. Passé ce délai, le système essaiera d'interrompre le programme.

qtemp.cleanup.threshold.hours

number

0

Pour spécifier quand qtemp.dblog est activé. Durée de vie de la partition DB (en heures).

qtemp.dblog

boolean

false

Activez ou non la journalisation de la base de données QTEMP.

qtemp.uuid.length

number

9

L'identifiant unique QTEMP est la longueur.

quartz.scheduler.stand-by-if-error

boolean

false

Spécifie s'il faut déclencher l'exécution de la tâche si le planificateur de tâches est en mode veille. Si c'est vrai, lorsque cette option est activée, l'exécution de la tâche n'est pas déclenchée.

query.useConcatCondition

boolean

false

Spécifie si la condition clé est créée par concaténation de clés ou non.

reportOutputPath

chaîne

/reports

Le chemin de sortie du rapport.

returnHttp5xxResponseForFailedSyncJob

boolean

false

Spécifie s'il faut renvoyer le code de réponse HTTP de la série 500 en cas d'échec de l'exécution synchronisée de la tâche.

4.10.0

rollbackOnRTE

boolean

false

Spécifie s'il faut annuler la transaction unitaire d'exécution implicite en cas d'exception d'exécution.

sctThreadLimit

long

5

La limite de threads pour le déclenchement de scripts.

server.servlet.session.timeout

chaîne

30 m

Spécifie la durée d'expiration de la session. Exemples : 60s (60 secondes), 4m (4 minutes), 4h (4 heures).

server.servlet.session.tracking-modes

chaîne

biscuit

Spécifie les modes de suivi de session à utiliser. Les valeurs possibles sonturl,cookie,ssl. Plusieurs valeurs peuvent être spécifiées en les séparant par des virgules. Remarque : lors du déploiement sur Tomcat, vous devez le définir cookies=false dans context.xml car Tomcat est prioritaire pour la configuration du mode de suivi.

spring.aws.application.credentials

chaîne

null

Chargez les AWS informations d'identification à partir du fichier de profils d'informations d'identification dans JICS.

spring.aws.client.bluesam.locks.redis.secret

chaîne

null

Spécifie l'ARN secret d'identification pour le cache Redis des verrous Bluesam, voir. AWS Les secrets d'exécution de Transform for Mainframe

spring.aws.client.bluesam.redis.secret

chaîne

null

Spécifie l'ARN secret d'identification pour le cache Bluesam Redis, voir. AWS Les secrets d'exécution de Transform for Mainframe

spring.aws.client.jcl.checkpoint.redis.secret

chaîne

null

Spécifie l'ARN secret d'identification pour le fournisseur de persistance Redis du mécanisme de point de contrôle JCL, voir. AWS Les secrets d'exécution de Transform for Mainframe

spring.aws.client.jics.queues.ts.redis.secret

chaîne

null

Spécifie l'ARN secret d'identification pour le serveur Redis JICS TS Queues, voir. AWS Les secrets d'exécution de Transform for Mainframe

spring.aws.client.jics.redis.secret

chaîne

null

Spécifie l'ARN secret d'identification pour la fabrique de connexions au serveur JICS Redis, voir. AWS Les secrets d'exécution de Transform for Mainframe

spring.jta.enabled

boolean

false

Clé standard Si le mode de prise en charge des sources de données n'est pas statique-xa, la configuration automatique des transactions Spring JTA doit être désactivée.

spring.session.store-type

chaîne

Aucune

Le cache de session pour les environnements à haute disponibilité. Les valeurs possibles sont none ouredis. La valeur par défaut estnone.

sqlCodePointShift

number

Facultatif. Le décalage de point de code SQL. Déplace le point de code pour les caractères de contrôle que nous pouvons rencontrer lors de la migration des données SGBDR existantes vers un SGBDR moderne. Par exemple, vous pouvez spécifier pour 384 qu'il corresponde au caractère \u0180 Unicode.

sqlConnectionAutoCommitEnabled

boolean

true

Active la validation automatique de la connexion en cours lors des opérations de réinitialisation de la connexion. Lorsque cette option est activée, valide automatiquement la connexion en cours avant de passer à une nouvelle connexion à une source de données dans des environnements non XA afin d'éviter toute instabilité de connexion. Lorsque cette option est désactivée, enregistre un message d'avertissement concernant des problèmes de connexion potentiels lors des opérations de réinitialisation.

4.10.0

sqlIntegerOverflowAllowed

boolean

false

Spécifie s'il faut autoriser le dépassement des entiers SQL, c'est-à-dire s'il est permis de placer des valeurs plus grandes dans la variable hôte.

startDefaultJob

chaîne

false

Spécifiez s'il faut initialiser la tâche par défaut lors de la première transaction.

stepFailWhenAbend

boolean

true

Spécifie s'il faut déclencher un arrêt en cas d'échec ou de fin d'exécution d'une étape.

stopExecutionWhenProgNotFound

boolean

true

Spécifie s'il faut arrêter l'exécution si aucun programme n'est trouvé. Si ce paramètre est défini surtrue, interrompt l'exécution si aucun programme n'est trouvé.

system.date.format

chaîne

MDY

Format de date système DATFMT.

---

system.date.separator

chaîne

/

Le séparateur de dates du système DATSEP.

Les valeurs possibles sont la barre oblique (`/`), le tiret (`—`), le point (`.`), la virgule (`,`) ou le blanc (``). La valeur doit être spécifiée entre guillemets doubles « ».

5,17,0

system.qdecfmt

chaîne

taskExecutor.allowCoreThreadTimeOut

boolean

false

Spécifie s'il faut autoriser le délai d'expiration des threads principaux dans JCIS. Cela permet une croissance et une réduction dynamiques, même en combinaison avec une file d'attente non nulle (étant donné que la taille maximale du pool n'augmentera que lorsque la file d'attente sera pleine).

taskExecutor.corePoolSize

number

5

Lorsqu'une transaction dans un terminal est initiée via un script groovy, un nouveau thread est créé. Utilisez ce paramètre pour configurer la taille du pool principal.

taskExecutor.maxPoolSize

number

10

Lorsqu'une transaction dans un terminal est initiée via un script groovy, un nouveau thread est créé. Utilisez ce paramètre pour configurer la taille maximale du pool (nombre maximum de threads parallèles).

taskExecutor.queueCapacity

number

50

Lorsqu'une transaction dans un terminal est initiée via un script groovy, un nouveau thread est créé. Utilisez ce paramètre pour configurer la taille de la file d'attente. (= nombre maximum de transactions en attente lorsqu'il taskExecutor.maxPoolSize est atteint)

tempFilesDirectory

chaîne

null

Spécifie le nom de l'emplacement du dossier des fichiers temporaires générés.

tempFolderPattern

chaîne

null

Spécifie un modèle qui sera utilisé pour créer dynamiquement le nom du dossier temporaire en fonction des informations prédéfinies et personnalisables suivantes.

HOST : le nom de l'hôte.

JOBID : l'identifiant de la tâche.

HASHCODE : le code de hachage du contexte de la tâche.

TIMESTAMP : le modèle à utiliser pour obtenir l'horodatage. Le nom cible du dossier temporaire est TMP_DIR_ {temp}. FolderPattern Par exemple, dans le cas du modèle suivant, le nom commencera par l'ID de la tâche et se terminera par le « timestamp » : temp FolderPattern : JOBID, host=XXXXX, HASHCODE, timestamp=YYYYMMDDHHMMSS. Si la propriété n'tempFolderPatternest pas ajoutée au fichier YAML ou si elle est vide, le nom du dossier temporaire sera « TMP_DIR_ » + this.hashCode () (). DefaultJobContext

uppercaseUserInput

boolean

true

Spécifie si les entrées utilisateur doivent être en majuscules.

useControlMVariable

boolean

false

Spécifie s'il faut utiliser la spécification Control-m pour le remplacement des variables.

xmlGeneratorPrettyFormat

boolean

true

Détermine le style de mise en forme de la sortie XML générée dans la XmlGenerator classe. Lorsque cette option est définie surtrue, la sortie XML est formatée selon une structure en retrait lisible par l'homme (joliment imprimée). Lorsque ce paramètre est défini surfalse, la sortie est dans un format compact sur une seule ligne, sans espace blanc supplémentaire.

4.8.0

Propriétés disponibles pour les applications Web facultatives

En fonction de votre application modernisée, vous devrez peut-être configurer une ou plusieurs applications Web facultatives qui prennent en charge les dépendances telles que z/OS AS/400, ou IMS/MFS. Les tableaux suivants contiennent la liste des key/value paramètres disponibles pour configurer chaque application Web facultative.

utilitaire gapwalk-pgm.war

Cette application Web optionnelle prend en charge les programmes Z/OS utilitaires.

Ce tableau fournit une vue exhaustive des key/values paramètres de cette application.

Clé Type Valeur par défaut Description Version de sortie

convertGraphicDataToFullWidth

boolean

true

Spécifie s'il faut convertir les données graphiques au format pleine largeur.

encoding

chaîne

ASCII

Encodage utilisé dans les programmes utilitaires. S'attend à un encodage valide CP1047IBM930,ASCII,,UTF-8.

forcedDate

chaîne

Force la date à la date indiquée, s'il y en a une.

forcedDateMode

chaîne

Spécifie le mode de date forcée. Lorsqu'elle est définie surHYBRID, la partie date est la date forcée configurée, mais la partie heure reflète l'heure réelle du système. S'applique uniquement si forcedDate cette option est également définie.

frozenDate

boolean

true

Spécifie s'il faut figer la date. S'applique uniquement si forcedDate cette option est également définie.

hasGraphic

boolean

false

Si l'utilitaire INFUTILB doit gérer les colonnes GRAPHIC DB2.

idcams.deleteFromAllSubfolders

boolean

false

Si la commande IDCAMS DELETE doit également supprimer les fichiers correspondants de chaque sous-dossier du répertoire des fichiers.

5,155,0

idcams.encoding.forced

chaîne

Encodage utilisé dans le programme utilitaire IDCAMS. S'attend à un encodage valide CP1047IBM930,ASCII,,UTF-8.

4.4.0

idcams.repro.failOnMissingOutput

boolean

false

S'il est défini sur true, IDCAMS REPRO échouera prématurément si un jeu de données Blusam en sortie, ayant une disposition SHR ou OLD, est manquant.

5,185,0

jcl.type

chaîne

mvs

Type de fichier .jcl. Les valeurs autorisées sontjcl/vse. Les PRINT/REPRO commandes de l'utilitaire IDCAMS renvoient 4 si le fichier est vide pour un jcl non vse.

load.applyRollback

boolean

false

Définissez ce paramètre pour true indiquer que vous souhaitez que le service annule les modifications apportées à la table s'il rencontre une erreur lors du chargement des données dans la base de données.

load.batchSize

number

0

Taille du lot de l'utilitaire de chargement.

load.format.dbDate

chaîne

aaaa- MM-dd

Format de base de données de l'utilitaire de chargement à utiliser.

load.format.dbTime

chaîne

HH:mm:ss

Durée d'utilisation de la base de données de l'utilitaire de chargement.

load.format.localDate

chaîne

ajouter. MM.yyyy\ dd/MM /aaaa \ aaaa- MM-dd

Format de date local de l'utilitaire de chargement à utiliser.

load.format.localTime

chaîne

HH:mm:ss\HH.mm.ss

Format d'heure locale de l'utilitaire de chargement à utiliser.

load.sqlCodePointShift

number

0 s

Le pointeur du code SQL pour l'utilitaire de chargement. Exécute le processus de changement de caractères. Obligatoire lorsque votre base de données cible provenant de DB2 est Postgresql.

logging.config

Chemin

chemin de classe : logback-utility.xml

Clé standard pour la référence au fichier de configuration de logback. D'autres clés de journalisation standard sont également disponibles.

primary.datasource -driver-class-name -url -username -password

Source de données Spring standard avec sous-clés

Contient les informations de connexion pour la base de données de l'application, si vous n'utilisez pas JNDI. Doit avoir la même configuration que dans le fichier YAML de l'application modernisé.

Alternativement, l'utilisation de AWS secrets est fortement encouragée, comme expliqué dansBase de données clients.

spring.datasource.primary.jndi-name

chaîne

jdbc/primary

Le nom JNDI (Java Naming And Directory Interface) de la source de données principale, si vous utilisez JNDI.

spring.jta.enabled

boolean

false

Clé standard Si le mode de prise en charge des sources de données n'est pas statique-xa, la configuration automatique des transactions Spring JTA doit être désactivée.

sysPunchEncoding

chaîne

ASCII

Le jeu de caractères de codage Syspunch. S'attend à un encodage valide CP1047IBM930,ASCII,,UTF-8.

systin.encoding

chaîne

ASCII

Le jeu de caractères de codage de l'ensemble de données du fichier SYSTIN. S'attend à un encodage valide CP1047IBM930,ASCII,,UTF-8.

4.5.0

treatLargeNumberAsInteger

boolean

false

Spécifie s'il faut traiter les grands nombres commeInteger. Ils sont traités comme BigDecimal par défaut.

unload.bmc.useInto

boolean

false

Spécifie s'il faut gérer le mot clé de contrôle INTO bmc pour l'utilitaire de déchargement.

unload.chunkSize

number

0

Taille du morceau utilisée pour l'utilitaire de déchargement.

unload.columnFiller

chaîne

espace

Le remplisseur de colonne utilitaire de déchargement.

unload.computeRecordSizeIfNull

boolean

false

Détermine s'il faut calculer la taille de l'enregistrement si elle n'est pas spécifiée. Si elle est spécifiée, la valeur reste inchangée.

unload.fetchSize

number

0

Vous permet de régler la taille de récupération lorsque vous manipulez des curseurs dans l'utilitaire de déchargement.

unload.format.date

chaîne

MM/dd/yyyy

S'il unload.useDatabaseConfiguration est activé, le format de date à utiliser dans l'utilitaire de déchargement.

unload.format.time

chaîne

HH.mm.ss

S'il unload.useDatabaseConfiguration est activé, le format d'heure à utiliser dans l'utilitaire de déchargement.

unload.format.timestamp

chaîne

aaaa- MM-dd-HH.mm.ss.SSSSSS

S'il unload.useDatabaseConfiguration est activé, le format d'horodatage à utiliser dans l'utilitaire de déchargement.

unload.nbi.whenNotNull

hexadécimal

00

La valeur NBI (Null Byte Indicator) à ajouter lorsque la valeur de la base de données n'est pas nulle.

unload.nbi.whenNull

hexadécimal

6F

La valeur NBI (Null Byte Indicator) à ajouter lorsque la valeur de la base de données est nulle.

unload.nbi.writeNullIndicator

boolean

false

Spécifie s'il faut écrire l'indicateur nul dans le fichier de sortie de déchargement.

unload.noPad

boolean

true

Indique que les champs de caractères de longueur variable (VARCHAR) doivent être déchargés sans aucun remplissage à la longueur maximale.

4.5.0

unload.sqlCodePointShift

number

0

Le pointeur du code SQL pour l'utilitaire de déchargement. Exécute le processus de changement de caractères. Obligatoire lorsque votre base de données cible provenant de DB2 est Postgresql.

unload.useDatabaseConfiguration

boolean

false

Spécifie s'il faut utiliser la configuration de date ou d'heure de application-main.yml dans l'utilitaire de déchargement.

unload.varCharIsNull

boolean

false

Utilisez ce paramètre dans le programme INFTILB. S'il est défini sur, tous les champs non nullables avec des valeurs vides (espace) renvoient une chaîne vide. true

zonedMode

chaîne

EBCDIC_STRICT

Mode de codage ou de décodage des types de données zonés. Les valeurs autorisées sontEBCDIC_STRICT/EBCDIC_MODIFIED/AS400.

gapwalk-cl-command.war

Cette application Web optionnelle prend en charge les programmes AS/400 utilitaires.

Ce tableau fournit une vue exhaustive des key/values paramètres de cette application.

Clé Type Valeur par défaut Description

commands-off

chaîne

Liste des commandes à désactiver, séparées par des virgules. Les valeurs autorisées sont PGM_BASICRCVMSG,SNDRCVF,CHGVAR,QCLRDTAQ,,RTVJOBA,ADDLFM,ADDPFM,RCVF,OVRDBF,DLTOVR,CPYF,SNDDTAQ. Utile lorsque vous souhaitez désactiver ou remplacer un programme existant. PGM_BASICest un programme AWS Transform for mainframe Runtime spécifique conçu à des fins de débogage.

encoding

chaîne

ASCII

Encodage utilisé dans les programmes utilitaires. S'attend à un encodage valide CP1047IBM930,ASCII,,UTF-8...

forcedDate

chaîne

Force la date à la date indiquée, s'il y en a une.

forcedDateMode

chaîne

Spécifie le mode de date forcée. Lorsqu'elle est définie surHYBRID, la partie date est la date forcée configurée, mais la partie heure reflète l'heure réelle du système. S'applique uniquement si forcedDate cette option est également définie.

logging.config

Chemin

chemin de classe : logback-utility.xml

Clé standard pour la référence au fichier de configuration de logback. D'autres clés de journalisation standard sont également disponibles.

primary.datasource + -driver-class-name + -url + -username + -password

Source de données Spring standard avec sous-clés

Contient les informations de connexion pour la base de données de l'application, si vous n'utilisez pas JNDI. Doit avoir la même configuration que dans le fichier YAML de l'application modernisé.

Alternativement, l'utilisation de AWS secrets est fortement encouragée, comme expliqué dansBase de données clients.

spring.datasource.primary.jndi-name

chaîne

jdbc/primary

Le nom JNDI (Java Naming And Directory Interface) de la source de données principale, si vous utilisez JNDI.

spring.jta.enabled

boolean

false

Clé standard Si le mode de prise en charge des sources de données n'est pas statique-xa, la configuration automatique des transactions Spring JTA doit être désactivée.

zonedMode

chaîne

EBCDIC_STRICT

Mode de codage ou de décodage des types de données zonés. Les valeurs autorisées sontEBCDIC_STRICT/EBCDIC_MODIFIED/AS400.

gapwalk-hierarchical-support.war

Cette application Web optionnelle prend en charge les IMS/MFS transactions.

Ce tableau fournit une vue exhaustive des key/values paramètres de cette application.

Clé Type Valeur par défaut Description

jhdb.backend

chaîne

Type de backend Jhdb. La valeur attendue est rdbms

jhdb.checkpointPersistence

chaîne

Aucune

Mode de persistance des points de contrôle. Les valeurs autorisées sontnone/add/end. addUtilisez-le pour conserver les points de contrôle lorsqu'un nouveau est créé et ajouté au registre. Utilisez le point de contrôle end trop persistant à l'arrêt du serveur. Toute autre valeur désactive la persistance. Notez que chaque fois qu'un nouveau point de contrôle est ajouté au registre, tous les points de contrôle existants seront sérialisés et le fichier sera effacé. Il ne s'agit pas d'un ajout aux données existantes du fichier. Ainsi, selon le nombre de points de contrôle, cela peut avoir des effets sur les performances.

jhdb.configuration.context.encoding

chaîne

L'encodage JHDB (base de données hiérarchique Java). Attend une chaîne de codage valideCP1047,IBM930,ASCII,UTF-8...

jhdb.keepParent

boolean

false

S'il faut conserver _parent et _logicalparent lors de l'insertion dans IMS. Lorsqu'il est défini sur true, l'appel IMS ISRT insère _parent et _logicalparent dans les colonnes de la base de données.

jhdb.query.timeout

int

-1

Spécifie un délai d'attente en secondes pour toute exécution de transaction jhdb. Passé ce délai, le système essaiera d'interrompre le programme. Aucun délai d'attente n'est défini si la valeur est -1 (par défaut).

jhdb.transaction.scope.programs

chaîne

liste des programmes à déclarer comme une transaction complète. Séparez chaque programme par une virgule (,). Exemples :PCP008,PCT008

logging.config

Chemin

chemin de classe : logback-utility.xml

Clé standard pour la référence au fichier de configuration de logback. D'autres clés de journalisation standard sont également disponibles.

metadata.datasource + -driver-class-name + -url + -username + -password + -type

chaîne

Source de données Spring standard avec sous-clés

Contient les informations de métadonnées de la base de données jhdb, y compris psbs, dbds et connections. Par ailleurs, l'utilisation de AWS secrets est fortement encouragée.

spring.jta.enabled

boolean

false

Clé standard Si le mode de prise en charge des sources de données n'est pas statique-xa, la configuration automatique des transactions Spring JTA doit être désactivée.

gapwalk-gs21.war

Utilisez cette application Web optionnelle pour exécuter les programmes de la plateforme Fujitsu GS21 dans votre environnement AWS Mainframe Modernization. Installez cette application uniquement si votre charge de travail modernisée inclut des programmes GS21.

Le tableau suivant décrit les paramètres clé-valeur pour cette application.

Clé Type Valeur par défaut Description

aim.sockets.socketConfigurations

liste

Aucune

Configure les connexions des sockets du module d'intégration d'applications (AIM). Chaque entrée est une configuration de serveur de socket ou une configuration de client de socket.

Clés d'entrée du serveur de socket : remote (nom de connexion), smqn (nom de file d'attente SMQN), port (port de socket).

Clés d'entrée du client Socket : remote (nom du serveur distant), targetName (nom du serveur cible), smqn (nom de la file d'attente SMQN), port (port local), targetPort (port cible), targetHost (IP cible).

datasource.gs21Ds + -driver-class-name + -url + -username + -password + -type

Source de données Spring standard avec sous-clés

Aucune

Stocke les informations de connexion pour la base de données GS21. Nous vous recommandons d'utiliser AWS Secrets Manager pour les informations d'identification de base de données. Pour de plus amples informations, veuillez consulter Base de données clients.

taskExecutor + -corePoolSize + -maxPoolSize + -queueCapacity + -allowCoreThreadTimeOut

Configuration de l'exécuteur Spring Thread Pool

Aucune

Configure l'exécuteur du pool de threads qui génère les processus AIM (tels que les SMQN, les gestionnaires de socket et les gestionnaires de réponses aux messages).

Propriétés disponibles pour l'application cliente

Votre application modernisée peut nécessiter des configurations de propriétés spécifiques pour l'application Spring cliente. Ces propriétés initialisent les beans à partir de classes contenues dans des fichiers JAR d'exécution. Le application-profile.yaml fichier, dans lequel la valeur du profil est définie lors de la génération de l'application, vous permet de configurer ces propriétés. Le tableau suivant répertorie les key/value paramètres disponibles pour configurer l'application Web cliente qui utilise des beans provenant de classes incluses dans le runtime Gapwalk.

Clé Type Valeur par défaut Description Version de sortie

blu4iv.dao.cache.enabled

boolean

false

Activez le In-memory cache.

4.8.0

blu4iv.dao.cache.enabledHits

boolean

false

Ajoutez le suivi du nombre de demandes au cache.

4.8.0

blu4iv.dao.cache.entries.fileIds

chaîne

La liste des tables de base de données à mettre en cache.

4.8.0

blu4iv.dao.cache.entries.programIds

chaîne

Identifiants du programme dans lesquels le cache doit être activé pour les tables spécifiées. Le cache est disponible pour tous les sous-programmes des piles d'exécution.

4.8.0

blu4iv.dao.cache.initMaxResults

number

10 000

Taille du cache.

4.8.0

blu4iv.dao.data.max

number

10

Taille du cache interne pour les opérations DAO en entrée. Ce cache existe au niveau du programme (instance unique).

4.9.0

blu4iv.dao.sort.function

chaîne

Le nom de la fonction de tri pour la base de données blu4iv.

4.9.0

blu4iv.dao.support

chaîne

JPA

Spécifie l'implémentation d'accès aux données à utiliser (JPA ou JDBC).

4.9.0

blu4iv.dtaara.library.disable

boolean

false

Contrôle l'utilisation de la bibliothèque dans le contexte des opérations des zones de données. Si ce paramètre est défini sur true, l'utilisation de la bibliothèque est désactivée pour les opérations de zone de données, mais cela n'affecte pas l'utilisation de QTemp. Si elle est définie sur false, la bibliothèque est prise en compte lors de l'exécution d'opérations CRUD pour la zone de données.

4.5.0

blu4iv.librarylist.enabled

boolean

false

Activez l'utilisation de la liste des bibliothèques pour résoudre une bibliothèque de fichiers.

4.10.0

blu4iv.librarylist.libraries

chaîne

La liste initiale des bibliothèques est ordonnée de gauche à droite.

4.10.0

Configuration du In-Memory cache pour les applications AS400

La fonction de cache en mémoire permet aux utilisateurs de mettre en cache des données en lecture seule dans la mémoire, ce qui améliore considérablement les performances des programmes gourmands en données. Le système de cache optimise les performances de trois manières : en chargeant les données uniquement lors du premier accès, en créant des cartes d'accès aux données à la demande et en stockant efficacement les données mises en cache à proximité de la mémoire du programme. Cette conception minimise la surcharge de mémoire tout en maximisant les améliorations de vitesse.

################################################################### # 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"]

Configurer la journalisation des accès à l'API

La fonction de journalisation des accès aux API enregistre des informations détaillées sur les demandes d'API adressées aux applications BAC, JAC et Gapwalk, afin de répondre aux exigences de sécurité en suivant qui a accédé à quoi et quand.

Clé Type Valeur par défaut Description Version de sortie

api.logging.enabled

boolean

false

Active la journalisation des accès aux API pour les applications BAC, JAC et Gapwalk. Lorsque cette option est activée, enregistre toutes les demandes d'API avec des informations détaillées.

5.0.0

Lorsque cette option est activée, l'utilisateur peut fournir une configuration de fichier de journalisation pour enregistrer les journaux d'accès à l'API à l'endroit choisi en utilisant le nom de l'enregistreur. api.access Les journaux peuvent inclure les champs MDC suivants :

Champ MDC Description

api-context

Où est hébergée l'API

api-date

La date et l'heure auxquelles la demande d'API a été effectuée

api-duration

Durée du traitement de la demande d'API (millisecondes)

api-host

L'adresse source d'où provient la demande d'API

api-method

Le type de requête HTTP effectuée (par exemple, GET, POST, DELETE,...)

api-name

Le endpoint/URI qui a été consulté

api-retcode

Le code d'état renvoyé une fois la demande d'API terminée

api-scheme

Protocole de transfert utilisé, par exemple HTTP ou HTTPS.

api-secure

La méthode de sécurité utilisée pour protéger l'appel d'API (par exemple, OAuth2, Token, Anonymous)

api-sessionid

Un identifiant unique pour la session de connexion en cours de l'utilisateur

api-user

Le nom d'utilisateur ou l'identifiant de la personne effectuant la demande d'API

Pour configurer un fichier journal dédié aux journaux d'accès aux API, ajoutez ce qui suit à votre configuration de journalisation :

<!-- 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>

Exemple de sortie du journal :

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

Configurer le suivi distribué

La fonction de traçage distribué permet un suivi des demandes de bout en bout entre GapWalk les applications en propageant TraceID et SpanID à partir des requêtes HTTP, ce qui permet de corréler les journaux tout au long du cycle de vie des demandes.

Clé Type Valeur par défaut Description Version de sortie

gapwalk.tracing.enabled

boolean

false

Permet le suivi distribué des GapWalk applications. Lorsque cette option est activée, propage TraceID et SpanID pour l'exécution de tâches par lots.

Lorsqu'elle est activée, la fonction de traçage propage le contexte de la trace. Les journaux peuvent inclure les champs MDC suivants :

Champ MDC Description

ID espagnol

Identifiant unique pour l'opération en cours dans la trace

traceId

Identifiant unique pour l'ensemble du flux de demandes sur tous les services et fils

Pour configurer le suivi distribué, mettez à jour votre configuration de journalisation afin d'inclure TraceID et SpanID dans le modèle de journal. Ajoutez ou mettez à jour la propriété suivante :

<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" />

Exemple de sortie du journal :

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