cle_clock
Home > wikikonf >  wmq/actions/by kikonf > mqm







Mqm

print

Action : wmq.mqm   (Category : wmq, Name : mqm, By : kikonf)
Complete Name : wmq.mqm.by.kikonf
Version : 5.0        License : Modified BSD License

Purpose of the wmq category :
Easy to customize. This category use in background the runmqsc command to create and configure :
Qmanagers, Qlocals, Qremotes, Clusters, Channels, Triggers, Processes, XMITQs, Listeners or SSL for WebSphere MQ ®.
You can use it to manage the whole IBM WebSphere MQ ® architecture.

Purpose of this mqm plugin : Configures a QManager

The following shows the Descriptor File for the Action : wmq.mqm

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


<!-- Note concerning Ssl                                                                                                                -->
<!-- -------------------                                                                                                                -->
<!-- MQ Ssl configuration applies to channels.                                                                                          -->
<!-- SSLCIPH : is required when establishing Ssl on a channel.                                                                          -->
<!-- If you have to configure Ssl communication between MQ and JAVA (@) (for instance WebSphere (@))                                    -->
<!-- be aware to respect SSLCIPH compatibility.                                                                                         -->
<!-- Here is the equivalence table:                                                                                                     -->
<!-- This information is extracted from the following links:                                                                            -->
<!-- http://www.ibm.com/developerworks/websphere/techjournal/0601_smithson/0601_smithson.html                                           -->
<!-- http://www.ibm.com/developerworks/websphere/tutorials/0908_muragod/section8.html                                                   -->
<!--                                                                                                                                    -->
<!-- Ciphersuite (MQ) 	    Cihperspec (Java)                                                                                           -->
<!-- RC4_MD5_US 	        SSL_RSA_WITH_RC4_128_MD5                                                                                    -->
<!-- RC4_SHA_US 	        SSL_RSA_WITH_RC4_128_SHA                                                                                    -->
<!-- RC4_MD5_EXPORT 	    SSL_RSA_EXPORT_WITH_RC4_40_MD5                                                                              -->
<!-- RC2_MD5_EXPORT 	    SSL_RSA_EXPORT_WITH_RC2_CBC_40_MD5                                                                          -->
<!-- DES_SHA_EXPORT 	    SSL_RSA_WITH_DES_CBC_SHA                                                                                    -->
<!-- NULL_MD5 	            SSL_RSA_WITH_NULL_MD5                                                                                       -->
<!-- NULL_SHA 	            SSL_RSA_WITH_NULL_SHA                                                                                       -->
<!-- RC4_56_SHA_EXPORT1024 	SSL_RSA_EXPORT1024_WITH_RC4_56_SHA                                                                          -->
<!-- DES_SHA_EXPORT1024 	SSL_RSA_EXPORT1024_WITH_DES_CBC_SHA                                                                         -->
<!-- TRIPLE_DES_SHA_US 	    SSL_RSA_WITH_3DES_EDE_CBC_SHA                                                                               -->
<!--                                                                                                                                    -->
<!--                                                                                                                                    -->
<!-- SSLPEER : is optional.                                                                                                             -->
<!-- Its value is compared with incoming dns.                                                                                           -->                                                                                                                                    -->
<!-- They are rules specifying SSLPEER value.                                                                                           -->
<!-- for more information about them please consult the IBM guide entitled "WebSphere MQ rules for SSLPEER values".                     -->
<!--                                                                                                                                    -->
<!--                                                                                                                                    -->
<!-- TradeMarks (@)                                                                                                                         -->
<!-- --------------                                                                                                                         -->
<!-- WebSphere is a trademark of International Business Machines Corporation.                                                           -->
<!-- Java and all Java-based marks are trademarks or registred trademarks of Sun Microsystems, Inc. in                                  -->
<!-- the United States and other countries.                                                                                             -->
<!-- Other company, product and service names may be trademarks or service marks of others.                                             -->

<!-- Defining : -->
<!--  -->
<!--    Queue Local -->
<!--     Queue Remote -->
<!--     Queue Alias -->
<!--  -->
<!--     Queue Trigger--> /3
<!--  -->
<!--     Cluster --> /1
<!--  -->
<!--     SsL --> /2
<!--  -->
<!--     BlockIp2 /4 --> 
<!--  -->
<!--     Listner -->
<!--  -->
<!--     Channel -->


