0001 TPADMSV(8)
0002 ==========
0003 :doctype: manpage
0004
0005
0006 NAME
0007 ----
0008 tpadmsv - Enduro/X administrative server.
0009
0010
0011 SYNOPSIS
0012 --------
0013 *tpadmsv* ['OPTIONS']
0014
0015
0016 DESCRIPTION
0017 -----------
0018 This is XATMI server which provides *tm_mib(5)* interface backend. On request,
0019 server process collects various system information, prepares the cursor (stored
0020 in memory) and provides the response back to caller. Currently only *GET* and
0021 *GETNEXT* operations are supported. The server process is optional for Enduro/X
0022 and is used only to provide a solid framework for gathering system information.
0023 *tpadmsv* collects information from following system parts:
0024
0025 - *ndrxd(5)* requests the information about processes (such as xadmin ppm), services
0026 (such as xadmin psc).
0027
0028 - *open queues* - reads the list of IPC queues to extract the service information.
0029
0030 - *shared memory* - to extract the information about services, client processes
0031 (such as *cpmsrv(5)*)
0032
0033 Every instance of *tmadmsv* will advertise following list of services:
0034
0035 1. .TMIB - command load balanced service for informational services. This is not
0036 exported over the *tpbridge(8)*.
0037
0038 2. .TMIB-<NODE ID> - used for initiating the requests over the *tpbridge(8)*.
0039
0040 2. .TMIB-<NODE ID>-<SERVER ID> - particular instance for fetching the next window
0041 of cursor data.
0042
0043 Each cursor returned from the *tmadmsv* encodes the the exact instance service
0044 number i.e. service 2. Thus when fetching the next portion of data, normally
0045 *.TMIB* service is called. If instance receive the cursor from other instance,
0046 the message is forwarded to exact service name.
0047
0048
0049 OPTIONS
0050 -------
0051 [*-n* 'MAX_CURSORS']::
0052 This is max number of cursors allowed for process to create. If number of open
0053 cursors is greater than this number, the *TAELIMIT* error is returned. The default
0054 value is *100*.
0055
0056 [*-b* 'REPLY_BUFFER_SIZE']::
0057 This is buffer size in bytes in which reply data window is loaded. When data is
0058 being loaded into reply buffer, cursor fetching algorithm ensures that before
0059 loading object into buffer, the buffer free size is object size multiplied
0060 by 2 plus 1152 bytes. Default value is *4096* bytes.
0061
0062 [*-v* 'CURSOR_VALIDITY']::
0063 Number of seconds to keep un-fetched cursors in memory. After this time the
0064 cursor is zapped. Un-fetched cursors usually appears due to user program error
0065 where fetch is not done till the end. The default value is *30* seconds.
0066
0067 [*-s* 'SCAN_TIME']::
0068 Un-fetched cursor sanity scan time. Interval into which tests are made for
0069 the cursors. The default value is *15* seconds.
0070
0071 EXIT STATUS
0072 -----------
0073 *0*::
0074 Success
0075
0076 *1*::
0077 Failure
0078
0079 BUGS
0080 ----
0081 Report bugs to support@mavimax.com
0082
0083 SEE ALSO
0084 --------
0085 *ndrxconfig.xml(5)* *tm_mib(5)* *xadmin(8)* *cpmsrv(8)* *ndrxd(8)*
0086
0087 COPYING
0088 -------
0089 (C) Mavimax, Ltd
0090
