Clicky

Command Line Utility

You can use the command line utility mxc.exe in batch files to execute a pre-defined extract job or to execute a new job by defining its extractions parameters.

Usage:

"drive:\path\mxc.exe" /parameter1 /parameter2 /parameter3 ...

The parameters can be:

  1. A *.xjob file saved with the ExtractEditor:  "drive:\path\mxc.exe" /JobFile:"apath\ajob.xjob"
  2. A file with parameters, one in each line: mxc.exe /File:"Path\afile.txt"
  3. Parameters separated by spaces: "drive:\path\mxc.exe" /parameter1 /parameter2 /parameter3 ...

You can find some examples here.

Command

Description

/JobFile:"filename"

Executes an extraction job

filename: The filename of an extraction job.
/JobFile:"d:\jobname.xjob"

/File:"filename"

Loads the parameters from a file

filename: The parameters file, one parameter on each line

Source Parameters

/LogFilename::"filename"

filename: The filename where the log will be optionally saved at the extraction end.

/SourceType:option

Email source type.

  • stiMailSrcSingleFiles
  • stiMailSrcPOP
  • stiMailSrcOutlookCom
  • stiMailSrcIMAP
  • stiMailSrcGmail
  • stiMailSrcYahooIMAP
  • stiMailSrcExchange
  • stiMailSrcOutlook
  • stiMailSrcOutlookMapi
  • stiMailSrcOutlookExpress
  • stiMailSrcWindowsMail
  • stiMailSrcWindowsLiveMail
  • stiMailSrcThunderbird
  • stiMailSrcIncrediMail
  • stiMailSrcEudora
  • stiMailSrcLocalArchive
  • stiMailSrcLocalStorage
  • stiMailSrcAmazonS3
  • stiMailSrcMbox

/SourceLocation:option

The location of the email client files. The Default location is where an email client stores its database. Use the slCustomLocation when you want to process files that have been copied and are stored on a folder other that the default.

  • slDefaultLocation
  • slCustomLocation

/SourceFile:"filename"

A file on disk inside quotation marks

Used when SourceLocation = slCustomLocation and a file is

/SourceFolder:"folder"

Parameter: A folder on disk inside quotation marks

Used when SourceLocation = slCustomLocation

/SourcePassword:text


/SourceProfileName:text

Used in Outlook and Exchange Server

Parameter: A profile name

/SourceAdminPrivilege

Used in Exchange Server to access all mailboxes. The user defined in the profile must be an Administrator

Folders

/SourceAllFolders

Process all folders in the email source

/SourceFolderInclude:"folder path"

The folder and all its sub folders will be processed

Parameter: A folder path inside quotation marks:

"Outlook\Sales\Jan 2014"

/SourceFolderExclude:"folder path"

The folder and all its sub folders will not be processed

Parameter: A folder path inside quotation marks

/SourceFolderDisable:"folder path"

The folder will not be processed and it will not be created at the target.

Parameter: A folder path inside quotation marks

Remote Server

/SourceServer:text

Used to connect to a remote server, like an IMAP server

/SourceServerPort:number

The server port

/SourceServerUserName:text

The user name

/SourceServerPassword:text

A password

/SourceServerUseSSL


/SourceImapAuthMechanism

You can login to an IMAP server using a name and password by default.

  • iamUserPassword (default)
  • iamCRAMMD5
  • iamNTLM
  • iamSASLPlain
  • iamSASLDigestMD5
  • iamKerberos
  • iamXOAUTH2

/SourceImapAuthorization

Used when logging in to Gmail using Oauth 2 authorization (iamXOAUTH2)

Amazon S3

/SourceAS3AwsAccesKey:text

S3 access key

/SourceAS3AwsSecretKey:text

S3 secret key

/SourceAS3BucketName:text

A bucket name

Options

/SourceDeleteMessages


/SourceIndexMessages


/SourceCopyToStorage


/SourceDownloadImages


/SourceDownloadManager


/SourceLoadPublicFolders


/SourceUseOutlookToReadMsgFiles


/SourceForceOnline


/SourceReplaceCharsFolderNames


/SourceInvalidChars:text


/SourceReplaceChar


Encryption

/SourceEncryptionAlgorithm:option

  • eaAES,
  • eaBlowfish
  • eaCAST
  • eaDES
  • eaIDEA
  • eaRC2
  • eaRC4
  • eaTEA
  • eaTripleDES
  • eaTwofish

/SourceEncryptionPassword:text


/SourceEncryptionPdfPassword:text


Mail Filters

/SourceFilterFrom:text


/SourceFilterTo:text


/SourceFilterSubject:text


/SourceFilterRecBefore:date

Received before. Date yyyymmdd

/SourceFilterRecAfter:date

Received after. Date yyyymmdd

/SourceFilterSentAge:option

  • fsaDate
  • fsaToday
  • fsaYesterday
  • fsaLastWeek
  • fsaLastMonth

/SourceFilterNotRead


Range Filters

/SourceFilterRangeStart:number

A number. The process will start at this number.

/SourceFilterRangeRange:number

A number. The number of messages that will be processed

/SourceFilterRangeCountFromEnd

Count from the end of a mailbox

Sampling Filters

/SourceFilterSampleSize:number

A number. The sample size.



Target Parameters

/TargetType:option

  • stiMailTarSingleFiles
  • stiMailTarCompilation
  • stiMailTarPrinter
  • stiMailTarEmailForwarder
  • stiMailTarExchange
  • stiMailTarOutlook
  • stiMailTarThunderbird
  • stiMailTarIMAP
  • stiMailTarGmail
  • stiMailTarOutlookCom
  • stiMailTarYahooIMAP
  • stiMailTarAmazonS3
  • stiMailTarMbox
  • stiMailTarLocalArchive
  • stiMailTarStorageLocal
  • stiMailTarEmailParts

/TargetImagesDownloadManager

Select this option to use the Download Manager to download the HTML linked images

/TargetDeleteFromSource


/TargetIncludeDownloadedImages


Single Files / Compilation / Email Parts

/TargetFileFormat:option

Depending on the target action select the type of file that will be created

Single Files:

  • ffSfMsg
  • ffSfEml
  • ffSfPdf
  • ffSfMht
  • ffSfHtm
  • ffSfTxt
  • ffSfRtf
  • ffSfTiff
  • ffSfPng
  • ffSfJpeg
  • ffSfBmp
  • ffSfGif
  • ffSfEmf
  • ffSfZip
  • ffSf7z

Compilation:

  • ffComPdf
  • ffComChm

Email Parts:

  • ffColExcel
  • ffColXlsx
  • ffColTxt
  • ffColXml
  • ffColSqL3

/TargetDuplicatedFiles:option

  • dfSkip
  • dfOverwrite
  • dfRename

/TargetFolder:"folder"


/TargetFile:"file"


/TargetFilenameScript:"file"


/TargetFilenameFormat:option

  • fnfDateFromToIdSubject
  • fnfDateFromIdSubject
  • fnfDateFromToSubject
  • fnfDateFromSubject
  • fnfUidFromSubject
  • fnfUidSubject
  • fnfUidDomain
  • fnfUid
  • fnfSource
  • fnfUserDefined

/TargetUserDefinedFileFormat:"text"

A text with the email fields separated by commas:

"fpSubmitDate, fpSubmitTime, fpFromAddress, fpSubject"

  • fpUniqueId
  • fpSubmitDate
  • fpSubmitTime
  • fpDeliveryDate
  • fpDeliveryTime
  • fpFromName
  • fpFromAddress
  • ftFromDomain
  • fpToAddress
  • ftToDomain
  • fpSubject
  • fpMessageId
  • fpSourceFilename
  • fpComputerName
  • fpUserName
  • fpDomainName
  • fpAttachmentSign

       

/TargetUserDefinedFileSeparator:character


/TargetSubFolderStructure:option

  • sfsDontCreateSubFolders
  • sfsLikeEmailSourceFolders
  • sfsCreateFromAddressPart
  • sfsCreateFromDomainPart
  • sfsFromDomainFromAddress

/TargetSubFolderPutComputerName


/TargetSubFolderPutUserName


Attachments

/TargetAttachmentsFolder:option

The placement of the 'Attachments' folder

  • afpCommonRoot
  • afpCommonSubfolder
  • afpSameFolderAsMessage
  • afpNamedAsMessage
  • afpNamedAsSenderAddress
  • afpNamedAsSenderDomain
  • afpNamedAsSenderDomainAddress

/TargetSaveInlineAttachments

Inline images will be saved to the 'Attachments' folder

/TargetSaveDwImagesToAttachFolder

Downloaded images will be saved to the 'Attachments' folder

/TargetUserAttachFilename:"text"

A text with the email fields separated by commas:

"fpSubmitDate, fpSubmitTime, fpFromAddress, fpSubject"

  • fpUniqueId
  • fpSubmitDate
  • fpSubmitTime
  • fpDeliveryDate
  • fpDeliveryTime
  • fpFromName
  • fpFromAddress
  • ftFromDomain
  • fpToAddress
  • ftToDomain
  • fpSubject
  • fpMessageId
  • fpSourceFilename
  • fpComputerName
  • fpUserName
  • fpDomainName
  • fpAttachmentSign

