3.3.5 Deleting and resetting the schema cache

For deleting or changing schema documents to be cached, you must use commands to delete or reset up the cache. You can use the commands to apply the changes of the schema document in the cache without stopping the J2EE server.

For details about the precautions to be taken when deleting and resetting up the cache, see the subsection 6.18.4 Precautions related to reset up and deletion of a cache.

This subsection describes the commands to be executed while deleting and resetting up the cache:

Organization of this subsection
(1) cacheoff command (deleting cache with XML parser)
(2) cacheon command (cache resetting with XML parser)
(3) cachestate command (display the cache functionality status)
(4) Relation of the synchronous processing of each command and parsing

(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.

(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:

(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 executedSystem status
Other than when parsing and the cases mentioned at the right sideWhen setting up cacheWhen deleting cache
1ParsingStart parsing
(start the process immediately).
Start parsing after the setup is complete.Start parsing after completing the deletion.
2cacheon commandExecuted in the following order:
  1. Immediately end the command. However, the schema cache setup is not executed at that time.
  2. Start the next parsing.
  3. Setup cache.
3cacheoff commandExecute in the following order:
  1. Immediately end the command. However, schema cache is not deleted at that time.
  2. Start the next parse.
  3. Delete cache.
4cachestate commandDisplay 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".