Xprocess DLL Agent

The Xprocess DLL Agent is provided with Sterling Gentran:Server® and is used to prepare data for transmission to a Trading Partner, or to prepare data that you received from a Trading Partner. You invoke the Xprocess DLL Agent by selecting it from the Agent list on the Edit Delivery Rule dialog box, and then entering specific command line parameters.

For each message that meets the Delivery Rule criteria, the Xprocess DLL Agent opens the source message attachment, converts the data according to the option defined, and then writes the output into a new message attachment.

When using a <filename> parameter, you must specify a full path in addition to the filename.

The following table shows the valid command line options used with the Xprocess DLL Agent.

Option	Description
0	Converts any specified hexadecimal character [hexValue1] to another hexadecimal character [hexValue2]. Usage `0 <hexValue1> <hexValue2>` The following is an example of command line option 0. `0 0x0D 0x0A` In this example, hexValue 0x0D (carriage return) converts to hexValue 0x0A (line feed).
1	Appends the file you specify [inputFileToAppend] to the beginning of the data. This option is often used as a preprocessor when sending data to the AT&T GMS network. Usage `1 <inputFileToAppend>` The following is an example of command line option 1. `1 c:\file_directory\filename.txt`
2	Replaces the tilde, Carriage Return, and Line Feed characters with a single Carriage Return. This option is often used as a preprocessor when sending data to the GEIS network.
3	Replaces all Carriage Returns with tildes and removes all Line Feeds. This option is often used as a preprocessor when receiving data from the GEIS network.
4	Removes all Carriage Returns and Line Feeds.
5	Removes all Carriage Returns and Line Feeds and adds one hexadecimal character 0x1A to the end of the file. This option is often used as a preprocessor for the TDSI network.
6	Removes all hexadecimal 0x1A characters. This option is often used as a prepostprocessor for the TDSI network.
7	Adds GM header and trailer records and removes all Carriage Returns and Line Feeds. This option is often used as a preprocessor for GM. It creates a THS and THD segment for the header and a TTR for the trailer. Usage `7 <youruserid> <theiruserid> <fileonGMsystem>`
8	Replaces all tilde, Carriage Return, and Line Feed characters with a single Line Feed. This option is often used as a preprocessor when sending data to the MCI network.
9	Replaces all Line Feed characters with a tilde character. This option is often used as a preprocessor when receiving data from the MCI network.
10	Replaces all Carriage Returns with Carriage Return/Line Feeds. This option is often used when receiving files from the network.
11	Replaces a string of hexadecimal characters with a second string of hexadecimal characters. Note: Each hexadecimal value contains the prefix 0x, followed by a 2-digit hexadecimal value. Together, the prefix and the 2-digit hexadecimal value are considered 1 hexadecimal character. Usage `11 <hexString1> <hexString2>` The following is an example of command line option 11. `11 0x7e0x0d0x0a 0x7e` In this example, the first string contains three (3) hexadecimal characters. (0x7e, 0x0d, and 0x0a). The second string contains one hexadecimal character (0x7e).
12	Removes all occurrences of a hexadecimal string from a file. Usage `12 <StringToDrop>` The following is an example of command line option 12. `12 0x??0x??0x??`
13	Inserts a hexadecimal string at the specified increment [Nbr Bytes] in the input file. This option is typically used (but not limited to) blocking streamed EDI data. Usage `13 <NbrBytes> <HexStringToInsert>` The following is an example of command line option 13. `13 4 0x??0x??0x??...`
14	Strips MIME headers or any non-essential data from an incoming data file. This allows you to strip the header from the data before processing the file for translation. Usage `14 <data start tag>` where: `<data start tag>` is the point in the file where the actual data starts (such as ISA). This is not case-sensitive. Note: This delivery rule uses clear text, not hexadecimal.
15	For MIME messages, strips off MIME headers. Also decodes messages if base64 encoded. Note: If the message is not a MIME message, no action will be performed.

This table shows additional parameters used with the Xprocess DLL Agent.

Parameter	Description
`hexValue1`	A hexadecimal value in the format `0x??`. This parameter is used with the 0 option (described in the previous table) and is the character you want to replace in the data. Where: ?? is the hexadecimal value.
`hexValue2`	A hexadecimal value in the format `0x??`. This parameter is used with the 0 option (described in the previous table) and is the new character you are exchanging for hexValue1. Where: ?? is the hexadecimal value.
`hexString1`	A hexadecimal string in the format `0x??0x??..`. This parameter is used with option 11 (described in the previous table). Where: ?? is the hexadecimal value. Note: Each hexadecimal value contains the prefix 0x, followed by a 2-digit hexadecimal value. Together, the prefix and the 2-digit hexadecimal value are considered 1 hexadecimal character. For example: `0x7e0x0d0x0a` This example describes a hexadecimal string containing three hexadecimal characters.
`hexString2`	A hexadecimal string in the format `0x??0x??..`. This parameter is used with option 11 (described in the previous table). Where: ?? is the hexadecimal value. Note: Each hexadecimal value contains the prefix 0x, followed by a 2-digit hexadecimal value. Together, the prefix and the 2-digit hexadecimal value are considered 1 hexadecimal character. For example: `0x7e0x0d0x0a` This example describes a hexadecimal string containing three hexadecimal characters.
`inputFileToAppend`	Specifies a filename value. This parameter is used with the 1 option (described in the previous table) and represents the file that you want append to the beginning of the data. When using this parameter, the full path name is required.
`StringToDrop`	Specifies a hexadecimal string value. This parameter is used with the 12 option shown (described in the previous table) and represents the hexadecimal string value that you want to remove from a file.
`NbrBytes`	Specifies a predefined increment at which you want to insert a hexadecimal string value. This parameter is used with the 13 option (described in the previous table).
`HexStringToInsert`	Specifies a hexadecimal string value that you want to insert at a predefined increment. This parameter is used with the 13 option (described in the previous table).