Commander Switch Usage

INGRESSOR COMMANDER SWITCH USAGE

Switch1

Brief Description

Required?

Description

-DEX

Deletes all exchange records

Optional

Retains all SMTP, MAPI, MAPIPDL, and FAX record contents.

-L2

Log File Name

Optional

Log file name with full path. If not specified then the default will be ingressor.log, which is stored in the same directory with the executable file. 

-E2

Export NK2 contents to text file

Optional

Export file with full path. When used a complete filename should be used.  (Not supported in DEMO version)

-P

Path to location of NK2 file

Required

NK2 filename with full path

-IMP

Import File Name

Optional

Import filename with full path. See formatting instructions below.

-D

Definition File Name

Optional

A file used to specify a group of rules to be applied.

-SD

Search and Delete

Optional

Search for any records containing a given value and delete that entire record

-S

Search

Optional

Search for any records containing a given value.  Usually used in conjunction with another switch like replace.  The Search and Replace switches are interdependent upon each other.

-R

Replace

Optional

Replaces selected record with desired string or value

-DSMTPALL

Deletes all SMTP records

Optional

Deletes SMTP records while retaining Exchange records

-DSMTP

Deletes SMTP records with no "@" sign

Optional

Deletes only those SMTP records with no "@" sign

1All switches are followed by the "=" sign with NO spaces

2The LOG or EXPORT file locations require write access.

A sample command line may appear as follows:

Ingressor.exe -P=C:\Documents and Settings\Administrator\Application Data\Microsoft\Outlook\Outlook.NK2-dex-L=C:\Ingressor\Ingressor.log -E=Ingressor_export.txt  -D=C:\Ingressor\Ingressor_Def.txt

A sample definition file may contain:

Reference

Input Example                <TAB>

Output Example

1

somedomain.com

ingressor.com

2

hotmail

HOTMAIL

3

dana

DANA

4

Chaparral

5

Paul

PAUL

6

Dynamic Computing Solutions

DCS

7

TREVISAN

A string followed by <tab> and another string will be interpreted as SEARCH and REPLACE (line 1, 2, 3, 5, 6)

A string by itself will be interpreted as SEARCH and DELETE (line 4, 7)

A sample import file format would appear as follows: 

(Comma or Tab delimited values are acceptable)

"EX","JohnDoe","/c=US/o=GOV/ou=NAVY/cn=ENG/cn=jdoe"

"EX","jglenn","/c=US/o=GOV/ou=NAVY/cn=ENG/cn=jglenn"

"EX","bates","/c=US/o=GOV/ou=NAVY/cn=ACCT/cn=bates"

"EX","gbush","/c=US/o=GOV/ou=NAVY/cn=ACCT/cn=gbush"

"EX","Cpowell","/c=US/o=GOV/ou=NAVY/cn=ACCT/cn=cpowell"

"EX","mjordan","/c=US/o=GOV/ou=DOD/cn=ENG/cn=mjordon"

"EX","vputin","/c=US/o=GOV/ou=DOD/cn=ENG/cn=vputin"

"EX","binman","/c=US/o=GOV/ou=ARMY/cn=ENG/cn=binman"

"EX","jclark","/c=US/o=GOV/ou=ARMY/cn=ACCT/cn=jclark"

"EX","dkeith","/c=US/o=GOV/ou=ARMY/cn=LOG/cn=dkeith"

"SMTP","Support","support@microsoft.com"

"SMTP","HelpDesk","itsupport@boeing.com"

"SMTP","Sales","sales@enroll.com"

"SMTP","Paul Newman","pnewman@greatsauces.com"

"SMTP","Pat Sajack",pat_sajack@WheelOfFortune.com

An example of a log file may appear as follows depending upon the switches used:

Command line : E:\NK2FileDirectory\DCS\Ingressor\Server\Exchange Command Line\Ingressor.exe -p=E:\NK2 Files\Exchange.NK2 -dex -imp=E:\NK2 Files\galexport33.txt -E=test_export.txt
*********************************************************************
Running on 2/28/2006 11:03:06 PM
Initializing
Server IP Address: 192.168.254.254
Server Port: 9691
Timeout: 10
Server Serial Number: B317E124D9E3A59E8642EFC3
Reading registry database completed
Number of opened NK2 files = 4
Deleting all exchange records
Reading NK2 file ...
Reading completed
Backing up current NK2 (E:\NK2 FILES\EXCHANGE.NK2) file to E:\NK2 FILES\EXCHANGE.NK2.20060228-230307
Back-up completed
Number of entries before processing = 256
Start processing ...
Writing NK2 file ...
Importing from E:\NK2 FILES\GALEXPORT33.TXT

Number of entries after processing = 421
Exporting data to TEST_EXPORT.TXT
Export complete
Processing completed
Writing completed
Done

The output from the log file can produce some added benefits.  One example would be to write a script that will read the number of records processed (see highlight section above) and automatically generate an email to the NK2 file's owner when the size nears it's maximum limit of 1,000 entries.