CommLog (Input Agent)

This Input Agent allows you to evaluate Comm Log events. Once a profile has been activated, this Input Agent receives the configured (see below) Comm Log events (of the Control Center). Important note: In the partner channel used, the option "Use Comm Log" must be active in order to generate Comm Log events. For protocol X.400, the option "Request for MDN" must also be active in the Response of type "X.400" in the sending profile.

Settings


(1) Direction: Data direction of the data to which the Comm Log events refer.

(2) Message type: Type of the Comm Log events. Options:

  • MDN. Positive receipts.

  • NDN. Negative receipts.

Note: Some protocol types (e.g. FTP and SSH), see (3), do not generate MDNs/NDNs. However, CommLog events do not only consist of MDNs and NDNs, i.e. with these protocol types there are still CommLog events, but no MDN events. Setting (2) is therefore ineffective for these protocols.

(3) Protocols: Selection of Comm Log events for all or specific transmission protocols.

(4) Partner: Selection of Comm Log events for all or specific partners.

Template for source structure and return values


The Input Agent delivers XML data. Set the profile's document type to "XML" and use value "event" for the field "XML tag for record".

In phase 3, load the XML template "CommLogEvent" via the source structure menu.

Following is an example XML input file.


<?xml version="1.0" encoding="UTF-8"?>
<event>
<id_event>1478274779834002</id_event>
<id_entry>1478274779865005</id_entry>
<id_channel>1470905156701141</id_channel>
<id_partner>1470904732807002</id_partner>
<remote_id>
<address_attr>http://62.206.113.210:9191/</address_attr>
<remote_id_val>MARBEHO-TEST</remote_id_val>
</remote_id>
<local_id>KNUSTAS2</local_id>
<type>
<code_attr>2</code_attr>
<protocol_attr>1</protocol_attr>
<protocol_subtype_attr>1</protocol_subtype_attr>
<direction_attr>2</direction_attr>
<type_val>message disposition notification</type_val>
</type>
<message_id>1449559883.94.1478274779709.JavaMail.SYSTEM@LobsterTestSystem</message_id>
<resource>merbeho_ordersp_11037911.xml</resource>
<result>
<code>0/0</code>
<text>null</text>
</result>
</event>


The values there have the following meaning.


Element

Meaning

Values

direction_attr

Direction

0: Not specified

1: Inbound

2: Outbound

message_id

Message type

0: Not specified

1: Message

2: MDN

3: NDN

4: Message pending (inbound)

5: MDN pending (inbound)

6: ACE request

7: ACE response

protocol_attr and protocol_subtype_attr

Protocol type and subtype

0: Protocol type not specified

1: Protocol type AS2

2: Protocol type FTP
1: FTP plain
2: FTPS explicit
3: FTPS implicit

3: Protocol type OFTP
1: ISDN
2: TCP/IP
3: TCP/IP TLS

5: Protocol type MAIL

1: SMTP (inbound or outbound)
2: ASMTP
3: POP3 (inbound)
4: IMAP

6: Protocol type SSH
1: SCP
2: SFTP
3: SSH remote

7: Protocol type X.400
2: Lobster X.400 client

8: Protocol type Fax

code and text

Response code and response text

The meaning of the response code and response text is protocol-dependent and is taken directly from the respective protocol block. For AS2, for example, there are the following possible codes: processed, processed/warning, processed/error and failure/error.

The content of the response text is not normalised and is taken 1:1 from the partner's response.