Enable properties for AWS Blu Age Runtime

logging.config

Path

classpath:logback-main.xml

Standard key for the reference to the logback configuration file. Other standard logging keys are available too.

spring.jta.enabled

boolean

false

Standard key. If the datasource support mode is not static-xa, spring JTA transactions autoconfiguration must be disabled.

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

Standard spring datasource with subkeys

Contains the connection information for the Jics database. Alternately, use of AWS secrets is strongly encouraged, as explained in JICS database.

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

Standard spring datasource with subkeys

Contains the connection information for the Jics database.

jildb.backend

string

Specifies the database type used in the Jildb backend, for example, Oracle.

jildb.record-hold-timeout

int

10000

Specifies the wait timeout period, in milliseconds, for the record holding mechanism in Jildb.

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

Standard spring datasource with subkeys

Contains the connection information for the Blusam database. Alternately, use of AWS secrets is strongly encouraged, as explained in Blusam database.

blu4iv.userspace.pageSize

int

4096

Specifies the page size which is used to allocate storage for user spaces. The size of the user space at any given time is always a multiple of this number specified.

blu4iv.userspace.store-type

string

memory

Specifies the store type that is used for user space registry. Supported values are memory and redis. If no store type is provided, memory is used by default.

blu4iv.userspace.redis.*

Supported Redis properties

Specifies configuration properties for the user spaces redis store, see Available Redis cache properties in AWS Blu Age Runtime.

blu4iv.dataaccess.useOldDaoDesign

boolean

false

A global flag that determines if the application is to use the old DAO architecture or the new. This is dependent on whether the DAO's were generated using old or new design.

bluesam.disabled

boolean

false

Whether to disable Blusam entirely.

bluesam.cache

string

If not set, the Blusam cache will not be used. Possible values (cache implementations) are cache and redis (Redis cache properties).

bluesam.maxBluesamDisablingThreadpoolSize

number

10

Specifies maximum threadpool size used to disable bluesam datasets for batch processing.

bluesam.bluesamStatusPollingInterval

number

1000

Specifies time (in millisecond) to wait between each iteration when polling bluesam status to check online activities.

bluesam.maxBluesamStatusPollingRetry

number

3

Specifies maximum number of retries when polling bluesam status is failing.

bluesam.checkBluesamStatus

boolean

false

Specifies whether or not to check bluesam dataset status before accessing it.

spring.aws.client.bluesam.redis.secret

string

null

Specifies the credential secret ARN for Bluesam Redis cache, see AWS Blu Age Runtime secrets.

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

string

null

Specifies the credential secret ARN for Bluesam locks Redis cache, see AWS Blu Age Runtime secrets.

forcedDate

string

Forces the date to the date provided if there is one.

clcommand.rtvmbrd.hasHeader

string

true

Specify if the files contain headers that should not be included when counting the rows.

frozenDate

boolean

true

Specifies whether to freeze the date. Applies only ifforcedDate is also set.

externalSort.threshold

datasize (example: 12 MB)

The sort threshold: when to switch to external (merge) sort.

blockSizeDefault

number

32760

The default block size to be used for BDW bytes.

jics.parameters.datform

string

MMDDYY

The date form.

jics.initList

string

The initialize JICS list, separated by commas. If present, it defines comma-separated names of lists to activate at Apache Tomcat startup among CICS lists. Example value: $UUU,DFH$IVPL,PEZ1. This will cascade to groups contained in those lists and their underlying resource definitions, which will then be visible to the runtime. Empty by default.

jics.parameters.applid

string

VELOCITY

The applied to identify application in JICS (at least 4 characters, no max length).

jics.parameters.sysid

string

CICS

The system identification (SYSID).

jics.parameters.eibtrmid

string

TERM

The terminal identifier (4 characters maximum, 1 minimum).

jics.parameters.userid

string

The user id (8 characters maximum, no minimum). When no value is provided (blank by default) the HTTP session id is used as the user id.

jics.parameters.username

string

MYUSERNAME

The username (10 characters maximum, 1 minimum).

jics.parameters.netname

string

MYNETNAME

The network name (8 characters maximum, 1 minimum).

jics.parameters.opid

string

XXX

The 3-character operator identification.

jics.parameters.jobname

string

MJOBNAME

The job name.

jics.parameters.sysname

string

SYSNAME

The AS400 system name (sysname).

jics.parameters.cwa.length

number

0

The length of the common work area (CWA).

jics.parameters.charset

string

CP037

JICS globally used character set.

jics.parameters.tsqimpl

string

bluesam

JICS Temporary Storage Queue (TSQ) implementation (allowed values arebluesam /memory /redis)

jics.queues.ts.redis.*

Supported Redis properties

