Send mapped output data to a terminal. The keywords are separated into those supported by minimum, standard, and full BMS. For further information about BMS, see Basic mapping support.
SEND MAP Minimum BMS >>-+--------------+---------------------------------------------> '-MAPSET(name)-' >--+-+-----------------+--+----------+--+--------------------+-+--> | '-FROM(data-area)-' '-DATAONLY-' '-LENGTH(data-value)-' | '-MAPONLY---------------------------------------------------' >--+-----------------------------+--+----------+----------------> '-CURSOR-+------------------+-' '-FORMFEED-' '-(--data-value--)-' >--+----------------------+--+-------+--+--------+--+-------+---> +-ERASE--+-----------+-+ '-PRINT-' '-FREEKB-' '-ALARM-' | +-ALTERNATE-+ | | '-DEFAULT---' | '-ERASEAUP-------------' >--+-------+--------------------------------------------------->< '-FRSET-'
SEND MAP Full BMS .-TERMINAL---------------------. >>-+-------+--+------------------------------+------------------> '-ACCUM-' +-SET(ptr-ref)-----------------+ +-PAGING-----------------------+ '-TERMINAL--+------+--+------+-' '-WAIT-' '-LAST-' .-HONEOM-. >--+-------------+--+---------+--+--------+-------------------->< '-REQID(name)-' '-NOFLUSH-' +-L40----+ +-L64----+ '-L80----'
Conditions: IGREQCD, IGREQID, INVLDC, INVMPSZ, INVPARTN, INVREQ, OVERFLOW, RETPAGE, TSIOERR, WRBRK
SEND MAP sends output data to a terminal.
When using the SEND MAP command with any of the ALARM, FREEKB, FRSET, HONEOM, L40, L64, L80, or PRINT options, see DFHMDI options, CTRL for a description of the option priority.
See BMS macros for map definition.
This option is ignored if the target terminal does not support partitions, or if there is no application partition set.
When using the ALARM option, refer to DFHMDI options, CTRL for a description of the option priority.
The data value must be a halfword binary value that specifies the cursor position relative to zero; the range of values that can be specified depends on the size of the screen being used. If no data value is specified, symbolic cursor positioning is assumed.
This option overrides any IC option of the ATTRB operand of DFHMDF. If ACCUM is being used, the most recent value of CURSOR specified is used to position the cursor.
The value specified in the CURSOR option must be positive. A negative value leads to unpredictable results.
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.
Note that the keyboard lock status is maintained separately for each partition on a terminal that supports partitions.
When using the FREEKB option, refer to DFHMDI options, CTRL for a description of the option priority.
This allows the ATTRB operand of DFHMDF for the requested map to control the final status of fields written or rewritten in response to a BMS command, if no other attribute information has been written in the symbolic map.
When using the FRSET option refer to DFHMDI options, CTRL for a description of the option priority.
When using the HONEOM option, refer to DFHMDI options, CTRL for a description of the option priority.
When an LDC is specified, BMS uses the device type, the page size, and the page status associated with the LDC mnemonic to format the message. These values are taken from the extended local LDC table for the logical unit, if it has one. If the logical unit has only a local (unextended) LDC table, the values are taken from the system LDC table. The numeric value of the LDC is obtained from the local LDC table, unless this is an unextended table and the value is not specified, in which case it is taken from the system table.
If the data area sending the map is longer than the data to be mapped, LENGTH should be specified. This should include the length of the 12-byte prefix generated by the TIOAPFX=YES option on the DFHMDI and DFHMSD BMS map definitions (see DFHMDI operands, TERM and Specifying NODDS in the BMS operand). For a description of a safe upper limit, see LENGTH options in CICS commands.
When using the options, refer to DFHMDI options, CTRL for a description of the option priority.
The number of maps per mapset is limited to a maximum of 9 998.
This option must be specified in the first SEND MAP command used to build a logical message. The option is ignored if the device receiving the message (direct or routed) is not one of those mentioned above.
If this option is used, buffer updating and attribute modification of fields previously written into the buffer are not allowed. CICS includes the ERASE option with every write to the terminal.
The NL character occupies a buffer position. A number of buffer positions, equivalent to the value of the RDO TYPETERM options PAGESIZE or ALTPAGE, for that terminal, is unavailable for data. This may cause data to wrap around in the buffer; if this occurs, the PAGESIZE or ALTPAGE value must be reduced.
The NLEOM option overrides the ALARM option if the latter is present.
If PAGING is specified with a REQID prefix that is used for temporary storage queues that are defined as recoverable, CICS provides message recovery for logical messages if the task has reached a syncpoint.
When using the PRINT option, refer to DFHMDI options, CTRL for a description of the option priority.
BMS message recovery is provided for a logical message only if the PAGING option is specified in the BMS SEND commands and if the syncpoint has been reached.
The SET option specifies that completed pages are to be returned to the application program. The pointer is set to the address of a list of completed pages.
The application program regains control either immediately following the SEND MAP command (if the current page is not yet completed), or at the label specified in a HANDLE CONDITION RETPAGE command, if the page has been completed.
If TIOAPFX=YES is specified in the map definition, the pointer returned contains the address of the TIOA prefix. The user data starts at offset X'0C' from the start of the TIOA prefix.
If WAIT is not specified, control returns to the application program when the output operation has started. A subsequent input or output command (terminal control, BMS, or batch data interchange) causes the application program to wait until the previous command has been completed.
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.
Default action: terminate the task abnormally.
Default action: terminate the task abnormally.
Default action: terminate the task abnormally.
Default action: ignore the condition.
Default action: return control to the application program at the point immediately following the BMS SEND MAP command.
Default action: terminate the task abnormally.
Default action: ignore the condition.