Creating, Editing, or Deleting a Channel

How to:

The following procedures describe how to create, edit, or delete a channel for your event adapter as well as how to start or stop a channel. All defined event ports must be associated with a channel. You can create a channel using iWay Explorer.


Top of page

x
Procedure: How to Create a Channel

To create a channel using iWay Explorer:

  1. Click the iWay Events tab.

    The list of adapters that support events appears in the left pane as shown in the following image.

  2. Expand the iWay Events node, for example, SAP.

    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 MYSAP channel pane opens on the right as shown in the following image.

    1. In the Channel Name field, type a name, for example, TEST_CHANNEL.
    2. In the Description field, type a brief description (optional).
    3. From the Channel Type drop-down list, select SAP Channel -- App Server.
  5. Click Next.

    The edit channels pane opens on the right as shown in the following image, with fields for the client, user, password, language, and code page information for the channel. The User tab is active.

    1. On the User tab, enter the information that is specific to your SAP system.

      The following table lists and describes the user parameters.

      Parameter

      Description

      Client

      Client number defined for the SAP system for client communications.

      User

      Valid user ID for the SAP system.

      Password

      Valid password for the SAP system.

      Language

      Valid language key. EN (English) is the default value.

      Codepage

      Character code page value used by the SAP system (optional).

      Authentication Mode

      From the Authentication mode drop-down list, select Password, Logon ticket (SSO2), or Logon ticket (X509). For more information on Secure Network Communications (SNC), see Creating XML Schemas for mySAP.

      Note: For more information on obtaining the values found in the User tab, see your SAP system administrator.

    2. Click the System tab.

      The System tab becomes active as shown in the following image, with fields to enter a gateway host, gateway service, program ID of the server, application server, and system number for the channel.

    3. Enter the user information that is specific to your SAP system.

      The following table lists and describes the system parameters.

      Parameter

      Description

      Gateway host

      Host name of the SAP gateway.

      Gateway service

      Service of the SAP gateway.

      Program ID of the server

      Program ID of the registered server program.

      Note: The program ID of the server is case sensitive.

      Application Server

      Host name of the SAP system.

      System number

      Number of the SAP system (two-digit numeric value).

      Note: For more information on obtaining the values found in the System tab, see your SAP system administrator.

    4. Click the Security tab.

      The Security tab becomes active as shown in the following image.

    5. To enable SNC, select 1 from the SNC mode drop-down list.

      By default, SNC is disabled.

    6. In the SNC partner field, type the name of the RFC server or message server (load balancing) that provides the SNC services.
    7. From the SNC level drop-down list, select the version of the SNC library.
    8. In the SNC name field, type the name of the SNC library you are using.
    9. In the SNC library path field, type the path to the SNC library
    10. Specify additional information or criteria for the channel you are creating.
    11. Click the Advanced tab.

      The Advanced tab becomes active as shown in the following image, with fields to enter or select an IDoc format, user defined function modules, and processing mode options, as well as check boxes to enable SAP traces or Unicode encoding of the event data.

    12. Specify additional information or criteria for the channel you are creating.

      Note: For more information on obtaining the values found in the Advanced tab, see your SAP system administrator.

      The following table lists and describes the parameters on the Advanced tab.

      Parameter

      Description

      IDOC Format

      The IDoc format to use for the channel you are creating. Possible values include:

      SAP IFR IDOC-XML (Default)

      FLAT IDOC

      IDOC release

      In the IDOC release field, specify the IDOC versioning you want to use for your connection.

      IDOC release provider

      From the IDOC release provider drop-down list, select, IDOC DOCREL field (default), SAP release, or user input.

      User Defined Function Modules

      Path on the file system that points to your user-defined function module. A user-defined function module is used as a data source.

      SAP trace

      Select this option to enable SAP traces.

      Unicode

      The iWay Application Adapter for mySAP ERP automatically detects whether the server you are connecting to is using UNICODE.

      Processing Mode

      Processing mode to use for your channel. Possible values include:

      REQUEST (Default)

      REQUEST_RESPONSE

  6. Click Next.

    The Select Ports pane opens as shown in the following image where you can move ports between the Available list and the Current list.

    1. Select an event port from the list of available ports.
    2. To transfer the port to the list of current ports, click the single right arrow button or to associate all event ports, click the double right arrow button.

      The port appears in the list of current ports as shown in the following image.

  7. Click Finish.

    In the left pane, the TEST_CHANNEL is selected and has an 'X' over the icon. The summary pane opens on the right with the channel description, channel status, and available ports as shown in the following image.

    All the information is associated with the channel you created. The 'X' over the icon indicates that the channel is currently disconnected. To activate your event configuration, you must start the channel using the Operations menu, as shown in the following image.

  8. Move the pointer over Operations and select Start the channel.

    The channel you created is now active, and the 'X' disappears, as shown in the following image.

    Note: You can start a channel even if a specific event port is not assigned. A default port is used in these situations. However, it is recommended that you always assign a specific port to the channel you create.

    For more information on creating a port, see Creating, Editing, or Deleting a Port.

    For more information on using the default port, see Using the Default Event Port.

  9. To stop the channel at any time, move the pointer over Operations and select Stop the channel.

Top of page

x
Procedure: How to Edit a Channel

To edit an existing channel:

  1. In the left pane, select the channel you want to edit.

    The Operations menu opens in the right pane over the summary of the channel information, as shown in the following image.

  2. Move the pointer over Operations and select Edit.

    The Edit channels pane opens on the right as shown in the following image.

  3. Make the required changes to the channel configuration fields.
  4. To continue editing information on the other tabs, click Next.
  5. When you complete your edits, click Finish.

Top of page

x
Procedure: How to Delete a Channel

To delete an existing channel:

  1. In the left pane, select the channel you want to delete.

    The Operations menu opens in the right pane over the summary of the channel information, as shown in the following image.

  2. Move the pointer over Operations and select Delete.

    A confirmation dialog box opens asking if you want to delete this item.

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

    The channel disappears from the list in the left pane.


iWay Software