Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 1 Installing Service Gateway for IDMS/DB : Introducing Service Gateway for IDMS/DB

Introducing Service Gateway for IDMS/DB
Service Gateway for IDMS/DB is a server interface used to access CA‑IDMS data from within TIBCO Object Service Broker. It uses CA‑IDMS services to provide retrieval and update access and to ensure data integrity. It ensures data is presented to TIBCO Object Service Broker rules in a manner consistent with TIBCO Object Service Broker behavior. The navigation of the CAIDMS database is defined in the IDM table definition and is therefore not required in each application that accesses CAIDMS data. You can get concurrent real-time access to CA‑IDMS data using either CAIDMS Central Version or Local mode.
The Service Gateway for IDMS/DB interface consists of the following components:
TIBCO Object Service Broker CAIDMS Data Dictionary (IDD) extract program – extracts subschema-specific data and creates data sets to be loaded into TIBCO Object Service Broker control tables
TIBCO Object Service Broker tool – manages the definition of CA‑IDMS data as follows:
Table Definer – defines IDM tables based on CA‑IDMS subschema information.
Service Gateway for IDMS/DB – formats TIBCO Object Service Broker requests into CA‑IDMS Data Manipulation Language (DML) calls to retrieve, insert, replace, or delete CA‑IDMS records.
Accessing CA‑IDMS Data
The figure below shows how you can access CA‑IDMS data through either the CA‑IDMS Central Version or in Local mode, while still having access to TDS data, which is TIBCO Object Service Broker's native data type.
Initializing a Gateway
The initializer program (S6BIDMST) is used only to start an instance of Service Gateway for IDMS/DB (a Data Object Broker must be active before the Gateway can be started). The initializer program establishes communication to the Data Object Broker using the TIBCO Object Service Broker Communication Subsystem (OCS), interprets the gateway startup parameters, and attaches the number of Gateway tasks requested in the startup parameters.
For CA‑IDMS Release 14.0 and above, the following occurs:
The Gateway uses the standard CAIDMS batch interface for accessing data through the Central Version or in Local mode.
Processing CA‑IDMS Data
The figure below shows how data is sent to the Data Object Broker in variable length buffers up to a maximum of 31 KB. If a row is less then 4KB, the maximum buffer size of 4 KB is used; otherwise, a 31 KB buffer is used. If a single request requires more rows than a buffer will hold, multiple buffers are sent until the request is complete.
Deployment
You can configure the Data Object Broker and the Service Gateway for IDMS/DB to reside on different hosts and/or operating systems (z/OS, Windows, or Solaris). Service Gateway for IDMS/DB must be in the same domain as the CA‑IDMS database system. Refer to Connecting the Gateway to a Windows or Solaris Data Object Broker for additional information.
If all components reside in the same domain and in authorized libraries, Cross Memory Services is used for communications. If the components do not all reside in authorized libraries, you can still get the Gateway to use Cross Memory Services; refer to Connecting the Gateway Using Cross Memory Services.
See Also
The TIBCO Object Service Broker for z/OS Installing and Operating manual or the TIBCO Object Service Broker for Open Systems Installing and Operating manual for more information on communications requirements.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved