You can create a configurable service
that the EmailInput node
or message flow refers to at run time for email server 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 and security identity values without needing to redeploy
your message flow.
Use the EmailServer configurable
service to change the email server connection information for the EmailInput node. The properties
of the EmailServer configurable service are described in Configurable services properties.
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 EmailServer configurable service for the email server that is running
at pop3://test.email.server.ibm.com port 12345.
The security identity is identified by mySecurityIdentityObjectName in
this example:
mqsicreateconfigurableservice MB8BROKER -c EmailServer -o
myEmailConfigurableServiceName -n serverName,securityIdentity -v
pop3://test.email.server.ibm.com:12345,mySecurityIdentityObjectName
- 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 the EmailInput node
that is configured to use the myEmailConfigurableServiceName configurable
service. After you run this command, the EmailInput node connects to
the production system (pop3://production.email.server.ibm.com:12345)
instead of the test system (pop3://test.email.server.ibm.com:12345).
mqsichangeproperties MB8BROKER -c EmailServer -o myEmailConfigurableServiceName
-n serverName -v pop3://production.email.server.ibm.com:12345
- To display all EmailServer configurable services, use the WebSphere Message Broker Explorer, or the mqsireportproperties command,
as shown in the following example:
mqsireportproperties MB8BROKER -c EmailServer -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 EmailServer -o
myEmailConfigurableServiceName
You can
delete only custom-named configurable services; you cannot delete
IBM-defined configurable services.