CICS Manual do Usuário - SEND TEXT

SEND TEXT

Sends data without mapping.

Sintaxe:

Condições: INVREQ, LENGERR

Descrição:

The text is split into lines that are the same width as the terminal, such that words are not broken across line boundaries.
If the text exceeds a page, it is split into pages that fit on the terminal.

The first byte of each line on the screen is reserved for either a blank or a new-line (NL) character.
Therefore, the text is placed with the first character positioned in row 1, column 2.

If the data cannot fit on one screen, it is wrapped back to the beginning of the screen (row 1, column 2), overwriting the previous page of text.
If the ERASE option is specified, the previous page is cleared before the current page is written.

Restrição: Datastreams that are larger than 4096 bytes cannot be sent with a single SEND TEXT command.
Use multiple SEND TEXT commands to split the data if it is larger than 4096 bytes.

Currently a restriction exists on the number of bytes that TXSeries for Multiplatforms can handle on a SEND TEXT command.
Because CICS uses 12-bit addressing, the total number of bytes cannot be greater than 4096.
This restriction also applies if the data being that is sent extends beyond line 31.

Nota:: If the data is also being sent to a standard printer, the lower half of the printer display (line 32 and beyond) cannot be displayed.

Opções:

ALARM

Specifies that the alarm feature is to be activated.

CURSOR(data-value)

Specifies, as a 16-bit binary value, the position to which the cursor is to be returned on completion of a SEND TEXT command.
The value that is specified must be greater than zero.
A negative value causes the cursor to be positioned at the upper left corner of the screen; that is, position zero.

ERASE

Specifies that the screen or printer buffer is to be erased and the cursor returned to the upper left corner of the screen.
The first output operation in any transaction, or in a series of pseudoconversational transactions, should always specify ERASE.

FORMFEED

Specifies that a new page is required. The FORMFEED character is positioned at the start of the buffer.
The application program must therefore ensure that this buffer position is not overwritten by map or text data.

FREEKB

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

FROM(data-area)

Specifies the data area that contains the data that is to be sent.

LENGTH(data-value)

Specifies the length of the data that is to be sent as a 16-bit binary value.
For a description of a safe upper limit, see LENGTH.
See LENGTH for more information about using this option.

NLEOM

Specifies that data should be built with blanks and new-line (NL) characters, and that an end-of-message (EOM) character should be placed at the end of the data.
When the data is printed, each NL character causes printing to continue on the next line, and the EOM character terminates printing.
The NLEOM option overrides the ALARM option if the latter is present.

Specifies that a print operation is to be started at a printer.
If this option is omitted, the data is sent to the printer buffer but is not printed.
Printed text is formatted such that words are not broken across line boundaries and, if the text exceeds a page, it is split into pages.

Condições:

INVREQ

An attempt is made to issue a SEND TEXT command from a remotely linked-to program.
Ação pré-definida: Terminates the task abnormally.

LENGERR

Occurs if an out-of-range value is supplied in the LENGTH option (zero is acceptable).
Ação pré-definida: terminate the task abnormally.

Exemplos:

CICS for Windows

To print data sent with SEND TEXT use either EXEC CICS START or CECI START, as shown:

      EXEC CICS START TRANSID(tranid)
                TERMID(termid)
      END-EXEC.
 
CECI START TRANSID(tranid) TERMID(termid)

where tranid is the application that issues the SEND TEXT PRINT command, and termid is the printer model entry that is defined in the Terminal Definitions (WD).

Informações relacionadas: