3.17. MercMon

3.17. MercMon

MercMon provides counter information about DM3 device drivers (Class Driver and Protocol Driver). These drivers maintain various counters that can aid in monitoring system activities and interpreting system behaviors.

Operating Systems: Windows

Command Line: mercmon [parameter_list]

The MercMon utility uses the following command line parameters:

Parameter Description

/f <file> Log file name (default is mercmon.log)

/t<n> Display Timer. The time interval (in milliseconds) between each screen refresh (default is 1000).

/l<n> Logging Interval. The time interval (in seconds) between each log file update (default is 600).

/w Enable/disable logging to a file (default is enabled)

/? Displays the program help screen (optional)

Example: This example enables logging to the file mercmon.log every five minutes and refreshes the screen every two seconds:
 mercmon /t 2000 /l 300
Driver Counters: For counter details, see Table 5 and Table 6.

Note: All counters are on a per board basis except for failMpathFind and failStrmFind. These two counters are on a global basis.

Table 5. Class Driver Counters
Class Driver Counter Description

CompleteReads Returns the size (in Bytes) of all the Read requests completed by the Protocol Driver (i.e. the actual size in KB of all the data read from the board)

CompleteSends Returns the size (in Bytes) of all the Messages sent to or received from the board

CompleteWrites Returns the size (in Bytes) of all the Write requests completed by the Protocol Driver (i.e. the actual size in KB of all the data written to the board)

FailMpathFind Returns the number of times a request to get a Message Handle (Mpath) failed (global counter)

FailStrmFind Returns the number of times a request to get a Stream Handle failed (global counter)

NumCanTakes Returns the number of "Can Takes" received for that board

NumReads Returns the total number of Read requests sent down to the Protocol Driver

NumSends Returns the total number of Messages sent down to the Protocol Driver

NumWrites Returns the total number of Write requests sent down to the Protocol Driver.

NumWriteSplit Returns the number of write requests, which were split for that board

NumOpenedStreams Returns the number of Open Streams on that board at any given time

NumCloseStreamErr Returns the number of Stream close requests failed on that particular board

NumOpenStreamErr Returns the number of Stream open requests failed on that particular board

NumStreamClose Returns the number of Stream close requests on that particular board

NumStreamOpen Returns the number of Stream open requests on that particular board

SizeReads Returns the size (in Bytes) of all the Read requests posted down to the Protocol Driver

SizeSends Returns the size (in Bytes) of all the messages sent down to the Protocol Driver

SizeWrites Returns the size (in Bytes) of all the Write requests sent down to the Protocol Driver

TimeoutReads Returns the number of Read requests that timed out

TimeoutSends Returns the number of Messages that timed out while waiting to be sent to the board or awaiting a reply from the board

TimeoutWrites Returns the number of Write requests that timed out

Table 6. Protocol Driver Counters
Protocol Driver Counter Description

MsgsInPerSramSession Returns the number of messages read from the SRAM in one session

MsgsOutPerSramSession Returns the number of messages written to the SRAM in one session

NoInDataDPCisr Returns the number of times when we received an interrupt but there was no data transfer between the SRAM and the HOST

StrmsOutPerSramSession Returns the number of streams written to the SRAM in one session (i.e., number of data blocks written)

StrmsInPerSramSession Returns the number of streams read from the SRAM in one session (i.e., number of data blocks read)

TotalAsyncMsgQDone Returns the number of requests completed in the AsyncMsgQ

TotalBadSramAddr Returns the number of times we tried reading a message/data (Streams) from the SRAM but the SRAM address was wrong

TotalBadSramAddrAlloc Returns the number of times the system tried to allocate a data block but the address was wrong

TotalBadSramAddrRelease Returns the number of times the system tried to release a data block but the address was wrong

TotalBadSramDataCount Returns the total number of times we got a data block of size greater then the SRAM_DATA_BLOCK_SIZE

TotalBadSramOffset Returns the number of times we tried reading data (Streams) from the SRAM but the offset calculation was incorrect

TotalBadSramOffsetAlloc Returns the number of times when we allocated a data block but offset was incorrect

TotalBigMessagesRcvd Returns the number of times we read a "BIG" message from the SRAM (i.e. message size greater then 24 bytes)

TotalBigMessagesSent Returns the number of times we wrote a "BIG" message to the SRAM (i.e. message size greater then 24 bytes)

TotalBogusInterrupts Not used

TotalDpcOverruns Returns the total number of DPC overruns (i.e. we were not expecting an Interrupt but we got one)

TotalDmaInterrupts Returns the total number of interrupts received from the board for performing DMA

TotalFatSramBlocks Returns the number of times the system received a "CHAINED" data block (i.e., the data blocks are linked together)

TotalIrpsCancelled Returns the total number of canceled requests in any queue

TotalMsgInQ Returns the number of requests in the Message In Queue, which are awaiting a reply from the board

TotalMsgInQDone Returns the number of requests completed from the Message In Queue (i.e., requests completed and sent to the application)

TotalMsgInSram Returns the total number of messages read from the SRAM

