Using XML parser pool functionality option

XML is analyzed in HCSC server by the following Java XML parser:

DOM parser (javax.xml.DocumentBuilder class)
SAX parser (org.xml.sax.XMLReader class)

Since multiple threads cannot share these XML parser instances, XML parser is created for each thread for simultaneous use by multiple threads. Since XML parser creation process requires time and performance deteriorates if the parser is created for each analysis.

You can use XML parser pool functionality to save in advance XML parser generated in XML parser pool created in the memory. The entire system shares XML parser saved in XML parser pool and process efficiency is expected to improve because the parser can be reused.

Specify XML parser pool functionality option in usrconf.properties (user properties file for J2EE server). These options are exclusive to Service Platform. The following points describe each option of XML parser pool functionality:

Organization of this subsection: (1) DOM parser pool functionality option; (2) SAX parser pool functionality option

(1) DOM parser pool functionality option

Specify DOM parser pool option used to analyze XML in HCSC server as follows:

Table 2-15 TableList of DOM parser pool functionality options

Item number	Key name	Contents	Default value
1	csc.dt.pool.DocumentBuilder.initialSize	Specify the number of default allocations when DOM parser pool is created by integers between 0 - 2,147,483,647. When you first create DOM parser, compile the number of default allocations and store in the pool. This enables you to reduce further creation time. If you specify a value larger than the maximum number of pools (specified by csc.dt.pool.DocumentBuilder.maxSize), initialization is by maximum number of pools. Operation is by default value if you specify a negative integer or a character string other than an integer.	0
2	csc.dt.pool.DocumentBuilder.maxSize	Specify the maximum number of pools of DOM parser by integers between 0 - 2,147,483,647. If DOM parser used exceeds the maximum number of pools specified here, standby status occurs till use by another thread ends. If you specify integers under 0, pool functionality is disabled. Operation is by default value if you specify character string other than integers.	64

Set the number of default allocations (specified by csc.dt.pool.DocumentBuilder.initialSize) and the maximum number of pools (specified by csc.dt.pool.DocumentBuilder.maxSize) to fulfill the following relation:

Number of default allocations ? Maximum number of pools ? Number of maximum simultaneous request executions

(2) SAX parser pool functionality option

Specify SAX parser pool option used to analyze XML in the following process:

Validation activity process of business process
Data validation functionality (specify ON in telegram-validation property in HCSC server runtime definition file)

The following table describes SAX parser pool options:

Table 2-16 TableList of SAX parser pool functionality options

Item number	Key name	Contents	Default value
1	csc.dt.pool.XMLReader.initialSize	Specify the number of default locations while creating SAX parser pool by integers between 0 - 2,147,483,647. When you first create SAX parser, compile the number of default allocations and store in the pool. This enables you to reduce further creation time. If you specify a value larger than the maximum number of pools (specified by csc.dt.pool.XMLReader.maxSize), initialization is by maximum number of pools. Operation is by default value if you specify a negative integer or a character string other than an integer.	0
2	csc.dt.pool.XMLReader.maxSize	Specify the maximum number of pools of SAX parser by integers between 0 - 2,147,483,647. If SAX parser used exceeds the maximum number of pools specified here, standby status occurs till use by another thread ends. If you specify integers under 0, pool functionality is disabled. Operation is by default value if you specify character string other than integers.	64

Set the number of default allocations (specified by csc.dt.pool.XMLReader.initialSize) and the maximum number of pools (specified by csc.dt.pool.XMLReader.maxSize) to fulfill the following relation:

Number of default allocations  ? Maximum number of pools 
 
<If data validation functionality is used>
Maximum number of pools  ? Maximum number of simultaneous executions of each business process/service adapter (multiplicity)
 
<If data validation functionality is not used>
Maximum number of pools  ? Total of maximum number of simultaneous executions of validation activities of each business process

2.3.10 Using XML parser pool functionality option

(1) DOM parser pool functionality option

(2) SAX parser pool functionality option