Start of change

mqsicreateconfigurableservice command

Supported platforms

Purpose

This command creates a new object name for a broker configurable service, such as a JMS provider. Use this command to add a predefined IBM resource types.

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 configurable service type, such as JMSProviders. Use the mqsireportproperties command to view the list of valid values.
-o ObjectName
(Required) The name of the object for which you want to change the properties.

If the -c parameter is set to JMSProvider, the expected object name is either an IBM-defined JMS provider name, or a user-defined JMS provider name. Use the mqsireportproperties command to view the list of default provider names.

-n PropertyName
(Optional) The name of the property that is being changed. For a JMSProvider resource, valid property names are:
  • JarsURL
  • NativeLibs
-v PropertyValue
(Optional, but required if -n 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 JMSProvider, and the -n parameter to JarsURL, the expected value is a URL that specified the file location of the JMS provider jar files. 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 JMSProvider, 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

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 JMSProvider -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 JMSProvider -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 JMSProvider -o JMS_ProviderABC -n JarsURL,NativeLibs -v file://D:\ProviderABC\java,D:\ProviderABC\libs
End of change