Enable properties for AWS Transform for mainframe Runtime

blockSizeDefault

number

32760

The default block size to be used for BDW bytes.

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.

blu4iv.userspace.batchThreshold

int

1

Specifies the number of update or set operations on a userspace after which the userspace is persisted in an external data repository.

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.redis.*

Supported Redis properties

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

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.

bluesam.bluesamStatusPollingInterval

number

1000

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

bluesam.cache

string

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

bluesam.checkBluesamStatus

boolean

false

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

bluesam.datasetPrefetchWindowSize

string[]

Specifies per-dataset prefetch window size overrides. Each entry format: "datasetName:size". If a dataset is not listed, it falls back to the global bluesam.prefetchWindowSize value.

Note:

- Do not add spaces around the colon separator.

- Dataset names containing | are supported (uses last colon as delimiter).

- Wrap entries in double quotes or ensure no spaces in the entry.

- Example: "fileset1|MYFILE:10000"

bluesam.disabled

boolean

false

Whether to disable Blusam entirely.

bluesam.fileList

string[]

Specifies the list of bluesam dataset to be cached during open.

Note:

- This parameter is only effective when bluesam.openWarmUp is set to false.

5.1.0

bluesam.fileLoading.commitInterval

number

100000

The bluesam commit interval.

bluesam.maxBluesamDisablingThreadpoolSize

number

10

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

bluesam.maxBluesamStatusPollingRetry

number

3

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

bluesam.metadataWarmUpFileList

string[]

Specifies the list of bluesam datasets whose index metadata will be pre-loaded into a permanent in-memory cache at application startup.

Note:

- Indexes are loaded on ApplicationReadyEvent and persist for the full application lifecycle.

- Only effective for large datasets.

bluesam.openWarmUp

boolean

false

Specifies whether to cache any bluesam datasets during open.

Warning: Breaking Change in version 5.1.0

- Default value changed from true to false.

5.1.0

bluesam.prefetchWindowMultiples

int

5

Specifies the multiplier for prefetch window size to determine maximum prefetch window capacity. The maximum capacity is calculated as prefetchWindowSize × prefetchWindowMultiples. This property is only effective when using Redis cache.

bluesam.prefetchWindowSize

int

1000

Specifies the number of records to prefetch and cache in memory for Redis cache optimization. This property is only effective when using Redis cache.

bluesam.redis.batchClearSize

int

1000

Batch size for Redis cache clear operations when bluesam.redis.enableBatchClear is enabled.

bluesam.redis.deleteAllBatchSize

int

1500

Batch size for Redis deleteAll operations to optimize performance when working with large datasets.

bluesam.redis.enableBatchClear

boolean

false

Enable batch processing for Redis cache clear operations when working with large datasets.

bluesam.redis.readBatchSize

int

1500

Batch size for Redis cache read operations (bulk read from cache by IDs).

bluesam.sizesCleanUpThreshold

int

1000

Maximum number of entries retained in the internal offset-tracking map per data set for large data sets (LargeKSDS, LargeESDS) during concurrent multi-threaded writes. When the map exceeds this threshold, it is trimmed to the 10 most recent entries to prevent heap exhaustion while preserving enough entries to avoid NullPointerException from concurrent thread access. Reduce this value if heap pressure is observed during high-volume large dataset bulk loads.

bluesam.warmUpMetadataCacheLimit

long

0

Maximum number of index entries allowed in the metadata warm-up cache. Set to 0 for unlimited.

Note:

- This is a global limit across all datasets configured in bluesam.metadataWarmUpFileList.

- When the limit is reached, additional indexes are skipped with a warning log.

cacheMetadata

boolean

true

Specifies whether to cache database metadata.

card.encoding

string

CP1145

Card encoding: to be used withuseControlMVariable.

check-groovy-file

boolean

true

Specifies whether to check groovy files content before registering.

checkinputfilesize

boolean

false

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

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.

clcommand.rtvmbrd.hasHeader

string

true

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

cleanTempFilesDirectoryAtStartup

boolean

true

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

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

number

2

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

context.preconstruct.parallelism

number

5

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

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

database.cursor.raise.already.opened.error

boolean

false

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

databaseStatistics

boolean

false

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

dataSimplifier.byteRangeBoundsCheck

boolean

false

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

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.

dataSimplifier.numproc

string

PFD

numproc compiler specification. Allowed values are PFD/NOPFD/MIG/. Default is PFD.

dataSimplifier.onInvalidNumericData

string

reject

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

dataSimplifier.zeroInvalidBcdNibbles

boolean

true

When set to true, bytes containing invalid BCD nibbles (hex digits A-F in digit positions) are treated as 00 during packed decimal decode. The default is true.

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.

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.

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

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.

defaultKeepExistingFiles

boolean

false

Specifies whether to set the dataset default previous value.

disposition.checkexistence

boolean

false

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

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.

encoding

string

ASCII

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

externalSort.threshold

datasize (example: 12 MB)

The sort threshold: determines when the system should switch from in-memory to external merge sorting using temporary files on the file system. If not specified (default=null), the threshold is set to half of the available memory at each new sort task. To estimate the available memory, a call to System.gc() is performed.

fetchSize

number

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

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.

filesDirectory

string

The directory for batches input/output files.

forcedDate

string

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

forceDisableSQLTrimStringType

boolean

false

Specifies whether to disable trim of all sql string parameters.

forceHR

boolean

false

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

frozenDate

boolean

true

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

forcedDateMode

string

Specifies the forced date mode. When set to HYBRID, the date portion is the configured forced date but the time portion reflects the actual system time. Applies only if forcedDate is also set.

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

string

disabled

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

gapwalk-application.security.allowedOrigins

string[]

null

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

gapwalk-application.security.blockedURIs

string[]

null

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

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

string[]

null

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

gapwalk-application.security.filterURIs

string

disabled

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

gapwalk-application.security.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.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.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.

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.

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.

gapwalk.io.sequential.readBufferSize

integer

8192

Sets the buffer size (in bytes) for BufferedInputStream when reading sequential files. Increasing this value reduces the number of I/O read operations, which can improve performance when reading large files from network-attached storage such as Amazon EFS.

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.

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.

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

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.

gdgDirectoryPath

string

output/gdg

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

ims.messages.extendedSize

boolean

false

Specifies whether to set the extended size on IMS messages.

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;

invalidDataTolerence

boolean

true

Specifies whether invalid data is tolerated for packed type.

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.

jcl.nullJclEof

boolean

true

Specifies how null JCL statements (//) are handled during job execution. When true, // terminates the job immediately (EOF mode). When false, // is treated as a null statement and execution continues (IGNORE mode).

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.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.configuration.context.encoding

string

CP297

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

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.

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.metadata.extrapath

string

file:./setup/

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

jhdb.navigation.cachenexts

number

5000

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

jhdb.query.limitJoinUsage

boolean

true

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

jhdb.use-db-prefix

boolean

true

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

jics.data.dataJsonInitLocation

string

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

jics.parameters.applid

string

VELOCITY

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

jics.parameters.charset

string

CP037

JICS globally used character set.

jics.parameters.cwa.length

number

0

The length of the common work area (CWA).

jics.parameters.datform

string

MMDDYY

The date form.

jics.parameters.eibtrmid

string

TERM

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

jics.parameters.jobname

string

MJOBNAME

The job name.

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

string

CICS

The system identification (SYSID).

jics.parameters.sysname

string

SYSNAME

The AS400 system name (sysname).

jics.parameters.tsqimpl

string

bluesam

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

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.queues.sqs.region

string

eu-west-1

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

jics.queues.ts.redis.*

Supported Redis properties

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

jics.redis.*

Supported Redis properties

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

jics.runUnitLauncherPool.enable

boolean

false

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

jics.runUnitLauncherPool.parallelism

number

2

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

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.spool.smtp.debug

boolean

false

Specifies the debug mode for the SMTP server.

jics.spool.smtp.hostname

string

null

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

jics.spool.smtp.password

string

null

Specifies the login password of the SMTP server.

jics.spool.smtp.port

string

null

Specifies the SMTP server port. Example: 25

jics.spool.smtp.username

string

null

Specifies the username of the SMTP server.

jics.xa.agent.timeout

number

jildb.backend

string

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

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

Standard spring datasource with subkeys

Contains the connection information for the Jics database.

jildb.record-hold-timeout

int

10000

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

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.

listOfMDCUrlParams

string

null

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

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

lockTimeout

number

500

The lock timeout, in milliseconds.

logging.config

Path

classpath:logback-main.xml

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

mapTransfo.prefixes

string

&,@,%%

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

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.

mq.connection.pool.share

boolean

false

Indicate whether to share or recreate the JMS connection pool with the same Queue Manager.

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

mq.queues.jms.connectionfactory.*

Supported Atomikos connection factory properties

Specifies configuration properties for the JMS MQ connection pool.

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].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].jmsMQMaxPoolSize

number

0

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

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].jmsMQPort

number

null

The IBMMQ port.

mq.queues.jmsMQQueueManagers[N].jmsMQQueueManager

string

null

The IBMMQ queue manager name.

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.jmsMQQueueManagers[N].jmsMQUserid

string

null

The IBMMQ user name.

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

string

null

The Rabbit MQ password.

mq.queues.rabbitMQPort

number

null

The Rabbit MQ port.

mq.queues.rabbitMQUsername

string

null

The Rabbit MQ user.

mq.queues.rabbitMQVirtualHost

string

null

The Rabbit MQ virtual hostname.

