Command Central 10.3 | Command Central Developer Reference | Using the Command Line Interface | Options for the Commands | log
 
log
Specifies a file where you want to log the outcome from the execution of the command, whether the command completes successfully or encounters errors. If you do not specify the {--log | -l} option, the command logs this error information to the console.
The logged results include:
*Service output
*Errors that occur while interpreting the command
Note:
If the error occurs while the initializing the command, the error is written to the console rather than the file specified with the {--log | -l} option
*Debug information if the {--debug | -d} option is specified on the command
Syntax
--log | -l file
Arguments
Argument
Description
file
Specifies the log file where you want the errors written. If the file you specify does not exist, the command creates it. You can specify:
*Absolute directory path and filename.
*Relative directory path and filename. The path is relative from where you initiated the command.
*Filename of a file in the same directory where you initiated the command.
Usage Notes
*If you use the {--output | -o} option with the {--log | -l} option and the command completes successfully, the command writes the results to the output file and logs the outcome to the log file.
*If you use the {--error | -r} option with the {--log | -l} option and the command encounters an error, the command writes the error results to the error file and logs the outcome to the log file.
*If a command uses the {--debug | -d} command, the debug information is also written to the log file.
*If the file you specify with the {--log | -l} option already exists, the command appends the new service results to the file.
*The error information includes a timestamp. Using this option for commands generates a history of the command execution and actions.
Examples
*To log information to a file named “logfile.xml” in the directory c:\outputs:
--log c:\outputs\logfile.xml
*To log information to a file named “logfile.json” in the \outputs directory relative to where you initiate the command:
--log outputs\logfile.json
*To log information to a file named “logfile” in the same directory from where you initiate the command:
--log logfile