AS1 Configuration

The adapter accepts one or more of the following configuration settings. Configuration settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the adapter, access to these internal properties is provided through the Other property.

AS1 Configuration Settings

DeleteOnSuspend: Specifies whether files may be deleted from server when message is suspended.

If true, the file on the server will be deleted in accordance with the option selected in DeleteMode even if the message is suspended.

The default value is False.

MDNTo: Allows the Send adapter to specify a separate email for MDN delivery.

Ordinarily, the Send adapter requests an MDN receipt at the address specified in MyEmail. You can set this to another address to request MDN delivery to a separate account, or set this value to an empty string to not request an MDN receipt.

MDNOptions: Used to indicate the options requested for the MDN receipt.

By default, the adapter will request that the MDN be signed with a PKCS#7 signature over an SHA1 or MD5 hash, which is the industry standard.

Set MDNOptions to an empty string to request an unsigned receipt.

The string format is that of the Disposition-Notification-Options header, as specified in RFC 3335. As a form of shorthand, you may set this property to "sha1" or "md5" to request the indicated hash algorithm.

MessageSecurity: Required security level for incoming messages.

The default value is (3), "Signed And Encrypted", in which case both a valid signature and encryption are required for incoming messages.

Other values include:


0	None
1	Signed
2	Encrypted
3	Signed And Encrypted

CAUTION: "None" is included for debugging purposes only. There is no security with this level.

EncryptionAlgorithm: The algorithm, if any, used to encrypt the EDI data.

In the Send adapter, if RecipientCert is set to a valid certificate, the data will be encrypted using "3DES", or industry-standard 168-bit Triple-DES encryption. Use of this algorithm is strongly recommended.

If EncryptionAlgorithm is set to the empty string, the data will not be encrypted.

The adapter also supports "RC2" (with a default keysize of 128 bits; you may also set "RC2CBC40" or "RC2CBC64" for 40- or 64-bit keysizes), single "DES", and "AES" encryption (with a default keysize of 128 bits; you may also set "AESCBC192" or "AESCBC256" for 192- and 256-bit keysizes).

SMTPUser: A user id to login the SMTP server.

If SMTP authentication is required, this property contains the user to log in as.

SMTPPassword: A login password id to login as in the SMTP server.

If SMTP authentication is required, this property contains the password for the SMTP user.

SMTPAuthMechanism: The authentication mechanism used to connect to the SMTP server.

By default, SMTPAuthMechanism is set to 0, which sends the AUTH command is SMTPUser and SMTPPassword are set. SMTPAuthMechanism can be set to 1 to use the more secure CRAM-MD5 authentication command.

General Configuration Settings


	AbsoluteTimeout: Determines whether timeouts are inactivity timeouts or absolute timeouts. If AbsoluteTimeout is set to True, any method which does not complete within Timeout seconds will be aborted. By default, AbsoluteTimeout is False, and the timeout is an inactivity timeout.
	LocalHost: The name of the local host or user-assigned IP interface through which connections are initiated or accepted. The LocalHost configuration contains the name of the local host as obtained by the Gethostname() system call, or if the user has assigned an IP address, the value of that address. In multihomed hosts (machines with more than one IP interface) setting LocalHost to the value of an interface will make the adapter initiate connections (or accept in the case of server adapters) only through that interface. If the adapter is connected, the LocalHost configuration shows the IP address of the interface through which the connection is made in internet dotted format (aaa.bbb.ccc.ddd). In most cases, this is the address of the local host, except for multihomed hosts (machines with more than one IP interface).
	TcpNoDelay: Whether or not to delay when sending packets. When true, the socket will send all data that is ready to send at once. When false, the socket will send smaller buffered packets of data at small intervals. This is known as the Nagle algorithm. By default, this config is set to false.
	UseManagedSecurityAPI: Tells the adapter whether or not to use the system security libraries or a managed implementation. By default the adapter will use the system security libraries to perform cryptographic functions. This means calls to unmanaged code will be made. In certain environments this is not desirable. To use a completely managed security implementation set this setting to True. Setting this to True tells the adapter to use the internal managed implementation instead of using the system's security API. Note that when this value is set the product's system dll is no longer required as a reference, as all unmanaged code is stored in this file.

Supported Macros

The adapter also supports the following Macros. These values are not case sensitive and would be supplied to a property in the form %MacroName%.


Temp	This is resolved to the full path to the system's temporary directory.
MessageID	Globally unique identifier (GUID) of the message in BizTalk Server.
SourceFileName	The original file name. This includes the extension and excludes the file path, for example, Sample.xml
SourceFileNameNoExt	The original file name without the extension or file path, for example, Sample
RemoteFileName	The name of the file as it was uploaded to the remote server. This includes the extension and excludes the file path, for example, Sample.xml. Valid only for AS3, FTP, and SFTP Send Adapters.
DestinationParty	Name of the destination party.
DestinationPartyQualifier	Qualifier of the destination party.
SourceParty	Name of the source party.
SourcePartyQualifier	Qualifier of the source party.
DateTime:CustomFormat	This special value allows you to specify your own custom time format. For instance DateTime:yyyy would be resolved to the 4 digit year.
Date	The date format yyyy-MM-dd.
DateTime	The date format yyyy-MM-ddThhmmss.
Time	The date format hhmmss.
DateTime_BTS2000	The date format yyyyMMddhhmmssf.
DateTime.TZ	The date format yyyy-MM-ddThhmmsszzz.
Time.TZ	The date format hhmmsszzz.