SEND (3270 display)

Write data to a 3270 information display system (TCAM).

Read syntax diagramSkip visual syntax diagram
SEND (3270 display)

>>-SEND--FROM(data-area)--+-LENGTH(data-value)--+--------------->
                          '-FLENGTH(data-value)-'   

>--+------------+--+------+------------------------------------->
   '-DEST(name)-'  '-WAIT-'   

>--+-+----------------------+--+---------------------+-+-------><
   | '-ERASE--+-----------+-'  '-CTLCHAR(data-value)-' |   
   |          +-DEFAULT---+                            |   
   |          '-ALTERNATE-'                            |   
   '-+----------+--------------------------------------'   
     '-STRFIELD-'                                          

Conditions: INVREQ, LENGERR

 

Description

SEND writes data to a terminal.

Options

ALTERNATE
sets the terminal to use the ALTERNATE screen size.
CTLCHAR(data-value)
specifies a 1-byte write control character (WCC) that controls a SEND command for a 3270. These are documented in the IBM 3270 Data Stream Programmer's Reference. A COBOL user must specify a data area containing this character. If the option is omitted, all modified data tags are reset to zero and the keyboard is restored.
DEFAULT
sets the terminal to use the DEFAULT screen size.
DEST(name)
specifies the 4-byte symbolic name of the TCAM destination to which the message is to be sent. This option is meaningful only for terminals defined using DFHTCT TYPE=SDSCI with DEVICE=TCAM.
Note: Start of changeIn CICS® TS 3.1, local TCAM terminals are not supported. The only TCAM terminals supported are remote terminals connected to a pre-CICS TS 3.1 terminal-owning region by the DCB (not ACB) interface of TCAM. End of change

If you use the DEST option, you must be aware of any restrictions placed on device-dependent data streams by the message control facility in use.

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 resource definition.

FLENGTH(data-value)
A fullword alternative to LENGTH.
FROM(data-area)
specifies the data to be written to the logical unit or terminal.
LENGTH(data-value)
specifies the length, as a halfword binary value, of the data to be written. For a description of a safe upper limit, see LENGTH options in CICS commands.
STRFIELD
specifies that the data area specified in the FROM option contains structured fields. If this option is specified, the contents of all structured fields must be handled by the application program. The CONVERSE command, rather than a SEND command, must be used if the data area contains a read partition structured field. (Structured fields are described in the CICS 3270 Data Stream Device Guide.)

CTLCHAR and ERASE are mutually exclusive with STRFIELD, and their use with STRFIELD generates an error message.

WAIT
specifies that processing of the command must be completed before any subsequent processing is attempted.

If the WAIT option is not specified, control is returned to the application program when processing of the command has started. A subsequent input or output request (terminal control, BMS, or batch data interchange) to the terminal associated with the task causes the application program to wait until the previous request has been completed.

Conditions

INVREQ
RESP2 values:
200
occurs if a distributed program link server application attempted to send on its function-shipping session (its principal facility)

Default action: terminate the task abnormally.

LENGERR
occurs if an out-of-range value is supplied in the LENGTH or FLENGTH option.

Default action: terminate the task abnormally.