Databridge 6.6 Service Pack 1 Update 3 Release Notes

March 2022

Micro Focus Databridge 6.6 Service Pack 1 Update 3 for Unisys MCP Systems includes enhancements and bug fixes. For information about previous updates, refer to the product readme.txt.

Many of these improvements were made in direct response to suggestions from our customers. Thank you for your time and valuable input. Please continue to help us ensure that our products meet your needs.

NOTE:All Databridge tailored libraries such as DMSIISUPPORT and SUPPORT should be recompiled using WFL/DATABRIDGE/COMP.

The documentation for this product is available from the Databridge Documentation.

1.0 Version 6.6 SP1 Update 3

released March 2022

This update includes several changes, fixes, and new features.

1.1 Version Information

The Databridge components and utilities are listed with their version number in version 6.6 Service Pack 1 Update 3.

Host

base

current

DBEngine version:

6.6.0.014

6.6.5.030

DBServer version:

6.6.0.007

6.6.1.009

DBSupport version:

6.6.0.000

6.6.2.003

DBGenFormat version:

6.6.0.000

 

DBSpan version:

6.6.0.003

 

DBSnapshot version:

6.6.0.000

 

DBTwin version:

6.6.0.001

 

DMSIIClient version:

6.6.0.005

 

DMSIISupport version:

6.6.0.000

6.6.6.002

DBInfo version:

6.6.0.000

6.6.5.001

DBLister version:

6.6.0.000

 

DBChangeUser version:

6.6.0.000

 

DBAuditTimer version:

6.6.0.000

 

DBAuditMirror version:

6.6.0.001

 

DBCobolSupport version:

6.6.0.000

 

DBLicenseManager version:

6.6.0.001

6.6.5.002

DBLicenseSupport version:

6.6.0.000

 

FileXtract

base

current

Initialize version:

6.6.0.000

 

PatchDASDL version:

6.6.0.000

 

COBOLtoDASDL version:

6.6.0.000

 

UserdatatoDASDL version:

6.6.0.000

 

UserData Reader version:

6.6.0.000

 

SUMLOG Reader version:

6.6.0.000

 

COMS Reader version:

6.6.0.000

 

Text Reader version:

6.6.0.000

 

BICSS Reader version:

6.6.0.000

 

TTrail Reader version:

6.6.0.000

 

LINCLog Reader version:

6.6.0.000

 

BankFile Reader version:

6.6.0.000

 

DiskFile Reader version:

6.6.0.000

 

PrintFile Reader version:

6.6.0.000

 

Enterprise Server

base

current

DBEnterprise version:

6.6.0.012

6.6.1.015

DBDirector version:

6.6.0.001

 

EnumerateDisks Version:

6.6.0.001

 

LINCLog version:

6.6.0.002

6.6.1.001

Client

base

current

bconsole version:

6.6.0.000

6.6.5.001

dbutility version:

6.6.0.009

6.6.6.088

DBClient version:

6.6.0.009

6.6.6.088

DBClntCfgServer version:

6.6.0.009

6.6.6.088

dbscriptfixup version:

6.6.0.009

6.6.6.088

DBClntControl version:

6.6.0.002

6.6.6.010

dbctrlconfigure:

6.6.5.007

6.6.6.010

dbfixup version:

6.6.0.000

6.6.6.002

migrate version:

6.6.0.000

 

dbpwenc version:

6.6.0.000

 

dbrebuild version:

6.6.0.009

6.6.6.088

1.2 File structure

This release uses the same directory structure as previous releases with the exception that 32-bit programs are no longer included on the release DVD image.

Hot Fixes, Updates and Service Packs use the same directory structure as the release DVD—for only 64-bit patches.

NOTE:Hot Fixes, Updates and Service Packs use a single patch, which updates the Client, the Client Console and DBEnterprise Server.

1.3 Resolved issues

The following issues were resolved in Databridge 6.6 SP1 Update 3, which includes the issues resolved in previous updates.

Supported e-mode changes

  • Unlike 6.6 SP1 Update 2, which provided containers for both e-modes Delta (LEVEL5) and Eta (LEVEL6), Update 3 provides only an e-mode Eta container.

  • A container for e-mode Delta is available on-demand, should it be required.

DBEngine

  • Support for MCP and DMSII SSR level 60.0 (version 19)

  • Audit files are read without using DBPlus or DMAuditLib

  • Added DBTwin support for reformatted (redacted) data items.

  • Host software Hot Fixes and Service Packs are now installed using the same technique as installing the base release.

  • DBTwin did not correct advance the audit location when tracking updates.

DBServer

  • The AUDIT ON PRIMARY option uses the secondary audit file, when available, rather than the primary audit file.

  • DBSupport is not automatically compiled when the LINKS option changes. This patch requires DBSupport 6.6.2.002 or later.

DBSupport

  • With DBSupport 6.6.2.002, it is possible to receive a premature notification of a database reorganization.

DMSIISupport

  • The second link item in a record has an incorrect error when cloned.

  • The item offset for a remap of extended variable format data set is wrong.

DBLicense Manager

  • Remote file reads were not caught.

DBInfo

  • DBInfo (FindQPT mode) can now be run as a COMS remote window application by using TASKVALUE=6.

DBClient

  • Support for Windows Server 2019

  • Support for SQL Server 2017

  • Support for Oracle 18c on Windows, AIX, Linux, and Solaris platforms

  • Developed the Databridge Kafka (big data) Client for Linux platforms. The new component is available in the Kafka folder of the release medium.

  • The new load balancing algorithm, which was implemented in 6.5 SP1, has completely replaced the old algorithm. This code no longer uses past update rate history in balancing the load, which eliminates the need to maintain this information in DATATABLES.

  • The SQL Server and Oracle clients work with cloud databases.

  • To be able to use Oracle in the cloud, the Client was modified to eliminate the need for the GRANT of SELECT on SYS.OBJ$.

  • The SQL Server Client was modified to use the BCP API during data extraction instead of using the bcp utility. The 6.6 release also supports using the bcp utility as a fallback in case there are problems with the BCP API.

    You can make the Client use the bcp utility for all data extractions during a run by adding the /l option to the command line. Alternatively, you can force the Client to use the bcp utility for problem data sets by setting the bit 0x1000000 in the ds_options column of the corresponding DATASETS table entries.

    The BCP API combined with multi-threaded updates is considerably faster than using the bcp utility, because it eliminates the use of temporary files and uses BCP API calls to do bulk inserts into the tables.

  • The SQL Server Client's update processing code was modified to use native host variables instead of character variables, which required the database access routines to do type conversion. This change and the change to use the BCP API were done as a first step towards supporting transparent column encryption (known as "always encrypted"), because the ODBC drivers, which do the encryptions, do not support data conversions.

  • To increase speed, multi-threaded updates were extended to the data extraction code, which can now run multi-threaded. Both of these are controlled by the parameter n_update_threads.

  • The clients have the ability to control the order in which data sets get extracted. This is done by using the extract_priority column in the DATASETS table.

  • The -n option was added to the reorg command to facilitate the handling of DMSII reorganizations in a multi-sourced database environment.

  • The SQL Server and Oracle Clients were enhanced to recognize database errors that indicate that the connection to the database was lost. Previously these errors were treated as SQL errors, which caused the service to disable the data source. The Client uses exit code 2089 in this situation. The service then periodically tries to restart the client until the database comes back online.

  • The lower limit for the second value of the "sql_exec_timeout" parameter was reduced to 30 seconds to allow for faster recovery from hung SQL updates.

  • UNIX clients could hang when a log switch occurred soon after midnight when the parameter logsw_on_newday was set to true.

  • When recoverable errors occur multiple times in runs that get relaunched by the service, the retry counter does not get reset. This leads to the data source getting disabled when the retry count reaches max_retries (3 by default) even though the client got past the point in the audit trail that caused the error. To mitigate this problem we implemented an unsolicited IPC message that allows the client to notify the service that the client has recovered from the error.

  • Modified the dbutility error recovery for failed process commands to work in the same way as the service initiated error recovery.

  • Windows clients did not allow members of the administrator group specified, in the registry, to run the client when their userid did not match the userid in the registry.

  • The client looped when file security was enabled and the attempt to create a security ACL for the the log file failed.

  • The SQL Server client got a SQL error when processing a numeric item that did not allow NULL and contained an undigit (i.e. a digits that had a value greater than 9).

  • The client occasionally creates faulty SQL when updating an OCCURS table without using stored procedures. This happens when one of the rows that is be to stored did not previously exist and the values of one or more columns of the record are null.

  • The Oracle client generates bad SQL for DELETE operations involving indexes that contain dates, which causes the client to stop. This happens only when the data set is configured to not use stored procedures for doing updates.

  • The writing of binary configuration files when the string pool area was full resulted in data corruption. This error only occurs when the configuration file has a lot of string data.

  • The SQL Server client crashes during data extraction when using the BCP API if the last column in a table is an int that has the NOT NULL attribute and its corresponding DMS item is a NUMBER(8). This will probably also happen during update processing as the same code is involved.

  • Added the parameter sasl_kerberos_kinit_cmd to allow the Kerberos kinit command to be customized to meet site requirements.

  • The SQL Server client, when run single-threaded, gets a bounds error in some rare situations when processing updates. This happens when the host variable storage requirements for the widest table exceed the computed size for storage block that is used in updates. When using multi-threaded updates, this situation does not occur because each table has its own host variable storage, which is correctly sized.

  • Increased the size of the text configuration file input buffer to handle lines that are longer than 255 characters for the Kafka client. This change allows the kafka_brokers parameters to accommodate more brokers.

  • Modified UNIX clients to handle hung queries like the Windows clients do. If the OCIBreak() call hangs, we kill then run using a kill() function. This yields an 8-bit exit code of 137. If the SQLCancel works, the client exits with an exit code of 2058; the 8-bit UNIX exit code for it is 207.

  • Modified the EBCDIC to ASCII translation code for the Kafka Client to handle special characters (such as double quote) in strings that need to be changed to two-character sequences that use “\” as the force character.

  • Implemented the configuration file parameter suppress_delete_msgs that when set to True stops the Client from reporting data errors for DELETE operations that result in discards.

  • The Client ignores such discards, as the target records cannot be in the relational database because they have keys with data errors, they are not included in the discard count and they are not written to the table's discard file.

Client Manager Service

  • The service now resets the retry count when it gets a message from the client indicating that it is no longer getting an error. This patch fixes the bookkeeping error of the retry count for relaunched client.

  • The service occasionally crashed after receiving a BCNOTIFY request to launch a script.

  • Modified the service to not check the password for a console connection that originates from the 7.0 console, because it does its own password checking and passes the service an empty password.

  • The Client Manager Service was modified to support the 7.0 SP1 Administrative Console.

1.4 Known issues

  • The Databridge Console does not work with Java 9. You need to use the Java 8 JRE or an earlier version.

  • Starting with SQL Server 2016, enhanced security no longer allows you to add "NT AUTHORITY\SYSTEM" to the sysadmin role. We suggest one of the following two options to mitigate this problem:

    • Run the service under the user account that is setup to run the command line client (dbutility) and use Integrated Windows authentication.

    • Set up the client to use SQL Server authentication to connect to the database, and continue to run the service under the SYSTEM account

1.5 Security Guidelines

Databridge 6.6 Service Pack 1 Update 3 includes the following security guidelines:

Databridge component

To decrease security risk

Databridge Host

Install Databridge Host to the Unisys mainframe under its own privileged usercode. This is preferable to installing under the usercode of the DMSII database. If you install and run Databridge under multiple usercodes, you must install a copy of DBEngine under each of those usercodes.Alternatively, you can establish DBEngine as a system library (SL).

Databridge Client

File security helps to protect Client operations by restricting access to the working directory and its files and subdirectories. Access is limited to the administrators and the system account, and to designated users (or on Windows, user groups). In Windows, you can enable file security via the option Enable File Security at installation, or by running the program setfilesecurity.exe as Administrator after installation.From the UserID box and the DBAdministrator box, specify users who can run Databridge Client and modify the working directory and its files. User IDs specified in the DBOperator box can monitor operations by reading the log files, but cannot run Databridge ClientIn UNIX, you restrict file access via the umask entry in the file globalprofile.ini. See Install Databridge Client on UNIX.

Databridge Enterprise Server

