Modules

Introduction to the CA IDMS DBOMP Transparency › Functions and Modules › Modules

Modules

The two central transparency modules are IMBSBRDG and IMBSTAB:

IMBSBRDG—handles all application program requests for database services
IMBSTAB (user-customized bridge module)—supplies IMBSBRDG with the CA IDMS/DB and DBOMP record descriptions necessary to simulate DBOMP processing

IMBSBRDG and IMBSTAB are discussed briefly below. These and other transparency components are described in detail in Transparency Programs and Macros.

IMBSBRDG

The IMBSBRDG module replaces the DBOMP modules:

BM$PIO
AP$SEQ

IMBSBRDG simulates DBOMP retrieval processing and update processing at the BM$PIO and AP$SEQ entry points, as shown in the following table.

Simulation of:	Description
Retrieval processing	Accepts a DBOMP call to entry point BM$PIO or AP$SEQ Validates the DBOMP file name and process indicator Converts the process indicator to a CA IDMS/DB call Retrieves the requested record from the CA IDMS/DB database Converts the retrieved CA IDMS/DB record to a DBOMP record Returns the converted record to the calling program Converts the CA IDMS/DB error status to the appropriate DBOMP error code Updates the work area prefix Returns control to the calling program
Update processing	Accepts a DBOMP call to entry point BM$PIO or AP$SEQ Validates the DBOMP file name and process indicator Converts the process indicator to a CA IDMS/DB call Reconstructs a CA IDMS/DB record from the updated DBOMP record Returns the reconstructed record to the CA IDMS/DB database Converts the CA IDMS/DB error status to the appropriate DBOMP error code Updates the work area prefix Returns control to the calling program

Simulation of:

Description

Retrieval processing

Accepts a DBOMP call to entry point BM$PIO or AP$SEQ
Validates the DBOMP file name and process indicator
Converts the process indicator to a CA IDMS/DB call
Retrieves the requested record from the CA IDMS/DB database
Converts the retrieved CA IDMS/DB record to a DBOMP record
Returns the converted record to the calling program
Converts the CA IDMS/DB error status to the appropriate DBOMP error code
Updates the work area prefix
Returns control to the calling program

Update processing

Accepts a DBOMP call to entry point BM$PIO or AP$SEQ
Validates the DBOMP file name and process indicator
Converts the process indicator to a CA IDMS/DB call
Reconstructs a CA IDMS/DB record from the updated DBOMP record
Returns the reconstructed record to the CA IDMS/DB database
Converts the CA IDMS/DB error status to the appropriate DBOMP error code
Updates the work area prefix
Returns control to the calling program

IMBSTAB

The IMBSTAB customized bridge module is generated by the user-coded customizing macro, IMBS. IMBSTAB consists entirely of buffers and tables that describe the DBOMP files and their equivalent CA IDMS/DB record types and set relationships. IMBSTAB provides IMBSBRDG with the environmental information necessary to build DBOMP records to be returned to the calling program and to reconstruct CA IDMS/DB records to be returned to the CA IDMS/DB database.