mqsicreateconfigurableservice command
Use the mqsicreateconfigurableservice command to create an object name for an integration node external resource.
You can also use the web user interface to create configurable services. For more information, see Creating 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 integration node 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 integration node is running.
- For some types of configurable service, you must stop and start the integration server for the change to take effect. Check the documentation for the specific configurable service type.
Syntax
Parameters
- integrationNodeName
- (Required) The name of the integration node 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 property name must be a valid XML
attribute name; for example, a property name cannot start with a number.
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 IBNODE -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 integration node name
- BIP8983 Configurable service already exists
- BIP8984 Configurable service was not found
Examples
mqsicreateconfigurableservice IBNODE -c Aggregation -o myAggregationService
-n queuePrefix,timeoutSeconds -v SET1,60
mqsicreateconfigurableservice IBNODE -c CICSConnection -o myCICSConnectionService
-n cicsServer,clientApplid,clientQualifier,connectionTimeoutSecs,
requestTimeoutSecs -v tcp://test.cics.ibm.com:12345,BRKApp,BRKQual,10,5
mqsicreateconfigurableservice IBNODE -c Collector -o myCollectorService
-n queuePrefix,collectionExpirySeconds -v SET1,60
test
, with a host name of
9.122.17.58
and port number
1369
:mqsicreateconfigurableservice IBNODE -c CDServer -o test
-n Hostname,Port -v 9.122.17.58,1369
mqsicreateconfigurableservice IBNODE -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 (previous version).
mqsicreateconfigurableservice IBNODE -c CORBA -o myCORBAService
-n namingService,objectReferenceName -v localhost:2809,Europe.region/Market.object
mqsicreateconfigurableservice IBNODE -c EmailServer -o myEmailConfigurableServiceName
-n serverName,securityIdentity -v pop3://test.email.server.ibm.com
:12345,mySecurityIdentityObjectName
mqsicreateconfigurableservice IBNODE -c FtpServer -o Server01
-n serverName,scanDelay,transferMode,connectionType,securityIdentity
-v one.hursley.abc.com:123,20,Binary,ACTIVE,secId
mqsicreateconfigurableservice IBNODE -c FtpServer -o TEST1
-n protocol,serverName,scanDelay,remoteDirectory,securityIdentity,cipher,compression,strictHostKeyChecking
-v SFTP,winlnx58,30,.,chbatey,blowfish-cbc,9,no
mqsicreateconfigurableservice IBNODE -c IMSConnect -o myIMSConnectService
-n Hostname,PortNumber,DataStoreName -v test.ims.ibm.com,9999,IMSA
mqsicreateconfigurableservice IBNODE -c JavaClassLoader
-o myJavaClassLoader
-n includedDeployedJars,sharedJarPath
-v "jcnapp1.jar","/var/app1/jars"
mqsicreateconfigurableservice IBNODE -c JMSProviders -o JMS_MyProviderXYZ
mqsicreateconfigurableservice IBNODE -c JMSProviders -o JMS_ProviderABC
mqsicreateconfigurableservice IBNODE -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 IBNODE -c MonitoringProfiles -o mp1
mqsicreateconfigurableservice IBNODE -c PeopleSoftConnection
-o myPeopleSoftAdapter.outadapter -n hostName,port -v "my.peoplesoft.qa.com",9000
mqsicreateconfigurableservice IBNODE -c Resequence -o myResequenceService
-n queuePrefix,missingMessageTimeoutSeconds -v SET1,60
mqsicreateconfigurableservice IBNODE -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 IBNODE -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 IBNODE -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 IBNODE -c TCPIPServer -o ServerPort1452
-n Port,MaximumConnections,ExpireConnectionSec -v 1452,1000,15
mqsicreateconfigurableservice IBNODE -c TCPIPClient
-o ClientPort1452HostnameJsmith
-n Port,Hostname,AlternativeAddresses,MinimumConnections,MaximumConnections
-v 1452,jsmith.hursley.ibm.com,jones:1111;edwards,5,10
mqsicreateconfigurableservice IBNODE -c Timer -o myTimerService
-n queuePrefix,timeoutIntervalSeconds -v SET1,5
mqsicreateconfigurableservice IBNODE -c UserDefined
-o HTTP_Timeout -n VerifyRequestTimeout -v 60
mqsicreateconfigurableservice IBNODE -c WXSServer -o xc10
-n catalogServiceEndPoints,gridName,overrideObjectGridFile,securityIdentity
-v "server.ibm.com:2809","myGrid","C:\Integration nodes\WebSphere_eXtreme_Scale\xc10\xc10Client.xml","xc10"