|
|
Jmq
Action : was.jmq (Category : was, Name : jmq, By : kikonf)
Complete Name : was.jmq.by.kikonf
Version : 5.0 License : Modified BSD License
Purpose of the was category :
Easy to customize. This category use in background the wsadmin command in jython mode (through AdminConfig, AdminControl
and AdminTask), to drive WebSphere Application Server ® configuration.
You can use it to manage the whole WebSphere ® architecture.
Purpose of this jmq plugin : Creates one or more Queue Connection Factory(ies), Queue(s) and Activation Spec(s)
The following shows the Descriptor File for the Action : was.jmq
Toggle lines
<!-- Copyright (c) 2008, Patrick Germain Placidoux -->
<!-- All rights reserved. -->
<!-- -->
<!-- This file is part of Kikonf Public Software. -->
<!-- -->
<!-- Kikonf Public Software is released under the modified BSD License, -->
<!-- which should accompany it or any part of it in the file "COPYING". -->
<!-- If you do not have this file you can access the license -->
<!-- through the WWW at http://www.kikonf.org/license/bsd/license.txt. -->
<!-- -->
<!-- Home page: http://www.kikonf.org -->
<!-- Contact: kikonf@gmx.com -->
<!-- ====================================================================== -->
<!-- -->
<!-- -->
<!-- -->
<!-- ====================================================================== -->
<!-- UPDATE | DATE | CODE | REASON -->
<!-- ====================================================================== -->
<!-- | | | -->
<!-- -->
<!-- -->
<!-- ====================================================================== -->
<jmq
type = '{\
*eq:action,\
*required:True,\
*display:False\
}'
bal = '{*display:False}'
sub_type = '{\
*value:configuration,\
*eq:configuration,\
*required:True,\
*deny:True,\
*display:False\
}'
softwares = "{
'*type':'dict',
'*dtype':
{
'was':
{
'*ge':'6.1',
'*le':'7.9',
'*required':True
}
},
'*deny':True,
'*display':False
}"
prefix='{*help:%lang/action.was.en/prefix.help,*lhelp:%lang/action.was.en/prefix.lhelp}'
__wk__='{\
*help:%lang/action.was.en/jmq.help,\
*lhelp:%lang/action.was.en/jmq.lhelp\
}'
>
<scope
cell = '{*value:false,*checkIn:(false,true),*required:True}'
node = ''
server = ''
cluster = ''
__wk__='{\
*eq:1,\
*help:%lang/action.was.en/scope.help,\
*lhelp:%lang/action.was.en/scope.lhelp\
}'
/>
<qcfs __wk__ = '{*le:1}'>
<qcf name='{*required:True}' jndi_name='{*required:True}' channel='{*value:SYSTEM.SRV.CONN,*required:True}' queue_manager='{*required:True}' host='{*required:True}' port='{*type:int,*required:True}' ccsid='{*value:1208,*type:int,*required:True}' xa='{*value:false,*checkIn:(false,true),*required:True}' transport_type='{*value:CLIENT,*checkIn:(DIRECTHTTP,BINDINGS,DIRECT,CLIENT),*required:True}' pollint='{*value:500,*type:int,*required:True}' desc='' __wk__='{*help:%lang/action.was.en/jmq.qcf.help,*lhelp:%lang/action.was.en/jmq.qcf.lhelp}'>
<connection_pool __wk__ = '{*le:1}'>
<connection_timeout value='{*value:180,*type:int,*required:True}' __wk__ = '{*le:1}'/>
<max_connections value='{*value:10,*type:int,*required:True}' __wk__ = '{*le:1}'/>
<min_connections value='{*value:1,*type:int,*required:True}' __wk__ = '{*le:1}'/>
<reap_time value='{*value:180,*type:int,*required:True}' __wk__ = '{*le:1}'/>
<unused_timeout value='{*value:1800,*type:int,*required:True}' __wk__ = '{*le:1}'/>
<aged_timeout value='{*value:0,*type:int,*required:True}' __wk__ = '{*le:1}'/>
<purge_policy value='{*value:FailingConnectionOnly,*checkIn:(FailingConnectionOnly,EntirePool),*required:True}' __wk__ = '{*le:1}'/>
</connection_pool>
</qcf>
</qcfs>
<queues __wk__ = '{*le:1}'>
<queue name='{*required:True}' queue='{*required:True}' jndi_name='{*required:True}' target='{*value:MQ,*checkIn:(MQ,JMS),*required:True}' expiry='{*value:5000,*type:int}' channel='{*value:SYSTEM.SRV.CONN,*required:True}' queue_manager='' host='' port='{*type:int}' ccsid='{*value:1208,*type:int,*required:True}' desc='' __wk__='{*help:%lang/action.was.en/jmq.queue.help,*lhelp:%lang/action.was.en/jmq.queue.lhelp}'>
<activation_spec name='{*required:True}' jndi_name='{*required:True}' channel='{*value:SYSTEM.SRV.CONN,*required:True}' queue_manager='{*required:True}' host='{*required:True}' port='{*type:int,*required:True}' max_pool='{*value:1208,*type:int}' desc='' __wk__='{*help:%lang/action.was.en/jmq.activation_spec.help,*lhelp:%lang/action.was.en/jmq.activation_spec.lhelp}'/>
</queue>
</queues>
</jmq>
<!-- Copyright (c) 2008, Patrick Germain Placidoux -->
<!-- All rights reserved. -->
<!-- -->
<!-- This file is part of Kikonf Public Software. -->
<!-- -->
<!-- Kikonf Public Software is released under the modified BSD License, -->
<!-- which should accompany it or any part of it in the file "COPYING". -->
<!-- If you do not have this file you can access the license -->
<!-- through the WWW at http://www.kikonf.org/license/bsd/license.txt. -->
<!-- -->
<!-- Home page: http://www.kikonf.org -->
<!-- Contact: kikonf@gmx.com -->
<!-- ====================================================================== -->
<!-- -->
<!-- -->
<!-- -->
<!-- ====================================================================== -->
<!-- UPDATE | DATE | CODE | REASON -->
<!-- ====================================================================== -->
<!-- | | | -->
<!-- -->
<!-- -->
<!-- ====================================================================== -->
<jmq
type = '{\
*eq:action,\
*required:True,\
*display:False\
}'
bal = '{*display:False}'
sub_type = '{\
*value:configuration,\
*eq:configuration,\
*required:True,\
*deny:True,\
*display:False\
}'
softwares = "{
'*type':'dict',
'*dtype':
{
'was':
{
'*ge':'6.1',
'*le':'7.9',
'*required':True
}
},
'*deny':True,
'*display':False
}"
prefix='{*help:%lang/action.was.en/prefix.help,*lhelp:%lang/action.was.en/prefix.lhelp}'
__wk__='{\
*help:%lang/action.was.en/jmq.help,\
*lhelp:%lang/action.was.en/jmq.lhelp\
}'
>
<scope
cell = '{*value:false,*checkIn:(false,true),*required:True}'
node = ''
server = ''
cluster = ''
__wk__='{\
*eq:1,\
*help:%lang/action.was.en/scope.help,\
*lhelp:%lang/action.was.en/scope.lhelp\
}'
/>
<qcfs __wk__ = '{*le:1}'>
<qcf name='{*required:True}' jndi_name='{*required:True}' channel='{*value:SYSTEM.SRV.CONN,*required:True}' queue_manager='{*required:True}' host='{*required:True}' port='{*type:int,*required:True}' ccsid='{*value:1208,*type:int,*required:True}' xa='{*value:false,*checkIn:(false,true),*required:True}' transport_type='{*value:CLIENT,*checkIn:(DIRECTHTTP,BINDINGS,DIRECT,CLIENT),*required:True}' pollint='{*value:500,*type:int,*required:True}' desc='' __wk__='{*help:%lang/action.was.en/jmq.qcf.help,*lhelp:%lang/action.was.en/jmq.qcf.lhelp}'>
<connection_pool __wk__ = '{*le:1}'>
<connection_timeout value='{*value:180,*type:int,*required:True}' __wk__ = '{*le:1}'/>
<max_connections value='{*value:10,*type:int,*required:True}' __wk__ = '{*le:1}'/>
<min_connections value='{*value:1,*type:int,*required:True}' __wk__ = '{*le:1}'/>
<reap_time value='{*value:180,*type:int,*required:True}' __wk__ = '{*le:1}'/>
<unused_timeout value='{*value:1800,*type:int,*required:True}' __wk__ = '{*le:1}'/>
<aged_timeout value='{*value:0,*type:int,*required:True}' __wk__ = '{*le:1}'/>
<purge_policy value='{*value:FailingConnectionOnly,*checkIn:(FailingConnectionOnly,EntirePool),*required:True}' __wk__ = '{*le:1}'/>
</connection_pool>
</qcf>
</qcfs>
<queues __wk__ = '{*le:1}'>
<queue name='{*required:True}' queue='{*required:True}' jndi_name='{*required:True}' target='{*value:MQ,*checkIn:(MQ,JMS),*required:True}' expiry='{*value:5000,*type:int}' channel='{*value:SYSTEM.SRV.CONN,*required:True}' queue_manager='' host='' port='{*type:int}' ccsid='{*value:1208,*type:int,*required:True}' desc='' __wk__='{*help:%lang/action.was.en/jmq.queue.help,*lhelp:%lang/action.was.en/jmq.queue.lhelp}'>
<activation_spec name='{*required:True}' jndi_name='{*required:True}' channel='{*value:SYSTEM.SRV.CONN,*required:True}' queue_manager='{*required:True}' host='{*required:True}' port='{*type:int,*required:True}' max_pool='{*value:1208,*type:int}' desc='' __wk__='{*help:%lang/action.was.en/jmq.activation_spec.help,*lhelp:%lang/action.was.en/jmq.activation_spec.lhelp}'/>
</queue>
</queues>
</jmq>
(Source: <KIKONF_INSTALLATION_DIR>/plugins/actions/was/jmq/by/kikonf/ACT_INF/action.xml)
A descriptor file is a WYSISWYG xsd like schema, wich describes what are the supported
Tags, Attributes and Attributes values for one Action.
The special Attributes : type, sub_type, bal, softwares, __wk__ are reserved by Kikonf.
The table below summarizes the informations provided by the was.jmq Descriptor File :
/jmq>   Creates one or more Queue Connection Factory(ies), Queue(s) and Activation Spec(s)
/jmq/scope>   A scope refers to a Name Space where to create the resource
Required:True
Name
|
Default
|
Type
|
Required
|
Denied
|
Help
|
cell
|
false
|
(false, true)
|
True
|
 