<mqm
    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':
            {
                'wmq':
                {
                    '*ge':'6.0.2',
                    '*required':True
                }
            },
        '*deny':True, 
        '*display':False
    }"

    force = '{\
        *value:true,\
        *checkIn:(false,true),\
        *required:True,\
        *help:%lang/action.wmq.en/mqm.force.help,\
		*lhelp:%lang/action.wmq.en/mqm.force.lhelp,\
    }'    
    name='{*required:True,*help:%lang/action.wmq.en/mqm.name.help,}'
    __wk__='{\
        *help:%lang/action.wmq.en/mqm.help,\
        *lhelp:%lang/action.wmq.en/mqm.lhelp,\
    }'
    >

    <listeners
	    __wk__='{\
	        *le:1,\
	    }'
    >
        <listener 
	        name='{*required:True,*help:%lang/action.wmq.en/mqm.listeners.listener.name.help,}' 
	        host='{*value:localhost,*required:True,*help:%lang/action.wmq.en/mqm.listeners.listener.host.help,}' 
	        port='{*type:int,*help:%lang/action.wmq.en/mqm.listeners.listener.port.help,}' 
	        dfn='{*value:false,*checkIn:(false,true),*help:%lang/action.wmq.en/mqm.listeners.listener.dfn.help,*lhelp:%lang/action.wmq.en/mqm.listeners.listener.dfn.lhelp,}'  
	        desc='{*value:Generated by kikonf.,*help:%lang/action.wmq.en/mqm.listeners.listener.desc.help,}'
		    __wk__='{\
		        *help:%lang/action.wmq.en/mqm.listeners.listener.help,\
		        *lhelp:%lang/action.wmq.en/mqm.listeners.listener.lhelp,\
		    }'
        />
    </listeners>


    <channels
	    __wk__='{\
	        *le:1,\
	    }'
    >
        <channel 
        	name='{*required:True,*help:%lang/action.wmq.en/mqm.channels.channel.name.help,}'  
            type='{*required:True,*checkIn:(\
                SVRCONN,\
                CLNTCONN,\
                RCVR,\
                SDR,\
                CLUSRCVR,\
                CLUSSDR,\
            	)\
            	,*help:%lang/action.wmq.en/mqm.channels.channel.type.help,\
        		*lhelp:%lang/action.wmq.en/mqm.channels.channel.type.lhelp,\
			}'
            host='{*help:%lang/action.wmq.en/mqm.channels.channel.host.help,}'
            port='{*type:int,*help:%lang/action.wmq.en/mqm.channels.channel.port.help,}'
            do_ssl='{*value:false,*checkIn:(true,false),*required:True,*help:%lang/action.wmq.en/mqm.channels.channel.do_ssl.help,}'
            sslciph='{*value:TRIPLE_DES_SHA_US,*checkIn:(\
                RC4_MD5_US,\
                RC4_SHA_US,\
                RC4_MD5_EXPORT,\
                RC2_MD5_EXPORT,\
                DES_SHA_EXPORT,\
                NULL_MD5,\
                NULL_SHA,\
                RC4_56_SHA_EXPORT1024,\
                DES_SHA_EXPORT1024,\
                TRIPLE_DES_SHA_US,\
            	),*required:True,\
				*help:%lang/action.wmq.en/mqm.channels.channel.sslciph.help,\
				*lhelp:%lang/action.wmq.en/mqm.channels.channel.sslciph.lhelp,\
            }'
            sslpeer='{*help:%lang/action.wmq.en/mqm.channels.channel.sslpeer.help,}' 
            cluster='{*help:%lang/action.wmq.en/mqm.cluster.help,*lhelp:%lang/action.wmq.en/mqm.cluster.lhelp,}'
            scydata='{*help:%lang/action.wmq.en/mqm.channels.channel.scydata.help,}'
            scyexit='{*help:%lang/action.wmq.en/mqm.channels.channel.scyexit.help,}'
            desc='{*value:Generated by kikonf.,*help:%lang/action.wmq.en/mqm.channels.channel.desc.help,}'
		    __wk__='{\
		        *help:%lang/action.wmq.en/mqm.channels.channel.help,\
		        *lhelp:%lang/action.wmq.en/mqm.channels.channel.lhelp,\
		    }'
        />
    </channels>

    <queues
	    __wk__='{\
	        *le:1,\
	    }'
    >
        <local 
        	name='{*required:True,*help:%lang/action.wmq.en/mqm.queues.local.name.help,}' 
        	max_depth='{*value:2000,*type:int,*required:True,*help:%lang/action.wmq.en/mqm.queues.local.max_depth.help,}' 
        	usage='{*value:NORMAL,*checkIn:(NORMAL,XMITQ),*required:True,*help:%lang/action.wmq.en/mqm.queues.local.usage.lhelp,*lhelp:%lang/action.wmq.en/mqm.queues.local.usage.lhelp,}' 
        	get='{*value:ENABLED,*checkIn:(ENABLED,DISABLED),*required:True,*help:%lang/action.wmq.en/mqm.queues.local.get.help,*lhelp:%lang/action.wmq.en/mqm.queues.local.get.lhelp,}' 
        	put='{*value:ENABLED,*checkIn:(ENABLED,DISABLED),*required:True,*help:%lang/action.wmq.en/mqm.queues.local.put.help,*lhelp:%lang/action.wmq.en/mqm.queues.local.put.lhelp,}' 
        	priority='{*value:0,*type:int,*required:True,*help:%lang/action.wmq.en/mqm.queues.local.priority.help,}' 
        	cluster='{*help:%lang/action.wmq.en/mqm.cluster.help,*lhelp:%lang/action.wmq.en/mqm.cluster.lhelp,}'
        	desc='{*value:Generated by kikonf.,*help:%lang/action.wmq.en/mqm.queues.local.desc.help,}'
		    __wk__='{\
		        *help:%lang/action.wmq.en/mqm.queues.local.help,\
		    }'
        >
            <trigger 
            	type='{*value:FIRST,*checkIn:(FIRST,EVERY,DEPTH),*required:True,*help:%lang/action.wmq.en/mqm.queues.local.trigger.type.help,}' 
            	trigdata='{*help:%lang/action.wmq.en/mqm.queues.local.trigger.trigdata.help,*lhelp:%lang/action.wmq.en/mqm.queues.local.trigger.trigdata.lhelp,}'
            	userdata='{*help:%lang/action.wmq.en/mqm.queues.local.trigger.userdata.help,*lhelp:%lang/action.wmq.en/mqm.queues.local.trigger.userdata.lhelp,}'
            	initq='{*value:SYSTEM.CHANNEL.INITQ,*required:True,*help:%lang/action.wmq.en/mqm.queues.local.trigger.initq.help,*lhelp:%lang/action.wmq.en/mqm.queues.local.trigger.initq.lhelp,}' 
            	process='{*help:%lang/action.wmq.en/mqm.queues.local.trigger.process.help,*lhelp:%lang/action.wmq.en/mqm.queues.local.trigger.process.lhelp,}'
			    __wk__='{\
			        *le:1,\
			        *help:%lang/action.wmq.en/mqm.queues.local.trigger.help,\
        			*lhelp:%lang/action.wmq.en/mqm.queues.local.trigger.lhelp,\
			    }'
            />
        </local>

        <remote 
	        name='{*required:True,*help:%lang/action.wmq.en/mqm.queues.remote.name.help,}' 
	        rqmname='{*help:%lang/action.wmq.en/mqm.queues.remote.rqmname.help,}'
	        rname='{*help:%lang/action.wmq.en/mqm.queues.remote.rname.help,}'
	        host='{*value:localhost,*help:%lang/action.wmq.en/mqm.queues.remote.host.help,}' 
	        port='{*type:int,*help:%lang/action.wmq.en/mqm.queues.remote.port.help,}' 
	        put='{*value:ENABLED,*checkIn:(ENABLED,DISABLED),*required:True,*help:%lang/action.wmq.en/mqm.queues.remote.put.help,}' 
	        cluster='{*help:%lang/action.wmq.en/mqm.cluster.help,*lhelp:%lang/action.wmq.en/mqm.cluster.lhelp,}'
	        clusnl='{*help:%lang/action.wmq.en/mqm.queues.remote.clusnl.help,}'
	        desc='{*value:Generated by kikonf.,*help:%lang/action.wmq.en/mqm.queues.remote.desc.help,}' 
	        xmitq='{*help:%lang/action.wmq.en/mqm.queues.remote.xmitq.help,}'
	        channel_sdr='{*help:%lang/action.wmq.en/mqm.queues.remote.channel_sdr.help,}'
	        channel_rcvr='{*help:%lang/action.wmq.en/mqm.queues.remote.channel_rcvr.help,}'
		    __wk__='{\
		        *help:%lang/action.wmq.en/mqm.queues.remote.help,\
		    }'
        /> 

        <alias 
	        name='{*required:True,*help:%lang/action.wmq.en/mqm.queues.alias.name.help,}' 
	        queue='{*required:True,*help:%lang/action.wmq.en/mqm.queues.alias.queue.help,}'
		    __wk__='{\
		        *help:%lang/action.wmq.en/mqm.queues.alias.help,\
		    }'
        />
    </queues>

    <processes
	    __wk__='{\
	        *le:1,\
	    }'
    >
        <process 
        	name='{*required:True,*help:%lang/action.wmq.en/mqm.processes.process.name.help,}' 
        	type='{*value:UNIX,*checkIn:(UNIX,CICS,WINDOWSNT),*required:True,*help:%lang/action.wmq.en/mqm.processes.process.type.help,*lhelp:%lang/action.wmq.en/mqm.processes.process.type.lhelp,}' 
        	exec_path='{*required:True,*help:%lang/action.wmq.en/mqm.processes.process.exec_path.help,}' 
        	userdata='{*help:%lang/action.wmq.en/mqm.processes.process.userdata.help,*lhelp:%lang/action.wmq.en/mqm.processes.process.userdata.lhelp,}'
        	desc='{*value:Generated by kikonf.,*help:%lang/action.wmq.en/mqm.processes.process.desc.help,}'
		    __wk__='{\
		        *help:%lang/action.wmq.en/mqm.processes.process.help,\
		        *lhelp:%lang/action.wmq.en/mqm.processes.process.lhelp,\
		    }'
		/>
    </processes>
    
    <clusters
	    __wk__='{\
	        *le:1,\
	    }'
    >

        <!-- This turns this QManager as a member of the specified clusters.                                                                        -->
        <!-- If the attribute full_repos from tag:cluster is true, this QManager becomes a full repository for this cluster.                        -->
        <!-- Afterward channels or queues are allowed to use either:                                                                                -->
        <!--    cluster=CLS1 to advertise to one them                                                                                               -->
        <!--    or                                                                                                                                  -->
        <!--    cluster='*' (also called artefact *) to advertise to all of them                                                                                              -->
        <!--    This works because confmqm also defines an mq object NAMELIST named: "CLUSTERS" for the whole clusters.                             -->
        <!--    or                                                                                                                                  -->
        <!--    cluster='$' (also called artefact $) to advertise to all clusters for wich this QManager is a full repository.                      -->
        <!--    This works because confmqm also defines an mq object NAMELIST named: "CLS1_CLS4" for the clusters                                   -->
        <!--    for wich this QManager is a full repository.                                                                                        -->
        <!--    or                                                                                                                                  -->
        <!--    cluster='CLS1,CLS2,CLS3' to advertise three of these 3 clusters covered by the QManager.                                            -->
        <!--    This works because confmqm wiil defined a specific name list CLS1_CLS2_CLS3 to match this.                                          -->        
        <!--                                                                                                                                        -->
        <!-- Example:                                                                                                                               -->
        <!--                                                                                                                                        -->        
        <!--    <clusters>                                                                                                                          -->
        <!--        <cluster name='CLS1' full_repos='true}'>                                                                                        -->
        <!--        <cluster name='CLS2'>                                                                                                           -->
        <!--        <cluster name='CLS3' full_repos='true}'>                                                                                        -->
        <!--        <cluster name='CLS4'>                                                                                                           -->
        <!--    </clusters>                                                                                                                         -->
        <!--                                                                                                                                        -->
        <!-- Note:                                                                                                                                  -->
        <!-- The channels CLUSSDR and CLUSRCVR defined under the cluster/channel tag                                                          -->
        <!-- must also be defined into the root confmqm/channels tag and their cluster attribute must also be defined                               -->
        <!-- to the proper cluster (s).                                                                                                             -->
        <!--                                                                                                                                        -->
        <!-- Afterward one can use these commands :                                                                                                 -->
        <!--                                                                                                                                        -->
        <!-- dis clusqmgr(*) : to display the cluster informations for this QManager under runmqsc                                                  -->
        <!-- And those two, to test the cluster                                                                                                     -->
        <!--    amqsput  LQ1_1 QM1                                                                                                                  -->
        <!--    amqsput  LQ1_1 QM2                                                                                                                  -->

        <cluster 
	        name='{*required:True,*help:%lang/action.wmq.en/mqm.clusters.cluster.name.help,*lhelp:%lang/action.wmq.en/mqm.clusters.cluster.name.lhelp,}' 
	        full_repos='{*value:false,*checkIn:(true,false),*required:True,*help:%lang/action.wmq.en/mqm.clusters.cluster.full_repos.help,*lhelp:%lang/action.wmq.en/mqm.clusters.cluster.full_repos.lhelp,}'
		    __wk__='{\
		        *help:%lang/action.wmq.en/mqm.clusters.cluster.help,\
		        *lhelp:%lang/action.wmq.en/mqm.clusters.cluster.lhelp,\
		    }'
        >
            <channels
			    __wk__='{\
			        *le:1,\
			        *help:%lang/action.wmq.en/mqm.clusters.cluster.channels.help,\
			        *lhelp:%lang/action.wmq.en/mqm.clusters.cluster.channels.lhelp,\
			    }'
            >
                <CLUSSDR 
                	name='{*required:True,*help:%lang/action.wmq.en/mqm.clusters.cluster.channels.CLUSSDR.help,}'
				    __wk__='{\
				        *le:1,\
				        *help:%lang/action.wmq.en/mqm.clusters.cluster.channels.CLUSSDR.help,\
					    }'
                />
                <CLUSRCVR 
                	name='{*required:True,*help:%lang/action.wmq.en/mqm.clusters.cluster.channels.CLUSRCVR.help,}'
				    __wk__='{\
				        *le:1,\
				        *help:%lang/action.wmq.en/mqm.clusters.cluster.channels.CLUSRCVR.help,\
				    }'
                />
            </channels>
        </cluster>
    </clusters>

    
    <ssl 
	    repos_dir='{*required:True,*help:%lang/action.wmq.en/mqm.ssl.repos_dir.help,}' 
	    expire='{*value:3650,*type:int,*required:True,*help:%lang/action.wmq.en/mqm.ssl.expire.help,*lhelp:%lang/action.wmq.en/mqm.ssl.expire.lhelp,}',
	    password='{*value:yourpass,*required:True,*help:%lang/action.wmq.en/mqm.ssl.password.help,}'
	    __wk__='{\
	        *le:1,\
	        *help:%lang/action.wmq.en/mqm.ssl.help,\
	        *lhelp:%lang/action.wmq.en/mqm.ssl.lhelp,\
	    }'
    >
        <!-- This will generate a Ssl key store file named: THIS_QMR_NAME.kdb                                                                   -->
        <!-- and eventually one Ssl key store file named: wmqca.kdb in repos_dir, if do_self_sign_cert=true.                                    -->
        <!-- A Certificate is automatically added into THIS_QMR_NAME.kdb.                                                                       -->
        <!-- The origine of the Certificate depends on these conditions :                                                                       -->
        <!-- If do_self_sign_cert=true:                                                                                                         -->
        <!--     The Certificate to add is generated/extracted (and named by attribute "file" from tag:cert in repos_dir)                       --> 
        <!--     from the self sign keystore wmqca.kdb.                                                                                         -->
        <!-- If do_self_sign_cert=false:                                                                                                        -->
        <!--     The attributes path from tag:cert must be guiven (except the following conditions).                                            -->
        <!--     And the Certificate to add is retreived from this path.                                                                        -->
        <!-- If do_self_sign_cert=false and the attributes path from tag:cert is not guiven                                                     -->
        <!--    If a file named by attribute file from tag:cert exists in repos_dir.                                                            -->
        <!--        The Certificate to add is retreived from this file.                                                                         -->
        <!--    If a file named by attribute file from tag:cert do not exists in repos_dir but a Ssl key store file named: wmqca.kdb exists.    -->
        <!--        The Certificate to add is generated/extracted (and named by attribute file from tag:cert in repos_dir)                      -->
        <!--     from the self sign keystore wmqca.kdb.                                                                                         -->
        <!--                                                                                                                                    -->
        <!-- In any cases the informations from tag:cert attributes label and format are retreived to generate/add the Certificate.             -->
        <!--                                                                                                                                    -->
        <!-- The simplest way to specify Ssl, generating a self certificate for test purpose, is likewise:                                      -->
        <!-- <ssl repos_dir='{*required:True}'>                                                                                                 -->
        <!--     <selfcert/>                                                                                                                    -->
        <!-- </ssl>                                                                                                                             -->
        <!--                                                                                                                                    -->
        <!-- Note:                                                                                                                              -->
        <!-- -----                                                                                                                              -->
        <!-- To validate the use of Ssl on your channels you still need to set the attribute do_ssl to true.                                    -->

        <!-- If this tag is present the Certificate named cert/@file into the directory ssl/@repos_dir is received into the keystore. -->
        <cert
            label='{*value:mycert,*required:True,*help:%lang/action.wmq.en/mqm.ssl.cert.label.help,}'
            file='{*value:mycert.cert,*required:True,*help:%lang/action.wmq.en/mqm.ssl.cert.file.help,}'
            format='{*value:512,*checkIn:(512,10234,2048),*type:int,*required:True,*help:%lang/action.wmq.en/mqm.ssl.cert.format.help,*lhelp:%lang/action.wmq.en/mqm.ssl.cert.format.lhelp,}'
            __wk__='{\
                *le:1,\
                *help:%lang/action.wmq.en/mqm.ssl.cert.help,\
                *lhelp:%lang/action.wmq.en/mqm.ssl.cert.lhelp,\
            }'
        />

        <!-- If this tag is present a Self Sign Certificate is generated and extracted. -->
        <!-- All Attributes here, have default values so you can ignore them all. -->        
        <selfcert 
            format='{*value:512,*checkIn:(512,10234,2048),*type:int,*required:True,*help:%lang/action.wmq.en/mqm.ssl.selfcert.format.help,*lhelp:%lang/action.wmq.en/mqm.ssl.selfcert.format.lhelp,}'
            dn="{'*value': 'CN=myuser,O=mycompany,OU=myunit,OU=test,C=US', '*required': True,'*help': '%lang/action.wmq.en/mqm.ssl.selfcert.dn.help','*lhelp': '%lang/action.wmq.en/mqm.ssl.selfcert.dn.lhelp',}" 
            cert_size='{*value:512,*checkIn:(512,10234,2048),*type:int,*required:True,*help:%lang/action.wmq.en/mqm.ssl.selfcert.cert_size.help,*lhelp:%lang/action.wmq.en/mqm.ssl.selfcert.cert_size.lhelp,}'
            cert_expire='{*value:3650,*required:True,*help:%lang/action.wmq.en/mqm.ssl.selfcert.cert_expire.help,*lhelp:%lang/action.wmq.en/mqm.ssl.selfcert.cert_expire.lhelp,}'
            cert_sigalg='{*value:sha1,*checkIn:(md5,sha1,sha224,sha256,sha384,sha512),*required:True,*help:%lang/action.wmq.en/mqm.ssl.selfcert.cert_sigalg.help,*lhelp:%lang/action.wmq.en/mqm.ssl.selfcert.cert_sigalg.lhelp,}'
            __wk__='{\
                *le:1,\
                *help:%lang/action.wmq.en/mqm.ssl.selfcert.help,\
            }'
        />
    </ssl>
    
