Send channel properties

Note: Server type channels have a property called Host. The Host property specifies an IP address or a host name where to run the channel on the Grid.

DISK

The disk protocol writes the message to a disk. Before you can put the file on a preferred location and with a specific name, you must set the parameters first.

Use these guidelines:

Add a full control access to the folder in the Central File Location host for the GridAgent logon Infor ION Grid Bootstrap.

See the Infor ION Grid Administration Guide.
If the location is absolute, the DiskIn and DiskOut folder paths are resolved in the Central File System host machine.
If the location is relative, the DiskIn and DiskOut folder paths are resolved in the Central File System share.


Property groups	Description
Naming	Name and description for this channel.
Basic Configuration	Includes the output folder, file name, and file extension.
Unique File Name	For more information about Unique File Name, see the disk protocol.
SkipRename	Enable/Disable SkipRename. For more information, see SkipRename.

By default, the IEC Send process stores the file in IEC Central path before sending the file to the selected Out Channel. Using DiskOut channel, the stored file in IEC Central path is renamed to the configured output folder. In Windows, the file rename function retains the Access Control List (ACL) even if the file folder structure is changed through renaming. This behavior is unauthorized on certain server environment, because the ACL of the IEC Central path is different from the configured DiskOut ACL output folder.

You can toggle SkipRename in the DiskOut settings. If a DiskOut channel has a SkipRename set on it, it will always use the value set in the DiskOut channel. If SkipRename was never toggled in the DiskOut setting, it will use the property Runtime.Control.DiskOut.SkipRename value.

On the IEC Application Properties settings, go to the IEC Ad Hoc Property, then add Runtime.Control.DiskOut.SkipRename=true. Setting this property to true enables the IEC Send process to:

Copy the stored file in IEC Central path to the configured output folder.
Maintain the ACL of the targeted DiskOut output folder.
You use this mechanism for more efficient file transfer across two different file systems.

In Windows environment, the file copy function is three times slower than the file rename function. This value is negligible unless the file output size is large.

For more information on Windows Services, see http://support.microsoft.com/kb/180362/EN-US/.

FTP

Note: After you set the FTP protocol, send a test message to verify the new configuration parameters. The Send Test Message feature uses an empty manifest. As a result, using the MEC_InfixManifest unique file name class option will return a blank text when retrieving manifest properties.


Property groups	Description
Naming	Name and description for this channel.
Basic Configuration	Includes the host, port, URL path, file name, and file extension. The combined host, port, and URL path will form a correct URL. The URL is the path from the FTP Root to the folder that you connect to. For the File Name, refer to the documentation on disk protocol.
Unique File Name	For more information about Unique File Name, see the disk protocol.
User Configuration	Sets the user access to Anonymous, or specify a user name/password.

HTTP

Note: After you set the HTTP protocol, send a test message to verify the new configuration parameters.


Property groups	Description
Naming	Channel name and description.
Basic Configuration	Includes the host, port, URL path, and content type. The combined host, port, and URL path will form a correct URL. The URL is the path from HTTPRoot to the folder that you will connect to. Use the HTTP content type header to specify the content type returned. For example, a web browser. When an internet client (a browser) accesses a remote document using the current HTTP protocol (1.0 or 1.1), the server will inform the client what content type is returned based on the HTTP content-type header details. This is an authoritative information according to HTTP standards.
User Configuration	Sets user access to Anonymous, or specify a user name/password.

WebSphere MQ (MQSeries)

When you use MQ protocol, the Correlation ID is automatically managed in the message.

For a detailed description of MQ parameters, see the documentation on MQ.

Note:

After you set the WebSphere MQ (MQSeries), send a test message with the new configuration parameters.

When you use the user ID and password for authentication, or the default SYSTEM.DEFAULT.AUTHINFO.IDPWOS configuration, you must configure the ADOPT attribute to YES.

For more information, see https://www.ibm.com/support/knowledgecenter/en/SSFKSJ_9.0.0/com.ibm.mq.sec.doc/q113250_.htm.


