tmexport : XTM Export Utility

Command Synopsis
Usage Examples

The tmexport command can be used to export topic maps from the TMCore system as XTM files. The utility includes an option to dump all of the topic maps from the system as XTM, or to specify selected topic map(s) to export.

Topic maps are always exported to a file in the current directory with the file name being the same as the topic map name in the topic map system. Any special characters in a topic map name that are not allowed as file name characters will be replaced with the underscore (_) character.

Command Synopsis

tmexport [/host:<string>] [/database:<string>] [/userid:<string>] [/password:<string>] [/all] [/force] [/verbose] {mapname...}

Table 2. tmexport Parameter Summary

Parameter (Short Form)	Description
/host (/h)	Specifies the name or IP address of the database server that hosts the TMCore system database. Defaults to 'localhost'.
/database (/d)	Specifies the name of the database catalog that contains the TMCore system tables. Defaults to 'topicmap'.
/userid (/u)	Specifies the database user ID to use when connecting to the database. If this parameter is omitted, the connection will instead use the current Windows login for database authentication.
/password (/p)	Specifies the password to use when connection to the database. This parameter is ignored if the `/userid:` parameter is not present. If the `/userid:` parameter is present and this parameter is omitted, the program will attempt to connect to the database using the specified user ID and no password.
/all (/a)	Specifies that all topic maps in the TMCore system should be exported. If this parameter is specified then any topic map names provided on the command-line will be ignored and all topic maps will be exported.
/force (/f)	If this switch is specified on the command line, then the application will silently overwrite existing files. Otherwise, you will be prompted for each possible file overwrite.
/verbose (/v)	Give more verbose error messages.
mapname	The name of the topic map to be exported. You may specify multiple topic map names on the command line by separating each name with a space. If a topic map name contains a space, use quotes on the command line (e.g. tmexport "My Topic Map").

Usage Examples

The following examples do not show examples of the /host /database /userid or /password options which work exactly as for the tmimport application.

tmexport mymap.xtm

Exports the topic map in the TMCore system with the name 'mymap.xtm'. The data will be written to a local file named mymap.xtm.

tmexport mymap.xtm myothermap

Exports the topic maps in the TMCore system with the names 'mymap.xtm' and 'myothermap'. The data will be written to the files mymap.xtm and myothermap respectively.

tmexport /a /f

Exports all topic maps from the TMCore system to XTM files in the local directory. This export will silently overwrite any existing files in the same directory when a name-clash occurs (because of the /f option).