Skip to content

Distributed Source Code

Source Files

The base environment distributions include the following source code and libraries, which are necessary to modify the origin application to work with the Streaming Integration Platform environment.

Must ship as source:

  • IOHookConfigure.dbl (subroutine, adds IOHooksKafka to a channel)
  • IOHookGlobal.dbl (subroutine, optional global I/O hook, calls IOHookConfigure.dbl)
  • IOHooksKafka.dbl (class)
  • IOHooksKafka.def (include file)

Shipped libraries (siplib.elb and siplib.dll):

  • FileInformation.dbl (class)
  • FileTools.dbl (class)
  • GetSqlTypeMapping.dbl (function, used in .NET only)
  • KafkaAPI_WL.dbl (functions)
  • JsonFormatter.dbl (class)
  • ParseFilesConfiguration.dbl (function)
  • ParseJsonFile.dbl (function)
  • RepositoryTools.dbl (used in class, .NET only)
  • StringTools.dbl (class, used in .NET only)

Utilities

  • ISAMReplicatorFileInfo.dbl (DBR, uses FileInformation to parse metadata from ISAM and RELATIVE files)
  • SQLReplicatorFileInfo.dbl (.NET EXE, uses RepositoryAPI to produce JSON metadata)

Libraries (Windows)

Library Description
dbl_replicator_hooks.dll Contains the (Rust) code used by the I/O hooks to communicate with the Message Broker.

Libraries (Linux)

Library Description
libdbl_replicator_hooks.so Contains the (Rust) code used by the I/O hooks to communicate with the Message Broker.

Libraries (OpenVMS)

Library Description

Logical Names

Logical Name Required or Optional Description
SIP_LOG
SIP_HOOKS_CONSOLE_DEBUG Optional Set to YES to enable console logging in the I/O hooks.
SIP_HOOKS_DEBUG_LOG Optional Set to YES to enable logging in the I/O hooks.
SIP_LOGLEVEL Optional If logging is enabled, defines the level of logging.
SIP_HOOKS_ENABLED Required Set to YES to enable I/O hooks and replication.
SIP_ENVIRONMENT Required Environment (profile) name
SIP_KAFKA_MAX_FAIL Optional Sets the maximum number of Kafka failures before giving up. Default is 1.
SIP_ZMQ_BROKERS Required, OpenVMS only Defines the ZeroMQ brokers used to communicate with the Message Broker.
SIP_CONFIG Required Points to the directory containing the files configuration file for the profile.
SIP_INCLUDE Required (for build) Defines the location of IOHooksKafka.def

Configuration Files

File Description
SIP_CONFIG:_FILES.JSON Or is it just SIP_CONFIG:FILES.JSON now???

Log Files

File Description
SIP_LOG:IOHOOKS.LOG I/O hooks log file (if enabled by SIP_HOOKS_DEBUG_LOG=YES)
SIP_LOG:EXCEPTIONS_\.LOG