Specifies configuration properties for the JICS TS Queues Redis server, see Supported Redis properties.

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

string

null

Specifies the credential secret ARN for JICS TS Queues Redis server, see AWS Blu Age Runtime secrets.

lockTimeout

number

500

The lock timeout, in milliseconds.

sqlCodePointShift

number

Optional. The sql code point shift. Shifts the codepoint for control characters that we might encounter when migrating legacy RDBMS data to a modern RDBMS. For example, you can specify384 to match Unicode character\u0180.

sqlIntegerOverflowAllowed

boolean

false

Specifies whether to allow the SQL integer overflow, meaning whether placing larger values in the host variable is allowed.

database.cursor.overflow.allowed

boolean

true

Specifies whether to allow the cursor overflow. Set totrue to perform a next call on the cursor whatever its position. Set tofalse to check whether the cursor is at the last position before performing a next call on cursor. Only enable if cursor is SCROLLABLE (SENSITIVE or INSENSITIVE).

reportOutputPath

string

/reports

The report output path.

server.servlet.session.tracking-modes

string

cookie

Specifies the session tracking modes to use. Possible values are url, cookie, ssl. Multiple values can be specified separated by commas. Note: When deploying on Tomcat, you need to set cookies=false in context.xml because Tomcat takes precedence for tracking mode configuration.

server.servlet.session.timeout

string

30m

Specifies the session timeout duration. Examples: 60s (60 seconds), 4m (4 minutes), 4h (4 hours).

spring.session.store-type

string

none

The session cache for high-availability environments. Possible values arenone orredis. Default isnone.

stopExecutionWhenProgNotFound

boolean

true

Specifies whether to stop running if a program isn't found. If set totrue, interrupts the run if a program is not found.

forceHR

boolean

false

Specifies whether to use Human Readable SYSPRINT, either on console or file output.

rollbackOnRTE

boolean

false

Specifies whether to rollback implicit run unit transaction on runtime exceptions.

sctThreadLimit

long

5

The thread limit for triggering scripts.

dataSimplifier.onInvalidNumericData

string

reject

How to react when decoding invalid numeric data. Allowed values arereject /toleratespaces /toleratespaceslowvalues /toleratemost. Default isreject.

dataSimplifier.doubleFloatingType

string

IEEE_754

The double floating type is the format used to encode and decode a floating-point number. Allowed values are IEEE_754 / HFP(for Hexadecimal Floating Point format). Default value is IEEE_754.

filesDirectory

string

The directory for batches input/output files.

ims.messages.extendedSize

boolean

false

Specifies whether to set the extended size on IMS messages.

defaultKeepExistingFiles

boolean

false

Specifies whether to set the dataset default previous value.

jics.db.ddlScriptLocation

string

The Jics DDL script location. Allows you to initiate the Jics database schema using a .sql script. Blank by default. For example,./jics/sql/jics.sql.

jics.db.schemaTestQueryLocation

string

Location of the sql file that should contain a unique query that returns the number of objects in the jics schema (if any).

jics.db.dataScriptLocation

string

Defines the path to SQL scripts used for initializing the JICS database. Accepts a comma-separated list of files and directories, allowing for multiple scripts and folders to be specified.

jics.db.dataTestQueryLocation

string

Location of a sql script containing a single sql query that is expected to return a count of objects (for example: counting number of records in the jics program table). If the count equals 0, database will be loaded using thejics.db.dataScriptLocation script, otherwise database load will be skipped.

jics.data.dataJsonInitLocation

string

jics.xa.agent.timeout

number

query.useConcatCondition

boolean

false

Specifies whether key condition is built by key concatenation or not.

system.qdecfmt

string

disposition.checkexistence

boolean

false

Specifies whether to release a check on file existence for Dataset with DISP SHR or OLD.

useControlMVariable

boolean

false

Specifies whether to use control-M specification for variable replacement.

card.encoding

string

CP1145

Card encoding: to be used withuseControlMVariable.

mapTransfo.prefixes

string

&,@,%%

List of prefixes to be used when transforming controlM variables. Each one separated by comma.

checkinputfilesize

boolean

false

Specifies whether to release a check if the file size is a multiple of record size.

stepFailWhenAbend

boolean

true

Specifies whether to raise an abend if a step fails or completes execution.

returnHttp5xxResponseForFailedSyncJob

boolean

false

Specifies whether to return HTTP response code of 500 series for unsuccessful synchronized job execution.

bluesam.fileLoading.commitInterval

number

100000

The bluesam commit interval.

uppercaseUserInput

boolean

true

Specifies whether user input must be in uppercase.

jhdb.lterm

string

Allow you to force a common logical terminal ID in the case of an IMS emulation. If not set then sessionId is used.

