Returns true and fetches the rightmost non-null row of an ordered conglomerate into "fetchRow" if there is at least one non-null row in the conglomerate. If there are no non-null rows in the conglomerate it returns false. Any row with a first column with a Null is considered a "null" row.
Non-ordered conglomerates will not implement this interface, calls will generate a StandardException.
RESOLVE - this interface is temporary, long term equivalent (and more) functionality will be provided by the openBackwardScan() interface.
ISOLATION_SERIALIZABLE and MODE_RECORD locking for btree max: The "BTREE" implementation will at the very least get a shared row lock on the max key row and the key previous to the max. This will be the case where the max row exists in the rightmost page of the btree. These locks won't be released. If the row does not exist in the last page of the btree then a scan of the entire btree will be performed, locks acquired in this scan will not be released.
Note that under ISOLATION_READ_COMMITTED, all locks on the table are released before returning from this call. @param conglomId The identifier of the conglomerateto open the scan for. @param open_mode Specifiy flags to control opening of table. OPENMODE_FORUPDATE - if set open the table for update otherwise open table shared. @param lock_level One of (MODE_TABLE, MODE_RECORD). @param isolation_level The isolation level to lock the conglomerate at.One of (ISOLATION_READ_COMMITTED, ISOLATION_REPEATABLE_READ or ISOLATION_SERIALIZABLE). @param scanColumnList A description of which columns to return from every fetch in the scan. template, and scanColumnList work together to describe the row to be returned by the scan - see RowUtil for description of how these three parameters work together to describe a "row". @param fetchRow The row to retrieve the maximum value into. @return boolean indicating if a row was found and retrieved or not. @exception StandardException Standard exception policy.
Returns true and fetches the rightmost row of an ordered conglomerate into "fetchRow" if there is at least one row in the conglomerate. If there are no rows in the conglomerate it returns false.
Non-ordered conglomerates will not implement this interface, calls will generate a StandardException.
RESOLVE - this interface is temporary, long term equivalent (and more) functionality will be provided by the openBackwardScan() interface. @param xact_manager The TransactionController under which this operation takes place. @param rawtran The raw store xact to associate all ops with. @param conglomId The identifier of the conglomerateto open the scan for. @param open_mode Specifiy flags to control opening of table. OPENMODE_FORUPDATE - if set open the table for update otherwise open table shared. @param lock_level One of (MODE_TABLE, MODE_RECORD, or MODE_NONE). @param locking_policy The LockingPolicy to use to open the conglomerate. @param isolation_level The isolation level to lock the conglomerate at.One of (ISOLATION_READ_COMMITTED, ISOLATION_REPEATABLE_READ, or ISOLATION_SERIALIZABLE). @param scanColumnList A description of which columns to return from every fetch in the scan. fetchRow and scanColumnList work together to describe the row to be returned by the scan - see RowUtil for description of how these three parameters work together to describe a "row". @param fetchRow The row to retrieve the maximum value into. @return boolean indicating if a row was found and retrieved or not. @exception StandardException Standard exception policy.
| |
| |
| |
| |
| |
| |
| |
| |