Converting DBOMP Calls to CA IDMS/DB Statements

Transparency Programs and Macros › IMBSBRDG program module › Converting DBOMP Calls to CA IDMS/DB Statements

Converting DBOMP Calls to CA IDMS/DB Statements

The IMBSBRDG program module simulates DBOMP processing by converting DBOMP calls to CA IDMS/DB statements. IMBSBRDG uses its process indicator table to make the conversion. The executing program:

Examines the process indicator (found in the work area prefix of the object record)
Searches the process indicator table for the name of the IMBSBRDG routine that issues the equivalent CA IDMS statement
Passes control to the appropriate IMBSBRDG routine, which performs the requested retrieval or update function

IMBSBRDG Routines

The following table describes the IMBSBRDG routines.

The IMBSBRDG module supplied on the installation media includes comments for each of these routines as well as for the routines that move pointers and data to and from the DBOMP file work area.

Name of routine	What it does
HOUSEKEEPING (performed on each entry to BM$PIO and AP$SEQ)	Saves registers Establishes addressability Sets sequential flag for entry to AP$SEQ
MAINLINE	Routes all calls to IMBSBRDG: On first call, passes control to INITIALIZATION routine For all subsequent calls, passes control to PROCESS INDICATOR routine and to FILENAME VERIFICATION routine
INITIALIZATION (performed on initial entry to IMBSBRDG)	Establishes location of IMBSTAB tables and loads their addresses Signs on to CA IDMS/DB BINDs CA IDMS/DB dummy record to pointer table in IMBSTAB BINDs all record types to CA IDMS/DB logical record buffer in IMBSTAB READYs the CA IDMS/DB database areas in the specified usage mode Initializes the general CA IDMS/DB call Initializes registers
FILENAME VERIFICATION	Equates the DBOMP file name to a CA IDMS/DB record type name
PROCESS INDICATOR	Equates the DBOMP process indicator to a CA IDMS/DB function
MOVE RECORD	For retrieval functions, builds the expected DBOMP record from the CA IDMS/DB logical record buffer and passes the record to the named DBOMP file work area For update functions, extracts the data from the DBOMP file work area and passes the data to the CA IDMS/DB logical record buffer (pointers are not moved from the work area to the CA IDMS/DB logical record buffer)
MRAN MRKY	Performs random record retrieval
DIRECT READ	Performs direct record retrieval
MODIFY RECORD	Updates in place master and chain file records
SEQUENTIAL READ	Performs processing requested by GE$T
START KEY	Performs processing requested by ST$KY
START DA	Performs processing requested by ST$DA
OPEN	Determines location mode of CA IDMS/DB record type that corresponds to named DBOMP file Determines, for future MGET processing, whether CA IDMS/DB record type belongs to an indexed set Determines if RACN function is permitted for named DBOMP file and if so returns file control record to named DBOMP file work area
CLOSE	Returns file control record to CA IDMS/DB database and closes database
EXPAND	Moves disk address to named work area prefix from indicated sending field
COMPRESS	Moves disk address from named work area prefix to indicated receiving field