Creating an Event Port

In this section:

iWay Explorer enables you to create event ports from the iWay Adapters tab or from the iWay Events tab. You also can modify or delete an existing port.


Top of page

x
Creating an Event Port From the iWay Adapters Tab

You can bypass the iWay Events tab and create an event port directly from the iWay Adapters tab.



x
Procedure: How to Create an Event Port From the iWay Adapters Tab
  1. Select the EnterpriseOne object for which you want to create an event port.

    The following image shows the selected transactions object under JDEConnection and Events in the left pane. It shows available operations in the right pane.

  2. In the right pane, move the pointer over Operations and select Create iWay Event Port.

    The Create Event Port dialog box opens in the right pane, as shown in the following image, with fields that allow you to define the port.

    1. In the Event Port Name field, type a name for the event port.
    2. In the Event Port Description field, type a brief description of the event port.
    3. From the Disposition Protocol drop-down list, select the required disposition (for example, FILE).
  3. Click Next.

    The Specify Disposition dialog box opens in the right pane.

  4. Specify the Disposition URL and click Finish.

For information on configuring port dispositions, see Creating an Event Port From the iWay Events Tab.


Top of page

x
Creating an Event Port From the iWay Events Tab

The following procedures describe how to create an event port from the iWay Events tab for various dispositions using iWay Explorer. You can switch between an iBSP and a JCA deployment by choosing one or the other from the drop-down menu in the upper right of iWay Explorer.

The following dispositions are available when using iWay Explorer in conjunction with an iBSP deployment.

The following dispositions are available when using iWay Explorer in conjunction with a JCA connector deployment.

You also can create an event port directly from the iWay Adapters tab. For more information, see Creating an Event Port From the iWay Adapters Tab.



x
Procedure: How to Create an Event Port for File
  1. Click the iWay Events tab.
  2. In the left pane, expand the JDEdwards node.
  3. Select the ports node.
  4. In the right pane, move the pointer over Operations and select Add a new port.

    The Create New Port dialog box opens in the right pane. The following image is an example of this dialog box with File chosen as the disposition protocol.

    1. In the Port Name and Description fields, type a name and a brief description for the event port.
    2. From the Disposition Protocol drop-down list, select FILE.
    3. In the Disposition field, specify a destination file to which the event data is written.

      When pointing iWay Explorer to an iBSP deployment, specify the destination file using the following format:

      ifile://[location];
      errorTo=[pre-defined port name or another disposition url]

      When pointing iWay Explorer to a JCA deployment, specify the full path to the directory.

      The following table lists and describes the disposition parameters for File.

      Parameter

      Description

      location

      Destination and file name of the document where event data is written, for example, D:\in\x.txt.

      errorTo

      Predefined port name or another disposition URL to which error logs are sent. Optional.

  5. Click OK.

The port appears under the ports node in the left pane. In the right pane, a table appears that summarizes the information associated with the event port you created.

You are ready to associate the event port with a channel. For more information, see Creating a Channel.



x
Procedure: How to Create an Event Port for iBSP
  1. Click the iWay Events tab.
  2. In the left pane, expand the JDEdwards node.
  3. Select the ports node.
  4. In the right pane, move the pointer over Operations and select Add a new port.
    1. In the Port Name and Description fields, type a name and a brief description for the event port.
    2. From the Disposition Protocol drop-down list, select iBSP.
    3. In the Disposition field, type an iBSP destination using the following format:
      ibsp:svcName.mthName;
      responseTo=[pre-defined port name or another disposition url];
      errorTo=[pre-defined port name or another disposition url]

      The following table lists and describes the disposition parameters for iBSP.

      Parameter

      Description

      svcName

      Name of the service created with iBSP.

      mthName

      Name of the method created for the Web service.

      responseTo

      Location where responses to the Web service are posted. A predefined port name or another full URL. Optional.

      errorTo

      Location where error documents are sent. A predefined port name or another full URL. Optional.

  5. Click OK.

The port appears under the ports node in the left pane. In the right pane, a table appears that summarizes the information associated with the event port you created.

You are ready to associate the event port with a channel. For more information, see Creating a Channel.



