Scalable Database Server, HiRDB Version 8 UAP Development Guide

[Contents][Index][Back][Next]

4.12.6 Notes about using lists

Organization of this subsection
(1) List after disconnection from HiRDB
(2) List status after row insertion or deletion
(3) Row insertion and deletion after list creation
(4) Execution of the ASSIGN LIST statement for a row partitioned table
(5) List operation by the same user
(6) Stopping of the dictionary server or a unit found in the dictionary server
(7) Recovery of a list base table with the database recovery utility
(8) Reinitialization of an RDAREA where a list base table is stored
(9) Execution of reorganization, creation mode download, or the PURGE TABLE statement on a list base table
(10) Narrowed search when the inner replica facility is used

(1) List after disconnection from HiRDB

A list is not deleted even after the UAP is disconnected from the HiRDB system. To delete a list, either use the DROP LIST statement or stop the HiRDB system to delete all lists.

(2) List status after row insertion or deletion

In a search that uses a list, rows that were present in the list when the list was created but then later deleted are not searched. If a row is updated after the list is created, the updated data is fetched.

(3) Row insertion and deletion after list creation

In a search that uses a list, rows that were inserted after the list was created and after rows in the base table were deleted are sometimes searched.

(4) Execution of the ASSIGN LIST statement for a row partitioned table

If the ASSIGN LIST statement is executed for a row partitioned table and the table cannot be searched because of shutdown of some of the RDAREAs in the base table, an error occurs even if the data of an RDAREA that can be searched is specified in a search condition for a partitioned column.

(5) List operation by the same user

The same user cannot connect to multiple HiRDB systems simultaneously and operate a list.

(6) Stopping of the dictionary server or a unit found in the dictionary server

With a HiRDB/Parallel Server, if the dictionary server or the unit that contains the dictionary server is stopped, the list management information is lost. As a result, operations (search, deletion, and update) become disabled for all lists that were created up to that point. (An error occurs if a list is operated.) To use a list that triggered an error when operated, use the ASSIGN LIST statement to create a new list that has the same list name as the previous list.

If the dictionary server is restarted, the KFPA11998-E error (list operation while transaction is undetermined) may be displayed for processes that use a list. This error may be displayed until recovery is completed for all list-using transactions of other users that were started before the server was stopped.

(7) Recovery of a list base table with the database recovery utility

If a log is used to recover a list base table to its latest status, the lists that were created can be used without modification. However, for a recovery that uses only a backup, a time-specification recovery that uses a log, or a recovery that does not use the latest log, use one of the following methods to delete or re-create all lists that were based on the recovered table:

If you want to use the lists:
Use the ASSIGN LIST statement to create lists that have the same list names as the previous lists.

If you do not want to use the lists:
Use the DROP LIST statement to delete the lists, or terminate and restart HiRDB to delete all created lists.

(8) Reinitialization of an RDAREA where a list base table is stored

Use one of the following methods to delete or re-create all lists that are based on a list stored in a reinitialized RDAREA:

If you want to use the lists:

Use the ASSIGN LIST statement to create lists that have the same list names as the previous lists.

If you do not want to use the lists:
Use the DROP LIST statement to delete the lists, or terminate and restart HiRDB to delete all created lists.

(9) Execution of reorganization, creation mode download, or the PURGE TABLE statement on a list base table

Executing reorganization, creation mode download, or the PURGE TABLE statement on a list base table invalidates previously obtained search results for lists that were created based on that table. To use the lists, you must use the ASSIGN LIST statement to re-create the lists.

(10) Narrowed search when the inner replica facility is used

When you use the inner replica facility and also use the pddbchg command or PDDBACCS in the client environment definitions to switch the RDAREA to be accessed, the search results become invalid unless one of the following conditions is satisfied:

To use a list, perform one of the following: