lsreplica

Lists VOB replicas

Applicability

Product Command type
ClearCase® cleartool subcommand
MultiSite multitool subcommand
Platform
UNIX
Linux
Windows

Synopsis

lsrep/lica
[ –l/ong | –s/hort | –fmt format ] [ –sib/lings | [ –sib/lings ] –invob vob-selector | [ –inr/eplicas { –all | replica-name [ ,... ] }] replica-selector ... ]

Description

This command lists information about all VOB-replica objects recorded in the VOB database of the current replica (except for deleted replicas). Other replicas may exist, but the packets that contain their creation information have not yet been imported at the current replica.

Restrictions

None.

Options and arguments

Listing format

Default
Includes creation event information for each replica.
–l/ong
Lists each replica's creation information, master replica, mastership request setting, ownership information, and host. If the current replica is in the process of restoration, this option annotates the listings of other replicas from which restoration updates are required. (See the restorereplica reference page.)
–s/hort
Lists only replica names.
–fmt format
Lists information using the specified format string. For details about using this report-writing facility, see the fmt_ccase reference page in the DevOps Code ClearCase Command Reference.
–sib/lings
Lists the family members of the current replica, but does not list the current replica itself. Use this option in scripts that process only sibling replicas.

Specifying the VOB family

Default
Lists family members of the replica containing the current working directory.
–invob vob-selector
Lists the replicas in the specified family. Specify vob-selector in the form [vob:]pname-in-vob
pname-in-vob
Pathname of the VOB tag (whether or not the VOB is mounted) or of any file system object within the VOB (if the VOB is mounted)

Specifying the replica

Default
Lists all known replicas in the family.
–inr/eplicas { –all | replica-name[,...] }
With –all, lists information about VOB-replica objects recorded in the VOB database of all replicas known to the current replica. Otherwise, lists information about VOB-replica objects recorded in the VOB database of the specified replicas. The list of replicas must be comma-separated, with no spaces.
replica-selector ...
Restricts the listing to one or more replicas. Specify replica-selector in the form [replica:]replica-name[@vob-selector]
replica-name
Name of the replica
vob-selector
VOB family of the replica; can be omitted if the current working directory is within the VOB.

Specify vob-selector in the form [vob:]pname-in-vob

pname-in-vob
Pathname of the VOB tag (whether or not the VOB is mounted) or of any file system object within the VOB (if the VOB is mounted)

Examples

In these examples, the lines are broken for readability. You must enter each command on a single physical line.

  • List the names of all replicas of the VOB containing the current working directory.



    multitool lsreplica –short

    bangalore
    boston_hub
    buenosaires
    sanfran_hub

  • List the names of all siblings of the VOB containing the current working directory.



    multitool lsreplica –short –siblings

    bangalore
    buenosaires
    sanfran_hub

  • Display a long listing of the current VOB's replicas.



    multitool lsreplica –long


    replica "bangalore"
    15-Aug-00.15:48:39 by Susan Goechs (susan.user@minuteman)
      replica type: unfiltered
      master replica: boston_hub@/vobs/dev
      request for mastership:enabled
      owner: susan
      group: user
      host: "ramohalli"
    replica "boston_hub"
    19-May-99.15:47:13 by Susan Goechs (susan.user@minuteman)
      replica type: unfiltered
      master replica: boston_hub@/vobs/dev
      request for mastership:enabled
      owner: susan
      group: user
      host: "minuteman"
    replica "buenosaires"
    15-Aug-00.15:48:44 by Susan Goechs (susan.user@minuteman)
      replica type: unfiltered
      master replica: boston_hub@/vobs/dev
      request for mastership:enabled
      owner: susan
      group: user
      host: "mardelplata"
    replica "sanfran_hub"
    19-May-99.15:49:46 by Susan Goechs (susan.user@minuteman)
      replica type: unfiltered
      master replica: sanfran_hub@/vobs/dev
      request for mastership:enabled
      owner: susan
      group: user
      host: "goldengate"

  • List all replicas of the VOB whose VOB tag is \doc.


    multitool lsreplica –invob \doc

    For VOB replica "\doc":
    11-Mar.13:42     jcole          replica "boston_hub"
    11-Mar.13:45     jcole          replica "sanfran_hub"
    11-Mar.13:48     jcole          replica "tokyo"

  • List the name, master replica, and replica host of all replicas in the family /vobs/doc.

    cmd-contextlsreplica –fmt
    "Name: %n\n\tMaster replica: %[master]p\n\tReplica
    host: %[replica_host]p\n" -invob /vobs/doc

    Name: boston_hub
       Master replica: boston@/vobs/doc
       Replica host: minuteman
    Name: sanfran_hub
       Master replica: sanfran_hub@/vobs/doc
       Replica host: goldengate
    Name: tokyo
       Master replica: sanfran_hub@/vobs/doc
       Replica host: shinjuku