My Way ©MJH 1996-2017
TMG™ GEDCOM Export Issues ©MJH 1996-2015

Modified August 11, 2017 3:20 pm
Michael J. Hannah <send e-mail>, Los Ranchos, NM.

TMG™ GEDCOM Export
Guide to Limitations and Issues ©MJH

NOTICE/DISCLAIMER: This document is not authorized or official TMG documentation. Instead see the embedded “ Help ” facility within your version of the program. I do not warrant in any way that the contents are accurate or useful, and any use of them is at the user’s own risk.

Any errors are undoubtedly mine. Corrections and suggestions can be addressed to me and posted on the TMG-L Mailing List hosted on Rootsweb where other TMG users may see them and comment.

Overview

These notes primarily cover advanced use of TMG and GEDCOM. I believe if TMG users only do the basic Birth, Death, Marriage, one set of parent/child relationships, and one-Principal events, with basic sources, their exports should be clean and simple. Further, whether they will care about these advanced issues will greatly depend upon the purpose of their export. If the user is providing the GEDCOM to some importing destination which will only accept basic information, then these notes are probably of little interest.

My following notes about TMG GEDCOM export issues are based on my testing through the final TMG Version 9.05. Most of my testing was done exporting to GEDCOM 5.5, which I recommend. Users are urged to test and verify any output from their own TMG projects. With the possible exception of some past bug fixes and the Enhanced Export Option, I believe most of these notes apply to GEDCOM exports from Version 7.04 to the present and probably before that.

This article is in two sections: basic GEDCOM export issues:

Limitations, ID Numbers, Names, Dates, Two-Principal Tags, Relationship Tags, Citations, Sources, Repositories, Tag Names, Exhibits, My Export recommendations

and an Enhanced Export Option introduced in Version 9.04:

Address/Telephone, Note/Name dates, Sort dates, Witnesses, Surety, Repository detail, Lengthy descriptions

Basic GEDCOM Export Issues

Output Limitations

The TMG export wizard provides options for some types of information to select whether that data will be exported. If data begins with an exclusion mark ‘-’ it will not export unless that option is set, but the TMG tag will still generate a GEDCOM tag. For example a TMG Note tag which only has an excluded memo will generate a completely blank GEDCOM NOTE tag. However, if the export option “Show Excluded Data” is selected, the output will include the leading dash. Data that begins with double exclusions or data within text marked [HID:][:HID] is never exported. 1 All parts of split memos 2 are exported complete with their double bars, even if a particular part other than the first is marked with single or double exclusion marks. Sensitive data (text surrounded by sensitivity braces ‘{‘ and ‘}’) will only export if that option is selected, and the braces will be stripped unless requested to remain by selecting the export option “With Markers”.

All embedded text format codes (e.g. [ITAL:]text[:ITAL], [BOLD:]text[:BOLD], etc.) as well as the HTML format codes (e.g. [WEB:]url;text[:WEB], etc.) are removed and not exported, but the text within them is exported. See below concerning the embedded citations codes.

Beginning with TMG Version 5, options were introduced which permitted selecting a subset of individuals within a dataset by first selecting a dataset, then selecting a subset of individuals that is defined either in the Project Explorer or in a saved Focus Group.

Regardless of which Place fields are selected for export, the export uses only the following fields of a Repository: Name (Other); Place: Detail (not Addressee), City, State, Postal, Country, and Phone; and the Repository memo. A full GEDCOM repository record output from TMG will be:

0 @R1@ REPO

1 NAME Repository Name Other

1 ADDR Repository Place Detail

2 CITY Repository Place City

2 STAE Repository Place State

2 POST Repository Place Postal

2 CTRY Repository Place Country

1 PHON Repository Place Phone

1 NOTE Repository memo

The GEDCOM specifications identify maximum allowed text lengths for each of these fields as:

NAME - 90

ADDR - 60

CITY - 60

STAE - 60

POST - 10

CTRY - 60

PHON - 25

NOTE - essentially unlimited

The GEDCOM specifications generally expect an ADR1 tag subordinate to the ADDR tag similar to City, State, etc. data as the location of the address detail, but TMG places this data directly on the ADDR tag. (See also the Version 9.04 Enhanced Export Option below.) An ADR1 tag has the same maximum field length as the ADDR tag. TMG will export to the length it allows as input up to the maximum specified GEDCOM line length. Importing programs are within their rights to not allow longer text and/or to truncate any data in these fields to these maximum lengths.

While an ATTR tag existed in GEDCOM 4.0 which could be used for custom flag values, in GEDCOM 5.5 the ATTR tag no longer exists. The only other option is the GEDCOM ATTRIBUTE_TYPE, but that is now a fixed list. As such, TMG Flags are not exported.

Certain project/dataset information is not exported. The dataset file name could be under HEAD as the GEDCOM FILE tag. Also the full name of the TMG project could be in a NAME tag subordinate to SOUR in HEAD . The contents of the user’s dataset memo ( .DOC file) could be exported as a NOTE tag under HEAD . However, none of this is exported by TMG.

ID Numbers

TMG exports its ID number of the individual in the TMG dataset as their GEDCOM INDI number in the output file. That permits a direct correlation between the GEDCOM file and the original dataset. Some importing programs will use the GEDCOM INDI number as the ID number of the record created from the GEDCOM file. However, if there are gaps in the sequence of TMG ID numbers, some importing programs may have problems with the missing numbers or give errors. The GEDCOM specifications require the INDI number to be unique within this file, be surrounded by the at-sign character ‘@’, not begin with a number sign ‘#’, and not contain either a colon ‘:’ or exclamation ‘!’ character. If your project has multiple datasets the displayed TMG ID number usually is preceded by the dataset number and separated by a colon, e.g. (2:94). Since you can only export from one dataset at a time, and the INDI number cannot contain a colon, the dataset number is not exported as part of the GEDCOM INDI number, e.g. @I94@. For additional output of those TMG ID numbers see my GEDCOM recommendation number 5 below.

Names

The GEDCOM specifications define the construction of the entire name which is required to be on the GEDCOM NAME tag entry as:

1 NAME <TEXT1> /<TEXT2>/ <TEXT3>