/TargetUserAttachSeparator:character

A character that separates the email fields

Compression

/TargetCompressionMethod:option

  • cmSevenZip
  • cmZip

/TargetEncryptionAlgorithm:option

Use without compression

  • eaAES
  • eaBlowfish
  • eaCAST
  • eaDES
  • eaIDEA
  • eaRC2
  • eaRC4
  • eaTEA
  • eaTripleDES
  • eaTwofish

/TargetZipEncrypt

When Zip compression is selected encrypt with AES256

/TargetSevenZipEncrypt

When Seven Zip compression is selected encrypt with AES256

/TargetEncryptionPassword:text


Options

/TargetInsertAttachments


/TargetShortEmailheaders


/TargetFullEmailheaders


/TargetIncludeDownloadedImages


/TargetEmbedImageAttachInBody


Page

/TargetPaperSize:option

  • psLetter
  • psLegal
  • psStatement
  • psTabloid
  • psLedger
  • psExecutive
  • psFolio
  • psA2
  • psA3
  • psA4
  • psA5
  • psA6
  • psB4
  • psB5
  • psISOB4

/TargetPaperOrientation:option

  • poPortrait
  • poLandscape

/TargetPaperTopMargin:number


/TargetPaperBottomMargin:number


/TargetPaperLeftMargin:number


/TargetPaperRightMargin:number


/TargetFitWidthToPage




Target IMAP: Gmail, Outlook.com, Yahoo Mail

/TargetServer:text

The IMAP Server

/TargetServerPort:number

The server port number

/TargetServerUserName:text

The mailbox name

/TargetServerPassword:text

The mailbox password

/TargetServerUseSSL


/TargetImapAuthMechanism

You can login to an IMAP server using a name and password by default.

  • iamUserPassword (default)
  • iamCRAMMD5
  • iamNTLM
  • iamSASLPlain
  • iamSASLDigestMD5
  • iamKerberos
  • iamXOAUTH2

/TargetImapAuthorization

Used when logging in to Gmail using Oauth 2 authorization (iamXOAUTH2)

/TargetIncludeDownloadedImages


TargetSubFolderStructure:option

  • sfsDontCreateSubFolders
  • sfsLikeEmailSourceFolders (default)
  • sfsCreateFromAddressPart
  • sfsCreateFromDomainPart
  • sfsFromDomainFromAddress

/TargetFolder:"text"

The IMAP target folder. All messages will be created under this folder

Ex. "Folder\Docs"



Target Outlook / Exchange

/TargetProfileName:text

Profile

/TargetMessageStore:text

When the target is Outlook it is the name of a target data store. If not used it will be the default message store.

Ex. "Personal Folders" , "APstFile.pst", "ab@abc.com"

In Exchange Server it is the name of the mailbox user:

Ex. "Mel Smith" , "Linda Jones"

/TargetFolder:"text"

That target folder path relative to the root .

"Special" folders must be placed in square bracketsExamples:

  "//[inbox]" opens the inbox

  "//[inbox]/sales/january" opens the january folder

TargetSubFolderStructure:option

  • sfsDontCreateSubFolders
  • sfsLikeEmailSourceFolders (default)
  • sfsCreateFromAddressPart
  • sfsCreateFromDomainPart
  • sfsFromDomainFromAddress

/TargetAdminPrivilege

Used in Exchange Server to access all mailboxes. The user defined in the profile must be an Administrator

Target Email Parts

/TargetFileFormat:option

The target file type

  • ffColExcel
  • ffColXlsx
  • ffColTxt
  • ffColXml
  • ffColSqL3

/TargetsColumnFields:text

A comma delimited text : "cfSubmitDate,cfFromAddress,cfSubject"

  • cfSubmitDate
  • cfDeliveryDate
  • cfFromName
  • cfFromAddress
  • cfToList
  • cfToComma
  • cfCCList
  • cfCcComma
  • cfSubject
  • cfHeaders
  • cfTextPart
  • cfHtmlPart,
  • cfMessageId
  • cfAttachCount
  • cfAttachList
  • cfAttachComma
  • cfPriority
  • cfXMailer
  • cfOrganization
  • cfReturnPath
  • cfEnvelopeTo
  • cfReplyTo
  • cfFilename
  • cfFolderName
  • cfLabels
  • cfFromIP
  • cfBounceType
  • cfBounceDescription
  • cfBounceRecipient

/TargetsColumnDelimiter:option

  • cfdNone
  • cdfFixed
  • cfdTab
  • cfdSemicolon
  • cfdComma
  • cfdSpace
  • cfdUserDefined

/TargetsColumnUserDelimiter:character


Still need help? Contact Us Contact Us