Contact Optimization command-line utility

Also known as the ACOOptAdmin utility, you can use this utility to run Contact Optimization sessions from the command line.

Open a command prompt and go to the /tools/bin directory of the directory where you installed Contact Optimization.

ACOOptAdmin -sn session -u [password] [-async] [-locale localecode] [-stop]

The ACOOptAdmin utility has the following parameters:

  • -sn session: Specifies the Contact Optimization session name. This parameter is required. For example, to specify a session that is called HolidayFundRaiser, you would enter:

    ACOOptAdmin -sn HolidayFundRaiser

    If the session is in a folder, include the folder names separated by forward slashes (/) or backward slashes (\). For example:

    ACOOptAdmin -sn MktFolder/HolidayFundRaiser

    To allow spaces in your text, place double quotation marks around the session name. For example:

    ACOOptAdmin -sn "Holiday Mailing"
  • -u username: Specifies the user name that is used to log on to Contact Optimization. This parameter is required.
  • -p password: Specifies a password for the user name. This parameter can be omitted if the password is blank.
  • -async: Runs the Contact Optimization session asynchronously, returning immediately. This parameter is an optional. The default is to run the Contact Optimization utility synchronously, which returns when the Contact Optimization session finishes running.
  • -locale localecode: Specifies the language in which to print the messages that are generated by the Contact Optimization utility. This parameter is optional. The default is en_US.
  • -stop: Stops a running optimization session.

    This command does not stop the session instantly. Instead, it stops the session at the next logical step in the optimization algorithm. This method ensures a clean shutdown with no corruption of data. It can take a few minutes for the process to stop.

You can specify these parameters in any order on the command line.