submit

Submits a new record.

Synopsis

submit [common options] [-field name value [ value value ...] ] [-f/ield name value [ value value ... ] [-ask] [-type record_type]

Description

Submits a new record to the current Rational® ClearQuest® database. Running without options causes interactive prompting for required fields only. A new defect cannot be created unless all required fields (as defined in the Rational ClearQuest schema) are provided.

Options and arguments

-field name value [value value ...]
Specify fields and their values to set in the newly created record. If a field name is unique, an unambiguous prefix of the name can be used. For example, you can enter "head" for the headline field.
-f/ield name value [ value value ...]
Alternate format for specifying a field and its values in the new record. Use this format in the case that the field is the same name as a subcommand option.
-ask
Interactively prompt for optional and required fields to be set. Required fields are always prompted if not set on the command line.
-type record_type
The type of record to create. If this option is not provided, the default record type is used.

Examples

Submits a record to the Defect record type without specifying field values.

CQTOOL submit -type Defect
Value required for field Headline [SHORT_STRING]: This is a test.
Value required for field Severity [SHORT_STRING] (? to see list): ?
1-Critical
2-Major
3-Average
4-Minor
5-Enhancement
Values can be given by an unambiguous prefix
Value required for field Severity [SHORT_STRING] (? to see list): 1
Created Defect SAMPL00000059
-----------------------------------------------------------

Submits a defect with all required fields set on the command line.

CQTOOL submit -headline "Typo in the online help." -severity 3
Created Defect SAMPL00000060
− ----------------------------------------------------------

Submits a record to the Defect record type after asking for additional fields to set.

CQTOOL submit -ask -type Defect
Value required for field Headline [SHORT_STRING]: This is a another test
Value required for field Severity [SHORT_STRING] (? to see list): 2
Enter field name [RETURN to continue] (? to see list): ?
Attachments 		Keywords	 Resolution
customer 		Note_Entry 	Severity
customer severity 	Owner 		Symptoms
Description 		Priority
Headline 		Project
Names can be given by an unambiguous prefix
Enter field name [RETURN to continue] (? to see list): Symptoms
Value for field Symptoms [MULTILINE_STRING] (? to see list): ?
Cosmetic Flaw Incorrect Operation System Crash
Data Corruption	 Installation Problem 	Unexpected Behavior
Data Loss 		Missing Feature 	Unfriendly Behavior
Documentation Issue 	Slow Performance
Values can be given by an unambiguous prefix
Value for field Symptoms [MULTILINE_STRING] (? to see list): Data Loss
Enter field name [RETURN to continue] (? to see list):
Created Defect SAMPL00000060
−-------------------------------------------------------------

Submits a record to the default record type after specifying multiple values for the field name keywords.

CQTOOL submit -keywords "ClearQuest multisite" "rational" or
CQTOOL submit -field keywords "ClearQuest multisite" "rational"

Feedback