</mqm>
							
(Source: <KIKONF_INSTALLATION_DIR>/plugins/actions/wmq/mqm/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 wmq.mqm Descriptor File :

/mqm>   Configures a QManager
Name Default Type Required Denied Help
force true (false, true) True   Do force ?
name     True   The QManager name

/mqm/listeners>  

/mqm/listeners/listener>   Configures a Listener
Name Default Type Required Denied Help
name     True   The Listener name.
host localhost   True   The Listener host.
port   int     The Listener port.
dfn false (false, true)     Do create definition ?
desc Generated by kikonf.       Description

/mqm/channels>  

/mqm/channels/channel>   Configures a Channel
Name Default Type Required Denied Help
name     True   The Channel name
type   (SVRCONN, CLNTCONN, RCVR, SDR, CLUSRCVR, CLUSSDR) True   The Channel type
host         The Channel host if relevant
port   int     The Channel port if relevant
do_ssl false (true, false) True   Do force SSL ?
sslciph TRIPLE_DES_SHA_US (RC4_MD5_US, RC4_SHA_US, RC4_MD5_EXPORT, RC2_MD5_EXPORT, DES_SHA_EXPORT, NULL_MD5, NULL_SHA, RC4_56_SHA_EXPORT1024, DES_SHA_EXPORT1024, TRIPLE_DES_SHA_US) True   SSL Cipher
sslpeer         SSL Peer
cluster         Cluster
scydata         Scydatat if relevant
scyexit         Scyexitt if relevant
desc Generated by kikonf.       Description

/mqm/queues>  

/mqm/queues/local>   Configures a QLocal
Name Default Type Required Denied Help
name     True   The QLocal name
max_depth 2000 int True   The QLocal depth
usage NORMAL (NORMAL, XMITQ) True   The QLocal usage. (Default NORMAL). Allowed values are : NORMAL or XMITQ.
get ENABLED (ENABLED, DISABLED) True   Do allow get ?
put ENABLED (ENABLED, DISABLED) True   Do allow put ?
priority 0 int True   The QLocal priority
cluster         Cluster
desc Generated by kikonf.       Description

/mqm/queues/local/trigger>   Configures a trigger on this QLocal
Name Default Type Required Denied Help
type FIRST (FIRST, EVERY, DEPTH) True   Trigger type
trigdata         Trigdata
userdata         Userdata
initq SYSTEM.CHANNEL.INITQ   True   Initq
process         Process name

/mqm/queues/remote>   Configures a QRemote
Name Default Type Required Denied Help
name     True   The QRemote name
rqmname         The remote QManager's name
rname         The remote local Queue's name
host localhost       The QRemote host
port   int     The QRemote port
put ENABLED (ENABLED, DISABLED) True   Do allow put ?
cluster         Cluster
clusnl         Cluster name list
desc Generated by kikonf.       Description
xmitq         Transmission Queue name
channel_sdr         Alternative channel sender name
channel_rcvr         Alternative receiver name

/mqm/queues/alias>   Configures a QaLias
Name Default Type Required Denied Help
name     True   Alias name
queue     True   Queue name

/mqm/processes>  

/mqm/processes/process>   Configures a process
Name Default Type Required Denied Help
name     True   The process name
type UNIX (UNIX, CICS, WINDOWSNT) True   The process type
exec_path     True   The process path.
userdata         Userdata
desc Generated by kikonf.       Description

/mqm/clusters>  

/mqm/clusters/cluster>   Configures a Cluster
Name Default Type Required Denied Help
name     True   The cluster name
full_repos false (true, false) True   Is full repository ?

/mqm/clusters/cluster/channels>   Configures CLUSSDR and CLUSRCVR Channel's names

/mqm/clusters/cluster/channels/CLUSSDR>   The CLUSSDR's name
Name Default Type Required Denied Help
name     True   The CLUSSDR's name

/mqm/clusters/cluster/channels/CLUSRCVR>   The CLUSRCVR's name
Name Default Type Required Denied Help
name     True   The CLUSRCVR's name

/mqm/ssl>   Configure SSL for this QManager
Name Default Type Required Denied Help
repos_dir     True   The repository directory
expire 3650 int True   The Keystore expire interval
password yourpass   True   The Keystore password

/mqm/ssl/cert>   Receive this certifcate into the keystore
Name Default Type Required Denied Help
label mycert   True   The label for this Certificate into the cluster
file mycert.cert   True   The file name for the Certificate
format 512 (512, 10234, 2048) True   The certificate SSL format

/mqm/ssl/selfcert>   Configures a Self Certicate into the Keystore
Name Default Type Required Denied Help
format 512 (512, 10234, 2048) True   The Self Certificate SSL format
dn CN=myuser,O=mycompany,OU=myunit,OU=test,C=US   True   The Self Certificate dn
cert_size 512 (512, 10234, 2048) True   The Self Certificate SSL size
cert_expire 3650   True   The Self Certificate expie interval
cert_sigalg sha1 (md5, sha1, sha224, sha256, sha384, sha512) True   The Self Certificate signature algorythm



Trademarks :
  • "IBM", "IBM WebSphere MQ", "WebSphere MQ" and "IBM MQ Series" are registred trademarks of International Business Machines Corporation.
  • Other names may be trademarks of their respective owners.

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