jhdb.identificationCardData

string

Used to hard-code some "operator identification card data" to the MID field designated by the CARD parameter. Blank by default, no input restriction.

encoding

string

ASCII

The encoding used in projects (not in groovy files). Expects a valid encodingCP1047,IBM930,ASCII,UTF-8...

cl.configuration.context.encoding

string

CP297

The encoding of CL files. Expects a valid encodingCP1047,IBM930,ASCII,UTF-8... Default value isCP297

cl.zonedMode

string

EBCDIC_STRICT

The mode for encoding or decoding control language (CL) commands. Allowed values areEBCDIC_STRICT /EBCDIC_MODIFIED /AS400.

ims.programs

string

List of IMS programs to use. Separate each parameter with a semicolon (;) and each transaction with a comma (,). For example:PCP008,PCT008;PCP054,PCT054;PCP066,PCT066;PCP068,PCT068;

jhdb.configuration.context.encoding

string

CP297

The JHDB (Java Hierarchical Database) encoding. Expects a valid encoding stringCP1047,IBM930,ASCII,UTF-8...

jhdb.metadata.extrapath

string

file:./setup/

A configuration parameter that specifies an extra, runtime-specific root folder for psbs and dbds folders.

jhdb.checkpointPersistence

string

none

The checkpoint persistence mode. Allowed values arenone /add /end. Useadd to persist checkpoints when a new one is created and added to the registry. Useend too persist checkpoint at server shutdown. Any other values disable the persistence. Note that each time a new checkpoint is added to the registry, all the existing checkpoints will be serialized and the file will be erased. It is not an append to the existing data in the file. So depending on the number of checkpoints, it can have some effects on performances.

jhdb.checkpointPath

string

file:./setup/

Ifjhdb.checkpointPersistence is notnone then this parameter allows you to setup the checkpoint persistence path (checkpoint.dat file storage location), all the checkpoints data contained in the registry are serialized and backed up in a file (checkpoint.dat) located in provided folder. Note that only checkpoint data (scriptId, stepId, database position and checkpoint area) are concerned by this backup.

jhdb.navigation.cachenexts

number

5000

The cache duration (in milliseconds) used in hierarchical navigation for an RDBMS.

jhdb.use-db-prefix

boolean

true

Specifies whether to enable a database prefix in hierarchical navigation for an RDBMS.

jhdb.query.limitJoinUsage

boolean

true

Specifies whether to use the limit join usage parameter on RDBMS graphs.

taskExecutor.corePoolSize

number

5

When a transaction in a terminal is initiated via a groovy script, a new thread is created. Use this parameter to setup the core pool size.

taskExecutor.maxPoolSize

number

10

When a transaction in a terminal is initiated via a groovy script, a new thread is created. Use this parameter to setup the max pool size (max number of parallel threads).

taskExecutor.queueCapacity

number

50

When a transaction in a terminal is initiated via a groovy script, a new thread is created. Use this parameter to setup the queue size. (= maximum number of pending transactions whentaskExecutor.maxPoolSize is reached)

taskExecutor.allowCoreThreadTimeOut

boolean

false

Specifies whether to allow core threads to time out in JCIS. This enables dynamic growing and shrinking even in combination with a non-zero queue (since the max pool size will only grow once the queue is full).

jics.runUnitLauncherPool.enable

boolean

false

Specifies whether to activate the run unit launcher pool in JICS.

jics.runUnitLauncherPool.size

number

20

The run unit launcher pool size in JICS.

jics.runUnitLauncherPool.validationInterval

number

1000

The interval between each run of the task that adjusts the size of the pool.

jics.runUnitLauncherPool.parallelism

number

2

The number of threads used to produce the missing instances in the queue when the adjustment task runs.

context.preconstruct.enable

boolean

false

Specifies whether to activate pre construction of program context.

context.preconstruct.frequencyInMillis

number

100

The interval between each run of the task that adjusts the size of the pool.

context.preconstruct.parallelism

number

5

The number of threads used to produce the missing instances in the queue when the adjustment task runs.

context.preconstruct.minInstances

number

2

The number of instances that will be created the first time a context is needed.

spring.aws.application.credentials

string

null

Load the AWS credentials from the credential profiles file in JICS.

jics.queues.sqs.region

string

eu-west-1

The AWS Region for Amazon Simple Queue Service, used in JICS.

jics.jcl.rt.encoding

string

CP037

The encoding of the JCL scripts written in the dedicated JICS queue.

jics.jcl.rt.queue

string

JICS

The name of the queue to which JCL scripts can be written line by line at runtime.

mq.queues.sqs.region

string

eu-west-3

The AWS Region for the AWS SQS MQ service.

quartz.scheduler.stand-by-if-error

boolean

false

Specifies whether to trigger job execution if the job scheduler is in standby mode. If true, When enabled job execution is not triggered.

databaseStatistics

boolean

false

Specifies whether to allow SQL builders to collect and display statistics information.

dbDateFormat

string

yyyy-MM-dd

The db target date format.

dbTimeFormat

string

HH:mm:ss

The db target time format.

dbTimestampFormat

string

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

The db target timestamp format.

dateTimeFormat

string

ISO

The dateTimeFormat describes how to spill database date time timestamp type into data simplifier entities. Allowed values areISO /EUR /EUR /USA /LOCAL

localDateFormat

string

List of local date formats.Separate each format with\.

localTimeFormat

string

List of local time formats. Separate each format with\

localTimestampFormat

string

List of local timestamp formats. Separate each format with\.

pgmDateFormat

string

yyyy-MM-dd

The date time format.

pgmTimeFormat

string

HH.mm.ss

The time format used for pgm (programs) execution.

pgmTimestampFormat

string

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

The timestamp format.

cacheMetadata

boolean

true

Specifies whether to cache database metadata.

forceDisableSQLTrimStringType

boolean

false

Specifies whether to disable trim of all sql string parameters.

fetchSize

number

The fetchSize value for cursors. Use when fetching data using chunks by load/unload utils.

check-groovy-file

boolean

true

Specifies whether to check groovy files content before registering.

qtemp.uuid.length

number

9

The QTEMP unique id length.

qtemp.dblog

boolean

false

Whether to enable QTEMP Database logging.

qtemp.cleanup.threshold.hours

number

0

To specify whenqtemp.dblog is enabled. The db partition lifetime (in hours).

invalidDataTolerence

boolean

true

Specifies whether invalid data is tolerated for packed type.

program.timeout

number

-1

Specifies a timeout for any program/transaction execution in seconds. After this time, the system will try to interrupt the program.

gapwalk.line.separator

string

null

Specifies line separator type in gapwalk. The allowed values are WIN (CRLF) / UNIX (LF) / LINUX (LF). Other values are ignored and System line.sepatator property is used.

enableActivePgmIdCache

boolean

false

Specifies whether to enable active program ID local cache. Use carefully this feature because JICS resources can be shared amongst programs and users. Those resources can be changed externally by any administrators and the local cache put in place might be invalidated.

mq.queues.default.syncpoint

boolean

false

Specifies the default behavior for MQ PUT commands when neither MQPMO_SYNCPOINT nor MQPMO_NO_SYNCPOINT are set. When set to true, it acts as MQPMO_SYNCPOINT and messages are NOT directly committed during the PUT command. When set to false, it acts as MQPMO_NO_SYNCPOINT and messages are directly committed during the PUT command.

dataSimplifier.byteRangeBoundsCheck

boolean

false

When set to true, it ensures that no ByteRange is created with improper values. The default is false.

file.stdoutIntoLogger

boolean

false

Specifies whether to enable writing to logger instead of the default system output stream in the default SYSPRINT and SYSPUNCH files.

tempFilesDirectory

string

null

Specifies the name of the folder location of the temporary files that are generated.

cleanTempFilesDirectoryAtStartup

boolean

true

Specifies whether to purge the contents of the temporary files folder at application startup.

tempFolderPattern

string

null

Specifies a pattern that will be used to dynamically build the name of the temporary folder based on the following predefined and customizable information.

HOST: the host name.

JOBID: the ID of the job.

HASHCODE: the hash code of the job context.

TIMESTAMP: the pattern to use when getting the timestamp. Target name of the temporary folder is TMP_DIR_{tempFolderPattern}. For example, in the case of the following pattern, the name will start with the job ID and end with the “timestamp”: tempFolderPattern: JOBID,HOST=xxxxx,HASHCODE,TIMESTAMP=yyyymmddhhmmss. If the property tempFolderPattern is not added to the YAML file or is empty, the name of the temporary folder will be "TMP_DIR_" + this.hashCode() (DefaultJobContext).

database.cursor.raise.already.opened.error

boolean

false

Specifies whether to enable raising SQLCODE error 502 when an already opened cursor is opening.

jics.spool.smtp.hostname

string

null

Specifies the SMTP server host. Example: smtp.xxx.com

jics.spool.smtp.port

string

null

Specifies the SMTP server port. Example: 25

jics.spool.smtp.password

string

null

Specifies the login password of the SMTP server.

jics.spool.smtp.username

string

null

Specifies the username of the SMTP server.

jics.spool.smtp.debug

boolean

false

Specifies the debug mode for the SMTP server.

gapwalk-application.security

string

disabled

