Send data without mapping. The keywords are separated into those supported by standard and full BMS. For further information about BMS, see Basic mapping support.
SEND TEXT Standard BMS >>-FROM(data-area)--+--------------------+----------------------> '-LENGTH(data-value)-' >--+--------------------+--+----------+-------------------------> '-CURSOR(data-value)-' '-FORMFEED-' >--+----------------------+--+-------+--+--------+--+-------+---> '-ERASE--+-----------+-' '-PRINT-' '-FREEKB-' '-ALARM-' +-DEFAULT---+ '-ALTERNATE-' >--+-------+--+---------------+---------------------------------> '-NLEOM-' '-FMHPARM(name)-' >--+-+----------------+--+----------------+-+-------------------> | '-OUTPARTN(name)-' '-ACTPARTN(name)-' | '-LDC(name)------------------------------' >--+-----------------+----------------------------------------->< '-MSR(data-value)-'
SEND TEXT Full BMS .-TERMINAL---------------------. >>-+------------------------------+--+-------------+------------> +-SET(ptr-ref)-----------------+ '-REQID(name)-' +-PAGING-----------------------+ '-TERMINAL--+------+--+------+-' '-WAIT-' '-LAST-' >--+-------------------+--+--------------------+----------------> '-HEADER(data-area)-' '-TRAILER(data-area)-' .-HONEOM-. >--+---------------------+--+-------+--+--------+-------------->< +-JUSTIFY(data-value)-+ '-ACCUM-' +-L40----+ +-JUSFIRST------------+ +-L64----+ '-JUSLAST-------------' '-L80----'
Conditions: IGREQCD, IGREQID, INVLDC, INVPARTN, INVREQ, LENGERR, RETPAGE, TSIOERR, WRBRK
SEND TEXT 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.
When using the SEND TEXT command with any of the ALARM, FREEKB, FRSET, HONEOM, L40, L64, L80, or PRINT options, see DFHMDI options, CTRL for a description of the option priority.
HEADER, JUSFIRST, JUSLAST, JUSTIFY and TRAILER all imply ACCUM.
This option is ignored if the target terminal does not support partitions, or if there is no application partition set.
The data value must be a halfword binary value that specifies the cursor position relative to zero; the range of values that can be specified depends on the size of the screen being used.
This option overrides any IC option of the ATTRB operand of DFHMDF. If ACCUM is being used, the most recent value of CURSOR specified is used to position the cursor.
The value specified in the CURSOR option must be positive. A negative value leads to unpredictable results.
The first output operation in any transaction, or in a series of pseudoconversational transactions, should always specify ERASE. For transactions attached to 3270 screens or printers, unless explicitly overridden by the DEFAULT or ALTERNATE option, this also ensures that the correct screen size is selected, as defined for the transaction by the SCRNSIZE option in the RDO PROFILE definition.
The FORMFEED option can appear on any SEND TEXT ACCUM command. You need only specify it once within a physical page because it always forces a FORMFEED at the start of the physical page. To force a FORMFEED at the start of a particular SEND TEXT ACCUM command, use the JUSFIRST option instead.
When using the FREEKB option, see DFHMDI options, CTRL for a description of the option priority.
Note that the keyboard lock status is maintained separately for each partition on a terminal that supports partitions.
See Header and trailer format for more information.
When using the HONEOM option, see DFHMDI options, CTRL for a description of the option priority.
When an LDC is specified, BMS uses the device type, the page size, and the page status associated with the LDC mnemonic to format the message. These values are taken from the extended local LDC table for the logical unit, if it has one. If the logical unit has only a local (unextended) LDC table, the values are taken from the system LDC table. The numeric value of the LDC is obtained from the local LDC table, unless this is an unextended table and the value is not specified, in which case it is taken from the system table.
When using the options, see DFHMDI options, CTRL for a description of the option priority.
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 (direct or routed) is not one of those mentioned above.
If this option is used, buffer updating and attribute modification of fields previously written into the buffer are not allowed. CICS includes the ERASE option with every write to the terminal.
The NL character occupies a buffer position. A number of buffer positions, equivalent to the value of the RDO TYPETERM options PAGESIZE or ALTPAGE for that terminal, is unavailable for data. This may cause data to wrap around in the buffer; if this occurs, the PGESIZE value must be reduced.
The NLEOM option overrides the ALARM option if the latter is present.
If PAGING is specified with a REQID prefix that is used for temporary storage queues that are defined as recoverable, CICS provides message recovery for logical messages if the task has reached a syncpoint.
When using the PRINT option, see DFHMDI options, CTRL for a description of the option priority.
BMS message recovery is provided for a logical message only if the PAGING option is specified in the BMS SEND commands and if the syncpoint has been reached.
The application program regains control either immediately following the BMS SEND command (if the current page is not yet completed), or at the label specified in a HANDLE CONDITION RETPAGE command if the page has been completed.
If TIOAPFX=YES is specified in the map definition, the pointer returned contains the address of the TIOA prefix. The user data starts at offset X'0C' from the start of the TIOA prefix.
See the Header and trailer format for more information.
If WAIT is not specified, control returns to the application program when the output operation has started. A subsequent input or output command (terminal control, BMS, or batch data interchange) causes the application program to wait until the previous command has been completed.
Default action: terminate the task abnormally.
Default action: terminate the task abnormally.
Default action: terminate the task abnormally.
Default action: terminate the task abnormally.
Default action: terminate the task abnormally.
Default action: terminate the task abnormally.
Default action: return control to the application program at the point immediately following the BMS SEND TEXT command.
Default action: terminate the task abnormally.
Default action: ignore the condition.