7.3.7 hold
This subcommand holds the services of the queue in the arguments.
The following table describes the arguments that can be specified for the subcommand hold:
Argument |
Explanation |
Target specification |
|
---|---|---|---|
Logical server |
Host |
||
queue <queueName> { in[:waitTime] | out | force[:waitTime]} |
Locks the queue with the name specified in <queueName> that belong to the CTM specified by the -t option. |
Y |
-- |
queues { in[:waitTime] | out | force[:waitTime] } |
Locks the queues belonging to the CTM or host specified by the -t option. |
Y |
Y |
allQueues { in[:waitTime] | out | force[:waitTime] } |
Locks all CTM queues in the management domain. |
-- |
-- |
You can use the hold subcommand to lock queues with the following three types of methods:
-
Specify the queue argument to lock a queue with a specific name.
Locks the queue with the name <queueName> belonging to the CTM specified by the -t option. Make sure to specify the -t option and <queueName>. Note that you cannot specify the host name in the -t option.
Specify in (locking the queue entrance), out (locking the queue exit), or force (force-locking the queue) as the lock conditions for the queue. When in is specified, you can specify the waiting time for the completion of a request being queued. Specify the following values for the waiting time, in the format in:waitTime:
- 0:
-
Locks the entrance of the queue, and waits until all requests being queued are completed.
- 1 to 2147483647:
-
Locks the entrance of the queue, and waits for the specified number of seconds for the completion of the requests being queued.
- -1:
-
Locks the entrance of the queue, and performs error return for all requests being queued.
If only in is specified, in:-1 will be setup.
If you specify out and lock the exit of the queue, requests will be received in the locked state, but the requests will not be distributed to the J2EE application. To replace a J2EE application in the online state, specify out, and then lock the queue.
When you specify force, the entrance of the queue will be locked in the same way as is locked when in:-1 is specified, and error return will be performed for all requests being queued, but locking can be executed at a faster speed as compared to when in:-1 is specified. Furthermore, you can specify the waiting time in the format force:waitTime. The specified values are same as for the case when in is specified.
-
Specify the queues argument to lock multiple queues.
Locks all queues belonging to the CTM or host specified by the -t option. Make sure to specify the -t option. in, out, and force are specified in the same way as for the case when the queue argument is specified.
-
Specify the allQueues argument to lock all queues.
Locks all queues of the management domain. in, out, and force are specified in the same way as for the case when the queue argument is specified.