Navigation Routines, D3Mxxx

D3MMDB - Select an MDB

This routine selects an MDB within the requested Marine project, opens the MDB databases and navigates to the default database world. The user has the option of specifying the default database type or can allow it to default to the type of the first MDB database.

D3MCDB - Make a Database Current in MDB

This routine makes a named database in the current MDB current at the specified position. Other databases are shuffled up or down, as necessary. This is equivalent to the Marine command CURRENT.

D3MEDB - Exchange Databases in MDB

This routine exchanges a current and a deferred database in the current MDB. One of the named databases must have 'current' status and the other must have 'deferred' status. Their status and list order position will be reversed. is equivalent to the Marine command EXCHANGE.

D3MDDB - Defer a Database in MDB

This routine defers a named database in the current MDB. This is equivalent to the Marine command DEFER.

D3MQDB - Query Database in Current MDB

This routine reads the name and status of the database in a defined position in the current MDB. If executed within a loop, this is equivalent to the Marine command STATUS.

D3MNAM - Move to an Element by Name or Reference Number

This routine navigates the hierarchy to an element specified by name or reference number.

D3MNUM - Move to an Item by Order Position

This routine navigates the hierarchy to an element by specified list order position. This mimics Marine commands such as '1', 'BRAN 3', 'EQUIP 1'.

The type of element may be an Marine noun (for example, BRANCH) or special keywords to move in the current list or to move to a member owned by the current element.

D3MREL - Move Relative to the Current Position

This routine navigates the hierarchy relative to the current database position, mimicking Marine commands such as 'PREV', 'LAST MEMB', 'NEXT BOX'.

D3MOWN - Move to the Owner of the Current Element

This routine navigates to the owner of the current element.

D3MSAV - Save Current Database Position

This routine saves the current database position so that it may subsequently be restored by calling D3MRST. This is more efficient than using D3RNAM and D3MNAM.

Calls to D3MSAV and D3MRST must be paired and can be nested to a depth of 10.

D3MRST - Restore Last Saved Database Position

This routine restores the database position saved by the previous call to D3MSAV.