XIBOD exit interface block for ODBM and IMS DB data store information

For connections to IMS DB, IMS Connect keeps track of the status of Open Database Manager (ODBM) instances and IMS data stores in entries in the XIBOD exit interface block for ODBM and data store information. The IMS Connect DB Routing user exit routines can reference the XIBOD to make routing decisions for incoming messages based on whether the ODBM instances and data stores are active.

For the ODBM instances known to IMS Connect, the XIBOD keeps track of the following ODBM states:

• ODBM is running and connected to IMS Connect.
• ODBM is running but not connected to IMS Connect. You can issue the IMS Connect WTOR command STARTOD or the IMS Connect type-2 command UPDATE IMSCON TYPE(ODBM) START(COMM) to establish a connection to ODBM.
• ODBM is running but not reachable because the Structured Call Interface (SCI) on the LPAR that the ODBM is running on is down. Restart the SCI to restore the connection between IMS Connect and ODBM.
• ODBM is not running. ODBM must be restarted before a connection can be made between IMS Connect and ODBM.

The XIBOD block also stores ODBM version information.

Data stores are known to IMS Connect by the alias names that are assigned to the data store in the ODBM configuration member CSLDCxxx during ODBM system definition. For IMS Connect to route an incoming request to a specific data store, the alias name of the data store must be active in both the ODBM in which it is defined and in IMS Connect.

For each alias name defined to the ODBM instances that are known to IMS Connect, the XIBOD keeps track of the following states of the connection to the data store represented by the alias name:

• The connection to the data store is complete. The alias name is active in both the ODBM instance and in IMS Connect (XIBOD_ICACTIVE EQU X'20').
• The connection to the data store is not complete. The alias name is active in ODBM, but has never been activated in IMS Connect (XIBOD_IACTIVE EQU X'80').
• The connection to the data store is not complete. The alias name was active in both ODBM and IMS Connect, but is no longer active in IMS Connect. The alias name is still active in ODBM (XIBOD_ICINACTIVE EQU X'10').
• The connection to the data store is not complete. The alias name was active in both ODBM and IMS Connect, but is no longer active in ODBM. Consequently, the alias name is no longer active in IMS Connect (XIBOD_IINACTIVE EQU X'40').

You can also use the XIBOD_USER field of an exit interface block data store entry for any purpose. You can code the IMS Connect User Initialization exit routine (HWSUINIT) to set the XIBOD_USER field during IMS Connect startup.

The exit interface block data store entries are mapped by the HWSXIBOD macro.