Getin/Getout sub-menu at Main menu

Figure 3 shows the Getin/Getout sub-menu of the main menu. Getin databases contain the first few (usually 3 or fewer) calls of a sequence. Getout databases contain resolves. Getin/getout databases are limited to symmetric 8-dancer choreography and a fixed number (26) of formations. Two default databases are supplied with the program: GETIN and GETOUT. These databases can not be deleted or renamed. In addition, the program places automatically generated getins into database NEWGETIN, and automatically generated getouts into database NEWGO.

Add new record(s) (Section 3.1) allows new records to be added to a selected getin/getout database. The formation and getin/getout text must also be entered.

Dump contents of record(s) writes the contents of a selected range of getin/getout records for a selected database to an output text file. You will be prompted to enter a title to be placed on each page of the output file, the name of the output file, and whether or not to insert an extra blank line whenever the formation changes. Upon completion, the output file can be deleted, printed, or viewed.

Find record(s) searches a selected getin/getout database for a set of records matching a specified search criteria. Searches can be done by perm number (a formation with specific dancers in specific locations with specific facing directions) (Section 3.1.1) or by a 'generalized' search (Section 3.1.2), which allows the search to be limited within a selected record range and/or within a selected level range and/or for records with any of the following specific criteria: a text string, proofread status, private status, use count, handle number, quickie count, level used at, or by author.

View a record (Section 3.3) displays a specific record within a selected getin/getout database. You can navigate forward or backward within the record set as well as jump to specific records within the database. The viewed record can be edited, parsed, proofread, deleted (or un-deleted), or marked as 'used'. Also, a new record can be created.

Database functions... create, delete, and rename getin/getout databases. Databases GETIN and GETOUT can not be deleted or renamed.

• New database creates a new getin/getout database.
• Delete a database deletes a getin/getout database, after confirmation.
• Rename a database renames a getin/getout database.

Breakup a database (Section 3.4) copies selected records from a selected getin/getout database and places the records in one or more output files. These output files, which are in getin/getout database format, can then be copied onto floppies or other media and distributed to other users. The other users can use the Import records option to import the contents of these files into their getin/getout databases.

Import records imports getin/getout records from a file into a selected getin/getout database. The file containing the records to be imported must already be in getin/getout database format. Using Import records, you can update your getin/getout databases by adding records from someone else's database or by adding records created on a different computer. You will be prompted for the name of the source database and the name of the destination database. The import process does not import records that are duplicates of existing records in the destination database.

Statistics creates an output text file that contains statistics for a selected getin/getout database. The statistics include the number of records at each level, the number of records for each of the 26 formations, the number of records marked as private, the number of proofread records, the number of records marked as deleted, and a percentage indicating how well of the database is sorted.

Validate

• Consistent capitalization consistently capitalizes all records within a selected range of records within a selected getin/getout database. This is the same as applying global option 'Consistent capitalization' (See section 9) to a range of getin/getout records.
• Delete duplicate records searches for duplicate records within a selected range of records within a selected getin/getout database. The duplicate records are marked as deleted.
• Validate records validates a range of records within a selected getin/getout database. For each record, fields are checked to be sure that they contain valid values. An output text file is created listing the bad records. This file can be deleted, printed, or viewed. This output file should be examined and problems within the database should be fixed by either deleting or editing the bad records.
• Verify levels processes a selected range of records within a selected getin/getout database. Each record is checked to see if the level of the getin/getout has changed, and if so, the level is updated within the record. This option should be performed on all records of all getin/getout databases after the level of one or more calls has been changed within the list database. For example, if the call Peel The Top is dropped from Plus and added to C1, the list database must first be edited to change the level and then this option should be run to update all getin/getout records that contain Peel The Top so that the level of the records are now at least C1.

Find Text (Section 3.5) searches for a specified text string within a selected set of records within one or more getin/getout databases. Using this option, you could search for all getin/getout records containing a specific call or concept.

Replace Text (Section 3.6) replaces one text string with another within a selected set of records within one or more getin/getout databases.

Sort a database sorts a selected getin/getout database. Sorting the database decreases the record access time (making the program run faster), and physically removes records marked as deleted. The original database (before the sort) can be saved as a backup copy. Unless you are low on disk space, the original database should always be saved as a backup. Also, the sort process itself is faster when the original database is saved. Both options (i.e., saving or not saving the original database as a backup) utilize a modified quicksort algorithm. Pass 1 reads the perm numbers (the primary key) for all records; pass 2 sorts pointers to the perm numbers; and pass 3 creates a new database or exchanges records within the current database. The elapsed time for each pass and a gauge showing the percent completed for the current pass is displayed.

Generate opening biggies creates an output text file cross-referencing the GETIN database with the GETOUT database. The search can be limited to a selected level (hence only showing potential opening biggies at that level). Upon completion, the output file can be deleted, printed, or viewed.

Generate opening biggies

Getin tree allows the getin tree to be modified. The getin tree is a hierarchial tree showing the first three lines of text from each record in your normal 8-dancer sequence databases.

• Update getin tree using sequences extracts the first three lines of text from a range of sequences within a selected sequence database, or from all sequences within all sequence databases.
• Generate getins using getin tree uses the getin tree to generate new getins. The new getins are added to getin/getout database NEWGETIN.
• Dump contents of getin tree writes the contents of the getin tree to a selected text file. This text file can be deleted, printed, or viewed.

Dump contents of getin tree

Special report (Section 3.7) creates an output text file that, for a selected getin/getout database, shows all occurrences of each call within a selected level range.