DnqFinExtractFromMT021 node

Icon for DnqFinExtractFromMT021 nodeThe DnqFinExtractFromMT021 node can be used to extract a nested APDU from a FIN MT 021 Retrieved Message (Text and History).

Node terminals

Node terminal Description
in The input terminal that receives the input message.
out The output terminal that propagates the message after it was processed without an error. If the payload of the input message is a valid MT021 that contains a nested APDU, the payload of the output message contains the nested APDU.
error The error terminal that propagates the message after it was processed with an error.

Prerequisites

The message format of the input message must be MTFIN.

Node properties

None.

Transactional support

IBM® Integration Bus performs transactional control.

Node processing

The DnqFinExtractFromMT021 node carries out the following actions:
  1. It determines the message type of the incoming message:
    • If the message type is not MT021:
      • If the incoming message does not start with {1:F or {1:A, it regards the message as a non-FIN APDU and passes the message to the error terminal.
      • Otherwise, it regards the message as a non-MT021 FIN APDU and passes the message to the output terminal without further processing.
    • If the message type is MT021, it extracts the nested message. If, during extraction, it detects a corrupt MT021 or if the MT021 indicates an retrieval error, it passes the message to the error terminal.
    The DnqFinExtractFromMT021 node does not validate the message.
  2. If the extraction of the nested message was successful, the body of the message is replaced with the nested message. If the incoming message has a MQRFH2 header with a ComIbmDni folder, the body of the original incoming message is saved in the OriginalMT021Payload field.
  3. If the incoming message has a MQRFH2 header with a ComIbmDni folder, it adds a history entry to this folder.
  4. It passes the message to the output terminal.

Error conditions

In case of an error, the DnqFinExtractFromMT021 node puts the output message on its error terminal and fills the folder in the ComIbmDni.Response folder in Local Environment. The following conditions are regarded as an error:
  • The incoming APDU contains an corrupt MT021. (DNQK1127E).
  • The incoming message does not contain a FIN APDU. (DNQK1128E).
  • The MT021 APDU indicates a retrieval error. (DNQK1129E).
For additional error information, refer to the description of messages DNQK1127 - DNQK1129 in DNQK1001E - DNQK3099E.