mqsicreateconfigurableservice command

Start of changeUse the mqsicreateconfigurableservice command to create a new object name for a broker external resource, such as a JMS provider. End of change

Supported platforms

Purpose

For configurable services that you add using the mqsicreateconfigurableservice command:
  • Use the mqsireportproperties command to view the configurable services.
  • Use the mqsichangeproperties command to modify the configurable services.
  • Use the mqsideleteconfigurableservice command to delete configurable services.

Usage notes

  • Before you run this command, ensure that the broker is running.
  • Stop and restart the broker before you use any new broker resources and properties.

Syntax

Parameters

BrokerName
(Required) The name of the broker to modify. This parameter must be the first parameter.
-c ConfigurableService
(Required) The type of external resource (configurable service). Use the mqsireportproperties command to view the list of valid values.
-o ObjectName
(Required) The name of the object whose properties you want to change.

If the -c parameter is set to JMSProviders, the expected object name is either an IBM-defined JMS provider name, or a user-defined JMS provider name.

-n PropertyName
(Optional) The name of the property that is being changed.
For a JMSProviders resource, valid property names are:
  • jarsURL
  • nativeLibs
-v PropertyValue
(Optional, but required if the -n parameter is specified) The value that is assigned to the property that is specified by the -n parameter. You can specify more than one property name and corresponding value using commas as separators; for example, -n Name1,Name2 -v Value1,Value2.

If you set the -c parameter to JMSProviders, and the -n parameter to jarsURL, the expected value is a URL that specifies the file location of the JMS provider JAR files, while omitting the file:// of the URL. If you do not specify the -n parameter, the default location for the JMS provider jar files is the broker's shared-classes directory.

If you set the -c parameter to JMSProviders, and the -n parameter to nativeLibs, the expected value is a file location of any JMS provider native libraries. If you do not specify the -n parameter, the default location for any JMS provider native libraries is the broker's LilPath.

Authorization

On all operating systems, the user ID must be a member of the mqbrkrs group.

Responses

This command returns the following responses
  • BIP8011 Unable to create configuration data
  • BIP8012 Unable to connect to system components
  • BIP8014 Component cannot be created
  • BIP8073 Invalid broker name
  • BIP8983 Configurable service already exists
  • BIP8984 Configurable service was not found

Examples

Add a JMS provider called MyProviderXYZ for broker WBRK6_DEFAULT_BROKER:
mqsicreateconfigurableservice WBRK6_DEFAULT_BROKER -c JMSProviders -o JMS_MyProviderXYZ
Add a JMS provider called ProviderABC for broker WBRK6_DEFAULT_BROKER with default values for the resource properties:
mqsicreateconfigurableservice WBRK6_DEFAULT_BROKER -c JMSProviders -o JMS_ProviderABC
Add a JMS provider called ProviderABC for broker WBRK6_DEFAULT_BROKER specifying a location for the provider's jar files, and a library path for the native libraries that are associated with those jar files:
mqsicreateconfigurableservice WBRK6_DEFAULT_BROKER -c JMSProviders -o JMS_ProviderABC 
-n jarsURL,nativeLibs -v file://D:\ProviderABC\java,D:\ProviderABC\libs
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009. All Rights Reserved.
Last updated : 2009-01-07 15:40:57

an37200_