How to Configure a POP3 Receive Location

You can set POP3 receive location adapter variables in the BizTalk Server Administration console. If properties are not set in the receive location, the default receive handler values set in the BizTalk Server Administration console are used.

To configure variables for a POP3 receive location

1. In the BizTalk Server Administration console, expand BizTalk Server Administration, expand BizTalk Group, expand Applications, and then expand the application you want to create a receive location in.

2. In the BizTalk Server Administration console, in the left pane, click the Receive Port node. Then in the right pane, right-click the receive port that is associated with an existing receive location or that you want to associate with a new receive location, and then click Properties.

3. In the Receive Port Properties dialog box, in the left pane, select Receive Locations, and then in the right pane, double-click an existing receive location or click Newto create a new receive location.

4. In the Receive Location Properties dialog box, in the Transport section next to Type, select POP3 from the drop-down list, and then click Configure.

5. In the POP3 Transport Properties dialog box, do the following:

   Use this	To do this
   Apply MIME Decoding	Specify whether to apply MIME decoding to messages received by the POP3 adapter. MIME decoding is used to parse the incoming message and any attachments into a multipart BizTalk message. Important: If this value is set to False then the POP3 adapter will submit the complete e-mail body including message headers to BizTalk Server. Default value: True
   Body Part Content Type	Specify the body part content type of the incoming e-mail message to submit to BizTalk Server. This is an optional setting. See What Is the POP3 Adapter? for more information.
   Body Part Index	Specify the body part of the incoming e-mail message to submit to BizTalk Server. See What Is the POP3 Adapter? for more information. Default value: 0
   Mail Server	Specify the POP3 mail server that houses the mailbox that will be polled by the POP3 adapter. Note: The URI for a send port or receive location cannot exceed 256 characters.
   Port	Specify the port for the POP3 mail server. Valid values: 1 through 65535 inclusive. Default value: 0 Note: A value of 0 indicates to use the default POP3 port of 110 if Use SSL is False or port 995 if Use SSL is True.
   Authentication Scheme	Specify the type of authentication to use with the destination server. Valid options are: - Basic - Digest - SPA Note: When using SPA authentication, the username must be specified with one of the following formats: Domain accounts must be entered with the syntax: <domain name>\<username> Local accounts must be entered with the syntax: <machine name>\<username>
   Password	Specify the user password to use for authentication with the POP3 server.
   Use SSL	Specify whether to use Secure Sockets Layer (SSL) to communicate with the destination server. Default value: False
   User Name	Specify the user name to use for authentication with the POP3 server. This property requires a value. Note: The account specified for the User Name property must have the ability to logon to the network. The POP3 adapter connects to the mailbox associated with the account specified for the User Name property. Therefore it is not possible to use the POP3 Adapter to connect to a mailbox other than the mailbox assigned to the specified account. For example, even if multiple accounts have Read permissions to the mailbox associated with a particular account, only the actual account name can be specified for User Name.
   Error Threshold	Specify the maximum number of network or protocol errors to wait before shutting down the adapter. Specify a value of 0 to prevent the adapter from shutting down. Default value: 10
   Polling Interval	Specify the interval between attempts to retrieve messages from the POP3 server. Default value: 5
   Polling Interval Unit	Specify the unit of measure to be used for the Polling Interval. Default value: Minutes

6. Click OK.

7. In the Receive Location Properties dialog box, enter the appropriate values to complete the configuration of the receive location, and then click OK to save settings. For information about the Receive Locations Properties dialog box, see How to Create a Receive Location.

See Also

Configuring the POP3 Adapter