These specifications state that TEXT2 is identified as the entire Surname since it is between slashes. Any of the three parts can be empty/missing but the slashes are expected. While TMG will infer empty name fields from the Primary Name tag for its reports, whether blank name fields in the GEDCOM output are inferred depends upon the “Name NPFX/NSFX” TMG Export option. If the GEDCOM Export option “Name NPFX/NSFX” is not checked, the subordinate namepart records for the NAME tag are not created, but if either TEXT1 or TEXT2 would be empty the NAME tag will include all inferred values for that otherwise empty field. 3 With the GEDCOM Export option “Name NPFX/NSFX” checked, no name fields are inferred even if TEXT1 and/or TEXT2 would be empty, and TMG will separately export up to six non-empty subfields from a TMG Name tag as:

1 TITL titlefield

1 NAME prefixfield givenfield /presurnamefield surnamefield/ suffixfield

2 NPFX prefixfield

2 GIVN givenfield

2 SPFX presurnamefield

2 SURN surnamefield

2 NSFX suffixfield

When constructing the complete name for the GEDCOM NAME tag the TMG Export combines the prefix and given in TEXT1 separated by a space, combines presurname and surname in TEXT2 separated by a space, and only puts the suffix in TEXT3 .

Although defined in GEDCOM, even if the TMG Name-Var tag is Name-Nick, TMG does not export anything into the NICK GEDCOM namepart. Neither the “OtherName” field, nor either of the sortname fields are exported. 4 If the TMG Name tag has a memo or citations these will export to GEDCOM. But the GEDCOM NAME structure does not define a DATE namepart, so the TMG Date field will not export. (See also the Version 9.04 Enhanced Export Option below.)

While the GEDCOM specifications allow multiple NAME tags for an individual, they include no mechanism to assign a specific NAME tag to be associated with a specific event. Thus this linkage feature in TMG is lost on export.

TMG “Title” Name Field

Regardless of the setting of the GEDCOM Export option “Name NPFX/NSFX”, the TMG “Title” Name field does not export as part of the GEDCOM NAME structure. Instead that TMG Name subfield always exports to a separate GEDCOM TITL tag. While GEDCOM does define a TITL tag type, that TITL event GEDCOM structure originally was designed to record the event upon which the title was granted. None of the TMG’s structures can produce a full GEDCOM TITL event structure, as the export of both TMG Name tags and Event tags have export limitations. A TMG Name type tag has no option to enter a Location so cannot export it, and the GEDCOM NAME tag has no option to include a DATE . (See also the Version 9.04 Enhanced Export Option below.) A TMG Event type tag can have both a Location and a Date, but it will export the entire memo even if split as the TITL value, so cannot export a separate memo.

A TMG custom Title-Event tag type in the Other group with a memo limited to the text of the title, and its TMG GEDCOM Export tag type set to TITL , would export closest to the defined intent of the GEDCOM TITL tag type. But such a custom event will have no recognition in TMG as being part of a name. As the Date (might be included by the Enhanced Export) and Location might be included as text in the memo, a Name-Title tag type in the Name group which only includes the Title text seems the best compromise for both TMG use and GEDCOM export.

If the GEDCOM Export option “Name NPFX/NSFX” is checked and there is data in more than the TMG Title field, both a GEDCOM TITL and a NAME tag will be exported. 5 The TMG Title field is exported as the GEDCOM tag TITL but that TITL tag will not include the memo and/or citations. The separate NAME tag will include the other name fields and any memo and/or citations. A TMG Name tag that only has data in the Title field will export only a TITL tag for the Title field text which will include the memo and/or citations.

If the GEDCOM Export option “Name NPFX/NSFX” is not checked and there is data in more than the TMG Title field, both a TITL tag and a second tag (either a NAME or another TITL tag) 6 will be created, both will contain the memo and/or citations, and the second tag will have inferred name values. Even when the option is not checked, a TMG Name tag that only has data in the Title field will export only a TITL tag for the Title field text which will include the memo and/or citations.

Dates

For both export and import there is a one-to-one relationship of the TMG standard date modifier codes and a GEDCOM date modifier as follows:

TMG Code

TMG Term

GEDCOM Code

0

Before

BEF

1

Say

EST

2

Circa

ABT

3

Exact

(no modifier)

4

After

AFT

5

Between

BET d1 AND d2

6

Or

EITHER d1 OR d2*

7

From...To

FROM d1 TO d2

*The date format of EITHER OR is not defined as valid in the GEDCOM specifications. However, this GEDCOM format is what TMG’s final Version will produce on Export from its Or Date format, and TMG will convert that format upon Import to its Or format. Hopefully another program will either accept this format on Import or at least produce a message indicating an invalid format.

There are two additional legal GEDCOM date forms which are not exported by TMG's standard date codes: CAL and INT . However, TMG's irregular date format can accomodate the export of those two GEDCOM date forms, up to the maximum of 29 characters allowed in TMG's irregular dates. For example, a TMG irregular date of:

CAL 1901

will export as the standard GEDCOM CAL (calculated mathematically) date form:

2 DATE CAL 1901

A GEDCOM INT date means “interpreted from knowledge about the associated date phrase included in following parentheses”. Since a TMG irregular date is limited to a maximum length of 29 characters, a meaningful phrase, complete with parentheses, can often be difficult. However, the TMG irregular date of:

INT 1901 (Fourth George R)

will export as the standard GEDCOM INT (interpreted) date form:

2 DATE INT 1901 (Fourth George R)

Two-Principal Tags

The GEDCOM specifications only define two types of records associated with people: Individual records and Family records. There is no definition of a general “two-person” record. Family records are used to describe “marriages, common law marriages, and family unions caused by two people becoming the parents of a child”. A Family record is created for the two individuals being designated as explicitly married or share parenting a child, and the two individuals are identified by the HUSB and WIFE entries in the GEDCOM Family record. “The family record structure assumes that the HUSB /father is male and WIFE /mother is female.” Family events within the GEDCOM Family record thus are shared by these two individuals. Individual records are “a compilation of facts, known or discovered, about an individual”. Individual events within the GEDCOM Individual record apply only to this one individual. TMG tags can only be exported as an event within one or the other of these two types of records. Either the event must be within a Family record relating to both the “husband” and “wife” of the “family union” or within an Individual record associated with only one person. This is the explicit design of the GEDCOM 5.5 specs. Only family events are defined by the GEDCOM specifications as relating to two Principals, all other GEDCOM events have no mechanism defined for anything but one Principal. (See also the new Enhanced Export option below for a custom mechanism to link Witnesses to an event.)

