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