IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Services and service-related functions > Access external services with adapters > Configure and using adapters > IBM WebSphere Adapters > IBM i > Configure the module for deployment > Setting connection properties

Setting properties to connect to the IBM i system

Specify the connection properties to enable the external service wizard to discover business objects on the IBM i system.

The external service wizard requires these properties to connect to the IBM i system to discover and create a service description.


Procedure

  1. In the Specify the Discovery Properties window, specify the connection properties for the wizard to use to connect to the IBM i system.

    1. From the Select the discovery mode list, select IBM i System.

    2. In the Host name field, specify the host name or IP address of the IBM i system.

    3. In the User name field, enter the user name used to connect to the server from the wizard.

    4. In the Password field, enter the password used to connect to the server from the wizard

    5. Select any one of the following options from the Object type to discover list.

      • Data queue (default option)
      • RPG via PCML
      • COBOL via PCML
      • SRVPGM via PCML
      • RPG Program
      • COBOL Program

      Option to work directly with RPG Program and COBOL Program is not available during iterative discovery.

      For more details regarding the supported object types for IBM i adapter, refer to the following link: Supported object types.

    6. The Path to library on IBM i for object discovery field is populated with values based on the object type selected in the previous step. If you select Data queue, or RPG Program, or COBOL Program as the object type, the library path is populated with /QSYS.LIB/.

      If you select any of the Call IBM i programs, for example RPG via PCML, COBOL via PCML, SRVPGM via PCML, as one of the object types, the library path on the IBM i system is populated with /home/.

    7. In the Prefix for business object names list, type a string to be placed at the beginning of business object names.

      For example, if you select a business object called FIFOQ and you type Test for Prefix for business object names, the business object created by the wizard is TestFIFOQ.

      The following figure shows the options to specify a discovery property, using the IBM i system.

      Figure 1. Specify the Discovery Properties window.

    Connection information from this window is used by the adapter to connect to the IBM i system and discover business objects. In this same wizard at a later time, you can also change the connection information or an authentication alias to be used at run time.

  2. Optional: To enable bidirectional support for the adapter at run time:

    1. Click Advanced.

    2. Select Bidi transformation from the Bidi properties list.
    3. Set the ordering schema, text direction, symmetric swapping, character shaping, and numeric shaping properties to control how bidirectional transformation is performed.

  3. To change the location of the logging files for the wizard or the amount of information included in the logs, click Change logging properties for wizard, and then provide the following information:

    • In Log file output location, specify the location of the log file for the wizard.

    • In Logging level, specify the severity of errors that you want logged.

    The log information is only for the wizard. At run time, the adapter writes messages and trace information into the standard log and trace files for the server.

  4. After you provide the required connection information for the wizard, click Next. The Path to folder at IBM i for object discovery field is validated.

    If the path is invalid, a message to that effect appears. In addition, you can also check the logs, which are in the directory specified in the Log file output location. Ensure that the connection information is correct.

  5. Click Next to proceed with your discovery.


Results

The external service wizard connects to the IBM i server using the information you provided and the Find Objects in the Enterprise System window is displayed.


What to do next

Continue working in the wizard. Locate the objects on the IBM i system for which you want the wizard to create business objects.

Setting connection properties for the external wizard