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

6.2.1 Creating Direct Access Key Definition File

A Direct access key definition file is the file that specifies an element note, which exists in an XML document and the identity has been guaranteed, in the text expression or attribute expression. The file is also corresponded with the name of the direct access key.

Enter contents of a direct access key definition file with the following format.

[Figure 6-2 The definition of the direct access key definition file]

Refer to B.2.2 Text Expressions for more information on the format for text expressions.
Refer to B.2.3 Attribute Expressions for more information on the format for attribute expressions.
Refer to C.4 Allowable Values for the Direct Access for more information on the allowable value when defining the value.

Restart the Shunsaku system when the direct access key definition file is edited.

The following section explains how to specify the direct access key definition file.

• Define a direct access key name in each line.
• A direct access key name has to be specified up to 32 bytes of alphanumeric characters.
• The maximum length in one line is 4096 bytes. (not including line feeds)
• An identity in an XML document has to be guaranteed for the direct access key. If Shunsaku File is used, the identity has to be within 1 file.
• If Shunsaku is operated with the Symfoware Server, specify the identity restriction (PRIMARY KEY) of the Symfoware Server into the direct access key.
• One definition of the direct access key name can contain up to 64 text expressions or attribute expressions.
• Double slash "//" and asterisk "*" cannot be specified in a text expression or an attribute expression.
• The same direct access key name cannot be defined more than once.
• Lines that begin with "#" are treated as comments.
• A "#" character cannot be specified for a comment in the middle of a line.
• Enter at least one definition of direct access key name in the direct access key definition file.
• If the text nodes or the attribute nodes specified in a direct access key are multi-byte characters, enter the same character code as the character identifier "CharacterCode" specified in the system environment file.

• The direct access key definition file and the director environment file have to be backed up at the same time.
• If the direct access function is used, the memory use of a director server will be increased because the direct access key information has to be loaded into the memory of the director.
  Therefore it is necessary to estimate the memory use of the director and also necessary to design the structure of the Shunsaku system.
  Refer to Estimating Resources in the Operator's Guide for more information on how to estimate the memory use of the director.
• There is no identity check on a direct access key in Shunsaku. Note that if an identity of the direct access key is not guaranteed, all XML documents that the element nodes have the same direct access key will be manipulated.

The following text is an example of the direct access key definition file.

# Direct access key definition file
key1 /doc/news/day/text(),/doc/news/number/text()

If multiple text nodes specified by a text expression or multiple attribute nodes specified by an attribute expression exist in the same document, the value at the beginning of the text node or the attribute node will be used. The example below shows that only the first data will be accessed. Other two data will not be accessed.