Toggle global security configuration (XSS, CORS, CSRF, OAUTH authentication...). Allowed values are disabled and enabled.

gapwalk-application.identity

string

null

Global authentication method. Recommended value is oauth. Allowed values are json and oauth. This option is required when gapwalk-application.security is enabled.

gapwalk-application.security.issuerUri

string

null

The issuer URI of the identity provider (IdP). This option is required when gapwalk-application.identity is oauth.

gapwalk-application.security.allowedOrigins

string[]

null

The list of origins to allow. This option requires gapwalk-application.identity to be set to oauth.

gdgDirectoryPath

string

output/gdg

GDG directory path is the directory where the gdg files are stored.

gapwalk-application.security.customAllowedHeaders

string[]

null

The list of custom headers to allow. This option requires gapwalk-application.identity to be set to oauth.

listOfMDCUrlParams

string

null

The list of URL parameters to add to the MDC when executing Groovy batch script.

gapwalk-application.security.claimGroupName

string

cognito:groups

The claim attribute that contains the list of all the groups a user belongs to. Use cognito:groups for Amazon Cognito, or any other string for a foreign IdP.

gapwalk-application.security.userAttributeName

string

username

The claim attribute name used to identify a user request. Use username for Amazon Cognito, preferred_username for Keycloak, or any other string for a foreign IdP.

gapwalk-application.defaultSuperAdminUserName

string

sadmin

When gapwalk-application.security is disabled, specifies the default local super user name.

gapwalk-application.defaultSuperAdminUserPwd

string

sadmin

When gapwalk-application.security is disabled, specifies the default local super user password.

gapwalk-application.security.filterURIs

string

disabled

Toggle filtering URIs configuration. Allowed values are disabled and enabled.

gapwalk-application.security.blockedURIs

string[]

null

The list of URIs to block. This option is required when gapwalk-application.security.filterURIs is enabled.

jics.redis.*

Supported Redis properties

Specifies configuration properties for the JICS Redis server connection factory, see Supported Redis properties.

spring.aws.client.jics.redis.secret

string

null

Specifies the credential secret ARN for JICS Redis server connection factory, see AWS Blu Age Runtime secrets.

jcl.checkpoint.enabled

boolean

false

Specifies if JCL checkpoint mechanism is enabled to allow job restart. JCL checkpoints are created and saved to the in-memory registry at the start of each step or main program invocation. All the step level checkpoints are persisted at the end of the job, if persistence provider is defined.

jcl.checkpoint.expireTimeout

number

-1

Specifies time duration to retain JCL checkpoints in the persistence provider or in-memory registry.

jcl.checkpoint.expireTimeoutUnit

string

SECONDS

Specifies time duration unit for the jcl.checkpoint.expireTimeout property. Supported enum constant values: java.util.concurrent.TimeUnit.

jcl.checkpoint.provider

string

null

Specifies JCL checkpoint mechanism persistence provider. Allowed values are redis.

jcl.checkpoint.redis.*

Supported Redis properties

Specifies configuration properties for JCL checkpoint mechanism's REDIS persistence provider, see Supported Redis properties.

job.default.encoding

string

CP1047

Specifies the default encoding which is used to initialize the job level storage. For example, switches in BLU4IV application uses this encoding to initialize to zeroes.

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

string

null

Specifies the credential secret ARN for JCL checkpoint mechanism's Redis persistence provider, see AWS Blu Age Runtime secrets.

gapwalk.ssl.enabled

boolean

false

Indicated to set the following gapwalk.ssl.* properties to the current JVM system properties if there are not already set at application start.

gapwalk.ssl.trustStore

string

null

Set the value to the system property javax.net.ssl.trustStore if not already set at application start.

gapwalk.ssl.trustStorePassword

string

null

Set the value to the system property javax.net.ssl.trustStorePassword if not already setup at application start. Alternately, use of AWS secrets is strongly encouraged, as explained in Secret manager for SSL password settings.

gapwalk.ssl.trustStoreType

string

null

Set the value to the system property javax.net.ssl.trustStoreType if not already setup at application start.

gapwalk.ssl.keyStore

string

null

Set the value to the system property javax.net.ssl.keyStore if not already setup at application start.

gapwalk.ssl.keyStorePassword

string

null

Set the value to the system property javax.net.ssl.keyStorePassword if not already setup at application start. Alternately, use of AWS secrets is strongly encouraged, as explained in Secret manager for SSL password settings.

mq.queues

string

sqs

Specifies which supported queue brocker to use among sqs using Amazon SQS, rabbitmq using on-prem Rabbit MQ or jms using on-prem IBMMQ.

mq.queues.jmsMQQueueManagers[N]

