DML Precompiler-Directive Statements › #MRB

#MRB

The #MRB statement establishes a map request block (MRB) in the program's variable storage area. It allocates storage, but does not initialize that storage. For each mapping request, the MRB communicates between the program and the mapping compiler. A separate MRB must be defined for each map used by a program. The DML precompiler uses map information stored in the dictionary to determine the actual size of the MRB, and generates the necessary Assembler DS instructions with macros.

One or more #MRB statements can be copied into the program by using the @COPY IDMS statement, discussed earlier in this chapter.

Syntax

►►─── #MRB MAPNAME=map-name ──────────────────────────────────────────────────►

 ►─── ,FIELDS=field-count ────────────────────────────────────────────────────►

 ►─── ,RECORDS=record-count ──────────────────────────────────────────────────►◄

Parameters

MAPNAME=map-name

Specifies the 1- to 8-character name of an existing map.

FIELDS=

Specifies the number of data and response fields in the specified map.

field-count

Absolute expression of the number of fields.

RECORDS=

Specifies the number of records in the map.

record-count

Absolute expression of the number of records.