About This Guide
This guide contains instructions for configuring and using the Micro Focus Databridge Client. This preface includes information to help you use this guide.
While this guide was originally written for command-line Client operations, it is applicable to both command-line or service-controlled Client operations. To facilitate the transition to using service-based operations we provide instructions on how to perform the tasks described in this document using the Administrative Console and information on where to find configuration parameters in the Administrative Console's Configure command dialog pages.
For Administrative Console users this manual contains a lot of detailed information that they do not need to know; particularly in the area of writing user scripts. The Administrative Console's Customize command hides a lot of these details from you and lets you concentrate on what you are trying to do (usually the operations involve a single mouse-click plus a selection among the possible data formats in DMSII). Using the Administrative Console to control the running of the Client gives you the ability to fully automate Client operations and do comprehensive error recovery. For information specific to the service-controlled Client, see the following topics in this chapter or go to the Help in the Databridge Administrative Console:
To install, configure, and run Databridge, you should be a system administrator familiar with the following:
-
Standard Unisys® operations for MCP-hosted mainframes such as the CS7xxx series, Libra series, ClearPath® NX/LX or A Series
-
DMSII databases and Data And Structure Definition Language (DASDL)
-
File layouts and the description of those layouts for the files you will be replicating
Conventions
The following conventions and terms may be used in this guide.
| This convention | Is used to indicate this |
|---|---|
| menu > sub menu 1 > sub menu 2 ... > menu item (item) | This font style/color shows mouse-clicks in the order required to access a specific function, window, dialog box, etc. The greater than symbol > indicates the next item to click in the series. The parentheses ( ) indicate the setting, option, or parameter being discussed. Note the font style reverts back to normal. |
this type style |
text that you type, filenames and directory names, onscreen messages |
| bold | Folder names and program names. For example logs, DBClient. |
| italic | variables, emphasis, document titles |
| square brackets ( [ ] ) | optional items in a command. For example, [ true | false ]. (Do not type the brackets.)Buttons. For example, [OK], [Start], [Cancel] |
pipe ( | ) |
a choice between items in a command or parameter. When enclosed in braces ( { } ), the choice is mandatory. |
| UPPERCASE | DMSII data set and data item names. |
| This term | Is used to indicate this |
|---|---|
| MCP server host mainframe | Unisys ClearPath NX, LX or A Series mainframe |
| DBEngine | Databridge Engine on the mainframe |
| DBEnterprise | Databridge Enterprise Server |
| DBServer | Databridge Server on the mainframe |
| Service | For UNIX Clients, consider this term synonymous with "daemon" |
Abbreviations
The following abbreviations are used throughout this guide and are provided here for quick reference.
| Abbreviation | Name |
|---|---|
| AA | Absolute Address |
| ABSN | Audit Block Serial Number |
| AFN | Audit File Number |
| API | Application Programming Interface |
| DASDL | Data and Structure Definition Language |
| DMSII | Data Management System II |
| IDX | Index |
| IPC | Inter-Process Communications |
| MCP | Master Control Program |
| RPC | Remote Procedure Call |
| RSN | Record Serial Number |
| SEG | Segment |
| WFL | Work Flow Language |
Related Documentation
When using Databridge, you may need to consult the following resources.
| Databridge product documentation | On the Databridge installation image, the Docs folder contains guides for installation, error codes, and administrator's guides for each Databridge product. These documents require Adobe Reader for viewing, which you can download from the Adobe website. This documentation, and additional support resources, is also available on the Micro Focus Support and Services site. Documentation for Databridge Enterprise Server and the Databridge Administrative Console is also available from the Help menu in each respective product. A modern browser is required for viewing this documentation. |
| Unisys MCP server documentation | If you are not completely familiar with DMSII configuration, refer to your Unisys documentation. |