When mq.queues is jms, enables to specify an IBM MQ connection list. mq.queues.jmsMQQueueManagers[0] for the first connection, mq.queues.jmsMQQueueManagers[1] for the second and so on.

mq.queues.jmsMQQueueManagers[N].jmsMQQueueManager

string

null

The IBMMQ queue manager name.

mq.queues.jmsMQQueueManagers[N].jmsMQAppName

string

null

The IBMMQ application name.

mq.queues.jmsMQQueueManagers[N].jmsMQChannel

string

null

The IBMMQ channel name.

mq.queues.jmsMQQueueManagers[N].jmsMQHost

string

null

The IBMMQ hostname.

mq.queues.jmsMQQueueManagers[N].jmsMQPort

number

null

The IBMMQ port.

mq.queues.jmsMQQueueManagers[N].jmsMQUserid

string

null

The IBMMQ user name.

mq.queues.jmsMQQueueManagers[N].jmsMQPassword

string

null

The IBMMQ user password. Alternately, use of AWS secrets is strongly encouraged, as explained in Secret manager for IBM MQ password settings.

mq.queues.jmsMQQueueManagers[N].jmsMQMaxPoolSize

number

0

The IBMMQ maximum pool size . With 0, an infinite number of physical connections are enabled.

mq.queues.jmsMQQueueManagers[N].jmsMQSSLCipher

string

null

The IBMMQ SSL cipher suite. An example could be "*TLS12ORHIGHER". Refer to the official documentation TLS CipherSpecs and CipherSuites in IBM MQ classes for JMS for more details.

mq.queues.non.jms.client

boolean

false

Indicate whether target client for sending messages to is non-JMS. Native MQ format will be used for non-JMS client while RFH2 format will be used for JMS.

mq.queues.rabbitMQHost

string

null

The Rabbit MQ hostname.

mq.queues.rabbitMQVirtualHost

string

null

The Rabbit MQ virtual hostname.

mq.queues.rabbitMQPort

number

null

The Rabbit MQ port.

mq.queues.rabbitMQUsername

string

null

The Rabbit MQ user.

mq.queues.rabbitMQPassword

string

null

The Rabbit MQ password.

mf.runtime.switch.N

boolean

true

Enables null insertion for MF nature line-sequential files.

mf.runtime.switch.T

boolean

false

Enables insertion of tab characters in MF nature line-sequential files.

gapwalk.database.support.useSavePointToRestoreFail

boolean

false

Enables transaction recovery in case of failure by using savepoints on insert queries. Enabling this property may impact database performance. You can override this setting for specific queries using the query-to-database mapping configuration.

xmlGeneratorPrettyFormat

boolean

true

Determines the formatting style of the generated XML output within the XmlGenerator class. When set to true, the XML output is formatted in a human-readable, indented structure (pretty-printed). When set to false, the output is in a compact, single-line format without additional whitespace.

gapwalk.database.metadata.schema-inclusion.enabled

boolean

false

Enables a memory optimization feature that control which database schemas are cached by a application. This configuration helps reduce memory footprint while maintaining system stability by intelligently managing schema metadata. It automatically includes some common database system schemas which maybe required for proper operation.

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

list<String>

null

Defines a list of schemas that should be cached.

sqlConnectionAutoCommitEnabled

boolean

true

Enables automatic commit of current connection during connection reset operations. When enabled, automatically commits the current connection before switching to a new datasource connection in non-XA environments to prevent connection instability. When disabled, logs a warning message about potential connection issues during reset operations.

gapwalk.post.script.mediatype.json

boolean

false

Specifies whether the Content-Type header of the response from endpoint /post/script/{scriptId:.+} is set to application/json, depending on the value of a boolean variable. If set to false, the default is text/plain; charset=utf-8.

startDefaultJob

string

false

Specify whether to initialize default job at first transaction.

gapwalk.cobol.cblqda.enabled

boolean

false

Enables a CBLQDA feature that controls QSAM files' dynamic allocation during an OPEN statement. This configuration helps to dynamically allocate temporary files declared in the program, even if the files are not defined in the JCL script.

mq.queues.jms.connectionfactory.*

Supported Atomikos connection factory properties

Specifies configuration properties for the JMS MQ connection pool.

logging.config

Path

classpath:logback-utility.xml

Standard key for the reference to the logback configuration file. Other standard logging keys are available too.

spring.jta.enabled

boolean

false

Standard key. If the datasource support mode is not static-xa, spring JTA transactions auto configuration must be disabled.

spring.datasource.primary.jndi-name

string

jdbc/primary

The JNDI name (Java Naming And Directory Interface) for the primary datasource, if using JNDI.

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

Standard spring datasource with subkeys

Contains the connection information for the application database, if not using JNDI. Must have the same configuration as in the modernized application YAML file.

