3.3.5 Deleting and resetting the schema cache
(1) cacheoff command (deleting cache with XML parser)
(a) Format
cacheoff J2EE server name
(b) Operation while executing the cacheoff command
The following are the operations when using the cacheoff command. Note that if the schema cache functionality is disabled, no operation will be performed even when using the cacheoff command.
- When you execute the cacheoff command, the XML parser releases all the cache from the memory, and deletes the directories having the same name as the J2EE server in the directory specified in diskcache_path of the schema definition file, and all the disk cache created below the directory.
- The schema cache functionality is disabled after the cacheoff command is executed, and the XML parser executes the schema validation without using the cache.
- The cacheoff command instructs the deletion of the cache in the XML parser, but does not directly delete the cache. The cache is deleted, when the DOM parse is passed for the first time, after the cacheoff command is executed.
- When using the cacheoff command, the directory "directory or server name specified in diskcache_path" is displayed, and the user is requested to confirm the deletion. Even when the cache is not created on the disk, and only the directory to save the disk cache is to be created, the user will be requested to confirm the deletion.
- An error message (KECX09506-E) is output in the standard error output, when using the cacheoff command, and an internal directory and the internal files are not accessible due to the abnormalities in the system, and the command process is interrupted.
- The error message (KECX09510-E) is output, when you specify the J2EE server name that does not exist in the argument of the cacheoff command.
- The error message (KECX09510-E) is output when ON is not specified in the com.cosminexus.jaxp.grammar_caching.preload property of the user-defined file of the J2EE server, and the cacheoff command is used for the J2EE server.
- When there is a mistake in the argument of the command, the following error message is output and the process is interrupted:
KECX09513-E cacheoff : Invalid parameter.
usage : cacheoff J2EE_server_name |
(2) cacheon command (cache resetting with XML parser)
(a) Format
cacheon J2EE server name
(b) Operation when executing the cacheon command
The following are the operations, when using the cacheon command:
- When using the cacheon command, the XML parser releases the cache from the memory and deletes the directories having the name same as that of the J2EE server in the directory specified in diskcache_path of the schema definition file, and all the disk cache created below the directory. Consequently, the cache is set up again according to the contents of the schema definition file.
- The schema cache functionality is enabled after using the cacheon command, and the XML parser executes the schema validation using the cache.
- The cacheon command instructs the reset up of cache with the XML parser, but does not directly delete or reset up the cache. The cache is deleted or reset up when the XML parse is passed for the first time, after using the cacheon command.
- When using the cacheon command, an internal directory and the internal files are not accessible because of the abnormalities in the system, the error message (KECX09506-E) is output in the standard error output, and the command process is interrupted.
- When you specify the J2EE server name that does not exist in the argument of the cacheon command, the error message (KECX09510-E) is output.
- When ON is not specified in the com.cosminexus.jaxp.grammar_caching.preload property of the user-defined file of the J2EE server, and the cacheon command is executed for that J2EE server, the error message (KECX09510-E) is output.
- When there is a mistake in the argument of the command, the following error message is output and the process is interrupted:
KECX09513-E cacheon : Invalid parameter.
usage : cacheon J2EE_server_name |
(3) cachestate command (display the cache functionality status)
(a) Format
cachestate [-d] [J2EE server name]
(b) Operation when executing the cachestate command
The following are the operations when using the cachestate command:
(4) Relation of the synchronous processing of each command and parsing
The following table describes the relation of the synchronous processing of the cacheon command, cacheoff command, cachestate command, and the parsing.
Table 3-6 Relation of the synchronous processing of each command and parsing
No. | Action to be executed | System status |
---|
Other than when parsing and the cases mentioned at the right side | When setting up cache | When deleting cache |
---|
1 | Parsing | Start parsing (start the process immediately). | Start parsing after the setup is complete. | Start parsing after completing the deletion. |
2 | cacheon command | Executed in the following order:
- Immediately end the command. However, the schema cache setup is not executed at that time.
- Start the next parsing.
- Setup cache.
|
3 | cacheoff command | Execute in the following order:
- Immediately end the command. However, schema cache is not deleted at that time.
- Start the next parse.
- Delete cache.
|
4 | cachestate command | Display the following information:
- When the schema cache functionality is enabled:
- "KECX09501-I J2EE Server 'J2EE server name': schema cache: ON"
- When the schema cache functionality is disabled:
- "KECX09501-I J2EE Server 'J2EE server name': schema cache: OFF"
| "KECX09501-I J2EE Server 'J2EE server name': schema cache: displays OFF". |