Secure Global Desktop 4.31 Administration Guide > Commands > The tarantella tscal list command

The tarantella tscal list command

Syntax

tarantella tscal list [ --inuseby user | --inuse | --free ] 
                      [ --type name ]
                      [ --format text|xml ]

Description

Use the tarantella tscal list command to list the Microsoft Windows Terminal Services Client Access Licenses (CALs) currently reserved for use by non-Windows clients.

If you do not use any arguments, the command lists all CALs and shows whether or not they are in use.

If you run this command on a secondary server in a Secure Global Desktop array and the primary server is unavailable, the list may not be completely accurate. This is because the primary server is responsible for updating all array members with changes to CAL information. The command warns you if the primary is unavailable.

Argument	Description
`--inuseby user`	List only the CALs being used by a particular user where `user` is either: the TFN name of a user; or a wild card filter. You can use the tarantella emulatorsession list command to determine the TFN name of a user. The * character is the only character you can use in a wild card filter. It represents a string of any length containing any characters. So an `--inuseby "green"` argument lists only the CALs for users whose TFN name contains the string 'green'.
`--inuse`	List only the CALs that are currently in use.
`--free`	List only the CALs that are currently not in use.
`--type name`	List only the CALs that can connect to a particular type of Terminal Services server. This is either `WinNT4-TS-CAL` or `Win200x-TS-CAL`. Note The name is not case sensitive.
`--format text \| xml`	Specifies the output format (default: text).

Examples

tarantella tscal list --free

Lists the CALs for non-Windows clients that are currently not in use.

Related topics
The tarantella tscal command Do I need to license Windows Terminal Services?