Properties	Description
Naming	Channel name and description.
Queue	Adds the name of the MQ message queue where you will send messages.
Host	Adds the address to the MQ server.
Channel	Adds the name of the MQ channel to use.
Port	Adds the MQ port to use.
Queue Manager	Adds the name of the MQ Queue Manager.
Username	The user name to access the server.
Password	The user password to access the server.
Format	See the MQ manual for the meaning of different formats.
Character Set	Specifies the coded character set identifier of character data in a message.

MSMQ

MSMQ protocol window contains the queue name and the message label.

For a detailed description of MSMQ parameters, see the MSMQ manual.


Property groups	Description
Naming	Channel name and description.
Queue Name	Adds the name of the MSMQ queue where to send a message.
Message Label	Adds the label to a message.
Path name and Direct format	Defines the queue name format for this configuration.
Use transaction	Allows for transaction defined MSMQ connection.

Note: When you configure inbound or outbound MSMQ channels, the property configurations must match both ways. If a wrong combination of inbound or outbound MSMQ channel is configured, messages can disappear.

You can set the destination queues to public, private, transactional, non-transactional, or a combination of these. When distributed message queuing is created, IEC specifies the destination queue setting to public, private, transactional, non-transactional, or a combination of these.

This table shows the distributed message processing in IEC Send(Out).


	Public	Private
Transactional	Path name and Direct Format works for local and remote Works for Send and Receive (in and out channel) No support for remote Transactional Receive Works for remote Non-Transactional Receive	Path name and Direct Format works for local No support for remote private transactional queue
Non-transactional	Path name and Direct Format works for local and remote Works for Send and Receive (in and out channel) No support for remote Non-Transactional Receive Works for remote Non-Transactional Receive	Direct Format works for local and remote No support for remote private non-transactional queue Works for Send and Receive (in and out channel)

Note: In MSMQ 3.0, if a message is sent to a non-transactional queue within a transaction, or a transactional queue outside of a transaction, the send process completes, but the message is not delivered to the destination queue.

FTPScript


Property groups	Description
Channel Configuration	Specify a channel name, description, then select FTPScript protocol.
Basic Configuration	Defines the host, port, and send file name. Select a filename extension type (xml, txt, or zip).
Unique File name	Select this to make the file name unique, then select a unique file name class from the list.
User Configuration	Sets the user access to Anonymous or specify a user name/password.

Note: You can access the agreement's Send process for additional FTPScript protocol settings. You can select the FTP script to use, specify the values to the EDITABLE properties, and view the FTP scripts.

HTTPSync

Use HTTPSync protocol to be able to reply to messages received through the HTTPSyncIn receive channel.

When you use HTTPSync channel, the agreements must have a Send process with the HTTPSync protocol. After you define your HTTPSync, define an error handling process flow to handle and report custom error responses back to the requestor.

If message processing take too long, the host might terminate the connection due to a timeout.


Property groups	Description
Channel Configuration	Specify a channel name, description, then select HTTPSyncSend protocol.
Response Configuration	Defines the content type. Select Keep connection alive to maintain the communication line with the client.

IONDBOut


Property groups	Description
Channel Configuration	Specify a channel name, description, then select IONDbOut protocol.
Basic Configuration	Defines the JDBC driver class and Connection URI. For an example of JDBC driver class: `com.microsoft.sqlserver.jsdb.SQLServerDriver` For an example of Connection URI: `jdbc:sqlserver://localhost:1433;databaseName=<value>` Specify the username and password. Click Test Connection to test the basic configuration parameters.
Basic Configuration	Database Schema - the database schema where outgoing messages are written. For MSSQL - if this property is left blank the value defaults to dbo schema.
ION Outbox Configuration	Defines the source logical ID and tenant ID, for example: From Logical ID: `lid://infor.m3be.<value>` Tenant ID: `infor` Specify the message priority order. For example, 4 .

SFTPOut

SFTP connectivity supports ID and password authentication only. The SSH public key authentication is not supported in this version.

These are the recommended settings for SFTPOut:


Property groups	Description
Channel Configuration	Specify a channel name, description, then select SFTPOut protocol.
Basic Configuration	Defines the user name, host, port, ReadTimeOut, URL path, and file name. On the URL path field, specify `./output`. Select a filename extension type (xml, txt, or zip).
Unique File name	Select this to make the file name unique, then select a unique file name class from the list.
User Configuration	Specify a password or private key.
Proxy Configuration	Select No Proxy setting.