IBM Integration Bus, Version 10.0.0.2 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS


Changing connection information for the EmailInput node

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.

Before you begin

About this task

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

Procedure

  1. To create a configurable service, use the web user interface 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 IBNODE -c EmailServer -o 
    myEmailConfigurableServiceName -n serverName,securityIdentity -v 
    pop3://test.email.server.ibm.com:12345,mySecurityIdentityObjectName
  2. To change a configurable service, use the web user interface or the mqsichangeproperties command, as shown in the following example. You must stop and start the integration server 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 IBNODE -c EmailServer -o myEmailConfigurableServiceName
      -n serverName -v pop3://production.email.server.ibm.com:12345
  3. To display all EmailServer configurable services, use the web user interface or the mqsireportproperties command, as shown in the following example:
    mqsireportproperties IBNODE -c EmailServer -o AllReportableEntityNames -r
  4. To delete a configurable service that you created, use the web user interface or the mqsideleteconfigurableservice command, as shown in the following example:
    mqsideleteconfigurableservice IBNODE -c EmailServer -o 
    myEmailConfigurableServiceName
    You can delete only configurable services that you created; you cannot delete IBM predefined configurable service templates.

bc16240_.htm | Last updated 2015-09-24 12:53:39