Admn.002.001.01 Mapper

Overview

The Admn.002.001.01 (Admn.002) Inbound Mapper is used by TCH for receiving Sign-On Response(AdmnSignOnResp) messages from TCH Real-Time Payment System(RTP) to FTM for Immediate Payments. The Admn.002 Inbound Mapper maps the TCH Sign-On Response messages to ISF messages. The default mapper name is Admn002ToISFMapper.

The details of the mapping specification for the inbound mapper are included in a separate document. Refer to Detailed admn.002 mapping specification for more information about obtaining the documentation for the mapping specifications.

The inbound admn.002 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 admn.002.*. The <msgTypeCfg> contains the configuration parameters for the inbound mapper.

For example, the default Response From CSM channel is configured with a CONFIG=IP_MAP_CFG_RESP_FROM_CSM parameter. When an admn.002.001.01 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_RESP_FROM_CSM.
  • In msgTypeCfg entry, the value of Type is admn.002.*.
The default <msgTypeCfg> for IP_MAP_CFG_RESP_FROM_CSM is as follows.
<msgTypeCfg>
	<class>ADMN002</class>
	<subType>IP_SIGN_ON_RESPONSE</subType>
	<extendedCfg>
		<name>MASTER_FLAG</name>
		<value>N</value>
	</extendedCfg>
	<pt>
		<class>ADMN002</class>
		<subType>IP_SIGN_ON_RESPONSE</subType>
	</pt>
	<mapName>Admn002ToISFMapper</mapName>
	<type>admn.002.*</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 admn.002 inbound mapper.
Table 1. Default configuration parameters for channels using admn.002 inbound mapper
Category Class SubType MASTER_FLAG Pt.class Pt.subType
IP_MAP_CFG_RESP_FROM_CSM ADMN002 IP_SIGN_ON_RESPONSE N ADMN002 IP_SIGN_ON_RESPONSE