Enabling message flows to send ATNA audit messages

To enable the sending of ATNA audit messages from message flows on your broker, use a configurable service to add ATNA configuration details to your broker, including the location of the ATNA audit repository.

To create a new configurable service that controls the settings used by your ATNAAudit nodes, complete the following steps:

1. Create a new UserDefined configurable service named ATNA, see: UserDefined configurable services in the IBM® Integration Bus product documentation
   Note: The configurable service must be named ATNA.
2. Create a property for each element in the following table and assign appropriate values to the properties.
   Note: The configurable service must contain each of the properties that is listed in the table, even if they are entered with an empty value. If any property that is listed in the table is missing from the configurable service, your ATNAAudit nodes produce an error and fail to start.

   Property	Value	Example
   auditEnabled	true if audit messages should be sent to the repository, or false if no audit messages should be sent. Note: ATNA audit messages are only sent from an ATNAAudit node when the auditEnabled property is set to true in the configurable service and the Audit enabled property is selected in the ATNAAudit node, see ATNAAudit node.	true
   auditEnterpriseSiteID	Any text value. This value is used in the AuditSourceIdentification element of ATNA audit messages as the value of AuditEnterpriseSiteID for all messages sent by the broker.	MySiteName
   auditHumanRequestor	Any text value. This value is used in the ActiveParticipant element of ATNA audit messages as the value of UserID for all messages sent by the broker. This value is only used in audit messages that have a human requestor.	Admin
   auditRepositoryURI	URI of the audit repository to which messages are sent, including the transport (UDP or TLS), the address and the port.	udp://myrepository.myorg.com:3001
   auditSourceID	Any text value. This value is used in the AuditSourceIdentification element of ATNA audit messages as the value of AuditSourceID for all messages sent by the broker.	OTHER_MYCO
   auditSystemAlternativeUserID	Any text value. This value is used in the ActiveParticipant element of the ATNA audit message as the value of AlternativeUserID for all messages sent by the system. This value correlates to either the source or destination participant, depending on the transaction. Note In IHE audit transactions, this is defined as the JVM's process ID for the sending system participant. If you leave this value empty, the node will attempt to resolve and use the process ID.	MyAltUserID
   auditSystemUserID	Any text value. This value is used in the ActiveParticipant element of the ATNA audit message as the value of UserID for all messages sent by the system. This value correlates to either the source or destination participant, depending on the type of audit message and transaction.	MyUserID
   auditSystemUserName	Any text value. This value is used in the ActiveParticipant element of the ATNA audit message as the value of UserName for all messages sent by the system. In transactions involving XUA, this field is overwritten with the properly-formatted XUA username contained in the XML audit message.	MyUserName

   For more information about the ATNA audit message format, see ATNAAudit nodes in message flows