INVDTAMAP (Invoke Data Map) keyword in printer files

You use this record-level keyword to specify a data map that defines the layout of a formatted page.

A page definition is used to map the line data. Functions that can be done by different data maps in a page definition include multiple-up or rotated printing, changing fonts, and lines per inch.

The format of the keyword is:

INVDTAMAP(data-map-name | &data-map-name-field)

The data-map-name parameter is required and defines a data map in the page definition. This parameter is 8 characters. You can specify the data map name as a constant or program-to-system field.

When you specify the data-map-name parameter as a program-to-system field, the field must exist in the same record format as the INVDTAMAP keyword. It must be defined as length of 8, data type A (character), and usage P (program-to-system).

This keyword is valid with DEVTYPE(*LINE) or DEVTYPE(*AFPDSLINE). Also, a page definition must be specified on the print file. If DEVTYPE is changed to anything other than *LINE or *AFPDSLINE, the keyword will be ignored and a warning message will be issued at print time.

The INVDTAMAP, SKIP, and SPACE keywords are processed in the following order. If you specify this keyword at the field level, skipping is performed before the field prints.

 SKIPB
 SPACEB
 INVDTAMAP
 SPACEA
 SKIPA

Note: Feature Print Services Facility (PSF) is required to use this keyword. If PSF is not installed, you will not be able to print files by using this keyword, nor by specifying DEVTYPE(*LINE) or DEVTYPE(*AFPDSLINE).

The data map specified remains in effect for the remainder of the file unless changed by another INVDTAMAP keyword.

Option indicators are valid for this keyword.

Example

The following example shows how to specify the INVDTAMAP keyword.

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....
     A
     A          R RECORD1
     A  02                                  INVDTAMAP(MAP1)
     A          R RECORD2                   INVDTAMAP(&MAP)
     A            MAP           8A  P
     A

In the example, RECORD1 uses a new data map (MAP1). RECORD2 allows the application program to specify the name of data map by setting program variable MAP.