JMS query scripts

The scripting library provides many script procedures to manage the Java Messaging Service (JMS) configurations. See the usage information for scripts that retrieve configuration IDs from the JMS configuration. We can run each script individually or combine many procedures to create custom automation scripts for your environment.

Each JMS management script procedure is located in the app_server_root/scriptLibraries/resources/JMS/V70 directory.

Beginning with Version 7, the Jython script library provides script functions for JDBC providers, JMS resources, and resource providers at the server scope. We can write our own custom scripts to configure resources at the cell, node, or cluster level.

Avoid trouble: Do not edit the script procedures in the script library. To write custom script library procedures, use the scripts in the app_server_root/scriptLibraries directory as Jython syntax samples. Save the custom scripts to a new subdirectory to avoid overwriting the library.gotcha

Fast path: Beginning with Fix Pack 5, the Jython script library provides script functions for JDBC providers, JMS resources, and resource providers at the cell, node, server, or cluster scope. Resource providers include mail providers, URL providers, and resource environment providers. You do not have to write custom scripts to configure resources at a particular scope.

Use the following script procedures to query the JMS configurations:

• listGenericJMSConnectionFactories

• listGenericJMSConnectionFactoryTemplates

• listGenericJMSDestinations

• listGenericJMSDestinationTemplates

• listJMSProviders

• listJMSProviderTemplates

• listWASQueueConnectionFactoryTemplates

• listWASQueueTemplates

• listWASTopicConnectionFactoryTemplates

• listWASQueueConnectionFactories

• listWASQueues

• listWASTopicConnectionFactories

• listWASTopics

• listWASTopicTemplates

listGenericJMSConnectionFactories

This script displays a list of configuration IDs for the generic JMS connection factories configured in the environment.

The script does not require any input parameters.

script. Run the script to list generic JMS connection

Argument	Description
connFactoryName	Optionally specifies the name of the generic JMS connection factory of interest.

Syntax

AdminJMS.listGenericJMSConnectionFactories(connFactoryName)

Example usage

AdminJMS.listGenericJMSConnectionFactories()

AdminJMS.listGenericJMSConnectionFactories("JMSCFTest")

listGenericJMSConnectionFactoryTemplates

This script displays a list of generic JMS connection factory template configuration ids.

The script does not require any input parameters. However, to return a specific generic JMS connection factory template, specify the template ID argument, as defined in the following table:

script. Run the script to list generic JMS connection

Argument	Description
templateName	Optionally specifies the name of the template of interest.

Syntax

AdminJMS.listGenericJMSConnectionFactoryTemplates(templateName)

Example usage

AdminJMS.listGenericJMSConnectionFactoryTemplates()

AdminJMS.listGenericJMSConnectionFactoryTemplates("Generic QueueConnectionFactory for Windows")

listGenericJMSDestinations

This script displays a list of configuration IDs for the generic JMS destinations configured in the environment. The script does not require any input parameters. However, to return a specific generic JMS destination, specify the generic JMS destination name.

The script does not require any input parameters. However, to return a specific generic JMS destination, specify the generic JMS destination name, as defined in the following table:

Argument	Description
destinationName	Optionally specifies the name of the generic JMS destination of interest.

Syntax

AdminJMS.listGenericJMSDestinations(destinationName)

Example usage

AdminJMS.listGenericJMSDestinations()

AdminJMS.listGenericJMSDestinations("JMSDestination")

listGenericJMSDestinationTemplates

This script displays a list of generic JMS destination template configuration ids.

The script does not require any input parameters. However, to return a specific template, specify the template name, as defined in the following table:

script. Run the script to list generic JMS destination

Argument	Description
templateName	Optionally specifies the name of the template of interest.

Syntax

AdminJMS.listGenericJMSDestinationTemplates(templateName)

Example usage

AdminJMS.listGenericJMSDestinationTemplates()

AdminJMS.listGenericJMSDestinationTemplates("Example.JMS.Generic.Win.Topic")

listJMSProviders

This script displays a list of configuration IDs for the JMS providers configured in the environment.

The script does not require any input parameters. However, to return a specific JMS provider, specify the JMS provider name, as defined in the following table:

Argument	Description
jmsProviderName	Optionally specifies the name of the generic JMS connection factory of interest.

Syntax

AdminJMS.listJMSProviders(jmsProviderName)

Example usage

AdminJMS.listJMSProviders()

AdminJMS.listJMSProviders("JMSTest")

listJMSProviderTemplates

This script displays a list of JMS provider template configuration ids.

