The Transparency Environment › DBOMP Macros Supported › Macros That Require Program Modification and Reassembly

Macros That Require Program Modification and Reassembly

The transparency requires that programs issuing macros to entry point AP$SEQ be altered and subsequently reassembled before interfacing with the bridge. The transparency can simulate the following macros only if you remove the prerequisite MF$SQ and FI$LE macros from the issuing program and replace them with the transparency macro IMBSEQ (see Transparency Programs and Macros):

• GE$T— Sequential retrieval
• PU$T— Sequential update
• ST$KY— Skip-sequential retrieval using logical key
• ST$DA— Skip-sequential retrieval using disk address

Transparency support of the sequential processing logic generated by the ST$KY and ST$DA macros assumes the use of indexing. Indexing allows the transparency to support logical sequential dependencies in DBOMP programs. If indexing hasn't been defined for the database, all programs using ST$KY and ST$DA must be altered to remove logical sequential dependencies before interfacing with the bridge.

The transparency handles GE$T, PU$T, ST$KY, and ST$DA as follows:

• GE$T—The transparency retrieves the first record in the logical or physical sequence of the named file and returns it to the work area. Subsequent GE$T macros issued for the same file cause the transparency to retrieve records in logical sequential order from that point if the record type is indexed, or in physical sequential order from that point if the record type is not indexed. Each retrieved record becomes current of run unit and current of its record type.
• PU$T—The transparency verifies that the named record is current of the transaction, updates the record with the information in the user work area, and returns the record to the CA IDMS/DB database. If the record is not current of run unit when PU$T is issued, CA IDMS DBOMP Transparency performs a direct read to establish currency.
• ST$KY—The transparency retrieves a record by the key specified in the work area prefix for the named file and returns the record to the work area. Currency for the file (record type) is set at the retrieved record. Subsequent GE$T macros cause the transparency to retrieve records in logical sequential order from that point if the record type is indexed, or in physical sequential order from that point if the record type is not indexed.
• ST$DA—The transparency retrieves a record by the disk address specified in the work area prefix for the named file and returns the record to the work area. Currency for the file (record type) is set at the retrieved records in logical sequential order from that point if the record type is indexed, or in physical sequential order from that point if the record type is not indexed.