Creating a Channel

In this section:

How to:

The following procedure describes how to create a channel for your event. You can create a TCP or File channel. All defined event ports must be associated with a channel. This topic also describes how to start and stop a channel, and how to edit and delete a channel.


Top of page

x
Procedure: How to Create a TCP Channel

To create a TCP channel:

  1. Click the iWay Events tab.

    The adapters that appear in the left pane support events.

  2. Expand the JDEdwards node.

    The ports and channels nodes appear in the left pane.

  3. Click the channels node.
  4. In the right pane, move the pointer over Operations and select Add a new channel.

    The Add a new JDEDWARDS channel dialog box opens in the right pane, as shown in the following image.

    1. In the Channel Name and Description fields, type a name (for example, JDEChannel) and a brief description for the channel.
    2. From the Channel Type drop-down list, select TCP Listener.
  5. Click Next.

    The Edit channels dialog box opens, as shown in the following image, with fields, a drop-down list, and check boxes prompting you for information required to create a channel.

  6. Provide the system information that is specific to your J.D. Edwards environment.

    The following table lists and describes the parameters required to create a channel.

    Parameter

    Description

    Host

    Name or URL of the machine where the database is installed.

    Port number

    Port number on which the server is listening, for example, 6009.

    Synchronization Type

    • If the event application expects a reply sent back to it, select REQUEST_RESPONSE. Specify a preemitter.
    • When a TCP/IP acknowledgment (ACK) is sent back to the event application, select REQUEST_ACK.
    • If the event application does not expect a return, select REQUEST.

    Is Length Prefix

    For EnterpriseOne events that send data back that are not in XML format. The TCP/IP event application must prefix the data with a 4-byte binary length field when writing the data to the TCP/IP port.

    Is XML

    For EnterpriseOne events that send data back in XML format.

    Is Keep Alive

    Maintains continuous communication between the event transaction and the channel.

    User ID

    Valid user ID for EnterpriseOne.

    User Password

    Password associated with the user ID.

    JDE Environment

    EnterpriseOne environment, for example, DV7333. For more information about this parameter, see your EnterpriseOne documentation or ask your EnterpriseOne system administrator.

    Application

    XMLInterop or the application name in EnterpriseOne. Optional.

    Server IP address

    Name of the server on which EnterpriseOne is running. This can be the name of the server, for example, JDE8.10, or its IP address, for example, 123.45.67.89.

    Server port

    Port number on which EnterpriseOne is running.

    User role

    User profile for the J.D. Edwards user identifying user privileges.

    Note: This parameter only appears in J.D. Edwards EnterpriseOne version 8.10.

    Schema style

    From the Schema style drop-down list, select ELEMENT_STYLE (default) or ATTRIBUTE _STYLE for J.D. Edwards events and services.

    For example, if the client requirement is for Microsoft BizTalk, select ELEMENT_STYLE, which sets the default for schema output that is used by Microsoft Biztalk.

  7. Click Next.
    1. Select an event port from the list of available ports. To select more than one, hold down the Ctrl key and click the ports.
    2. Click the single right-arrow button to transfer the selected port(s) to the list of current ports. To transfer all event ports, click the double right-arrow button.
  8. Click Finish.

    An information summary for the new channel appears in the right pane. It provides the channel, description, channel status, and ports.

    An X over the icon for the channel name indicates that the channel is currently disconnected. You must start the channel to activate your event configuration.



x
Procedure: How to Create a File Channel

