Java API of the Message Standards Service

For information about how to use the Java™ API of the Message Standards Service, refer to its Javadoc information. To access this information:
  1. Locate the following compressed file: 
    /usr/lpp/IBM/ftm/ftmswift/v324/run/doc/dni.msgstds.api.doc.zip
  2. Copy the file to your workstation.
  3. Extract the online help files. The files, which are in JavaDoc format, are stored in the subdirectory dni.msgstds.api.doc.
  4. Open the file index.html in subdirectory dni.msgstds.api.doc in a web browser.
All classes and interfaces of this service are located in the following Java package: 
com.ibm.dni.msgstds
The service interface is represented by MessageDomainService, and an implementation can be obtained from a static method in the MessageDomainService.Lookup class. The service provides several methods to look up the available message domains and message definition sets, which are represented by instances of the interfaces MessageDomain and MessageDefinitionSet. Table 1 describes the available message domains.
To work with the payload of a message, obtain an instance of the MessageProcessor interface from the service. Each message processor can work with only one message payload at a time, but can be used for different messages in succession. Because the message definition set is specified at the time that a message processor is created, a processor can be used only for messages that employ that message definition set. A message processor can:
  • Import and export message payloads in different formats
  • Validate an imported message

Reference data that specifies country codes or currencies and that is used to validate messages can be provided to each message processor individually, or to the message domain service, in which case it is available to each message processor by default. If no reference data is made available to a message processor, it checks only the syntax of country codes and currencies.

In order to use the Message Standards Service, the class path of the Java virtual machine (JVM) in which the application runs must include the directory in which the following files are stored: 
butil.jar
dnicv*.jar
msgstds.jar
com.ibm.dni.msgstds.*.xml
These files are located in the directory /usr/lpp/IBM/ftm/ftmswift/v324/run/classes .