See information about the latest product version
mqsicreateconfigurableservice command
Use the mqsicreateconfigurableservice command to create an object name for a broker external resource.
You can also use the WebSphere® Message Broker Explorer to create configurable services. For more information, see Using the WebSphere Message Broker Explorer to work with configurable services.
Supported platforms
- Windows.
- Linux and UNIX systems.
- z/OS®. Run this command by customizing and submitting BIPCRCS. For more information, see Contents of the broker PDSE.
Purpose
- 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.
You do not have to use the mqsicreateconfigurableservice command to create EIS providers, because definitions are supplied for you. Use the mqsichangeproperties command to modify EIS providers.
Usage notes
- Before you run this command, ensure that the broker is running.
- For some types of configurable service, you must stop and start the execution group for the change to take effect. Check the documentation for the specific configurable service type.
Syntax
>>-mqsicreateconfigurableservice--BrokerName--------------------> >-- -c --ConfigurableService-- -o--ObjectName-------------------> >--+---------------------------------------------------+------->< | .-,------------. | | V | | '- -n----PropertyName-+--+------------------------+-' | .-,-------------. | | V | | '- -v----PropertyValue-+-'
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.
The valid resource types are listed in Configurable services properties.
- -o ObjectName
- (Required) The name of the object whose properties you want to
change.
For example, 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. Default services are provided for the supported databases to which you can connect over JDBC type 4 connections. Use the supplied services as a template when you create a service by using this command. Use the mqsireportproperties command to view the list of default provider names.
- -n PropertyName
- (Optional) The name of the property that is being changed.
The valid property names are listed in Configurable services properties.
- -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 by using commas as separators;
for example, -n Name1,Name2 -v Value1,Value2.
If the property value contains a comma, enclose the value with escaped double quotation marks (\" and \"); for example, -n Name1,Name2 -v Value1,\"Value21,Value22\".
On UNIX systems, if the -v parameter contains a semi-colon (;), enclose the entire string in quotation marks, as shown in the following example:
mqsicreateconfigurableservice MB8BROKER -c JDBCProviders -o DB2EXTRA -n connectionUrlFormat -v "jdbc:db2://[serverName]:[portNumber]/[databaseName]:user=[user];password=[password];"
The property values are described in Configurable services properties.
Authorization
- Security requirements for Linux and UNIX platforms
- Security requirements for Windows systems
- Security requirements for z/OS
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
mqsicreateconfigurableservice MB8BROKER -c Aggregation -o myAggregationService
-n queuePrefix,timeoutSeconds -v SET1,60
mqsicreateconfigurableservice MB8BROKER -c CICSConnection -o myCICSConnectionService
-n cicsServer,clientApplid,clientQualifier,connectionTimeoutSecs,
requestTimeoutSecs -v tcp://test.cics.ibm.com:12345,BRKApp,BRKQual,10,5
mqsicreateconfigurableservice MB8BROKER -c Collector -o myCollectorService
-n queuePrefix,collectionExpirySeconds -v SET1,60
mqsicreateconfigurableservice MB8BROKER -c CDServer -o test
-n Hostname,Port -v 9.122.17.58,1369
mqsicreateconfigurableservice MB8BROKER -c ConnectorProviders -o MyProvider
-n connectorClassName,jarsURL
–v com.ibm.broker.MyFactory,C:\temp\jars
To view the Javadoc for the connector API, see Connector API.
mqsicreateconfigurableservice MB8BROKER -c CORBA -o myCORBAService
-n namingService,objectReferenceName -v localhost:2809,Europe.region/Market.object
mqsicreateconfigurableservice MB8BROKER -c EmailServer -o myEmailConfigurableServiceName
-n serverName,securityIdentity -v pop3://test.email.server.ibm.com
:12345,mySecurityIdentityObjectName
mqsicreateconfigurableservice MB8BROKER -c FtpServer -o Server01
-n serverName,scanDelay,transferMode,connectionType,securityIdentity
-v one.hursley.abc.com:123,20,Binary,ACTIVE,secId
mqsicreateconfigurableservice MB8BROKER -c FtpServer -o TEST1
-n protocol,serverName,scanDelay,remoteDirectory,securityIdentity,cipher,compression,strictHostKeyChecking
-v SFTP,winlnx58,30,.,chbatey,blowfish-cbc,9,no
mqsicreateconfigurableservice MB8BROKER -c IMSConnect -o myIMSConnectService
-n Hostname,PortNumber,DataStoreName -v test.ims.ibm.com,9999,IMSA
mqsicreateconfigurableservice MB8BROKER -c JavaClassLoader
-o myJavaClassLoader
-n includedDeployedJars,sharedJarPath
-v "jcnapp1.jar","/var/app1/jars"
mqsicreateconfigurableservice MB8BROKER -c JMSProviders -o JMS_MyProviderXYZ
mqsicreateconfigurableservice MB8BROKER -c JMSProviders -o JMS_ProviderABC
mqsicreateconfigurableservice MB8BROKER -c JMSProviders -o BEAV91
-n proprietaryAPIHandler,proprietaryAPIAttr1,proprietaryAPIAttr2,proprietaryAPIAttr3
–v com.ibm.broker.apihandler.BEAWebLogicAPIHandler,weblogic.jndi.WLInitialContextFactory,
t3://19.21.194.126:7001,BEAServerName
mqsicreateconfigurableservice MB8BROKER -c MonitoringProfiles -o mp1
mqsicreateconfigurableservice MB8BROKER -c PeopleSoftConnection
-o myPeopleSoftAdapter.outadapter -n hostName,port -v "my.peoplesoft.qa.com",9000
mqsicreateconfigurableservice MB8BROKER -c Resequence -o myResequenceService
-n queuePrefix,missingMessageTimeoutSeconds -v SET1,60
mqsicreateconfigurableservice MB8BROKER -c SAPConnection -o mySAPAdapter.outadapter
-n applicationServerHost,client -v test.sap.ibm.com,001
You can set the user name and password for an SAP adapter by using the mqsisetdbparms command.
mqsicreateconfigurableservice MB8BROKER -c SecurityProfiles -o myWSTrustTFIMv62Profile
-n authentication,mapping,authorization,propagation,mappingConfig
-v "WS-Trust v1.3 STS","WS-Trust v1.3 STS","WS-Trust v1.3 STS",TRUE,
http://wstrusthost1.ibm.com:9080/TrustServerWST13/services/RequestSecurityToken
The
Default Propagation profile is a predefined profile that requests
only identity propagation. For more information about creating a security
profile for a WS-Trust V1.3 STS provider, LDAP, or TFIM V6.1, see Creating a security profile.mqsicreateconfigurableservice MB8BROKER -c SiebelConnection -o mySiebelAdapter.outadapter
-n connectString -v "siebel://my.siebel.qa.com/SBA_80/SSEObjMgr_enu"
You can set the user name and password for a Siebel adapter by using the mqsisetdbparms command.
mqsicreateconfigurableservice MB8BROKER -c TCPIPServer -o ServerPort1452
-n Port,MaximumConnections,ExpireConnectionSec -v 1452,1000,15
mqsicreateconfigurableservice MB8BROKER -c TCPIPClient
-o ClientPort1452HostnameJsmith
-n Port,Hostname,AlternativeAddresses,MinimumConnections,MaximumConnections
-v 1452,jsmith.hursley.ibm.com,jones:1111;edwards,5,10
mqsicreateconfigurableservice MB8BROKER -c Timer -o myTimerService
-n queuePrefix,timeoutIntervalSeconds -v SET1,5
mqsicreateconfigurableservice MB8BROKER -c UserDefined
-o HTTP_Timeout -n VerifyRequestTimeout -v 60
mqsicreateconfigurableservice MB8BROKER -c WXSServer -o xc10
-n catalogServiceEndPoints,gridName,overrideObjectGridFile,securityIdentity
-v "server.ibm.com:2809","myGrid","C:\Brokers\WebSphere_eXtreme_Scale\xc10\xc10Client.xml","xc10"