x
Procedure: How to Create an Event Port for MSMQ
  1. Click the iWay Events tab.
  2. In the left pane, expand the JDEdwards node.
  3. Select the ports node.
  4. In the right pane, move the pointer over Operations and select Add a new port.
    1. In the Port Name and Description fields, type a name and a brief description for the event port.
    2. From the Disposition Protocol drop-down list, select MSMQ.
    3. In the Disposition field, type an MSMQ destination using the following format:
      msmq:/host/private$/qName;
      errorTo=[pre-defined port name or another disposition url]

      Note: This syntax is for a private queue. Private queues are queues that are not published in Active Directory. They appear only on the local computer that contains them. Private queues are accessible only by Message Queuing applications that recognize the full path name or format name of the queue.

      The following table lists and describes the disposition parameters for MSMQ.

      Parameter

      Description

      host

      Machine name where the Microsoft Queuing system is running.

      qName

      Name of the private queue where messages are placed.

      errorTo

      Predefined port name or another disposition URL to which error logs are sent. Optional.

  5. Click OK.

The port appears under the ports node in the left pane. In the right pane, a table appears that summarizes the information associated with the event port you created.

You are now ready to associate the event port with a channel. For more information, see Creating a Channel.



x
Procedure: How to Create an Event Port for JMS Queue
  1. Click the iWay Events tab.
  2. In the left pane, expand the JDEdwards node.
  3. Select the ports node.
  4. In the right pane, move the pointer over Operations and select Add a new port.
    1. In the Port Name and Description fields, type a name and a brief description for the event port.
    2. From the Disposition Protocol drop-down list, select JMSQ.
    3. In the Disposition field, type a JMS destination.

      When pointing iWay Explorer to an iBSP deployment, specify the destination using the following format:

      jmsq:myQueueName@myQueueFac;jndiurl=[myurl];
      jndifactory=[myfactory];user=[user];password=[xxx];
      errorTo=[pre-defined port name or another disposition url]

      When pointing iWay Explorer to a JCA deployment, specify the destination using the following format:

      jms:jmsqueue@jmsfactory;jndiurl=;jndifactory=;

      The following table lists and describes the disposition parameters for JMSQ.

      Parameter

      Description

      myQueueName or jmsqueue

      JNDI name of a queue to which events are emitted.

      myQueueFac or jmsfactory

      A resource that contains information about the JMS Server.

      jndiurl

      The URL to use to contact the JNDI provider. The syntax of this URL depends on the JNDI provider being used. This value corresponds to the standard JNDI property.

      java.naming.provider.url

      jndifactory

      Is JNDI context. INITIAL_CONTEXT_FACTORY and is provided by the JNDI service provider.

      user

      Valid user name required to access a JMS server.

      password

      Valid password required to access a JMS server.

      errorTo

      Predefined port name or another disposition URL to which error logs are sent. Optional.

  5. Click OK.

The port appears under the ports node in the left pane. In the right pane, a table appears that summarizes the information associated with the event port you created.

You are now ready to associate the event port with a channel. For more information, see Creating a Channel.



x
Procedure: How to Create a Port for the SOAP Disposition

The SOAP disposition allows an event response to launch a Web service specified by a WSDL file. A soapaction is optional, the default is "".

To create a port for a SOAP disposition using iWay Explorer:

  1. Click the iWay Events tab.
  2. In the left pane, expand the J.D. Edwards adapter node.
  3. Select the ports node.
  4. Move the pointer over Operations and select Add a new port.

    The Create New Port pane opens on the right.

    1. In the Port Name and Description fields, type a name and a brief description for the event port.
    2. From the Disposition Protocol drop-down list, select SOAP.
    3. In the Disposition field, enter an SOAP destination, using the following format:
      soap:[wsdl-url];soapaction=[myaction];
      method=[web service method];namespace=[namespace];
      responseTo=[pre-defined port name or another disposition URL];
      errorTo=[pre-defined port name or another disposition url]

      The following table lists and defines the parameters for the disposition.

      Parameter

      Description

      wsdl-url

      The URL to the WSDL file that is required to create the SOAP message, for example,

      http://localhost:7001/ibse/IBSEServlet/test/webservice.ibs?wsdl

      where:

      webservice

      Is the name of the Web service you created using iWay Explorer.

      This value can be found by navigating to the iWay Business Services tab and opening the Service Description option in a new window. The WSDL URL appears in the Address field.

      You can also open the WSDL file in a third party XML editor and view the SOAP request settings to find this value.

      soapaction

      The method that will be called by the SOAP disposition, for example

      webservice.method@test@@

      where:

      webservice

      Is the name of the Web service you created using iWay Explorer.

      method

      Is the method being used.

      test

      Is the license that is being used by the Web service.

      This value can be found by navigating to the iWay Business Services tab and opening the Service Description option in a new window. Perform a search for soapAction.

      method

      The Web service method you are using. This value can be found in the WSDL file.

      namespace

      The XML namespace you are using. This value can be found in the WSDL file.

      responseTo

      The location to which responses are posted, which can be a predefined port name or another URL. Optional.

      A predefined port name or another disposition URL. The URL must be complete, including the protocol.

      errorTo

      The location to which error logs are sent. Optional.

      A predefined port name or another disposition URL. The URL must be complete, including the protocol.

  5. Click OK.

    The port appears under the ports node in the left pane. In the right pane, a table appears that summarizes the information associated with the port you created.

You are now ready to associate the event port with a channel. For more information, see Creating a Channel.



x
Procedure: How to Create an Event Port for HTTP

To create an event port for HTTP:

  1. Click the iWay Events tab.
  2. In the left pane, expand the JDEdwards node.
  3. Select the ports node.
  4. In the right pane, move the pointer over Operations and select Add a new port.
    1. In the Port Name and Description fields, type a name and a brief description for the event port.
    2. From the Disposition Protocol drop-down list, select HTTP.
    3. In the Disposition field, type an HTTP destination.

      When pointing iWay Explorer to an iBSP deployment, specify the destination using the following format:

      ihttp://myurl;
      responseTo=[pre-defined port name or another disposition url];

      When pointing iWay Explorer to a JCA deployment, specify the destination using the following format:

      http://host:port/uri                    

      The following table lists and describes the disposition parameters for HTTP when using an iBSP deployment.

      Parameter

      Description

      myurl

      URL target for the post operation, for example,

      http://myhost:1234/docroot

      responseTo

      Predefined port name or another disposition URL to which response documents are sent. Optional.

      The following table lists and describes the disposition parameters for HTTP when using a JCA deployment.

      Parameter

      Description

      host:port

      Combination of the name of the host on which the server resides and the port on which the server is listening for the post operation.

      uri

      Universal resource identifier that completes the URL specification.

  5. Click OK.

    The port appears under the ports node in the left pane. In the right pane, a table appears that summarizes the information associated with the event port you created.

You are now ready to associate the event port with a channel. For more information, see Creating a Channel.



x
Procedure: How to Create an Event Port for MQSeries
  1. Click the iWay Events tab.
  2. In the left pane, expand the JDEdwards node.
  3. Select the ports node.
  4. In the right pane, move the pointer over Operations and select Add a new port.
    1. In the Port Name and Description fields, type a name and a brief description for the event port.
    2. From the Disposition Protocol drop-down list, select MQSeries.
    3. In the Disposition field, type an MQSeries destination.

      When pointing iWay Explorer to an iBSP deployment, specify the destination using the following format:

      mqseries:/qManager/qName;host=hostname;
      port=port;channel=channnelname;
      errorTo=pre-defined port name or another disposition url                    

      When pointing iWay Explorer to a JCA deployment, specify the destination using the following format:

      mq:qmanager@respqueue;host=hostname;port=port;channel=channnelname                    

      The following table lists and describes the disposition parameters for MQSeries.

      Parameter

      Description

      qManager

      Name of the queue manager to which the server must connect.

      qName or respqueue

      Name of the queue where messages are placed.

      host

      Host on which the MQ server is located (MQ Client only).

      port

      Number to connect to an MQ server queue manager (MQ client only).

      channel

      Case-sensitive name of the channel that connects with the remote MQ server queue manager (MQ client only). The default channel name for MQSeries is SYSTEM.DEF.SVRCONN.

      errorTo

      Predefined port name or another disposition URL to which error logs are sent. Optional.

  5. Click OK.

The port appears under the ports node in the left pane. In the right pane, a table appears that summarizes the information associated with the event port you created.

You are now ready to associate the event port with a channel. For more information, see Creating a Channel.


Top of page

x
Editing and Deleting an Event Port

The following procedures describe how to edit and delete an event port.



x
Procedure: How to Edit an Event Port
  1. In the left pane, select the event port you want to edit.
  2. In the right pane, move the pointer over Operations and select Edit.

    The Edit Port dialog box opens.

  3. Make the required changes and click OK.


x
Procedure: How to Delete an Event Port
  1. Select the event port you want to delete.
  2. In the right pane, move the pointer over Operations and select Delete.

    A confirmation dialog box opens.

  3. To delete the event port you selected, click OK.

The event port disappears from the list in the left pane.


iWay Software