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.