clearbug

Creates problem report for HCL Customer Support

Applicability

Product

Command type

VersionVault

command

Platform

UNIX®

Linux®

Synopsis

clearbug [ –s/hort ] [ –p bug-priority ] [ –r yes/no ]
[ –l alternate-logfile-name ]

Description

clearbug gathers information from your current processing context: date/time, version of operating system, versions of VersionVault tools, your UNIX or Linux® context, your VersionVault context, system error logs, and so on. It sends this information to stdout, from which you can paste it into a problem report for HCL Customer Support. Run clearbug from a directory somewhere below the root of the VOB in question, so that the view and VOB information are recorded.

clearbug is self-documenting, displaying detailed instructions before it prompts you for information. clearbug first prompts you for the priority of the bug and whether it is reproducible, then gathers the following information:

  • System information
  • Version numbers of VersionVault programs
  • User and group information
  • Working directory pathname
  • VOB information (from describe)
  • View information
  • Information about mounts
  • Active VOBs on the current machine
  • The last twenty lines of the system log file

Send the problem report to HCL Customer Support.

Options and arguments

–s/hort
Displays only the prompts for priority and reproducibility; suppresses the initial text that explains how to submit the problem, lists log files to examine, and describes the priorities.
–p bug-priority
Sets priority level of the bug:

1

Urgent problem; no useful work can be done.

2

Serious problem; a major function is experiencing a reproducible problem that causes major inconvenience; no easy workaround.

3

Problem; an important function is experiencing an intermittent problem, or a common nonessential operation is failing consistently.

4

Minor problem; all other errors. Inconvenience can be tolerated.

5

Request for enhancement.

–r  yes/no
Specifies whether the bug is reproducible.
–l alternative-logfile-name
Specifies an alternative name for the log file. By default, the log is displayed on the screen and written to ./clearbug.log.date.time. If you do not want a log file, specify –l  /dev/null.