If the two Principals assigned to a TMG tag are married or share parenting a child, and the export GEDCOM event type for that TMG tag type is defined as an expected or potential Family event (see the list of GEDCOM event types below), then the TMG tag will be exported as an event within the Family record of that family union. Such tags will not be exported as part of the Individual records of either of the two Principals.

If the two Principals are not married nor share parenting a child, and the export GEDCOM event type is defined as an expected or potential Family event, the tag is not exported in any way. TMG excludes the entire tag from the GEDCOM output. 7

TMG tag types with only one Principal set to export as an expected or potential Family GEDCOM tag type involve special conditions. Some GEDCOM tag types are expected to be GEDCOM Family events and have two Principals, such as the default export of standard tag types in the TMG Marriage and Divorce groups plus Annulment. Some GEDCOM tag types potentially can be either Family events or Individual events. TMG appears to deal with such one-Principal tags differently depending upon their group.

Standard one-Principal TMG tag types which are set to export as GEDCOM tag types expected to be GEDCOM Family events will still export as a Family event in a GEDCOM Family record which identifies only that one spouse.

Custom one-Principal TMG tag types which are set to export as GEDCOM tag types expected to be GEDCOM Family events will not export.

• A one-Principal TMG tag type which is set to export as a GEDCOM tag type which potentially can be either a Family event or an Individual event will export as an Individual event.

If the export GEDCOM event type for that TMG tag type is defined as a strictly Individual event (see the list of GEDCOM event types below), then the TMG tag will be exported regardless of the relationship of the two TMG tag Principals and regardless of the number of Principals. If there are two Principals, the single TMG tag will become two GEDCOM Individual events, a duplicate created within each Principal’s Individual GEDCOM record. However, any indication of a linkage of the two Principals to this identical event is lost in the GEDCOM output.

TMG tag types set to export to GEDCOM as 1 EVEN 2 TYPE deserve special mention. EVEN is a catch-all and is the default GEDCOM export tag type for custom tag types in TMG. The TMG tag type Name is the fixed value to output in that GEDCOM event’s TYPE field. 8 Since 1 EVEN 2 TYPE events are among those which are potential Family events, the export actions for those types of events apply. Thus if there are two Principals who are married or share parenting a child, the tag will export as an event within a Family record. If the two Principals are neither, the tag will not export. If there is only one Principal, the tag will export as an Individual event.

Whatever the situation with the Principals, the GEDCOM export tag type for a custom TMG tag type must be set on the Other tab of the Tag Type Definition screen either to a existing allowed GEDCOM tag type, or to the generic 1 EVEN 2 TYPE event type. If the TMG export option is explicitly set to a named but undefined or unallowed GEDCOM tag type, that TMG tag type will not export.

With the ability to output Witness links using the new Enhanced Export option, users may wish to change the linkage of one of the two “non-family” Principals to be a Witness to the tag instead of a Principal using an appropriate role. With that change the linkage of both individuals to this one GEDCOM event will be retained within the enhanced GEDCOM output. A List of Events report can identify all TMG tags in a project which have two Principals with a filter like:

Principal1... // ID # // <> Does not equal // 0 // AND
Principal2... // ID # // <> Does not equal // 0 // END

I suggest including in the report’s output columns the Column Types of “Tag Type Group” and “Tag Type Label” as the first two sort fields, along with at least “Prin1 ID” to identify the specific tag. With this report sort, those tag types which are expected to be GEDCOM Family events and have two Principals (such as those in the Marriage and Divorce groups plus Annulment) can be quickly identified. The TMG tag types which potentially might be accepted as GEDCOM Family events (depending upon the two Principals being married or parenting a child) are any TMG tag types which output as 1 EVEN 2 TYPE plus those with a default GEDCOM tag type which is identified as both an Individual and Family event in the list of GEDCOM tag type names below. These standard TMG tag types include by default: Anecdote, Association, Census, Event-Misc, History, HTML, Illness, JournalConclusion, JournalIntro, Living, Military-Begin, Military-End, NarrativeChildren.

Relationship Tags

There are several export limitations concerning relationship tags. TMG will only export Primary relationship tags. Neither the memo nor the citations on the Primary relationship tags will be exported. While GEDCOM 5.5 has no structure for citations directly on its relationship tag types (i.e FAMC or FAMS ) so none are exported, it does have the capability to include a memo/note, but TMG does not export it. 9 Further all primary relationship tags will be exported as if they are birth/genetic relationships, regardless of the TMG relationship tag type. Although the GEDCOM 5.5 definition of the FAMC tag structure allows the nature of that entire family relationship (implying both father and mother) to be defined as one of four types using a PEDI qualifier tag (defined values: adopted, birth, foster, sealing), TMG does not use the PEDI qualifier on export. 10

No non-primary relationship tags will be exported 11 even though the GEDCOM 5.5 standard does define a method to allow a child to be linked to multiple family structures using multiple GEDCOM FAMC tags. However GEDCOM considers all of those linkages to be (potential) biological relationships.

Citations

First, TMG will only include in the export those sources linked to some person or tag which is exported, and those repositories which are linked to exported sources. If the source is not cited, it is not exported. As specified in TMG HELP: “If the citation detail is split, only CD1 is exported.” Further CD1 is placed in the GEDCOM PAGE subtag under the SOUR tag reference. The GEDCOM specification limits PAGE text to a maximum of 248 characters. One Wholly Genes Forum post suggested choosing to restrict one’s memo data entry use to CD2 through CD9 for TMG output template purposes. Then with the Citation Preview option 12 one could copy the created Full Footnote text and paste it into CD1. That way the TMG templates could be used, but the Full Footnote text (if it did not exceed 248 characters) would export to GEDCOM.

Since GEDCOM has no subtag for a Citation Reference, if the Export options specify to output the Citation Reference TMG will export it following the Citation Detail in the GEDCOM PAGE subtag separated by a semicolon. The combined export may still be limited to the maximum of 248 characters.

The entire citation memo will be exported to GEDCOM in a NOTE subtag, possibly with continuation lines, under the SOUR tag reference. If the citation memo is split, all parts including the separator bars will be exported. If the CM is not otherwise used in TMG source templates, the Full Footnote preview text could be copied and pasted to that TMG field for GEDCOM export.

