The FIN sample application

You invoke the sample application from the operating system command shell, not from the FTM SWIFT CLI.

When the application is invoked in send mode, it:
  1. Verifies all parameters specified. See also Program invocation and parameters.
  2. Assembles an FTM SWIFT request that consists of the MQMD header, the MQRFH2 header, and the message body.
    • In the MQMD:
      • Sets the name of the reply queue in the ReplyToQ field (-q parameter).
      • Sets the format name to MQFMT_RF_HEADER_2 in the Format field.
    • In the MQRFH2:
      • Adds a ComIbmDni folder to the message header. The content of the folder is determined by the options you specify.
    • In the message body:
      • Includes a SWIFT message read from standard input or from a file (-f parameter).
  3. Generates the service interface queue name to instance.ou.DNF_ILC_FIN to access the Send message flow.
    • The instance is mandatory.
    • The OU is DNFSYSOU by default or you can specify one (-o parameter).
  4. Puts the message on the service interface queue.
  5. Waits for the reply message from the FIN services in the reply queue.
  6. Writes the folder structures and the message body of the response to the standard error stream when it receives a reply.
  7. Ends, and returns control to the command shell.
When the application is invoked in the receive mode, it:
  1. Waits for a message from the FIN services in the specified queue (-q parameter).
  2. Writes the folder structures and message body of the response to the standard output stream or to a specified file (-f parameter) when it receives a message.
  3. Ends, and returns control to the command shell.
The sample application ends before normal completion if one of these conditions occur:
  • A parameter is not valid.
  • A queue or file cannot be opened, or a resource is not available.
  • A reply message is not received within the specified time (-t parameter).

The sample application is not intended to be terminated by user intervention. Set a suitable timeout so that it terminates without intervention.