4.2.5.4 Remote Services Definition

SERVICE TYPE=REMOTE statements define remote services to which TMA TCP for IMS has access. Each statement specifies:

  • The corresponding local and remote service names
  • The Local Service Name is the name used by an IMS Client transaction to request the service. The Remote Service Name is the name of the service as defined on the remote system. These need not be the same, but note that the Remote Service Name must match the configuration of the remote system.
  • The remote system (Logical Machine ID) that offers the service
  • The remote system offering the service is identified by a Logical Machine ID, which must correspond to the Logical Machine ID specified in a GATEWAY TYPE=REMOTE statement.
  • A time limit for processing the request
  • The Time Limit (in seconds) specifies how long TMA TCP for IMS “waits” for a response to a request sent to a remote system before assuming that the request has “timed out” and that no response is forthcoming. Specify a value that makes a reasonable allowance for network latency and overall system load. Small values should be avoided because they may result in requests timing out under otherwise normal circumstances.

    Note:

    It is permissible to have more than one SERVICE TYPE=REMOTE statement for the same (local) service name. When this is the case, each statement must identify a different remote Logical Machine ID. This allows TMA TCP for IMS to “spread” requests for a particular service among multiple remote systems offering the service, thus balancing the load and improving overall throughput.