Admi.004.001.02 Mapper

Overview

The Admi.004.001.02 (Admi.004) Inbound Mapper is used by TCH for sending System Event Notification(SysEvtNtfctn) messages from TCH Real-Time Payment System(RTP) to FTM for Immediate Payments. The default mapper name is Admi004ToISFMapper.

The details of the mapping specification are included in a separate document. Refer to Detailed admi.004 mapping specification for more information about obtaining the documentation for the mapping specifications.

The inbound admi.004 mapper can also be used in conjunction with the Business Application Header mapper. Refer to TCH Business Application Header Mapper for more information.

Inbound Mapper

The CONFIG=entry in Channel parameter is required for inbound mapper. The mapper uses the setting to locate <msgTypeCfg> entry in Value table with child element <Type> containing admi.004.*. The <msgTypeCfg> contains the configuration parameters for the inbound mapper.

For example, the default System Notification From CSM channel is configured with a CONFIG=IP_MAP_CFG_SNM_FROM_CSM parameter. When a admi.004.001.02 message is received , the mapper looks for the <msgTypeCfg> entry in the Value table with the following conditions:

In Value table, the value of Category is IP_MAP_CFG_SNM_FROM_CSM.
In msgTypeCfg entry, the value of Type is admi.004.*.

The default <msgTypeCfg> for IP_MAP_CFG_RESP_FROM_CSM is as follows.

<msgTypeCfg>
	<class>ADMI004</class>
	<subType>IP_FROM_CSM_SNM</subType>
	<extendedCfg>
		<name>MASTER_FLAG</name>
		<value>Y</value>
	</extendedCfg>	
	<pt>
		<class>ADMI004</class>
		<subType>IP_FROM_CSM_SNM</subType>
	</pt>
	<mapName>Admi004ToISFMapper</mapName>
	<type>admi.004.*</type>
</msgTypeCfg>

The inbound mapper uses the configuration parameters of the <msgTypeCfg> entry as follows:

<class> - value for TRANSACTION_V.OBJ_CLASS
<subType> - value for TRANSACTION_V.SUBTYPE and ISFMessage/Header/BusinessConcept
<extendedCfg>.<value> with <name>=MASTER_FLAG - value for MASTER_FLAG (for TRANSACTION_V and TRANSMISSION_V)
<pt>.<class> - value for TRANSMISSION_V.OBJ_CLASS
<pt>.<subType> - value for TRANSMISSION_V.SUBTYPE

Note: When the inbound mapper is used in conjunction with the Business Application Header mapper, the inbound mapper checks the value of AppHdr/CpyDplct in Business Application Header. If the value is 'DUPL', the mapper appends '_RPT' to existing <subType> value to indicate the message is a repeat Message Reject message.

If the <msgTypeCfg> entry cannot be located, the mapper throws an exception with error 'subType not found'.

Table 1 shows the default configuration parameters for the channels using admi.004 inbound mapper.

Table 1. Default configuration parameters for channels using admi.004 inbound mapper
Category	Class	SubType	MASTER_FLAG	Pt.class	Pt.subType
IP_MAP_CFG_SNM_FROM_CSM	ADMI004	IP_FROM_CSM_SNM	Y	ADMI004	IP_FROM_CSM_SNM