tmdiag: Topic Map Diagnostic Utility

Command Synopsis
Usage Examples

The tmdiag command can be used to query topic maps searching for information about a particular topic map, topic or topic attribute. Using this tool you can:

  1. Get a list of topic maps in the database.

  2. Display information about any topic map object:

    1. Topic Map

    2. Topic

    3. Topic name

    4. Occurrence

    5. Association

    6. Association Role

Command Synopsis

tmdiag [/host:<string>] [/database:<string>] [/userid:<string>] [/password:<string>] [/objectid:<integer>]

Table 5. npcl 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.

/verbose (/v)

Give more verbose error messages.

/objectId (/o)

The non-negative integer identity of a topic map object in the database that is to be searched for.

If no value is specified or 0 is specified then a list of the topic maps in the database is displayed.

/name (/n)A topic name to search for. % and _ may be used as wildcards for any string or a single character respectively.
/subjectidentifier (/s)A full or partial specification of a subject indicator. % and _ may be used as wildcards for any string or a single character respectively. Specifying this option will display all topics that match the subject identifier pattern given, so care should be taken with this option when specifying very commonly used patterns, such as http%.
/occValueUsed to find an occurrence by value. % and _ may be used as wildcards for any string or a single character respectively.
/occResourceUsed to find an occurrence by resource. % and _ may be used as wildcards for any string or a single character respectively.

Usage Examples

tmdiag

Displays a list of topic maps available in the local topicmap database.

tmdiag /o:23

Displays information about the topic map object with identity 23.