Using the RECEIVE MAP command

The RECEIVE MAP command causes BMS to format terminal input data and make it accessible to your application program.

The command specifies:

Which map to use in formatting the input data stream—that is, what format is on the screen and what data structure the program expects (the MAP option)
Where to find this map (MAPSET option)
Where to get the input (TERMINAL or FROM option)
Whether to suppress translation to uppercase (ASIS option)
Where to put the formatted input data (the INTO and SET options)

The MAP and MAPSET options together tell BMS which map to use, and they work exactly as they do on a SEND MAP command.

BMS gets the input data to format from the terminal associated with your task (its principal facility), unless you use the FROM option. FROM is an alternative to TERMINAL, the default, used in relatively unusual circumstances (see Formatting other input).

BMS also translates lowercase input to uppercase automatically in some cases; we explain how to control translation in Uppercase translation.

You tell BMS where to put the formatted input with the INTO or SET option of RECEIVE MAP.

In addition to the data on the screen, the RECEIVE MAP command tells you where the operator last used the cursor and what key caused transmission. This information becomes available in the EIB on completion of the RECEIVE MAP command. EIBAID identifies the transmit key (the “attention identifier” or AID), and EIBCURSR tells you where the cursor was last located.