JANUS TSTAT or TSTATUS: Difference between revisions
m (→Usage notes: change table class) |
m (add italics) |
||
Line 5: | Line 5: | ||
==Syntax== | ==Syntax== | ||
<p class="syntax">JANUS TSTATUS portname | <p class="syntax">JANUS TSTATUS <span class="term">portname</span> | ||
</p> | </p> | ||
Where | Where <var class="term">portname</var> is the name of the port(s) to display. <var class="term">portname</var> defaults to <tt>*</tt> (asterisk) to display the thread activity on all ports. | ||
==Usage notes== | ==Usage notes== | ||
JANUS TSTATUS provides the following information: | <var>JANUS TSTATUS</var> provides the following information: | ||
<table class="thJustBold"> | <table class="thJustBold"> | ||
<tr><th>Name</th> | <tr><th>Name</th> | ||
<td>Name defined to the TCP/IP port.</td></tr> | <td>Name defined to the TCP/IP port.</td></tr> | ||
<tr><th>Port</th> | <tr><th>Port</th> | ||
<td>TCP/IP port number.</td></tr> | <td>TCP/IP port number.</td></tr> | ||
<tr><th>Type</th> | <tr><th>Type</th> | ||
<td>IFDIAL, SDS, OAS, OMNI, OPENSERV, WEBSERV, CLSOCK, <var>DEBUGGERCLIENT</var>, or SRVSOCK.</td></tr> | <td>IFDIAL, SDS, OAS, OMNI, OPENSERV, WEBSERV, CLSOCK, <var>DEBUGGERCLIENT</var>, or SRVSOCK.</td></tr> | ||
<tr><th>Stat</th> | <tr><th>Stat</th> | ||
<td>Status of the connection (started, stopped, forcing, or draining).</td></tr> | <td>Status of the connection (started, stopped, forcing, or draining).</td></tr> | ||
<tr><th>Activ</th> | <tr><th>Activ</th> | ||
<td>The current number of active connections for the port. An active connection is one that is "open" from TCP/IP's perspective and reduces by one the available open threads on the port and is counted against the site's licensed connection limit.</td></tr> | <td>The current number of active connections for the port. An active connection is one that is "open" from TCP/IP's perspective and reduces by one the available open threads on the port and is counted against the site's licensed connection limit.</td></tr> | ||
<tr><th>Free</th> | <tr><th>Free</th> | ||
<td>The current number of available connections for the port. This is simply the port's connection limit (as specified on the JANUS DEFINE command) minus the number of active connections (<code>Activ</code>). The value of Free is an absolute limit of the number of additional connections on a port. Other limits such as the system-wide connection limit or the number of available sdaemon threads might prevent this limit from being attained.</td></tr> | <td>The current number of available connections for the port. This is simply the port's connection limit (as specified on the <var>JANUS DEFINE</var> command) minus the number of active connections (<code>Activ</code>). The value of Free is an absolute limit of the number of additional connections on a port. Other limits such as the system-wide connection limit or the number of available sdaemon threads might prevent this limit from being attained.</td></tr> | ||
<tr><th>Perst</th> | <tr><th>Perst</th> | ||
<td>The number of "persistent" sessions currently active for the port. Persistent sessions include Janus Web Legacy sessions (3270 screens automatically converted to HTML by | <td>The number of "persistent" sessions currently active for the port. Persistent sessions include Janus Web Legacy sessions (3270 screens automatically converted to HTML by [[Janus Web Server]]) and those using <var>$Web_Form_Done</var>. Persistent sessions do not count against a port's maximum connection limit, but they '''do''' count against the site's overall maximum connection limit, and they do occupy sdaemon threads.</td></tr> | ||
<tr><th>InUse</th> | <tr><th>InUse</th> | ||
<td>The sum of <code>Activ</code> and <code>Perst</code>. This indicates the number of connections for the port that are counted against the site's overall connection limit.</td></tr> | <td>The sum of <code>Activ</code> and <code>Perst</code>. This indicates the number of connections for the port that are counted against the site's overall connection limit.</td></tr> | ||
<tr><th>TConn</th> | <tr><th>TConn</th> | ||
<td>The total number of separate connections made to the port. For WEBSERV ports this value is sometimes referred to as "hits." | <td>The total number of separate connections made to the port. For <var>WEBSERV</var> ports this value is sometimes referred to as "hits." </td></tr> | ||
</td> | |||
<tr><th>Treuse</th> | <tr><th>Treuse</th> | ||
<td>On WEBSERV and CLSOCK ports using [http://en.wikipedia.org/wiki/HTTP_persistent_connection HTTP keep-alives] this is the number of web requests that were handled on a TCP connection that was "kept alive" for the [[KEEPALIVE (JANUS DEFINE parameter)|KEEPALIVE time]]. On a WEBSERV port using HTTP keep-alives, the number of web hits is actually TConn plus Treuse. The ratio of Treuse to TConn is an indicator of the efficacy of the KEEPALIVE parameter. If Treuse is significantly greater than TConn | <td>On <var>WEBSERV</var> and <var>CLSOCK</var> ports using [http://en.wikipedia.org/wiki/HTTP_persistent_connection HTTP keep-alives], this is the number of web requests that were handled on a TCP connection that was "kept alive" for the [[KEEPALIVE (JANUS DEFINE parameter)|KEEPALIVE time]]. On a <var>WEBSERV</var> port using HTTP keep-alives, the number of web hits is actually TConn plus Treuse. The ratio of Treuse to TConn is an indicator of the efficacy of the <var>KEEPALIVE</var> parameter. If Treuse is significantly greater than TConn, a port is probably getting significant benefits from the use of the [[KEEPALIVE (JANUS DEFINE parameter)|KEEPALIVE parameter]].</td></tr> | ||
</tr> | |||
</table> | </table> | ||
Latest revision as of 22:03, 27 November 2017
Display Janus thread usage activity
This provides information about thread usage activity on Janus ports that can prove useful in isolating problems with thread availability and in doing capacity planning. The JANUS LIMITS command provides information about system-wide thread availability.
Syntax
JANUS TSTATUS portname
Where portname is the name of the port(s) to display. portname defaults to * (asterisk) to display the thread activity on all ports.
Usage notes
JANUS TSTATUS provides the following information:
Name | Name defined to the TCP/IP port. |
---|---|
Port | TCP/IP port number. |
Type | IFDIAL, SDS, OAS, OMNI, OPENSERV, WEBSERV, CLSOCK, DEBUGGERCLIENT, or SRVSOCK. |
Stat | Status of the connection (started, stopped, forcing, or draining). |
Activ | The current number of active connections for the port. An active connection is one that is "open" from TCP/IP's perspective and reduces by one the available open threads on the port and is counted against the site's licensed connection limit. |
Free | The current number of available connections for the port. This is simply the port's connection limit (as specified on the JANUS DEFINE command) minus the number of active connections (Activ ). The value of Free is an absolute limit of the number of additional connections on a port. Other limits such as the system-wide connection limit or the number of available sdaemon threads might prevent this limit from being attained. |
Perst | The number of "persistent" sessions currently active for the port. Persistent sessions include Janus Web Legacy sessions (3270 screens automatically converted to HTML by Janus Web Server) and those using $Web_Form_Done. Persistent sessions do not count against a port's maximum connection limit, but they do count against the site's overall maximum connection limit, and they do occupy sdaemon threads. |
InUse | The sum of Activ and Perst . This indicates the number of connections for the port that are counted against the site's overall connection limit. |
TConn | The total number of separate connections made to the port. For WEBSERV ports this value is sometimes referred to as "hits." |
Treuse | On WEBSERV and CLSOCK ports using HTTP keep-alives, this is the number of web requests that were handled on a TCP connection that was "kept alive" for the KEEPALIVE time. On a WEBSERV port using HTTP keep-alives, the number of web hits is actually TConn plus Treuse. The ratio of Treuse to TConn is an indicator of the efficacy of the KEEPALIVE parameter. If Treuse is significantly greater than TConn, a port is probably getting significant benefits from the use of the KEEPALIVE parameter. |
Example
This command displays the thread activity on all defined ports; sample output follows:
JANUS TSTATUS *
Name Port Type Stat Activ Free Perst InUse TConn TReuse IFDIAL 2999 IFDIAL Start 0 5 0 0 0 0 DEBUGGER 6999 DEBUGSRV Start 0 10 0 0 0 0 DEBUGCLIENT * DEBUGCLT Start 0 10 0 0 0 0 JANWEB 80 WEBSERV Start 0 50 0 0 16348 2378 JANWEBS 443 WEBSERV Start 0 50 0 0 2315 184 EMAILC * CLSOCK Start 0 5 0 0 0 0 NEXTEL * CLSOCK Start 0 5 0 0 0 0 SOAP * CLSOCK Start 0 5 0 0 106 0 FLASHMON 8881 SRVSOCK Start 0 10 0 0 0 0 FTP 2121 FTPSERV Start 0 10 0 0 0 0 UKWEB 80 WEBSERV Start 0 10 0 0 0 0 UKWEBS 443 WEBSERV Stop 0 0 0 0 0 0 UKLDAP * CLSOCK Start 0 5 0 0 0 0 CLUBWEB 80 WEBSERV Stop 0 0 0 0 3899 0 CLUBWEBS 443 WEBSERV Stop 0 0 0 0 0 0 MKIWEB 80 WEBSERV Start 0 10 0 0 0 0 MKIWB2 81 WEBSERV Stop 0 0 0 0 0 0 MKIWEBS 443 WEBSERV Stop 0 0 0 0 0 0 CYO 80 WEBSERV Stop 0 0 0 0 0 0 JAL 80 WEBSERV Start 0 10 0 0 1926 0 MEGWEB 80 WEBSERV Start 0 10 0 0 0 0 YODAWEB 80 WEBSERV Start 0 10 0 0 1212 0 VIETNAM 80 WEBSERV Start 0 10 0 0 1716 0 HOCKEY 80 WEBSERV Start 0 25 0 0 6748 0 HOCKEYS 443 WEBSERV Start 0 25 0 0 1997 0 XTEND 7878 WEBSERV Start 0 10 0 0 0 0 XTENDS 7879 WEBSERV Start 0 10 0 0 0 0 TNSERV 3270 TNSERV Start 0 20 0 0 1 0 AGENTS 20002 OPENSERV Start 0 5 0 0 0 0