test

Sun Adapter for TCP/IP HL7 Tutorial

Creating and Configuring the Environments

Environments include External Systems, Logical Hosts, application servers, and message servers used by a project. These contain the configuration information for these components. Environments are created using NetBeans and the Environment Editor. This section describes how to create and configure Environments for all five of the Connectivity Maps included in the inbound and outbound projects. You only need to create Environments for the operations you want to run.

The instructions are divided into the following sections:

Creating and Configuring the HL7 Outbound Environment

The components required for the HL7 outbound Environment include a Logical Host, application server, JMS IQ Manager, and two external systems.

ProcedureTo Create an Environment for the prjHL7Outbound

  1. On the NetBeans Services window, right–click CAPS Environment and then select New Environment.

    A new environment is created and is added to the CAPS Environment tree.

  2. Rename the new Environment to envHL7Outbound.

    New Environment Renamed

  3. Right-click envHL7Outbound, point to New, and then select Logical Host.

    It takes few seconds to process the Logical Host into the Environment.

    GlassFish Server Created

  4. Rename the Logical Host lhHL7Outbound

  5. Create and configure an application server:

    1. Right-click lhHL7Outbound, point to New, and then select Sun Java System Application Server.

      A new application server is added to the Environment tree .

    2. Rename the server gfHL7Outbound.

    3. Right-click gfHL7Outbound and select Properties.

      The Properties Editor appears.

    4. Click the ellipses button next to the Password property.

      The Password Settings dialog box appears.

    5. Click the ellipses available at the end of the field.

      The Password Settings dialog box appears.

      Password Settings

    6. Enter the password in the Password and the Confirm Password fields.

      The default Password is adminadmin and the default Confirm Password is adminadmin.

    7. Click OK.

    8. On the Properties Editor, verify the remaining properties and then click OK.

  6. Create and configure a JMS IQ Manager:

    1. Right-click lhHL7Outbound, point to New, and then select Sun JMS IQ Manager.

      A new JMS IQ Manager is added to the Environment tree.

      Sun JMS IQ Manager Created

    2. Rename the IQ Manager iqHL7Outbound.

    3. Right-click iqHL7Outbound, and select Properties.

      The Properties Editor appears.

    4. In the Sun JMS IQ Manager URL property, enter the URL of the IQ Manager.

      The default URL is stcms://localhost:18007.

    5. Enter a password as described for the application server above.

    6. Verify the remaining fields, and then click OK.

  7. Create and configure a File External System:

    1. Right-click envHL7Outbound, point to New, and then select File External System.

    2. On the dialog box that appears, enter esFile as the name.

    3. Click OK.

      Name esFile

      The external system is added to the Environment tree.

      esFile Created

    4. Right-click esFile and select Properties.

      The Properties Editor appears.

    5. On the Properties Editor, expand Inbound File eWay, and modify the directory from which the File Adapter will pick up the input file.

    6. Click OK.

  8. Create and Configure an HL7 External System:

    1. Right-click envHL7Outbound, point to New, and then select HL7 External System.

    2. On the dialog box that appears, enter esHL7 as the name.

    3. Click OK.

      The External System is added to the Environment tree.

      envHL7Outbound Tree Structure

    4. Right-click eHL7 and select Properties.

      The Properties Editor appears.

    5. On the Properties Editor, expand HL7 Outbound eWay, and select TCPIP Outbound Settings.

    6. Make sure the hostname and port are correct for the application that is listening for HL7 messages.

    7. Click OK.

  9. On the NetBeans toolbar, click Save All.

Creating Environments for the HL7 Inbound and Outbound Samples

Follow the example given in the previous section, create Environments for the remaining TCP/IP HL7 samples. You only need to create Environments for the samples you want to run. Make sure the configure the URL and authentication information for all the application servers and JMS IQ Managers you add. Any additional required configuration is listed below.

Tip –

Even if you do not modify the Environment components of an External System, be sure to open the Properties Editor for each External System. Otherwise, the build process may fail.

HL7 Inbound Sample

Create the envHL7Inbound Environment with the following components:

HL7 Inbound Forward MSG Sample

Create the envHL7InboundForwardMSG Environment with the following components:

HL7 Outbound Delayed ACK Sample

Create the envHL7OutboundDelayedACK Environment with the following components:

HL7 Outbound Forward Sample

Create the envHL7OutboundForward Environment with the following components: