Command-Line Execution Capabilities

Several of the Voter Focus programs—listed in the table below—can be run from a system command line. A command-line string can be set up to run as a scheduled task after hours or at any time the program needs to be executed without operator intervention.

Note The set up of scheduled tasks is an Windows operating system activity, which is outside the Voter Focus system. If you do not know how to set up a scheduled task, contact your county's IT staff for assistance.

To run a command, navigate to I:\Vr6Sharedbinaries and enter:

voterfocus <program name> <parameters>

Program Parameters

Parameters must be separated by a space.

A space must be inserted between the parameter character and the parameter value.

-d

-e

-i

-o

-q

-r

database

election number

input file name

output file name

run Redistricting program after import

run type

All programs can be run with the optional parameter -d, which applies the program to one of the Voter Focus databases (Normal, Training, Redistricting, or Sandbox).

For example, to run the ElectionsManagement program against the Training database, you would enter:

voterfocus electionsmanagement -d training

If you omit the -d parameter, the program runs against the Normal database.

Several of the programs use additional parameters. To list the available parameters for a program, run the program with the help parameter:

voterfocus <program name> /?

Note Insert a space before the slash character.

Note Running the VoterCard and VoterLabel programs with the help parameter simply initiates the program as these programs are not run with other parameters.

These parameters are subject to change, so before inserting the command in a batch file, run the list to verify that the parameters you intend to use will perform the intended task.

Programs Executable from a Command Line

Program Name	Purpose	Must be run from Voter Focus server?	Parameters
ElectionsManagement	Freeze book-closing totals for a specified election.	No	Required: -e <election number> -r FreezeBookClosingTotals Optional: -d <database>
	Example—To freeze the book-closing totals for election 100 on the live database: voterfocus electionsmanagement -e 100 -r freezebookclosingtotals -d normal

FvrsBulkXfrs	Run the FVRS Bulk Transfers program.	Yes	Optional: -d <database>
FvrsNotes	Run the FVRS Notes program.	Yes	Optional: -d <database>
FvrsUpload	Run the FVRS Upload program.	Yes	Optional: -d <database>
IntegrityCheck	Run the Integrity Check program.	No	Required: -r IntegrityCheck Optional: -d <database> -o <output file name> Note The -o parameter specifies the name (and location, if not the default location) of the output text file, which documents runtime errors. If you don't supply a file name, errors are sent to the default location.
	Example: voterfocus integritycheck –r integritycheck

Redistricting	Run the Redistricting Update program	No	Required: -r Redist Optional: -d <database>
	Example—To run redistricting on the redistricting database: voterfocus redistricting –r redistrict –d redistricting

StreetUtilities	Import GIS data into the voter registration database.	No	Required: -r Maptitude or -r GeoElections or -r GISImport Note The -GISImport parameter value is for counties using the Generic GIS interface to Voter Focus. -i <input file name> Note The -i parameter specifies the name (and location if program is not run from the same location) of the file to be processed. Optional: -o <output file name> Note The -o parameter specifies the name (and location if not the default location) of the output text file, which documents runtime errors. If you don't supply a file name, errors are sent to the default location. -d <database> -q Note The -q parameter instructs the program to run the Redistricting program after the GIS import finishes.
	Example—To do a GeoElections run on the Training database followed by a redistricting run using these files: Import file: c:\geoimp\2342333.txt Output file: c:\GeoelectionsErrors enter this command: voterfocus streetutilities –r GeoElections –d Training –I c:\geoimp\2342333.txt –o c:\GeoelectionsErrors –q Example—To use the same import file but have the program use the default name and location for the output file: voterfocus streetutilities –r GeoElections –d Training –I c:\geoimp\2342333.txt –q

SystemUtilities	To run the Recalculate Totals program or create a Sandbox database.	No	Required: -r RecalcTotals or -r CreateSandboxDatabase -i <input file name) Note The -i parameter specifies the name (and location if program is not run from the same location) of the file to be processed. Optional: -o <output file name> Note The -o parameter specifies the name (and location if not the default location) of the output text file, which documents runtime errors. If you don't supply a file name, errors are sent to the default location. -d <database>
	Example—To recalculate voter registration totals on the production database: voterfocus systemutilities -r recalctotals -d normal

VoterCard	Run the VoterCard program.	No	Optional: -d <database> Note Running in a database other than Normal would be unusual in a county environment. This parameter is intended for testing by VR Systems.
VoterLabel	Run the VoterLabel program.	No	Optional: -d <database> Note Running in a database other than Normal would be unusual in a county environment. This parameter is intended for testing by VR Systems.