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







Ra

print

Action : was.ra   (Category : was, Name : ra, By : kikonf)
Complete Name : was.ra.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 ra plugin : Configure a Resource Adaptor

The following shows the Descriptor File for the Action : was.ra

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                         -->
<!-- ====================================================================== -->
<!--            |              |          |                                 -->
<!--                                                                        -->
<!--                                                                        -->
<!-- ====================================================================== -->



<ra
    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
    }"

    name='{*required:True}'
    ra_force='{\
        *value:false,\
        *checkIn:(false,true),\
        *required:True,\
        *type:str,\
        *help:%lang/action.was.en/ra.ra_force.help,\
    }'
    ra_type='{\
        *value:cics,\
        *checkIn:(cics,ims,sib),\
        *required:True,\
    }'
    ra_path='{\
        *type:str,\
        *help:%lang/action.was.en/ra.ra_path.help,\
        *lhelp:%lang/action.was.en/ra.ra_path.lhelp\
    }'
    ra_archive_path='{\
        *type:str,\
        *help:%lang/action.was.en/ra.ra_archive_path.help,\
        *lhelp:%lang/action.was.en/ra.ra_archive_path.lhelp\
    }'
    prefix='{*help:%lang/action.was.en/prefix.help}'
    desc=''
    __wk__='{\
        *help:%lang/action.was.en/ra.help,\
        *lhelp:%lang/action.was.en/ra.lhelp\
    }'
    >
    
    <scope 
        node = '{*required:True}'
        server = '{*required:True}'
        __wk__='{\
            *eq:1,\
            *help:%lang/action.was.en/scope.help,\
            *lhelp:%lang/action.was.en/scope.lhelp\
        }'
    />
    
    <jcfs __wk__ = '{*eq:1}'>
        <jcf
            name='{*required:True}'  
            jndi_name='{*required:True}' 
            factory_interface='{*required:True,*type:str,*help:%lang/action.was.en/ra.jcfs.jcf.factory_interface.help}' 
            desc=''
            __wk__='{\
                *help:%lang/action.was.en/ra.jcfs.jcf.help,\
            }'
            >
            
            <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>  
            
            <properties __wk__ = '{*le:1}'>
                <property name='{*required:True}' value='{*required:True}'/>
            </properties>
        </jcf>
    </jcfs>
        
</ra>
							
(Source: <KIKONF_INSTALLATION_DIR>/plugins/actions/was/ra/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.ra Descriptor File :

/ra>   Configure a Resource Adaptor
Name Default Type Required Denied Help
name     True    
ra_force false (false, true) True   Force the installation of a guiven rar file
ra_type cics (cics, ims, sib) True    
ra_path   str     Set the rar file's path
ra_archive_path   str     Set the Archive path
prefix         Using prefix for configuration resource names is a generic way to define them
desc   str      

/ra/scope>   A scope refers to a Name Space where to create the resource
Required:True
Name Default Type Required Denied Help
node     True    
server     True    

/ra/jcfs>  
Required:True

/ra/jcfs/jcf>   Creates a Connection factory
Name Default Type Required Denied Help
name     True    
jndi_name     True    
factory_interface   str True   Set the Connection factory Interface
desc   str      

/ra/jcfs/jcf/connection_pool>  

/ra/jcfs/jcf/connection_pool/connection_timeout>  
Name Default Type Required Denied Help
value 180 int True    

/ra/jcfs/jcf/connection_pool/max_connections>  
Name Default Type Required Denied Help
value 10 int True    

/ra/jcfs/jcf/connection_pool/min_connections>  
Name Default Type Required Denied Help
value 1 int True    

/ra/jcfs/jcf/connection_pool/reap_time>  
Name Default Type Required Denied Help
value 180 int True    

/ra/jcfs/jcf/connection_pool/unused_timeout>  
Name Default Type Required Denied Help
value 1800 int True    

/ra/jcfs/jcf/connection_pool/aged_timeout>  
Name Default Type Required Denied Help
value 0 int True    

/ra/jcfs/jcf/connection_pool/purge_policy>  
Name Default Type Required Denied Help
value FailingConnectionOnly (FailingConnectionOnly, EntirePool) True    

/ra/jcfs/jcf/properties>  

/ra/jcfs/jcf/properties/property>  
Name Default Type Required Denied Help
name     True    
value     True    



Trademarks :
  • "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