Command-line syntax
Use the command-line syntax to process a data masking request.
To invoke the command-line interface, open a command prompt to the directory that contains the application command file, or include the directory in the PATH environment variable.
The command-line process uses the following syntax:
{ IOQMASKINGTOOL.BAT | IOQMASKINGTOOL.SH }
{--INPUT| -I} configuration_file_path [{--HADOOP | -H}]
[{--DEBUG-LEVEL | -D} { SEVERE | WARNING | INFO | FINE | FINER | FINEST | ALL } ]
[{--DEBUG-FILE | -F } debug_file_path ]
[{--REPORTING-PERCENT | -P} percentage ] [{--REPORT | -R}]
- IOQMASKINGTOOL.BAT
- For Windows platforms only. The data privacy application batch script command file, located in the \mod\MODApp installation directory of the data privacy application.
- IOQMASKINGTOOL.SH
- For Linux® platforms only. The data privacy application shell script command file, located in the /mod/MODApp installation directory of the data privacy application.
- --INPUT (or -I)
- The location of the configuration file.
- --HADOOP (or -H)
- Indicates that the configuration file is on a Hadoop file system. Important: If you use the IOQHadoopMasking.sh file, described in Masking in Hadoop, to mask data, do not specify the --HADOOP (or -H) syntax. The --HADOOP or -H syntax is not needed in that case because the edited IOQHadoopMasking.sh file includes that syntax. The --HADOOP (or -H) syntax is required only if you use the IOQMASKINGTOOL.SH file to mask data in Hadoop.
- --DEBUG-LEVEL (or-D)
- Specifies the type of log messages to produce. A lower level of
severity also includes log messages from higher-severity levels. Enter
one of the following options, which are listed in descending order
of severity.
- SEVERE
- Log only serious errors, such as when masking fails because the mask string is invalid.
- WARNING
- Log warning messages that require a warning, such as when there are duplicate keywords in the configuration file.
- INFO
- Log information messages, such as when the application starts.
- FINE
- Log tracing information.
- FINER
- Log fairly detailed tracing information.
- FINEST
- Log highly detailed tracing information.
- ALL
- Log all messages.
- --DEBUG-FILE (or -F)
- The location of the log file.
- --REPORTING-PERCENT (or -P)
- Specifies the frequency at which the console generates status messages during the masking process. Enter a percentage value in the range 1 - 100. For example, if you specify 10, the console generates a message for every 10% of masking that is complete.
- --REPORT (or -R)
- Specifies that the process report will not open in a browser after the masking process completes.
Examples
The following example shows the command-line string for a Windows platform. The console will generate a status message for every 25% of processing. All debug messages will appear in the log file. The processing report will open in a browser after processing.
IOQMaskingTool.bat -i c:\masking\cfg\sample.ioqmoda -p 25 -r -d all -f sampleDebug.xml