WebSphere brand IBM WebSphere Telecom Web Services Server, Version 7.1

Administering Parlay X Terminal Location over Parlay

After you deploy Parlay X Terminal Location over Parlay, you can use the TWSS Administration Console to change the deployment configuration properties for the Web service and related Service Platform components.

Terminal Location enables applications to send Web services requests requesting the Terminal Location services defined by the Parlay X 2.1 specification and to register for Terminal Location notifications. Terminal Location offers a simple Web services API that adapts the Parlay X 2.1 API to the Parlay API. The Parlay Connector is responsible for making and managing this connection, as well as CORBA calls to the database.

TWSS Administration Console settings

This Web service implementation adds the following configurable settings to the TWSS Administration Console:
  • Global: Policy values that are used for all services.
    • Common Service Settings: Use these settings to configure naming schemes for groups. The Access Gateway uses the IBM® XDMS component to resolve groups, and it can define and configure groups apart from the group scheme.
      • Country and code: The local country and code.
      • Address plan: The local address plan.
      • Enable Transaction Monitoring: Whether or not to enable transaction monitoring.
      • Supported Group Scheme: A comma-separated list of URI schemes that the service treats as a group URI. This setting must be coordinated with the Group List Manager component configuration. The default value is glmgroup.
      For more information about these settings, refer to the topic Group schema configuration.

  • Services: Default values used for Parlay X Terminal Location over Parlay:
    • Terminal Location Web service: The following lists the configurable runtime properties:
      • Network Resource Name: This field defines the Network Resource name, this name should be same as the one defined under Network Resources -> Network Resources Configuration -> Resource Name for Parlay X Terminal Location over Parlay. The default value is PX21_TL_Parlay.
      • Periodic Notification Supported: Indicates the availability of periodic notification.
      • Geographical Notification Supported: Indicates whether notifications may be set on a geographical area.
      • Terminal Location Enabled: True if the service is enabled, false if disabled and all requests will be rejected.
    • Terminal Location Parlay:
      • Parlay Service Name: Parlay gateway service name.
      • Minimum Triggered Notification Radius: The minimum notification radius allowed, in meters.
      • Ignore Check Immediate: Indicates whether the checkImmediate flag should be ignored because the Parlay gateway automatically checks device attributes when a notification is initially created.
      • Parlay Automatic Retry: Indicates whether a Parlay error should cause the service to retry an operation. Should be true if multiple gateways are configured for failover.
      • Use Extended Location: Determines whether extended location requests should be made.
      • Parlay Gateway Location Method List: List of Parlay gateway location method strings. Entries in the list must match a location method supported by the Parlay gateway. See LocationAccuracyRangeList and the Parlay 4.x Mobility Specification. (This is ignored if UseExtentedLocation=false.)
      • Use Degrees for Notification Radius: Indicates whether the gateway expects major and minor axis measurements in degrees.
      • Gateway Reporting Interval Precision: Units of time passed to the Parlay gateway, in seconds or milliseconds.
      • Parlay Gateway Location Accuracy Range List: Integer list of location ranges. Entries are used to select the corresponding location method and parameters for Parlay 4.x Mobility requests. Entries must be in ascending order. (This is ignored if UseExtentedLocation = false)
      • Parlay Gateway Location Type List: List of Parlay gateway location type strings, which must consist of the following strings:
        P_M_CURRENT_OR_LAST_KNOWN 
        P_M_CURRENT 
        P_M_INITIAL
        See LocationAccuracyRangeList and the Parlay 4.x Mobility Specification.
      • Use Camel Interface: Indicates whether the CAMEL (Customized Applications for Mobile Network Enhanced Logic) interface should be used to make Parlay requests.
      • Maximum Triggered Notification Radius: The maximum notification radius allowed, in meters.
      • Number of Parlay Automatic Retries: The number of times the service will retry a Parlay operation.
      • Response Timeout: Indicates the amount of time, in seconds, to wait for service activity. Service execution must complete within this window or a ServiceException will be returned to the client.
  • Common Components: Click the name of a Service Platform component–for example Fault Alarm Client or Usage Record Client–to configure it to work with this Web service implementation. If you leave the endpoint URI empty for a component, then the component is disabled.

You can receive additional information on specific properties from the online help in the TWSS Administration Console.

Policies

Policy attributes are retrieved from Subscription Management in the Access Gateway and are passed to the Parlay X Terminal Location over Parlay Web service in the SOAP headers. If the policies are not found in the SOAP header, then the Web service uses the values that are defined in the TWSS Administration Console.

For information about default policy configuration, refer to the following topic: Default service policies for Parlay X Terminal Location over Parlay.




Terms of use
(C) Copyright IBM Corporation 2009. All Rights Reserved.