Support elements for JDBC and DB2

You can use a support element (also referred to as a support class) to allow z/OS® Batch Runtime to interoperate with a database or other resource manager.

For this release, the only support element is one that manages the JDBC driver that communicates with DB2®. The support element must implement the following interface:

com.ibm.zos.zbatch.runtime.support.BCDBatchRuntimeSupport

This interface defines the following Java™ methods:

initializeBatchRuntimeEnv(Properties props)

Initializes z/OS Batch Runtime environment. Startup options are passed in the properties object

terminateBatchRuntimeEnv()

Ends the z/OS Batch Runtime environment.

notifyNewGlobalTransaction(BCDTransaction transaction)

Informs the support element of a new global transaction. The support element of this method calls the following, which z/OS Batch Runtime implements:

transaction.registerSynchronization(BCDSynchronization sync)

getVersion()

Retrieves a string representation of the version of the support element for diagnostic purposes. The content of the string is determined by the support element.

Transaction and synchronization processing that are normally part of the J2EE javax.transaction package are part of the following z/OS Batch Runtime package:

com.ibm.zos.batch.runtime.support.transaction

The classes for this package are called:

BCDTransaction
BCDSynchronization

In addition, a support element is required to implement a static getInstance() method that returns an instance of the support element class. You must add any .JAR files or DLLs to the CLASSPATH and LIBPATH in the BCDBATCH JCL. For more details, see Invoking z/OS Batch Runtime.