The Dictionary Feature - mfx - 3.1

Syncsort™ MFX Programmers Guide

Product type
Software
Portfolio
Integrate
Product family
Syncsort™ Software
Product
Syncsort™ MFX > MFX
Version
3.1
Language
English
Content type
Programmer’s Guide
Product name
Syncsort™ MFX
Title
Syncsort™ MFX Programmers Guide
Copyright
2024
First publish date
2010
Last updated
2024-11-06
Published on
2024-11-06T17:38:26.716054

The MFX Dictionary Feature allows you to create symbolic ‘dictionary_names’ for fields, constants, or output columns, and use these dictionary_names in MFX control statements.

Using the Dictionary Feature has many benefits:

  • Easier coding of control statements speeds development of applications and improves accuracy.

  • More readable and understandable control statements facilitate debugging and adaptation to changes in the future.

  • Reducing or eliminating changes to control statements when record layouts change saves time and reduces errors.

To use the MFX Dictionary Feature, do the following:

  • Build a symbols dictionary using the dictionary statements. A dictionary statement creates a dictionary_name and associates it with a constant value, field specification (position, length, format), or a parsed field.

  • Activate the Dictionary Feature using the SYMNAMES DD statement. This DD tells MFX the name and location of the symbols dictionary to use. You can include multiple dictionaries by concatenating data sets.

  • Use dictionary_names in control statements.

You may also use JCL statements with SET symbols or PROC symbols to establish dictionary_names. See Using JCL SET and PROC Symbols to Create Dictionary_Names.

A dictionary consists of one or more dictionary statements. A dictionary can be a sequential data set, a member of a PDS, or it can be placed immediately after the SYMNAMES DD statement (DD *).

Each time MFX executes with the Dictionary Feature activated by the SYMNAMES DD, it reads the dictionary statements from the symbols dictionary, and substitutes any dictionary_name found in the following control statements with the associated field specification or constant.

When a record layout changes, just modify the dictionary statements. The next sort execution will read in the updated dictionary statements and apply the new values during dictionary_name substitutions.