Input, output, and user feedback parameters

Subparameter

Description

-i <input_filename>

This subparameter specifies the name of an input file. The format of the input file is .csv. You can use an input file to specify the parameters and values that you want the tool to use when it runs a command.

You can use an input file for any parameter that has command line options. The first line of the input file is a comma-separated list of options that the columns represent. This list can be any non-empty subset of valid options in any order.

For Boolean options, such as -new_user_only, a column value of 0 or FALSE (not case-sensitive) turns off the option. All other values, including an empty value, turn on the option.

For example, you type the following command: besuseradminclient -username admin -password password -find_mail_store_user -i MyInputFile.csv

The MyInputFile.csv input file contains the following information:

-u,-new_user_only
USER1,0
USER2,false
USER3,FALSE
USER4
USER5
USER6, 1
USER7,true
USER8,TRUE
USER9,anything
This example produces the following results:
  • The find_mail_store_user command executes for users 1 to 3 and does not use the -new_user_only parameter.
  • The find_mail_store_user command executes for users 4 to 9 and uses the -new_user_only parameter.

-o <output_filename>

This subparameter generates an output file containing the results of the command, and specifies the name of the output file.

-v <level>

This subparameter provides detailed or verbose feedback for the options that you specified, depending on the level set. The <level> can be one of the following:
  • TRACE: This level shows all method entries, arguments, return values, and exits, as well as messages of earlier levels.
  • DEBUG: This level displays messages about logical blocks within methods, as well as messages of earlier levels.
  • INFO: This level displays normal feedback messages to the user, as well as messages of earlier levels.
  • WARN: This level displays exception messages, as well as messages of earlier levels.
  • ERROR: This level is not currently used.
  • FATAL: This level is not currently used.
-cmdTimeout <seconds>

This subparameter specifies the maximum amount of time (in seconds) to wait for a command to complete before the command times out.



Was this information helpful? Send us your comments.