JMS configuration scripts
The scripting library provides many script procedures to manage your Java™ Messaging Service (JMS) configurations. See the usage information for scripts that query your JMS configuration. You can run each script individually or combine many procedures to create custom automation scripts for your environment.
Each AdminJMS management script procedure is located in the app_server_root/scriptLibraries/resources/JMS/V70 directory.
- createGenericJMSConnectionFactory
- createGenericJMSConnectionFactoryUsingTemplate
- createGenericJMSConnectionFactoryAtScope
- createGenericJMSConnectionFactoryUsingTemplateAtScope
- createGenericJMSDestination
- createGenericJMSDestinationUsingTemplate
- createGenericJMSDestinationAtScope
- createGenericJMSDestinationUsingTemplateAtScope
- createJMSProvider
- createJMSProviderUsingTemplate
- createJMSProviderAtScope
- createJMSProviderUsingTemplateAtScope
- createWASQueue
- createWASQueueUsingTemplate
- createWASQueueAtScope
- createWASQueueUsingTemplateAtScope
- createSIBJMSQueue
- createWMQQueue
- createWASQueueConnectionFactory
- createWASQueueConnectionFactoryUsingTemplate
- createWASQueueConnectionFactoryAtScope
- createWASQueueConnectionFactoryUsingTemplateAtScope
- createWASTopic
- createWASTopicUsingTemplate
- createWASTopicAtScope
- createWASTopicUsingTemplateAtScope
- createSIBJMSTopic
- createWMQTopic
- createWASTopicConnectionFactory
- createWASTopicConnectionFactoryUsingTemplate
- createWASTopicConnectionFactoryAtScope
- createWASTopicConnectionFactoryUsingTemplateAtScope
- createSIBJMSConnectionFactory
- createWMQConnectionFactory
- createSIBJMSQueueConnectionFactory
- createWMQQueueConnectionFactory
- createSIBJMSTopicConnectionFactory
- createWMQTopicConnectionFactory
- createSIBJMSActivationSpec
- createWMQActivationSpec
- startListenerPort
Format for the scope argument
The scope format applies to the scripts in the script library that have the scope argument.
A cell is optional on node, server, and cluster scopes. A node is required on the server scope.
You can delimit the type by using a comma (,) or a colon (:). You can use lowercase for the type (cell=, node=, server=, or cluster=.)
The examples in the following table are split on multiple lines for publishing purposes.
Scope | Containment path | Configuration ID | Type |
---|---|---|---|
Cell | /Cell:myCell/ |
|
Cell=myCell or cell=myCell |
Node | /Cell:myCell/Node:myNode/ or /Node:myNode/ |
|
or or |
Server | or
|
|
or
or
|
Cluster | or
|
|
or or
|
createGenericJMSConnectionFactory
This script creates a new generic JMS connection factory in your configuration. The script returns the configuration ID of the created JMS connection factory in the respective cell.
Argument | Description |
---|---|
nodeName | Specifies the name of the node of interest. |
serverName | Specifies the name of the server of interest. |
jmsProvider | Specifies the name of the JMS provider. |
connFactoryName | Specifies the name to assign to the new connection factory |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
extJndiName | Specifies the JNDI name that is used to bind
the queue into the application server name space. As a convention,
use the fully qualified JNDI name; for example, in the form jms/Name ,
where Name is the logical name of the resource.
This name is used to link the platform binding information. The
binding associates the resources defined by the deployment descriptor
of the module to the actual (physical) resources bound into JNDI
by the platform. |
attributes | Optionally specifies additional
attributes in a particular format:
|
Attributes | Description | Example |
---|---|---|
XAEnabled | Specifies whether XA recovery processing is enabled. |
|
authDataAlias | Specifies the alias used for database authentication at runtime. |
|
authMechanismPreference | Specifies the authentication mechanism. Valid
values are BASIC_PASSWORD for basic authentication
and KERBEROS for Kerberos authentication. Do not put either of the values in quotes for the string format of the command. |
|
category | Specifies the category that can be used to classify or group the resource. |
|
connectionPool | Specifies the JMS connection pooling properties
for the parent JMS connection factory instance. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
description | Specifies a description of the resource adapter. |
|
diagnoseConnectionUsage | Specifies whether connection usage diagnosis is enabled. |
|
logMissingTransactionContext | Specifies whether missing transaction context logging is enabled. |
|
manageCachedHandles | Specifies whether this data source is used for
container-managed persistence of enterprise beans. The default value
is true . |
|
mapping | Specifies the mapping of the configuration login
to a specified authentication alias name. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
preTestConfig | Specifies the pretest connection configuration
settings. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
properties | Specifies either a typed property type or a
descriptive property type. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
provider | Specifies the JMS driver implementation class for access to a vendor database. To create a pool of connections to that database, associate a data source with the JMS provider. |
|
providerType | Specifies the JMS provider type used by this JMS provider. |
|
sessionPool | Specifies the JMS session pooling properties
for the parent JMS connection instance. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
xaRecoveryAuthAlias | Specifies the database authentication alias used during XA recovery processing. When this property is specified, the default value is the alias for application authentication. |
|
Attributes | Description | Example |
---|---|---|
type | Specifies QUEUE for queues, TOPIC for
topics, and UNIFIED for both queues and topics. Do not put either of the values in quotes for the string format of the command. |
|
Syntax
AdminJMS.createGenericJMSConnectionFactory(nodeName,
serverName, jmsProvider, connFactoryName, jndiName,
extJndiName, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createGenericJMSConnectionFactory("myNode", "myServer",
"JMSTest", "JMSCFTest", "jmsjndi", "extjmsjndi")
AdminJMS.createGenericJMSConnectionFactory("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1",
"My Generic JMSConnection Factory", "JNDIName", "extJNDIName", "XAEnabled=false,
authDataAlias=myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD, category=myCategory,
description='my JMS Connection Factory',
diagnoseConnectionUsage=false, logMissingTransactionContext=true, manageCachedHandles=true,
providerType=myJMSProviderType, type=TOPIC, xaRecoveryAuthAlias=myCellManager01/a1")
The following example script includes optional attributes in a list format:
AdminJMS.createGenericJMSConnectionFactory("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1",
"My Generic JMSConnection Factory",
"JNDIName", "extJNDIName", [['XAEnabled', 'false'], ['authDataAlias', 'myAuthDataAlias'],
['authMechanismPreference', 'BASIC_PASSWORD'], ['category', 'myCategory'],
['connectionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'],
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'],
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'],
['numberOfUnsharedPoolPartitions', '3'],
['properties', [[['description', 'My description'], ['name', 'myName'],
['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]],
['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeCreationInterval', '10'],
['surgeThreshold', '10'], ['testConnection', 'true'], ['testConnectionInterval', '10'],
['unusedTimeout', '10000']]], ['description', 'My description'],
['diagnoseConnectionUsage', 'false'], ['logMissingTransactionContext', 'true'],
['manageCachedHandles', 'true'], ['mapping', [['authDataAlias', 'authDataAliasValue'],
['mappingConfigAlias', 'mappingConfigAliasValue']]], ['preTestConfig',
[['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]],
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'],
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet',
[['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'],
['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'],
['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'],
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'],
['value', 50000]]]]]], ['providerType', 'myJMSProviderType'], ['sessionPool',
[['agedTimeout', '100'], ['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10],
['maxConnections', '12'], ['minConnections', '5'], ['numberOfFreePoolPartitions', '3'],
['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], ['properties',
[[['description', 'My description'], ['name', 'myName'], ['required', 'false'],
['validationExpression', ''], ['value', 'myValue']]]],
['purgePolicy', 'EntirePool'], ['reapTime', '10000'],
['surgeCreationInterval', '10'], ['surgeThreshold', '10'],
['testConnection', 'true'], ['testConnectionInterval', '10'], [
'unusedTimeout', '10000']]], ['type', 'TOPIC'], ['xaRecoveryAuthAlias', 'myCellManager01/a1']] )
createGenericJMSConnectionFactoryUsingTemplate
This script uses a template to create a generic JMS connection factory in your configuration. The script returns the configuration ID of the created JMS connection factory using a template in the respective cell.
Argument | Description |
---|---|
nodeName | Specifies the name of the node of interest. |
serverName | Specifies the name of the server of interest. |
jmsProvider | Specifies the name of the JMS provider. |
templateID | Specifies the configuration ID of the template to use. |
connFactoryName | Specifies the name to assign to the new connection factory |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
extJndiName | Specifies the JNDI name that is used to bind the queue into the application server name space. As a convention, use the fully qualified JNDI name; for example, in the form jms/Name, where Name is the logical name of the resource. This name is used to link the platform binding information. The binding associates the resources defined by the deployment descriptor of the module to the actual (physical) resources bound into JNDI by the platform. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
XAEnabled | Specifies whether XA recovery processing is enabled. |
|
authDataAlias | Specifies the alias used for database authentication at runtime. |
|
authMechanismPreference | Specifies the authentication mechanism. Valid
values are BASIC_PASSWORD for basic authentication
and KERBEROS for Kerberos authentication. Do not put either of the values in quotes for the string format of the command. |
|
category | Specifies the category that can be used to classify or group the resource. |
|
connectionPool | Specifies the JMS connection pooling properties
for the parent JMS connection factory instance. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
description | Specifies a description of the resource adapter. |
|
diagnoseConnectionUsage | Specifies whether connection usage diagnosis is enabled. |
|
logMissingTransactionContext | Specifies whether missing transaction context logging is enabled. |
|
manageCachedHandles | Specifies whether this data source is used for
container-managed persistence of enterprise beans. The default value
is true . |
|
mapping | Specifies the mapping of the configuration login
to a specified authentication alias name. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
preTestConfig | Specifies the pretest connection configuration
settings. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
properties | Specifies either a typed property type or a
descriptive property type. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
provider | Specifies the JMS driver implementation class for access to a vendor database. To create a pool of connections to that database, associate a data source with the JMS provider. |
|
providerType | Specifies the JMS provider type used by this JMS provider. |
|
sessionPool | Specifies the JMS session pooling properties
for the parent JMS connection instance. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
xaRecoveryAuthAlias | Specifies the database authentication alias used during XA recovery processing. When this property is specified, the default value is the alias for application authentication. |
|
Attributes | Description | Example |
---|---|---|
type | Specifies QUEUE for queues, TOPIC for
topics, and UNIFIED for both queues and topics. Do not put either of the values in quotes for the string format of the command. |
|
Syntax
AdminJMS.createGenericJMSConnectionFactoryUsingTemplate(nodeName,
serverName, jmsProvider, templateID,
connFactoryName, jndiName, extJndiName, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createGenericJMSConnectionFactoryUsingTemplate("myNode", "myServer",
"JMSTest", "Generic QueueConnectionFactory for
Windows(templates/system|JMS-resource-provider-templates.xml#GenericJMSConnectionFactory_1)",
"JMSCFTest", "jmsjndi", "extjmsjndi")
AdminJMS.createGenericJMSConnectionFactoryUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1",
"Generic QueueConnectionFactory for Windows
(templates/system|JMS-resource-provider-templates.xml#GenericJMSConnectionFactory_1)",
"My Generic JMSConnection Factory", "JNDIName", "extJNDIName", "XAEnabled=false,
authDataAlias=myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD, category=myCategory,
description='my JMS Connection Factory using template',
diagnoseConnectionUsage=false, logMissingTransactionContext=true, manageCachedHandles=true,
providerType=myJMSProviderType, type=TOPIC, xaRecoveryAuthAlias=myCellManager01/a1")
The following example script includes optional attributes in a list format:
AdminJMS.createGenericJMSConnectionFactoryUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1",
"Generic QueueConnectionFactory for Windows(templates/system|JMS-resource-provider-templates.xml#GenericJMSConnectionFactory_1)",
"My Generic JMSConnection Factory", "JNDIName", "extJNDIName", [['XAEnabled', 'false'],
['authDataAlias', 'myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'],
['category', 'myCategory'], ['connectionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'],
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'],
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'],
['numberOfUnsharedPoolPartitions', '3'], ['properties', [[['description', 'My description'],
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]],
['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeCreationInterval', '10'],
['surgeThreshold', '10'], ['testConnection', 'true'], ['testConnectionInterval', '10'],
['unusedTimeout', '10000']]], ['description', 'My description'], ['diagnoseConnectionUsage', 'false'],
['logMissingTransactionContext', 'true'], ['manageCachedHandles', 'true'], ['mapping',
[['authDataAlias', 'authDataAliasValue'], ['mappingConfigAlias', 'mappingConfigAliasValue']]],
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]],
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'],
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', [['resourceProperties',
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'],
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'],
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]],
['providerType', 'myJMSProviderType'], ['sessionPool', [['agedTimeout', '100'],
['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'],
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'],
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'],
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'],
['reapTime', '10000'], ['surgeCreationInterval', '10'], ['surgeThreshold', '10'],
['testConnection', 'true'], ['testConnectionInterval', '10'], ['unusedTimeout', '10000']]],
['type', 'TOPIC'], ['xaRecoveryAuthAlias', 'myCellManager01/a1']] )
createGenericJMSConnectionFactoryAtScope
This script creates a new generic JMS connection factory in your configuration at the scope that you specify. The script returns the configuration ID of the created JMS connection factory in the respective cell.
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the JMS provider. |
jmsProvider | Specifies the name of the JMS provider. |
connFactoryName | Specifies the name to assign to the new connection factory |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
extJndiName | Specifies the JNDI name that is used to bind
the queue into the application server name space. As a convention,
use the fully qualified JNDI name; for example, in the form jms/Name ,
where Name is the logical name of the resource.
This name is used to link the platform binding information. The
binding associates the resources defined by the deployment descriptor
of the module to the actual (physical) resources bound into JNDI
by the platform. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
XAEnabled | Specifies whether XA recovery processing is enabled. |
|
authDataAlias | Specifies the alias used for database authentication at runtime. |
|
authMechanismPreference | Specifies the authentication mechanism. Valid
values are BASIC_PASSWORD for basic authentication
and KERBEROS for Kerberos authentication. Do not put either of the values in quotes for the string format of the command. |
|
category | Specifies the category that can be used to classify or group the resource. |
|
connectionPool | Specifies the JMS connection pooling properties
for the parent JMS connection factory instance. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
description | Specifies a description of the resource adapter. |
|
diagnoseConnectionUsage | Specifies whether connection usage diagnosis is enabled. |
|
logMissingTransactionContext | Specifies whether missing transaction context logging is enabled. |
|
manageCachedHandles | Specifies whether this data source is used for
container-managed persistence of enterprise beans. The default value
is true . |
|
mapping | Specifies the mapping of the configuration login
to a specified authentication alias name. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
preTestConfig | Specifies the pretest connection configuration
settings. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
properties | Specifies either a typed property type or a
descriptive property type. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
provider | Specifies the JMS driver implementation class for access to a vendor database. To create a pool of connections to that database, associate a data source with the JMS provider. |
|
providerType | Specifies the JMS provider type used by this JMS provider. |
|
sessionPool | Specifies the JMS session pooling properties
for the parent JMS connection instance. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
xaRecoveryAuthAlias | Specifies the database authentication alias used during XA recovery processing. When this property is specified, the default value is the alias for application authentication. |
|
Attributes | Description | Example |
---|---|---|
type | Specifies QUEUE for queues, TOPIC for
topics, and UNIFIED for both queues and topics. Do not put either of the values in quotes for the string format of the command. |
|
Syntax
AdminJMS.createGenericJMSConnectionFactoryAtScope(scope,
jmsProvider, connFactoryName, jndiName,
extJndiName, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createGenericJMSConnectionFactoryAtScope("myScope", "JMSTest", "JMSCFTest", "jmsjndi",
"extjmsjndi")
AdminJMS.createGenericJMSConnectionFactoryAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "My Generic JMSConnection Factory", "JNDIName", "extJNDIName",
"XAEnabled=false, authDataAlias=myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD,
category=myCategory, diagnoseConnectionUsage=false, logMissingTransactionContext=true,
description='my JMS Connection Factory at scope',
manageCachedHandles=true, providerType=myJMSProviderType, type=TOPIC,
xaRecoveryAuthAlias=myCellManager01/a1")
The following example script includes optional attributes in a list format:
AdminJMS.createGenericJMSConnectionFactoryAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "My Generic JMSConnection Factory", "JNDIName", "extJNDIName", [['XAEnabled', 'false'],
['authDataAlias', 'myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'],
['category', 'myCategory'], ['connectionPool', [['agedTimeout', '100'],
['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], ['maxConnections', '12'],
['minConnections', '5'], ['numberOfFreePoolPartitions', '3'],
['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], ['properties',
[[['description', 'My description'], ['name', 'myName'], ['required', 'false'],
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'],
['reapTime', '10000'], ['surgeCreationInterval', '10'], ['surgeThreshold', '10'],
['testConnection', 'true'], ['testConnectionInterval', '10'], ['unusedTimeout', '10000']]],
['description', 'My description'], ['diagnoseConnectionUsage', 'false'],
['logMissingTransactionContext', 'true'], ['manageCachedHandles', 'true'], ['mapping',
[['authDataAlias', 'authDataAliasValue'], ['mappingConfigAlias', 'mappingConfigAliasValue']]],
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', '12343'],
['retryLimit', '4']]], ['properties', [[['description', 'My description'], ['name', 'myName'],
['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]], ['propertySet',
[['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'],
['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]],
[['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']],
[['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]],
['providerType', 'myJMSProviderType'], ['sessionPool', [['agedTimeout', '100'],
['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], ['maxConnections', '12'],
['minConnections', '5'], ['numberOfFreePoolPartitions', '3'],
['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'],
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'],
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'],
['reapTime', '10000'], ['surgeCreationInterval', '10'], ['surgeThreshold', '10'],
['testConnection', 'true'], ['testConnectionInterval', '10'], ['unusedTimeout', '10000']]],
['type', 'TOPIC'], ['xaRecoveryAuthAlias', 'myCellManager01/a1']] )
createGenericJMSConnectionFactoryUsingTemplateAtScope
This script uses a template to create a generic JMS connection factory in your configuration at the scope that you specify. The script returns the configuration ID of the created JMS connection factory using a template in the respective cell.
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the JMS provider. |
jmsProvider | Specifies the name of the JMS provider. |
templateID | Specifies the configuration ID of the template to use. |
connFactoryName | Specifies the name to assign to the new connection factory |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
extJndiName | Specifies the JNDI name that is used to bind the queue into the application server name space. As a convention, use the fully qualified JNDI name; for example, in the form jms/Name, where Name is the logical name of the resource. This name is used to link the platform binding information. The binding associates the resources defined by the deployment descriptor of the module to the actual (physical) resources bound into JNDI by the platform. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
XAEnabled | Specifies whether XA recovery processing is enabled. |
|
authDataAlias | Specifies the alias used for database authentication at runtime. |
|
authMechanismPreference | Specifies the authentication mechanism. Valid
values are BASIC_PASSWORD for basic authentication
and KERBEROS for Kerberos authentication. Do not put either of the values in quotes for the string format of the command. |
|
category | Specifies the category that can be used to classify or group the resource. |
|
connectionPool | Specifies the JMS connection pooling properties
for the parent JMS connection factory instance. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
description | Specifies a description of the resource adapter. |
|
diagnoseConnectionUsage | Specifies whether connection usage diagnosis is enabled. |
|
logMissingTransactionContext | Specifies whether missing transaction context logging is enabled. |
|
manageCachedHandles | Specifies whether this data source is used for
container-managed persistence of enterprise beans. The default value
is true . |
|
mapping | Specifies the mapping of the configuration login
to a specified authentication alias name. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
preTestConfig | Specifies the pretest connection configuration
settings. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
properties | Specifies either a typed property type or a
descriptive property type. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
provider | Specifies the JMS driver implementation class for access to a vendor database. To create a pool of connections to that database, associate a data source with the JMS provider. |
|
providerType | Specifies the JMS provider type used by this JMS provider. |
|
sessionPool | Specifies the JMS session pooling properties
for the parent JMS connection instance. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
xaRecoveryAuthAlias | Specifies the database authentication alias used during XA recovery processing. When this property is specified, the default value is the alias for application authentication. |
|
Attributes | Description | Example |
---|---|---|
type | Specifies QUEUE for queues, TOPIC for
topics, and UNIFIED for both queues and topics. Do not put either of the values in quotes for the string format of the command. |
|
Syntax
AdminJMS.createGenericJMSConnectionFactoryUsingTemplateAtScope(scope,
jmsProvider, templateID,
connFactoryName, jndiName, extJndiName, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createGenericJMSConnectionFactoryUsingTemplateAtScope("myScope",
"JMSTest", "Generic QueueConnectionFactory for
Windows(templates/system|JMS-resource-provider-templates.xml#GenericJMSConnectionFactory_1)",
"JMSCFTest", "jmsjndi", "extjmsjndi")
AdminJMS.createGenericJMSConnectionFactoryUsingTemplateAtScope
("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1",
"Generic QueueConnectionFactory for Windows(templates/system|JMS-resource-provider-templates.xml#GenericJMSConnectionFactory_1)",
"My Generic JMSConnection Factory", "JNDIName", "extJNDIName", "XAEnabled=false,
authDataAlias=myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD, category=myCategory,
diagnoseConnectionUsage=false, logMissingTransactionContext=true, manageCachedHandles=true,
description='my JMS Connection Factory using a template and scope',
providerType=myJMSProviderType, type=TOPIC, xaRecoveryAuthAlias=myCellManager01/a1")
The following example script includes optional attributes in a list format:
AdminJMS.createGenericJMSConnectionFactoryUsingTemplateAtScope
("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1",
"Generic QueueConnectionFactory for Windows(templates/system|JMS-resource-provider-templates.xml#GenericJMSConnectionFactory_1)",
"My Generic JMSConnection Factory", "JNDIName", "extJNDIName",
[['XAEnabled', 'false'], ['authDataAlias', 'myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'],
['category', 'myCategory'], ['connectionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'],
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'],
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'],
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'],
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], ['reapTime', '10000'],
['surgeCreationInterval', '10'], ['surgeThreshold', '10'], ['testConnection', 'true'],
['testConnectionInterval', '10'], ['unusedTimeout', '10000']]], ['description', 'My description'],
['diagnoseConnectionUsage', 'false'], ['logMissingTransactionContext', 'true'],
['manageCachedHandles', 'true'], ['mapping', [['authDataAlias', 'authDataAliasValue'],
['mappingConfigAlias', 'mappingConfigAliasValue']]], ['preTestConfig', [['preTestConnection', 'true'],
['retryInterval', '12343'], ['retryLimit', '4']]], ['properties', [[['description', 'My description'],
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]],
['propertySet', [['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'],
['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]],
[['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'],
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myJMSProviderType'],
['sessionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10],
['maxConnections', '12'], ['minConnections', '5'], ['numberOfFreePoolPartitions', '3'],
['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], ['properties',
[[['description', 'My description'], ['name', 'myName'], ['required', 'false'], ['validationExpression', ''],
['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], ['reapTime', '10000'],
['surgeCreationInterval', '10'], ['surgeThreshold', '10'], ['testConnection', 'true'],
['testConnectionInterval', '10'], ['unusedTimeout', '10000']]], ['type', 'TOPIC'],
['xaRecoveryAuthAlias', 'myCellManager01/a1']] )
createGenericJMSDestination
This script creates a generic JMS destination in your configuration. The script returns the configuration ID of the created JMS destination in the respective cell.
Argument | Description |
---|---|
nodeName | Specifies the name of the node of interest. |
serverName | Specifies the name of the server of interest. |
jmsProvider | Specifies the name of the JMS provider. |
genericJMSDestination | Specifies the name to assign to the new generic JMS destination. |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
extJndiName | Specifies the JNDI name that is used to bind the queue into the application server name space. As a convention, use the fully qualified JNDI name; for example, in the form jms/Name, where Name is the logical name of the resource. This name is used to link the platform binding information. The binding associates the resources defined by the deployment descriptor of the module to the actual (physical) resources bound into JNDI by the platform. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
category | Specifies the category that can be used to classify or group the resource. |
|
description | Specifies a description of the resource adapter. |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
provider | Specifies the JMS driver implementation class for access to a vendor database. To create a pool of connections to that database, associate a data source with the JMS provider. |
|
providerType | Specifies the JMS provider type used by this JMS provider. |
|
type | Specifies QUEUE for queues, TOPIC for
topics, and UNIFIED for both queues and topics. Do not put either of the values in quotes for the string format of the command. |
|
Syntax
AdminJMS.createGenericJMSDestination(nodeName,
serverName, jmsProvider, genericJMSDestination,
jndiName, extJndiName, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createGenericJMSDestination("myNode", "myServer", "JMSTest",
"JMSDest", "destjndi", "extDestJndi")
AdminJMS.createGenericJMSDestination("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1",
"My JMSDestination", "JNDIName", "extJNDIName", "category=myCategory, description='My description',
providerType=myProviderType, type=QUEUE")
The following example script includes optional attributes in a list format:
AdminJMS.createGenericJMSDestination("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1",
"My JMSDestination", "JNDIName", "extJNDIName", [['category', 'myCategory'], ['description',
'My description'], ['propertySet', [['resourceProperties', [[['name', 'databaseName'],
['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'],
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'],
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]],
['providerType', 'myProviderType'], ['type', 'QUEUE']] )
createGenericJMSDestinationUsingTemplate
This script uses a template to create a generic JMS destination in your configuration. The script returns the configuration ID of the created JMS destination in the respective cell.
To run the script, specify the node, server, JMS provider name, template ID, generic JMS destination name, JNDI name, and external JNDI name arguments. You can optionally specify attributes. The arguments and attributes are defined in the following tables:
Argument | Description |
---|---|
nodeName | Specifies the name of the node of interest. |
serverName | Specifies the name of the server of interest. |
jmsProvider | Specifies the name of the JMS provider. |
templateID | Specifies the configuration ID of the template to use. |
genericJMSDestination | Specifies the name to assign to the new generic JMS destination. |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
extJndiName | Specifies the JNDI name that is used to bind the queue into the application server name space. As a convention, use the fully qualified JNDI name; for example, in the form jms/Name, where Name is the logical name of the resource. This name is used to link the platform binding information. The binding associates the resources defined by the deployment descriptor of the module to the actual (physical) resources bound into JNDI by the platform. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
category | Specifies the category that can be used to classify or group the resource. |
|
description | Specifies a description of the resource adapter. |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
provider | Specifies the JMS driver implementation class for access to a vendor database. To create a pool of connections to that database, associate a data source with the JMS provider. |
|
providerType | Specifies the JMS provider type used by this JMS provider. |
|
type | Specifies QUEUE for queues, TOPIC for
topics, and UNIFIED for both queues and topics. Do not put either of the values in quotes for the string format of the command. |
|
Syntax
AdminJMS.createGenericJMSDestinationUsingTemplate(nodeName,
serverName, jmsProvider, templateID,
genericJMSDestination, jndiName, extJndiName,
attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createGenericJMSDestinationUsingTemplate("myNode", "myServer",
"JMSTest",
"Example.JMS.Generic.Win.Topic(templates/system|JMS-resource-provider-templates.xml#GenericJMSDestination_2)",
"JMSDest", "destjndi", "extDestJndi")
AdminJMS.createGenericJMSDestinationUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1",
"Example.JMS.Generic.Win.Queue(templates/system|JMS-resource-provider-templates.xml#GenericJMSDestination_1)",
"My JMSDestination", "JNDIName", "extJNDIName","category=myCategory, description='My description',
providerType=myProviderType, type=QUEUE ")
The following example script includes optional attributes in a list format:
AdminJMS.createGenericJMSDestinationUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1",
"Example.JMS.Generic.Win.Queue(templates/system|JMS-resource-provider-templates.xml#GenericJMSDestination_1)",
"My JMSDestination", "JNDIName", "extJNDIName", [['category', 'myCategory'],
['description', 'My description'], ['propertySet', [['resourceProperties', [[['name', 'databaseName'],
['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'],
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'],
['value','localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]],
['providerType', 'myProviderType'], ['type', 'QUEUE']] )
createGenericJMSDestinationAtScope
This script creates a generic JMS destination in your configuration at the scope that you specify. The script returns the configuration ID of the created JMS destination in the respective cell.
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the JMS provider. |
serverName | Specifies the name of the server of interest. |
jmsProvider | Specifies the name of the JMS provider. |
genericJMSDestination | Specifies the name to assign to the new generic JMS destination. |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
extJndiName | Specifies the JNDI name that is used to bind the queue into the application server name space. As a convention, use the fully qualified JNDI name; for example, in the form jms/Name, where Name is the logical name of the resource. This name is used to link the platform binding information. The binding associates the resources defined by the deployment descriptor of the module to the actual (physical) resources bound into JNDI by the platform. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
category | Specifies the category that can be used to classify or group the resource. |
|
description | Specifies a description of the resource adapter. |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
provider | Specifies the JMS driver implementation class for access to a vendor database. To create a pool of connections to that database, associate a data source with the JMS provider. |
|
providerType | Specifies the JMS provider type used by this JMS provider. |
|
type | Specifies QUEUE for queues, TOPIC for
topics, and UNIFIED for both queues and topics. Do not put either of the values in quotes for the string format of the command. |
|
Syntax
AdminJMS.createGenericJMSDestinationAtScope(scope,
jmsProvider, genericJMSDestination,
jndiName, extJndiName, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createGenericJMSDestinationAtScope("myScope", "JMSTest",
"JMSDest", "destjndi", "extDestJndi")
AdminJMS.createGenericJMSDestinationAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "My JMSDestination", "JNDIName", "extJNDIName", "category=myCategory,
description='My description', providerType=myProviderType, type=QUEUE")
The following example script includes optional attributes in a list format:
AdminJMS.createGenericJMSDestinationAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "My JMSDestination", "JNDIName", "extJNDIName", [['category', 'myCategory'],
['description', 'My description'], ['propertySet', [['resourceProperties', [[['name', 'databaseName'],
['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'],
['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'],
['type', 'java.lang.Integer'], ['value',50000]]]]]], ['providerType', 'myProviderType'], ['type', 'QUEUE']] )
createGenericJMSDestinationUsingTemplateAtScope
This script uses a template to create a generic JMS destination in your configuration at the scope you specify. The script returns the configuration ID of the created JMS destination in the respective cell.
To run the script, specify the scope, JMS provider name, template ID, generic JMS destination name, JNDI name, and external JNDI name arguments. You can optionally specify attributes. The arguments and attributes are defined in the following tables:
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the JMS provider. |
serverName | Specifies the name of the server of interest. |
jmsProvider | Specifies the name of the JMS provider. |
templateID | Specifies the configuration ID of the template to use. |
genericJMSDestination | Specifies the name to assign to the new generic JMS destination. |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
extJndiName | Specifies the JNDI name that is used to bind the queue into the application server name space. As a convention, use the fully qualified JNDI name; for example, in the form jms/Name, where Name is the logical name of the resource. This name is used to link the platform binding information. The binding associates the resources defined by the deployment descriptor of the module to the actual (physical) resources bound into JNDI by the platform. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
category | Specifies the category that can be used to classify or group the resource. |
|
description | Specifies a description of the resource adapter. |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
provider | Specifies the JMS driver implementation class for access to a vendor database. To create a pool of connections to that database, associate a data source with the JMS provider. |
|
providerType | Specifies the JMS provider type used by this JMS provider. |
|
type | Specifies QUEUE for queues, TOPIC for
topics, and UNIFIED for both queues and topics. Do not put either of the values in quotes for the string format of the command. |
|
Syntax
AdminJMS.createGenericJMSDestinationUsingTemplateAtScope(scope,
jmsProvider, templateID,
genericJMSDestination, jndiName, extJndiName,
attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createGenericJMSDestinationUsingTemplateAtScope("myScope",
"JMSTest",
"Example.JMS.Generic.Win.Topic(templates/system|JMS-resource-provider-templates.xml#GenericJMSDestination_2)",
"JMSDest", "destjndi", "extDestJndi")
AdminJMS.createGenericJMSDestinationUsingTemplateAtScope
("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "Example.JMS.Generic.Win.Queue
(templates/system|JMS-resource-provider-templates.xml#GenericJMSDestination_1)",
"My JMSDestination", "JNDIName", "extJNDIName", "category=myCategory,
description='My description', providerType=myProviderType, type=QUEUE")
The following example script includes optional attributes in a list format:
AdminJMS.createGenericJMSDestinationUsingTemplateAtScope
("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "Example.JMS.Generic.Win.Queue
(templates/system|JMS-resource-provider-templates.xml#GenericJMSDestination_1)",
"My JMSDestination", "JNDIName", "extJNDIName", [['category', 'myCategory'], ['description', 'My description'],
['propertySet', [['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']],
[['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'],
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]],
['providerType', 'myProviderType'], ['type', 'QUEUE']] )
createJMSProvider
This script creates a JMS provider in your configuration. The script returns the configuration ID of the created JMS provider in the respective cell.
To run the script, specify the node, server, JMS provider name, external initial contextual factory name, and external provider URL arguments. You can optionally specify attributes. The arguments and attributes are defined in the following tables:
Argument | Description |
---|---|
nodeName | Specifies the name of the node of interest. |
serverName | Specifies the name of the server of interest. |
jmsProvider | Specifies the name to assign to the new JMS provider. |
extContextFactory | Specifies the Java class name of the initial context factory for the JMS provider. |
extProviderURL | Specifies the JMS provider URL for external JNDI lookups. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
classpath | Specifies a list of paths or Java archive (JAR) file names which together form the location for the resource provider classes. Use a semicolon (;) to separate class paths. |
|
description | Specifies a description of the JMS Provider. |
|
isolatedClassLoader | If set to true, specifies that the resource
provider is loaded in its own class loader. Attention: A
provider cannot be isolated when a native library path is specified.
|
|
nativepath | Specifies an optional path to any native libraries, such as *.dll and *.so. Native path entries are separated by a semicolon (;). |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
providerType | Specifies the JMS provider type that this JMS provider uses. |
|
supportsASF | If set to true , specifies that
the JMS provider supports Application Server Facilities (ASF), which
provides concurrency and transactional support for applications. |
|
Syntax
AdminJMS.createJMSProvider(nodeName, serverName,
jmsProvider, extContextFactory, extProviderURL,
attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createJMSProvider("myNode", "myServer", "JMSTest1",
"extInitCF", "extPURL")
AdminJMS.createJMSProvider("IBM-F4A849C57A0Node01", "server1", "MyJMSProvider", "extInitCF", "extPURL",
"classpath='${DB2_JCC_DRIVER_PATH}/db2jcc4.jar; ${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar',
description='My JMSProvider description',isolatedClassLoader=true,
nativepath=${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}, providerType=myJMSProviderType, supportsASF=true")
The following example script includes optional attributes in a list format:
AdminJMS.createJMSProvider("IBM-F4A849C57A0Node01", "server1", "MyJMSProvider", "extInitCF", "extPURL",
[['classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar; ${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar'], ['description', 'My JMSProvider description'],
['isolatedClassLoader', 'true'], ['nativepath', '${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}'],
['propertySet', [['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'],
['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]],
[['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'],
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myJMSProviderType'],
['supportsASF', 'true']] )
createJMSProviderUsingTemplate
This script uses a template to create a JMS provider in your configuration. The script returns the configuration ID of the created JMS provider using a template in the respective cell.
To run the script, specify the node, server, configuration ID of the JMS provider template, name to assign to the new JMS provider, external initial context factory, and external provider URL arguments. You can optionally specify attributes. The arguments and attributes are defined in the following tables:
Argument | Description |
---|---|
nodeName | Specifies the name of the node of interest. |
serverName | Specifies the name of the server of interest. |
templateID | Specifies the configuration ID of the JMS provider template to use. |
jmsProvider | Specifies the name to assign to the new JMS provider. |
extContextFactory | Specifies the Java class name of the initial context factory for the JMS provider. |
extProviderURL | Specifies the JMS provider URL for external JNDI lookups. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
classpath | Specifies a list of paths or Java archive (JAR) file names which together form the location for the resource provider classes. Use a semicolon (;) to separate class paths. |
|
description | Specifies a description of the JMS Provider. |
|
isolatedClassLoader | If set to true, specifies that the resource
provider is loaded in its own class loader. Attention: A
provider cannot be isolated when a native library path is specified.
|
|
nativepath | Specifies an optional path to any native libraries, such as *.dll and *.so. Native path entries are separated by a semicolon (;). |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
providerType | Specifies the JMS provider type that this JMS provider uses. |
|
supportsASF | If set to true , specifies that
the JMS provider supports Application Server Facilities (ASF), which
provides concurrency and transactional support for applications. |
|
Syntax
AdminJMS.createJMSProviderUsingTemplate(nodeName,
serverName, templateID, jmsProvider,
extContextFactory, extProviderURL, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createJMSProviderUsingTemplate("myNode", "myServer", "WebSphere JMS
Provider(templates/servertypes/APPLICATION_SERVER/servers/DeveloperServer|resources.xml#builtin_jmsprovider)",
"JMSTest", "extInitCF", "extPURL")
AdminJMS.createJMSProviderUsingTemplate("IBM-F4A849C57A0Node01", "server1",
"WebSphere JMSProvider(templates/servertypes/APPLICATION_SERVER/servers/default|resources.xml#builtin_jmsprovider)",
"MyJMSProvider", "extInitCF", "extPURL",
"classpath='${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar', description='My JMSProvider description',
isolatedClassLoader=true, nativepath=${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH},
providerType=myJMSProviderType,supportsASF=true")
AdminJMS.createJMSProviderUsingTemplate("IBM-F4A849C57A0Node01", "server1",
"WebSphere JMSProvider(templates/servertypes/APPLICATION_SERVER/servers/default|resources.xml#builtin_jmsprovider)",
"MyJMSProvider", "extInitCF", "extPURL",
[['classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar'],
['description', 'My JMSProvider description'], ['isolatedClassLoader', 'true'],
['nativepath', '${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}'],
['propertySet', [['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'],
['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]],
[['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']],
[['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]],
['providerType', 'myJMSProviderType'], ['supportsASF', 'true']])
createJMSProviderAtScope
This script creates a JMS provider in your configuration at the scope that you specify. The script returns the configuration ID of the created JMS provider in the respective cell.
To run the script, specify the scope, JMS provider name, external initial contextual factory name, and external provider URL arguments. You can optionally specify attributes. The arguments and attributes are defined in the following tables:
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the JMS provider. |
jmsProvider | Specifies the name to assign to the new JMS provider. |
extContextFactory | Specifies the Java class name of the initial context factory for the JMS provider. |
extProviderURL | Specifies the JMS provider URL for external JNDI lookups. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
classpath | Specifies a list of paths or Java archive (JAR) file names which together form the location for the resource provider classes. Use a semicolon (;) to separate class paths. |
|
description | Specifies a description of the JMS Provider. |
|
isolatedClassLoader | If set to true, specifies that the resource
provider is loaded in its own class loader. Attention: A
provider cannot be isolated when a native library path is specified.
|
|
nativepath | Specifies an optional path to any native libraries, such as *.dll and *.so. Native path entries are separated by a semicolon (;). |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
providerType | Specifies the JMS provider type that this JMS provider uses. |
|
supportsASF | If set to true , specifies that
the JMS provider supports Application Server Facilities (ASF), which
provides concurrency and transactional support for applications. |
|
Syntax
AdminJMS.createJMSProviderAtScope(scope,
jmsProvider, extContextFactory, extProviderURL,
attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createJMSProvider("myScope", "JMSTest1",
"extInitCF", "extPURL")
AdminJMS. createJMSProviderAtScope ("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"MyJMSProvider", "extInitCF", "extPURL",
"classpath='${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar', description='My JMSProvider description',
isolatedClassLoader=true, nativepath=${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH},
providerType=myJMSProviderType,supportsASF=true")
The following example script includes optional attributes in a list format:
AdminJMS.createJMSProviderAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"MyJMSProvider", "extInitCF", "extPURL", [['classpath',
'${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar'], ['description', 'My JMSProvider description'],
['isolatedClassLoader', 'true'], ['nativepath', '${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}'],
['propertySet', [['resourceProperties', [[['name', 'databaseName'],
['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'],
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'],
['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'],
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myJMSProviderType'],
['supportsASF', 'true']] )
createJMSProviderUsingTemplateAtScope
This script uses a template to create a JMS provider at the scope that you specify. The script returns the configuration ID of the created JMS provider using a template in the respective cell.
To run the script, specify the scope, configuration ID of the JMS provider template, name to assign to the new JMS provider, external initial context factory, and external provider URL arguments. You can optionally specify attributes. The arguments and attributes are defined in the following tables:
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the JMS provider. |
templateID | Specifies the configuration ID of the JMS provider template to use. |
jmsProvider | Specifies the name to assign to the new JMS provider. |
extContextFactory | Specifies the Java class name of the initial context factory for the JMS provider. |
extProviderURL | Specifies the JMS provider URL for external JNDI lookups. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
classpath | Specifies a list of paths or Java archive (JAR) file names which together form the location for the resource provider classes. Use a semicolon (;) to separate class paths. |
|
description | Specifies a description of the JMS Provider. |
|
isolatedClassLoader | If set to true, specifies that the resource
provider is loaded in its own class loader. Attention: A
provider cannot be isolated when a native library path is specified.
|
|
nativepath | Specifies an optional path to any native libraries, such as *.dll and *.so. Native path entries are separated by a semicolon (;). |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
providerType | Specifies the JMS provider type that this JMS provider uses. |
|
supportsASF | If set to true , specifies that
the JMS provider supports Application Server Facilities (ASF), which
provides concurrency and transactional support for applications. |
|
Syntax
AdminJMS.createJMSProviderUsingTemplateAtScope(scope,
templateID, jmsProvider,
extContextFactory, extProviderURL, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createJMSProviderUsingTemplateAtScope("myScope", "WebSphere JMS
Provider(templates/servertypes/APPLICATION_SERVER/servers/DeveloperServer|resources.xml#builtin_jmsprovider)",
"JMSTest", "extInitCF", "extPURL")
AdminJMS. createJMSProviderUsingTemplateAtScope
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"WebSphere JMSProvider(templates/servertypes/APPLICATION_SERVER/servers/default|resources.xml#builtin_jmsprovider)",
"MyJMSProvider", "extInitCF", "extPURL",
"classpath='${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar', description='My JMSProvider description',
isolatedClassLoader=true, nativepath=${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH},
providerType=myJMSProviderType,supportsASF=true")
AdminJMS.createJMSProviderUsingTemplateAtScope("Cell=IBM-F4A849C57A0Cell01, Node=IBM-F4A849C57A0Node01",
"WebSphere JMS Provider(templates/servertypes/APPLICATION_SERVER/servers/default|resources.xml#builtin_jmsprovider)",
"MyJMSProvider", "extInitCF", "extPURL",
[['classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar; ${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar'], ['description', 'My JMSProvider description'],
['isolatedClassLoader', 'true'], ['nativepath', '${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}'],
['propertySet', [['resourceProperties', [[['name', 'databaseName'],
['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'],
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'],
['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'],
['type', 'java.lang.Integer'], ['value',50000]]]]]], ['providerType', 'myJMSProviderType'],
['supportsASF', 'true']] )
createWASQueue
This script creates a WebSphere Application server queue in your configuration. You should only use JMS resources for applications that perform messaging with a WebSphere Application Server version 5.1 embedded JMSServer in a Version 7.0 cell. The script returns the configuration ID of the created WebSphere Application Server queue in the respective cell.
To run the script, specify the node, server, JMS provider name, name to assign to the queue, and JNDI name arguments. You can optionally specify attributes. The arguments and attributes are defined in the following tables:
Argument | Description |
---|---|
nodeName | Specifies the name of the node of interest. |
serverName | Specifies the name of the server of interest. |
jmsProvider | Specifies the name of the JMS provider of interest. |
queueName | Specifies the name to assign to the new queue. |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
category | Specifies the category that can be used to classify or group the resource. |
|
description | Specifies a description of the resource adapter. |
|
expiry | Specifies the length of time after which messages
that are sent to this destination expire and are dealt with according
to their disposition options. Valid values are APPLICATION_DEFINE , SPECIFIED ,
and UNLIMITED . Do not put either of the values in quotes for the string format of the command. |
|
persistence | Specifies the level of persistence. Valid values
are APPLICATION_DEFINED , NONPERSISTENT ,
and PERSISTENT . |
|
priority | Specifies the level of priority. Valid values
are APPLICATION_DEFINED and SPECIFIED . |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
provider | Specifies the JMS driver implementation class for access to a specific vendor database. To create a pool of connections to that database, associate a data source with the JMS provider. |
|
providerType | Specifies the JMS provider type used by this JMS provider. |
|
specifiedExpiry | Specifies the time in milliseconds after which messages on this queue are discarded. |
|
specifiedPriority | Specifies the priority from 0 to 9 of the WASQueue WebSphere queue. |
|
Syntax
AdminJMS.createWASQueue(nodeName, serverName,
jmsProvider, queueName, jndiName,
attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createWASQueue("myNode", "myServer", "JMSTest",
"WASQueueTest", "queuejndi")
AdminJMS.createWASQueue("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1",
"Example.JMS.WAS.Q1(templates/system|JMS-resource-provider-templates.xml#WASQueue_1)",
"My WASQueue Name", "JNDIName", "category =myCategory, description='My description',
expiry=SPECIFIED, persistence=NONPERSISTENT, priority=SPECIFIED, specifiedExpiry=1000,
specifiedPriority=0")
The following example script includes optional attributes in a list format:
AdminJMS.createWASQueue("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", "My WASQueue Name",
"JNDIName", [['category ', 'myCategory'], ['description', 'My description'], ['expiry', 'SPECIFIED'],
['persistence', 'NONPERSISTENT'], ['priority', 'SPECIFIED'], ['propertySet', [['resourceProperties',
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'],
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'],
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]],
['providerType', 'myProviderType'], ['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )
createWASQueueUsingTemplate
This script uses a template to create a WebSphere Application Server queue in your configuration. You should only use JMS resources for applications that perform messaging with a WebSphere Application Server version 5.1 embedded JMSServer in a Version 7.0 cell. The script returns the configuration ID of the created WebSphere Application Server queue using a template in the respective cell.
Argument | Description |
---|---|
nodeName | Specifies the name of the node of interest. |
serverName | Specifies the name of the server of interest. |
jmsProvider | Specifies the name of the JMS provider of interest. |
templateID | Specifies the configuration ID of the WebSphere Application Server queue template to use. |
queueName | Specifies the name to assign to the new queue. |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
category | Specifies the category that can be used to classify or group the resource. |
|
description | Specifies a description of the resource adapter. |
|
expiry | Specifies the length of time after which messages
that are sent to this destination expire and are dealt with according
to their disposition options. Valid values are APPLICATION_DEFINE , SPECIFIED ,
and UNLIMITED . Do not put either of the values in quotes for the string format of the command. |
|
persistence | Specifies the level of persistence. Valid values
are APPLICATION_DEFINED , NONPERSISTENT ,
and PERSISTENT . |
|
priority | Specifies the level of priority. Valid values
are APPLICATION_DEFINED and SPECIFIED . |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
provider | Specifies the JMS driver implementation class for access to a specific vendor database. To create a pool of connections to that database, associate a data source with the JMS provider. |
|
providerType | Specifies the JMS provider type used by this JMS provider. |
|
specifiedExpiry | Specifies the time in milliseconds after which messages on this queue are discarded. |
|
specifiedPriority | Specifies the priority from 0 to 9 of the WASQueue WebSphere queue. |
|
Syntax
AdminJMS.createWASQueueUsingTemplate(nodeName,
serverName, jmsProvider, templateID, queueName,
jndiName, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createWASQueueUsingTemplate("myNode", "myServer", "JMSTest",
"WASQueueTest", "queuejndi")
AdminJMS.createWASQueueUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1",
"Example.JMS.WAS.Q1(templates/system|JMS-resource-provider-templates.xml#WASQueue_1)", "My WASQueue Name",
"JNDIName", “category =myCategory, description='My description', expiry=SPECIFIED,
providerType=myProviderType, specifiedExpiry=1000, specifiedPriority=0”)
The following example script includes optional attributes in a list format:
Usage: AdminJMS.createWASQueueUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1",
"Example.JMS.WAS.Q1(templates/system|JMS-resource-provider-templates.xml#WASQueue_1)", "My WASQueue Name",
"JNDIName", [['category ', 'myCategory'], ['description', 'My description'], ['expiry', 'SPECIFIED'],
['persistence', 'NONPERSISTENT'], ['priority', 'SPECIFIED'], ['propertySet', [['resourceProperties',
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'],
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'],
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]],
['providerType', 'myProviderType'], ['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )
createWASQueueAtScope
This script creates a WebSphere Application Server queue in your configuration at the scope that you specify. You should only use JMS resources for applications that perform messaging with a WebSphere Application Server version 5.1 embedded JMSServer in a Version 7.0 cell. The script returns the configuration ID of the created WebSphere Application Server queue in the respective cell.
To run the script, specify the scope, JMS provider name, name to assign to the queue, and JNDI name arguments. You can optionally specify attributes. The arguments and attributes are defined in the following tables:
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the JMS provider. |
jmsProvider | Specifies the name of the JMS provider of interest. |
queueName | Specifies the name to assign to the new queue. |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
category | Specifies the category that can be used to classify or group the resource. |
|
description | Specifies a description of the resource adapter. |
|
expiry | Specifies the length of time after which messages
that are sent to this destination expire and are dealt with according
to their disposition options. Valid values are APPLICATION_DEFINE , SPECIFIED ,
and UNLIMITED . Do not put either of the values in quotes for the string format of the command. |
|
persistence | Specifies the level of persistence. Valid values
are APPLICATION_DEFINED , NONPERSISTENT ,
and PERSISTENT . |
|
priority | Specifies the level of priority. Valid values
are APPLICATION_DEFINED and SPECIFIED . |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
provider | Specifies the JMS driver implementation class for access to a specific vendor database. To create a pool of connections to that database, associate a data source with the JMS provider. |
|
providerType | Specifies the JMS provider type used by this JMS provider. |
|
specifiedExpiry | Specifies the time in milliseconds after which messages on this queue are discarded. |
|
specifiedPriority | Specifies the priority from 0 to 9 of the WASQueue WebSphere queue. |
|
Syntax
AdminJMS.createWASQueueAtScope(scope,
jmsProvider, queueName, jndiName,
attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createWASQueueAtScope("scope", "JMSTest",
"WASQueueTest", "queuejndi")
AdminJMS.createWASQueueAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "My WASQueue Name", "JNDIName", “category =myCategory, description='My description',
expiry=SPECIFIED, providerType=myProviderType, specifiedExpiry=1000, specifiedPriority=0”)
The following example script includes optional attributes in a list format:
AdminJMS.createWASQueueAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "My WASQueue Name", "JNDIName", [['category ', 'myCategory'], ['description', 'My description'],
['expiry', 'SPECIFIED'], ['persistence', 'NONPERSISTENT'], ['priority', 'SPECIFIED'], ['propertySet',
[['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']],
[['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'],
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], [
'providerType', 'myProviderType'], ['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )
createWASQueueUsingTemplateAtScope
This script uses a template to create a WebSphere Application Server queue in your configuration at the scope that you specify. You should only use JMS resources for applications that perform messaging with a WebSphere Application Server version 5.1 embedded JMSServer in a Version 7.0 cell. The script returns the configuration ID of the created WebSphere Application Server queue using a template in the respective cell.
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the JMS provider. |
jmsProvider | Specifies the name of the JMS provider of interest. |
templateID | Specifies the configuration ID of the WebSphere Application Server queue template to use. |
queueName | Specifies the name to assign to the new queue. |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
category | Specifies the category that can be used to classify or group the resource. |
|
description | Specifies a description of the resource adapter. |
|
expiry | Specifies the length of time after which messages
that are sent to this destination expire and are dealt with according
to their disposition options. Valid values are APPLICATION_DEFINE , SPECIFIED ,
and UNLIMITED . Do not put either of the values in quotes for the string format of the command. |
|
persistence | Specifies the level of persistence. Valid values
are APPLICATION_DEFINED , NONPERSISTENT ,
and PERSISTENT . |
|
priority | Specifies the level of priority. Valid values
are APPLICATION_DEFINED and SPECIFIED . |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
provider | Specifies the JMS driver implementation class for access to a specific vendor database. To create a pool of connections to that database, associate a data source with the JMS provider. |
|
providerType | Specifies the JMS provider type used by this JMS provider. |
|
specifiedExpiry | Specifies the time in milliseconds after which messages on this queue are discarded. |
|
specifiedPriority | Specifies the priority from 0 to 9 of the WASQueue WebSphere queue. |
|
Syntax
AdminJMS.createWASQueueUsingTemplateAtScope(scope,
jmsProvider, templateID, queueName,
jndiName, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createWASQueueUsingTemplateAtScope("myScope", "JMSTest",
"WASQueueTest", "queuejndi")
AdminJMS.createWASQueueUsingTemplateAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "Example.JMS.WAS.Q1(templates/system|JMS-resource-provider-templates.xml#WASQueue_1)",
"My WASQueue Name", "JNDIName", "category =myCategory, description='My description', expiry=SPECIFIED,
providerType=myProviderType, specifiedExpiry=1000, specifiedPriority=0")
The following example script includes optional attributes in a list format:
AdminJMS.createWASQueueUsingTemplateAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "Example.JMS.WAS.Q1(templates/system|JMS-resource-provider-templates.xml#WASQueue_1)",
"My WASQueue Name", "JNDIName", [['category ', 'myCategory'], ['description', 'My description'], ['expiry', 'SPECIFIED'],
['persistence', 'NONPERSISTENT'], ['priority', 'SPECIFIED'], ['propertySet', [['resourceProperties',
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'],
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'],
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]],
['providerType', 'myProviderType'], ['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )
createSIBJMSQueue
This script creates a JMS queue in your configuration at the scope that you specify. The script returns the configuration ID of the created SIB JMS queue.
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the JMS provider. |
name | Specifies the name of the JMS queue of interest. |
queueName | Specifies the name of the service integration bus destination to which the JMS queue maps. |
jndiName | Specifies the JNDI name that the system to bind the queue into the application server namespace. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description |
---|---|
description | Specifies a description of the SIB JMS queue. |
DeliveryMode | Specifies the delivery mode for messages. Valid
values are Application , NonPersistent ,
and Persistent . |
timeToLive | Specifies the time in milliseconds before a message expires. |
priority | Specifies the priority for messages. Valid values are integers from 0 to 9, inclusive. |
readAhead | Specifies the read-ahead value. Valid values
are Default , AlwaysOn , and AlwaysOff . |
busName | Specifies the name of the bus on which the queue resides. |
ScopeToLocalQP | Specifies whether the SIB queue destination is scoped to a local queue point when addressed using this JMS queue. |
ProducerBind | Specifies how JMS producers bind to queue points
of the clustered queue. A value of TRUE indicates
that a queue point is chosen when the session is opened and never
changes. A value of FALSE indicates that a queue
point is chosen every time a message is sent. |
ProducerPreferLocal | Specifies whether queue points local to the producer are used. |
GatherMessages | Specifies whether JMS consumers and browsers are given messages from any queue points, rather than from the single queue point to which they are attached. |
Syntax
AdminJMS.createSIBJMSQueue(scope,
name, queueName,
jndiName, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createSIBJMSQueue("myScope", "myName",
"SIBJMSQueueTest", "queuejndi")
AdminJMS.createSIBJMSQueue
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName7", "myQueueName7", "readAhead=AlwaysOff,timeToLive=9")
The following example script includes optional attributes in a list format:
AdminJMS.createSIBJMSQueue
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName7", "myQueueName7", [['readAhead', 'AlwaysOff'], ['timeToLive', '9']])
createWMQQueue
This script creates queue type destination for the WebSphere MQ messaging provider at the scope that you specify. The script returns the configuration ID of the created WebSphere MQ queue.
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the WebSphere MQ messaging provider. |
name | Specifies the name of the WebSphere MQ messaging provider queue type destination. |
queueName | Specifies the name of the WebSphere MQ queue to store messages for the queue type destination definition of the WebSphere MQ messaging provider. |
jndiName | Specifies the name used to bind this object into WebSphere Application Server JNDI. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description |
---|---|
ccsid | Specifies the coded character set identifier. |
decimalEncoding | Specifies the decimal encoding setting for this
queue. Valid values are Normal and Reversed . |
description | Specifies an administrative description to associate with this WebSphere MQ JMS queue type destination. |
expiry | Specifies the amount of time after which messages,
sent to this destination, expire and are dealt with based on their
disposition options. Valid values are APP , UNLIM ,
or any positive integer. |
floatingPointEncoding | Specifies the floating point encoding setting
for this queue. Valid values are IEEENormal , IEEEReversed and z/OS . |
integerEncoding | Specifies the integer encoding setting for this
queue. Valid values are Normal and Reversed . |
persistence | Specifies the level of persistence used to store
messages sent to this destination. Valid values are APP, QDEF,
PERS, NON or HIGH . |
priority | Specifies the priority level to assign to messages
sent to this destination. Valid values are APP, QDEF, 0, 1,
2, 3, 4, 5, 6, 7, 8, or 9 . |
qmgr | Specifies the queue manager on which the WebSphere MQ queue resides. |
readAheadClose | Specifies the behavior that occurs when closing
a message consumer that is receiving messages asynchronously. The
message consumer uses a message listener from a destination that has
the readAhead parameter set to true . When a value
of DELIVERALL is specified, the close method invocation
waits until all read-ahead messages are delivered to the consumer
before closing it. When a value of DELIVERCURRENT is
specified, then the close() method only waits for any in-progress
delivery to end before closing the consumer. Valid values are DELIVERALL and DELIVERCURRENT . |
readAhead | Specifies whether messages for non-persistent
consumers can be read ahead and cached. Valid values are YES,
NO or QDEF . |
sendAsync | Specifies whether messages can be sent to this
destination without requiring that the queue manager acknowledges
they have arrived. Valid values are YES, NO or QDEF . |
useRFH2 | Specifies whether an RFH version 2 header is
appended to messages sent to this destination. Valid values are true or false . |
useNativeEncoding | Specifies the native encoding settings for this queue. |
Syntax
AdminJMS.createWMQQueue(scope,
name, queueName,
jndiName, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createWMQQueue("myScope", "myName",
"WMQQueueTest", "queuejndi")
AdminJMS.createWMQQueue
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName8", "myQueueName8", "readAhead=YES,description=myDescription")
The following example script includes optional attributes in a list format:
AdminJMS.createWMQQueue
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName8", "myQueueName8", [['readAhead', 'YES'], ['description', 'myDescription']])
createWASQueueConnectionFactory
This script creates a WebSphere Application Server queue connection factory in your configuration. You should only use JMS resources for applications that perform messaging with a WebSphere Application Server version 5.1 embedded JMSServer in a Version 7.0 cell. The script returns the configuration ID of the created WebSphere Application Server queue connection factory in the respective cell.
To run the script, specify the node, server, JMS provider name, name to assign to the queue connection factory, and JNDI name arguments. You can optionally specify attributes. The arguments and attributes are defined in the following tables:
Argument | Description |
---|---|
nodeName | Specifies the name of the node of interest. |
serverName | Specifies the name of the server of interest. |
jmsProvider | Specifies the name of the JMS provider of interest. |
queueConnFactoryName | Specifies the name to assign to the new WebSphere Application Server queue connection factory. |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
XAEnabled | Specifies whether XA recovery processing is enabled. |
|
authDataAlias | Specifies the alias used for database authentication at runtime. |
|
authMechanismPreference | Specifies the authentication mechanism. Valid
values are BASIC_PASSWORD for basic authentication
and KERBEROS for Kerberos authentication. Do not put either of the values in quotes for the string format of the command. |
|
category | Specifies the category that can be used to classify or group the resource. |
|
connectionPool | Specifies the JMS connection pooling properties
for the parent JMS connection factory instance. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
description | Specifies a description of the resource adapter. |
|
diagnoseConnectionUsage | Specifies whether connection usage diagnosis is enabled. |
|
logMissingTransactionContext | Specifies whether missing transaction context logging is enabled. |
|
manageCachedHandles | Specifies whether this data source is used for
container-managed persistence of enterprise beans. The default value
is true . |
|
mapping | Specifies the mapping of the configuration login
to a specified authentication alias name. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
preTestConfig | Specifies the pretest connection configuration
settings. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
properties | Specifies either a typed property type or a
descriptive property type. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
provider | Specifies the JMS driver implementation class for access to a vendor database. To create a pool of connections to that database, associate a data source with the JMS provider. |
|
providerType | Specifies the JMS provider type used by this JMS provider. |
|
sessionPool | Specifies the JMS session pooling properties
for the parent JMS connection instance. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
xaRecoveryAuthAlias | Specifies the database authentication alias used during XA recovery processing. When this property is specified, the default value is the alias for application authentication. |
|
Syntax
AdminJMS.createWASQueueConnectionFactory(nodeName,
serverName, jmsProvider, queueConnFactoryName,
jndiName, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createWASQueueConnectionFactory("myNode", "myServer",
"JMSTest", "queueCFTest", "queuejndi")
AdminJMS.createWASQueueConnectionFactory("IBM-F4A849C57A0Node01", "server1",
"My JMS Provider Name1", "My WASQueue Name", "JNDIName", “XAEnabled=false,
authDataAlias=myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD, category=myCategory,
description='My description', diagnoseConnectionUsage=false, logMissingTransactionContext=true,
manageCachedHandles=true, providerType=myProviderType, xaRecoveryAuthAlias=myCellManager01/a1")
The following example script includes optional attributes in a list format:
AdminJMS.createWASQueueConnectionFactory("IBM-F4A849C57A0Node01", "server1",
"My JMS Provider Name1", "My WASQueue Name", "JNDIName", [['XAEnabled', 'false'],
['authDataAlias', 'myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'],
['category', 'myCategory'], ['connectionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'],
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'],
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'],
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'],
['validationExpression', ' '], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'],
['reapTime', '10000'], ['surgeCreationInterval', '10'], ['surgeThreshold', '10'],
['testConnection', 'true'], ['testConnectionInterval', '10'], ['unusedTimeout', '10000']]],
['description', 'My description'], ['diagnoseConnectionUsage', 'false'],
['logMissingTransactionContext', 'true'], ['manageCachedHandles', 'true'], ['mapping',
[['authDataAlias', 'authDataAliasValue'], ['mappingConfigAlias', 'mappingConfigAliasValue']]],
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]],
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'],
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', [['resourceProperties',
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'],
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'],
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]],
['providerType', 'myProviderType'], ['sessionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'],
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'],
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'],
['numberOfUnsharedPoolPartitions', '3'], ['properties', [[['description', 'My description'],
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]],
['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeThreshold', '10'], ['testConnection', 'true']]],
['xaRecoveryAuthAlias', 'myCellManager01/a1']] ))
createWASQueueConnectionFactoryUsingTemplate
This script uses a template to create a WebSphere Application Server queue connection factory in your configuration. You should only use JMS resources for applications that perform messaging with a WebSphere Application Server version 5.1 embedded JMSServer in a Version 7.0 cell. The script returns the configuration ID of the created WebSphere Application Server queue connection factory using a template in the respective cell.
Argument | Description |
---|---|
nodeName | Specifies the name of the node of interest. |
serverName | Specifies the name of the server of interest. |
jmsProvider | Specifies the name of the JMS provider of interest. |
templateID | Specifies the configuration ID of the WebSphere Application Server queue connection factory template to use. |
queueConnFactoryName | Specifies the name to assign to the new WebSphere Application Server queue connection factory. |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
XAEnabled | Specifies whether XA recovery processing is enabled. |
|
authDataAlias | Specifies the alias used for database authentication at runtime. |
|
authMechanismPreference | Specifies the authentication mechanism. Valid
values are BASIC_PASSWORD for basic authentication
and KERBEROS for Kerberos authentication. Do not put either of the values in quotes for the string format of the command. |
|
category | Specifies the category that can be used to classify or group the resource. |
|
connectionPool | Specifies the JMS connection pooling properties
for the parent JMS connection factory instance. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
description | Specifies a description of the resource adapter. |
|
diagnoseConnectionUsage | Specifies whether connection usage diagnosis is enabled. |
|
logMissingTransactionContext | Specifies whether missing transaction context logging is enabled. |
|
manageCachedHandles | Specifies whether this data source is used for
container-managed persistence of enterprise beans. The default value
is true . |
|
mapping | Specifies the mapping of the configuration login
to a specified authentication alias name. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
preTestConfig | Specifies the pretest connection configuration
settings. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
properties | Specifies either a typed property type or a
descriptive property type. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
provider | Specifies the JMS driver implementation class for access to a vendor database. To create a pool of connections to that database, associate a data source with the JMS provider. |
|
providerType | Specifies the JMS provider type used by this JMS provider. |
|
sessionPool | Specifies the JMS session pooling properties
for the parent JMS connection instance. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
xaRecoveryAuthAlias | Specifies the database authentication alias used during XA recovery processing. When this property is specified, the default value is the alias for application authentication. |
|
Syntax
AdminJMS.createWASQueueConnectionFactoryUsingTemplate(nodeName,
serverName, jmsProvider, templateID,
queueConnFactoryName, jndiName, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createWASQueueConnectionFactoryUsingTemplate("myNode", "myServer",
"JMSTest", "Example WAS
QueueConnectionFactory(templates/system|JMS-resource-provider-templates.xml#WASQueueConnectionFactory_1)",
"queueCFTest", "queuecfjndi")
AdminJMS.createWASQueueConnectionFactoryUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1",
"Example WAS QueueConnectionFactory(templates/system|JMS-resource-provider-templates.xml#WASQueueConnectionFactory_1)",
"My WASQueue Name", "JNDIName", “XAEnabled=false, authDataAlias=myAuthDataAlias,
authMechanismPreference=BASIC_PASSWORD, category=myCategory, description='My description',
diagnoseConnectionUsage=false, logMissingTransactionContext=true, manageCachedHandles=true,
providerType=myProviderType, xaRecoveryAuthAlias=myCellManager01/a1")
The following example script includes optional attributes in a list format:
AdminJMS.createWASQueueConnectionFactoryUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1",
"Example WAS QueueConnectionFactory(templates/system|JMS-resource-provider-templates.xml#WASQueueConnectionFactory_1)",
"My WASQueue Name", "JNDIName", [['XAEnabled', 'false'],['authDataAlias', 'myAuthDataAlias'],
['authMechanismPreference', 'BASIC_PASSWORD'], ['category', 'myCategory'], ['connectionPool',
[['agedTimeout', '100'], ['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10],
['maxConnections', '12'], ['minConnections', '5'], ['numberOfFreePoolPartitions', '3'],
['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], ['properties',
[[['description', 'My description'], ['name', 'myName'], ['required', 'false'],
['validationExpression', ' '], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'],
['reapTime', '10000'],['surgeCreationInterval', '10'], ['surgeThreshold', '10'],
['testConnection', 'true'], ['testConnectionInterval', '10'], ['unusedTimeout', '10000']]],
['description', 'My description'], ['diagnoseConnectionUsage', 'false'],
['logMissingTransactionContext', 'true'], ['manageCachedHandles', 'true'], ['mapping',
[['authDataAlias', 'authDataAliasValue'], ['mappingConfigAlias', 'mappingConfigAliasValue']]],
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]],
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'],
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', [['resourceProperties',
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'],
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'],
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]],
['providerType', 'myProviderType'], ['sessionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'],
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'],
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'],
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'],
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'],
['reapTime', '10000'], ['surgeThreshold', '10'], ['testConnection', 'true']]],
['xaRecoveryAuthAlias', 'myCellManager01/a1']] )
createWASQueueConnectionFactoryAtScope
This script creates a WebSphere Application Server queue connection factory in your configuration at the scope that you specify. You should only use JMS resources for applications that perform messaging with a WebSphere Application Server version 5.1 embedded JMSServer in a Version 7.0 cell. The script returns the configuration ID of the created WebSphere Application Server queue connection factory in the respective cell.
To run the script, specify the scope, JMS provider name, name to assign to the queue connection factory, and JNDI name arguments. You can optionally specify attributes. The arguments and attributes are defined in the following tables:
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the JMS provider. |
jmsProvider | Specifies the name of the JMS provider of interest. |
queueConnFactoryName | Specifies the name to assign to the new WebSphere Application Server queue connection factory. |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
XAEnabled | Specifies whether XA recovery processing is enabled. |
|
authDataAlias | Specifies the alias used for database authentication at runtime. |
|
authMechanismPreference | Specifies the authentication mechanism. Valid
values are BASIC_PASSWORD for basic authentication
and KERBEROS for Kerberos authentication. Do not put either of the values in quotes for the string format of the command. |
|
category | Specifies the category that can be used to classify or group the resource. |
|
connectionPool | Specifies the JMS connection pooling properties
for the parent JMS connection factory instance. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
description | Specifies a description of the resource adapter. |
|
diagnoseConnectionUsage | Specifies whether connection usage diagnosis is enabled. |
|
logMissingTransactionContext | Specifies whether missing transaction context logging is enabled. |
|
manageCachedHandles | Specifies whether this data source is used for
container-managed persistence of enterprise beans. The default value
is true . |
|
mapping | Specifies the mapping of the configuration login
to a specified authentication alias name. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
preTestConfig | Specifies the pretest connection configuration
settings. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
properties | Specifies either a typed property type or a
descriptive property type. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
provider | Specifies the JMS driver implementation class for access to a vendor database. To create a pool of connections to that database, associate a data source with the JMS provider. |
|
providerType | Specifies the JMS provider type used by this JMS provider. |
|
sessionPool | Specifies the JMS session pooling properties
for the parent JMS connection instance. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
xaRecoveryAuthAlias | Specifies the database authentication alias used during XA recovery processing. When this property is specified, the default value is the alias for application authentication. |
|
Syntax
AdminJMS.createWASQueueConnectionFactoryAtScope(scope,
jmsProvider, queueConnFactoryName,
jndiName, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createWASQueueConnectionFactoryAtScope("myScope",
"JMSTest", "queueCFTest", "queuejndi")
AdminJMS.createWASQueueConnectionFactoryAtScope
("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "My WASQueue Name", "JNDIName", “XAEnabled=false, authDataAlias=myAuthDataAlias,
authMechanismPreference=BASIC_PASSWORD, category=myCategory, description='My description', diagnoseConnectionUsage=false,
logMissingTransactionContext=true, manageCachedHandles=true, providerType=myProviderType,
xaRecoveryAuthAlias=myCellManager01/a1")
The following example script includes optional attributes in a list format:
AdminJMS.createWASQueueConnectionFactoryAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "My WASQueue Name", "JNDIName", [['XAEnabled', 'false'], ['authDataAlias', 'myAuthDataAlias'],
['authMechanismPreference', 'BASIC_PASSWORD'], ['category', 'myCategory'], ['connectionPool', [['agedTimeout', '100'],
['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'],
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'],
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], ['validationExpression', ' '],
['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeCreationInterval', '10'],
['surgeThreshold', '10'], ['testConnection', 'true'], ['testConnectionInterval', '10'], ['unusedTimeout', '10000']]],
['description', 'My description'], ['diagnoseConnectionUsage', 'false'], ['logMissingTransactionContext', 'true'],
['manageCachedHandles', 'true'], ['mapping', [['authDataAlias', 'authDataAliasValue'],
['mappingConfigAlias', 'mappingConfigAliasValue']]], ['preTestConfig', [['preTestConnection', 'true'],
['retryInterval', '12343'],
['retryLimit', '4']]], ['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'],
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', [['resourceProperties', [[['name', 'databaseName'],
['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'],
['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'],
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myProviderType'], ['sessionPool',
[['agedTimeout', '100'], ['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], ['maxConnections', '12'],
['minConnections', '5'], ['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'],
['numberOfUnsharedPoolPartitions', '3'], ['properties', [[['description', 'My description'], ['name', 'myName'],
['required', 'false'],
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], ['reapTime', '10000'],
['surgeThreshold', '10'], ['testConnection', 'true']]], ['xaRecoveryAuthAlias', 'myCellManager01/a1']] )
createWASQueueConnectionFactoryUsingTemplateAtScope
This script uses a template to create a WebSphere Application Server queue connection factory in your configuration at the scope that you specify. You should only use JMS resources for applications that perform messaging with a WebSphere Application Server version 5.1 embedded JMSServer in a Version 7.0 cell. The script returns the configuration ID of the created WebSphere Application Server queue connection factory using a template in the respective cell.
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the JMS provider. |
jmsProvider | Specifies the name of the JMS provider of interest. |
templateID | Specifies the configuration ID of the WebSphere Application Server queue connection factory template to use. |
queueConnFactoryName | Specifies the name to assign to the new WebSphere Application Server queue connection factory. |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
XAEnabled | Specifies whether XA recovery processing is enabled. |
|
authDataAlias | Specifies the alias used for database authentication at runtime. |
|
authMechanismPreference | Specifies the authentication mechanism. Valid
values are BASIC_PASSWORD for basic authentication
and KERBEROS for Kerberos authentication. Do not put either of the values in quotes for the string format of the command. |
|
category | Specifies the category that can be used to classify or group the resource. |
|
connectionPool | Specifies the JMS connection pooling properties
for the parent JMS connection factory instance. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
description | Specifies a description of the resource adapter. |
|
diagnoseConnectionUsage | Specifies whether connection usage diagnosis is enabled. |
|
logMissingTransactionContext | Specifies whether missing transaction context logging is enabled. |
|
manageCachedHandles | Specifies whether this data source is used for
container-managed persistence of enterprise beans. The default value
is true . |
|
mapping | Specifies the mapping of the configuration login
to a specified authentication alias name. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
preTestConfig | Specifies the pretest connection configuration
settings. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
properties | Specifies either a typed property type or a
descriptive property type. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
provider | Specifies the JMS driver implementation class for access to a vendor database. To create a pool of connections to that database, associate a data source with the JMS provider. |
|
providerType | Specifies the JMS provider type used by this JMS provider. |
|
sessionPool | Specifies the JMS session pooling properties
for the parent JMS connection instance. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
xaRecoveryAuthAlias | Specifies the database authentication alias used during XA recovery processing. When this property is specified, the default value is the alias for application authentication. |
|
Syntax
AdminJMS.createWASQueueConnectionFactoryUsingTemplateAtScope(scope,
jmsProvider, templateID,
queueConnFactoryName, jndiName, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createWASQueueConnectionFactoryUsingTemplateAtScope("myScope",
"JMSTest", "Example WAS
QueueConnectionFactory(templates/system|JMS-resource-provider-templates.xml#WASQueueConnectionFactory_1)",
"queueCFTest", "queuecfjndi")
AdminJMS.createWASQueueConnectionFactoryUsingTemplateAtScope
("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "Example WAS QueueConnectionFactory
(templates/system|JMS-resource-provider-templates.xml#WASQueueConnectionFactory_1)",
"My WASQueue Name", "JNDIName", “XAEnabled=false, authDataAlias=myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD,
category=myCategory, description='My description', diagnoseConnectionUsage=false, logMissingTransactionContext=true,
manageCachedHandles=true, providerType=myProviderType, xaRecoveryAuthAlias=myCellManager01/a1")
The following example script includes optional attributes in a list format:
AdminJMS.createWASQueueConnectionFactoryUsingTemplateAtScope
("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "Example WAS QueueConnectionFactory
(templates/system|JMS-resource-provider-templates.xml#WASQueueConnectionFactory_1)",
"My WASQueue Name", "JNDIName", [['XAEnabled', 'false'], ['authDataAlias', 'myAuthDataAlias'],
['authMechanismPreference', 'BASIC_PASSWORD'],
['category', 'myCategory'], ['connectionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'],
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'],
['numberOfFreePoolPartitions', '3'],
['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], ['properties',
[[['description', 'My description'],
['name', 'myName'], ['required', 'false'], ['validationExpression', ' '], ['value', 'myValue']]]],
['purgePolicy', 'EntirePool'],
['reapTime', '10000'], ['surgeCreationInterval', '10'], ['surgeThreshold', '10'], ['testConnection', 'true'],
['testConnectionInterval', '10'], ['unusedTimeout', '10000']]], ['description', 'My description'],
['diagnoseConnectionUsage', 'false'],
['logMissingTransactionContext','true'], ['manageCachedHandles', 'true'], ['mapping',
[['authDataAlias', 'authDataAliasValue'],
['mappingConfigAlias', 'mappingConfigAliasValue']]], ['preTestConfig', [['preTestConnection', 'true'],
['retryInterval', '12343'],
['retryLimit', '4']]], ['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'],
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', [['resourceProperties', [[['name', 'databaseName'],
['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'],
['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']],
[['name', 'portNumber'],
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myProviderType'], ['sessionPool',
[['agedTimeout', '100'],
['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'],
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'],
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'],
['validationExpression', ''],
['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeThreshold', '10'],
['testConnection', 'true']]],
['xaRecoveryAuthAlias', 'myCellManager01/a1']] )
createWASTopic
This script creates a WebSphere Application Server topic in your JMS configuration. You should only use JMS resources for applications that perform messaging with a WebSphere Application Server version 5.1 embedded JMSServer in a Version 7.0 cell. The script returns the configuration ID of the created WebSphere Application Server topic in the respective cell.
Argument | Description |
---|---|
nodeName | Specifies the name of the node of interest. |
serverName | Specifies the name of the server of interest. |
jmsProvider | Specifies the name of the JMS provider of interest. |
topicName | Specifies the name to assign to the new topic. |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
topic | Specifies the name of the topic (as a qualifier in the topic space) that this topic is to use. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
category | Specifies the category that can be used to classify or group the resource. |
|
description | Specifies a description of the resource adapter. |
|
expiry | Specifies the length of time after which messages
that are sent to this destination expire and are dealt with according
to their disposition options. Valid values are APPLICATION_DEFINE , SPECIFIED ,
and UNLIMITED . Do not put either of the values in quotes for the string format of the command. |
|
persistence | Specifies the level of persistence. Valid values
are APPLICATION_DEFINED , NONPERSISTENT ,
and PERSISTENT . |
|
priority | Specifies the level of priority. Valid values
are APPLICATION_DEFINED and SPECIFIED . |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
provider | Specifies the JMS driver implementation class for access to a specific vendor database. To create a pool of connections to that database, associate a data source with the JMS provider. |
|
providerType | Specifies the JMS provider type used by this JMS provider. |
|
specifiedExpiry | Specifies the time in milliseconds after which messages on this queue are discarded. |
|
specifiedPriority | Specifies the priority from 0 to 9 of the WASQueue WebSphere queue. |
|
Syntax
AdminJMS.createWASTopic(nodeName, serverName,
jmsProvider, topicName, jndiName, topic,
attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createWASTopic("myNode", "myServer", "JMSTest",
"TopicTest", "topicjndi", "mytopic")
AdminJMS.createWASTopic("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1",
"My WASTopic", "JNDIName", "A WAS Topic",” category=myCategory, description='My description',
expiry=SPECIFIED, persistence=PERSISTENT, priority=APPLICATION_DEFINED")
The following example script includes optional attributes in a list format:
AdminJMS.createWASTopic("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", "My WASTopic",
"JNDIName", "A WAS Topic", [['category', 'myCategory'], ['description', 'My description'],
['expiry', 'SPECIFIED'], ['persistence', 'PERSISTENT'], ['priority', 'APPLICATION_DEFINED'],
['propertySet', [['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'],
['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]],
[['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'],
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myProviderType'],
['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )
createWASTopicUsingTemplate
This script uses a template to create a WebSphere Application Server topic in your JMS configuration. You should only use JMS resources for applications that perform messaging with a WebSphere Application Server version 5.1 embedded JMSServer in a Version 7.0 cell. The script returns the configuration ID of the created WebSphere topic in the respective cell.
Argument | Description |
---|---|
nodeName | Specifies the name of the node of interest. |
serverName | Specifies the name of the server of interest. |
jmsProvider | Specifies the name of the JMS provider of interest. |
templateID | Specifies the configuration ID of the WebSphere Application Server topic template to use. |
topicName | Specifies the name to assign to the new topic. |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
topic | Specifies the name of the topic (as a qualifier in the topic space) that this topic is to use. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
category | Specifies the category that can be used to classify or group the resource. |
|
description | Specifies a description of the resource adapter. |
|
expiry | Specifies the length of time after which messages
that are sent to this destination expire and are dealt with according
to their disposition options. Valid values are APPLICATION_DEFINE , SPECIFIED ,
and UNLIMITED . Do not put either of the values in quotes for the string format of the command. |
|
persistence | Specifies the level of persistence. Valid values
are APPLICATION_DEFINED , NONPERSISTENT ,
and PERSISTENT . |
|
priority | Specifies the level of priority. Valid values
are APPLICATION_DEFINED and SPECIFIED . |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
provider | Specifies the JMS driver implementation class for access to a specific vendor database. To create a pool of connections to that database, associate a data source with the JMS provider. |
|
providerType | Specifies the JMS provider type used by this JMS provider. |
|
specifiedExpiry | Specifies the time in milliseconds after which messages on this queue are discarded. |
|
specifiedPriority | Specifies the priority from 0 to 9 of the WASQueue WebSphere queue. |
|
Syntax
AdminJMS.createWASTopicUsingTemplate(nodeName,
serverName, jmsProvider, templateID, topicName,
jndiName, topic, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createWASTopicUsingTemplate("myNode", "myServer", "JMSTest",
"Example.JMS.WAS.T1(templates/system|JMS-resource-provider-templates.xml#WASTopic_1)",
"TopicTest",
"topicjndi", "mytopic")
AdminJMS.createWASTopic("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1",
"My WASTopic", "JNDIName", "A WAS Topic",” category=myCategory, description='My description',
expiry=SPECIFIED, persistence=PERSISTENT, priority=APPLICATION_DEFINED”)
AdminJMS.createWASTopic("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", "My WASTopic",
"JNDIName", "A WAS Topic", [['category', 'myCategory'], ['description', 'My description'], [
'expiry', 'SPECIFIED'], ['persistence', 'PERSISTENT'], ['priority', 'APPLICATION_DEFINED'],
['propertySet', [['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'],
['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]],
[['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'],
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myProviderType'],
['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )
createWASTopicAtScope
This script creates a WebSphere Application Server topic in your JMS configuration at the scope that you specify. You should only use JMS resources for applications that perform messaging with a WebSphere Application Server version 5.1 embedded JMSServer in a Version 7.0 cell. The script returns the configuration ID of the created WebSphere Application Server topic in the respective cell.
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the JMS provider. |
jmsProvider | Specifies the name of the JMS provider of interest. |
topicName | Specifies the name to assign to the new topic. |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
topic | Specifies the name of the topic (as a qualifier in the topic space) that this topic is to use. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
category | Specifies the category that can be used to classify or group the resource. |
|
description | Specifies a description of the resource adapter. |
|
expiry | Specifies the length of time after which messages
that are sent to this destination expire and are dealt with according
to their disposition options. Valid values are APPLICATION_DEFINE , SPECIFIED ,
and UNLIMITED . Do not put either of the values in quotes for the string format of the command. |
|
persistence | Specifies the level of persistence. Valid values
are APPLICATION_DEFINED , NONPERSISTENT ,
and PERSISTENT . |
|
priority | Specifies the level of priority. Valid values
are APPLICATION_DEFINED and SPECIFIED . |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
provider | Specifies the JMS driver implementation class for access to a specific vendor database. To create a pool of connections to that database, associate a data source with the JMS provider. |
|
providerType | Specifies the JMS provider type used by this JMS provider. |
|
specifiedExpiry | Specifies the time in milliseconds after which messages on this queue are discarded. |
|
specifiedPriority | Specifies the priority from 0 to 9 of the WASQueue WebSphere queue. |
|
Syntax
AdminJMS.createWASTopicAtScope(scope,
jmsProvider, topicName, jndiName, topic,
attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createWASTopic("myScope", "JMSTest",
"TopicTest", "topicjndi", "mytopic")
AdminJMS.createWASTopicAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "My WASTopic", "JNDIName", "A WAS Topic", ” category=myCategory, description='My description',
expiry=SPECIFIED, persistence=PERSISTENT, priority=APPLICATION_DEFINED”)
The following example script includes optional attributes in a list format:
AdminJMS.createWASTopicAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "My WASTopic", "JNDIName", "A WAS Topic", [['category', 'myCategory'],
['description', 'My description'],
['expiry', 'SPECIFIED'], ['persistence', 'PERSISTENT'], ['priority', 'APPLICATION_DEFINED'], ['propertySet',
[['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']],
[['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'],
['type', 'java.lang.String'],
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]],
['providerType', 'myProviderType'], ['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )
createWASTopicUsingTemplateAtScope
This script uses a template to create a WebSphere Application Server topic in your JMS configuration at the scope that you specify. You should only use JMS resources for applications that perform messaging with a WebSphere Application Server version 5.1 embedded JMSServer in a Version 7.0 cell. The script returns the configuration ID of the created WebSphere topic in the respective cell.
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the JMS provider. |
jmsProvider | Specifies the name of the JMS provider of interest. |
templateID | Specifies the configuration ID of the WebSphere Application Server topic template to use. |
topicName | Specifies the name to assign to the new topic. |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
topic | Specifies the name of the topic (as a qualifier in the topic space) that this topic is to use. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
category | Specifies the category that can be used to classify or group the resource. |
|
description | Specifies a description of the resource adapter. |
|
expiry | Specifies the length of time after which messages
that are sent to this destination expire and are dealt with according
to their disposition options. Valid values are APPLICATION_DEFINE , SPECIFIED ,
and UNLIMITED . Do not put either of the values in quotes for the string format of the command. |
|
persistence | Specifies the level of persistence. Valid values
are APPLICATION_DEFINED , NONPERSISTENT ,
and PERSISTENT . |
|
priority | Specifies the level of priority. Valid values
are APPLICATION_DEFINED and SPECIFIED . |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
provider | Specifies the JMS driver implementation class for access to a specific vendor database. To create a pool of connections to that database, associate a data source with the JMS provider. |
|
providerType | Specifies the JMS provider type used by this JMS provider. |
|
specifiedExpiry | Specifies the time in milliseconds after which messages on this queue are discarded. |
|
specifiedPriority | Specifies the priority from 0 to 9 of the WASQueue WebSphere queue. |
|
Syntax
AdminJMS.createWASTopicUsingTemplateAtScope(scope,
jmsProvider, templateID, topicName,
jndiName, topic, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createWASTopicUsingTemplateAtScope("myScope", "JMSTest",
"Example.JMS.WAS.T1(templates/system|JMS-resource-provider-templates.xml#WASTopic_1)",
"TopicTest",
"topicjndi", "mytopic")
AdminJMS.createWASTopicUsingTemplateAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "Example.JMS.WAS.T1(templates/system|JMS-resource-provider-templates.xml#WASTopic_1)",
"My WASTopic", "JNDIName", "A WAS Topic", ” category=myCategory, description='My description', expiry=SPECIFIED,
persistence=PERSISTENT, priority=APPLICATION_DEFINED”)
AdminJMS.createWASTopicUsingTemplateAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "Example.JMS.WAS.T1(templates/system|JMS-resource-provider-templates.xml#WASTopic_1)",
"My WASTopic", "JNDIName", "A WAS Topic", [['category', 'myCategory'], ['description', 'My description'],
['expiry', 'SPECIFIED'], ['persistence', 'PERSISTENT'], ['priority', 'APPLICATION_DEFINED'], ['propertySet',
[['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']],
[['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'],
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]],
['providerType', 'myProviderType'], ['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )
createSIBJMSTopic
This script create a new JMS topic for the default messaging provider at the scope that you specify. The script returns the configuration ID of the created SIB JMS topic.
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the default messaging provider. |
name | Specifies the name to assign to the new topic. |
jndiName | Specifies the JNDI name that the system uses to bind this object into WebSphere Application Server JNDI. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description |
---|---|
description | Specifies a description of the SIB JMS topic. |
topicSpace | Specifies the name of the underlying SIB topic space to which the topic points. |
topicName | Specifies the topic used inside the topic space, for example, stock/IBM. |
deliveryMode | Specifies the delivery mode for messages. Valid
values are Application, NonPersistent, and Persistent . |
timeToLive | Specifies the time in milliseconds for message expiration. |
priority | Specifies the priority level to assign to messages
sent to this destination. Valid values are 0, 1, 2, 3, 4,
5, 6, 7, 8, or 9 . |
readAhead | Specifies the read-ahead value. Valid values
are AsConnection, AlwaysOn , and AlwaysOff . |
busName | The name of the bus on which the topic resides. |
Syntax
AdminJMS.createSIBJMSTopic(scope,
name,
jndiName, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createSIBJMSTopic("myScope", "myName", "myJNDIName")
AdminJMS.createSIBJMSTopic
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", "myName" ,
"myJndiName9", "readAhead=AlwaysOff,timeToLive=6")
AdminJMS.createSIBJMSTopic
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", "myName" ,
"myJndiName9", [['readAhead', 'AlwaysOff'], ['timeToLive', '6']])
createWMQTopic
This script creates a JMS topic destination for the WebSphere MQ messaging provider at the scope that you specify. The script returns the configuration ID of the created WebSphere MQ topic.
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the WebSphere MQ messaging provider. |
name | Specifies the name to assign to the new topic. |
jndiName | Specifies the JNDI name that the system uses to bind this object into WebSphere Application Server JNDI. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description |
---|---|
brokerCCDurSubQueue | Specifies the name of the queue from which a connection consumer receives durable subscription messages. |
brokerDurSubQueue | Specifies the name of the queue from which a connection consumer receives non-durable subscription messages. |
brokerPubQmgr | Specifies the name of the queue manager on which the broker is running. |
brokerPubQueue | Specifies the name of the queue to which publication messages are sent. |
brokerVersion | Specifies the level of functionality required for publish and subscribe operations. |
ccsid | Specifies the coded character set identifier. |
decimalEncoding | Specifies the decimal encoding setting for this
topic. Valid values are Normal and Reversed . |
description | Specifies an administrative description to associate with this WebSphere MQ JMS topic type destination. |
expiry | Specifies the amount of time after which messages,
sent to this destination, expire and are dealt with based on their
disposition options. Valid values are APP , UNLIM ,
or any positive integer. |
floatingPointEncoding | Specifies the floating point encoding setting
for this topic. Valid values are IEEENormal , IEEEReversed and z/OS . |
integerEncoding | Specifies the integer encoding setting for this
topic. Valid values are Normal and Reversed . |
persistence | Specifies the level of persistence used to store
messages sent to this destination. Valid values are APP, TDEF,
PERS, NON or HIGH . |
priority | Specifies the priority level to assign to messages
sent to this destination. Valid values are APP, TDEF, 0, 1,
2, 3, 4, 5, 6, 7, 8, or 9 . |
readAheadClose | Specifies the behavior that occurs when closing
a message consumer that is receiving messages asynchronously. The
message consumer uses a message listener from a destination that has
the readAhead parameter set to true . When a value
of DELIVERALL is specified, the close method invocation
waits until all read-ahead messages are delivered to the consumer
before closing it. When a value of DELIVERCURRENT is
specified, then the close() method only waits for any in-progress
delivery to end before closing the consumer. Valid values are DELIVERALL and DELIVERCURRENT . |
readAhead | Specifies whether messages for non-persistent
consumers can be read ahead and cached. Valid values are YES,
NO or TDEF . |
sendAsync | Specifies whether messages can be sent to this
destination without requiring that the queue manager acknowledges
they have arrived. Valid values are YES, NO or TDEF . |
useRFH2 | Specifies whether an RFH version 2 header is
appended to messages sent to this destination. Valid values are true or false . |
useNativeEncoding | Specifies the native encoding settings for this topic. |
wildcardFormat | Specifies which sets of characters are interpreted as topic wild cards. |
Syntax
AdminJMS.createWMQTopic(scope,
name,
jndiName, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createWMQTopic("myScope", "myName", "myJNDIName")
AdminJMS.createWMQTopic
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName10", "myTopicName10", "readAhead=YES,sendAsync=NO")
AdminJMS.createWMQTopic
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName10", "myTopicName10", [['readAhead', 'YES'], ['sendAsync', 'NO']])
createWASTopicConnectionFactory
This script creates a WebSphere Application Server topic connection factory in your configuration. You should only use JMS resources for applications that perform messaging with a WebSphere Application Server version 5.1 embedded JMSServer in a Version 7.0 cell. The script returns the configuration ID of the created WebSphere Application Server topic connection factory in the respective cell.
Argument | Description |
---|---|
nodeName | Specifies the name of the node of interest. |
serverName | Specifies the name of the server of interest. |
jmsProviderName | Specifies the name of the JMS provider of interest. |
topicConnFactoryName | Specifies the name to assign to the new connection factory. |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
port | Specify the port of interest. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
XAEnabled | Specifies whether XA recovery processing is enabled. |
|
authDataAlias | Specifies the alias used for database authentication at runtime. |
|
authMechanismPreference | Specifies the authentication mechanism. Valid
values are BASIC_PASSWORD for basic authentication
and KERBEROS for Kerberos authentication. Do not put either of the values in quotes for the string format of the command. |
|
category | Specifies the category that can be used to classify or group the resource. |
|
connectionPool | Specifies the JMS connection pooling properties
for the parent JMS connection factory instance. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
description | Specifies a description of the resource adapter. |
|
diagnoseConnectionUsage | Specifies whether connection usage diagnosis is enabled. |
|
logMissingTransactionContext | Specifies whether missing transaction context logging is enabled. |
|
manageCachedHandles | Specifies whether this data source is used for
container-managed persistence of enterprise beans. The default value
is true . |
|
mapping | Specifies the mapping of the configuration login
to a specified authentication alias name. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
preTestConfig | Specifies the pretest connection configuration
settings. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
properties | Specifies either a typed property type or a
descriptive property type. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
provider | Specifies the JMS driver implementation class for access to a vendor database. To create a pool of connections to that database, associate a data source with the JMS provider. |
|
providerType | Specifies the JMS provider type used by this JMS provider. |
|
sessionPool | Specifies the JMS session pooling properties
for the parent JMS connection instance. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
xaRecoveryAuthAlias | Specifies the database authentication alias used during XA recovery processing. When this property is specified, the default value is the alias for application authentication. |
|
Attributes | Description | Example |
---|---|---|
clientID | Specifies the client ID. |
|
cloneSupport | Specifies whether the WebSphere topic connection factory is supported across clones. |
|
Syntax
AdminJMS.createWASTopicConnectionFactory(nodeName,
serverName, jmsProviderName, topicConnFactoryName,
jndiName, port, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createWASTopicConnectionFactory("myNode", "myServer",
"JMSTest", "TopicCFTest", "topiccfjndi", "DIRECT")
AdminJMS.createWASTopicConnectionFactory("IBM-F4A849C57A0Node01", "server1",
"My JMS Provider Name1", "My WASTopicConnectionFactory", "JNDIName", "DIRECT", “XAEnabled=false,
authDataAlias=myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD, category=myCategory,
clientID=myClientID, cloneSupport=true, description='My description', diagnoseConnectionUsage=false,
logMissingTransactionContext=true, manageCachedHandles=true, providerType=myProviderType,
xaRecoveryAuthAlias=myCellManager01/a1")
The following example script includes optional attributes in a list format:
AdminJMS.createWASTopicConnectionFactory("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1",
"My WASTopicConnectionFactory", "JNDIName", "DIRECT", [['XAEnabled', 'false'],
['authDataAlias', 'myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'],
['category', 'myCategory'], ['clientID', 'myClientID'], ['cloneSupport', 'true'],
['connectionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'],
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'],
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'],
['numberOfUnsharedPoolPartitions', '3'], ['properties', [[['description', 'My description'],
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]],
['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeThreshold', '10'],
['testConnection', 'true']]], ['description', 'My description'], ['diagnoseConnectionUsage', 'false'],
['logMissingTransactionContext', 'true'], ['manageCachedHandles', 'true'], ['mapping',
[['authDataAlias', 'authDataAliasValue'], ['mappingConfigAlias', 'mappingConfigAliasValue']]],
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]],
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'],
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', [['resourceProperties',
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']],
[['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'],
['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'],
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myProviderType'], ['sessionPool',
[['agedTimeout', '100'], ['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10],
['maxConnections', '12'], ['minConnections', '5'], ['numberOfFreePoolPartitions', '3'],
['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], ['properties',
[[['description', 'My description'], ['name', 'myName'], ['required', 'false'],
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'],
['reapTime', '10000'], ['surgeThreshold', '10'], ['testConnection', 'true']]],
['xaRecoveryAuthAlias', 'myCellManager01/a1']] )
createWASTopicConnectionFactoryUsingTemplate
This script uses a template to create a WebSphere Application Server topic connection factory in your configuration. You should only use JMS resources for applications that perform messaging with a WebSphere Application Server version 5.1 embedded JMS Server in a Version 7.0 cell. The script returns the configuration ID of the created WebSphere topic using a template in the respective cell.
Argument | Description |
---|---|
nodeName | Specifies the name of the node of interest. |
serverName | Specifies the name of the server of interest. |
jmsProviderName | Specifies the name of the JMS provider of interest. |
templateID | Specifies the configuration ID of the WebSphere Application Server topic connection factory to use. |
topicConnFactoryName | Specifies the name to assign to the new connection factory. |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
port | Specifies the port of interest. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
XAEnabled | Specifies whether XA recovery processing is enabled. |
|
authDataAlias | Specifies the alias used for database authentication at runtime. |
|
authMechanismPreference | Specifies the authentication mechanism. Valid
values are BASIC_PASSWORD for basic authentication
and KERBEROS for Kerberos authentication. Do not put either of the values in quotes for the string format of the command. |
|
category | Specifies the category that can be used to classify or group the resource. |
|
connectionPool | Specifies the JMS connection pooling properties
for the parent JMS connection factory instance. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
description | Specifies a description of the resource adapter. |
|
diagnoseConnectionUsage | Specifies whether connection usage diagnosis is enabled. |
|
logMissingTransactionContext | Specifies whether missing transaction context logging is enabled. |
|
manageCachedHandles | Specifies whether this data source is used for
container-managed persistence of enterprise beans. The default value
is true . |
|
mapping | Specifies the mapping of the configuration login
to a specified authentication alias name. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
preTestConfig | Specifies the pretest connection configuration
settings. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
properties | Specifies either a typed property type or a
descriptive property type. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
provider | Specifies the JMS driver implementation class for access to a vendor database. To create a pool of connections to that database, associate a data source with the JMS provider. |
|
providerType | Specifies the JMS provider type used by this JMS provider. |
|
sessionPool | Specifies the JMS session pooling properties
for the parent JMS connection instance. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
xaRecoveryAuthAlias | Specifies the database authentication alias used during XA recovery processing. When this property is specified, the default value is the alias for application authentication. |
|
Attributes | Description | Example |
---|---|---|
type | Specifies QUEUE for queues, TOPIC for
topics, and UNIFIED for both queues and topics. Do not put either of the values in quotes for the string format of the command. |
|
Syntax
AdminJMS.createWASTopicConnectionFactoryUsingTemplate(nodeName,
serverName, jmsProviderName, templateID,
topicConnFactoryName, jndiName, port, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createWASTopicConnectionFactoryUsingTemplate("myNode", "myServer",
"JMSTest", "First Example WAS
TopicConnectionFactory(templates/system|JMS-resource-provider-templates.xml#WASTopicConnectionFactory_1)",
"TopicCFTest", "topiccfjndi", "DIRECT")
AdminJMS.createWASTopicConnectionFactoryUsingTemplate
("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1",
"First Example WAS TopicConnectionFactory
(templates/system|JMS-resource-provider-templates.xml#WASTopicConnectionFactory_1)",
"My WASTopicConnectionFactory", "JNDIName", "DIRECT", “XAEnabled=false, authDataAlias=myAuthDataAlias,
authMechanismPreference=BASIC_PASSWORD, category=myCategory, clientID=myClientID, cloneSupport=true,
description='My description', diagnoseConnectionUsage=false, logMissingTransactionContext=true,
manageCachedHandles=true, providerType=myProviderType, xaRecoveryAuthAlias=myCellManager01/a1")
The following example script includes optional attributes in a list format:
AdminJMS.createWASTopicConnectionFactoryUsingTemplate
("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1",
"First Example WAS TopicConnectionFactory
(templates/system|JMS-resource-provider-templates.xml#WASTopicConnectionFactory_1)",
"My WASTopicConnectionFactory", "JNDIName", "'DIRECT'", [['XAEnabled', 'false'],
['authDataAlias', 'myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'],
['category', 'myCategory'], ['clientID', 'myClientID'], ['cloneSupport', 'true'],
['connectionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'],
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'],
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'],
['numberOfUnsharedPoolPartitions', '3'], ['properties', [[['description', 'My description'],
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]],
['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeThreshold', '10'],
['testConnection', 'true']]], ['description', 'My description'], ['diagnoseConnectionUsage', 'false'],
['logMissingTransactionContext', 'true'], ['manageCachedHandles', 'true'], ['mapping',
[['authDataAlias', 'authDataAliasValue'], ['mappingConfigAlias', 'mappingConfigAliasValue']]],
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]],
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'],
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', [['resourceProperties',
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'],
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'],
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]],
['providerType', 'myProviderType'], ['sessionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'],
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'],
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'],
['numberOfUnsharedPoolPartitions', '3'], ['properties', [[['description', 'My description'],
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]],
['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeThreshold', '10'],
['testConnection', 'true']]], ['xaRecoveryAuthAlias', 'myCellManager01/a1']] )
createWASTopicConnectionFactoryAtScope
This script creates a WebSphere Application Server topic connection factory in your configuration at the scope that you specify. You should only use JMS resources for applications that perform messaging with a WebSphere Application Server version 5.1 embedded JMSServer in a Version 7.0 cell. The script returns the configuration ID of the created WebSphere Application Server topic connection factory in the respective cell.
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the JMS provider. |
jmsProviderName | Specifies the name of the JMS provider of interest. |
topicConnFactoryName | Specifies the name to assign to the new connection factory. |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
port | Specify the port of interest. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
type | Specifies QUEUE for queues, TOPIC for
topics, and UNIFIED for both queues and topics. Do not put either of the values in quotes for the string format of the command. |
|
Syntax
AdminJMS.createWASTopicConnectionFactoryAtScope(scope,
jmsProviderName, topicConnFactoryName,
jndiName, port, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createWASTopicConnectionFactoryAtScope("myScope",
"JMSTest", "TopicCFTest", "topiccfjndi", "DIRECT")
AdminJMS.createWASTopicConnectionFactoryAtScope
("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "My WASTopicConnectionFactory", "JNDIName", "DIRECT", “XAEnabled=false,
authDataAlias=myAuthDataAlias,
authMechanismPreference=BASIC_PASSWORD, category=myCategory, clientID=myClientID, cloneSupport=true,
description='My description',
diagnoseConnectionUsage=false, logMissingTransactionContext=true, manageCachedHandles=true,
providerType=myProviderType,
xaRecoveryAuthAlias=myCellManager01/a1")
The following example script includes optional attributes in a list format:
AdminJMS.createWASTopicConnectionFactoryAtScope
("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "My WASTopicConnectionFactory", "JNDIName", "'DIRECT'", [['XAEnabled', 'false'],
['authDataAlias', 'myAuthDataAlias'], ['authMechanismPreference','BASIC_PASSWORD'], ['category', 'myCategory'],
['clientID', 'myClientID'], ['cloneSupport', 'true'], ['connectionPool', [['agedTimeout', '100'],
['connectionTimeout', '1000'],
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'],
['numberOfFreePoolPartitions', '3'],
['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], ['properties',
[[['description', 'My description'],
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]],
['purgePolicy', 'EntirePool'],
['reapTime', '10000'], ['surgeThreshold', '10'], ['testConnection', 'true']]],
['description', 'My description'],
['diagnoseConnectionUsage', 'false'], ['logMissingTransactionContext', 'true'],
['manageCachedHandles', 'true'],
['mapping', [['authDataAlias', 'authDataAliasValue'], ['mappingConfigAlias', 'mappingConfigAliasValue']]],
['preTestConfig',
[['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]], ['properties',
[[['description', 'My description'],
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]], ['propertySet',
[['resourceProperties', [[['name','databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']],
[['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'],
['type', 'java.lang.String'],
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]],
['providerType', 'myProviderType'], ['sessionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'],
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'],
['numberOfFreePoolPartitions', '3'],
['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], ['properties',
[[['description', 'My description'],
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]],
['purgePolicy', 'EntirePool'],
['reapTime', '10000'], ['surgeThreshold', '10'], ['testConnection', 'true']]],
['xaRecoveryAuthAlias','myCellManager01/a1']] )
createWASTopicConnectionFactoryUsingTemplateAtScope
This script uses a template to create a WebSphere Application Server topic connection factory in your configuration at the scope that you specify. You should only use JMS resources for applications that perform messaging with a WebSphere Application Server version 5.1 embedded JMS Server in a Version 7.0 cell. The script returns the configuration ID of the created WebSphere topic using a template in the respective cell.
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the JMS provider. |
jmsProviderName | Specifies the name of the JMS provider of interest. |
templateID | Specifies the configuration ID of the WebSphere Application Server topic connection factory to use. |
topicConnFactoryName | Specifies the name to assign to the new connection factory. |
jndiName | Specifies the JNDI name that the system uses to bind the connection factory into the name space. |
port | Specifies the port of interest. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description | Example |
---|---|---|
XAEnabled | Specifies whether XA recovery processing is enabled. |
|
authDataAlias | Specifies the alias used for database authentication at runtime. |
|
authMechanismPreference | Specifies the authentication mechanism. Valid
values are BASIC_PASSWORD for basic authentication
and KERBEROS for Kerberos authentication. Do not put either of the values in quotes for the string format of the command. |
|
category | Specifies the category that can be used to classify or group the resource. |
|
connectionPool | Specifies the JMS connection pooling properties
for the parent JMS connection factory instance. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
description | Specifies a description of the resource adapter. |
|
diagnoseConnectionUsage | Specifies whether connection usage diagnosis is enabled. |
|
logMissingTransactionContext | Specifies whether missing transaction context logging is enabled. |
|
manageCachedHandles | Specifies whether this data source is used for
container-managed persistence of enterprise beans. The default value
is true . |
|
mapping | Specifies the mapping of the configuration login
to a specified authentication alias name. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
preTestConfig | Specifies the pretest connection configuration
settings. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
properties | Specifies either a typed property type or a
descriptive property type. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
propertySet | Optionally specifies resource properties in
the following format: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]...
[[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
provider | Specifies the JMS driver implementation class for access to a vendor database. To create a pool of connections to that database, associate a data source with the JMS provider. |
|
providerType | Specifies the JMS provider type used by this JMS provider. |
|
sessionPool | Specifies the JMS session pooling properties
for the parent JMS connection instance. When you use this attribute in a script, use the list format. The string format does not work because this attribute is a configuration object type. |
|
xaRecoveryAuthAlias | Specifies the database authentication alias used during XA recovery processing. When this property is specified, the default value is the alias for application authentication. |
|
Attributes | Description | Example |
---|---|---|
type | Specifies QUEUE for queues, TOPIC for
topics, and UNIFIED for both queues and topics. Do not put either of the values in quotes for the string format of the command. |
|
Syntax
AdminJMS.createWASTopicConnectionFactoryUsingTemplateAtScope(scope,
jmsProviderName, templateID,
topicConnFactoryName, jndiName, port, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createWASTopicConnectionFactoryUsingTemplateAtScope("myScope",
"JMSTest", "First Example WAS
TopicConnectionFactory(templates/system|JMS-resource-provider-templates.xml#WASTopicConnectionFactory_1)",
"TopicCFTest", "topiccfjndi", "DIRECT")
AdminJMS.createWASTopicConnectionFactoryUsingTemplateAtScope
("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "First Example WAS TopicConnectionFactory
(templates/system|JMS-resource-provider-templates.xml#WASTopicConnectionFactory_1)",
"My WASTopicConnectionFactory", "JNDIName", "DIRECT", “XAEnabled=false, authDataAlias=myAuthDataAlias,
authMechanismPreference=BASIC_PASSWORD,
category=myCategory, clientID=myClientID, cloneSupport=true, description='My description',
diagnoseConnectionUsage=false,
logMissingTransactionContext=true, manageCachedHandles=true, providerType=myProviderType,
xaRecoveryAuthAlias=myCellManager01/a1”)
The following example script includes optional attributes in a list format:
AdminJMS.createWASTopicConnectionFactoryUsingTemplateAtScope
("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"My JMS Provider Name1", "First Example WAS TopicConnectionFactory
(templates/system|JMS-resource-provider-templates.xml#WASTopicConnectionFactory_1)",
"My WASTopicConnectionFactory", "JNDIName", "'DIRECT'", [['XAEnabled', 'false'],
['authDataAlias', 'myAuthDataAlias'],
['authMechanismPreference', 'BASIC_PASSWORD'], ['category', 'myCategory'], ['clientID', 'myClientID'],
['cloneSupport', 'true'],
['connectionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10],
['maxConnections', '12'], ['minConnections', '5'], ['numberOfFreePoolPartitions', '3'],
['numberOfSharedPoolPartitions', '6'],
['numberOfUnsharedPoolPartitions', '3'], ['properties', [[['description', 'My description'],
['name', 'myName'], ['required', 'false'],
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'],
['reapTime', '10000'], ['surgeThreshold', '10'],
['testConnection', 'true']]], ['description', 'My description'], ['diagnoseConnectionUsage', 'false'],
['logMissingTransactionContext', 'true'],
['manageCachedHandles', 'true'], ['mapping', [['authDataAlias', 'authDataAliasValue'],
['mappingConfigAlias', 'mappingConfigAliasValue']]],
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]],
['properties', [[['description', 'My description'],
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]],
['propertySet',
[['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']],
[['name', 'driverType'],
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'],
['value', 'localhost']],
[['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myProviderType'],
['sessionPool',
[['agedTimeout', '100'], ['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10],
['maxConnections', '12'],
['minConnections', '5'], ['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'],
['numberOfUnsharedPoolPartitions', '3'],
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'],
['validationExpression', ''],
['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeThreshold', '10'],
['testConnection', 'true']]],
['xaRecoveryAuthAlias', 'myCellManager01/a1']] )
createSIBJMSConnectionFactory
The script creates a new SIB JMS connection factory for the default messaging provider at the scope that you specify. The script returns the configuration ID of the created SIB JMS connection factory.
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the JMS provider. |
name | Specifies the administrative name assigned to this connection factory. |
jndiName | Specifies the JNDI name that is specified in the bindings for message-driven beans associated with this connection factory. |
busName | Specifies the name of the service integration bus to which connections are made. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description |
---|---|
authDataAlias | Specifies a user ID and password to be used to authenticate connections to the JMS provider for application-managed authentication. |
containerAuthAlias | Specifies a container managed authentication alias, from which security credentials are used to establish a connection to the JMS provider. |
mappingAlias | Specifies the Java Authentication and Authorization Service (JAAS) mapping alias to use when determining the security related credentials. The security related credentials are used when establishing a connection to the JMS provider. |
xaRecoveryAuthAlias | Specifies the authentication alias used during XA recovery processing. |
category | Specifies the category that can be used to classify or group the connection factory |
description | Specifies a description of the connection factory. |
logMissingTransactionContext | Specifies whether missing transaction context logging is enabled. |
manageCachedHandles | Specifies whether cached handles , which are handles held in instance variables in a bean, are tracked by the container |
clientID | Specifies the client ID which is required only for durable subscriptions. |
userName | Specifies the user name that is used to create connections from the connection factory. |
password | Specifies the password that is used to create connections from the connection factory. |
nonPersistentMapping | Specifies a non-persistent mapping value. Valid
values are BestEffortNonPersistent , ExpressNonPersistent , ReliableNonPersistent , ReliablePersistent , AssuredPersistent , AsSIBDestination ,
and None . |
persistentMapping | Specifies a persistent mapping value. Valid
values are BestEffortNonPersistent , ExpressNonPersistent , ReliableNonPersistent , ReliablePersistent , AssuredPersistent , AsSIBDestination and None . |
durableSubscriptionHome | Specifies the durable subscription home value. |
readAhead | Specifies the read-ahead value. Valid values
are Default , AlwaysOn , and AlwaysOff . |
target | Specifies the name of a target that resolves to a group of messaging engines. |
targetType | Specifies the type of the name in the target
parameter. Valid values are BusMember , Custom ,
and ME . |
targetSignificance | Specifies the significance of the target group.
Valid values are Preferred and Required . |
targetTransportChain | Specifies the name of the protocol that to connect to a remote messaging engine. |
providerEndPoints | Specifies a comma-separated list of endpoint triplets of the form host:port:chain. |
connectionProximity | Specifies the proximity of acceptable messaging
engines. Valid values are Bus , Host , Cluster ,
and Server . |
tempQueueNamePrefix | Specifies a temporary queue name prefix. |
tempTopicNamePrefix | Specifies a temporary topic name prefix. |
shareDataSourceWithCMP | Specifies how to control data sources that are shared. |
shareDurableSubscriptions | Specifies how to control durable subscriptions
that are shared. Valid values are InCluster , AlwaysShared ,
and NeverShared . |
consumerDoesNotModifyPayloadAfterGet | Specifies that when a message consuming application
receives object or byte messages, the system serializes the message
data only when necessary. The application is connected to the bus
using this connection factory. Applications that obtain the data from
these messages must treat the data as read-only data. Valid values
are true and false . The default
value is false . |
producerDoesNotModifyPayloadAfterSet | Specifies that when a message consuming application
sends object or byte messages, the data is not copied and the system
serializes the data only when necessary. The application is connected
to the bus using this connection factory. Applications sending such
messages must not modify the data after it has been set in a message.
Valid values are true and false .
The default value is false . |
Syntax
AdminJMS.createSIBJMSConnectionFactory(scope,
name, jndiName,
busName, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createSIBJMSConnectionFactory("myScope", "myName", "myJNDIName",
"MyBusName")
AdminJMS.createWMQConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName2", "readAhead=AlwaysOff,description=my description")
The following example script includes optional attributes in a list format:
AdminJMS.createSIBJMSConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", "myName"
, "myJndiName1", "myBusName", [['readAhead', 'AlwaysOff'], ['description', 'my description']])
createWMQConnectionFactory
The script creates a connection factory for the WebSphere MQ messaging provider at the scope that you specify. The script returns the configuration ID of the created WebSphere MQ connection factory.
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the JMS provider. |
name | Specifies the administrative name assigned to this WebSphere MQ messaging provider connection factory. |
jndiName | Specifies the name and location used to bind this object into WebSphere Application Server JNDI. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description |
---|---|
maxBatchSize | Specifies the maximum number of messages to take from a queue in one packet when using asynchronous message delivery. |
brokerCCSubQueue | Specifies the name of the queue from which non-durable subscription messages are retrieved for a connection consumer. This parameter is valid only for topic connection factories. |
brokerCtrlQueue | Specifies the broker control queue to use if this connection factory is to subscribe to a topic. This parameter is valid only for topic connection factories. |
brokerQmgr | Specifies the name of the queue manager on which the queue manager is running. This parameter is valid only for topic connection factories. |
brokerSubQueue | Specifies the queue for obtaining subscription messages if this connection factory subscribes to a topic. This parameter is valid only for topic connection factories. |
brokerVersion | Specifies the level of functionality required for publish and subscribe operations. This parameter is valid only for topic connection factories. |
brokerPubQueue | Specifies the queue to send publication messages to when using queue based brokering. This parameter is valid only for topic connection factories. |
ccdtQmgrName | Specifies a queue manager name that is used to select one or more entries from a client channel definition table. |
ccdtUrl | Specifies a URL to a client channel definition table. Use this attribute for this connection factory, when contacting the WebSphere MQ messaging provider. Connection factories created using this attribute are ccdtURL connection factories. |
ccsid | Specifies the coded character set ID to use on connections. |
cleanupInterval | Specifies the interval between background executions of the publish and subscribe cleanup utility. This parameter is valid only for topic connection factories. |
cleanupLevel | Specifies the cleanup Level for BROKER or MIGRATE subscription stores. This parameter is valid only for topic connection factories. |
clientId | Specifies the client identifier used for connections started using this connection factory. |
clonedSubs | Specifies whether two or more instances of the same durable topic subscriber can run simultaneously. This parameter is valid only for topic connection factories. |
compressHeaders | Determines if message headers are compressed or not. |
compressPayload | Determines if message payloads are compressed or not. |
containerAuthAlias | Specifies a container managed authentication alias that has security credentials that are used for establishing a connection to the WebSphere MQ messaging provider. |
description | Specifies a description of the connection factory. |
failIfQuiescing | Specifies the behavior of certain calls to the queue manager when the queue manager is put into a quiescent state. |
localAddress | Specifies either or both of the following items:
|
mappingAlias | Specifies the JAAS mapping alias to use when determining the security related credentials. The security related credentials are used when establishing a connection to the WebSphere MQ. |
modelQueue | Specifies the WebSphere MQ model queue definition to use as a basis when creating JMS temporary destinations. This parameter is valid only for queue connection factories. |
msgRetention | Specifies whether the connection consumer keeps
unwanted messages on the input queue. A value of true means
that it does. A value of false means that the messages
are disposed of based on their disposition options. This parameter
is valid only for queue connection factories. |
msgSelection | Specifies where message selection occurs. This parameter is valid only for topic connection factories. |
pollingInterval | Specifies in milliseconds the maximum time that elapses during a polling interval. If a message listener within a session has no suitable message on its queue, the message listener uses the polling interval to determine how often to poll its queue for a message. Increase the value for this property if sessions frequently do not have a suitable message available. This attribute is applicable only in the client container. |
providerVersion | Specifies the minimum version and capabilities of the queue manager. |
pubAckInterval | Specifies the number of publications to send to a queue based broker before sending a publication which solicits an acknowledgement. This attribute is valid only for topic connection factories. |
qmgrHostname | Specifies the hostname that this connection factory uses when attempting a client mode connection to WebSphere MQ. |
qmgrName | Specifies the queue manager name that this connection factory uses when contacting the WebSphere MQ messaging provider. Connection factories created using this parameter are user-defined connection factories. |
qmgrPortNumber | Specifies the port number that this connection factory uses when attempting a client mode connection to WebSphere MQ. |
qmgrSvrconnChannel | Specifies the SVRCONN channel to use when connecting to WebSphere MQ. Connection factories created using this parameter are user-defined connection factories. |
rcvExitInitData | Specifies initialization data to pass to the receive exit. |
rcvExit | Specifies a comma separated list of receive exit class names. |
replyWithRFH2 | Specifies whether, when replying to a message, an RFH version 2 header is included in the reply message. This parameter is valid only for queue connection factories. |
rescanInterval | Specifies in milliseconds the maximum time that elapses during a scanning interval. When a message consumer in the point-to-point domain uses a message selector to select which messages it wants to receive, the WebSphere MQ JMS client searches the WebSphere MQ queue for suitable messages in the sequence determined by the MsgDeliverySequence attribute of the queue. When the client finds a suitable message and delivers it to the consumer, the client resumes the search for the next suitable message from its current position in the queue. The client continues to search the queue until it reaches the end of the queue, or until the interval of time specified by this property has expired. In each case, the client returns to the beginning of the queue to continue its search, and a new time interval starts. This parameter is only valid for queue connection factories. |
secExitInitData | Specifies initialization data to pass to the security exit. |
secExit | Specifies a comma separated list of security exit class names. |
sendExitInitData | Specifies initialization data to pass to the send exit. |
sendExit | Specifies a comma separated list of send exit class names. |
sparseSubs | Specifies the message retrieval policy of a TopicSubscriber object. This parameter is only valid for topic connection factories. |
sslConfiguration | Specifies a specific Secure Sockets Layer (SSL) configuration to secure network connections to the queue manager. |
sslCrl | Specifies a list of LDAP servers which can be used to provide certificate revocation information if this connection factory establishes an SSL connection to WebSphere MQ. |
sslPeerName | Specifies a peer name to match against the distinguished name in the peer certificate. This attribute is used when the connection factory establishes an SSL connection to the queue manager. |
sslResetCount | Specifies the number of bytes to transfer before resetting the symmetric encryption key used for the SSL session. This attribute is used when the connection factory establishes an SSL connection to the queue manager. |
sslType | Specifies the configuration, if any, when the connection factory establishes an SSL connection to the queue manager. |
stateRefreshInt | Specifies in milliseconds the maximum time that
elapses between refreshes of the long running transaction that detects
when a subscriber loses its connection to the queue manager. This
property is relevant only if subStore attribute has the value QUEUE .
This attribute is valid only for topic connection factories. |
subStore | Specifies that WebSphere MQ JMS stores persistent data relating to active subscriptions. This attribute is valid only for topic connection factories. |
support2PCProtocol | Specifies whether the connection factory acts as a resource which is capable of participating in distributed two phase commit processing. |
tempQueuePrefix | Specifies the prefix to apply to WebSphere MQ temporary queues. These temporary queues represent JMS temporary queue type destinations. This attribute is valid only for queue connection factories. |
tempTopicPrefix | Specifies the prefix to apply to WebSphere MQ temporary topics. These temporary topics represent JMS temporary topic type destinations. This attribute is valid only for topic connection factories. |
wildcardFormat | Specifies which sets of characters are interpreted as topic wild cards. This attribute is valid only for topic connection factories. |
wmqTransportType | Specifies how this connection factory connects
to WebSphere MQ. Connection
factories created using this attribute are user-defined. Valid values
are BINDINGS , BINDINGS_THEN_CLIENT ,
and CLIENT . |
xaRecoveryAuthAlias | Specifies the authentication alias to connect to WebSphere MQ for XA recovery. |
Syntax
AdminJMS.createWMQConnectionFactory(scope,
name, jndiName,
attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createWMQConnectionFactory("myScope", "myName", "myJNDIName")
AdminJMS.createWMQConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName2", "maxBatchSize=15,description=my description")
The following example script includes optional attributes in a list format:
AdminJMS.createWMQConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName2", [['maxBatchSize', '15'], ['description', 'my description']])
createSIBJMSQueueConnectionFactory
The script creates a new SIB JMS queue connection factory for the default messaging provider at the scope that you specify. The script returns the configuration ID of the created SIB JMS queue connection factory.
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the JMS provider. |
name | Specifies the administrative name assigned to this connection factory. |
jndiName | Specifies the JNDI name that is specified in the bindings for message-driven beans associated with this connection factory. |
busName | Specifies the name of the service integration bus to which connections are made. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description |
---|---|
authDataAlias | Specifies a user ID and password to be used to authenticate connections to the JMS provider for application-managed authentication. |
containerAuthAlias | Specifies a container managed authentication alias, from which security credentials are used to establish a connection to the JMS provider. |
mappingAlias | Specifies the Java Authentication and Authorization Service (JAAS) mapping alias to use when determining the security related credentials. The security related credentials are used when establishing a connection to the JMS provider. |
xaRecoveryAuthAlias | Specifies the authentication alias used during XA recovery processing. |
category | Specifies the category that can be used to classify or group the connection factory |
description | Specifies a description of the connection factory. |
logMissingTransactionContext | Specifies whether missing transaction context logging is enabled. |
manageCachedHandles | Specifies whether cached handles , which are handles held in instance variables in a bean, are tracked by the container |
clientID | Specifies the client ID which is required only for durable subscriptions. |
userName | Specifies the user name that is used to create connections from the connection factory. |
password | Specifies the password that is used to create connections from the connection factory. |
nonPersistentMapping | Specifies a non-persistent mapping value. Valid
values are BestEffortNonPersistent , ExpressNonPersistent , ReliableNonPersistent , ReliablePersistent , AssuredPersistent , AsSIBDestination ,
and None . |
persistentMapping | Specifies a persistent mapping value. Valid
values are BestEffortNonPersistent , ExpressNonPersistent , ReliableNonPersistent , ReliablePersistent , AssuredPersistent , AsSIBDestination and None . |
durableSubscriptionHome | Specifies the durable subscription home value. |
readAhead | Specifies the read-ahead value. Valid values
are Default , AlwaysOn , and AlwaysOff . |
target | Specifies the name of a target that resolves to a group of messaging engines. |
targetType | Specifies the type of the name in the target
parameter. Valid values are BusMember , Custom ,
and ME . |
targetSignificance | Specifies the significance of the target group.
Valid values are Preferred and Required . |
targetTransportChain | Specifies the name of the protocol that to connect to a remote messaging engine. |
providerEndPoints | Specifies a comma-separated list of endpoint triplets of the form host:port:chain. |
connectionProximity | Specifies the proximity of acceptable messaging
engines. Valid values are Bus , Host , Cluster ,
and Server . |
tempQueueNamePrefix | Specifies a temporary queue name prefix. |
tempTopicNamePrefix | Specifies a temporary topic name prefix. |
shareDataSourceWithCMP | Specifies how to control data sources that are shared. |
shareDurableSubscriptions | Specifies how to control durable subscriptions
that are shared. Valid values are InCluster , AlwaysShared ,
and NeverShared . |
consumerDoesNotModifyPayloadAfterGet | Specifies that when a message consuming application
receives object or byte messages, the system serializes the message
data only when necessary. The application is connected to the bus
using this connection factory. Applications that obtain the data from
these messages must treat the data as read-only data. Valid values
are true and false . The default
value is false . |
producerDoesNotModifyPayloadAfterSet | Specifies that when a message consuming application
sends object or byte messages, the data is not copied and the system
serializes the data only when necessary. The application is connected
to the bus using this connection factory. Applications sending such
messages must not modify the data after it has been set in a message.
Valid values are true and false .
The default value is false . |
Syntax
AdminJMS.createSIBJMSQueueConnectionFactory(scope,
name, jndiName,
busName, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createSIBJMSQueueConnectionFactory("myScope", "myName", "myJNDIName",
"MyBusName")
AdminJMS.createSIBJMSQueueConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", "myName" ,
"myJndiName3", "myBusName", "readAhead=AlwaysOff,description=my description")
The following example script includes optional attributes in a list format:
AdminJMS.createSIBJMSQueueConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", "myName" ,
"myJndiName3", "myBusName", [['readAhead', 'AlwaysOff'], ['description', 'my description']])
createWMQQueueConnectionFactory
The script creates a queue connection factory for the WebSphere MQ messaging provider at the scope that you specify. The script returns the configuration ID of the created WebSphere MQ queue connection factory.
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the JMS provider. |
name | Specifies the administrative name assigned to this WebSphere MQ messaging provider connection factory. |
jndiName | Specifies the name and location used to bind this object into WebSphere Application Server JNDI. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description |
---|---|
maxBatchSize | Specifies the maximum number of messages to take from a queue in one packet when using asynchronous message delivery. |
brokerCCSubQueue | Specifies the name of the queue from which non-durable subscription messages are retrieved for a connection consumer. This parameter is valid only for topic connection factories. |
brokerCtrlQueue | Specifies the broker control queue to use if this connection factory is to subscribe to a topic. This parameter is valid only for topic connection factories. |
brokerQmgr | Specifies the name of the queue manager on which the queue manager is running. This parameter is valid only for topic connection factories. |
brokerSubQueue | Specifies the queue for obtaining subscription messages if this connection factory subscribes to a topic. This parameter is valid only for topic connection factories. |
brokerVersion | Specifies the level of functionality required for publish and subscribe operations. This parameter is valid only for topic connection factories. |
brokerPubQueue | Specifies the queue to send publication messages to when using queue based brokering. This parameter is valid only for topic connection factories. |
ccdtQmgrName | Specifies a queue manager name that is used to select one or more entries from a client channel definition table. |
ccdtUrl | Specifies a URL to a client channel definition table. Use this attribute for this connection factory, when contacting the WebSphere MQ messaging provider. Connection factories created using this attribute are ccdtURL connection factories. |
ccsid | Specifies the coded character set ID to use on connections. |
cleanupInterval | Specifies the interval between background executions of the publish and subscribe cleanup utility. This parameter is valid only for topic connection factories. |
cleanupLevel | Specifies the cleanup Level for BROKER or MIGRATE subscription stores. This parameter is valid only for topic connection factories. |
clientId | Specifies the client identifier used for connections started using this connection factory. |
clonedSubs | Specifies whether two or more instances of the same durable topic subscriber can run simultaneously. This parameter is valid only for topic connection factories. |
compressHeaders | Determines if message headers are compressed or not. |
compressPayload | Determines if message payloads are compressed or not. |
containerAuthAlias | Specifies a container managed authentication alias that has security credentials that are used for establishing a connection to the WebSphere MQ messaging provider. |
description | Specifies a description of the connection factory. |
failIfQuiescing | Specifies the behavior of certain calls to the queue manager when the queue manager is put into a quiescent state. |
localAddress | Specifies either or both of the following items:
|
mappingAlias | Specifies the JAAS mapping alias to use when determining the security related credentials. The security related credentials are used when establishing a connection to the WebSphere MQ. |
modelQueue | Specifies the WebSphere MQ model queue definition to use as a basis when creating JMS temporary destinations. This parameter is valid only for queue connection factories. |
msgRetention | Specifies whether the connection consumer keeps
unwanted messages on the input queue. A value of true means
that it does. A value of false means that the messages
are disposed of based on their disposition options. This parameter
is valid only for queue connection factories. |
msgSelection | Specifies where message selection occurs. This parameter is valid only for topic connection factories. |
pollingInterval | Specifies in milliseconds the maximum time that elapses during a polling interval. If a message listener within a session has no suitable message on its queue, the message listener uses the polling interval to determine how often to poll its queue for a message. Increase the value for this property if sessions frequently do not have a suitable message available. This attribute is applicable only in the client container. |
providerVersion | Specifies the minimum version and capabilities of the queue manager. |
pubAckInterval | Specifies the number of publications to send to a queue based broker before sending a publication which solicits an acknowledgement. This attribute is valid only for topic connection factories. |
qmgrHostname | Specifies the hostname that this connection factory uses when attempting a client mode connection to WebSphere MQ. |
qmgrName | Specifies the queue manager name that this connection factory uses when contacting the WebSphere MQ messaging provider. Connection factories created using this parameter are user-defined connection factories. |
qmgrPortNumber | Specifies the port number that this connection factory uses when attempting a client mode connection to WebSphere MQ. |
qmgrSvrconnChannel | Specifies the SVRCONN channel to use when connecting to WebSphere MQ. Connection factories created using this parameter are user-defined connection factories. |
rcvExitInitData | Specifies initialization data to pass to the receive exit. |
rcvExit | Specifies a comma separated list of receive exit class names. |
replyWithRFH2 | Specifies whether, when replying to a message, an RFH version 2 header is included in the reply message. This parameter is valid only for queue connection factories. |
rescanInterval | Specifies in milliseconds the maximum time that elapses during a scanning interval. When a message consumer in the point-to-point domain uses a message selector to select which messages it wants to receive, the WebSphere MQ JMS client searches the WebSphere MQ queue for suitable messages in the sequence determined by the MsgDeliverySequence attribute of the queue. When the client finds a suitable message and delivers it to the consumer, the client resumes the search for the next suitable message from its current position in the queue. The client continues to search the queue until it reaches the end of the queue, or until the interval of time specified by this property has expired. In each case, the client returns to the beginning of the queue to continue its search, and a new time interval starts. This parameter is only valid for queue connection factories. |
secExitInitData | Specifies initialization data to pass to the security exit. |
secExit | Specifies a comma separated list of security exit class names. |
sendExitInitData | Specifies initialization data to pass to the send exit. |
sendExit | Specifies a comma separated list of send exit class names. |
sparseSubs | Specifies the message retrieval policy of a TopicSubscriber object. This parameter is only valid for topic connection factories. |
sslConfiguration | Specifies a specific Secure Sockets Layer (SSL) configuration to secure network connections to the queue manager. |
sslCrl | Specifies a list of LDAP servers which can be used to provide certificate revocation information if this connection factory establishes an SSL connection to WebSphere MQ. |
sslPeerName | Specifies a peer name to match against the distinguished name in the peer certificate. This attribute is used when the connection factory establishes an SSL connection to the queue manager. |
sslResetCount | Specifies the number of bytes to transfer before resetting the symmetric encryption key used for the SSL session. This attribute is used when the connection factory establishes an SSL connection to the queue manager. |
sslType | Specifies the configuration, if any, when the connection factory establishes an SSL connection to the queue manager. |
stateRefreshInt | Specifies in milliseconds the maximum time that
elapses between refreshes of the long running transaction that detects
when a subscriber loses its connection to the queue manager. This
property is relevant only if subStore attribute has the value QUEUE .
This attribute is valid only for topic connection factories. |
subStore | Specifies that WebSphere MQ JMS stores persistent data relating to active subscriptions. This attribute is valid only for topic connection factories. |
support2PCProtocol | Specifies whether the connection factory acts as a resource which is capable of participating in distributed two phase commit processing. |
tempQueuePrefix | Specifies the prefix to apply to WebSphere MQ temporary queues. These temporary queues represent JMS temporary queue type destinations. This attribute is valid only for queue connection factories. |
tempTopicPrefix | Specifies the prefix to apply to WebSphere MQ temporary topics. These temporary topics represent JMS temporary topic type destinations. This attribute is valid only for topic connection factories. |
wildcardFormat | Specifies which sets of characters are interpreted as topic wild cards. This attribute is valid only for topic connection factories. |
wmqTransportType | Specifies how this connection factory connects
to WebSphere MQ. Connection
factories created using this attribute are user-defined. Valid values
are BINDINGS , BINDINGS_THEN_CLIENT ,
and CLIENT . |
xaRecoveryAuthAlias | Specifies the authentication alias to connect to WebSphere MQ for XA recovery. |
Syntax
AdminJMS.createWMQQueueConnectionFactory(scope,
name, jndiName,
attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createWMQQueueConnectionFactory("myScope", "myName", "myJNDIName")
AdminJMS.createWMQQueueConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", "myName
" , "myJndiName4", "maxBatchSize=15,description=my description")
The following example script includes optional attributes in a list format:
AdminJMS.createWMQQueueConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName4", [['maxBatchSize', '15'], ['description', 'my description']])
createSIBJMSTopicConnectionFactory
The script creates a new SIB JMS topic connection factory for the default messaging provider at the scope that you specify. The script returns the configuration ID of the created SIB JMS topic connection factory.
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the JMS provider. |
name | Specifies the administrative name assigned to this connection factory. |
jndiName | Specifies the JNDI name that is specified in the bindings for message-driven beans associated with this connection factory. |
busName | Specifies the name of the service integration bus to which connections are made. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description |
---|---|
authDataAlias | Specifies a user ID and password to be used to authenticate connections to the JMS provider for application-managed authentication. |
containerAuthAlias | Specifies a container managed authentication alias, from which security credentials are used to establish a connection to the JMS provider. |
mappingAlias | Specifies the Java Authentication and Authorization Service (JAAS) mapping alias to use when determining the security related credentials. The security related credentials are used when establishing a connection to the JMS provider. |
xaRecoveryAuthAlias | Specifies the authentication alias used during XA recovery processing. |
category | Specifies the category that can be used to classify or group the connection factory |
description | Specifies a description of the connection factory. |
logMissingTransactionContext | Specifies whether missing transaction context logging is enabled. |
manageCachedHandles | Specifies whether cached handles , which are handles held in instance variables in a bean, are tracked by the container |
clientID | Specifies the client ID which is required only for durable subscriptions. |
userName | Specifies the user name that is used to create connections from the connection factory. |
password | Specifies the password that is used to create connections from the connection factory. |
nonPersistentMapping | Specifies a non-persistent mapping value. Valid
values are BestEffortNonPersistent , ExpressNonPersistent , ReliableNonPersistent , ReliablePersistent , AssuredPersistent , AsSIBDestination ,
and None . |
persistentMapping | Specifies a persistent mapping value. Valid
values are BestEffortNonPersistent , ExpressNonPersistent , ReliableNonPersistent , ReliablePersistent , AssuredPersistent , AsSIBDestination and None . |
durableSubscriptionHome | Specifies the durable subscription home value. |
readAhead | Specifies the read-ahead value. Valid values
are Default , AlwaysOn , and AlwaysOff . |
target | Specifies the name of a target that resolves to a group of messaging engines. |
targetType | Specifies the type of the name in the target
parameter. Valid values are BusMember , Custom ,
and ME . |
targetSignificance | Specifies the significance of the target group.
Valid values are Preferred and Required . |
targetTransportChain | Specifies the name of the protocol that to connect to a remote messaging engine. |
providerEndPoints | Specifies a comma-separated list of endpoint triplets of the form host:port:chain. |
connectionProximity | Specifies the proximity of acceptable messaging
engines. Valid values are Bus , Host , Cluster ,
and Server . |
tempQueueNamePrefix | Specifies a temporary queue name prefix. |
tempTopicNamePrefix | Specifies a temporary topic name prefix. |
shareDataSourceWithCMP | Specifies how to control data sources that are shared. |
shareDurableSubscriptions | Specifies how to control durable subscriptions
that are shared. Valid values are InCluster , AlwaysShared ,
and NeverShared . |
consumerDoesNotModifyPayloadAfterGet | Specifies that when a message consuming application
receives object or byte messages, the system serializes the message
data only when necessary. The application is connected to the bus
using this connection factory. Applications that obtain the data from
these messages must treat the data as read-only data. Valid values
are true and false . The default
value is false . |
producerDoesNotModifyPayloadAfterSet | Specifies that when a message consuming application
sends object or byte messages, the data is not copied and the system
serializes the data only when necessary. The application is connected
to the bus using this connection factory. Applications sending such
messages must not modify the data after it has been set in a message.
Valid values are true and false .
The default value is false . |
Syntax
AdminJMS.createSIBJMSTopicConnectionFactory(scope,
name, jndiName,
busName, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createSIBJMSTopicConnectionFactory("myScope", "myName", "myJNDIName",
"MyBusName")
AdminJMS.createSIBJMSTopicConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName5", "myBusName", "readAhead=AlwaysOff,description=my description")
The following example script includes optional attributes in a list format:
AdminJMS.createSIBJMSTopicConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName5", "myBusName", [['readAhead', 'AlwaysOff'], ['description', 'my description']])
createWMQTopicConnectionFactory
The script creates a topic connection factory for the WebSphere MQ messaging provider at the scope that you specify. The script returns the configuration ID of the created WebSphere MQ topic connection factory.
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the JMS provider. |
name | Specifies the administrative name assigned to this WebSphere MQ messaging provider connection factory. |
jndiName | Specifies the name and location used to bind this object into WebSphere Application Server JNDI. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description |
---|---|
maxBatchSize | Specifies the maximum number of messages to take from a queue in one packet when using asynchronous message delivery. |
brokerCCSubQueue | Specifies the name of the queue from which non-durable subscription messages are retrieved for a connection consumer. This parameter is valid only for topic connection factories. |
brokerCtrlQueue | Specifies the broker control queue to use if this connection factory is to subscribe to a topic. This parameter is valid only for topic connection factories. |
brokerQmgr | Specifies the name of the queue manager on which the queue manager is running. This parameter is valid only for topic connection factories. |
brokerSubQueue | Specifies the queue for obtaining subscription messages if this connection factory subscribes to a topic. This parameter is valid only for topic connection factories. |
brokerVersion | Specifies the level of functionality required for publish and subscribe operations. This parameter is valid only for topic connection factories. |
brokerPubQueue | Specifies the queue to send publication messages to when using queue based brokering. This parameter is valid only for topic connection factories. |
ccdtQmgrName | Specifies a queue manager name that is used to select one or more entries from a client channel definition table. |
ccdtUrl | Specifies a URL to a client channel definition table. Use this attribute for this connection factory, when contacting the WebSphere MQ messaging provider. Connection factories created using this attribute are ccdtURL connection factories. |
ccsid | Specifies the coded character set ID to use on connections. |
cleanupInterval | Specifies the interval between background executions of the publish and subscribe cleanup utility. This parameter is valid only for topic connection factories. |
cleanupLevel | Specifies the cleanup Level for BROKER or MIGRATE subscription stores. This parameter is valid only for topic connection factories. |
clientId | Specifies the client identifier used for connections started using this connection factory. |
clonedSubs | Specifies whether two or more instances of the same durable topic subscriber can run simultaneously. This parameter is valid only for topic connection factories. |
compressHeaders | Determines if message headers are compressed or not. |
compressPayload | Determines if message payloads are compressed or not. |
containerAuthAlias | Specifies a container managed authentication alias that has security credentials that are used for establishing a connection to the WebSphere MQ messaging provider. |
description | Specifies a description of the connection factory. |
failIfQuiescing | Specifies the behavior of certain calls to the queue manager when the queue manager is put into a quiescent state. |
localAddress | Specifies either or both of the following items:
|
mappingAlias | Specifies the JAAS mapping alias to use when determining the security related credentials. The security related credentials are used when establishing a connection to the WebSphere MQ. |
modelQueue | Specifies the WebSphere MQ model queue definition to use as a basis when creating JMS temporary destinations. This parameter is valid only for queue connection factories. |
msgRetention | Specifies whether the connection consumer keeps
unwanted messages on the input queue. A value of true means
that it does. A value of false means that the messages
are disposed of based on their disposition options. This parameter
is valid only for queue connection factories. |
msgSelection | Specifies where message selection occurs. This parameter is valid only for topic connection factories. |
pollingInterval | Specifies in milliseconds the maximum time that elapses during a polling interval. If a message listener within a session has no suitable message on its queue, the message listener uses the polling interval to determine how often to poll its queue for a message. Increase the value for this property if sessions frequently do not have a suitable message available. This attribute is applicable only in the client container. |
providerVersion | Specifies the minimum version and capabilities of the queue manager. |
pubAckInterval | Specifies the number of publications to send to a queue based broker before sending a publication which solicits an acknowledgement. This attribute is valid only for topic connection factories. |
qmgrHostname | Specifies the hostname that this connection factory uses when attempting a client mode connection to WebSphere MQ. |
qmgrName | Specifies the queue manager name that this connection factory uses when contacting the WebSphere MQ messaging provider. Connection factories created using this parameter are user-defined connection factories. |
qmgrPortNumber | Specifies the port number that this connection factory uses when attempting a client mode connection to WebSphere MQ. |
qmgrSvrconnChannel | Specifies the SVRCONN channel to use when connecting to WebSphere MQ. Connection factories created using this parameter are user-defined connection factories. |
rcvExitInitData | Specifies initialization data to pass to the receive exit. |
rcvExit | Specifies a comma separated list of receive exit class names. |
replyWithRFH2 | Specifies whether, when replying to a message, an RFH version 2 header is included in the reply message. This parameter is valid only for queue connection factories. |
rescanInterval | Specifies in milliseconds the maximum time that elapses during a scanning interval. When a message consumer in the point-to-point domain uses a message selector to select which messages it wants to receive, the WebSphere MQ JMS client searches the WebSphere MQ queue for suitable messages in the sequence determined by the MsgDeliverySequence attribute of the queue. When the client finds a suitable message and delivers it to the consumer, the client resumes the search for the next suitable message from its current position in the queue. The client continues to search the queue until it reaches the end of the queue, or until the interval of time specified by this property has expired. In each case, the client returns to the beginning of the queue to continue its search, and a new time interval starts. This parameter is only valid for queue connection factories. |
secExitInitData | Specifies initialization data to pass to the security exit. |
secExit | Specifies a comma separated list of security exit class names. |
sendExitInitData | Specifies initialization data to pass to the send exit. |
sendExit | Specifies a comma separated list of send exit class names. |
sparseSubs | Specifies the message retrieval policy of a TopicSubscriber object. This parameter is only valid for topic connection factories. |
sslConfiguration | Specifies a specific Secure Sockets Layer (SSL) configuration to secure network connections to the queue manager. |
sslCrl | Specifies a list of LDAP servers which can be used to provide certificate revocation information if this connection factory establishes an SSL connection to WebSphere MQ. |
sslPeerName | Specifies a peer name to match against the distinguished name in the peer certificate. This attribute is used when the connection factory establishes an SSL connection to the queue manager. |
sslResetCount | Specifies the number of bytes to transfer before resetting the symmetric encryption key used for the SSL session. This attribute is used when the connection factory establishes an SSL connection to the queue manager. |
sslType | Specifies the configuration, if any, when the connection factory establishes an SSL connection to the queue manager. |
stateRefreshInt | Specifies in milliseconds the maximum time that
elapses between refreshes of the long running transaction that detects
when a subscriber loses its connection to the queue manager. This
property is relevant only if subStore attribute has the value QUEUE .
This attribute is valid only for topic connection factories. |
subStore | Specifies that WebSphere MQ JMS stores persistent data relating to active subscriptions. This attribute is valid only for topic connection factories. |
support2PCProtocol | Specifies whether the connection factory acts as a resource which is capable of participating in distributed two phase commit processing. |
tempQueuePrefix | Specifies the prefix to apply to WebSphere MQ temporary queues. These temporary queues represent JMS temporary queue type destinations. This attribute is valid only for queue connection factories. |
tempTopicPrefix | Specifies the prefix to apply to WebSphere MQ temporary topics. These temporary topics represent JMS temporary topic type destinations. This attribute is valid only for topic connection factories. |
wildcardFormat | Specifies which sets of characters are interpreted as topic wild cards. This attribute is valid only for topic connection factories. |
wmqTransportType | Specifies how this connection factory connects
to WebSphere MQ. Connection
factories created using this attribute are user-defined. Valid values
are BINDINGS , BINDINGS_THEN_CLIENT ,
and CLIENT . |
xaRecoveryAuthAlias | Specifies the authentication alias to connect to WebSphere MQ for XA recovery. |
Syntax
AdminJMS.createWMQTopicConnectionFactory(scope,
name, jndiName,
attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createWMQTopicConnectionFactory("myScope", "myName", "myJNDIName")
AdminJMS.createWMQTopicConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName6", "maxBatchSize=15,description=my description")
The following example script includes optional attributes in a list format:
AdminJMS.createWMQTopicConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName6", [['maxBatchSize', '15'], ['description', 'my description']])
createSIBJMSActivationSpec
This script creates a new JMS activation specification for the default messaging provider at the scope that you specify. The script returns the configuration ID of the created SIB JMS activation specification.
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the default messaging provider at which the JMS activation specification is to be created. |
name | Specifies the name assigned to this activation specification. |
jndiName | Specifies the JNDI name that is specified in the bindings for message-driven beans associated with this activation specification. |
destinationJndiName | Specifies the JNDI name of the destination JMS queue or topic that the message-driven bean uses. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description |
---|---|
description | Specifies the JMS activation specification that the default messaging provider uses to validate the activation-configuration properties for a JMS message-driven bean (MDB). |
acknowledgeMode | Specifies how the session acknowledges any messages it receives. |
authenticationAlias | Specifies the name of a J2C authentication alias used for component-managed authentication of connections to the service integration bus. |
busName | Name of the service integration bus to which connections are made. |
clientId | Specifies the JMS client identifier. The client identifier is required for durable topic subscriptions. |
destinationType | Specifies whether the message-driven bean uses a queue or topic destination. |
durableSubscriptionHome | Specifies the name of the durable subscription home. This attribute identifies the messaging engine where all durable subscriptions accessed through this activation specification are managed. |
maxBatchSize | Specifies the maximum number of messages received from the messaging engine in a single batch. |
maxConcurrency | Specifies the maximum number of endpoints to which messages are delivered concurrently. |
messageSelector | Specifies the JMS message selector used to determine which messages the message-driven bean (MDB) receives. |
password | Specifies the password for Java 2 connector security to use. |
subscriptionDurability | Specifies whether a JMS topic subscription is durable or nondurable. |
subscriptionName | Specifies the subscription name needed for durable topic subscriptions. |
shareDurableSubscriptions | Specifies how durable subscriptions are shared. |
userName | Specifies the user identify for the Java 2 connector security to use. |
readAhead | Specifies the read-ahead value. Valid values
are Default , AlwaysOn , and AlwaysOff . |
target | Specifies the new target value of the SIB JMS activation specification. |
targetType | Specifies the new target value of the SIB JMS
activation specification. Valid values are BusMember, Custom ,
and ME . |
targetSignificance | Specifies the significance of the target group. |
targetTransportChain | Specifies the name of the protocol that used to connect to a remote messaging engine. |
providerEndPoints | Specifies a comma-separated list of endpoint triplets of the form host:port:chain. |
shareDataSourceWithCMP | Specifies how data sources are shared. |
consumerDoesNotModifyPayloadAfterGet | Specifies, when enabled, that object messages
received through this activation specification only have their message
data serialized by the system when necessary. Applications that obtain
data from these messages must be treated as read-only. Valid values
are true and false . The default
is false . |
forwarderDoesNotModifyPayloadAfterSet | Specifies, when enabled, that object or byte
messages forwarded through this activation specification that have
their payload modified will not have the data copied when the data
is sent in the message. The system serializes the message data only
when necessary. Applications sending such messages must not modify
the data after they send it in the message. Valid values are true and false .
The default is false . |
alwaysActivateAllMDBs | Specifies the MDB server-selection rule. The
rule determines which servers can drive MDBs deployed to them. Valid
values are true and false . The default
is false . Specify true to activate
MDBs in all servers. Otherwise, only servers with a running messaging
engine are used. |
retryInterval | Specifies the delay in seconds between attempts
to connect to a messaging engine, both for the initial connection
and for any subsequent attempts to establish a better connection.
The default is 30 . The delay must be greater than
zero. |
autoStopSequentialMessageFailure | Specifies that the endpoint is stopped when the number of sequentially failing messages reaches the configured limit. Due to processing dependencies in the MDB, the actual number of messages processed might exceed this value. |
failingMessageDelay | Specifies the period of time that passes before a message can be retried. A message is retried when the MDB fails to process it, but the message has not reached its maximum failed delivery limit. Other messages can be tried during this period, unless the sequential failure threshold and the maximum concurrency are set to 1. |
Syntax
AdminJMS.createSIBJMSActivationSpec(scope,
name, jndiName,
destinationJndiName, attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createSIBJMSActivationSpec("myScope", "myName",
"myJNDIName", "myDestinationName")
AdminJMS.createSIBJMSActivationSpec(
"server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName11", "myDestinationJndiName11", "readAhead=AlwaysOff,maxBatchSize=54")
The following example script includes optional attributes in a list format:
AdminJMS.createSIBJMSActivationSpec
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName11", "myDestinationJndiName11", [['readAhead', 'AlwaysOff'], ['maxBatchSize', '54']])
createWMQActivationSpec
This script creates a new activation specification for the WebSphere MQ messaging provider at the scope that you specify. The script returns the configuration ID of the created WebSphere MQ activation specification.
Argument | Description |
---|---|
scope | Specifies a scope of cell, node, server, or cluster for the activation specification of the WebSphere MQ messaging provider. |
name | Specifies the name assigned to this activation specification. |
jndiName | Specifies the name and location used to bind this object into WebSphere Application Server JNDI. |
destinationJndiName | Specifies the JNDI name of a WebSphere MQ messaging provider queue or topic type destination. When an MDB is deployed with this activation specification, messages for the MDB are consumed from this destination. |
destinationType | Specifies the type of the destination. Valid
values are javax.jms.Queue and javax.jms.Topic .
The argument has no default value. |
attributes | Optionally specifies additional attributes
in a particular format:
|
Attributes | Description |
---|---|
authAlias | Specifies the authentication alias used to obtain the credentials that this activation specification needs to establish a connection to WebSphere MQ. |
brokerCCDurSubQueue | Specifies the name of the queue from which a connection consumer receives durable subscription messages. |
brokerCCSubQueue | Specifies the name of the queue from which non-durable subscription messages are retrieved for a connection consumer. |
brokerCtrlQueue | Specifies the broker control queue to use when this activation specification subscribes to a topic. |
brokerQmgr | Specifies the name of the queue manager on which the broker is running. |
brokerSubQueue | Specifies the queue for obtaining subscription messages if this activation subscribes to a topic. |
brokerVersion | Specifies the level of functionality required for publish and subscribe operations. |
ccdtQmgrName | Specifies the name of the queue manager that selects one or more entries from a client channel definition table. |
ccdtUrl | Specifies the URL to client channel definition table. Use this attribute for this activation specification when contacting WebSphere MQ. Activation specifications created using this attribute are ccdtURL activation specifications. |
ccsid | Specifies the coded character set ID used on connections. |
cleanupInterval | Specifies the interval between background executions of the publish and subscribe cleanup utility. |
cleanupLevel | Specifies the cleanup level for broker or migrate subscription stores. |
clientId | Specifies the client identifier for connections started with this activation specification. |
clonedSubs | Specifies whether two or more instances of the same durable topic subscriber can run simultaneously. |
compressHeaders | Specifies whether message headers are compressed. |
compressPayload | Specifies whether message payloads are compressed. |
description | Specifies an administrative description assigned to the activation specification. |
failIfQuiescing | Specifies the behavior of certain calls to the queue manager when the queue manager is put into a quiescent state. |
failureDeliveryCount | Specifies the number of sequential delivery failures that are allowed before the endpoint is suspended. |
maxPoolSize | Specifies the maximum number of server sessions in the server session pool that the connection consumer uses. |
messageSelector | Specifies which messages are delivered. |
msgRetention | Specifies whether the connection consumer keeps
unwanted messages on the input queue. A value of true means
that it does. A value of false means that the messages
are disposed of based on the disposition options. |
msgSelection | Specifies where message selection occurs. |
poolTimeout | Specifies the period of time, in milliseconds, that an unused server session is held open in the server session pool before being closed due to inactivity. |
providerVersion | Specifies the minimum version and capabilities of the queue manager. |
qmgrHostname | Specifies the hostname which used for this activation specification, when attempting a client mode connection to WebSphere MQ. |
qmgrName | Specifies the name of the queue manager for this activation specification, when contacting WebSphere MQ. Activation specifications created using this attribute are user defined. |
qmgrPortNumber | Specifies the port number for this activation specification, when attempting a client mode connection to WebSphere MQ. |
qmgrSvrconnChannel | Specifies the SVRCONN channel to use when connecting to WebSphere MQ. Activation specifications created using this attribute are user defined. |
rcvExitInitData | Specifies initialization data to pass to the receive exit. |
rcvExit | Specifies a comma separated list of receive exit class names. |
rescanInterval | Specifies in milliseconds the maximum time that elapses during a scanning interval. When a message consumer in the point-to-point domain uses a message selector to select which messages it wants to receive, the WebSphere MQ JMS client searches the WebSphere MQ queue for suitable messages in the sequence determined by the MsgDeliverySequence attribute of the queue. When the client finds a suitable message and delivers it to the consumer, the client resumes the search for the next suitable message from its current position in the queue. The client continues to search the queue until it reaches the end of the queue, or until the interval of time specified by this property has expired. In each case, the client returns to the beginning of the queue to continue its search, and a new time interval starts. |
secExitInitData | Specifies initialization data to pass to the security exit. |
secExit | Specifies a security exit class name. |
sendExitInitData | Specifies initialization data to pass to the send exit. |
sendExit | Specifies a comma separated list of class names for the send exit. |
sparseSubs | Specifies the message retrieval policy of a topic subscriber object. |
sslConfiguration | Specifies the SSL configuration used to secure network connections to the queue manager. |
sslCrl | Specifies a list of LDAP servers which can be used to provide certificate revocation information if this activation specification establishes an SSL connection to WebSphere MQ. |
sslPeerName | Specifies a value to match against the distinguished name in the peer certificate. This attribute is used when the activation specification establishes an SSL connection to the queue manager. |
sslResetCount | Specifies how many bytes to transfer before resetting the symmetric encryption key for the SSL session. This attribute is used when the activation specification establishes an SSL connection to the queue manager. |
sslType | Specifies the SSL configuration for the network connection to the queue manager. |
startTimeout | Specifies the period of time in milliseconds within which delivery of a message to an MDB must start after the work to deliver the message has been scheduled. If this period of time elapses, the message is returned to the queue. |
stateRefreshInt | Specifies the interval in milliseconds between
refreshes of the long running transaction that detects when a subscriber
loses its connection to the queue manager. This attribute is relevant
only if the subStore attribute has the value QUEUE . |
stopEndpointIfDeliveryFails | Specifies whether the endpoint is stopped if message delivery fails the number of times specified by the failureDeliveryCount attribute. |
subscriptionDurability | Specifies whether a durable or nondurable subscription is used to deliver messages to an MDB subscribing to the topic. |
subscriptionName | Specifies the name of the durable subscription. |
subStore | Specifies where WebSphere MQ JMS stores persistent data relating to active subscriptions. |
wildcardFormat | Specifies which sets of characters are interpreted as topic wild cards. |
wmqTransportType | Specifies the manner in which, for this activation
specification, a connection is established with WebSphere MQ. Activation specifications
created using this attribute are user defined. Valid values are BINDINGS,
BINDINGS_THEN_CLIENT and CLIENT . |
localAddress | Specifies either or both of the following options:
|
Syntax
AdminJMS.createSIBJMSActivationSpec(scope,name, jndiName,
destinationJndiName, destinationType,attributes)
Example usage
The following example script contains required attributes only:
AdminJMS.createSIBJMSActivationSpec("myScope", "myName",
"myJNDIName", "myDestinationName", "myDestinationType")
AdminJMS.createWMQActivationSpec
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName12", "myDestinationJndiName12", "javax.jms.Topic", "poolTimeout=2222,startTimeout=9999")
The following example script includes optional attributes in a list format:
AdminJMS.createWMQActivationSpec
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName12", "myDestinationJndiName12", "javax.jms.Topic", [['poolTimeout', '2222'],
['startTimeout', '9999']])
startListenerPort
This script starts a listener port in your environment. The script returns a value of 1 if the system successfully starts the listener port or a value of -1 if the system does not start the listener port.
Argument | Description |
---|---|
nodeName | Specifies the name of the node of interest. |
serverName | Specifies the name of the server of interest. |
Syntax
AdminJMS.startListenerPort(nodeName,
serverName)
Example usage
AdminJMS.startListenerPort("myNode", "myServer")