cle_clock
Home > wikikonf >  was/actions/by kikonf > jmq







Jmq

print

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>
							
(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)
Name Default Type Required Denied Help
prefix         Using prefix for configuration resource names is a generic way to define them

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

Copyright © 2011 - Patrick Placidoux, Hélène Malamoud