Any embedded citation which is included in a TMG Tag Memo will not export. All the text between the embedded citation codes, including the codes, will not appear in the GEDCOM NOTE tag, nor will there be output a source citation to that source.

There is an option in the Export Wizard to export citation Surety values to GEDCOM. 13 I don’t use Surety so have not extensively tested this feature. However, the QUAY tag produced by this option can only accept one integer value, and the only values defined are 0, 1, 2, and 3. TMG will export only the P1 Surety as the QUAY value, and will not export a QUAY tag if the P1 value is either blank or a minus sign ‘-’. (See also the Enhanced Export option concerning Sureties.)

Sources

The GEDCOM citation points to a separate GEDCOM source record structure which is considerably more limited in capability than TMG Source records. There are only five main GEDCOM elements in the SOUR record to contain all the actual data about the source, plus a few elements in the REPO record. In contrast TMG has 31 different Source Element Groups which can contain variable data about the source and repository, although a single source can only include 23 of those elements.

In some cases the TMG Source Element name/alias used in this source definition can output, plus there can be additional fixed data entered as text output from the source templates. 14 TMG attempts to squeeze all these 31 elements and these names/aliases into the limited GEDCOM source elements. Numerous alternate names/aliases for a TMG Source Group can be defined, called Source Elements. But for all groups there is one standard Source Element name which is essentially identical to the name of the Source Element group. That name is used for clarity in the table below, but the Source Element alternate name/alias is in some cases output also as text in that GEDCOM field.

The TMG fields potentially exported into each GEDCOM SOUR record field are listed below. Multiple TMG fields output into a single GEDCOM field are output in the order shown , separated by commas unless otherwise specified. Fields marked with SE below are output preceded by the TMG Source Element name/alias used in that source definition ending in a colon. When multiple fields could output in a single GEDCOM field, any fields whose text contains commas and/or colons can make it difficult to tell when one field ends and another begins. Fields which are not marked with SE below and thus are not identified by their Source Element name make it especially unclear whether the text is from such an additional field, or was simply part of the text being output from the preceding TMG field. Since any field not marked with SE below does not output it’s alternative Source Element names/alias, such names will be lost in the GEDCOM export. If a GEDCOM field can contain multiple fields and the first or only field output is marked with SE below, the field will begin with that name/alias.

ABBR

Abbreviation (if no Short Title); otherwise Short Title, Short Subtitle (separated from a Short Title by a colon, not output if no Short Title)

TITL

Abbreviation (only if otherwise empty), Title, Subtitle (separated from a Title by a colon), Record Type SE , Subject SE , Second Person SE , Location SE , Second Location SE , Series SE , Edition SE , Volume SE , Version SE , Pages SE , File Reference SE , Film Number SE

AUTH

Author, Compiler SE , Editor SE

NOTE

Comments

PUBL

Publisher, Publisher Location, Date, Second Date (Source Element name is separated from the date by a comma)

CALN

Repository Reference

Repositories

If a TMG source definition has a repository linked on its Attachments tab, that GEDCOM SOUR record will in turn point to a separate GECOM REPO record which will export the details of the one TMG Repository linked as primary. If multiple repositories are linked to this source, only the link to the primary is exported. A Repository definition will only be exported if it is linked as primary to some source which is exported. If the TMG “Name-ID #” field in the repository definition has an ID number of an individual as the repository, the REPO subfield of the SOUR record will link directly to that individual's GEDCOM record. A separate GEDCOM REPO main record is not created for such a Repository Definition, so anything else entered in any field of that TMG Repository Definition is lost in the export. A Repository Abbreviation is never exported, even if the Name-Other is empty.

NAME

Repository Name-Other (if that field is empty, the word “unknown” is output as the name)

ADDR, CITY, STAE, POST, CTRY, PHON

Non-empty address fields from the repository definition. (See also the enhancements to the Repository Detail place field when the V9.04 Enhanced GEDCOM Export option is used.)

NOTE

Repository Memo

GEDCOM Tag Names

Many standard TMG tag types are set to export as a specific GEDCOM tag name which is not included in the strict GEDCOM 5.5 definition. Even though they are the TMG export default, none of them (marked with the superscript NO in the table below) will export since the GEDCOM tag type is unrecognized. All of their event data will be lost on export if their GEDCOM export tag type is not changed to a recognized name, or to 1 EVEN 2 TYPE . Because I generally prefer to strictly adhere to the GEDCOM 5.5 definition as well as try to avoid loss of data, I usually modify such TMG Tag Types in the Other tab of the Tag Type Definition to avoid its unrecognized tag name and use the general purpose 1 EVEN 2 TYPE structure for GEDCOM export:

1 EVEN

2 TYPE TMG-tag-name

Any program accepting GEDCOM 5.5 should accept these generic definitions as custom events. This is also the only mechanism to retain a custom TMG tag type Name. If multiple TMG tag types are set to export to the same specific defined GEDCOM tag name, their different original tag type Names are lost.

Some standard TMG tag types export to a defined GEDCOM tag name, but do not or cannot export all the data which may be stored in the TMG tag type. A major example is the TMG Note tag type, which by default exports as the defined GEDCOM NOTE tag type. The entire memo will export as the text on the NOTE tag with possible CONC tags if necessary. But neither the Date nor the Location will export. (See also the Enhanced Export option below for custom output of the Date. That produces tag names with a leading underscore character, which is the naming method defined by the GEDCOM standard to identify a non-standard tag name.) I also recommend these GEDCOM export tag types specified in the table below be changed to 1 EVEN 2 TYPE so that all the TMG data will export. However, be aware of the affect this may have on such tags if assigned two Principals as described above.

Default GEDCOM export tag names

The following table lists the TMG Tag Types which are included in a “New” project 15 and the default GEDCOM tag type which they are set to output by default. Projects upgraded from earlier versions may have older and thus different defaults. The Notes in the table below indicate whether this GEDCOM tag type is a standard tag type defined in GEDCOM 5.5.

GEDCOM Family events generally assume/require two Principals who are either married or share parentage to a child. See the comments above about two Principal events.