mq.queues.sqs.region

string

eu-west-3

The AWS Region for the AWS SQS MQ service.

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.

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.

qtemp.cleanup.threshold.hours

number

0

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

qtemp.dblog

boolean

false

Whether to enable QTEMP Database logging.

qtemp.uuid.length

number

9

The QTEMP unique id length.

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.

query.useConcatCondition

boolean

false

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

reportOutputPath

string

/reports

The report output path.

returnHttp5xxResponseForFailedSyncJob

boolean

false

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

rollbackOnRTE

boolean

false

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

sctThreadLimit

long

5

The thread limit for triggering scripts.

server.servlet.session.timeout

string

30m

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

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.

spring.aws.application.credentials

string

null

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

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

string

null

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

spring.aws.client.bluesam.redis.secret

string

null

Specifies the credential secret ARN for Bluesam Redis cache, see AWS Transform for mainframe Runtime secrets.

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

string

null

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

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

string

null

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

spring.aws.client.jics.redis.secret

string

null

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

spring.jta.enabled

boolean

false

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

spring.session.store-type

string

none

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

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.

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.

sqlIntegerOverflowAllowed

boolean

false

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

startDefaultJob

string

false

Specify whether to initialize default job at first transaction.

stepFailWhenAbend

boolean

true

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

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.

system.date.format

string

MDY

The system date format DATFMT.

---

system.date.separator

string

/

The system date separator DATSEP.

Possible values are slash (`/`), dash (`–`), period (`.`), comma (`,`) or blank (` `). Value needs to be specified in double quotes `""`.

5.17.0

system.qdecfmt

string

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

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)

tempFilesDirectory

string

null

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

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

uppercaseUserInput

boolean

true

Specifies whether user input must be in uppercase.

useControlMVariable

boolean

false

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

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.

convertGraphicDataToFullWidth

boolean

true

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

encoding

string

ASCII

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

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.

forcedDateMode

string

Specifies the forced date mode. When set to HYBRID, the date portion is the configured forced date but the time portion reflects the actual system time. Applies only if forcedDate is also set.

hasGraphic

boolean

false

Whether the INFUTILB utility needs to handle GRAPHIC DB2 columns.

idcams.deleteFromAllSubfolders

boolean

false

Whether the IDCAMS DELETE command should also remove matching files from every sub-folder of the files directory.

idcams.encoding.forced

string

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

idcams.repro.failOnMissingOutput

boolean

false

If set to true, IDCAMS REPRO will early fail if an output Blusam dataset, having either SHR or OLD disposition, is missing.

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.

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.

load.batchSize

number

0

The load utility batch size.

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

number

0s

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

logging.config

Path

classpath:logback-utility.xml

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

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.

spring.datasource.primary.jndi-name

string

jdbc/primary

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

spring.jta.enabled

boolean

false

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

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.

treatLargeNumberAsInteger

boolean

false

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

unload.bmc.useInto

boolean

false

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

unload.chunkSize

number

0

Chunk size used for unload utility.

unload.columnFiller

string

space

The unload utility column filler.

unload.computeRecordSizeIfNull

boolean

false

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

unload.fetchSize

number

0

Allows you to tune the fetch size when handling cursors in the 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.whenNotNull

hexadecimal

00

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

unload.nbi.whenNull

hexadecimal

6F

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

unload.nbi.writeNullIndicator

boolean

false

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

unload.noPad

boolean

true

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

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

boolean

false

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

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.

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 Transform for mainframe Runtime program designed for debugging purposes.

encoding

string

ASCII

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

forcedDate

string

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

forcedDateMode

string

Specifies the forced date mode. When set to HYBRID, the date portion is the configured forced date but the time portion reflects the actual system time. Applies only if forcedDate is also set.

logging.config

Path

classpath:logback-utility.xml

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

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.

spring.datasource.primary.jndi-name

string

jdbc/primary

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

spring.jta.enabled

boolean

false

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

zonedMode

string

EBCDIC_STRICT

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

jhdb.backend

string

Jhdb backend type. Expected value is rdbms

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.configuration.context.encoding

string

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

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.transaction.scope.programs

string

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

logging.config

Path

classpath:logback-utility.xml

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

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.

spring.jta.enabled

boolean

false

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

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.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.dao.cache.initMaxResults

number

10000

The size of the cache.

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

Where the API is hosted

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

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

api-name

The endpoint/URI that was accessed

api-retcode

The status code returned after the API request completed

api-scheme

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

api-secure

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

api-sessionid

A unique identifier for the user's current login session

api-user

The username or identifier of the person making the API request

gapwalk.tracing.enabled

boolean

false

Enables distributed tracing for GapWalk applications. When enabled, propagates traceId and spanId for batch job execution.

spanId

Unique identifier for the current operation within the trace

traceId

Unique identifier for the entire request flow across all services and threads