Unsupported content This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Utility - agentLicenseUsageReportByRelativeDateRange

Utility - agentLicenseUsageReportByRelativeDateRange

Description :

This command generates a report that lists the number of active agents and the kinds of jobs performed on these agents within a specified relative date range. For example, you can request a report for the last n number of days, months, or years. The report is in XML format.

Note

This BLCLI command has been optimized in version 8.7 of BMC Server Automation. For earlier versions of BMC Server Automation, BMC recommends that you do not use it. Instead, you can use a script provided by BMC; obtain this script from BMC Communities.

Return type : java.lang.Void

Command Input :

Variable Name

Variable Type

Description

reportFilePath

String

The path to the location where you want to write the XML report file.

relativeRangeValue

String

Number of days/months/years

daysMonthsOrYears

String

day(s)/month(s)/year(s).

Examples :

Example

The following example shows how to use this command to obtain a report for the last month.

Script

blcli Utility agentLicenseUsageReportByRelativeDateRange /mydir/report.xml 1 month



Example

The following example shows how to use this command to obtain a report for the last 2 years.

Script

blcli Utility agentLicenseUsageReportByRelativeDateRange /mydir/report.xml 2 years

Example

The following example shows an output report for a period of 30 months.

Configuration Manager Agent Activity License Report
Date: Mon Nov 24 09:42:16 EST 2014
Selected Date Range: Thu May 24 09:42:16 EDT 2012    to    Mon Nov 24 09:42:16 EST 2014
BladeLogic Environment (Database URL): jdbc:oracle:thin:@localhost:1521:orcl
Currently Active Agent Count: 34
BladeLogic Manager Suite Type       Minimum BBSA Licenses Required to Enable Currently Used Functionality
Configuration Manager          14
Compliance Manager             0
Provisioning Manager           75
Configuration Manager + Compliance Manager or Server Automation Suite            5
Compliance Manager + Provisioning Manager or Server Automation Suite             0
Configuration Manager + Provisioning Manager or Server Automation Suite          10
Compliance Manager + Provisioning Manager + Configuration Manager or Server Automation Suite  0

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*