IM Relationship Resolution Information Center, Version 4.2

Command syntax of the net change utility

The net change utility is a Java™-based tool that uses Java command syntax.

The syntax for the net change utility is:

java -server -jar jnce.jar --cfg-file=filename.ini
 --base-file=filename.base --new-file=inputfile
 --out-root=filename
Note: This command is wrapped.

The Java VM -server flag must always be included in the command line when running net change utility. Including this flag offers a significant performance increase.

Net change utility command switches

You can use the following command line switches to specify how net change utility works.

cfg-file=configfile
Specifies the net change utility configuration file to use for processing. All current configuration file parameters are supported, although the NCEID parameter is ignored. This switch is required.
base-file=filename
Specifies the current base file to use. The file must exist.
init
Creates a new base file. You must specify a KeyWidth on the command line or in a configuration file. You must also specify a file name for the new base file. For example,
--init --cfg-file=configfile --base-file=filename.base
or
--init --KeyWidth=100 --base-file=filename.base
new-file=newfilename
(Required) Specifies the incoming data file to process.
resizeKey
In cases where the record key of a base file is extremely long, resizing (shortening) the key might offer a significant processing speed increase.

Resizes KeyWidth of an existing base file. Requires the new KeyWidth size. If using a base file older than version 3.6, you must specify the CriteriaWidth.

--resizeKey --KeyWidth=50 --base-file=filename.base

out-root=rootname
(Required) Used to generate filenames for the following net change utility output files:
  • One new base file (filename.merge)
  • One or more difference files (filename-n.diff )
    where `n' is the number of the .diff file.
Note: The total number of files is specified in the next switch.
num-files=n
The number of difference files to create.

Use this switch only if you want more that one .diff file. To aid in processing speed, net change utility is designed to create results into a specified number of .diff files where it places one record in each file until the last file is reached, then starts again with the first file.

report-seen
Indicates net change utility uses the "Seen" action flag.

If you use this switch, the difference file includes the first instance of an unchanged record and marks it with a `S' action flag. The default is to ignore these records as duplicates.

do-delete
Indicates net change utility uses the `Delete" action flag. The net change utility performs a full comparison.
compress-base-file
Compresses the new base file.

Only use if absolutely necessary. Using the compress-base-file option can involve a significant performance cost.



Feedback

Last updated: 2009