CICS SEND CONTROL

CICS Send Text CICS Program Execution from another prog

Advertisements


SEND CONTROL option used to send the control to the terminal.

This is dynamic way of sending the control to terminal.


Syntax:

EXEC CICS 

     SEND CONTROL
          CURSOR(cursor-data-value)
          FORMFEED
          ERASE
          ERASEAUP
          PRINT
          FREEKB
          ALARM
          FRSET
  
END-EXEC. 

Lets discuss each one individually.


CURSOR(cursor-data-value):

This is an optional entry in SEND CONTROL.

Specifies the cursor position in the map while SEND CONTROL 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 CONTROL.

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 CONTROL.

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 CONTROL.

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 CONROL.

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 CONTROL.

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 CONTROL.

Specifies the alarm option to be activated for SEND CONTROL.


FRSET:

This is an optional entry in SEND CONTROL.

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 overwrite the current SEND and might provide irrelevant results.


Error Conditions:


INVREQ:

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

Program tries to issue a SEND CONTROL command which is remotely linked to it.

Remotely linked to program tries to execute SEND CONTROL command that refers principal felicity.


CICS Send Text CICS Program Execution from another prog

Advertisements