Installation Results
This section includes lists of files that are installed with each product.
Files Installed with Databridge Host
This section describes each of the files installed with Databridge Host software.
Databridge software is organized into the following directories:
| Directory | Description |
|---|---|
| DATA/= | Parameter and data files |
| OBJECT/DATABRIDGE/= | Executable files |
| PATCH/= | Source files |
| SYMBOL/DATABRIDGE/= | Source files |
| WFL/DATABRIDGE/= | WFL job files |
OBJECT/DATABRIDGE Directory
Databridge Host files are copied to the usercode designated at installation.
| Filename | Description |
|---|---|
| OBJECT/DATABRIDGE/AUDITMIRROR | Object code for the Databridge AuditMirror Accessory |
| OBJECT/DATABRIDGE/AUDITTIMER | Object code for the Databridge AuditTimer program |
| OBJECT/DATABRIDGE/BCNOTIFY | Object code for the BCNOTIFY utility |
| OBJECT/DATABRIDGE/CHANGEUSER | Object code for the Databridge ChangeUser library, which changes the usercode of a Server Accessory Worker in cases where the SOURCE specifies a USERCODE, so the Worker will run under that usercode. |
| OBJECT/DATABRIDGE/COBOLSUPPORT | Object code for Databridge CobolSupport library |
| OBJECT/DATABRIDGE/DBINFO | Object code for the Databridge Database Info utility |
| OBJECT/DATABRIDGE/DCKEYIN | Object code for the ODT command program |
| OBJECT/DATABRIDGE/ENGINE | Object code for Databridge Engine Library |
| OBJECT/DATABRIDGE/GENFORMAT | Object code for the Databridge GenFormat program |
| OBJECT/DATABRIDGE/LICENSEMANAGER | Object code for product key management program |
| OBJECT/DATABRIDGE/LICENSESUPPORT | Object code for the license verification library |
| OBJECT/DATABRIDGE/LISTER | Object code for the Databridge Lister Accessory |
| OBJECT/DATABRIDGE/SAMPLE/AUDITCLOSE | Object code for the sample Databridge Audit Close utility |
| OBJECT/DATABRIDGE/SAMPLE/COBOLGEN | Object code for the sample Databridge COBOLGen Accessory |
| OBJECT/DATABRIDGE/SAMPLE/DASDLGEN | Object code for the sample Databridge DASDLGen Accessory |
| OBJECT/DATABRIDGE/SAMPLE/EXTRACTADDRESS | Object code for the sample ExtractAddress Library |
| OBJECT/DATABRIDGE/SAMPLE/READDOC | Object code for the sample Databridge ReadDoc Accessory |
| OBJECT/DATABRIDGE/SAMPLE/REFORMAT | Object code for sample data item conversion routines |
| OBJECT/DATABRIDGE/SAMPLE/SQLGEN | Object code for the sample Databridge SQLGen Accessory |
| OBJECT/DATABRIDGE/SERVER | Object code for the Databridge Server Accessory |
| OBJECT/DATABRIDGE/SNAPSHOT | Object code for the Databridge Snapshot Accessory |
| OBJECT/DATABRIDGE/SPAN | Object code for the Databridge Span Accessory |
| OBJECT/DATABRIDGE/SUPPORT | Object code for the Databridge Support Library |
SYMBOL/DATABRIDGE Directory
Databridge Host files are copied to the usercode designated at installation.
| Filename | Description |
|---|---|
| SYMBOL/DATABRIDGE/COBOLSUPPORT | Source code for providing entry points to COBOL Accessories for filtering and formatting routines in the Support Library (ALGOL file type) |
| SYMBOL/DATABRIDGE/DMSIISUPPORT | Source code for the DMSII Support Library |
| SYMBOL/DATABRIDGE/SAMPLE/AUDITCLOSE | Sample source code for closing a DMSII audit file (ALGOL file type) |
| SYMBOL/DATABRIDGE/SAMPLE/COBOLGEN | Sample source code for generating COBOL file layouts corresponding to a DMSII database (ALGOL file type) |
| SYMBOL/DATABRIDGE/SAMPLE/DASDLGEN | Sample source code for generating a DMSII DASDL source corresponding to a DMSII database (ALGOL file type) |
| SYMBOL/DATABRIDGE/SAMPLE/DATABASE | Source code for defining the sample DMSII database (DASDL file type) |
| SYMBOL/DATABRIDGE/SAMPLE/EXTRACTADDRESS | Sample source code for a library that will extract addresses and build VIRTUAL records (COBOL85 file type) |
| SYMBOL/DATABRIDGE/INTERFACE | Source code Databridge host software API (ALGOL file type) |
| SYMBOL/DATABRIDGE/SAMPLE/READDOC | Sample source code for reading audit records (ALGOL file type) |
| SYMBOL/DATABRIDGE/SAMPLE/REFORMAT | Sample source code for writing data item conversion routines in a REFORMAT library (ALGOL file type) |
| SYMBOL/DATABRIDGE/SAMPLE/SQLGEN | Sample source code for generating an SQL script to create tables that correspond to a DMSII database. (ALGOL file type) |
| SYMBOL/DATABRIDGE/SUPPORT | Source code for the Support Library (ALGOL file type) |
WFL/DATABRIDGE Directory
Databridge Host files are copied to the usercode designated at installation.
| Filename | Description |
|---|---|
| WFL/DATABRIDGE/INSTALL | Work flow for installing the Databridge software |
| WFL/DATABRIDGE/SAMPLE/AUDITCLOSE | Work flow for executing the Audit Close sample Accessory |
| WFL/DATABRIDGE/SAMPLE/AUDITMIRROR | Work flow that receives mirrored audit files on the secondary computer |
| WFL/DATABRIDGE/SAMPLE/AUDITTIMER | Work flow for executing the AuditTimer utility |
| WFL/DATABRIDGE/SAMPLE/BCNOTIFY | Work flow for executing BCNOTIFY |
| WFL/DATABRIDGE/SAMPLE/COBOLGEN | Work flow for executing the COBOL file layout generator program |
| WFL/DATABRIDGE/SAMPLE/COMP | Work flow for compiling a Databridge sample program, the Support Library or DMSII Support Library |
| WFL/DATABRIDGE/SAMPLE/COPYAUDIT | Work flow that can be used in place of the DMSII COPYAUDIT WFL to postpone removal of audit files |
| WFL/DATABRIDGE/SAMPLE/DATABASE | Work flow for creating and populating the sample database (BANKDB) supplied with Databridge |
| WFL/DATABRIDGE/SAMPLE/DBINFO | Work flow for executing the Databridge Database Info utility |
| WFL/DATABRIDGE/SAMPLE/DBNOTIFY | Work flow for executing the DBNOTIFY program |
| WFL/DATABRIDGE/SAMPLE/INCLUDE/DBTITLE | Work flow that parses the DMSII database title for all other WFLs |
| WFL/DATABRIDGE/SAMPLE/LISTER | Work flow for executing the Lister accessory |
| WFL/DATABRIDGE/SAMPLE/NOTIFY | Work flow for executing the DBNOTIFY program |
| WFL/DATABRIDGE/SAMPLE/READDOC | Work flow for executing the ReadDoc sample Accessory |
| WFL/DATABRIDGE/SAMPLE/REMOVEAUDIT | Work flow for removing audit files |
| WFL/DATABRIDGE/SAMPLE/SPAN | Work flow for executing Databridge Span |
| WFL/DATABRIDGE/SAMPLE/SQLGEN | Work flow for executing the SQLGen sample Accessory |
| WFL/DATABRIDGE/SAMPLE/SERVER | Work flow for executing Databridge Server |
| WFL/DATABRIDGE/SAMPLE/SNAPSHOT | Work flow for executing the Snapshot Accessory |
DATA Directory
Databridge Host files are copied to the usercode designated at installation.
| Filename | Description |
|---|---|
| DATA/AUDITMIRROR/SAMPLE/CONTROL | Sample parameter file for the AuditMirror program (SEQDATA file type) |
| DATA/AUDITTIMER/SAMPLE/CONTROL | Sample parameter file for the AuditTimer program (SEQDATA file type) |
| DATA/COBOLTODASDL/SAMPLE/BANKFILE/CONTROL | COBOLTODASDL parameter file for the BANKFILE FileXtract example. |
| DATA/COBOLTODASDL/SAMPLE/BANKFILE/FD | COBOL FD for the BANKFILE FileXtract example. |
| DATA/COBOLTODASDL/SAMPLE/LINCLOGDB/FD | COBOL FD for the LINCLOGDB FileXtract example. |
| DATA/COBOLTODASDL/SAMPLE/LINCLOGDB/CONTROL | COBOLTODASDL parameter file for the LINCLOGDB FileXtract example. |
| DATA/DATABRIDGE/SAMPLE/LICENSE | Sample software license file (DATA file type) |
| DATA/ENGINE/CONTROL | Parameter file that contains the key information for running this release of Databridge, as well as other options for DBEngine operation |
| DATA/ENGINE/SAMPLE/CONTROL | Sample DBEngine parameter file for specifying database-specific DBEngine parameters (SEQDATA file type) |
| DATA/GENFORMAT/SAMPLE/CONTROL | Sample parameter file for the GenFormat program (SEQDATA file type) |
| DATA/GENFORMAT/SAMPLE/BANKFILESDB/CONTROL | Sample BANKFILESDB parameter file for the GenFormat program (SEQDATA file type). |
| DATA/GENFORMAT/SAMPLE/LINCLOGDB/CONTROL | Sample LINCLOGDB parameter file for the GenFormat program (SEQDATA file type). |
| DATA/GENFORMAT/SAMPLE/NAPFILESDB/CONTROL | Sample NAPFILESDB parameter file for the GenFormat program (SEQDATA file type) |
| DATA/GENFORMAT/SAMPLE/SYSFILESDB/CONTROL | Sample SYSFILESDB parameter file for the GenFormat program (SEQDATA file type)) |
| DATA/GENFORMAT/SAMPLE/USERDATADB/CONTROL | Sample USERDATADB parameter file for the GenFormat program (SEQDATA file type). |
| DATA/LISTER/SAMPLE/CONTROL | Sample parameter file for the Lister Accessory (SEQDATA file type) |
| DATA/LOAD/SAMPLE/DATABASE | Data for the sample database that you can use with Databridge |
| DATA/SERVER/SAMPLE/CONTROL | Sample parameter file for Databridge Server (SEQDATA file type) |
| DATA/SERVER/SAMPLE/FILEBRIDGE/CONTROL | Sample FileXtract parameter file for the DBServer program (SEQDATA file type) |
PATCH Directory
Databridge Host files are copied to the usercode designated at installation.
| Filename | Description |
|---|---|
| PATCH/DATABRIDGE/COBOLFD/PARSER | Routines for parsing a COBOL FD. |
| PATCH/DATABRIDGE/COBOLTODASDL/PARSER | Routines for parsing a COBOLTODASDL parameter file. |
| PATCH/DATABRIDGE/DASDL/TWIN | A DASDL patch you must include in your database to run Databridge Twin if your restart data set does not have the required fields |
| PATCH/DATABRIDGE/PARSER/DEFINES | Definitions included when compiling a parser. |
| PATCH/DATABRIDGE/SAMPLE/SUPPORT/REFORMAT | Sample INTERNAL REFORMAT program |
| PATCH/DATABRIDGE/SAMPLE/SUPPORT/ERRORHANDLER | Sample error manager routine |
| PATCH/DATABRIDGE/SAMPLE/SUPPORT/FORMATADDRESS | Sample formatting routine for VIRTUAL data sets |
| PATCH/DATABRIDGE/SAMPLE/SUPPORT/NAPREFORMAT | Sample INTERNAL REFORMAT program for the NAPFilesDB FileXtract database. |
| PATCH/DATABRIDGE/SAMPLE/SUPPORT/SHUTDOWN | Sample shutdown procedure for a Support Library |
| PATCH/DATABRIDGE/SAMPLE/SUPPORT/SYSREFORMAT | Sample INTERNAL REFORMAT program for the SYSFilesDB FileXtract database. |
| PATCH/DATABRIDGE/SAMPLE/SUPPORT/STARTUP | Sample startup procedure for a Support Library |
| PATCH/DATABRIDGE/SAMPLE/SUPPORT/VIRTUAL | Sample skeleton patch to the Support Library for a VIRTUAL TRANSFORM routine |
Files Installed with DMSII Client
The following files are copied to the usercode you designated when you installed DMSII Client:
| Filename | Description |
|---|---|
| DATA/DMSIICLIENT/SAMPLE/CONTROL | Sample parameter file for DMSII Client See Modifying the DMSII Client Parameter File in the “DMSII Client Administrator’s Guide” for an example. |
| OBJECT/DATABRIDGE/DMSIICLIENT | Object code for DMSII Client |
| OBJECT/DATABRIDGE/DMSIICLIENT/AUTOCONNECT | Object code for the auto connect feature |
| PATCH/DATABRIDGE/DMSIICLIENT/SAMPLE/DASDL | Sample patch file to specify DASDL particulars See Modifying the DMSII Client DASDL File in the “DMSII Client Administrator’s Guide” for an example. |
| SYMBOL/DATABRIDGE/DMSIICLIENT/LIB | Library source code used by DMSII Client when accessing a client database |
| SYMBOL/DATABRIDGE/DMSIISUPPORT | Library source code for performing the actual inquiries and updates of the client database |
| SYMBOL/DATABRIDGE/INTERFACE | Source code INCLUDE file for the API |
| WFL/DATABRIDGE/INSTALL | Work flow for installing DMSII Client |
| WFL/DATABRIDGE/SAMPLE/BACKUPTAILORED | Workflow for backing up tailored DMSII software, DESCRIPTION and DMSUPPORT, with the update level as the last node of the file titles. |
| WFL/DATABRIDGE/SAMPLE/DMSIICLIENT | Work flow for executing DMSII Client |
| WFL/DATABRIDGE/SAMPLE/DMSIICLIENT/COMPILEDB | Work flow for compiling DMSII Client database when using the manual compile option |
| WFL/DATABRIDGE/SAMPLE/DMSIICLIENT/REORGDB | Work flow for compiling the DMSII Reorganization program for generating the sets for a cloned data set. |
The SAMPLE work flows are also copied without the SAMPLE node if those files don't already exist.
Files Installed with Databridge Twin
The following is a list of files that are installed on the secondary system. These files are copied to the secondary system via the Databridge installation WFL:
| Filename | Description |
|---|---|
| DATA/ENGINE/SAMPLE/CONTROL | Required: This data file contains options for running the Databridge Twin Engine. |
| DATA/TWIN/SAMPLE/CONTROL | Required: This Databridge Twin parameter file provides information to the Databridge Twin program on where and how to locate the Server SOURCE for the primary database. |
| OBJECT/DATABRIDGE/DBINFO | DBInfo creates reports about your DMSII database. For Databridge Twin Engine, only the DBInfo normal mode is supported because the Databridge Twin Engine does not provide access to the audit file. For instructions on DBInfo, see the Databridge Host Administrator’s Guide. |
| OBJECT/DATABRIDGE/ENGINE | Required: This is the object file for the Databridge Twin Engine, which is a subset of the full Databridge Engine. |
| OBJECT/DATABRIDGE/GENFORMAT | Optional: Object code for the Databridge GenFormat program |
| OBJECT/DATABRIDGE/SUPPORT | Required: This is the object code for the non-tailored Support library. |
| OBJECT/DATABRIDGE/TWIN | Required: This is the object file for the Databridge Twin program, which calls the Databridge Twin Engine. |
| PATCH/DATABRIDGE/TWIN/DASDL | Optional: This file is required if you use the INCLUDE statement in your DASDL instead of inserting the contents of this patch file into the DASDL. If you use an INCLUDE statement to include this file in the DASDL, this file must be on both the primary and the secondary systems. |
| SYMBOL/DATABRIDGE/DMSIISUPPORT | Required: This file is the source file for the DMSIISupport Library that will update the secondary database. |
| SYMBOL/DATABRIDGE/INTERFACE | Optiona:. This file supplies the API for the Databridge Engine. It is required for compiling the Support Library. |
| SYMBOL/DATABRIDGE/SUPPORT | Optional: This is the source code for the Support Library. |
| WFL/DATABRIDGE/INCLUDE/DBTITLE | Required: This WFL source file is required for running any Databridge WFL. It parses the database name you enter when you start the WFL |
| WFL/DATABRIDGE/INSTALL | Required: This WFL is required for installing Databridge Twin. |
| WFL/DATABRIDGE/SAMPLE/COMP | Optional: This WFL compiles the Support Library. |
| WFL/DATABRIDGE/SAMPLE/TWIN | Required: This is the WFL for running the Databridge Twin program. |
| WFL/DATABRIDGE/SAMPLE/INCLUDE/SSRTITLES | Required: This WFL source file is included by WFL/DATABRIDGE/COMP to specify the location of the compilers for each SSR (system software release). |
| WFL/DATABRIDGE/TWININITIALIZE | Optional: If you run this WFL, it starts WFL/DATABRIDGE/TWIN with the LOAD command. NOTE:This feature is deprecated, but still operates to support legacy use. |
After you have verified the files, you are ready to configure the primary and secondary databases (see Configuring Databridge Twin in the Databridge Twin Administrator's Guide).
To replicate the primary database, see the chapter Replicating a Database in the DataBridge Twin Administrator's Guide.
Files Installed with Databridge Enterprise Server
Use this document to verify the default installation results for Databridge Enterprise Server.
In addition to installing the Enterprise Server files, the setup program adds shortcuts to the Start menu from which you can configure a source and view the configuration and log files folder.
The following files are installed to
C:\Program Files\Micro Focus\Databridge\7.0\Enterprise:
| Filename | Description |
|---|---|
| DBUI.dll | The optional message and dialog text for Enterprise Server, which can be translated into other (non-English) languages |
| DBDirector.exe | Windows service that listens for requests from Databridge Clients and then initiates the Enterprise Server application |
| Help folder | The Databridge Enterprise Server Help files (.html) which are viewable from the program by selecting the Help menu or by pressing the F1 key. |
| Support folder | Header files and DBEUser.lib for compiling user-written libraries |
| Support\MakeUserLib.cmd | Batch file for building user-written libraries |
| DBEnterprise.exe | Enterprise Server executable file |
| EnumDisk.exe | Enterprise Server utility that lists the MCP disks available on the server where Enterprise Server is installed |
| FinishMirrored.cmd | Sample batch file to run whenever an audit file is successfully mirrored to the secondary system. |
| LINCLOG.dll | LINC log FileXtract Reader library |
| Notify.cmd | Sample batch file to run when the Databridge Server accessory signals the availability of more audit files to process |
Files Installed with Databridge Client
During installation, Databridge Client 70 copies files to the install
directory and a client-specific directory (such as SQLServer). On
Windows, the install directory is located at
C:\Program Files\Micro Focus\Databridge\7.0. In addition, the Micro
Focus Installer Program installs a Setup folder in this location
containing files that repair, reinstall, and remove the program.
In the following tables, the filenames represent both UNIX and Windows files. Windows extensions are provided in brackets ([ ]). The following files are copied to the install directory:
| Filename | Description |
|---|---|
| bconsole[.exe] | The Batch Console automates routine Client tasks by allowing command files/shell scripts launched by the Client service to interact with the service. For more information, see the Databridge Client Administrator's Guide. |
| DATABridge_Messages.dat | A binary file that the Databridge service/daemon uses to retrieve the text associated with error status codes generated by various Databridge components. |
| DBClntControl[.exe] | The service (Windows) or daemon (UNIX) that automates most Client operations. It handles operator requests from the administrative and batch consoles and routes all log and informational messages to the consoles. The service has no effect on dbutility command-line operations. |
| dbctrlconfigure[.exe] | A command-line program that implements the import and export commands for the Client Manager service configuration file. It converts the service configuration file (dbcontrol.cfg) from its native binary format to text format (.ini) and back using the export and import commands. |
| logmaint[.exe] | A utility that allows you to delete all log files from the service and the individual data source directories except for the most recent. Run this utility from the working directory for the service or the data source whose log files you want to manage. The number of files to retain are specified on the command line for logmaint as optional parameters. When used for the client, it has two parameters. The first parameter is for the DBClient and dbutility log files. The second parameter is for DBClnCfgServer log files. The parameters default to 10 and can be set to a value as low as 2. |
| readme.txt | A text file that contains late-breaking information for the product. This file is updated to document patches in Hot Fixes, Updates and Service Packs. |
| setbcuserid.exe (Windows only) | A Windows program that lets you register a specific Windows userid as a trusted user. This allows this userid to run the bconsole utility without specifying a password by adding /T option to the command line. This avoids having clear-text passwords in command files that run bconsole. This is meant for runs that are initiated from places like the Windows scheduler or third-party job scheduling tools. |
| setfilesecurity.exe (Windows only) | A Windows program that lets you set file security for all files and directories in the Working Directory (which includes changes to the Windows registry). This program functions the same as the utility started by the installer, except that it doesn't allow you change the system or user path. You must run this program as Administrator. |
| showerror.exe | A utility that prints the text associated with a Databridge error number. |
The following files are copied to the client-specific directory:
| Filename | Description |
|---|---|
| bcp_auditor.exe (Windows only) | A program that scans the bcp output to determine if the bcp utility was successful. The bcp_auditor utility sets the exit code correctly. This utility applies only to Microsoft SQL Server databases. |
| DBClient[.exe] | 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 Administrative Console to display its output and interact with the operator. |
| DBClntCfgServer[.exe] | A program that handles all requests from the Administrative 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. |
| dbeatran.dll dbgaiji.smp dbtrans_jbis8.smp dbtrans_v24jbis8.smp | Japanese double-byte translation DLL and sample configuration files. Depending on which character set the mainframe uses, copy the appropriate dbtrans file to the config directory as dbtrans.cfg. Also, copy the file dbgaiji.smp to the config directory as dbgaiji.cfg. |
| dbfixup[.exe] | A program used for updating existing client control tables when upgrading from a previous client release. |
| dbpwenc[.exe] | A program used to encode relational database and DBServer (or DBEnterprise Server) passwords in text configuration files and change passwords in text and binary configuration files. NOTE: Passwords set in the Administrative Console are automatically encoded in binary configuration files. |
| dbscriptixup[.exe] | A program that modifies the Client control tables according to changes specified by the user scripts and enables the Client Configurator to make future modifications to the table layout. |
| dbutility[.exe] | A program that runs Databridge Client from a command line. |
| getlogtail.exe | A program that extracts the tail of the current log file and writes it to the file trace.log. |
| migrate[.exe] | The upgrade program that updates configuration settings and creates the working directory structure. It copies the updated configuration files and any user scripts to the new working directory structure. |
| splitter[.exe] | A utility that splits large trace files into smaller files. Used primarily for sending files to Micro Focus for troubleshooting. |
| dumpnullrecs[.exe] | A program that displays the content of the NULL record file for a given data source. |
*Installed only when the Japanese language feature is selected.
Administrative Console Directories and Files
Files for the Administrative Console are installed in the following two directories at C:\Program Files\Micro Focus\Databridge\7.0\Administrative Console\.
| Directory | Description |
|---|---|
| bin | Contains a set of batch files, some of which are platform specific. |
| conf | Contains configuration files. The one that you need to be aware is "container.properties". The post-install script, launched by the postinstall program at the end of the installation in Windows, creates using the file with the same name in the templates folder, unless the file is already present in the "conf" directory when reinstalling the Administrative Console. In a new installation file needs to be updated before you can start using the Administrative Console |
| java | The private JRE for running the Administrative Console code. |
| lib | Contains the administrative console jar files and library files. |
| microservices | The two subdirectories "adminconsole" and "auth-service" contain files for configuring the corresponding services. |
| templates | contains the starter configuration file "container.properties" |
| utilities | contains utilities including the keystore explorer |