General options

Specify the path and file name of the log files to be read. The default location of a DSLS log file is C:\ProgramData\DassaultSystemes\LicenseServer\LogFiles\ on Windows or /var/DassaultSystemes/LicenseServer/LogFiles/ on Linux. For FLEXnet, you must specify the debug log file. If the log file is located on a remote server, you must copy it to a directory that is accessible by your local computer. This option is required.

Multiple log files can be specified in two ways:

• Use the -log option multiple times: -log first.log -log second.log

• Give a comma-separated list of the file names: -log first.log,second.log

Specify the type of license server being used with Abaqus: dsls or flexnet. This option is required and is case-sensitive (must be lowercase).

Specify the starting date and time for the reporting period. If the -start option is omitted, the reporting period begins with the oldest recorded item in the log files. The date and time must be specified in one of the following formats:

• dd-mmm-yyyy_hh:mm:ss

  For example, -start 01-jan-2012_09:00:00 indicates a starting time of 9:00 AM on January 1, 2012. Specifying a time is required, including hours, minutes, and seconds. The hour field (hh) must be entered in 24-hour format.

• -xhours or -xdays

  Use this format to pick a time or day in the past. For example, -start -6hours specifies a start time of six hours ago.

Specify the ending date and time for the reporting period. If the -end option is not specified, the reporting period ends with the most recent recorded item in the log files. The date and time must be specified in one of the following formats:

• dd-mmm-yyyy_hh:mm:ss

  For example, -end 31-mar-2012_18:00:00 indicates an ending time of 6:00 PM on March 31, 2012. Specifying a time is required, including hours, minutes, and seconds. The hour field (hh) must be entered in 24-hour format.

• -xhours or -xdays

  Use this format to pick a time or day in the past. For example, -end -3hours specifies an ending time of three hours ago.

Specify the type of report desired: export or query. If this option is omitted, the default is export. An export report provides the basic licensing session information, usually in tabular format or comma-separated values (CSV). The data can be optionally filtered or sorted. A query report lets you look at sessions in aggregate; you can operate on the raw data to calculate such things as maximum usage, peak usage, and averages. A query report divides the total time period into equal sized buckets. You choose the size of each time bucket with the -duration option. You can also use an export report to save the raw data to a CSV file, import it into an Excel spreadsheet, and perform custom calculations using your own tools.

Comma-separated list of accessors to be read from the log data. Accessors are the fields or columns of the output report. For example: -accessor username,checkout,duration. This option is required.

Use this option to obtain a list of the available report accessors. The basic accessors are as follows:

• duration—duration of the license session, in seconds

• username—username

• checkout—checkout date

• feature—Dassault Systèmes license feature (trigram); for example, QSD

• quantity—number of licenses requested

• project—custom project names or numbers recorded from the lmproject environment file parameter

• session—the internal session object that represents the licensing job; this is useful only when using the peak aggregator or designing your own custom aggregators

Filter the report data. The required format for this option is -filter accessor:value. The report output is filtered to include only data records for which accessor=value. You can include multiple accessor:value pairs in a comma-separated list; for example,

-filter username:tsmith,hostname:zulu

This example would produce a report showing license checkouts only from the user tsmith on the computer zulu. To create other filters, use the -custom option with a Python program.

Use this option to obtain a list of the available filters. The one built-in filter takes the form -filter accessor:value. If you create any custom filters using the -custom option, they will appear in this list.