Administrator's Guide for Rational ClearCase MultiSite, Release 2002.05.00, All Platforms

lspacket

Describes contents of packet

APPLICABILITY


Product	Command type
MultiSite	multitool subcommand

Platform
UNIX
Windows

SYNOPSIS

lspacket [ -l·ong | -s·hort ] [ pname ... ]

DESCRIPTION

This command lists a summary of the contents of one or more disk files that contain replica-creation or update packets. By default, the lspacket output includes this information:

Pathname of each packet

Type of each packet (Replica Creation or Update)

VOB family to which the packet applies

Creation comment for the packet

Replicas for which the packet is intended; if the VOB-tag is available, lspacket displays it.

An asterisk after a replica name indicates that the packet can be imported immediately because it does not depend on any other packet. (This applies only for replicas listed in the host's ClearCase registry.)

For example, if there are two packets waiting to be imported at a replica, the first packet has an asterisk and the second doesn't (because the second packet depends on the first).

Packet sequence number (for a disk file storing one part of a logical packet that has been split into multiple physical packets)

RESTRICTIONS

None.

OPTIONS AND ARGUMENTS

LISTING FORMAT. Default: Includes the information listed in the DESCRIPTION section.

-l·ong: In addition to the default information, lists the following information:
-s·hort: Lists only the pathname of a packet.

SPECIFYING THE PACKETS TO BE LISTED. Default: Lists all packets in all storage bays on the current host.

pname ...: One or more pathnames of files and/or directories.
: Each file you specify is listed if it contains a physical packet. For each directory you specify, lspacket lists packets stored in that directory.

EXAMPLES

List a single replica-creation packet.

multitool lspacket \ /usr/atria/shipping/ms_ship/incoming/repl_boston_15-Aug-00.17.07.20_7865_1 Packet is: /usr/atria/shipping/ms_ship/incoming/repl_boston_15-Aug-00.17.07.20_7865_1 Packet type: Replica Creation VOB family identifier is: 94be56a1.0dd611d1.a0df.00:01:80:7b:09:69 Comment supplied at packet creation is: Packet intended for the following targets: buenosaires The packet sequence number is 1

List a single update packet.

multitool lspacket /usr/tmp/packet1 Packet is: /usr/tmp/packet1 Packet type: Update VOB family identifier is: c3f47cf3.71b111cd.a4f2.00:01:80:31:7a:a7 Comment supplied at packet creation is: Packet intended for the following targets: sanfran_hub [ local to this network ] tag: /vobs/tests The packet sequence number is 1

List all packets in all of the local host's storage bays.

multitool lspacket Packet is: c:\Program Files\Rational\ClearCase\var\shipping \ms_ship\incoming\packet1 ... Packet is: c:\Program Files\Rational\ClearCase\var\shipping \ms_ship\incoming\packet2

List all packets in a specific storage bay.

multitool lspacket "c:\Program Files\Rational\ClearCase\var\shipping\to_boston" Packet is: c:\Program Files\Rational\ClearCase\var\shipping \to_boston\outgoing\packet1 Packet type: Update ...

List an update packet in long format.

multitool lspacket -long /usr/tmp/packet1 Packet is: /usr/tmp/packet1 Packet type: Update VOB family identifier is: c3f47cf3.71b111cd.a4f2.00:01:80:31:7a:a7 Comment supplied at packet creation is: Packet intended for the following targets: sanfran_hub [ local to this network ] * tag: /vobs/tests Originating replica is: sydney The following replicas are referenced by this packet: f3b1cd51.04b111d3.b2f0.00:c0:4f:96:17:d8 first oplog id is 10 incarnation is 06/29/95 12:18:09 3f370590.04b211d3.b2f0.00:c0:4f:96:17:d8 first oplog id is 0 incarnation is 0 8b354320.04c218k3.b5r0.00:c0:4f:99:27:f7 first oplog id is 1 incarnation is 07/21/95 11:45:20 The major packet version is 2, the minor packet version is 0 The packet sequence number is 1