Show TOC

Procedure documentationCreate Service Locate this document in the navigation structure

Procedure

To create a new service in the ICF service hierarchy, proceed as follows:

  1. Call transaction SICF.

  2. A selection screen appears on which you can restrict which services or external aliases are displayed. Specify which hierarchy type (services or external aliases) you want to display. If required, you can restrict your selection further within the chosen hierarchy type by specifying the following:

    • Virtual host (only those services are displayed that are located under this root node)

    • Path (only those services are displayed that are located under the last node specified)

      Note Note

      The path must always start with "/" and must include a further "/" after each node.

      End of the note.

      Note Note

      The last node of the path can also be a service name. Only this service (with its root node) will then be displayed.

      • Description (only those services are displayed that contain the specified description)

      End of the note.

  3. Select an existing virtual host or service node under which you want to create a service.

    Note Note

    If you have your own namespace, we recommend that you create a node with the same name as the namespace at the top level of the hierarchy, and create all your services under this node.

    End of the note.

  4. Now select an object in the hierarchy that you want to use as a root node (or parent node) of the service you are creating (an existing service or a virtual host) and choose Create Host/Service (or right-click and choose New Subelement).

  5. In the following dialog box, enter a name for your service (or the alias for an existing service).

  6. Specify whether you want to create a service (Independent Service) or an internal alias (Reference to Existing Service).

    Caution Caution

    Note that the service name can have a maximum of 15 characters. Since services are transported, they are subject to the transport system’s restrictions.

    End of the caution.

  7. If you choose Independent Services, enter the properties of this service on the following screen and enter a HTTP request handler.

    Note Note

    You can create multiple HTTP request handlers for a single service. These are then called in the order you specify. You can use return codes to control whether other handlers from the list are called, and if so, which ones.

    End of the note.

  8. If you choose Reference to Existing Service, enter the relevant alias.

  9. Save your data by choosing .

  10. Check that the service is active.

More Information

When you create a service, you have the following configuration options:

For information about creating virtual hosts and aliases, see the following: