Send a page. Only supplied by full BMS. For further
information about BMS, see Basic mapping support.
SEND TEXT NOEDIT
>>-SEND TEXT NOEDIT--FROM(data-area)--+--------------------+---->
'-LENGTH(data-value)-'
>--+----------------------+--+-------+--+--------+--+-------+--->
'-ERASE--+-----------+-' '-PRINT-' '-FREEKB-' '-ALARM-'
+-DEFAULT---+
'-ALTERNATE-'
.-TERMINAL---------------------.
>--+----------------+--+------------------------------+--------->
'-OUTPARTN(name)-' +-TERMINAL--+------+--+------+-+
| '-WAIT-' '-LAST-' |
'-PAGING-----------------------'
.-HONEOM-.
>--+-------------+--+--------+---------------------------------><
'-REQID(name)-' +-L40----+
+-L64----+
'-L80----'
Conditions: IGREQCD, IGREQID, INVREQ, INVPARTN, TSIOERR,
WRBRK
Description
SEND TEXT NOEDIT sends a page
of a device-dependent data stream built by the application program.
The data stream cannot contain structured fields. This command differs
from a terminal control SEND, because the data stream may be written
to temporary storage and interfaced to the terminal operator paging
transaction (using the PAGING option). Also the device-dependent data
stream can be sent to a partition (using the OUTPARTN option).
If
the OUTPARTN option is specified, the data stream is sent to the specified
partition. This command is used to output a user-generated data stream.
It differs from a terminal control SEND in that data may be output
to temporary storage (using the PAGING option), or routed like any
other BMS data.
When using the SEND TEXT NOEDIT 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.
This command is supported
on full BMS only.
Options
- ALARM
- specifies
that the 3270 audible alarm feature is to be activated. For logical
units supporting FMHs (except interactive and batch logical units),
ALARM instructs BMS to set the alarm flag in the FMH.
- ALTERNATE
- sets
the terminal to use the ALTERNATE screen size.
- DEFAULT
- sets
the terminal to use the DEFAULT screen size.
- ERASE
- specifies
that the screen printer buffer or partition is to be erased and the
cursor returned to the upper left corner of the screen. (This option
applies only to the 3270, or 8775, and to the 3604 Keyboard Display.)
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.
- FREEKB
- specifies
that the 3270 keyboard should be unlocked after the data is written.
If FREEKB is omitted, the keyboard remains locked.
Note that the
keyboard lock status is maintained separately for each partition on
a terminal that supports partitions.
When using the FREEKB
option, refer to DFHMDI
options, CTRL for a description of the option priority.
- FROM(data-area)
- specifies
the data area containing the data to be sent.
- HONEOM
- specifies
that the default printer line length is to be used. This length should
be the same as that specified using the RDO TYPETERM options PAGESIZE
or ALTPAGE, and the same as the printer platen width; otherwise the
data may not format correctly.
When using the HONEOM option, refer
to DFHMDI options, CTRL for
a description of the option priority.
- LAST
- specifies
that this is the last output operation for a transaction and, therefore,
the end of a bracket. This option applies to logical units only.
- LENGTH(data-value)
- specifies
the length of the data to be sent as a halfword binary value. For
a description of a safe upper limit, see LENGTH options in CICS commands.
- L40, L64, or L80
- specifies the line length for a 3270
printer; a carrier return and line feed are forced after 40, 64, or
80 characters have been printed on a line. Unacceptable results are
likely if this differs from the page width specified by the RDO TYPETERM
options PAGESIZE or ALTPAGE.
When using the options, refer to
CTRL DFHMDI options, CTRL for
a description of the option priority.
- OUTPARTN(name)
- specifies
the name (1–2 characters) of the partition to which data is to be
sent. This option is ignored if the terminal does not support partitions,
or if there is no application partition set associated with the terminal.
If there is an application partition set, and the OUTPARTN option
is omitted, data is sent to the partition named by the PARTN operand
of the DFHMSD or DFHMDI map definition. If maps are not used, or if
there is no PARTN operand, the output is sent to the first partition
in the partition set.
- PAGING
- specifies
that the output data is not to be sent immediately to the terminal,
but is to be placed in temporary storage and displayed in response
to paging commands entered by the terminal operator.
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.
- PRINT
- specifies
that a print operation is to be started at a 3270 printer or at a
3275 with the printer adapter feature, or that data on an LUTYPE2
(3274/76 or 3790) 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.
When using the PRINT option, refer to DFHMDI options, CTRL for
a description of the option priority.
- REQID(name)
- specifies
a 2-character prefix to be used as part of a temporary storage identifier
for CICS message recovery. Only one prefix can be specified for each
logical message. The default prefix is **.
- TERMINAL
- specifies
that the data is to be sent to the terminal that originated the transaction.
- 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 command (terminal control,
BMS, or batch data interchange) causes the application program to
wait until the previous command has been completed.
Conditions
- 57 IGREQCD
- occurs
when an attempt is made to execute a SEND TEXT command after a SIGNAL
data-flow control command with a request change direction (RCD) code
has been received from an LUTYPE4 logical unit.
Default action:
terminate the task abnormally.
- 39 IGREQID
- occurs
if the prefix specified in the REQID option on a BMS SEND command
is different from that established by a previous REQID option, or
by default for this logical message—REQID (**).
Default action:
terminate the task abnormally.
- 65 INVPARTN
- occurs
if the specified partition is not defined in the partition set associated
with the application program.
Default action: terminate the task
abnormally.
- 16 INVREQ
- RESP2
values:
- 200
- Command not allowed for a distributed program link server program.
also occurs (RESP2 not set) in any of the following
situations:
- Text data is output to the same partition or LDC as mapped data
while a BMS logical message is active. If neither partitions nor LDCs
are in use, text data is output to the same logical message as mapped
data.
- During overflow processing, data is sent to a different LDC from
the LDC that caused page overflow.
- The length of a header on a SEND TEXT command is negative.
- The length of a trailer on a SEND TEXT command is negative.
Default action: terminate the task abnormally.
- 35 TSIOERR
- occurs
if there is an irrecoverable temporary storage input/output error.
Default action: terminate the task abnormally.
- 03 WRBRK
- occurs
if a SEND command is interrupted by the terminal operator pressing
the ATTN key. It applies only to the 2741 Communication Terminal,
and only if write break is supported for CICS.
Default action:
ignore the condition.