Any TMG tag type, standard or custom, whose GEDCOM Export option is set to export as a TMG recognized Individual GEDCOM Attribute event 16 can be affected by the TMG Export Option “Extract recognizable memos as tags”. If this option is not selected, the tag will export according to the GEDCOM tag type set in the TMG Tag Type Options. But if this option is selected and TMG recognizes the first word of the tag memo as one of TMG’s recognized Individual GEDCOM Attribute Event names 17 followed by a colon, then TMG will export using that GEDCOM tag name instead of the GEDCOM tag type specified for this TMG tag type. All the memo text following the colon will output, using GEDCOM CONC lines if necessary. Any blanks following the colon are stripped. Historically this feature was introduced to deal with data imported from early PAF versions where "tags" were recorded in memo fields in the form: TAGNAME: data. Since the TMG tag type’s GEDCOM export tag type and the name in the memo must be a recognized Individual GEDCOM Attribute event name, and some standard TMG tag type will already output as this GEDCOM tag type, there now seems little value to this option. As an example, a custom TMG “MyTag” tag type might be set to export as the Individual GEDCOM Attribute event DSCR. But if the memo of a tag of that type begins with the text: NATI:more text , a DSCR GEDCOM tag will not be output. Instead a NATI tag will be output as:

1 NATI more text

The TMG tag types marked with a superscript LDS will be hidden if the “Show LDS tag types” option is unset on the Master Tag Type List. As mentioned above, the TMG tag types whose GEDCOM tag type is marked with a superscript NO should be changed to export as the generic GEDCOM 1 EVEN 2 TYPE tag type since TMG will not export the tag type as there is no defined GEDCOM tag type of that name. The TMG tag types marked with a superscript # should be used with caution as some of the TMG event information will be lost on export. They also may be good candidates to export as the generic GEDCOM 1 EVEN 2 TYPE tag type. The few standard GEDCOM tag types which have no standard TMG tag type are good candidates for creating a TMG custom tag type with its export set to that name.

TMG Tag Type

GEDCOM
Tag Type

Notes

Address

ADDR NO

Not a defined GEDCOM event, but a subfield of an event, similar to PLAC and PHON.

Adoption

ADOP

Standard Individual GEDCOM Event

AFN #

AFN

Standard non-event GEDCOM tag type. There is also a TMG Export option to produce this tag using the TMG Reference Field data.

Age

AGE NO

Not a defined GEDCOM event, but a subfield of an event, or of HUSB/WIFE in a family record, to specify the age at the event.

Annulment

ANUL

Standard Family GEDCOM Event

Association

 

In earlier versions the GEDCOM export tag type was set to ASSO, but that GEDCOM structure has a very different purpose than this TMG event tag type. In Version 9.03 this TMG type is set to export as 1 EVEN 2 TYPE.

 

ASSO

Standard non-event GEDCOM tag type for associating/linking two people together. TMG has no mechanism to produce what is required by GEDCOM for this tag type.

Attributes

ATTR NO

Not a defined GEDCOM event or keyword.

Baptism

BAPM

Standard Individual GEDCOM Event

BaptismLDS LDS

BAPL

Standard LDS Individual Ordinance GEDCOM Event

BarMitzvah

BARM

Standard Individual GEDCOM Event

BatMitzvah

BASM

Standard Individual GEDCOM Event

Birth-Covenant LDS

BIC NO

Not a defined GEDCOM event but a value for the STAT subfield of the SLGC event

Birth

BIRT

Standard Individual GEDCOM Event

Blessing

BLES

Standard Individual GEDCOM Event

Infant BlessingLDS LDS

BLSL

Standard LDS Individual Ordinance GEDCOM Event

Burial

BURI

Standard Individual GEDCOM Event

CancelSeal LDS

CANC NO

Not a defined GEDCOM event or keyword. The full word “CANCELED” is used as a value for the STAT subfield of the SLGS event

Caste

CAST

Standard Individual GEDCOM Attribute Event

Census

CENS

Both a standard Individual and Family GEDCOM Event

Christening

CHR

Standard Individual GEDCOM Event

 

CHRA

Standard Individual GEDCOM Event for Adult Christening. Not a standard TMG tag type.

Codicil

CODI NO

Not a defined GEDCOM event or keyword.

Confirmation

CONF

Standard Individual GEDCOM Event

ConfirmLDS LDS

CONL

Standard LDS Individual Ordinance GEDCOM Event

 

CREM

Standard Individual GEDCOM Event for Cremation. Not a standard TMG tag type.

Criminal

CRIM NO

Not a defined GEDCOM event or keyword.

Death

DEAT

Standard Individual GEDCOM Event

Divorce

DIV

Standard Family GEDCOM Event

Divorce Filing

DIVF

Standard Family GEDCOM Event

Description

DSCR

Standard Individual GEDCOM Attribute Event

Education

EDUC

Standard Individual GEDCOM Attribute Event

Emigration

EMIG

Standard Individual GEDCOM Event

Employment

EMPL NO

Not a defined GEDCOM event or keyword.

EndowmentLDS LDS

ENDL

Standard LDS Individual Ordinance GEDCOM Event

Engagement

ENGA

Standard Family GEDCOM Event

Anecdote, Association,
Event-Misc, History,
HTML, Illness,
JournalConclusion,
JournalIntro, Living,
Military-Begin, Military-End,
NarrativeChildren

EVEN

Both a standard Individual and Family GEDCOM Event. Any TMG tag type can be set to export as the generic GEDCOM tag type of EVEN with a TYPE subfield having the TMG name of the tag type. The listed TMG tag types have this option set by default.

Excommunication

EXCO NO

Not a defined GEDCOM event or keyword.

Communion1st

FCOM

Standard Individual GEDCOM Event

GEDCOM

GEDC NO

Not a defined GEDCOM event, but a subfield of the header of the file defining the GEDCOM version used in the file. This TMG tag type is used by default on import for any unrecognized GEDCOM tag type.

Graduation

GRAD

Standard Individual GEDCOM Event

Birth-Illegtimate

ILLE NO

Not a defined GEDCOM event or keyword.

Immigration

IMMI

Standard Individual GEDCOM Event

 

IDNO

Standard Individual GEDCOM Attribute Event for a national ID number. Not a standard TMG event.

Marriage bann

MARB

Standard Family GEDCOM Event

Marriage contract

MARC

Standard Family GEDCOM Event

Marriage license

MARL

Standard Family GEDCOM Event

Marriage

MARR

Standard Family GEDCOM Event

Marriage settlement

MARS

Standard Family GEDCOM Event

Misc

MISC NO

Not a defined GEDCOM event or keyword.

Name-Baptism, Name-Change,
Name-Married, Name-Nick,
Name-Variation

NAME

Standard Individual GEDCOM Name structure. See the separate comments above about exporting Names.

Namesake

NAMS NO

Not a defined GEDCOM event or keyword.

Nationality

NATI

Standard Individual GEDCOM Attribute Event

Naturalization

NATU

Standard Individual GEDCOM Event

Number of children

NCHI

Standard Individual GEDCOM Attribute Event

Number of marriages

NMR

Standard Individual GEDCOM Attribute Event

Note #

NOTE

Standard non-event GEDCOM tag type

NullifyLDS LDS

NULL NO

Not a defined GEDCOM event or keyword. “NULL” is used in the GEDCOM standard to indicate the absence of any text for the value. There is no apparent equivalent LDS event in the GEDCOM standard

Occupation

OCCU

Standard Individual GEDCOM Attribute Event

Ordinance

ORDI NO

Not a defined GEDCOM event, but a field with a yes/no value in the header of the GEDCOM file to identify whether the submission should be processed for LDS ordinances. Thus the meaning of the TMG tag type is completely different from the meaning of the GEDCOM keyword.

OrdinationLDS LDS

ORDL NO

Not a defined GEDCOM event or keyword. Instead see ENDL or ORDN

Ordination

ORDN

Standard Individual GEDCOM Event

Passenger List

PASL NO

Not a defined GEDCOM event or keyword.

Telephone

PHON NO

Not a defined GEDCOM event, but a defined as a subfield of an event, similar to ADDR and PLAC.

Presumed cancelled LDS

PRES NO

Not a defined GEDCOM event or keyword. The full word “CANCELED” is used as a value for the STAT subfield of the SLGS event

Probate

PROB

Standard Individual GEDCOM Event

 

PROP

Standard Individual GEDCOM Attribute Event for identifying possessions/property. Not a standard TMG event.

Ratification LDS

RATI NO

Not a defined GEDCOM event or keyword.

Rebaptism

REBA NO

Not a defined GEDCOM event or keyword.

Reference #

REFN

Standard non-event GEDCOM tag type. There is also a TMG Export option to produce this tag using the TMG Reference Field data.

Religion

RELI

Standard Individual GEDCOM Attribute Event

Reseal LDS

RESE NO

Not a defined GEDCOM event or keyword.

Residence

RESI

Standard Individual GEDCOM Attribute Event

Restoration

REST NO

Not a defined GEDCOM event or keyword.

Retirement

RETI

Standard Individual GEDCOM Event

 

RFN

Standard non-event GEDCOM tag type for a permanent record file number. Not a standard TMG event.

 

RIN

Standard non-event GEDCOM tag type for an automated record ID. Not a standard TMG event.

 

ROLE

Standard GEDCOM sub-tag defined only as part of a source citation to identify what role this individual played in the type of event which was responsible for the source entry being recorded. Not used by TMG. Used by some other programs for the non-standard purpose of identifying the role of a witness to an event.

SealChildLDS LDS

SLGC

Standard LDS Individual Ordinance GEDCOM Event

SealParentLDS LDS

SLGP NO

Not a defined GEDCOM event or keyword. The GEDCOM 5.5 standard only defines the SLGC event to seal the child to a family (i.e. both parents). There is no defined event of sealing a parent to a child.

SealSpouseLDS LDS

SLGS

Standard LDS Spouse Sealing GEDCOM Event

SSN

SSN

Standard Individual GEDCOM Attribute Event. There is also a TMG Export option to produce this tag using the TMG Reference Field data.

Stake LDS

STAL NO

Not a defined GEDCOM event or keyword. The standard only defines TEMP as a subtag of LDS ordinance, endowmen, and sealing events for the LDS temple code

Birth-Stillborn

STIL NO

Not a defined GEDCOM event or keyword. STILLBORN is a value accepted for the AGE field of any event, or the DATE field of an LDS ordinance event.

 

TITL

Standard Individual GEDCOM Attribute Event for a nobility type title. Not a separate default TMG event. See the separate comments above about exporting Names.

VoidLiving LDS

VOIL NO

Not a defined GEDCOM event or keyword.

WAC LDS

WAC NO

Not a defined GEDCOM event or keyword.

Will

WILL

Standard Individual GEDCOM Event

Exhibits

I have not done extensive testing of the GEDCOM export of exhibits, either internal or external, as I do not choose to export exhibits to GEDCOM. (If I get a chance to do such testing I may update this article in the future.) One type of exhibit I have tested are internal text exhibits, which are not exported by TMG either attached to events or to sources. Exhibits is one of several areas in the GEDCOM specifications which is open to interpretation in how they should be represented. The specification does provide for “multimedia objects” within a GEDCOM file which are to be “encoded” as a “Blob”, but also has a rather short maximum record length for them. Since the GEDCOM file is primarily intended to be a text file, due to the ambiguity of the specification, and because exhibit files are often very large, I have found this an area which programs commonly do not implement.

I suggest it would be safer and more reliable to transfer exhibits separately as their original file types, rather than rely upon an uncertain GEDCOM “encoding” and “decoding”. Users also might consider John Cardinal's TMG Utility to convert all their TMG internal image exhibits to external ones to make such a separate transfer easier. The only method I have used to export internal text exhibits from TMG uses the “Export” feature in the TMG Utility to export the Exhibit Log. Although that produces a single file of all the exhibits, it could be post processed. While I have not personally tried it, the documentation for Bryan Wetton’s program PathWiz! suggests it can create external text files from TMG’s internal text exhibits.

 

My GEDCOM export recommendations

Even with the Enhanced Export option mentioned below, I do not recommend using GEDCOM to transfer your TMG data to another program if it can be avoided. Whenever possible a program which will directly import the data from the TMG project files themselves is likely to do a better job. By exporting to GEDCOM, too much is likely to be lost or require considerable post import cleanup. However if GEDCOM is the only option, the following may improve the ability to later import the GEDCOM file:

1) Use the Enhanced Export option if you are using Version 9.04 or later.

