Interstage Shunsaku Data Manager Application Development Guide - Microsoft(R) Windows(R) 2000/ Microsoft(R) Windows Server(TM) 2003 - - UNIX -

6.4 Searching Data by Direct Access Key

Specify the direct access key at the API provided by Shunsaku to search the XML document that is identical to the direct access key from the XML document stored in Shunsaku (hereafter referred to as 'direct search')

There is no influence from the search process by record ID to the direct search process. Therefore, the system will be able to process the search faster than the search without the direct access.

The Flow of the Direct Search

The following figure shows the flow of the direct search.

[Figure 6-3 The flow when using the direct search]

• If the direct access key name specified in the direct search API is not identical to the direct access key name entered in the direct access key definition file, the error with the API using the direct access key will occur. Specify the same direct access key definition file into all director environment files in the Shunsaku system.
• If Shunsaku file is used, specify the same direct access key definition file to all director environment files defined by the Shunsaku file. It is not necessary to specify the same direct access key definition file to the director specified by other Shunsaku file.
• If the direct access key specified in the direct search API does not exist, the number of search result will be zero.
• If the number of the direct access key element node entered in the direct access key definition file is different from the number of the direct access key element entered in the API, the error with the API that is using the direct access key will occur.
• Specify the direct access key element in order of the direct access key element entered in the direct access key definition file. If the direct access key element is not in the correct order, the search result may not be returned correctly.
• The direct search API can process the search that specifies multiple direct access keys at a time.
• If the identity of the direct access key is not guaranteed, all XML documents that the element nodes have the same direct access key will be returned.

The following sections explain about the Java API, .NET API, and C API.

---

6.4.1 For Java API

6.4.2 For .NET API

6.4.3 For C API