Import messages 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 a file or data set and create, for each FIN message, a corresponding FTM SWIFT message in a target IBM® MQ queue.

  1. Ensure that the applications that provided the input data use the data formats described in Data formats used by SDF.
  2. Check the pre-requisite options or variables depending on how SDF is carried out:
    • Running on the command line
      Java home directory
      Locate the home directory of your Java 1.7 or later installation

      Example: /local/java/a70/J7.0

      Data set support library
      Add the directory containing the JZOS support library for Java to your CLASSPATH:

      Example: export CLASSPATH=/local/java/a70/J7.0/lib/s390:$CLASSPATH

      IBM MQ Java™ library directory
      Add the IBM MQ Java libraries to the CLASSPATH.

      Example: export CLASSPATH=/usr/lpp/mqm/V7R1M0/java/lib/com.ibm.mq.jar:$CLASSPATH

      Path to FTM SWIFT Message Management installation directory
      Identify the path to the SDF code.

      Example: /usr/lpp/IBM/ftmswift/v300/run/classes

      The following example shows how the values can be specified when carrying out the SDF.

      prompt> export CLASSPATH=/usr/lpp/mqm/V7R1M0/java/lib/com.ibm.mq.jar:/local/java/a70/J7.0/lib/s390:\
prompt> $CLASSPATH
prompt> /local/java/a70/J7.0/bin/java -Xdump:none
        -cp $CLASSPATH:/usr/lpp/IBM/ftmswift/v300/run/classes/dnqcbsdf.jar
        com.ibm.dbq.sdf.DnqcbSdf
        -import my.file
        -queue ABC ...
      Note: You can add additional Java Virtual Machine (JVM) options as required. In the example, the -Xdump:none options has been used.
    • Shell script dnqsdf

      Ensure that the environment variables required for import are enabled and defined. Also check that the correct Java and IBM MQ settings are activated in the script.

  3. Run the import task (either directly using Java on the command line or through a shell script) as needed.