2) Set the GEDCOM export option to 1 EVEN 2 TYPE for all the TMG tag types which you use and are described in the above listing of GEDCOM Tag Names as having export issues. That export setting will insure that all data for such TMG tag types including dates and citations are exported as custom events. However, be aware of the affect this may have on such tags if assigned two Principals as described above.

3) Use the Secondary Output on a List of People report to change all Ancestor Interest (ANCI) and Descendant Interest (DESI) TMG Flags to 0 before export. Use a copy of your project to do this if these flags are useful to you in TMG. As these Flags are generally not recognized by other importing programs, this will remove numerous messages concerning them from an import.

4) When you select Surety export, do not select the SOUR sub-option. For some importing programs these extra tags cause problems. If you select the Enhanced Export option, this SOUR sub-option will be disabled as it will interfere with the custom export of TMG surety information.

5) In Step 5 of the TMG Export Wizard you can select the TMG ID numbers (the number assigned to each person in a data set) to export. As mentioned above, the GEDCOM INDI number will already be the TMG ID number. If this option is selected, the TMG ID Number (without any dataset number) also will be exported in a separate standard GEDCOM REFN tag as the tag following the GEDCOM INDI tag for that individual.

This option may be of use if the importing program does not use the GEDCOM INDI number as that individual’s ID number in the constructed dataset. Most importing programs will retain the GEDCOM REFN data, so this option at least should allow you to see the TMG ID number in such importing programs. In Step 7 of the Export Wizard you could specify that the TMG Reference field be exported also in a standard GEDCOM REFN tag. That REFN tag will be output in addition to the one specified for the TMG ID number.

6) Also in Step 5 you can select the character set to be used. TMG only provides the options of (ANSI, ANSEL, IBMPC) and defaults to ANSI which is the character set used by TMG’s underlying software. 18 However, the GEDCOM 5.5 specification only allows three specific character sets (ANSEL, UNICODE, ASCII) and expects ANSEL. 19 These character sets all differ in how they represent upper range special characters (the characters from 128 to 255). I have not fully tested whether such special characters will output differently within the exported file by specifying either of the other two character sets in TMG’s export. Unfortunately if the TMG export specifies ANSI, some software packages will not import such a file. All GEDCOM files specify the character set used to generate the file on an internal GEDCOM tag near the beginning of the file, e.g.:

1 CHAR ANSI

Users have reported simply changing that name of the character set in that line in the file using a text editor to be one of the allowed GEDCOM values so that the file will import. It is not clear whether changing this character set name will affect how a specific importing software will deal with or change these upper range special characters. I recommend leaving the TMG export as ANSI but changing the character set name in the file if your importing software objects to ANSI. The user should review how the importing software now displays such upper range characterrs.

7) Set the GEDCOM line length to TMG’s maximum line length of 246. This will minimize data loss on created GEDCOM tags where the GEDCOM CONT/CONC continuation tags are not allowed or are limited to only one continuation line.

Version 9.04 Enhanced Export Option

With the discontinuation of development of TMG, Wholly Genes added an optional enhanced export option to Version 9.04. Since the GEDCOM specifications are very limited, this option exports data from many of TMG’s advanced features which would normally be lost in “user-defined” custom GEDCOM tags. See the internal HELP file in Version 9.04 and the final Version for the official description of this option.

As of Version 9.04 a new Option in Step 5 of the GEDCOM export wizard was added:

[ ] Enhanced GEDCOM tag export (see Help)

As described in Version 9.04 and the final Version TMG HELP, when this option is selected a number of additions are made to the GEDCOM export. Unless explicitly mentioned as part of this enhanced export option, all the conditions described above regarding what data is exported to a GEDCOM file are unchanged whether or not this option is selected. For example, for a TMG tag with two Principals to be exported as a GEDCOM family record, the two principals still must be married or must be the parents of one of more children (or both). And TMG Tag Types set to export as one of the above-listed non-existent GEDCOM tag names instead of as 1 EVEN 2 TYPE will still not export.

Address and Telephone tags

As described above, by default these two TMG tag types are set to export as the non-existent GEDCOM tag types of ADDR and PHON . If these tag types, or any custom tag types, are still set to export this way, this option will export the tags as the custom GEDCOM tag types of _ADDR and _PHON .

Dates in Note tags and Name tags

If the TMG Note tag type, or any custom tag type, is set to export as the GEDCOM tag type of NOTE , dates will be exported as a custom GEDCOM subtag under the NOTE tag:

2 _DATE date

TMG Name tag types should always have the GEDCOM export selection set to NAME , and with this enhanced option dates associated with these tags will be exported as the custom GEDCOM subtag:

2 _DATE date

For some import programs in order for this date data to be recognized as dates, these custom GEDCOM subtags for either the NOTE tags or NAME tags may need their tag names edited after export in the GEDCOM file to the standard GEDCOM tag name format by removing the leading underscore character in the custom tag name.

Sort dates

Sort dates are an advanced TMG feature. While they always exist within TMG, they can only be explictly entered/modified when in TMG’s Advanced (versus Beginner) edit mode. This enhanced export option will export these sort date values as a custom GEDCOM tag type following any tag’s standard DATE tag or any custom _DATE tag added by this enhanced export option.

2 DATE date

2 _SDATE sort date

or

2 _DATE date

2 _SDATE sort date

Witnesses (those individuals not linked to tags as Principals)

A linkage to another individual who is a witness to this Principal’s TMG event tag, the witness’ TMG rolename , and any entered Witness memo specific to that witness now can be exported. The output will be a custom GEDCOM subtag _SHAR within that event’s GEDCOM structure with two subtags: a non-standard use of the standard GEDCOM ROLE subtag plus a standard NOTE subtag. The _SHAR tag will point to that witness using their INDI, the ROLE tag will contain the TMG rolename assigned to that witness in this tag, and the NOTE tag will contain their TMG witness memo. Since both the ROLE tag and the NOTE tag are subordinate to the custom _SHAR tag type, a custom use of these two subtags is implied. As an example, partial export output from a TMG Census event tag might be:

1 CENS

2 DATE date

2 _SDATE sort date

2 _SHAR @I2@

3 ROLE rolename for I2

3 NOTE I2 witness memo

2 _SHAR @I13@

3 ROLE rolename for I13

3 NOTE I13 witness memo

