RECEIVE MAP - IBM Mainframe

The RECEIVE MAP command will receive data from the terminal and place the data into an application area in the program. After completion of the command, the inbound cursor position is placed in EIBCPOSN, and the terminal attention identifier (AID) placed in EIBAID. The keywords for the command are separated according to the BMS support function:

  • Minimum
  • Standard
  • Full-function

For receiving data, you must specify either the INTO or SET option. If the intent is solely to detect an attention identifier (AID), the INTO and SET options can be omitted. There are certain logical units that will not map the data, but is left unaltered. Data from certain logical units is not mapped, but is left unaltered. The syntax of the RECEIVE MAP command is given below:

Minimum BMS

Minimum BMS

Standard and Full BMS

An example of the RECEIVE MAP command is given below:

The various options of the RECEIVE MAP command are explained below:

  • ASIS - No upper/lower case translation is to occur on the data being received. This option does not take effect on the first RECEIVE command of a transaction, because terminal control performs a READ INITJAL and uses the terminal defaults to translate the data. For data already existing on the screen, this command has no effect. Only data read and translated in preparation for the next task and the first RECEIVE command in that task retrieves the translated data.
  • FROM (dataarea) - Identifies the storage location that contains the data to be mapped by the command. This includes the 12-byte prefix generated by the TIOAPXF=YES option on the DFHMDI and DFHMSD BMS map definitions.
  • INPARTN (name) - Character field (1-2 bytes) containing the partition name where the terminal operator enters the data. If the data is entered in another partition then the INPARTN partition is activated, the keyboard is unlocked for the partition, and an error message is output to any error message partition. The option is ignored if either the terminal does not support partitions, or no application partition set is found.
  • INTO (dataarea) - Identifies the data area set-up for receiving the mapped data. When this option is omitted the name will default to the name of the map set suffixed with an T.
  • LENGTH (data_value) - Halfword binary (PIC 9(4) COMP) value containing the length of the data to be formatted. It must not exceed the length of the FROM data area, but this should include the length of the 12-byte prefix generated by the TIOAPXF=YES option on the DFHMDI and DFHMSD BMS map definitions
  • MAP (name) - Character field (1-7 bytes) containing the name of the map to be used.
  • MAPSET (name) - Character field (1-7 bytes) containing the unsuffixed name of the mapset to be used. The mapsets must reside in a program library defined to CICS, and must be defined to CICS in the RDO (Resource Definition On-line) file. When this option is omitted, the name given in the MAP option is assumed to be that of the map set.
  • SET (ptr_ref) - Set the pointer reference value to the address of the 12-byte prefix of the mapped data. The pointer reference address can be above or below the 16MB line when DATALOCATION (ANY) is associated in RDO with the application program. When the pointer reference address resides above the 16MB line, and the DATALOCATION (BELOW) is associated in RDO with the application program, then the data is copied below the 16MB line, and the address of this copy's new location is returned. When storage protection is active, and TASKDATAKEY (USER) is specified, thre returned data is in user-key DSA. When storage protection is active, and TASKDATAKEY (CICS) is specified, the returned data is in CICS-key DSA.
  • TERMINAL - Option indicates the input data will be read from the terminal that originated the transaction. The handle conditions are given below: o EOC - Condition is set when the request/response unit (RU) is received with the End Of Chain indicator set. EIB field EIBEOC contains the indicator also.

The default action is the abnormal termination of the task.

  • EODS - Condition is set when no data is received. (Only an FMH) This option is only valid for 3770 batch LUs and to 3770 and 3790 batch data interchange LUs. The default action is the abnormal termination of the task.
  • INVMPSZ - Condition is set when the map is too wide or too long for the terminal. The default action is the abnormal termination of the task.
  • INVPARTN -Condition is set when the specified partition is not defined in the partition set associated with the application program. The default action is the abnormal termination of the task.
  • INVREQ - Conditions is set when the RECEIVE MAP command is issued from a non-terminal task; these tasks do not contain a TIOA or a TCTTE. The default action is the abnormal termination of the task.
  • MAPFAIL - Condition is set when the data being mapped has a length of zero or the map does not contain the set-buffer-address (SBA) sequence. This error is valid only for 3270 devices. The receiving data area contains the unmapped input data stream. The LENGTH option value will determine the amount of unmapped data to be moved into the user area. The input map is not set to nulls. This error condition is also set when the terminal operator responds by pressing one of the following keys in response to the RECEIVE MAP command:
    1. CLEAR key
    2. PA key
    3. ENTER key without entering data first
    4. PF key without entering data first

The default action is the abnormal termination of the task.

  • PARTNFAIL - Condition is set when the terminal operator tries (more than three times) to enter data in another partition other than the one specified in the 1NPARTN option. The default action is the abnormal termination of the task.
  • RDATT - The attention key (ATTN) terminates a conversation instead of the normal return key during the "receive" part of the program command. Condition is valid only on a 2741 Communications Terminal, and then only if 2741 read attention support has been generated for CICS. The default action is the abnormal termination of the task.
  • UNEXPIN - Either unexpected or unrecognized information received from the batch data interchange terminal will trigger this .error condition. The default action is the abnormal termination of the task.

All rights reserved © 2018 Wisdom IT Services India Pvt. Ltd DMCA.com Protection Status

IBM Mainframe Topics