TotalMsgOutQDone Returns the number of requests completed from the Message Out Queue (these requests are sent to the board and then moved to the Message In Queue, if expecting a reply, or completed and sent to the application)

TotalMsgOutSram Returns the total number of messages written to the SRAM

TotalMsgOverruns Returns the number of Overruns for the Orphan Message Queue (i.e. we had an Orphan Message but there was no space in the Orphan Message Queue)

TotalMsgTimeouts Returns the total number of requests timed out while waiting to be written to the SRAM or awaiting a reply from the SRAM (i.e. either in the Message In Q, Message Out Q or the Async Message Q)

TotalOrphanMsgsv Returns the total number of Orphan Messages (i.e., Messages which were read from the SRAM but do not have any pending requests from the application)

TotalOrphanMsgMatches Returns the total number of messages matched in the Orphan Message Queue

TotalOrphanMsgVolume Returns the size (in bytes) of the messages present in the Orphan message queue at any given time

TotalOrphanStrms Returns the total number of Orphan Streams in the Orphan Stream Table (i.e., data which was read from the SRAM but did not have any pending Read requests from the application)

TotalOrphanStrmMatches Returns the total number of Streams matched in the Orphan Stream table

TotalOrphanStrmVolume Returns the size (in bytes) of the data present in the Orphan Stream table at any given time

TotalSramDataFull Returns a count of the number of times the HOST tried to write a stream (data) to the SRAM but the SRAM was full

TotalSramGrantInterrupts Returns the number of "HOST SRAM PENDING" interrupts

TotalSramGrantLost Not used

TotalSramInterrupts Returns the total number of "NORMAL" interrupts received from the board (i.e. there is something to read from the SRAM)

TotalSramMsgFull Returns a count of the number of times the HOST tried to write a message to the SRAM but the SRAM was full

TotalStrmInQ Returns the number of Read requests pending in the Stream In Queue

TotalStrmInQDone Returns the number of Read requests completed from the Stream In Queue (i.e., Read Requests completed and sent to the application)

TotalStrmInSram Returns the number of data packets read from the SRAM

TotalStrmOutQ Returns the number of Writes performed by the user on that particular board. It is also incremented whenever the application sends an End Of Stream command.

TotalStrmOutQDone Returns the number of Write requests completed from the Stream Out Queue (i.e., Write Requests completed and sent to the application)

TotalStrmOutSram Returns the number of data packets written to the SRAM

