CICS RECEIVE MAP

RECEIVE MAP command is used to fetch input data from a terminal into a data area in an application program for processing.

Syntax:

Below is the syntax for CICS RECEIVE MAP command.

EXEC CICS RECEIVE
   MAP('map-name')
   MAPSET('mapset-name')
   [INTO(data-area)]
   [FROM(data-area)]
   [LENGTH(data-value)]
END-EXEC.

Let us see the parameters used in the RECEIVE MAP command.

• MAP('map-name')

  Specifies the name of the map to be used.

• MAPSET('mapset-name')

  Specifies the name of the mapset to be used. It is needed unless mapset name is the same as the map name.

• INTO(data-area)

  Specifies the data area into which the mapped data is to be written. If this field is not specified, the name defaults to the name of the map suffixed with an I.

• FROM(data-area)

  Specifies the data area containing the data to be mapped by a RECEIVE MAP command.

• LENGTH(data-value)

  Specifies the length of the data to be formatted as a halfword binary value. It must not exceed the length of the FROM data area.

Example:

The following example shows you how to receive the input data into 'MAPNAMEI' field.

EXEC CICS RECEIVE
           MAP('map-name')
           MAPSET('mapset-name')
           INTO(MAPNAMEI)
END-EXEC.

If you have any doubts or queries related to this chapter, get them clarified from our Mainframe experts on ibmmainframer Community!