query SCC modcount data to provide usage info. sorted by module, project or user perspective.
Usage:
query_modcount [ --before_date|-b before_date ]
[ --after_date|-a after_date ]
[ --sortby|-s module|proj|user ]
[ --line_limit|-n total_lines_to_show ]
[ --verbose|-v ] [ --version|-V ]
[ --module|-m modname]
[ --user|-u login]
[ --proj|-p projname]
[ --help|-h]
where:
before_date: yyyy-mm-dd; end date of the date range, if not present, or the date given is beyond current date, it will be the set to one day before the current date
after_date: yyyy-mm-dd; start date of the date range, 1) if not present, will be one month earlier than before_date;2) the earliest date is 2017-09-01
sortby: the field we will use to sort the count, by default, using a decreasing order. module: sort module usage count according to module, from the most used module to the least proj: sort by module usage count according to project, from the most used project to least
user: sort by module usage count according to user, from the most frequent user to the least
line_limit: total lines to display in the result, -1 means show all, and it is also the default
verbose: if verbose is true, print out all the detailed count data at the individula module/project/user level. All the numbers in the parentheses are the number of usage count associated. Otherwise, print only the top level numbers. version: show the version of the tool
module: specific module to look for, if given in modname/modver form, then the result will also be limited to the particular version only
user: look for specific user by his/her login name
proj: look for specific project usage count help: Prints out this help message
Example #1 get the brief/long description about the command: query_modcount # brief
query_modcount -h # long
query_modcount -V # version info
Example #2 get module statistics sort by module name (this is default):
query_modcount -a 2023-10-01 # all module usages after 2023-10-01, sort by module name
query_modcount --after_date 2023-10-01 --before_date 2023-12-31 -v -p ms-dental # get detailed usage for 'ms-dental' project from 2023-10-01 to 2023-12-31 sort by module
these two commands are equivalent: query_modcount -a 2023-10-01 -p rcs-user -s module query_modcount -a 2023-10-01 -p rcs-user
Example #3 get module statistics sort by project name:
query_modcount -s proj # return all module usage
query_modcount -a 2023-10-01 -s proj # return all module usages after 2023-10-01
query_modcount --after_date 2023-10-01 --before_date 2023-12-31 --sortby proj -v -p ms-dental # get detailed usage for 'ms-dental' project from 2023-10-01 to 2023-12-31
Example #4 get module statistics sort by user name:
query_modcount -s user
query_modcount -a 2023-10-01 -b 2023-12-31 -s user -n 20
query_modcount -a 2023-10-01 -b 2023-12-31 -s user -v
##NOTES: call command without any parameters will show the short command line usage message: $ query_modcount
Usage:
query_modcount [ --before_date|-b before_date ]
[ --after_date|-a after_date ]
[ --sortby|-s module|proj|user ]
[ --line_limit|-n total_lines_to_show ]
[ --verbose|-v ] [ --version|-V ]
[ --module|-m modname]
[ --user|-u login]
[ --proj|-p projname]
[ --help|-h]