BeginMapper

Figure 1. BeginMapper subflow for input mappers
BeginInputMapperSubflow.jpg
The BeginMapper subflow shown in the previous figure has the following main responsibilities:
  • Provide a facility to name the mapper. This is done by means of a label node, where the label name property is promoted so that it can be set at a higher level in the main input mapper flow. The mapper name specified here must exactly match that name of a mapper configured in the configuration database.
  • Trap any unexpected errors, such as a parser exception, that occur during the mapping process and forward the details directly to the EndMapper subflow. Mapping errors need to be caught here because, if not, they would be caught by the generic error flow and the transaction would be rolled back.
  • The default behavior of the EventOrRollback node is to flow directly to the failure node, not to cause a rollback. However in certain cases it may be preferable to rollback when an exception is caught. This is achieved by either creating a new or editing an existing entry in the VALUE table with CATEGORY = 'CORE', KEY = 'ROLLBACK_ON_INMAP_ABORT' and VALUE = 'Y'.