lsclients
Displays the client host list for a ClearCase® license or registry server
host
Applicability
Product
|
Command
type
|
|---|
ClearCase
|
cleartool
subcommand
|
Platform
|
|---|
UNIX®
|
| Linux® |
Windows®
|
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 client host list. For more information about albd_server,
see the Administrator's Guide.
For product patch information, use cleartool –ver.
Options and arguments
Specifying a host
- Default
- None. You must supply a license or registry server host name.
- –hos/t hostname
- Specifies the registry or license server host. Only license and registry
server hosts maintain client lists. If you specify a host that is not a license
or registry server host, lsclients prints a message indicating
that the host has no clients.
Specifying the type of server host
- Default
- –all.
- –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.
Listing format
- Default
- Displays a one-line description of each client.
- –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 and time of the last
server access.
Examples
The UNIX system and Linux examples in this
section are written for use in csh. If you use another
shell, you may need to use different quoting and escaping conventions.
The
Windows examples that include 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 UNIX system and Linux
shells or Windows command interpreter prompt, followed by the cleartool command.
In cleartool interactive mode, cmd-context represents
the interactive cleartool prompt.
- Display the sorted client list for
license server host bromacil.
cmd-context lsclients –host bromacil –type license | sort
...
durian: ClearCase 4.1 (OSF1 V5.1 732 alpha)
indeno: ClearCase 4.1 (SunOS 5.7 Generic_106541-08 sun4u)
lead: ClearCase 4.2 (SunOS 5.8 Generic_108528-01 sun4m)
lowell: ClearCase 4.1 (IRIX64 6.5 04151556 IP30)
scorpius: ClearCase 4.2 (HP-UX B.11.00 A 9000/785)...
- Display the long format client list
for registry server host atrium.
cmd-context lsclients –host atrium –long
...
Client: pyramid
Product: ClearCase 7.0.1.0
Operating system: Windows NT 5.1 (build 2600)Service Pack 2
Hardware type: Pentium
Registry host: atrium
Registry region: atria_r_d_unc
License host: maple
Last registry access: 2007-11-20T04:32:08
Last license access: never
...
UNIX and Linux files
- /var/adm/rational/clearcase/config/rgy_hosts.conf
- /var/adm/rational/clearcase/config/rgy_svr.conf
- /var/adm/rational/clearcase/config/rgy_region.conf
- /var/adm/rational/clearcase/config/license_host
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