Skip to content

Installing Databridge DMSII Client

This chapter explains how to install DMSII Client on a Unisys MCP-hosted mainframe. For DMSII Client to work properly, you must configure it according to the instructions provided in the DMSII Client Administrator's Guide


Databridge DMSII Client Installation Requirements

DMSII Client software itself takes less than 2 MB of disk space. The size of the client database depends on the size of the data sets and sets replicated from the primary system. The size of the client database audit trail depends on the number of audit files you keep on the system. For a rough estimate of the disk space required multiply the size of the primary database by the fraction of the database that will be replicated. If the whole primary database will be replicated then an equal amount of disk space will be required for the client database.

The system resource requirements are proportional to the amount of data replicated. DMSII Client uses the standard DMSII application program interface to the client database and its processor and memory usage would be similar to other application programs.

The DMALGOL and DASDL compilers must be visible to DMSII Client in order to automatically compile the client database and associated library programs. If these compilers are not available you must specify the COMPILE MANUAL option in the parameter file and compile the software using other means.


Install Databridge DMSII Client

You must install Databridge components on both the primary and secondary systems. Before you install DMSII Client on the secondary system, you must install the current version of Databridge Host software on your primary system. See Install Databridge Host of this guide for Host installation instructions and system requirements.

Follow this procedure to install the DMSII Client. You can install DMSII Client to the same mainframe where you installed the Databridge server software, or you can install it to a different mainframe.

Before you install, you'll need to determine the usercode and pack that you\'ll use to install. For best results, we recommend that you choose a privileged usercode and the primary pack of the FAMILY substitution statement.

  1. Sign on to a privileged usercode.

    If you install to a nonprivileged usercode, all object files will be marked as restricted and you will have to use the ODT command RESTRICT -- FILE objectcode on every program.

  2. Upload Databridge container to the host.Upload the DB70-00-BASE file using a file transfer tool capable of binary/image transfers to the privileged usercode where Databridge is to be installed.

  3. Unwrap the Databridge installation WFL (WFL/DATABRIDGE/INSTALL).

    To extract the install WFL from the file DB70-00-BASE, enter the following CANDE command:

    WFL UNWRAP *WFL/DATABRIDGE/INSTALL AS WFL/DATABRIDGE/INSTALL OUTOF DB70-00-BASE
    
  4. Start the Databridge Installation WFL.

    START WFL/DATABRIDGE/INSTALL ("DMSIICLIENT")
    

    If you want to install DMSII Client software to a different pack family than primary pack of your FAMILY substitution statement (FAMILY DISK = primarypack OTHERWISE secondarypack), use the following command instead.

    START WFL/DATABRIDGE/INSTALL ("DMSIICLIENT", "otherpack")
    

The WFLs are copied with a SAMPLE node in the title. They will also be copied without the SAMPLE node using the ADD command so that first-time installations will have WFL files with the standard name but existing WFL files are not replaced.