CICS SEND TEXT

CICS Return CICS Send Control

Advertisements


SEND-TEXT can be sent to the terminal without any predefined BMS maps.

SEND TEXT has all the options like below.

  1. If the text exceeds a line, SEND TEXT can split it up into multiple lines without splitting words.
  2. If the text exceeds a page, SEND TEXT can split into multiple pages that can be according to the terminal size.

The very first byte of the screen is reserved.

It can be used to place a blank or new line character.

The data text can be placed from row1 and column 2 on the screen.

If the data is exceeds a page, then ERASE option needs to be coded along with SEND TEXT to clear the screen before next SEND TEXT.

Otherwise, the screen will not be cleared and the data will be overwritten on the screen which may produce unpredictable results.

Single SEND TEXT command can be sent up to 4096 bytes in a single execution.

If the data stream is greater than 4096 bytes, then multiple SEND TEXT commands needs to be coded to pass the data.


Lets discuss each one individually.

FROM(input-data-area)

Specifies the data area that is to be processed.

FROM needs to be coded always along with SEND TEXT command.

Otherwise, EMPTY screen will be displayed.

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.

CURSOR(cursor-data-value):

This is an optional entry in SEND TEXT.

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

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

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.

PRINT:

This is an optional entry in SEND TEXT.

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

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

Specifies the alarm option to be activated for SEND TEXT.

NLEOM:

This is an optional entry in SEND TEXT.

Specifies that the below things while data text build.

data should be created along with spaces

new line(NL) characters should be included

End of Message character should be included at the end of message.

These new line and EOM characters mainly useful while printing to specify how to print and when to terminate.

NLEOM option overrides the ALARM option if the ALARM option is specified after NELOM.

Error Conditions:

INVREQ:

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

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

LENGERR:

LENGERR occurs if the range of the value is out of the range of the data specified where as ZERO length value is accepted.


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


CICS Return CICS Send Control

Advertisements