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