In the above example the numbers @I2@ and @I13@ point to the individuals with those GEDCOM INDI numbers in this GEDCOM file. As mentioned concerning ID numbers, they also are the TMG ID numbers of these individuals. As mentioned concerning NAME tags, there is no GEDCOM mechanism to assign a specific NAME tag to be associated with a specific event. Thus linkage of a particular NAME for this witness to this tag is lost on export.

Surety

TMG surety has many more values and indications than defined in the standard GEDCOM QUAY feature. This enhanced export option will add a NOTE tag as part of the GEDCOM SOUR citation record following the GEDCOM QUAY tag. The NOTE data will contain all of the TMG surety data for the citation.

3 QUAY 3

3 NOTE {TMG Surety 3.12.}

The five values will reflect the TMG surety values currently assigned to this citation. Consistent with TMG’s display of surety, periods will be used as filler values for blank surety values.

Repository Detail Place Field

As described above, the Repository Place Detail is output by TMG on the GEDCOM ADDR tag. With this enhanced export option this data will be duplicated in an ADR1 tag as follows:

1 ADDR Repository Place Detail

2 ADR1 Repository Place Detail

2 CITY Repository Place City

2 STAE Repository Place State

2 POST Repository Place Postal

2 CTRY Repository Place Country

1 PHON Repository Place Phone

1 NOTE Repository memo

Lengthy Descriptions

The main TMG tag memo text for the standard Caste, Descriptn (or Description), Education, Occupation, and Religion TMG tag types is output on the exported GEDCOM CAST , DSCR , EDUC , OCCU and RELI tag lines respectively. The GEDCOM specifications identify maximum allowed field lengths for the text on these tag lines for each of these tag types as:

CAST - 90

DSCR - 248

EDUC - 248

OCCU - 90

RELI - 90

TMG will export the entire memo text up to the maximum specified GEDCOM line length. Importing programs are within their rights to not allow longer text and/or to truncate any data in these fields to these maximum lengths. To prevent the text loss when the memo length exceeds 90 characters, with this enhanced export option selected for each of these five GEDCOM tag types the entire memo text will be moved to a NOTE tag subordinate to that tag and will not be truncated. Most importing programs will place the NOTE text in the event note field and the event description field for these imported tags will be empty. While these event tags will require post-import cleanup, no text will be lost.

TMG doesn't have a standard Property tag type. However if a user has customized a tag type to export as the standard GEDCOM PROP tag type which allows up to 248 characters on that GEDCOM tag line, this provision to deal with lengthy memos also has been implemented for that GEDCOM tag type.

 


1. There was a bug in Version  6 where text marked [HID:][:HID] was exported. This was corrected in Version 7.04.

2. See the separate topic concerning split citations.

3. When the option “Name NPFX/NSFX” is not checked, inferring of GEDCOM name parts only occurs for export to GEDCOM 5.5, not for GEDCOM 4.0. In GEDCOM 4.0 the NameVar is output as an ALIA tag. In GEDCOM 5.5 the NameVar is output as a separate Name tag. Tested in Version 9.03. I recommend selecting GEDCOM 5.5.

4. In addition to no field for Date, there is no field in GEDCOM to receive the TMG OtherName field or any sort name fields, regardless of the setting of the “Name NPFX/NSFX” option. They will be lost on Export.

5. Both a TITL and a NAME tag will be exported even if the TMG Name-Var tag is specified to output to GEDCOM as TITL.

6. If the TMG Name-Var tag is specified to output to GEDCOM as TITL, two TITL tags will be created: one with only the title value on the TITL tag, and one with a full inferred name without the title on the TITL tag.

7. TMG might have chosen to export two identical Individual events, one for each Principal, as it does for GEDCOM tag types defined as Individual events. However, this is not done for two-Principal tags exporting as GEDCOM tag types which are defined as either expected or potential Family events.

8. If a specific GEDCOM TYPE text value is desired, the TMG tag type Name must be set to that value.

9. Although the GEDCOM FAMC and FAMS tags do define the option of a NOTE subtag, and that NOTE itself could have citations, none of this is generated by a TMG export.

10. In TMG one parent could be biological and the other not. GEDCOM has no mechanism to show this. Even if both parents are set to the same TMG non-biological relationship tag type, TMG will not use the PEDI qualifier.

11. Since TMG does not export a PEDI qualifier subtag, if it exported multiple relationships all these multiple FAMC tags would appear to be birth relationships, denoting the child had multiple sets of birth parents. Further, there is no GEDCOM mechanism to specify different qualifiers for each parent.

12. Added in Version 9.00.

13. See the TMG HELP topic “GEDCOM Export” for more details of the options affecting the creation of the QUAY tag.

14. Need to do further testing to identify exactly what exports and when from the TMG source templates.

15. Obtained from the final Version. The longer TMG tag names introduced in Version 8 are used in this table.

16. The GEDCOM export option cannot be set to an Individual GEDCOM event or a Family GEDCOM Event, only a recognized Individual GEDCOM Attribute event tag type. TMG does not recognize IDNO or PROP as Individual GEDCOM Attribute event tag types.

17. TMG does not recognize IDNO or PROP as Individual GEDCOM Attribute event tag types. Thus this mechanism cannot be used to output those tag types. To generate such GEDCOM tag types a custom TMG tag type must be created and set to export as either an IDNO or PROP GEDCOM tag.

18. The underlying software is MicroSoft FoxPro, whose documentation states is based on the ANSI character set which is why the TMG software uses this term. This is not an official name of a standard character set, and actually refers to a character set defined by MicroSoft called “Windows-1252”.

19. ANSEL is a character set which defined some of the characters in the range 128-255 specifically for use in bibliographies. GEDCOM adopted it and defined some additional characters in this upper range. Unfortunately even those some of these character exist in the other character sets, the assignment of these characters in ANSEL do not match any of the other character sets (Unicode, ANSI, ASCII, IBMPC).


Disclaimer

I am not affiliated in any way with TMG™, its company Wholly Genes, Inc., or its primary author Bob Velke. I am simply a satisfied user of this software package and have constructed this document to aid me in its use.

If others find this content useful, so much the better. I do not warrant in any way that it is accurate or useful, and any use of its contents is at the user’s own risk.

This document was composed with Adobe® Framemaker® using its hyperlink and HTML conversion features.

©MJH Consulting, 1996-2017. All rights reserved.