Previous Topic

Next Topic

Book Contents

Book Index

Input File

The input file is a text file in .INI file format, with one input value per line.

Sample file


[Params] 
Host=172.16.23.204 
SSL=False 
Port=6280 
SSLFingerprint= 
User=micentral 
Password=G7z3fN9wP 
Recipient=translate:moveit 
Sender=X850TEST 
MIMEType= 
ExceptionsInsteadOfData=True 
FilenameToProcess=C:\TEMP\MIC\c88-0002\atc10001.tmp 
OriginalFilename=X850test-MultOut.txt OutputDir=C:\TEMP\MIC\c88-0002 
MaxSeconds=300 
PollIntervalSeconds=5 
TraceFilename= 
ForceAtLeastSeconds=20

Input Values

All values are required except where marked optional.

Name

Description

Host

The hostname or IP address of the MessageWay server.

SSL

True if SSL should be used, else False. Note: if you use SSL, you must specify the MessageWay server's certificate's fingerprint in SSLFingerprint. If the server is on the same computer as MOVEit Automation, you can safely specify False here and avoid having to know the certificate's fingerprint.

Port

The TCP port to which the program should connect. Typically 6280 if not SSL, or 6243 if SSL.

SSLFingerprint

(Optional) Hexadecimal fingerprint (MD5 or SHA1) of the server's certificate. Required if SSL is True. (There is no way to specify that any certificate should be accepted.) The string consists of groups of 2 hex characters separated by spaces.

User

The MessageWay username. This user must have sufficient permission to access the recipient location.

Password

The password of the MessageWay user.

Recipient

Destination (in MessageWay terminology) of the translated files. Typically this will be something like translate:moveit, which means that there must be a translation location named translate and a mailbox named moveit configured in MessageWay. The specified user must have sufficient access to these locations.

Sender

An arbitrary sender's name. The MessageWay translation engine may base its translation partly on the sender's name.

MIMEType

(Optional) An arbitrary MIME type string.

ExceptionsInsteadOfData

Indicates how the script behaves when any exception occurs (meaning poorly formatted data). Values:

True - no data files should be returned if an exception occurs; instead, the exception report files are returned.

False (default) - only data files are returned. If False and exceptions do occur, you will have to look up the exception reports directly through MessageWay.

FilenameToProcess

The full path to the input data file to process.

Note: MessageWay is not informed of this filename; instead, MessageWay is told that the filename is the value specified in OriginalFilename.

OriginalFilename

The filename to provide to MessageWay. Do not include a path in this filename. Depending upon how MessageWay is configured, the type of processing done may be partially determined by this filename.

OutputDir

The full path of the directory into which xformviamway should write its data and report files. For example, C:\data\xlate.

MaxSeconds

(Optional) The maximum number of seconds to wait for MessageWay to process the file. A value of 0 means no limit. Can include macros. Defaults to 7200 (two hours).

PollIntervalSeconds

(Optional) The number of seconds to wait between queries to MessageWay to determine whether processing has completed. May include macros. Defaults to 5 seconds.

TraceFilename

(Optional) The full path to a file which will receive a detailed trace log of xformviamway's communications with the MessageWay server. For example, C:\tmp\MWTrace.txt. Use this parameter only to debug problems interacting with the MessageWay server.

ForceAtLeastSeconds

(Optional) A rarely-used parameter which specifies the minimum amount of time that xformviamway should take before responding. Specified as an integer number of seconds. If specified, xformviamway will wait until at least ForceAtLeastSeconds seconds have passed before returning, even if the processing was complete before that amount of time. This parameter was implemented to allow testing of progress bars.