File security is automatically enabled when you install Databridge Enterprise. File security protects the configuration and log files by restricting privileges on the PC to users who need to modify the configuration.By default, any user in the Administrators group can modify the configuration files and delete the read-only log files. If you create a user group in Windows called DBEAdmins, only the users in that group will be able to alter the configuration files and delete log files. Likewise, if you create a group called DBEUsers, only the users in that group will be able to view the configuration. For more information, see "Implementing File Security" in the Databridge Enterprise Server Help.

1.6 System Requirements

Databridge 6.6 Service Pack 1 Update 3 includes support for the following hardware and software requirements.

System Support Updates

Databridge will remove support for operating systems and target databases when their respective software company ends mainstream and extended support.

Databridge Host

Unisys mainframe system with an MCP level SSR 57.1 through 60.0

DMSII or DMSII XL software (including the DMALGOL compiler)

DMSII database DESCRIPTION, CONTROL, DMSUPPORT library, and audit files

Databridge Enterprise Server

ClearPath PC with Logical disks or MCP disks (VSS disks in MCP format)

-or-

Windows PC that meets the minimum requirements of its operating system, which is one of the following:

  • Windows Server 2019

  • Windows Server 2016 (CORE mode must be disabled for installation and configuration)

  • Windows Server 2012 R2 (CORE mode must be disabled for installation and configuration)

  • Windows Server 2012

  • Windows Server 2008 R2

Direct Disk replication (recommended) requires read-only access to MCP disks on a storage area network (SAN)

TCP/IP transport

To view the product Help, a supported Internet browser is required. In addition, JavaScript must be enabled in the browser settings to navigate and search Help.

Databridge Client Console

You can install Client Console to the same machine as the Client; however, this can drain resources and impact the performance of your relational database. Instead, we recommend that you install the Client Console to a machine that connects to the Client machine via TCP/IP transport.

Requires Java Runtime Environment (JRE). Download and install the latest version from Oracle. Install JRE version 8 as the Client will not run on JRE 9. For more information, see the Databridge Installation Guide.

Databridge Client

NOTE:Disk space requirements for replicated DMSII data are not included here. For best results, use a RAID disk array and store the client files on a separate disk from the database storage.

NOTE:Memory requirements do not include the database requirements when running the Client in the server that houses the relational database (consult your database documentation for these). The numbers are for a stand-alone client machine that connects to a remote database server.

If you run the console in the same machine as the Client, it will need an additional 1-2 GB of memory depending on how many data sources you have and how long you let it run. All log information is saved in memory.

Client - Windows

Unisys ES7000

-or-

Pentium PC processor 3 GHz or higher (multiple CPU configuration recommended)

2 GB of RAM (4 GB recommended)

100 GB of disk space in addition to disk space for the relational database built from DMSII data)

TCP/IP transport

One of the following operating systems:

  • Windows Server 2019

  • Windows Server 2016 (CORE mode must be disabled for installation and console cannot be run locally)

  • Windows Server 2012 R2 (CORE mode must be disabled for installation and console cannot be run locally)

  • Windows Server 2012

  • Windows Server 2008 R2

  • Windows 10

  • Windows 8.1

  • Windows 8

One of the following databases:

  • Microsoft SQL Server 2019

  • Microsoft SQL Server 2017

  • Microsoft SQL Server 2016

  • Microsoft SQL Server 2014

  • Microsoft SQL Server 2012

  • Microsoft SQL Server 2008 R2 (up to SP1)

  • Oracle 11g, 12c, 18c, and 19c

Client - UNIX and Linux

One of the following systems:

  • Sun Microsystems SPARCstation running Solaris 11 or later.

  • Hewlett Packard Itanium with HP-UX 11i v3 (B11.31) or later.

  • IBM pSeries running AIX 7.1 or later.

  • Intel X-86 with Red Hat Enterprise Linux Release 6 or later.

  • Intel X-86 with Red Hat SUSE Linux Enterprise Server 11 SP1 or later.

  • Intel X-86 with UBUNTU Linux 14.4 or later.

2 GB of RAM (4 GB recommended)

100 GB of free disk space for installation (in addition to disk space for the relational database built from DMSII data)

TCP/IP transport

One of the following databases:

  • Oracle 11g Release 2, 12c, 18c, or 19c (AIX, Linux and Solaris only)

NOTE:Oracle 12c, 18c, and 19c clients exist only as 64-bit programs.

