Configuring a Host Connection

The Services Builder for CICS run-time supports both TCP/IP and SNA host connections, and requires minimal configuration. Configuration includes defining a connection (referred to as a "System"), and then mapping Task IDs to Systems (referred to as "Mappings"), which enables tasks to be run.

Both Systems and Mappings are configured using the Management Console, under the Configuration node of each run-time server. Each run-time server you add represents an installation, or instance, of Runtime Service for CICS.

To configure a host connection
  1. Click  next to the run-time server you want to configure.

    The navigation tree expands and the Configure node appears below the selected run-time server.

  2. Click Configure.

    The Configuration window appears in the right pane with the Systems page displayed.

  3. Click New in the host connection pane for which you want configure a host.

    Depending upon your selection, the New TCP/IP System or the New SNA Gateway property page appears.

  4. Complete the system options, and then click OK. For detailed information about the options on these pages, click Help.

  5. Note Before an SNA Gateway system is operational, the SNA Gateway components of Services Builder for CICS must be configured. For more information, see Creating an SNA Gateway Configuration.
  6. From the Mappings page, click New.

    The New Mappings property page displays.

  7. Complete the Mapping options, and then click OK. For detailed information about the options on this page, click Help.

  8. (Optional) Configure your logging and tracing options for each run-time/host configuration using the options available on the Logging/Tracing page.

  9. Click Save Configuration to save your configuration as either remote or local.

    If the CICS Services Builder run-time server
    This occurs
    Is running The remote configuration file (.cfg) is saved to the install location of the run-time server in the following location:

    install_directory\Attachmate\EAI\CICSServer\Config

    Is not running The modified configuration file (.cfg) is saved locally to:

    ..\HTTPEngine\webapps\mcs\resources\connector_cics\
      specified_runtime_server

    Is running and a locally-saved configuration file is also available You will be prompted to choose which configuration file you want to modify before you can edit a configuration. If no configuration file is available, you will be asked whether you want to use a default configuration.

    For additional information about default configuration files and Runtime Service for CICS, refer to Server Configuration Files.

Once these configuration steps are complete, the run-time server can connect to one or more hosts and each host connection can handle one or more tasks.

Related Topics
Bullet Configuring Your Run-time Environment
Bullet Creating an SNA Gateway Configuration
Bullet Server Configuration Files
Bullet Connecting to the Host Via TCP/IP
  Attachmate