This topic contains sections marked as revised for this release

WebSphere Message Brokers
File: an37200_
Writer: Karen Cameron

Reference topic

This build: July 31, 2007 21:34:35

mqsicreateconfigurableservice command

The mqsicreateconfigurableservice command creates a new object name for a broker external resource, such as a JMS providerStart of change or JDBC providerEnd of change.

Supported platforms

Purpose

Start of changeUse this command to add a predefined IBM® resource type. End of change

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
Start of change(Required) The type of external resource (configurable service). Use the mqsireportproperties command to view the list of valid values.
The valid resource types are:
  • JMSProviders
  • JDBCProviders
  • SecurityProfiles
End of change
-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. Start of changeSimilarly, if the -c parameter is set to JDBCProviders, the expected object name is either an IBM-defined JDBC provider name, or a user-defined JDBC provider name. End of change Use the mqsireportproperties command to view the list of default provider names. Start of changeIf the -c parameter is set to SecurityProfiles, the expected object name is the name of a new security profile for the broker.End of change

-n PropertyName
(Optional) The name of the property that is being changed. For a JMSProviders resource, valid property names are:
  • jarsURL
  • nativeLibs
Start of changeFor a JDBCProviders resource, valid property names are:
  • databaseType
  • databaseVersion
  • type4DriverClassName
  • connectionUrlFormat
  • connectionUrlFormat Attr1-5
  • databaseName
  • description
  • jarsURL
  • portNumber
  • serverName
  • securityIdentity
End of change
Start of changeFor a SecurityProfiles resource, valid property names are:
  • authentication = {NONE, LDAP, TFIM}
  • authenticationConfig = string
  • mapping = {NONE, TFIM}
  • mappingConfig = string
  • authorization = {NONE, LDAP, TFIM}
  • authorizationConfig = string
  • propagation = {TRUE, FALSE}
End of change
-v PropertyValue
(Optional, but required if -n is specified) The value that is assigned to the property 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.

Start of changeIf you set the -c parameter to SecurityProfiles, and the -n parameter to authentication, the property value can be NONE, LDAP, TFIM, or a user-defined value to specify an alternative.End of change

Start of changeIf you set the -c parameter to SecurityProfiles, and the -n parameter to authenticationConfig, the expected property value is a provider-specific configuration string.End of change

Start of changeIf you set the -c parameter to SecurityProfiles, and the -n parameter to mapping, the property value can be NONE, TFIM, or a user-defined value to specify an alternative.End of change

Start of changeIf you set the -c parameter to SecurityProfiles, and the -n parameter to mappingConfig, the expected property value is a provider-specific configuration string.End of change

Start of changeIf you set the -c parameter to SecurityProfiles, and the -n parameter to authorization, the property value can be NONE, LDAP, TFIM, or a user-defined value to specify an alternative.End of change

Start of changeIf you set the -c parameter to SecurityProfiles, and the -n parameter to authorizationConfig, the expected value is a provider-specific configuration string.End of change

Start of changeIf you set the -c parameter to SecurityProfiles, and the -n parameter to propagation, the property value can be either TRUE or FALSE.End of change

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 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
Start of changeCreate a security profile for TFIM use::
mqsicreateconfigurableservice WBRK6_DEFAULT_BROKER -c SecurityProfiles -o TFIM -n authentication,mapping,authorization,propagation,mappingConfig -v TFIM,TFIM,TFIM,TRUE,http://tfimhost1.ibm.com:9080
End of change
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:34:35

an37200_ This topic's URL is: