DATABridge Components

Each of the DATABridge products (for example, DATABridge Host, the DATABridge Client, and DATABridge Enterprise Server) and the components they include are described in the following table.

DATABridge Host (installed on the mainframe)

Component

Description

DATABridge Engine (DBEngine)

The main component of the DATABridge software, the DATABridge Engine is a host library program that retrieves structural information, layout information, and data from the DMSII database and passes the information to the Server Accessory.

DATABridge Server Accessory (DBServer)

An accessory that provides communications between DBEngine and the DATABridge Client, and also between DBEngine and DATABridge Enterprise Server. DBServer responds to DATABridge Client requests for DMSII data or DMSII layout information. It retrieves updates by reading the audit files on the host and sends the changes to the Client.

Support Library (DBSupport)

A library that provides translation, formatting, and filtering to the DATABridge Server Accessory. After the Server Accessory receives data from the DATABridge Engine, it calls the Support Library to determine if the data should be replicated, and if so, passes the data to the Support Library for formatting.

DBGenFormat

A host utility that creates translation, filter, and format routines. The GenFormat utility interprets the GenFormat parameter file to generate ALGOL source code patches, which are included in a tailored support library (a customized version of the DATABridge Support Library).

Span Accessory

Produces a replication of one or more data sets into flat sequential disk files that can be extended when more audit becomes available. The Span Accessory updates the extracted flat files by appending the changes to the end of the flat files (unlike the Snapshot Accessory, which replaces the changed records).

Snapshot Accessory

Produces a clone of one or more data sets into tape or flat sequential disk files that consist of records suitable for bulk loading into a client application (for example, a spreadsheet or a relational database). The Snapshot Accessory clones the selected data sets each time you run it.

Tanker Accessory

Provides filtered audit files for the Span and Server Accessories.

Lister Accessory

Produces a report of the layout of the structures in your DMSII database, including structure numbers and key sets.

Info Utility

 

Produces a report of your DMSII database timestamps, update levels, DMSII release levels, etc.

WFL (Work Flow Language) Jobs

Provide customizable ways to run DATABridge Accessories. For example, the Notify WFL makes the Server Accessory notify the Client whenever audit files are available for processing.

AuditTimer Utility

Schedules times for closing an audit file.

Copy Audit Utility

Enables you to specify the number of closed audit files that should be saved on disk, automatically have the Server Accessory notify the Client each time an audit file becomes available, and run the Span Accessory each time an audit file becomes available.

Audit Close Utility

Enables you to close the current audit file.

Audit Remove Utility

Enables you to remove processed audit files that you copied to a separate audit pack.

Sample Source Code and Accessories

Illustrate how to use the DATABridge API to write your own accessories. These sample accessories are not supported. For more information, see the DATABridge Programmer’s Reference.

APIs (Application Program Interfaces)

Provide access to DBEngine from any DATABridge or user-written accessory (for example, Span) for the purpose of retrieving information for a DMSII database. For more information about the DATABridge API and the DATABridge COBOL API, see the DATABridge Programmer's Reference.

DATABridge Enterprise Server

A Windows-based product that includes many of the DATABridge host components. Enterprise Server offloads much of the replication workload from the Unisys mainframe to a Windows computer, reducing mainframe resource utilization and initial load time.

DATABridge Clients can connect directly to Enterprise Server, which in turn connects to the Server Accessory on the mainframe. If MCP disks are directly accessible from the Windows server, Enterprise Server extracts the DMSII data directly. Enterprise Server reads the audit trail on the host to retrieve updates that occurred during the extraction and sends the changed information from the audit file to the Client. If MCP disks are not directly accessible, Enterprise Server uses the Server Accessory to retrieve blocks of data from DMSII data sets or the audit files.

Component

Description

DBEnterprise

The executable file for Enterprise Server, frequently used interchangeably with Enterprise Server.

DATABridge Director (DBDirector)

A Windows Service that starts Enterprise Server whenever a data request is received.

DATABridge Client

The Client initiates a connection with DBServer on the host or DBEnterprise on a Windows PC and then specifies the DMSII data sets to be replicated from a DMSII database.

Component

Description

Client Service

A service (Windows) or daemon (UNIX) that automates most Client operations from the Client Console. It handles scheduling for the Client and messaging to the Client Console.

DBClient

A Client program that is launched by the service. DBClient handles the processing of DMSII data and updates the same as dbutility, except that it runs as a background run and uses the Client Console to display its output and interact with the operator.

DBClntCfgServer

A program that handles all requests from the Client Console specific to a data source. These requests include updating the client configuration file, providing access to the client control tables, and handling the Client Configurator. Like DBClient, this program is run by the service as a background run.

dbutility

An optional program that runs the DATABridge Client from a command-line.

Client Console (installed separately from the Client)

A graphical user interface from which you can connect to Client services. From the Client Console you can start the Client Configurator, which lets you customize the layout of the relational database for DMSII databases.

DATABridge FileXtract

An application that allows you to clone and update flat files that reside on Unisys ClearPath NX, LX, or A Series mainframes. You can also use FileXtract with the DATABridge Client to replicate this data. From the Client perspective, FileXtract data sources look like DMSII data sources.

FileXtract is bundled with DATABridge Host software and includes several Reader libraries and other associated files.

DATABridge DMSII Client

A mainframe program that clones and updates a DMSII database as another DMSII database. With the DMSII Client, you can selectively replicate by filtering on both row and column.

DATABridge Plus

A system library program that provides DATABridge 5.0 and later the ability to access current DMSII audit files. DATABridge Plus applies to all DATABridge Accessories. For example, once you establish DATABridge Plus as an SL (System Library), all Accessories automatically use it, even if the Accessories are accessing different databases

DATABridge Twin

A mainframe program that replicates a DMSII database as another DMSII database. Twin is installed on the primary DMSII database and the cloned data typically resides on a development or departmental mainframe. As DMSII audit becomes available, updates to the primary data base are also applied to the secondary database.