Secure Global Desktop Administration Guide > Commands > The tarantella emulatorsession list command

The tarantella emulatorsession list command

Syntax

tarantella emulatorsession list 
                        [--person pobj]
                        [--application appobj]
                        [--appserver hobj]
                        [--server serv]
                        [--format text|count|xml]

Description

Lists emulator sessions matching the criteria specified. Information shown includes session IDs, which are used with other tarantella emulatorsession commands.

An example session ID is paris.indigo-insurance.com:965127448604:...%2f_ens%2fo=Indigo Insurance%2fcn=Emma Rald. Session IDs may contain spaces, so make sure you quote them.

Option Description
--person pobj Lists emulator sessions matching the person specified. Use a TFN name for pobj.
--application appobj Lists emulator sessions matching the application specified. Use a TFN name for appobj.
--appserver hobj Lists emulator sessions matching the application server specified. Use a TFN name for hobj.
--server serv Lists emulator sessions hosted by the Secure Global Desktop array member specified. Use a TFN name or a peer DNS name for serv.
--full Includes the current IP address of the client and the status of the emulator session in the output. It takes longer to display this information.
--format text | count | xml Specifies the output format (default: text). Use count to display only the number of matching sessions.

If --person, --application, --appserver and --server are all omitted, all emulator sessions are listed.

Examples

tarantella emulatorsession list \
  --person ".../_ens/o=Indigo Insurance/cn=Emma Rald"

Lists Emma Rald's emulator sessions.

tarantella emulatorsession list \
  --server boston.indigo-insurance.com

Lists all emulator sessions hosted by the Secure Global Desktop array member boston.indigo-insurance.com. (This is the server on which the Protocol Engines run.)

Related topics