Running Built-In Test Simulator with SOA Suite Healthcare 11g in PS4 and PS5


SOA Suite for Healthcare Integration pack comes with a pre-installed simulator that can be used as an external endpoint to generate inbound and outbound HL7 traffic on specified MLLP ports. This is a command-line utility that can be very handy when trying to build a complete end-to-end demo within a standalone, closed environment.

The ant-based utility accepts the name of a configuration file as the command-line input argument. The format of this configuration file has changed between PS4 and PS5. In PS4, the configuration file was XML based and in PS5, it is name-value property based.

The rest of this note highlights these differences and provides samples that can be used to run the first scenario from the product samples set.

PS4 - Configuration File

The sample configuration file for PS4 is shown below.

The configuration file contains information about the following items:

  • Directory for incoming and outgoing files for the host running SOA Suite Healthcare
  • Polling Interval for the directory
  • External Endpoint Logical Names
  • External Endpoint Server Host Name and Ports
  • Message throughput to be simulated for generating outbound messages
  • Documents to be handled by different endpoints

A copy of this file can be downloaded from here.

PS5 - Configuration File

The corresponding sample configuration file for PS5 is shown below.

The configuration file contains similar information about the sample scenario but is not in XML format. It has name-value pairs specified in the form of a properties file. This sample file can be downloaded from here.

Simulator Configuration

Before running the simulator, the environment has to be set by defining the proper ANT_HOME and JAVA_HOME. The following extract is taken from a working sample shell script to set the environment:

Also, as a part of setting the environment, template and can be generated by using the following ant command:

  • ant -f ant-b2bsimulator-util.xml b2bsimulator-prop

Sample and are shown below and can be modified, as needed.

The contains information about connectivity to the local Weblogic Managed Server instance and the file controls the amount of logging that can be generated from the running simulator process.

Simulator Usage - Start and Stop

The command syntax to launch the simulator via ant is the same in PS4 and PS5. Only the appropriate configuration file has to be supplied as the command-line argument, for example:

  • ant -f ant-b2bsimulator-util.xml b2bsimulatorstart -Dargs="simulator1.hl7-config.xml"

This will start the simulator and will keep running to provide an active external endpoint for SOA Healthcare Integration engine. To stop the simulator, a similar ant command can be used, for example:

  • ant -f ant-b2bsimulator-util.xml b2bsimulatorstop

IS it possible to run simulator on Windows 7?
I'm getting the following error:
C:\Oracle\Middleware\Oracle_SOA1\bin\ant-b2bsimulator-util.xml:304: Execute fail
ed: Cannot run program "\tmp\": CreateProcess error=193, %1 is not a valid Win32 application

Posted by guest on August 07, 2012 at 07:25 AM PDT #


I've installed HCI on top of PS5 in Windows 7, and am trying to invoke the In_Patient_Admission endpoint from B2B simulator as described above. Using a netstat I was able to see that the receiving endpoint is active.

The ant script spawns a java.exe which uses upto 25% of CPU, but the file stays put in the in folder. I also get a NullPointerException (among various other errors) in the simulator log. Eventually I had to kill the java.exe explicitly as the stop simulator target seems to work only for bash or ksh. Can we use any other means to test the integration between HCI and SOA composite?

Posted by Aravind on March 04, 2013 at 11:23 PM PST #

Hello A-Team, I've installed HCI patch on top of PS5 and am trying the sample from for HCI, SOA Suite integration. Though the B2B simulator seems to have polled the file from the listen folder, I do not see the file being sent to the destination folder as provided in the config properties. Also no composite instances are found in the EM.

I've posted all details in this link can you please give me any pointers on what might be the issue?

Posted by Aravind on March 11, 2013 at 10:04 PM PDT #

Post a Comment:
  • HTML Syntax: NOT allowed

This is the blog for the Oracle FMW Architects team fondly known as the A-Team. The A-Team is the central, technical, outbound team as part of the FMW Development organization working with Oracle's largest and most important customers. We support Oracle Sales, Consulting and Support when deep technical and architectural help is needed from Oracle Development.
Primarily this blog is tailored for SOA issues (BPEL, OSB, BPM, Adapters, CEP, B2B, JCAP)that are encountered by our team. Expect real solutions to customer problems, encountered during customer engagements.
We will highlight best practices, workarounds, architectural discussions, and discuss topics that are relevant in the SOA technical space today.


« April 2014