Exception Conditions
INVMPSZ
occurs if the specified map is too wide or too long for the terminal.
Default action: Terminate the task abnormally.
INVREQ
RESP2 values: v
200
A SEND MAP command is issued for a map without field specifications by specifying the FROM option without the DATAONLY option.
The command is issued in a DPL server program.
Default action: Terminate the task abnormally.
NOTAUTH
RESP2 values:
70
A resource security check has failed on MAPSET(name).
Default action: Terminate the task abnormally.
SEND TEXT
(
Send text data without mapping.
data-area
)
LENGTH (
data-value
) CURSOR (
data-value
)
FORMFEED ERASE PRINT FREEKB ALARM NLEOM WAIT
Conditions:
INVREQ
Description
The SEND TEXT command sends text data without mapping.
The text is split into lines of 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 with application-defined headers and trailers.
For further information about SEND TEXT, see “Text processing” on page 164.
Options
ALARM
specifies that the audible alarm feature is to be activated.
CURSOR(
data-value
)
specifies as a halfword binary value the position to which the cursor is to be returned on completion of a SEND TEXT command.
The supplied value gives the cursor position relative to zero; the range of possible values depends on the size of the screen being used.
The value specified in the CURSOR option must be positive. A negative value leads to unpredictable results.
Chapter 32. Application programming commands - reference
439
ERASE
specifies that the screen printer buffer is to be erased and the cursor returned to the upper left corner of the screen before this page of output is displayed.
The first output operation in any transaction, or in a series of pseudoconversational transactions, should always specify ERASE. For transactions attached to 3270 or 5250 screens or printers, this also ensures that the correct screen size is selected, as defined for the transaction using the
ADDCICSPCT CL command. This command is described in the
CICS/400
Administration and Operations Guide
.
5250 screens are automatically erased to avoid possible device errors.
FORMFEED
specifies that a new page is required. The FORMFEED character is positioned at the start of the display or printer buffer. The application program must thus ensure that this buffer position is not overwritten by the map or text data.
FREEKB
specifies that the 3270 keyboard is to be unlocked. If FREEKB is omitted, the keyboard remains locked. This option has no effect on 5250 keyboards.
FROM(
data-area
)
specifies the data area containing the data to be sent.
LENGTH(
data-value
)
specifies as a halfword binary value the length of the data to be sent. For a
description of a safe upper limit, see “LENGTH options” on page 312.
NLEOM
specifies that data for a 3270 or SCS printer is to be built with blanks and new-line (NL) characters, and that an end-of-message (EM) character is to be placed at the end of the data. As the data is printed, each NL character causes printing to continue on the next line, and the EM character terminates printing.
This option must be specified in the first SEND TEXT command used to build a logical message. The option is ignored if the device receiving the message is not a 3270 or SCS printer.
The NLEOM option overrides the ALARM option if the latter is present.
PRINT
specifies that a print operation is to be started at a 3270 or SCS printer, or that data on a 3270 display is to be printed on a printer allocated by the controller.
If this option is omitted, the data is sent to the printer buffer but is not printed.
WAIT
specifies that control should not be returned to the application program until the output operation has been completed.
If WAIT is not specified, control returns to the application program when the output operation has started. A subsequent input or output request (terminal control or BMS) causes the application program to wait until the previous request has been completed.
Exception Conditions
INVREQ
RESP2 values:
200
The command is issued in a DPL server program.
Default action: Terminate the task abnormally.
440
CICS for iSeries Application Programming Guide V5
