Varicent Incentive Compensation Management Documentation

Using the CLI Tool to Overwrite Saved Imports

Use the CLI tool to overwrite a saved import file located in Varicent Incentive Compensation Management (ICM) on Cloud storage.

You must extract the IBM Varicent ICM Command Line Tool from the compressed folder that came with your release.

The overwrite parameter overwrites a saved import in Varicent ICM storage. The parameter should be used when there is an existing file in Varicent ICM storage with the same filename. It reuses an existing file ID. If the filename does not exist in Varicent ICM storage, the tool will create it. If the filename does exist, the tool will clear the content of the file and overwrite it with the new content.

  1. Open the command prompt.

  2. Navigate to the directory in which the import tool is stored.

  3. From the command-line, type the following at a command prompt to overwrite a saved import file:

    "IBM Varicent ICM Command Line Tool.exe" --host "<ICM address>" --username "<ICM login name>" 
    --password "<ICM login password>" --model "<model  name>" --function "importupload 
    --name "<filename>" --filepath "<file path>" --overwrite

    where, name is the name of the file that you want to overwrite and filepath is the location of the file that you want to import.

    Important

    Enclose the parameters with quotation marks "<name>" to prevent errors related to spaces in names.

    You must update your passwords in the command every time you update your admin client password.

The file uploads in small batches. If the tool runs successfully, it will return an exit code of 0. If it fails, the tool will return a non-zero exit code. If you rerun the overwrite command, it will clear the content of the file in Varicent ICM storage and overwrite it again.