Repository tools command to show the floating licenses information

Use the listIssuedFloatingLicenses command to list the issued floating licenses.

Purpose

The listIssuedFloatingLicenses command is used to show information about floating licenses that are currently issued on a running server.
Important: The server must be running when you run the command.

Parameters

Attribute Description Required Default
repositoryURL The connection URL for the server. No https://localhost:9443/application

where application is jts, ccm, rm, qm, gc, dcc, or relm.

adminUserId Admin user ID to login to the Jazz repository. No ADMIN
adminPassword Admin password to login to the Jazz repository. No ADMIN
credentialsFile The file containing the admin user's login credentials. No credentials.properties
certificateFile The file containing the admin user's login certificate. No none
smartCard The alias to login using a smart card, or ? to list available aliases. No none
logFile Path to the log file. No repotools-application_listIssuedFloatingLicenses.log

where application is jts, ccm, rm, qm, gc, dcc, or relm.

kerberos Authenticate with Windows user credentials using Kerberos/SPNEGO by setting to true. Or authenticate with Windows Integrated Authentication by setting to windows. No None

Example

The following example is for Jazz® Team Server. To use this command for other applications, run these options from the server directory:
  • IBM® Engineering Workflow Management (Change and Configuration Management application): repotools-ccm
  • IBM Engineering Requirements Management DOORS® Next (Requirements Management application): repotools-rm
  • IBM Engineering Test Management (Quality Management application): repotools-qm
  • Global Configuration Management: repotools-gc
  • Data Collection Component: repotools-dcc
  • IBM Engineering Lifecycle Optimization - Engineering Insights: repotools-relm

For Windows
operating system Open a command prompt and enter this command:

cd C:\Program Files\IBM\JazzTeamServer\server\
repotools-jts.bat -listIssuedFloatingLicenses repositoryURL=https://hostname.example.com/jts kerberos=true

For Unix
operating systems Open a command line and enter this command:

cd opt/IBM/JazzTeamServer/server/
./repotools-jts.sh -listIssuedFloatingLicenses repositoryURL=https://hostname.example.com/jts

Sample

The output is a list of checked out floating licenses that includes the name of the floating license, user ID, user name, and when the floating license lease expires.

Number of issued floating licenses: 2
license: Developer-Floating
User ID: a
User Name: a
Timeout: 115 minutes
license: Developer-Floating
User ID: b
User Name: b
Timeout: 119 minutes