Receive screen input into an application data area, without reference to the principal facility, if any. Terminal characteristics are obtained from the MAPPINGDEV parameter. For further information about BMS, see the CICS® Application Programming Guide.
RECEIVE MAP MAPPINGDEV >>-RECEIVE MAP(name)--MAPPINGDEV(data-value)--FROM(data-area)---> >--+--------------------+--+--------------+---------------------> '-LENGTH(data-value)-' '-MAPSET(name)-' >--+-----------------+----------------------------------------->< +-INTO(data-area)-+ '-SET(ptr-ref)----'
Conditions: INVMPSZ, INVREQ, MAPFAIL,
RECEIVE MAP MAPPINGDEV allows the mapping of input data from a 3270 terminal that is not necessarily the principal facility of the transaction.
MAPPINGDEV specifies the name of a 3270 terminal whose BMS characteristics were used to create the input data stream. This may be a terminal from which the data was originally received using a RECEIVE command.
The value specified is moved into field EIBAID in the EXEC interface block on completion of the operation. No check is made that the AID value specified is valid.
If AID(data-value) is not specified, then the AID value defaults to X'7D' (the Enter key).
If the AID byte (either explicitly, or by default) indicates an operation other than CLEAR, PA1, PA2, or PA3, and CURSLOC=YES is specified for the map, then the field containing the cursor is flagged by setting the X'02' bit in its flag byte.
If the AID (whether specified explicitly, or by default) is the subject of a HANDLE AID command, the specified branch will be taken in the usual way.
The value specified is moved into EIBCPOSN in the EXEC interface block on completion of the operation. No check is made that the CURSOR value specified is valid.
If CURSOR(data-value) is not specified, then the cursor value defaults to X'0000'.
If "TASKDATALOC(ANY)" is specified for the running task, the data returned may be above or below the 16MB line.
If "TASKDATALOC(BELOW)" is specified for the running task,the data returned is below the 16MB line.
If "TASKDATAKEY(USER)" is specified for the running task, and storage protection is active, the data returned is in user-key. If "TASKDATAKEY(CICS)" is specified and storage protection is active, the data returned is in CICS-key.
Some of the following conditions may occur in combination. If more than one occurs, only the first is passed to the application program.
Default action: terminate the task abnormally.
Default action: terminate the task abnormally.
Default action: terminate the task abnormally.