No Entry

No Entry

BSS File Format

Topic: Overview Header Record
  Bidding Sequence Record Stock Convention Card Record
  Convention Record Defensive Carding Record
Overview Back to Top

Convention Card Definition and Convention Definition files are ASCII text files having a “.bss” file name extension. As might be surmised from the use of a specific file name extension, the files have a well defined format, including encoding of information. In a defined context, a specific character will be an encoding of something, for example, a single character will represent position at the table (including one character to indicate 1st or 2nd position, etc.).

The file consists of a series of “records”. A record is a line of the text file — it is terminated by a “new line” character. The overall format of the file is:

In the description of the layout of a record, brackets (“square brackets”) are used to enclose an optional item — something that can be left out (generally under well-defined conditions).

Similarly, angle brackets (“less than” and “greater than” signs) are used to enclose an item that is a character string (the words enclosed in the angle brackets represent a name for the character string).

The brackets and angle brackets are not part of a record, they are solely to facilitate interpretation. On the other hand, character strings that are embedded in other information are generally enclosed in braces (curly brackets) that are part of the record; character strings that occur at the end of a record are generally not enclosed in braces (the string starts at a defined place in the record and is terminated by the end of the record).

There is no embedded “white space” in a record, except in character strings. Spaces have been included in the formats purely for readability.

Format

*00 [{<System Name>}] = NYYYYYY [<Summary>]

?00 [{<System Name>}] = NYYYYYY [<Summary>]

Description

The first record in the file is a Header record. The “00” and the “= NYYYYYY” are ignored (though they must be present).

File Type

The first character in the record is either an “*” or a “?”. An “*” indicates a standard Convention Card Definition or Convention Definition file; a “?” identifies a Floating Convention Definition file. Currently the only stock Floating convention is “Roman Key Card Blackwood (1430)”.

Although the Full Disclosure editor can be used to open any Convention Definition file, editing Floating conventions is not currently supported (nothing will be visible in the editor except the name and description).

System Name

System Name is the name entered in the Define dialog when editing the convention card file.

Summary

Summary is the system summary entered in the Define dialog when editing the convention card file.

Bidding Sequence Record Back to Top

Format

  AB <Bidding Sequence> = CDEFGHI J [KL] [<Description>]

* AB <Bidding Sequence> = CDEFGHI J [KL] [<Description>]

Records that start with an asterisk represent competitive sequences where They open; those without the asterisk represent sequences where We open.

The capital letters, except in the name of character strings, represent encodings — each is a single character representing some information.

Position

“A” represents the position in which the opening bid is made. Implicitly this defines the Dealer, which is the label used in the Full Disclosure editor when defining the bid.

The encoding is:

Vulnerability

“B” represents the prevailing vulnerability conditions which apply to the bidding sequence.

In the following list of encodings, the labels used in the Full Disclosure editor are included in parentheses.

Bidding Sequence

The Bidding Sequence starts immediately after the first two characters and is terminated by the equals sign (“=”). The calls in the sequence are either “P” for Pass, “D” for Double, “R” for Redouble, or a bid. A bid consists of a single digit (“1” to “7”) followed by the initial letter of the strain (“S”, “H”, “D”, “C”, or “N” for notrump).

Note: If a Qualification is entered for an opponent’s bid, then that qualification will appear as a string within braces (curly brackets). It will appear after the bid that was qualified and after the intervention. The qualified bid does not have to be the first one in the sequence; for example, you might play one agreement over an opponent’s transfer bid, but another if their suit responses to 1NT are natural.

Artificial Bid

“C” is used to indicate whether the last bid in the sequence is artificial (“Y”) or not (“N”).

Possible Outcomes

The next six characters (“D” through “I”) represent the six possible outcomes. If the outcome is possible, it is a “Y”; otherwise an “N”. The outcomes (possible strains that are still open after the last bid in the sequence) are, in order:

Disposition

“J” encodes the Disposition of the last bid in the sequence as defined in Full Disclosure.

The encoding is:

Suit Length

The minimum and maximum promised suit length that apply to the last bid in the bidding sequence are defined by “K” and “L” respectively.

If the last bid is a notrump bid, then “K” and “L” are omitted.

The digits “0” to “8” are used to represent the actual length for the minimum length (“K”).

In the case of the maximum length (“L”), the digits “0” to “7” are used to represent the actual length, and “8” to represent “Any”.

Description

The Description string is whatever you entered under Description when you defined the last bid in the bidding sequence.

Stock Convention Card Record Back to Top

Format

$ <File Name>

Description

When you edit one of the stock convention cards online, change it, and save it under a new name, then rather than storing a complete copy of the Convention Card Definition file, a reference to the stock card is put into your new file.

There can only be one Convention Card Record in a Convention Card Definition file. If there is one, it appears immediately after the Header record.

File Name is the name of the stock Convention Card Definition file. These files are stored in the “convcards\default convcards” subdirectory of the “Bridge Base Online” directory.

Convention Record Back to Top

Format

+ <File Name>

Description

When you use Manage Conventions in the Full Disclosure editor, it creates (or removes) Convention records. These are simply pointers to the appropriate Convention Definition files.

Multiple Convention Records are allowed, however they cannot be nested (the Convention Definition file cannot contain further Convention Records).

File Name is the name of the Convention Definition file. These files are stored in the “conventions” subdirectory of the “Bridge Base Online” directory.

Defensive Carding Record Back to Top

Comment

There should never be a need to edit or generate this record other than by using the Full Disclosure editor.

Format

% <Leads vs NT> <Leads vs Suits> <Defensive Signals> [<Description and Other agreements>]

Description

This record represents your carding agreements and, if there is one, is the last record in the file.

Leads vs NT

There are 22 characters in this string, each representing one of the card combinations listed in the Leads vs NT section of the Full Disclosure editor’s Opening Leads section.

The choices you can make in the editor do not always include every card in the combination; for example, you cannot choose to lead the Queen from Qxx. Of the available choices, “B” indicates the top card, “C” the next lower card, and so on.

Here is the full list of 22 card combinations:

xx, xxx, xxxx, xxxxx, Qxx, Qxxx, Qxxxx, Qxxxxx, Qxxxxxx, AKx, KQJ, QJ10, J109, 1098, KQ109, AKJ10, AQJ, AJ10, A109, KJ10, K109, Q109

Leads vs Suits

There are 18 characters in this string, each representing one of the card combinations listed in the Leads vs Suits section of the Full Disclosure editor’s Opening Leads section.

The encoding is exactly the same as described above.

Here is the full list of 18 card combinations:

xx, xxx, xxxx, xxxxx, Qxx, Qxxx, Qxxxx, Qxxxxx, Qxxxxxx, AK, AKx, KQJ, QJ10, J109, 1098, KJ10, K109, Q109

Defensive Signals

In the Full Disclosure editor section on Defensive Signals, there are three sections for signals against notrump contract and three for suit contracts. Each of those has an agreement for first, second, and third priority.

Thus the following six sections each have a first, second, and third priority for a total of 18 characters in the Defensive Carding record:

The choice of agreements listed in the Full Disclosure editor is the same for each of the 18 situations. The encoding is:

Description and Other Agreements

If you have entered anything into the Description and Other agreements area, that character string is appended to the record.

  Back to Top