14.3.18 put (stores specified data)
- Organization of this subsection
(1) Description
This subcommand associates a specified value with a key, and then stores it.
This subcommand is used to test whether the configured execution environment is operational.
(2) Rules
You can execute this subcommand when the EADS server is running.
(3) Format
eztool put cache-name key value
(4) Options and arguments
(a) cache-name
Specify the name of the cache that stores the value.
The following characters are permitted for a cache name:
-
If cache property files were not used to create caches
A maximum of 32 single-byte characters in ASCII codes 0x20 to 0x7E
-
If cache property files were used to create caches
A maximum of 32 single-byte alphanumeric characters (0 to 9, A to Z, and a to z)
(b) key
Specify the key associated with the value that you are storing.
For details about the data that can be specified as keys, see 15.2.2(1) Data types that can be specified as keys.
(c) value
Specify the value you want to store.
For value, you can specify a character string (java.lang.String) consisting of a maximum of 1,024 single-byte characters.
(5) Return code
The following table lists the return codes that this subcommand returns.
|
No. |
Return code |
Description |
|
|---|---|---|---|
|
eads.command.compat parameter omitted in the command properties |
0300 specified in the eads.command.compat parameter in the command properties |
||
|
1 |
0 |
0 |
Command execution was successful. |
|
2 |
101 |
101 |
Initialization of the command failed. |
|
3 |
120 |
The command failed due to a syntax error. |
|
|
4 |
150 |
The command failed during execution. |
|
|
5 |
200 |
The command failed due to a timeout. |
|
(6) Notes
You can use this subcommand to manipulate data processed by an API function; conversely, you can use an API function to manipulate data processed by this subcommand.
Note that the data types and sizes permitted for key and value are not completely compatible with those permitted by the API functions. For example, this subcommand cannot store an object that is not a character string (java.lang.String) or a value that consists of more than 1,024 single-byte characters.