EmiaCtrlLite | Emia4Win | DecMsgX | DecMime

DecMsgX (decmsgx.exe)Documentation 0.3BV561 | Back



DecMsgX is a utility for managing the decoding of attachments. Unlike it's predeceaser DecMime, DecMsgX can Decode Multiple MIME(BASE64 and UUE) attachments, both ASCII and BINARY. DecMsgX also has advanced features for performing batch jobs.


DecMsgX (c) 2003 Jeremy Aiyadurai. All Rights Reserved. DecMsgX is NOT free software. The user must purchase a valid license to use it, or get a FREE 30 Trial License.
The DecMsgX software is provided as is without any warranty of any kind. The entire risk arising out of the use or performance of this product and documentation remains with recipient. To the maximum extent permitted by applicable law, in no event shall program DecMsgX or its suppliers be liable for any consequential, incidental, direct, indirect, special, punitive, recursive, or other damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, personal injury, disruption of family life, or other pecuniary loss) arising out of this agreement or the use of or inability to use the product DecMsgX.



[TOP]DecMsgX vs. Decmime

The Following table compares DecMsgX advantages over DecMime.

Features DecMsgX DecMime
Base64 Decoding Yes Yes
UUE Decoding Yes No
Intelligent MIME identification Yes No
Force decoding capability Yes No
Recursive Dir (eq. C:/Mail) tree Decoding Yes No
ASCII attachment Decoding support Yes No
Multiple/Multipart MIME Attachment Decoding support Yes No
Stand-Alone Software Yes No
[TOP]DecMsgX Syntax

Decoding while retrieving mail:

"decmsgx get /proto:[pr] /svr:[p] /port:[pn] /id:[i] /pass:[pd] /msg:[n] /DEL:[D] /out:[o] [/force:[f]]"

pr: mail server protocol ( "pop3" or "imap")
: POP3/IMAP mail server (eg: mail.domain.com)
pn: POP3/IMAP port
i: POP3/IMAP username
pd: POP3/IMAP password

n: message number
D: delete message = 1
keep on server = 0
o: Output disk-path (eg. /Mail)
- optional args:
f: force "base64" decode or "uu" for uudecode

Decoding a single downloaded MIME message:

"decmsgx decode /src:[s] [ /force:[f] ]"

s: source MESSAGE.# file
- optional args:
f: force "base64" decode or "uu" for uudecode

Recursively Decoding all downloaded MIME messages:

"decmsgx rdecode /dir:[s] [ /force:[f] ] [ fall ]"

s: source directory (eg. /mail)
- optional args:
f: force "base64" decode or "uu" for uudecode
fall: ("f"orce "all") attempts decoding all messages whether there is an attachment or not.

[TOP]Installation and Notes

In order to use DecMsgX, you must purchase a license, or get a FREE 30 Day Trial License. Place the license in this dir: C:\Documents and Settings\All Users\Application Data\decmsgx. If the path does not exist, create it.

-DecMsgX supports both Base64 and UUE decoding. For best results, it is recommended that Base64 should be in the forced mode of decoding, because Base64 mime attachments are widely used. To achieve this result, use the /force: switch: eg.
decmsgx get /proto:pop3 /svr:mail.host.com /port:110 /id:test /pass:pass /msg:1 /DEL:0 /out:/ /force:base64
decmsgx decode /src:mail/test/message.1 /force:base64
decmsgx rdecode /dir:c:/mail /force:base64

[TOP] DecMsgX version History

Version 0.1
-first release
Version 0.2
-now stand-alone, does not require Emia4Win.
Version 0.3BV561
- fixed decode and rdecode functionality bug
Version 0.4CV580A
- fixed rdecode bug

[TOP]DecMsgX for VBScript/VBA/ASP Overview


DecMsgX now supports VBScript/VBA/ASP, by deploying a component DLL that takes care of the processes.
It requires that you have the Microsoft .NET Framework Redistributable installed. *EmiaCom.dll is not standalone. It requires Emia4Win (emia.exe) and DecMsgX (decmsgx.exe)
Once installed, you must register the component by typing at the console "regasm EmiaCom.dll /tlb /codebase"
Please Note: In order to use EmiaCom with ASP on IIS, you must set "Application Protection" to "Low" and "Execute Permissions" to "Scripts only" or "Scripts and Executables" under the "Home Directory" Tab in website properties.

EmiaCom.dll Copyright and Disclaimer (GNU Lesser General Public License).

Name: EmiaCom Version 1.0. Description: library to be used with Emia (Emia4win)/ DecMsgX / DecMime.
Copyright (C) 2002/2003 Jeremy Aiyadurai

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

Download the open source EmiaCom.dll package here


METHODS for Decoding MIME BASE64 and UUE attachments
ProgID = "EmiaCom.DecMsgX"

  • void set_DecMsgX(string server,string proto*,int pport,string uid, string pwd,string pathtodecmsgx)
  • string mimeDecodeDownload(int msgnum,int DEL,string outputdir,string mode*)
  • void mimeDecodeStored(string src,string mode*)
  • void mimeRDecodeStored(string dir,string mode*,int forceAll*)

*proto = "pop3" or "imap"
*mode (/force: mode) = "AUTO" ,"base64" or "uu"
*forceAll = 1 or 0


[TOP]explicitly decoding a stored message via VBScript
dim pop3
Set pop3 = CreateObject("EmiaCom.DecMsgX")

pop3.set_DecMsgX "","",0,"","","C:\path\to\decmsgxroot"
pop3.mimeDecodeStored "C:/path/to/MESSAGE.1","base64"

[TOP]explicitly decoding while downloading message via VBScript

dim pop3,svr,port,id,pass,msgnum,DEL,outputdir,MODE,PROTO
svr = "mail.host.com"
port = 110
id = "johndoe"
pass = "*********"
msgnum = 1
DEL = 0
outputdir = "/mail"
MODE = "base64"

PROTO = "pop3"
Set pop3 = CreateObject("EmiaCom.DecMsgX")

pop3.set_DecMsgX svr,PROTO,port,id,pass,"C:\path\to\decmsgxroot"
pop3.mimeDecodeDownload msgnum,DEL,outputdir,MODE



© 2002/2003 Jeremy Aiyadurai . All Rights Reserved