Read a record from a data set.
ISSUE RECEIVE >>-ISSUE RECEIVE--+-INTO(data-area)-+--+-------------------+--->< '-SET(ptr-ref)----' '-LENGTH(data-area)-'
Conditions: DSSTAT, EOC, EODS, INVREQ, LENGERR, UNEXPIN
ISSUE RECEIVE reads a sequential data set in an outboard controller.
The INTO option specifies the area into which the data is to be placed. The LENGTH option must specify a data area that contains the maximum length of record that the program accepts. If the record length exceeds the specified maximum length, the record is truncated and the LENGERR condition occurs. After the retrieval operation, the data area specified in the LENGTH option is set to the record length (before any truncation occurred).
Alternatively, a pointer reference can be specified in the SET option. CICS® then acquires an area of sufficient size to hold the record, and sets the pointer reference to the address of that area. After the retrieval operation, the data area specified in the LENGTH option is set to the record length.
The outboard controller might not send the data from the data set specified in the ISSUE QUERY command. The ASSIGN command must be used to get the value of DESTID (which identifies the data set that has been transmitted) and the value of DESTIDLENG (which is the length of the identifier in DESTID).
If you specify the ISSUE RECEIVE command with the INTO option, the parameter must be a data area that specifies the maximum length of data that the program is prepared to handle. If the value specified is less than zero, zero is assumed. If the length of the data exceeds the value specified, the data is truncated to that value and the LENGERR condition occurs. On completion of the retrieval operation, the data area is set to the original length of the data.
If you have specified SET, you must also specify LENGTH.
If you specify the SET option, the parameter must be a data area. On completion of the retrieval operation, the data area is set to the length of the data.
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.
If you have specified SET, you must also specify LENGTH.
Default action: terminate the task abnormally.
Default action: ignore the condition.
Default action: terminate the task abnormally.
Default action: terminate the task abnormally.
Default action: terminate the task abnormally.
Default action: terminate the task abnormally.