DML Precompiler-Directive Statements › DECLARE MAP

DECLARE MAP

The DECLARE MAP statement:

• Indicates to the DML precompiler that your program uses mapping-mode terminal I/O
• Defines the program's maps

Repeat the DECLARE MAP statement as many times as required to define each map used by your program. Code DECLARE MAP statements for all of your maps before the first INCLUDE IDMS statement.

Syntax

►►─── DECLARE (map-name MAP ─┬──────────────────────────┬─ ) ─────────────────►
                             └─ VERSION version-number ─┘

 ►─┬────────────────────────────────────────────┬─ ; ─────────────────────────►◄
   └─ TYPE ( ─┬─ STANDARD ◄ ─┬─ ) ─┬──────────┬─┘
              └─ EXTENDED ───┘     └─ PAGING ─┘

Parameters

map-name MAP

Specifies the name of a map used by the program. Map-name must be the 1- to 8-character name of a map defined in the dictionary.

VERSION version-number

Optionally qualifies the named map with a version number. Version-number must be an integer in the range 1 through 9999 that is associated with the named map in the data dictionary.

TYPE

Specifies whether the map request block (MRB) built for the map will be standard or extended.

STANDARD

Specifies that the map has standard 3270 terminal attributes. STANDARD is the default.

EXTENDED

Specifies that the map has extended 3279 terminal attributes. You can use such mapping features as color, blinking fields, and reverse video for your application programs running under 3279-type terminals.

PAGING

Specifies that the named map is a pageable map. For more information on pageable maps, see MAP IN (DC/UCF) , and MAP OUT (DC/UCF), or refer to the CA IDMS Mapping Facility Guide.

Example

The following example illustrates how to use the DECLARE MAP statement to access the EMPMAPLR map:

DECLARE (EMPMAPLR MAP);