lstype

Lists a VOB's type objects

APPLICABILITY

ClearCase (cleartool subcommand), Attache (command)

SYNOPSIS

• (not in Attache) List type objects graphically:

  lstype -g·raphical [ -kin·d type-kind ] [ -inv·ob vob-selector ]

• List type objects in the command window:

  lstype [ -local ] [ -l·ong | -s·hort | -fmt format-string ] [ -obs·olete ]

  
  

  { -kin·d type-kind [ -inv·ob vob-selector ]
  | type-selector ...
  }

DESCRIPTION

The lstype command lists information about one or more of a VOB's type objects.

Obsolete Type Objects

Type objects can be rendered obsolete with the lock -xxtype -obsolete command. lstype lists an obsolete type object only if you either specify its name with a type-name argument or use the -obsolete option.

PERMISSIONS AND LOCKS

Permissions Checking: No special permissions required. Locks: No locks apply.

OPTIONS AND ARGUMENTS

(NOT IN ATTACHE) LISTING TYPE OBJECTS GRAPHICALLY. Default: Lists type objects in the command window.

-g·raphical

Starts a type object browser to display type objects.

LISTING LOCAL COPIES OF GLOBAL TYPES. Default: In addition to types in the specified VOB, lstype lists all global types in associated administrative VOBs.

-local

Lists ordinary types and local copies of global types. For more information about global types, see Administering ClearCase.

LISTING FORMAT.  Default: A type object listing looks like this:

07-Nov-1998     sakai     element type "text_file"

-l·ong

Expands the listing to include any type-specific parameters (for example, that a label type is one-per-element or that an element type inherited its type manager from the text_file supertype and so on.)

-s·hort

Restricts the listing to type names only.

-fmt format-string

Lists information using the specified format string. See the fmt_ccase reference page for details on using this report-writing facility.

LISTING OBSOLETE TYPES.  Default: If you don't specify any type-name argument, only the nonobsolete types of the specified kind are listed.

-obs·olete

Includes obsolete type objects in the listing when you don't specify any individual type objects with type-name arguments. Has no effect if you specify one or more type-name arguments.

SPECIFYING THE KIND OF TYPE OBJECT.  Default: None.

-kin·d type-kind

A kind of type object. All objects of this kind are listed. type-kind can be one of:

attype, brtype, eltype, hltype, lbtype, trtype

SPECIFYING THE VOB.  Default: Lists type objects in the VOB that contains the current working directory.

-inv·ob vob-selector

The VOB whose type objects are to be listed. Specify vob-selector in the form [vob:]pname-in-vob

SPECIFYING INDIVIDUAL TYPE OBJECTS.  Default: None.

type-selector ...

One or more names of type objects. The listing includes only the named objects. Specify type-selector in the form [type-kind:]type-name[@vob-selector]

EXAMPLES

Examples including 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 command interpreter prompt. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt. In Attache, cmd-context represents the workspace prompt.

• List all branch types defined in the VOB containing the current working directory.

cmd-context lstype -kind brtype

15-Dec.09:34   jenny       branch type "main"
"Predefined branch type used to represent the main branch of elements."
08-Dec.12:12   jackson     branch type "test"
"test development branch"
08-Dec.12:12   jackson     branch type "patch2"
08-Dec.12:12   jackson     branch type "patch3"
08-Dec.12:12   jackson     branch type "rel2_bugfix"

• List all label types defined in the current VOB. Use the short format, and include obsolete label types.

cmd-context lstype -kind lbtype -obsolete -short

BACKSTOP
CHECKEDOUT
LATEST
REL1 (obsolete)
REL2
REL3
V2.7.1 (obsolete)

Note that the listing includes the three predefined label types, BACKSTOP, LATEST, and CHECKEDOUT.

• List information about a particular user-defined element type, in long format.

cmd-context lstype -long eltype:c_source

element type "c_source"
 08-Dec-98.12:12:38 by jackson.dvt@oxygen
 owner: jackson
 group: dvt
 scope: this VOB (ordinary type)
 type manager: text_file_delta (inherited from type "text_file")
 supertype: text_file
 meta-type of element: file element

• List information about a particular trigger type, in long format.

cmd-context lstype -long trtype:trig1

trigger type "trig1"
 08-Dec-98.12:14:08 by jackson.dvt@oxygen
 owner: jackson
 group: dvt
 element trigger
 pre-operation MODIFY_ELEM
 action: -exec checkcmt

• List information about a particular hyperlink type.

cmd-context lstype -long hltype:design_spec

hyperlink type "design_spec"
 08-Dec-98.12:13:31 by Chuck Jackson (test user) (jackson.dvt@oxygen)
 "source to design document"
 owner: jackson
 group: dvt
 scope: this VOB (ordinary type)

• List the name, lock status, mastering replica, and scope of all label types in the VOB \stage. (The command line, including the quoted format string, constitutes a single input line. The input line below is broken to improve readability. Spaces are significant.)

cmd-context lstype -fmt "%n\n\tLock status: %[locked]p\n\tMastering replica: %[master]p\n\tScope: %[type_scope]p\n" -kind lbtype
V3.BL3
Lock status: unlocked
Mastering replica: lex
Scope: ordinary
V3.BL4
Lock status: locked
Mastering replica: lex
Scope: global
V4.0.DOC
Lock status: unlocked
Mastering replica: doc_clone
Scope: ordinary
V4.0.HELP
Lock status: unlocked
Mastering replica: doc_clone
Scope: ordinary

• List the name, kind, and creation comment of a particular trigger type.

cmd-context lstype -fmt "%n\t%[trigger_kind]p\n\t%c" trtype:cmnt
cmnt     element trigger
     prompt user for comment

SEE ALSO

describe, rmtype, rename, type_object