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


Receiving emails

You can configure the EmailInput node to receive an email, with or without an attachment, from an email server that supports Post Office Protocol 3 (POP3) or Internet Message Access Protocol (IMAP).

About this task

You can use the Email server property on the EmailInput node to specify the protocol, host name, and port of the email server that the integration node uses to receive emails. Alternatively, you can specify a configurable service name that refers to an EmailServer configurable service that is defined on the integration node. To enable the configurable service, use the mqsicreateconfigurableservice and mqsichangeproperties commands, as shown in the following examples:
mqsicreateconfigurableservice IBNODE -c EmailServer -o 
myEmailConfigurableServiceName
mqsichangeproperties IBNODE -c EmailServer -o myEmailConfigurableServiceName
  -n serverName -v pop3://myemailserver.com:12345
If the value of the Email server EmailInput node property is set to the defined configurable service name, any values set by the administrator on the command line are used in preference to any statically defined value.
The following list details the order of preference for value selection:
  1. The email server URL value that is specified in the EmailServer configurable service serverName property, if a configurable service exists that matches the name that is supplied in the Email server EmailInput node property.
  2. The email server URL value of the Email server property that is specified directly on the EmailInput node.
A configurable service can be removed by using the mqsideleteconfigurableservice command, so that the EmailInput node reverts to resolving the email server URL from the value that is set on the node. For more information about creating, changing, reporting, and deleting configurable services, see Changing connection information for the EmailInput node.
While most configurable service properties are set by using the mqsichangeproperties command, security identity support, such as an email server user ID and password pair, is typically set by using the mqsisetdbparms command. Security identity support can be configured by setting the Security identity EmailInput node property or EmailServer configurable service securityIdentity property to reference a security identity object. However, the security identity object must first be created by using the mqsisetdbparms command, for example:
mqsisetdbparms IBNODE -n email::mySecurityIdentity -u myUserID -p myPassword
mqsichangeproperties IBNODE -c EmailServer -o myEmailConfigurableServiceName -n 
securityIdentity -v mySecurityIdentity

For more information about email server security identity support, see mqsisetdbparms command.

The topics in this section describe the different ways in which you can use the EmailInput node to receive email messages.

Procedure


bc16210_.htm | Last updated 2015-11-27 00:00:49