The script does not require any input parameters. However, to return a specific template, specify the template name, as defined in the following table:

Argument	Description
templateName	Optionally specifies the name of the template of interest.

Syntax

AdminJMS.listJMSProviderTemplates(templateName)

Example usage

AdminJMS.listJMSProviderTemplates()

AdminJMS.listJMSProviderTemplates("WebSphere JMS Provider")

listWASQueueConnectionFactoryTemplates

This script displays a list of JMS queue connection factory template configuration ids.

The script does not require any input parameters. However, to return a specific template, specify the template name, as defined in the following table:

script. Run the script to list JMS queue connection factory

Argument	Description
templateName	Optionally specifies the name of the template of interest.

Syntax

AdminJMS.listWASQueueConnectionFactoryTemplates(templateName)

Example usage

AdminJMS.listWASQueueConnectionFactoryTemplates()

AdminJMS.listWASQueueConnectionFactoryTemplates("Example WAS QueueConnectionFactory")

listWASQueueTemplates

This script displays a list of JMS queue template configuration ids.

The script does not require any input parameters. However, to return a specific generic template, specify the template name, as defined in the following table:

Argument	Description
templateName	Optionally specifies the name of the template of interest.

Syntax

AdminJMS.listWASQueueTemplates(templateName)

Example usage

AdminJMS.listWASQueueTemplates()

AdminJMS.listWASQueueTemplates("Example.JMS.WAS.Q1")

listWASTopicConnectionFactoryTemplates

This script displays a list of JMS topic connection factory template configuration ids.

The script does not require any input parameters. However, to return a specific template, specify the template name, as defined in the following table:

script. Run the script to list JMS topic connection factory

Argument	Description
templateName	Optionally specifies the name of the template of interest.

Syntax

AdminJMS.listWASTopicConnectionFactoryTemplates(templateName)

Example usage

AdminJMS.listWASTopicConnectionFactoryTemplates()

AdminJMS.listWASTopicConnectionFactoryTemplates("First Example WAS TopicConnectionFactory")

listWASQueueConnectionFactories

This script displays a list of configuration IDs for the JMS queue connection factories configured in the environment.

The script does not require any input parameters. However, to return a specific JMS queue connection factory, specify the connection factory name, as defined in the following table:

Argument	Description
connFactoryName	Optionally specifies the name of the JMS connection factory of interest.

Syntax

AdminJMS.listWASQueueConnectionFactories(connFactoryName)

Example usage

AdminJMS.listWASQueueConnectionFactories()

AdminJMS.listWASQueueConnectionFactories("queuecf")

listWASQueues

This script displays a list of JMS queues.

The script does not require any input parameters. However, to return a specific queue, specify the queue name, as defined in the following table:

Argument	Description
queueName	Optionally specifies the name of the queue of interest.

Syntax

AdminJMS.listWASQueues(queueName)

Example usage

AdminJMS.listWASQueues()

AdminJMS.listWASQueues("WASQueueTest")

listWASTopicConnectionFactories

This script displays a list of configuration IDs for the JMS topic connection factories configured in the environment.

The script does not require any input parameters. However, to return a specific JMS topic connection factory, specify the connection factory name, as defined in the following table:

Argument	Description
connFactoryName	Optionally specifies the name of the JMS topic connection factory of interest.

Syntax

AdminJMS.listWASTopicConnectionFactories(connFactoryName)

Example usage

AdminJMS.listWASTopicConnectionFactories()

AdminJMS.listWASTopicConnectionFactories("TopicCFTest")

listWASTopics

This script displays a list of configuration IDs for the JMS topics configured in the environment.

The script does not require any input parameters. However, to return a specific topic, specify the topic name, as defined in the following table:

Argument	Description
topicName	Optionally specifies the name of the topic of interest.

Syntax

AdminJMS.listWASTopics(topicName)

Example usage

AdminJMS.listWASTopics()

AdminJMS.listWASTopics("TopicTest")

listWASTopicTemplates

This script displays a list of JMS topic template configuration ids.

The script does not require any input parameters. However, to return a specific template, specify the template name, as defined in the following table:

Argument	Description
templateName	Optionally specifies the name of the template of interest.

Syntax

AdminJMS.listWASTopicTemplates(templateName)

Example usage

AdminJMS.listWASTopicTemplates()

AdminJMS.listWASTopicTemplates("Example.JMS.WAS.T1")

Related tasks

Use the script library to automate the application serving environment

JMS configuration scripts

JDBC configuration scripts

JDBC query scripts