Command-Line Options for Creating Reports

You can create and schedule various license and device reports using command-line options.

Command Description
-REPORT=DEVICE [-FILE=[Path]Filename] [-APPEND] 
[-INPUTFILE=[Path]\Filename][-EXPIRE=X_NUMBER_OF_DAYS]
Shows the server name, server ID, client alias, client ID, client type, and lease expiration dates for the specified device.
-REPORT=LICENSE [-FILE=[Path]Filename] [-APPEND] 
[-INPUTFILE=[Path]\Filename][-EXPIRE=X_NUMBER_OF_DAYS]
Shows details about the licenses to expire within the specified number of days, including the activation codes, the total and available number of licenses, the expiration dates, and the number of reserved licenses.
-REPORT=LICENSECOUNT [-FILE=[Path]Filename] [-APPEND] 
[-INPUTFILE=[Path]\Filename] 
[-PERCENT_REMAINING=X_PERCENTAGE_OF_LICENSES_REMAINING]
Shows the percentage of licenses available for each activation code, including the total and available number of licenses, and the number of reserved licenses.

This report defaults to a low instance count of 20% or less. Reserve licenses are not included in the available licenses.

-REPORT=LICENSE [-RESERVED] [-FILE=[Path]Filename] [-APPEND] 
[-INPUTFILE=[Path]\Filename]
Shows details about reserved licenses, including the activation codes, the total and available number of licenses, the number of in-use licenses, the number of reserved licenses, and the expiration dates.
-REPORT=[LICENSE|DEVICE]
Creates either a license or device type report. The reports generated are the same as clicking the "Save to File" button on the View Server Licenses or View Client. Computers pages in the License Server Configuration Tool.
Note: You cannot use LICENSE and DEVICE at the same time.
[-RESERVED]
Reports on reserved licenses.
-FILE=[Path]Filename

Specifies the output file name for the requested report. If Path is omitted, then the output file will be the same location as the directory that is used for the log file. This is typically the "My Documents" folder.

Note:
  • If the FILE parameter contains embedded spaces, you must use quotes around the entire parameter (for example, -FILE="C:\My Directory Structure\Output File.Txt").
  • If -FILE is omitted entirely, the default name is ProficyServerDeviceReport_<servername>.txt or ProficyServerLicenseReport_<servername>.txt
  • Both text and comma separated value reports are available, so the -FILE parameter can be either {FileName}.txt or {FileName}.csv.
-APPEND
Appends a new report to an existing report file. You can apply -APPEND to either a license report (-REPORT=LICENSE) or a device report (-REPORT=DEVICE).
Note: This parameter may be placed before or after the -FILE parameter.
-INPUTFILE=[Path]\Filename
An INI-formatted file containing one or more servers to include in the output report. If INPUTFILE is omitted, then the report uses the last connected server.
The file must have the format:
[FNESERVERS]
Count=2
; each server has the format of Servern=url:port
; url does not include the http:// prefix. 
; Server0=localhost:3333 ; this list starts at 0
Server0=localhost:3333
Server1=192.168.0.1:3333

The section and key names for all switches are case sensitive. To change the number of servers, change the Count parameter and add or remove Server= lines as necessary.

Note: If the INPUTFILE parameter contains embedded spaces, you must use quotes around the entire parameter (for example, -INPUTFILE="C:\My Directory Structure\ServerList.ini")
[-EXPIRE=X_NUMBER_OF_DAYS]
For a device-type report, provides a list of licenses that will expire within the specified number of days for a device client.

For a license-type report, provides a list of licenses that will expire within the specified number of days for all device clients.

[-PERCENT_REMAINING=X_PERCENTAGE_OF_LICENSES_REMAINING]
Reports on the percentage of licenses available for each product. The default is 20%.
[-SERVER=SERVER_NAME]
Reports on the specified server instead of the one you are currently using.
[-PORT=PORT_NUMBER]
Uses the specified port instead of the Local License Server default port of 3333.