Utility - agentLicenseUsageReportByAbsoluteDateRange

Utility - agentLicenseUsageReportByAbsoluteDateRange

Description :

This command generates a summary report and a detailed report that list the number of active agents and the kinds of jobs performed on these agents within a specified absolute date range. The reports are in CSV format.

Use the startDateString and endDateString arguments to specify the date range. Enclose all date strings in double quotes. Use the following syntax:

"yyyy/MM/dd HH:mm:ssZ"

where Z indicates the UTC timezone.

For example, to specify December 15, 2009, 3:14 PM in USA Mountain Time, you would specify:

"2009/12/15 15:00:14-0700"

To indicate this time for France, you would specify:

"2009/12/15 15:00:14+0100"

and so on.

Return type : java.lang.Void

Command Input :

Variable Name

Variable Type




The path to the location where you want to write the CSV report files, and (at the end of the path) a prefix for the names of the reports. The report names always end with _summary.csv and _details.csv.

For example, if you specify /tmp/report, then the following two reports will be stored in the /tmp directory: report_summary.csv and report_details.csv.



Start date, enclosed in double quotes. Use the format "yyyy/MM/dd HH:mm:ssZ"



End date, enclosed in double quotes. Use the format "yyyy/MM/dd HH:mm:ssZ" or "" (empty string) to indicate the current date and time (now).


The following example shows how to use this command to obtain a pair of reports for a specific date range.


blcli Utility agentLicenseUsageReportByAbsoluteDateRange /mydir/report "2013/01/12 01:02:04-0500" "" 

For examples of output reports, see Evaluating license and product usage trends.

Was this page helpful? Yes No Submitting... Thank you