Exporting/Importing messages to and from files or data sets

Note: Before performing any of the tasks described in this section, carry out the procedure described in Configuring the Sequential Data Facility.
Use the Sequential Data Facility (SDF) to:
  • Import FIN messages from an input file or data set and create, for each FIN message, a corresponding IBM® Financial Transaction Manager for SWIFT Services message in a target queue.
  • Export FIN messages (each of which is contained in the body of an FTM SWIFT message) from a source queue to an output file or data set.
Ensure that the following settings and definitions are available. If you intend to run the SDF using customized shell scripts, ensure that the settings are included. Adjust the values according to your environment.
Setting defined in Example
Path to FTM SWIFT code CLASSPATH or direct reference in command line /usr/lpp/IBM/ftmswift/v300/run/classes
IBM MQ Java support library CLASSPATH or direct reference in command line /usr/lpp/mqm/V7R1M0/java/lib/com.ibm.mq.jar
Path to Java PATH or direct reference in command line /local/java/a70/J7.0
Library for z/OS data set support CLASSPATH or direct reference in command line /local/java/a70/J7.0/lib/s390
Each SDF task requires memory for its processing:
  • The SDF import task reads and checks the complete set of FIN messages and stores it in main storage before it starts to put the messages into the SDF target queue.
  • The SDF export task browses the source queue, checks the set of FIN messages, and stores it in main storage before it starts to write the messages to the SDF sequential output media.
An SDF task typically requires about two to three times as much main storage space as the accumulated size of the FIN messages to be processed. Adjust the Java Virtual Machine (JVM) memory parameters as appropriate. For example, to double the memory maximum, change -Xmx48m to -Xmx96m. If, after you run the SDF, it fails due to a lack of main storage, increase the memory maximum and rerun the SDF without changing the input data.

If SDF is connected by means of an MQ client, the export or import operation use a communication channel to the queue manager specified in the operation. To enhance security controls in this communication, IBM MQ SSL/TLS security settings can be used. You need to activate the required Cipher Spec in the communication channel definition. Ensure that the SSL Authentication setting for the channel definition is set to Optional. The selected cipher is then to be set for the SDF operation using the "-ciphersuite" command parameter and a trust store file, which contains the certificate of the queue manager. If you selected for example SSL/TLS cipher specification TLS_RSA_WITH_AES_128_CBC_SHA as message security for the channel SYSTEM.DEF.SVRCONN, the corresponding SDF command would look like the following:

dnqsdf -import file.rje -queue INST1.OU5.DNQ_K_TPLFIN 
-channel SYSTEM.DEF.SVRCONN  
-port 1433 -host aix.ibm.com -qmgr QB6 -instance INST1 -OU OU5
-ciphersuite SSL_RSA_WITH_AES_128_CBC_SHA -truststore /path/truststore.jks