This command lists objects mastered by a replica. By default, the command uses only the information known to your current replica. If you list objects mastered by a sibling replica, changes that have not been imported at your current replica are not included in the output. For example, a label type is added at replica sanfran_hub, but replica boston_hub has not imported the update packet that contains the change. If you enter the command multitool lsmaster sanfran_hub at the boston_hub replica, the output does not include the new label type.
To retrieve information from a sibling replica, use –inreplicas. This form of the command contacts the sibling replicas and works only between sites that have IP connections. If lsmaster cannot contact a replica, it prints an error and tries to contact the next replica you specified.
If you have a view context, lsmaster uses the view to resolve object identifiers (OIDs) of file system objects to the names of the objects. If you do not have a view context, lsmaster prints OIDs for file system objects. You can specify a view context with the –view option.
When you specify –inreplicas, lsmaster prints OIDs for objects whose creation operations have not yet been imported at your current replica.
Values for ClearCase:
attype |
branch |
brtype |
delem (directory element) |
eltype |
felem (file element) |
hlink |
hltype |
lbtype |
slink |
vob |
Values for ClearCase UCM:
activity |
baseline |
component |
folder |
project |
stream |
Values for MultiSite:
replica |
For non-file system objects, the master replica, object kind, and name of each object are listed. For example:
In these examples, the lines are broken for readability. You must enter each command on a single physical line.
cleartool lsmaster –kind eltype,lbtype,brtype sanfran_hub
master replica: sanfran_hub@\dev "element type" file_system_object
master replica: sanfran_hub@\dev "element type" file
master replica: sanfran_hub@\dev "element type" directory
...
master replica: sanfran_hub@\dev "branch type" sanfran_main
master replica: sanfran_hub@\dev "branch type" v1.0_bugfix
...
master replica: sanfran_hub@\dev "label type" LATEST
master replica: sanfran_hub@\dev "label type" SANFRAN_V2.0
master replica: sanfran_hub@\dev "label type" V1.0_BUGFIX
master replica: sanfran_hub@\dev "label type" TOKYO_BASE
master replica: sanfran_hub@\dev "label type" SYDNEY_BASE
...
multitool lsmaster –inreplicas –all sanfran_hub@/vobs/dev
In replica "boston_hub"
master replica: sanfran_hub@/vobs/dev "versioned object base" /vobs/dev
master replica: sanfran_hub@/vobs/dev "directory element"
(oid:40e0000b.241d23ca.b3df.08:00:69:02:05:33)
master replica: sanfran_hub@/vobs/dev "directory element"
(oid:40e0000b.241d23ca.b3df.08:00:69:02:05:33)
...
Use a view context:
multitool lsmaster –view v4.1 –inreplicas –all sanfran_hub@/vobs/dev
In replica "boston_hub"
master replica: sanfran_hub@/vobs/dev "versioned object base" /vobs/dev
master replica: sanfran_hub@/vobs/dev "directory element"
/view/v4.1/vobs/dev/.@@
master replica: sanfran_hub@/vobs/dev "directory element"
/view/v4.1/vobs/dev/lib@@
...
multitool lsmaster –inreplicas boston_hub –kind project,baseline,stream boston_hub@/vobs/projects
In replica "boston_hub"
master replica: boston_hub@/vobs/projects "project" V4.5.BL3
master replica: boston_hub@/vobs/projects "project" doc_localize
master replica: boston_hub@/vobs/projects "stream" 4.5.bl2_int
master replica: boston_hub@/vobs/projects "project" V4.5.BL2
master replica: boston_hub@/vobs/projects "stream" 4.5.bl2
master replica: boston_hub@/vobs/projects "stream" stream000317.160434
master replica: boston_hub@/vobs/projects "stream" stream000317.173156
master replica: boston_hub@/vobs/projects "baseline" V4.5.BL2.011005.12820
master replica: boston_hub@/vobs/projects "baseline" V4.5.BL2.011005.12890
master replica: boston_hub@/vobs/projects "baseline" V4.5.BL2.011005.17408
master replica: boston_hub@/vobs/projects "baseline" V4.5.BL2.011005.17695
master replica: boston_hub@/vobs/projects "baseline" V4.5.BL2.011005.19614
...
Copyright© 2003 Rational Software. All Rights Reserved.