CICS SEND MAP

CICS Pseudo Conversation CICS Receive Map

Advertisements


Used to send map to the terminal.

Used to send mapped data to the terminal through application program.

Before executing the SEND command, the application program should prepare the data in the symbolic map area layout.

If FROM is not coded, then CICS automatically finds the symbolic map area (mapname+O) for the corresponding MAP and fill the MAP from the layout data and send it to the terminal.

Let’s discuss options one by one.

MAP(map-name):

Specifies the map name that used to identify the map.

Map name can be up to 7 characters long.

Map name is an optional entry in SEND MAP.

If the Map name is not a literal, FROM is required.

If FROM is not specified, it will try to get the data from the data area corresponding to map name.

MAPSET(mapset-name):

Specifies the map set name that used to be added under.

Mapset name can be 7 character long and contains alphabetic and numbers.

Mapset should be defined under program definitions.

Mapset should be resides under CICS maps directory.

Providing Mapset information is optional in SEND MAP.

If the Mapset information is not provided, CICS assumes that MAP name as a MAPSET name.

FROM(input-data-area):

Specifies the data area that is to be processed.

FROM Data area is optional.

If the FROM option is not specified, name defaults to the map name, suffixed with O in COBOL.

LENGTH(input-data-value):

Specifies the length of the data area that is to be formatted.

It should not exceed the length of the FROM data area.

It is a 16-bit binary value.

DATAONLY:

This is an optional entry in SEND MAP.

Specifies only application data program to be written.

The modification can be identified by using attribute byte.

Attribute byte will be associated with each field defined on the MAP.

The attribute byte value is X’00’ specifies that the field is unchanged.

If the attribute byte value is specified as other than X’00’, then field data modified.

MAPONLY:

This is an optional entry in SEND MAP.

Specifies only default MAP data to be written to the screen when SEND MAP executed.

It won’t add any data from application program to screen if MAPONLY option specified.

If the MAPONLY option is specified, FROM option is not required.

CURSOR(cursor-data-value):

This is an optional entry in SEND MAP.

Specifies the cursor position in the map while SEND MAP executed.

Cursor-data-value is a 16-bit binary field which contains the cursor relative value.

Cursor data value starts from 0 and depending on the size of the screen.

If no value specified, then the cursor will be positioned at the first un protected field of the MAP which is a symbolic position.

This value overrides the IC value of ATRRIB of DFHMDF macro.

The value specified in the cursor option must be positive and should be greater than zero.

If the negative value specified, then the cursor will be placed at the left most corner of the MAP which is of position zero.

FORMFEED:

This is an optional entry in SEND MAP.

Specifies about the new page is required or not while sending a MAP to screen.

FORMFEED character is positioned at the start of the buffer.

Application program has to be responsible for the overwriting of indicator.

The MAP or text area can have a chance to override the FORMFEED indicator.

ERASE:

This is an optional entry in SEND MAP.

Erase option responsible for the below three tasks.

Specifies screen buffer to be erased before sending the map to the screen.

Specifies the print buffer to be erased before sending the map to the screen.

Places the cursor to the upper left corner of the MAP before sending the map to screen.

The first output operation should specify the ERASE option to clear the screen before the map is displayed on the screen.

Otherwise, the new map will be overwritten on the existing screen without clearing it.

In a similar way, series of pseudo conversations also need ERASE option codes along with it to clear the screen always before output operation performed.

ERASEAUP:

This is an optional entry in SEND MAP.

ERASEUP will do only a task which is part of ERASE option.

ERASEUP erases all unprotected fields character locations on the screen before sending the map to the screen.

PRINT:

This is an optional entry in SEND MAP.

PRINT Specifies the printing of map needs to be started at printer.

If the PRINT option is specified, the map will be send to print buffer, but not to the printer.

FREEKB:

This is an optional entry in SEND MAP.

Specifies that the keyboard is to be unlocked after the data entered.

If the FREEKB option not specified, the data will still remain locked even though the data entered on the screen.

ALARM:

This is an optional entry in SEND MAP.

Specifies the alarm option to be activated for SEND MAP.

FRSET:

This is an optional entry in SEND MAP.

Specifies to reset all the Modified Data Tags (MDT) of all current map fields in terminal buffer.

The reset process will be completed before written the data to terminal buffer.

If the FRSET option is not specified, the MDT of previous transactions may overwritten the current SEND and might provide irrelevant results.

Error Conditions:

INVMPSZ:

INVMPSZ error occurs in two scenarios

• MAP is too wide for the terminal.

• MAP is too long for the terminal.

INVREQ:

INVREQ error occurs in below scenarios depending on the SEND MAP Conditions.

1. DATAONLY option is used and the length option is twelve or less.

2. Remotely linked program tries to execute SEND MAP command that refers other fecility.

3. An attempt to issue SEND MAP command from remote linked program that might be from different region.

LENGERR:

LENGERR occurs if the data mapped is of length of ZERO or negative value provided in legth field.


If any questions on the above, post your queries on CICS Discussion forum


CICS Pseudo Conversation CICS Receive Map

Advertisements