To create a File channel:

  1. Click the iWay Events tab.

    The adapters that appear in the left pane support events.

  2. Expand the JDEdwards node.

    The ports and channels nodes appear in the left pane.

  3. Click the channels node.
  4. In the right pane, move the pointer over Operations and select Add a new channel.

    The Add a new JDEDWARDS channel dialog box opens in the right pane, as shown in the following image.

    1. In the Channel Name and Description fields, type a name (for example, JDEChannel) and a brief description for the channel.
    2. From the drop-down list, select File Listener.
  5. Click Next.

    The Edit channels dialog box opens with Request, Response, Advanced, and preparser tabs, which are used to provide information for the creation of a File channel. The Request tab is selected by default, as shown in the following image.

  6. Provide the necessary information for the File channel that is specific to your J.D. Edwards environment.

    The following table lists and describes the parameters provided in the Request tab.

    Parameter

    Description

    Polling Location

    Directory where messages are received. DOS-style file patterns are valid for this parameter. You can specify a file pattern as well as a directory. For example, c:\xyz\ab*cd (without a file suffix) takes the file suffix from that parameter. If you use a pattern, files are selected based on the suffix and then, the pattern. AB?CD selects ABxCD. AB*CD selects ABxxxCD.

    File Mask

    File extension for the file event. This limits input files to those with the specified extensions. The "." is not required. A minus sign ("-") indicates no extension. If the file extension is zip, the unzipped files must conform to the event schema, or they fail. This function also works with transform configured.

  7. Click the Response tab.

    The following image shows the Response tab of the Edit channels dialog box.

    The following table lists and describes the parameters provided in the Response tab.

    Parameter

    Description

    Synchronization Type

    Select one of the following synchronization types from the drop-down list:

    • REQUEST (Default)
    • REQUEST_RESPONSE
    • REQUEST_ACK

    Response/Ack Directory

    The directory in which the acknowledgment document is placed.

  8. Click the Advanced tab.

    The following image shows the Advanced tab of the Edit channels dialog box.

    The following table lists and describes the parameters provided in the Advanced tab.

    Parameter

    Description

    Error Directory

    The directory in which the error documents are placed.

    Poll interval (msec)

    This is a time, expressed in milliseconds. The maximum interval between checks for new documents. The higher this value, the longer the interval, and the fewer system resources that are used. The side-effect of a high value is that a worker thread cannot respond to a stop command. If this value is set to 0, the listener runs once and terminates.

    Processing Mode

    Select one of the following synchronization types from the drop-down list:

    • sequential (default)
    • threaded

    Thread limit

    Specify the number of worker threads that you want to have available.

  9. Click the preparser tab.

    The following image shows the preparser tab of the Edit channels dialog box.

    The following table lists and describes the parameters provided in the preparser tab.

    Parameter

    Description

    User ID

    Valid user ID for EnterpriseOne.

    User password

    Password associated with the user ID.

    JDE Environment

    EnterpriseOne environment, for example, DV7333. For more information about this parameter, see your EnterpriseOne documentation or ask your EnterpriseOne system administrator.

    Application

    XMLInterop or the application name in EnterpriseOne (Optional).

    Server IP address

    Name of the server on which EnterpriseOne is running. This can be the name of the server, for example, JDE8.10, or its IP address, for example, 123.45.67.89.

    Server port

    Port number on which EnterpriseOne is running.

    User role

    User profile for the J.D. Edwards user identifying user privileges.

    Note: This parameter only appears in J.D. Edwards EnterpriseOne version 8.10.

    Schema style

    From the Schema style drop-down list, select ELEMENT_STYLE (default) or ATTRIBUTE _STYLE for J.D. Edwards events and services.

    For example, if the client requirement is for Microsoft BizTalk, select ELEMENT_STYLE, which sets the default for schema output that is used by Microsoft Biztalk.

  10. Click Next.
    1. Select an event port from the list of available ports. To select more than one, hold down the Ctrl key and click the ports.
    2. Click the single right-arrow button to transfer the selected port(s) to the list of current ports. To transfer all event ports, click the double right-arrow button.
  11. Click Finish.

    An information summary for the new channel appears in the right pane. It provides the channel, description, channel status, and ports.

    An X over the icon for the channel name indicates that the channel is currently disconnected. You must start the channel to activate your event configuration.



x
Procedure: How to Start and Stop a Channel
  1. Expand the iWay Events node.
  2. Expand the JDEdwards node.
  3. Select the channel you want to start or stop.

    To start the channel, move the pointer over Operations and select Start the channel.

    To stop the channel, move the pointer over Operations and select Stop the channel.


Top of page

x
Editing and Deleting a Channel

The following procedures describe how to edit and delete a channel.



x
Procedure: How to Edit a Channel
  1. Expand the iWay Events node.
  2. Expand the JDEdwards node.
  3. In the left pane, select the channel you want to edit.
  4. In the right pane, move the pointer over Operations and select Edit.

    The Edit channels dialog box opens.

  5. Make the required changes to the channel configuration and click Finish.


x
Procedure: How to Delete a Channel
  1. Expand the iWay Events node.
  2. Expand the JDEdwards node.
  3. In the left pane, select the channel you want to delete.
  4. In the right pane, move the pointer over Operations and select Delete.

    A confirmation dialog box opens.

  5. To delete the channel you selected, click OK.

The channel disappears from the list in the left pane.


iWay Software