sagcc get license-tools reports aggregated reportid

Generates a file that contains:

An existing aggregated report in PDF, XML, or JSON format. An aggregated license report contains the metered data for all installed products and all licenses in all up-to-date license manifest files.

Metered data based on the total product usage per month and the base and peak licenses in PDF, XML, or JSON format. Command Central extracts the data for the aggregated usage report from an existing aggregated license report.

A list of the products, which require metering in XML or JSON format. Products that require metering have a metering tag that is not empty and not marked with "MNO" in the license key or license manifest file.

Syntax

Command Central syntax:

To generate a complete aggregated license report:

sagcc get license-tools reports aggregated reportid
--output-format.{pdf|xml|json} --output filename.{pdf|xml|json}

To generate a usage, or a metering-only report:

sagcc get license-tools reports aggregated [{usage | meteringonly}] reportid
--output-format.{pdf|xml|json} --output filename.{pdf|xml|json}

Not supported on Platform Manager.

Arguments and Options

Argument or Option	Description
[{usage \| meteringonly}]	Optional. The type of report to generate: usage - contains the billing information of all products that require metering. meteringonly - contains a list of products that require metering. The supported output format is only XML and JSON. To generate a complete aggregated license report, omit this argument.
reportid	Required. The ID of the aggregated report for which to generate a PDF, XML, or JSON file. The report ID is case-sensitive.
--output-format. {pdf\|xml\|json}	Required. Specifies the format of the generated output. For more information, see output-format.
--output filename. {pdf\|xml\|json}	Required. Specifies a name for the output file. For more information, see output.

Usage Notes

You can archive an aggregated report by downloading it in XML format. You can later add the report back to Command Central, using the following command:

sagcc add license-tools reports aggregated {--input|-i}filename.xml

To provide billing information to Software AG, which will be used by Software AG to generate your invoice, create a usage report in XML format.

Examples When Executing on Command Central

To archive an aggregated report with ID Jun2018 in the current directory:

sagcc get license-tools reports aggregated Jun2018
--output-format xml --output Jun2018.xml

To then add the archived aggregated report in Command Central:

sagcc add license-tools reports aggregated -i Jun2018.xml

To generate a PDF file for an aggregated report with ID Jun2018 and save the generated report file in the current directory:

sagcc get license-tools reports aggregated Jun2018
--output-format pdf --output Jun2018.pdf

To generate a JSON file for an aggregated report with ID Jun2018 and save the generated report file in the current directory:

sagcc get license-tools reports aggregated Jun2015
--output-format json --output Jun2018.js

To generate a PDF file for a usage report with ID Jun2018 and save the generated report file in the current directory:

sagcc get license-tools reports aggregated usage Jun2018
--output-format pdf --output Jun2018.pdf

To generate an XML file for a usage report with ID Jun2018, which you can send to Software AG for creating an invoice, and save the generated report file in the current directory:

sagcc get license-tools reports aggregated usage Jun2018
--output-format xml --output Jun2018.xml

To generate a JSON file for a metering-only report with ID Jun2018 and save the generated report file in the current directory:

sagcc get license-tools reports aggregated meteringonly Jun2018
--output-format json --output Jun2018.js