Dump Journal Topic Index File
The amps_tx_topic_index_dump
utility is used to display the contents of an AMPS transaction log topic index file for debugging.
Command Line Options
The amps_tx_topic_index_dump
utility has the following options available. These can also be printed to the screen by providing the -help
option to the utility.
The utility requires one of the options (topic
, topic-hash
, or message-type
) to produce output.
Option | Description |
| Filename of the AMPS transaction log topic index file. |
| Show the program help message and quit. |
| Display offset list for a given topic. |
| Display offset list for topic. |
| Message type of topic used to produce topic hash. |
Looking at the Output
The output of the utility is a representation of the index. Notice that, since the index is optimized for speed and is only intended to be used to reference journal files, the index contains minimal information.
For example, the following dump shows the results from a topic where only three messages are present in the transaction log:
This shows the topic hash used in the transaction log, and information about the journals.
In this case, messages are found in journal 0 and journal 24.
The first message in journal 0 has local transaction id 1711058031000000105
. The messages in that journal file are at offset 29596
and offset 30976
within the file.
The other message is found in journal 24, with local transaction id 1711058031000999830
and is at offset 4411904
in the file.
Notice that the "transition" indicators are output to indicate the start of an index record for a different journal file. Also notice that the index contains no information about journals that do not contain messages for that topic, nor do they contain any information about the messages other than that needed to quickly locate messages for a given topic.
Last updated