Alternately, use of AWS secrets is strongly encouraged, as explained in Client database.

encoding

string

ASCII

The encoding used in utility programs. Expects a valid encoding CP1047,IBM930,ASCII,UTF-8.

sysPunchEncoding

string

ASCII

The syspunch encoding character set. Expects a valid encodingCP1047,IBM930,ASCII,UTF-8.

systin.encoding

string

ASCII

The encoding character set of SYSTIN file dataset. Expects a valid encodingCP1047,IBM930,ASCII,UTF-8.

zonedMode

string

EBCDIC_STRICT

The mode for encoding or decoding zoned data types. Allowed values areEBCDIC_STRICT /EBCDIC_MODIFIED /AS400.

idcams.encoding.forced

string

The encoding used in IDCAMS utility program. Expects a valid encoding CP1047, IBM930, ASCII, UTF-8.

unload.chunkSize

number

0

Chunk size used for unload utility.

unload.computeRecordSizeIfNull

boolean

false

Determines whether to compute the record size if not specified. If specified, the value remains unchanged.

unload.sqlCodePointShift

number

0

The SQL code pointshift for unload utility. Runs the shifting characters process. Required when your target database from DB2 is Postgresql.

unload.columnFiller

string

space

The unload utility column filler.

unload.varCharIsNull

boolean

false

Use this parameter in INFTILB program, if set totrue then all not nullable fields with blank (space) values returns an empty string.

unload.useDatabaseConfiguration

boolean

false

Specifies whether to use the date or time configuration from application-main.yml in unload utility.

unload.format.date

string

MM/dd/yyyy

Ifunload.useDatabaseConfiguration is enabled, the date format to use in the unload utility.

unload.format.time

string

HH.mm.ss

Ifunload.useDatabaseConfiguration is enabled, the time format to use in the unload utility.

unload.format.timestamp

string

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

Ifunload.useDatabaseConfiguration is enabled, the timestamp format to use in the unload utility.

unload.nbi.whenNull

hexadecimal

6F

The Null Byte Indicator (NBI) value to add when value from database is null.

unload.nbi.whenNotNull

hexadecimal

00

The Null Byte Indicator (NBI) value to add when value from database is not null.

unload.nbi.writeNullIndicator

boolean

false

Specifies whether to write out the null indicator in the unload output file.

unload.bmc.useInto

boolean

false

Specifies whether to handle INTO bmc control keyword for unload utility.

unload.fetchSize

number

0

Allows you to tune the fetch size when handling cursors in the unload utility.

unload.noPad

boolean

true

Indicates that variable-length character (VARCHAR) fields are to be unloaded without any padding to the maximum length.

treatLargeNumberAsInteger

boolean

false

Specifies whether to treat large numbers asInteger. They are treated asBigDecimal by default.

load.batchSize

number

0

The load utility batch size.

load.format.localDate

string

dd.MM.yyyy\dd/MM/yyyy\yyyy-MM-dd

The load utility local date format to use.

load.format.localTime

string

HH:mm:ss\HH.mm.ss

The load utility local time format to use.

load.format.dbDate

string

yyyy-MM-dd

The load utility database format to use.

load.format.dbTime

string

HH:mm:ss

The load utility database time to use.

load.sqlCodePointShift

number

0s

The SQL code pointshift for load utility. Runs the shifting characters process. Required when your target database from DB2 is Postgresql.

load.applyRollback

boolean

false

Set this parameter to true to indicate that you want the service to roll back table changes if it encounters an error while loading data into the database.

forcedDate

string

Forces the date to the date provided if there is one.

frozenDate

boolean

true

Specifies whether to freeze the date. Applies only ifforcedDate is also set.

jcl.type

string

mvs

.jcl file type. Allowed values arejcl /vse. The IDCAMS utility PRINT/REPRO commands return 4 if the file is empty for non-vse jcl.

hasGraphic

boolean

false

Whether the INFUTILB utility needs to handle GRAPHIC DB2 columns.

convertGraphicDataToFullWidth

boolean

true

Specifies whether to convert graphic data to full-width format.

logging.config

Path

classpath:logback-utility.xml

Standard key for the reference to the logback configuration file. Other standard logging keys are available too.

spring.jta.enabled

boolean

false

Standard key. If the datasource support mode is not static-xa, spring JTA transactions auto configuration must be disabled.

spring.datasource.primary.jndi-name

string

jdbc/primary

The JNDI name (Java Naming And Directory Interface) for the primary datasource, if using JNDI.

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

Standard spring datasource with subkeys

Contains the connection information for the application database, if not using JNDI. Must have the same configuration as in the modernized application YAML file.

Alternately, use of AWS secrets is strongly encouraged, as explained in Client database.

