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

See information about the latest product version

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 start:

Read Configurable services to find out more about configurable services.
Read Receiving emails for background information.

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 IBM® Integration Explorer; see Using the IBM Integration 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 IB9NODE -c EmailServer -o 
myEmailConfigurableServiceName -n serverName,securityIdentity -v 
pop3://test.email.server.ibm.com:12345,mySecurityIdentityObjectName
```
To change a configurable service, use the IBM Integration Explorer, 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 IB9NODE -c EmailServer -o myEmailConfigurableServiceName
  -n serverName -v pop3://production.email.server.ibm.com:12345
```
To display all EmailServer configurable services, use the IBM Integration Explorer, or the mqsireportproperties command, as shown in the following example:
```
mqsireportproperties IB9NODE -c EmailServer -o AllReportableEntityNames -r
```
You can delete a configurable service that you have created by using the IBM Integration Explorer, or the mqsideleteconfigurableservice command, as shown in the following example:
```
mqsideleteconfigurableservice IB9NODE -c EmailServer -o 
myEmailConfigurableServiceName
```
You can delete only custom-named configurable services; you cannot delete IBM-defined configurable services.

bc16240_.htm |

Last updated Friday, 21 July 2017