TeamcenterKnowledge

Configuration utilities > Organization

license_usage

Displays the number of seat-level licenses that are being used for each license server. This information is needed to determine whether unassigned licenses are available, or more licenses need to be purchased in order to create or modify users via the Organization application or the make_user utility. Syntax license_usage [-u=user-id {-p=password | -pf=password-file} -g=group] arguments [-h] arguments can include one or more of the following: -licenseserver=license-server -licenselevel=license-level -all Arguments -u Specifies the user ID. This is the user ID of a user with administration privileges. If this argument is used without a value, the operating system user name is used. Note If Security Services single sign-on (SSO) is enabled for your server, the -u and -p arguments are authenticated externally through SSO rather than being authenticated against the Teamcenter database. If you do not supply these arguments, the utility attempts to join an existing SSO session. If no session is found, you are prompted to enter a user ID and password. -p Specifies the password. If this argument is not used, the system assumes the user-id value to be the password. This argument is mutually exclusive with the -pf argument. -pf Specifies the password file. If used without a value, the system assumes a null value. If this argument is not used, the system assumes the user-id value to be the password. This argument is mutually exclusive with the -p argument. -g Specifies the group associated with the user. If used without a value, the user's default group is assumed. arguments Specifies one or more arguments. -licenseserver= Specifies the license server, for example "Default Local License Server". -licenselevel= Specifies the license level. Valid values are author, occasionalauthor, consumer, or admin. -all Specifies usage for all seat-level licenses. -h Displays help for this utility. Examples Following are examples of the use of the license_usage utility: The following example displays the number of licenses used for all seats (author, consumer, occasional author, and admin) on the Default Local License Server license server: Copy license_usage -u=Tc_admin -p=password -g=group     -licenseserver="Default Local License Server" -all A sample report is: Copy Author: Purchased Count = 500 Active Users = 436 Inactive Users With Current Month Usage = 5 Available Licenses = 59

Consumer: Purchased Count = 300 Active Users = 214 Inactive Users With Current Month Usage = 18 Available Licenses = 68

Occasional Author: Purchased Count = 50 Active Users = 43 Inactive Users With Current Month Usage = 0 Available Licenses = 7

Admin: Purchased Count = 2 Active Users = 1 Inactive Users With Current Month Usage = 0 Available Licenses = 1 The following example displays author usage information on the testServer license server: Copy license_usage -u=Tc_admin -p=password -g=group     -licenseserver=testServer -licenselevel=author A sample report is: Copy Author: Purchased Count = 500 Active Users = 436 Inactive Users With Current Month Usage = 5 Available Licenses = 59 Related Topics Organization Management

Source: https://docs.sw.siemens.com/documentation/external/PL20251212545240207/en-US/tc_help/utilities_reference/coz1737253683897/cdq1737253686488/xid1607946.html · retrieved Fri Jul 31 2026 00:00:00 GMT+0000 (Coordinated Universal Time)