|
 
|
node
|
 
|
str
|
 
|
 
|
 
|
server
|
 
|
str
|
 
|
 
|
 
|
cluster
|
 
|
str
|
 
|
 
|
 
|
/jmq/qcfs>  
/jmq/qcfs/qcf>   Creates a Queue Connection Factory
Name
|
Default
|
Type
|
Required
|
Denied
|
Help
|
name
|
 
|
 
|
True
|
 
|
 
|
jndi_name
|
 
|
 
|
True
|
 
|
 
|
channel
|
SYSTEM.SRV.CONN
|
 
|
True
|
 
|
 
|
queue_manager
|
 
|
 
|
True
|
 
|
 
|
host
|
 
|
 
|
True
|
 
|
 
|
port
|
 
|
int
|
True
|
 
|
 
|
ccsid
|
1208
|
int
|
True
|
 
|
 
|
xa
|
false
|
(false, true)
|
True
|
 
|
 
|
transport_type
|
CLIENT
|
(DIRECTHTTP, BINDINGS, DIRECT, CLIENT)
|
True
|
 
|
 
|
pollint
|
500
|
int
|
True
|
 
|
 
|
desc
|
 
|
str
|
 
|
 
|
 
|
/jmq/qcfs/qcf/connection_pool>  
/jmq/qcfs/qcf/connection_pool/connection_timeout>  
Name
|
Default
|
Type
|
Required
|
Denied
|
Help
|
value
|
180
|
int
|
True
|
 
|
 
|
/jmq/qcfs/qcf/connection_pool/max_connections>  
Name
|
Default
|
Type
|
Required
|
Denied
|
Help
|
value
|
10
|
int
|
True
|
 
|
 
|
/jmq/qcfs/qcf/connection_pool/min_connections>  
Name
|
Default
|
Type
|
Required
|
Denied
|
Help
|
value
|
1
|
int
|
True
|
 
|
 
|
/jmq/qcfs/qcf/connection_pool/reap_time>  
Name
|
Default
|
Type
|
Required
|
Denied
|
Help
|
value
|
180
|
int
|
True
|
 
|
 
|
/jmq/qcfs/qcf/connection_pool/unused_timeout>  
Name
|
Default
|
Type
|
Required
|
Denied
|
Help
|
value
|
1800
|
int
|
True
|
 
|
 
|
/jmq/qcfs/qcf/connection_pool/aged_timeout>  
Name
|
Default
|
Type
|
Required
|
Denied
|
Help
|
value
|
0
|
int
|
True
|
 
|
 
|
/jmq/qcfs/qcf/connection_pool/purge_policy>  
Name
|
Default
|
Type
|
Required
|
Denied
|
Help
|
value
|
FailingConnectionOnly
|
(FailingConnectionOnly, EntirePool)
|
True
|
 
