lsreplica

Lists VOB replicas

Applicability

Product

Command type

VersionVault

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.
–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

Path name 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-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

Path name 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"
     2007-08-15T15: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"
     2007-05-19T15: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"
     2007-08-15T15: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"
     2007-05-19T15: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�?:
    —03-11T13:42 jcole replica "boston_hub"
    —03-11T13:45 jcole replica "sanfran_hub"
    —03-11T13:48 jcole replica "tokyo"

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

    cmd-context lsreplica –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

See also

fmt_ccase, and in the MultiSite command reference, the mkreplica and restorereplica commands.