You can create a configurable service
that the IMSRequest node
or message flow refers to at run time for connection information,
instead of defining the connection properties on the node or the message
flow. The advantage being that you can change the host name, performance,
and security values without needing to redeploy your message flow.
Use the IMSConnect configurable
service to change the connection information for the IMSRequest node. Two configurable
services can connect to the same instance of IMS Connect. The properties of the IMSConnect
configurable service are described in Configurable services properties.
You can use the IMSConnect configurable service to configure
the IMSRequest node to
use Secure Sockets Layer (SSL) protocol. For more information, see Securing the connection to IMS by using SSL.
Creating, changing,
reporting, and deleting configurable services
- To create a configurable service, use the WebSphere® Message Broker Explorer; see Using the WebSphere Message Broker Explorer to work with configurable services for
more information, or the mqsicreateconfigurableservice command,
as shown in the following example. This example creates
an IMSConnect configurable service for the IMS instance IMSA that is running on test.ims.ibm.com port
9999:
mqsicreateconfigurableservice MB8BROKER -c IMSConnect -o myIMSConnectService
-n Hostname,PortNumber,DataStoreName -v test.ims.ibm.com,9999,IMSA
- To change a configurable service, use the WebSphere Message Broker Explorer, or the mqsichangeproperties command,
as shown in the following example. You must stop and
start the execution group for the change of property value to take
effect. This example changes all the nodes that
are configured to use the myIMSConnectService configurable
service. After you run this command, the IMSRequest node connects to
the production system (production.ims.ibm.com)
instead of the test system (test.ims.ibm.com). The command also changes to coded character set
identifier (CCSID) to 37.
mqsichangeproperties MB8BROKER -c IMSConnect -o myIMSConnectService -n Hostname,CodedCharSetID
-v production.ims.ibm.com,37
See Securing the connection to IMS by using SSL for information
about how to turn on SSL support in the broker by setting the UseSSL and SSLEncryptionType IMSConnect configurable
service properties.
- To display all IMSConnect configurable services, use the WebSphere Message Broker Explorer, or the mqsireportproperties command,
as shown in the following example:
mqsireportproperties MB8BROKER -c IMSConnect -o AllReportableEntityNames -r
- You can delete a configurable service that you have created
by using the WebSphere Message Broker Explorer, or the mqsideleteconfigurableservice command,
as shown in the following example:
mqsideleteconfigurableservice MB8BROKER -c IMSConnect -o myIMSconnectService
You can delete only custom-named configurable services; you
cannot delete IBM-defined configurable services.