NOTE:If you are using Oracle 11g, we strongly recommend that you upgrade Oracle 11g release 2, as the client is designed for this version of Oracle.

2.0 Version 6.6 SP1 Update 2

released December 2020

2.1 Features and fixes

Databridge 6.6 Service Pack 1 Update 2 introduced several fixes and improvements to Databridge components and utilities.

  • Support for Oracle 19c for Windows, AIX, Linux, HP-UX (Itanium) and Solaris Clients

  • Support for SQL Server 2019

  • Support for Windows Server 2019

  • Numerous bug fixes for the base release (see "Patch Notes" section)

  • Added the configuration parameter "use_bcp" (in the "bulk_loader" section) to avoid having to use the /l option to force the client to use bcp. This option requires a Redefine All command before it will take effect.Implemented the environment variable DBRIDGE_PROFILE for UNIX/Linux Clients to allow customers using multiple clients to use different file names for "globalprofile.ini"

  • Update 2 includes two host containers: DB66-06-SP1-U2 and DB66-06-SP1-U2-ETA. The two containers are identical except for the COMPILERTARGET and compiler versions used to generate the object files.

    • DB66-06-SP1-U2 is compiled with COMPILERTARGET = LEVEL5, 58.1 compilers.

    • DB66-06-SP1-U2-ETA is compiled with COMPILERTARGET = LEVEL6, 60.0 compilers.

  • LEVEL5 software will not run on the upcoming MCP 20/62.0 release. Additionally, LEVEL6 software will not run on DELTA/EPSILON systems. It is suggested that DB66-06-SP1-U2-ETA be used to install this update unless your system is incapable of running LEVEL6 software.

3.0 Installation Instructions for Hot Fixes, Updates, and Service Packs

Before you install a hot fix, update, or service pack, quit all Databridge applications including the Console, and then terminate the service (daemon on UNIX).

After the installation is complete, restart the service/daemon manually.

IMPORTANT:If you're updating the Client software, you must also update the Client Console because the older console is incompatible with the 6.6 service.

To avoid potential problems, we strongly recommend that you upgrade the Databridge Host and Enterprise Server software simultaneously.

3.1 Databridge Host

  1. On the MCP Server, upload DB66xxxxx using binary or image file transfer (where xxxx is a string of characters that identifies the type of release).

    ftp my_aseries_host
    <login>
    bin
    put DB66xxxxx DB66xxxxx
  2. Log on to the MCP using Databridge USERCODE and go to CANDE.

  3. Extract the install WFL from the above-mentioned file, using the following command:

    WFL UNWRAP *WFL/DATABRIDGE/INSTALL AS WFL/DATABRIDGE/INSTALL OUTOF DB66xxxxx
  4. Run the Databridge install file to apply the patch.

    START WFL/DATABRIDGE/INSTALL

    If installing the Databridge software to a different pack family than the primary pack of the FAMILY substitution statement (FAMILY DISK = primarypack OTHERWISE secondarypack), use this command instead.

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

    NOTE:This procedure is identical to the steps to install the base release.

    The container file DISKINSTALL is provided for backward compatibility, and you can also get it from the DB66xxxxx container file. Alternatively, you can upload DISKINSTALL and get the INSTALL WFL by unwrapping this file.

3.2 Databridge Client, Client Console, and Enterprise Server

  • On Windows, open the Windows64 folder of the Hot Fix, Update or Service Pack and double-click the file databridge-6.6.bbbb-xxxxx-W64.exe, where bbbb is the 4-digit build number and xxxxxx is "hotfix", "update" or "servicepack."

    All installed components such as the Client, the Console, or Enterprise Server will be updated.

  • On UNIX, upload the appropriate tar files for the Client and Console from the hot fix, update or service pack to the directories where these components are installed. (Ideally, the Client and Console should be installed in separate directories to facilitate maintenance.) If you use Windows to process the extract of the tar file from the zip file, you must transfer the tar file to UNIX using binary FTP.

    Then, use the following command:

    tar -xvf <filename>

    where <filename> is the full name of the tar file. This command replaces the files in the Databridge install directory with updated files from the tar file.

    NOTE:To avoid accidentally deleting the Databridge applications, we recommend that you always keep the install directory and the working directory separate.