lsclients

Displays the client host list for a ClearCase license or registry server host

APPLICABILITY

ClearCase (cleartool subcommand), Attache (command)

SYNOPSIS

lsclients -hos·t hostname [ -typ·e { registry | license | all } ] [ -s·hort | -l·ong ]

DESCRIPTION

On every ClearCase license server host and registry server host, the albd_server process maintains a list of current client hosts.

If a client host does not access a server host for 30 days, albd_server drops it from that server host's list of client hosts.

If you name a host that is not a license or registry server host, lsclients prints the following message:

Server "hostname" has no clients.

PERMISSIONS AND LOCKS

Permissions Checking: No special permissions required. Locks: No locks apply.

OPTIONS AND ARGUMENTS

SPECIFYING A HOST.  Default: None. You must supply a ClearCase license or registry server host name.

-hos·t hostname

Specifies the registry or license server host. Only ClearCase license and registry server hosts maintain client lists.

LISTING FORMAT.  Default: Display a one-line description of each registry client and each license client of the specified server host.

-typ·e { registry | license | all }

Use -type registry or -type license to restrict the listing to include only clients of registry server hosts or clients of license server hosts, respectively. The default is all.

-s·hort

Displays client host names only.

-l·ong

Expands the listing to include each client's registry server host, registry region, license server host, and date-time of last server access.

EXAMPLES

Examples including wildcards or quoting are written for use in cleartool interactive mode. If you use cleartool single-command mode, you may need to change the wildcards and quoting to make your command interpreter process the command appropriately.

In cleartool single-command mode, cmd-context represents the command interpreter prompt. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt. In Attache, cmd-context represents the workspace prompt.

• Display the client list for license server host merlin.

cmd-context lsclients -host merlin -type license...
apple: ClearCase 4.0 (Windows NT 3.51 (build 1057) Pentium
orange: ClearCase 4.0 (Windows NT 3.50 (build 807) 486
quince: ClearCase 4.0 (Windows NT 3.51 (build 1057) Pentium
...

• Display the long format client list for registry server host saturn.

cmd-context lsclients -host saturn -long

...
Client: neptune
  Product: ClearCase 4.0
  Operating system: Windows NT 3.51 (build 1057)
  Hardware type: 486
  Registry host: saturn
  Registry region: devel
  License host: venus
  Last registry access: 08-Apr-99.15:12:43
  Last license access: never
...

WINDOWS REGISTRY KEYS

HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\AtriaRegy
HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\Region
HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\ServerType
HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\LicenseHost

SEE ALSO

albd_server, clearlicense, registry_ccase