DFHMDI Macro


DFHMDI abbreviates as Defined Field Hierarchy Map Definition Interface. The DFHMDI macro defines a map within the map set defined by DFHMSD macro.

A map contains zero or more fields. It is a partition definition. DFHMDI used to define a map with its characteristics in MAPSET. One DFHMDI macro used for one Map definition.

map is the one- to seven-character name of the map. If the maps are used in a COBOL program and STORAGE=AUTO has not been specified in the DFHMSD macro, they must be specified in descending size sequence. Below syntax shows the most important options of DFHMDI macro -

Syntax -


DFHMDI Syntax

Options -


Most of the options described by considering COBOL is the programming language.

COLOR -


Specifies the color that used for the maps of the map set. This overrides the COLOR operand of the DFHMSD macro and can overridden by the COLOR operand of the DFHMDF macro for individual fields.

The color value can be overridden by individual COLOR parameter. Valid colors are - BLUE, GREEN, NEUTRAL, PINK, RED, TURQUOISE and YELLOW. If it is ignored, the default value of the output device is to be used as the basic color for this map.

COLUMN -


Specifies the starting column for the particular MAP. Column is a number from the left margin where the MAP needs to be displayed. If it is ignored, the MAP gets displayed from the left margin.

CTRL -


Specifies control actions that are to be performed when the map displaying on screen. Specifies the device control requests. CNTL= (FREEKB, PRINT, FSET, ALARM)

FREEKB is used to unlock the keyboard. FREEKB specifies the keyboard is to be unlocked after the map has been sent. If FREEKB is not specified, the keyboard remains locked and data entry from the keyboard is inhibited until this status is changed.

FRSET is used to reset the MDTs of all the fields in specific maps to zero before any map data is written to the buffer.

PRINT is used to send the map set to printer. Must be specified if the printer is to be started. If omitted, the data is sent to the printer buffer, but is not printed. if the map is used with 3270 displays, this operand is ignored.

ALARAM is specifies the alarm feature is to be activated.

DATA -


Specifies the format of the data. This parameter is supported only for compatibility with CICS mainframe.

FIELD specifies the data is passed as contiguous fields. This is the default operand.

HILIGHT -


Specifies default highlighting attribute for all named fields in the named map. This overrides the HILIGHT attribute specified in DFHMSD macro. This overridden by the HILIGHT operand of the DFHMDF macro for individual fields.

HILIGHT=OFF/BLINK/REVERSE/UNDERLINE

OFF is default and indicates no highlighting is used.

BLINK used to specify to field must blink.

REVERSE used to specify character or field displayed in reverse.

UNDERLINE used to underline the field. If the terminal doesn't support highlighting, these parameters is ignored.

JUSTIFY -


Specify the map to be positioned at the bottom of the screen. This operand applies to the SEND MAP command by providing the number of lines specified in the SIZE operand; otherwise, JUSTIFY parameter is ignored.

It allows the same map to be used for different screen sizes. If JUSTIFY=BOTTOM and the LINE operand both are specified, the value specified in LINE is ignored.

LINE -


Specifies the starting line number for the particular MAP. LINE number value ranges from 1 through 240.

SIZE -


Specifies the size of the map. An entry required for the SIZE option. Must specify two arguments namely line and column like below -

SIZE=(Line, Column) Line specifies depth of the map from 1 through 240.

Column specifies the width of the map from 1 through 240.These specifies the map size for the particular MAP.