Communicate on a 3270 information display system.
CONVERSE (3270 display) >>-CONVERSE--FROM(data-area)--+-FROMLENGTH(data-value)--+-------> '-FROMFLENGTH(data-value)-' >--+-INTO(data-area)-+--+-TOLENGTH(data-area)--+----------------> '-SET(ptr-ref)----' '-TOFLENGTH(data-area)-' >--+------------------------+--+------------+-------------------> +-MAXLENGTH(data-value)--+ '-NOTRUNCATE-' '-MAXFLENGTH(data-value)-' >--+-+----------------------+--+---------------------+-+--------> | '-ERASE--+-----------+-' '-CTLCHAR(data-value)-' | | +-DEFAULT---+ | | '-ALTERNATE-' | '-+----------+--------------------------------------' '-STRFIELD-' >--+------------+--+------+------------------------------------>< '-DEST(name)-' '-ASIS-'
Condition: LENGERR
CONVERSE communicates on a 3270 information display system.
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.
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.
If the value specified is less than zero, zero is assumed.
If the length of data exceeds the value specified and the NOTRUNCATE option is not present, the data is truncated to that value and the LENGERR condition occurs. The data area specified in the TOLENGTH option is set to the original length of data.
If the length of data exceeds the value specified and the NOTRUNCATE option is present, CICS retains the remaining data and uses it to satisfy subsequent RECEIVE commands. The data area specified in the TOLENGTH option is set to the length of data returned.
If no argument is coded for MAXLENGTH, CICS defaults to TOLENGTH.
If DATALOCATION(ANY) is associated with the application program, the address of the data can be above or below the 16MB line.
If DATALOCATION(BELOW) is associated with the application program, and the data resides above the 16MB line, the data is copied below the 16MB line, and the address of this copy is returned.
If TASKDATAKEY(USER) is specified for the running task, and storage protection is active, the data returned is in a user-key. If TASKDATAKEY(CICS) is specified and storage protection is active, the data returned is in a CICS-key.
CTLCHAR and ERASE are mutually exclusive with STRFIELD, and their use with STRFIELD generates an error message.
If the length of the data exceeds the value specified, but NOTRUNCATE is omitted, the data is truncated to that value, and the LENGERR condition occurs. When the data is received, the data area is set to the length of the data.
For a description of a safe upper limit, see LENGTH options in CICS commands.
Default action: terminate the task abnormally.