Skip to main content

2024 December FeatureLog

View the various changes made to the FairCom documentation in the month of December

change log for December 2024

change logupdate lognew feature logDecember 2024Dec24
Description

FairCom has increased data flexibility and efficiency by creating a new variant data type. You can now store any type of data in a variant column, including a string, number, date, time, Boolean, image, JSON, XML, or user-defined data type, along with metadata that tells your application precisely what you stored in the column as well as the format and encoding of the data value. The database can also automatically store a value with multiple encodings along with the metadata that tells your application how it is encoded so your application can decode it.

Documents updatedInitial products and versions
  • FairCom DB 13.0.1

  • FairCom Edge 4.2.1

  • FairCom MQ 4.2.1

  • FairCom RTG COBOL 4.2.1

  • FairCom RTG Btrieve 4.2.1

Audience

Developers and Administrators

Source references

D1510

variant data type

variantvariant typedata typeJSON DB
Description

The FairCom server provides a setting in the setsyncstate script that can be used to configure the method of notifying administrators when replication becomes asynchronous which puts the server at risk of losing data during failover. For details, see Linux Pacemaker

Documents updatedInitial products and versions
  • FairCom DB 13.0.1

  • FairCom Edge 4.2.1

  • FairCom MQ 4.2.1

  • FairCom RTG COBOL 4.2.1

  • FairCom RTG Btrieve 4.2.1

Audience

Developers Administrators

Source references

D1439

Failover risk notification method

failover risknotificationnotify
Description

In the rare event of data corruption, quickly recover using our new tutorial for rebuilding indexes.

Documents updatedInitial products and versions
  • FairCom DB 13.0.1

  • FairCom Edge 4.2.1

  • FairCom MQ 4.2.1

  • FairCom RTG COBOL 4.2.1

  • FairCom RTG Btrieve 4.2.1

Audience

Developers and Administrators

Source references

D1131

tutorial to rebuild tables and indexes

Tutorialrebuild tablesrebuild indexes
Description

Upgrading FairCom RTG tables to the new RTG 5 resource format allows nearly all FairCom DB features to be applied to RTG tables. These features include the JSON DB API, dbNotify, partitioned files, hot alter table, replication, two-phase commit support, and full-text search. All COBOL and BTRV data types are now available in all FairCom products.

Documents updatedInitial products and versions
  • FairCom RTG COBOL 5.0.0

  • FairCom RTG Btrieve 5.0.0

Audience

Developers and Administrators.

Source references

D1492

Upgrade to RTG 5

UpgradeRTGv5JSON DB APIdbNotifypartitioned fileshot alter table
Hot_alter_table.png
Description

You can now alter an existing FairCom RTG table by adding columns without requiring file migration. This makes rolling out new application updates faster, easier, and less resource-intensive.

Documents updatedInitial products and versions
  • FairCom RTG COBOL 5.0.0

  • FairCom RTG Btrieve 5.0.0

Audience

Developers and Administrators

Source references

D1472

Hot Alter Table

Hot alter tableSQL alter tableAdd columnApplication update
partitioned_files.png
Description

You can now create tables as (or convert them to) partitioned files in FairCom RTG. This makes deleting large blocks of data very fast and efficient.

Documents updatedInitial products and versions
  • FairCom RTG COBOL 5.0.0

  • FairCom RTG Btrieve 5.0.0

Audience

Developers and Administrators.

Source references

D1547

Partitioned files in RTG

partitionfilesrtgtable
Description

RTG issues are now easier to diagnose since the Function Monitor (an RTG subsystem that logs API function calls sent to the server process) now shows the names of specific RTG functions.

Documents updatedInitial products and versions
  • FairCom RTG COBOL 5.0.0

  • FairCom RTG Btrieve 5.0.0

Audience

Developers and Administrators.

Function names in RTG function monitor

RTG function monitorFunction monitorLog
Description

Commands for RTG's command line tool (ctutil) have been added or enhanced to improve ease of use and to support new v5 features.

Documents updated

New commands:

  • -o word: Specifies the password of a file.

  • -unload: Allows you to read records larger than 64KB by exporting data from a COBOL data file to a sequential or ASCII file.

  • -info: Displays information about a file.

  • -applyrules: Applies rules to an XFD or XDD file.

  • -maxsize: Specifies a maximum size limit for a file.

Enhanced commands:

  • -conv: Stores or retrieves the numeric storage convention of a file. Enhanced to be able to do this even if the convention ID parameter is omitted.

  • -ddf2xdd: Transforms Btrieve Data Dictionary Files (DDFs) into c-tree XDD files containing schema information about the data and index structures. Enhanced to be able to do this even when the name in the DDF does not match the file name.

  • -alter: Changes the record schema of a file. Enhanced to display new record length on success.

  • -copy: Copies a file. Enhanced not to automatically overwrite existing destination files.

Initial products and versions
  • FairCom RTG COBOL 5.0.0

  • FairCom RTG Btrieve 5.0.0

Audience

Developers, Administrators.

New and updated RTG commands in ctutil

RTGctutilcommand line toolfile passwordunloadinfoapply rulesfile size maximumstorage conventionddfrecord schemacopy
Description

FairCom RTG is now compatible with new Btrieve operations that were not previously supported. We support the vast majority of applicable Btrieve functionalities.

Documents updatedInitial products and versions
  • FairCom RTG COBOL 5.0.0

  • FairCom RTG Btrieve 5.0.0

Audience

Developers and Administrators.

Source references

D1550

Enhanced Btrieve compatibility in RTG

RTGBTRVBtrievecompatibility
Description

You can now use new RTG substitution specifier "%o" to set applicable configuration options to return the server task ID of an affected instance. This can be helpful for troubleshooting or monitoring activity on a server.

Documents updatedInitial products and versions
  • FairCom RTG COBOL 5.0.0

  • FairCom RTG Btrieve 5.0.0

Audience

Developers and Administrators.

New RTG substitution specifier for server task ID

RTGsubstitution specifierserver task id
Description

You can now customize RTG log entries (specifically the portion that prints which client application logged the entry), allowing them to return more detailed information, or change their formats to work more smoothly with monitoring software.

Documents updatedInitial products and versions
  • FairCom RTG COBOL 5.0.0

  • FairCom RTG Btrieve 5.0.0

Audience

Developers and Administrators.

Customize format of client application logging in RTG

RTGlog entrycustomize
Description

RTG configuration option <datafilesuffix> can now be configured to disallow duplicating file name extensions using new options <datafilesuffix append> and <datafilesuffix casesensitive>. Previously, this could happen accidentally due to the automatic appending of a file name extension even if there was already one present, causing confusion (for example, accidentally naming something "filename.dat.dat").

Documents updatedInitial products and versions
  • FairCom RTG COBOL 5.0.0

  • FairCom RTG Btrieve 5.0.0

Audience

Developers and Administrators.

Prevent duplicate file name extensions in RTG

RTGfile nameextensionduplicate
Description

You can now set an RTG file's data file format to a previous version. This allows customers to upgrade to a newer RTG version with the ability to tell RTG to create new files with an older file format. This makes it possible to move files created with newer versions of RTG to previous versions.

Documents updatedInitial products and versions
  • FairCom RTG COBOL 5.0.0

  • FairCom RTG Btrieve 5.0.0

Audience

Developers and Administrators.

Source references

DOC-1532

Set RTG file's data file format to a previous version

versionpreviousprioroldrtgupgrade
Description

The ADO.NET SQL and CTDB drivers now support client certificate authentication. This enables replacing the normal password-based authentication with a more secure client certificate method.

Documents updatedInitial products and versions
  • FairCom DB 13.0.2

Audience

Developers , Administrators

Source references

DB-44

Client certificates in ADO.NET

TLSX509client certificateADO.NETauthentication
Would you like to provide feedback?