print_in_use_mtxbufs

The print_in_use_mtxbufs script provides information about the in-use memory buffers on a server. It mainly provides details about what is inside the MtxBuf buffers that are in-use.

Note: This script is a debugging tool to use when a MATRIXX Data Container (MDC) or message is "stuck." If you run it on a live system that is active, the data is likely modified by the time it is printed and is not useful.

Syntax

print_in_use_mtxbufs -d [ -f mtx_config.xml | -i instanceId | -p poolId ]

Options

The print_in_use_mtxbufs.py script has the following required options, in addition to the general engine options:
-d, --details
Print details about the memory buffers in use.
-f, --config-file mtx_config.xml
The full path of the mtx_config.xml file used by the engine. The default is ${MTX_CONF_DIR}/mtx_config.xml
-i, --instance-id instance-id
The instance of the MATRIXX service for which to examine the memory buffer. The default is 1.
-p, --pool-id poolId
The mtxbuf pool to examine. By default, the value is 6, which is the large mtxbuf pool. The other pool ID is 9, which is the huge mtxbuf pool.

For more information about the MATRIXX environment variables, see the discussion about container directories and environment variables in MATRIXX Installation and Upgrade.

Print Details For All In-Use Memory Buffers

print_in_use_mtxbufs -d
For buffer Pool ID 6, the open mtxbufs are as follows (16 found):

MtxBuf allocated: ID 6:-:1:674, (loc=transaction server, lineNum=114), BufType=1
MtxBuf allocated: ID 6:-:1:687, (loc=transaction server, lineNum=128), BufType=0
MtxBuf allocated: ID 6:-:1:1377, (loc=charging server, lineNum=128), BufType=0
MtxBuf allocated: ID 6:-:1:2070, (loc=MDC gateway, lineNum=48), BufType=0
MtxBuf allocated: ID 6:-:1:2075, (loc=MDC gateway, lineNum=128), BufType=0
MtxBuf allocated: ID 6:-:1:2778, (loc=diameter gateway, lineNum=48), BufType=0
MtxBuf allocated: ID 6:-:1:2779, (loc=diameter gateway, lineNum=48), BufType=0
MtxBuf allocated: ID 6:-:1:2780, (loc=diameter gateway, lineNum=48), BufType=0
MtxBuf allocated: ID 6:-:1:2781, (loc=diameter gateway, lineNum=48), BufType=0
MtxBuf allocated: ID 6:-:1:2797, (loc=diameter gateway, lineNum=128), BufType=0
MtxBuf allocated: ID 6:-:1:3509, (loc=task mgr, lineNum=53), BufType=0
MtxBuf allocated: ID 6:-:1:3510, (loc=task mgr, lineNum=53), BufType=0
MtxBuf allocated: ID 6:-:1:3511, (loc=task mgr, lineNum=53), BufType=0
MtxBuf allocated: ID 6:-:1:3520, (loc=task mgr, lineNum=128), BufType=0
MtxBuf allocated: ID 6:-:1:4262, (loc=snmp agent, lineNum=128), BufType=0
MtxBuf allocated: ID 6:-:1:5024, (loc=ha cluster, lineNum=128), BufType=0
In-Use Summary:

Location = charging server, Line Number = 128, # of elements in-use = 1
Location = transaction server, Line Number = 114, # of elements in-use = 1
Location = transaction server, Line Number = 128, # of elements in-use = 1
Location = MDC gateway, Line Number = 48, # of elements in-use = 1
Location = MDC gateway, Line Number = 128, # of elements in-use = 1
Location = diameter gateway, Line Number = 48, # of elements in-use = 4
Location = diameter gateway, Line Number = 128, # of elements in-use = 1
Location = snmp agent, Line Number = 128, # of elements in-use = 1
Location = ha cluster, Line Number = 128, # of elements in-use = 1
Location = task mgr, Line Number = 53, # of elements in-use = 3
Location = task mgr, Line Number = 128, # of elements in-use = 1