TotalStrmOverruns Returns the number of Overruns for the Orphan Stream Table (i.e. we had an Orphan Stream but we had exceeded the maximum amount of memory allocated for the Orphan Stream Table or we could not allocate memory.

TotalStrmTimeouts Returns the total number of Read or Write Requests timed out (from the Stream In Queue or the Stream Out Queue)

TotalUnknownInterrupts Returns the total number of unknown interrupts received from the board

Parameter	Description
/f <file>	Log file name (default is mercmon.log)
/t<n>	Display Timer. The time interval (in milliseconds) between each screen refresh (default is 1000).
/l<n>	Logging Interval. The time interval (in seconds) between each log file update (default is 600).
/w	Enable/disable logging to a file (default is enabled)
/?	Displays the program help screen (optional)

**Table 5. Class Driver Counters**
Class Driver Counter	Description
CompleteReads	Returns the size (in Bytes) of all the Read requests completed by the Protocol Driver (i.e. the actual size in KB of all the data read from the board)
CompleteSends	Returns the size (in Bytes) of all the Messages sent to or received from the board
CompleteWrites	Returns the size (in Bytes) of all the Write requests completed by the Protocol Driver (i.e. the actual size in KB of all the data written to the board)
FailMpathFind	Returns the number of times a request to get a Message Handle (Mpath) failed (global counter)
FailStrmFind	Returns the number of times a request to get a Stream Handle failed (global counter)
NumCanTakes	Returns the number of "Can Takes" received for that board
NumReads	Returns the total number of Read requests sent down to the Protocol Driver
NumSends	Returns the total number of Messages sent down to the Protocol Driver
NumWrites	Returns the total number of Write requests sent down to the Protocol Driver.
NumWriteSplit	Returns the number of write requests, which were split for that board
NumOpenedStreams	Returns the number of Open Streams on that board at any given time
NumCloseStreamErr	Returns the number of Stream close requests failed on that particular board
NumOpenStreamErr	Returns the number of Stream open requests failed on that particular board
NumStreamClose	Returns the number of Stream close requests on that particular board
NumStreamOpen	Returns the number of Stream open requests on that particular board
SizeReads	Returns the size (in Bytes) of all the Read requests posted down to the Protocol Driver
SizeSends	Returns the size (in Bytes) of all the messages sent down to the Protocol Driver
SizeWrites	Returns the size (in Bytes) of all the Write requests sent down to the Protocol Driver
TimeoutReads	Returns the number of Read requests that timed out
TimeoutSends	Returns the number of Messages that timed out while waiting to be sent to the board or awaiting a reply from the board
TimeoutWrites	Returns the number of Write requests that timed out

**Table 6. Protocol Driver Counters**
Protocol Driver Counter	Description
MsgsInPerSramSession	Returns the number of messages read from the SRAM in one session
MsgsOutPerSramSession	Returns the number of messages written to the SRAM in one session
NoInDataDPCisr	Returns the number of times when we received an interrupt but there was no data transfer between the SRAM and the HOST
StrmsOutPerSramSession	Returns the number of streams written to the SRAM in one session (i.e., number of data blocks written)
StrmsInPerSramSession	Returns the number of streams read from the SRAM in one session (i.e., number of data blocks read)
TotalAsyncMsgQDone	Returns the number of requests completed in the AsyncMsgQ
TotalBadSramAddr	Returns the number of times we tried reading a message/data (Streams) from the SRAM but the SRAM address was wrong
TotalBadSramAddrAlloc	Returns the number of times the system tried to allocate a data block but the address was wrong
TotalBadSramAddrRelease	Returns the number of times the system tried to release a data block but the address was wrong
TotalBadSramDataCount	Returns the total number of times we got a data block of size greater then the SRAM_DATA_BLOCK_SIZE
TotalBadSramOffset	Returns the number of times we tried reading data (Streams) from the SRAM but the offset calculation was incorrect
TotalBadSramOffsetAlloc	Returns the number of times when we allocated a data block but offset was incorrect
TotalBigMessagesRcvd	Returns the number of times we read a "BIG" message from the SRAM (i.e. message size greater then 24 bytes)
TotalBigMessagesSent	Returns the number of times we wrote a "BIG" message to the SRAM (i.e. message size greater then 24 bytes)
TotalBogusInterrupts	Not used
TotalDpcOverruns	Returns the total number of DPC overruns (i.e. we were not expecting an Interrupt but we got one)
TotalDmaInterrupts	Returns the total number of interrupts received from the board for performing DMA
TotalFatSramBlocks	Returns the number of times the system received a "CHAINED" data block (i.e., the data blocks are linked together)
TotalIrpsCancelled	Returns the total number of canceled requests in any queue
TotalMsgInQ	Returns the number of requests in the Message In Queue, which are awaiting a reply from the board
TotalMsgInQDone	Returns the number of requests completed from the Message In Queue (i.e., requests completed and sent to the application)
TotalMsgInSram	Returns the total number of messages read from the SRAM
TotalMsgOutQDone	Returns the number of requests completed from the Message Out Queue (these requests are sent to the board and then moved to the Message In Queue, if expecting a reply, or completed and sent to the application)
TotalMsgOutSram	Returns the total number of messages written to the SRAM
TotalMsgOverruns	Returns the number of Overruns for the Orphan Message Queue (i.e. we had an Orphan Message but there was no space in the Orphan Message Queue)
TotalMsgTimeouts	Returns the total number of requests timed out while waiting to be written to the SRAM or awaiting a reply from the SRAM (i.e. either in the Message In Q, Message Out Q or the Async Message Q)
TotalOrphanMsgsv	Returns the total number of Orphan Messages (i.e., Messages which were read from the SRAM but do not have any pending requests from the application)
TotalOrphanMsgMatches	Returns the total number of messages matched in the Orphan Message Queue
TotalOrphanMsgVolume	Returns the size (in bytes) of the messages present in the Orphan message queue at any given time
TotalOrphanStrms	Returns the total number of Orphan Streams in the Orphan Stream Table (i.e., data which was read from the SRAM but did not have any pending Read requests from the application)
TotalOrphanStrmMatches	Returns the total number of Streams matched in the Orphan Stream table
TotalOrphanStrmVolume	Returns the size (in bytes) of the data present in the Orphan Stream table at any given time
TotalSramDataFull	Returns a count of the number of times the HOST tried to write a stream (data) to the SRAM but the SRAM was full
TotalSramGrantInterrupts	Returns the number of "HOST SRAM PENDING" interrupts
TotalSramGrantLost	Not used
TotalSramInterrupts	Returns the total number of "NORMAL" interrupts received from the board (i.e. there is something to read from the SRAM)
TotalSramMsgFull	Returns a count of the number of times the HOST tried to write a message to the SRAM but the SRAM was full
TotalStrmInQ	Returns the number of Read requests pending in the Stream In Queue
TotalStrmInQDone	Returns the number of Read requests completed from the Stream In Queue (i.e., Read Requests completed and sent to the application)
TotalStrmInSram	Returns the number of data packets read from the SRAM
TotalStrmOutQ	Returns the number of Writes performed by the user on that particular board. It is also incremented whenever the application sends an End Of Stream command.
TotalStrmOutQDone	Returns the number of Write requests completed from the Stream Out Queue (i.e., Write Requests completed and sent to the application)
TotalStrmOutSram	Returns the number of data packets written to the SRAM
TotalStrmOverruns	Returns the number of Overruns for the Orphan Stream Table (i.e. we had an Orphan Stream but we had exceeded the maximum amount of memory allocated for the Orphan Stream Table or we could not allocate memory.
TotalStrmTimeouts	Returns the total number of Read or Write Requests timed out (from the Stream In Queue or the Stream Out Queue)
TotalUnknownInterrupts	Returns the total number of unknown interrupts received from the board

Click here to contact Dialogic Customer Engineering