ECN-4678 Two new fields added to C$REDIRECT I/O linkage handlers

Incidents:
  • 3231462
  • 3231463
RPI Numbers:
  • 1120623
  • 1120625

Product: ACUCOBOL-GT

Module: Runtime

Machines Affected: N/A

DESCRIPTION:

Two new fields have been added to the linkage item passed to C$REDIRECT I/O handlers:

HANDLER-SEQUENTIAL-TYPE
Contains the type of sequential file. Values are the same as defined for SEQ-TYPE in def/filesys.def.
HANDLER-RELATIVE-KEY
Contains the relative key for relative files. Changes made to this field by the handler will be returned to the runtime's key value for the file after the handler returns.

In previous versions, handler.cpy only contained the latest version of the current linkage item. handler.cpy has been replaced with three versions of the file, each containing one of three revisions to the linkage item.

To access the new fields, do one of the following:

  • Set a symbolic link (or similar) from handler.cpy to a new version of the file that contains the desired version of the linkage item. This option enables future updates without disturbing existing code that uses an older version of the linkage item.
  • Update your source code to reference the desired version of the linkage item.

Example:

  1. Include handlern.cpy in the I/O handler program.
  2. Set HANDLER-VERSION to n before registering the I/O handler with the runtime with C$REDIRECT.
    Important: Be sure that HANDLER-VERSION matches the version of the linkage item included in your code.