|
 
|
/jmq/queues>  
/jmq/queues/queue>   Creates a Queue
Name
|
Default
|
Type
|
Required
|
Denied
|
Help
|
name
|
 
|
 
|
True
|
 
|
 
|
queue
|
 
|
 
|
True
|
 
|
 
|
jndi_name
|
 
|
 
|
True
|
 
|
 
|
target
|
MQ
|
(MQ, JMS)
|
True
|
 
|
 
|
expiry
|
5000
|
int
|
 
|
 
|
 
|
channel
|
SYSTEM.SRV.CONN
|
 
|
True
|
 
|
 
|
queue_manager
|
 
|
str
|
 
|
 
|
 
|
host
|
 
|
str
|
 
|
 
|
 
|
port
|
 
|
int
|
 
|
 
|
 
|
ccsid
|
1208
|
int
|
True
|
 
|
 
|
desc
|
 
|
str
|
 
|
 
|
 
|
/jmq/queues/queue/activation_spec>   Creates an Activation Specification
Name
|
Default
|
Type
|
Required
|
Denied
|
Help
|
name
|
 
|
 
|
True
|
 
|
 
|
jndi_name
|
 
|
 
|
True
|
 
|
 
|
channel
|
SYSTEM.SRV.CONN
|
 
|
True
|
 
|
 
|
queue_manager
|
 
|
 
|
True
|
 
|
 
|
host
|
 
|
 
|
True
|
 
|
 
|
port
|
 
|
int
|
True
|
 
|
 
|
max_pool
|
1208
|
int
|
 
|
 
|
 
|
desc
|
 
|
str
|
 
|
 
|
 
|
Trademarks :
- "IBM WebSphere MQ" and "WebSphere MQ" are registred trademarks of International Business Machines Corporation.
- "IBM", "WebSphere", "WebSphere Aplication Server", "WAS" are registred trademarks of International Business Machines Corporation.
- "Java" and "JVM" are a registred trademarks of Oracle and/or its affiliates.
- Other names may be trademarks of their respective owners.
|