encoding

string

ASCII

The encoding used in utility programs. Expects a valid encodingCP1047,IBM930,ASCII,UTF-8...

zonedMode

string

EBCDIC_STRICT

The mode for encoding or decoding zoned data types. Allowed values areEBCDIC_STRICT /EBCDIC_MODIFIED /AS400.

commands-off

string

List of commands to turn off, separated by comma. Allowed values arePGM_BASIC,RCVMSG,SNDRCVF,CHGVAR,QCLRDTAQ,RTVJOBA,ADDLFM,ADDPFM,RCVF,OVRDBF,DLTOVR,CPYF,SNDDTAQ. Useful when you want to disable or overwrite an existing program. PGM_BASIC is a specific AWS Blu Age Runtime program designed for debugging purposes.

forcedDate

string

Forces the date to the date provided if there is one.

logging.config

Path

classpath:logback-utility.xml

Standard key for the reference to the logback configuration file. Other standard logging keys are available too.

spring.jta.enabled

boolean

false

Standard key. If the datasource support mode is not static-xa, spring JTA transactions auto configuration must be disabled.

jhdb.configuration.context.encoding

string

The JHDB (Java Hierarchical Database) encoding. Expects a valid encoding stringCP1047,IBM930,ASCII,UTF-8...

jhdb.checkpointPersistence

string

none

The checkpoint persistence mode. Allowed values arenone /add /end. Useadd to persist checkpoints when a new one is created and added to the registry. Useend too persist checkpoint at server shutdown. Any other values disable the persistence. Note that each time a new checkpoint is added to the registry, all the existing checkpoints will be serialized and the file will be erased. It is not an append to the existing data in the file. So depending on the number of checkpoints, it can have some effects on performances.

jhdb.keepParent

boolean

false

Whether to keep _parent and _logicalparent during IMS insertion. When set to true the IMS ISRT call will insert _parent and _logicalparent into database columns.

jhdb.query.timeout

int

-1

Specifies a timeout for any jhdb transaction execution in seconds. After this time, the system will try to interrupt the program. No timeout is set if the value is -1 (default).

jhdb.backend

string

Jhdb backend type. Expected value is rdbms

jhdb.transaction.scope.programs

string

list of programs to be declared as a whole transaction. Separate each program with a comma (,). For example:PCP008,PCT008

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

string

Standard spring datasource with subkeys

Contains the metadata information for the jhdb database, including psbs, dbds, connections. Alternately, use of AWS secrets is strongly encouraged.

blu4iv.dtaara.library.disable

boolean

false

Controls the usage of library in the context of data area operations. If set to true, library usage is disabled for data area operations, but this does not affect the usage of QTemp. If set to false, library is considered when performing CRUD operations for data area.

blu4iv.dtaara.library.disable

boolean

false

Controls the usage of library in the context of data area operations. If set to true, library usage is disabled for data area operations, but this does not affect the usage of QTemp. If set to false, library is considered when performing CRUD operations for data area.

blu4iv.dao.data.max

number

10

The size of the internal cache for input DAO operations. This cache exists at the program level (single instance).

blu4iv.dao.sort.function

string

The sort function name for the blu4iv database.

blu4iv.dao.support

string

JPA

Specifies the data access implementation to use (JPA or JDBC).

blu4iv.dao.cache.enabled

boolean

false

Enable the In-memory cache.

blu4iv.dao.cache.enabledHits

boolean

false

Add the tracking of number of requests to the cache.

blu4iv.dao.cache.initMaxResults

number

10000

The size of the cache.

blu4iv.dao.cache.entries.fileIds

string

The list of database tables to be cached.

blu4iv.dao.cache.entries.programIds

string

The program's identifiers where the cache should be activated for the specified tables. The cache is available for all sub-programs in the execution stacks.

blu4iv.librarylist.enabled

boolean

false

Enable the use of the library list to resolve a file library.

blu4iv.librarylist.libraries

string

The initial list of libraries ordered from left to right.

api.logging.enabled

boolean

false

Enables API access logging for BAC, JAC, and Gapwalk applications. When enabled, logs all API requests with details.

api-date

The date and time when the API request was made

api-duration

How long it took to process the API request (milliseconds)

api-host

The source address that the API request came from

api-context

Where the API is hosted

api-user

The username or identifier of the person making the API request

api-sessionid

A unique identifier for the user's current login session

api-scheme

The transfer protocol used, for example, HTTP or HTTPS.

api-name

The endpoint/URI that was accessed

api-retcode

The status code returned after the API request completed

api-secure

The security method used to protect the API call (e.g., OAuth2, Token, Anonymous)

api-method

The type of HTTP request made (e.g., GET, POST, DELETE, ...)