Receiving emails

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 broker uses to receive emails. Alternatively, you can specify a configurable service name that refers to an EmailServer configurable service that is defined on the broker. To enable the configurable service, use the mqsicreateconfigurableservice and mqsichangeproperties commands, as shown in the following examples:

mqsicreateconfigurableservice IB9NODE -c EmailServer -o 
myEmailConfigurableServiceName

mqsichangeproperties IB9NODE -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 IB9NODE -n email::mySecurityIdentity -u myUserID -p myPassword
mqsichangeproperties IB9NODE -c EmailServer -o myEmailConfigurableServiceName -n 
securityIdentity -v mySecurityIdentity