Description of DATABridge Components

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

DATABridge Host (installed on the mainframe)

Component

Description

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

Server (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 asking DBEngine to read the audit files on the host and send the changes to the Client.

Support Library (DBSupport)

A library that provides translation, formatting, and filtering to the DBServer and other accessories. After DBServer 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.

GenFormat

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 the tailored Support Library.

Span

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

Snapshot

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

Provides pre-filtered audit files for the accessories.

Lister

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

DBInfo 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 DBServer 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 DBServer 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

Closes (switches) the current audit file.

Audit Remove Utility

Removes processed audit files.

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 provides the same functionality as the DATABridge Engine (DBEngine) and DATABridge Server (DBServer) on the host. 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 DBServer 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 DBServer to retrieve blocks of data from DMSII data sets or the audit files. Enterprise Server provides high-speed file transfer between the host and the Windows environment and audit file mirroring.

Component

Description

DBEnterprise

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

DATABridge Director (DBDirector)

A Windows Service that listens for Client connection requests and starts Enterprise Server whenever a connect request is received.

EnumDisk

A command-line program that lists MCP disks that are visible to Enterprise Server.

DATABridge Client

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

Component

Description

Client Service

The service (Windows) or daemon (UNIX) that automates most Client operations. It handles operator requests from the Client Console and routes all log and informational messages to the consoles.

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

A program that runs the DATABridge Client from a command line.

Batch Console (bconsole)

A program that allows Windows command files (UNIX shell scripts) to issue process-related requests to the Client Service. The Batch Console interprets (and runs) scripts that are written in a language that vaguely resembles Visual Basic.

Client Console (installed separately)

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

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. That is, after DATABridge Plus is established as an SL (System Library), all accessories automatically use it, even if the accessories access different databases.

DATABridge Twin

A mainframe program that replicates a DMSII database as another DMSII database. Twin typically runs on a development or departmental mainframe. As DMSII audit becomes available, updates to the primary database are applied to the secondary database.