Receive initial input data from a 3600 pipeline logical unit. Subsequent RECEIVEs for further input data are not allowed.
RECEIVE (3600 pipeline) >>-RECEIVE--+---------------------+--+-LENGTH(data-area)--+-----> '-+-INTO(data-area)-+-' '-FLENGTH(data-area)-' '-SET(ptr-ref)----' >--+------------------------+--+------------+------------------>< +-MAXLENGTH(data-value)--+ '-NOTRUNCATE-' '-MAXFLENGTH(data-value)-'
Conditions: INVREQ, LENGERR, NOTALLOC
If data is to be received, you must specify either the INTO or the SET option. If a RECEIVE is issued purely to detect an attention identifier (AID) you can omit both the INTO and SET options.
If you specify the INTO option, but omit the MAXLENGTH option, the argument must be a data area that specifies the maximum length that the program accepts. If the value specified is less than zero, zero is assumed.
If you specify the SET option, the argument must be a data area. When the data has been received, the data area is set to the length of the data.
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 LENGTH 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 LENGTH option is set to the length of data returned.
If this option is omitted, the value indicated in the LENGTH option is assumed.
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.
Default action: terminate the task abnormally.
Default action: terminate the task abnormally.
Default action: terminate the task abnormally.