JANUS TSTAT or TSTATUS: Difference between revisions

From m204wiki
Jump to navigation Jump to search
 
m (add italics)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:JANUS TSTAT or TSTATUS}}
{{DISPLAYTITLE:JANUS TSTAT or TSTATUS}}
<span class="pageSubtitle"><section begin="desc" />Display Janus thread usage activity<section end="desc" /></span>
<span class="pageSubtitle">Display Janus thread usage activity</span>


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 ([[JANUS LIMITS]]) provides information about system-wide thread availability.
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 <var>[[JANUS LIMITS]]</var> command provides information about system-wide thread availability.


==Syntax==
==Syntax==
<p class="syntax"><section begin="syntax" /> JANUS TSTATUS portname
<p class="syntax">JANUS TSTATUS <span class="term">portname</span>
<section end="syntax" /></p>
 
 
Where '''portname''' is the name of the port(s) to display. '''portname''' defaults to <code>*</code> (asterisk) to display the thread activity on all ports.
 
<p class="code"> JANUS TSTATUS *
</p>
</p>


In the above example, the thread activity on all defined ports is shown.  
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.


JANUS TSTATUS provides the following information:
==Usage notes==
<var>JANUS TSTATUS</var> provides the following information:


<table class="syntaxTable">
<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 ''[[Janus Web Server]]'') and those using $WEB_FORM_DONE. Persistent sessions do not count against a port's maximum connection limit but '''do''' count against the site's overall maximum connection limit and they do occupy sdaemon threads.</td></tr>
<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 then a port is probably getting significant benefits from the use of the [[KEEPALIVE (JANUS DEFINE parameter)|KEEPALIVE parameter]].</td>  
<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>


<p class="code"> Name          Port  Type    Stat  Activ  Free Perst InUse    TConn    TReuse
==Example==
IFDIAL        2999 IFDIAL  Start    0    5    0    0        0        0
This command displays the thread activity on all defined ports; sample output follows:
DEBUGGER      6999 DEBUGSRV Start    0    10    0    0        0        0
<p class="code">JANUS TSTATUS *
DEBUGCLIENT      * DEBUGCLT Start    0    10    0    0        0        0
</p>
JANWEB          80 WEBSERV  Start    0    50    0    0    16348      2378
 
JANWEBS        443 WEBSERV  Start    0    50    0    0      2315      184
<p class="code"> Name          Port  Type    Stat  Activ  Free Perst InUse    TConn    TReuse
EMAILC            * CLSOCK  Start    0    5    0    0        0        0
IFDIAL        2999 IFDIAL  Start    0    5    0    0        0        0
NEXTEL            * CLSOCK  Start    0    5    0    0        0        0
DEBUGGER      6999 DEBUGSRV Start    0    10    0    0        0        0
SOAP              * CLSOCK  Start    0    5    0    0      106        0
DEBUGCLIENT      * DEBUGCLT Start    0    10    0    0        0        0
FLASHMON      8881 SRVSOCK  Start    0    10    0    0        0        0
JANWEB          80 WEBSERV  Start    0    50    0    0    16348      2378
FTP            2121 FTPSERV  Start    0    10    0    0        0        0
JANWEBS        443 WEBSERV  Start    0    50    0    0      2315      184
UKWEB            80 WEBSERV  Start    0    10    0    0        0        0
EMAILC            * CLSOCK  Start    0    5    0    0        0        0
UKWEBS          443 WEBSERV  Stop      0    0    0    0        0        0
NEXTEL            * CLSOCK  Start    0    5    0    0        0        0
UKLDAP            * CLSOCK  Start    0    5    0    0        0        0
SOAP              * CLSOCK  Start    0    5    0    0      106        0
CLUBWEB          80 WEBSERV  Stop      0    0    0    0      3899        0
FLASHMON      8881 SRVSOCK  Start    0    10    0    0        0        0
CLUBWEBS        443 WEBSERV  Stop      0    0    0    0        0        0
FTP            2121 FTPSERV  Start    0    10    0    0        0        0
MKIWEB          80 WEBSERV  Start    0    10    0    0        0        0
UKWEB            80 WEBSERV  Start    0    10    0    0        0        0
MKIWB2          81 WEBSERV  Stop      0    0    0    0        0        0
UKWEBS          443 WEBSERV  Stop      0    0    0    0        0        0
MKIWEBS        443 WEBSERV  Stop      0    0    0    0        0        0
UKLDAP            * CLSOCK  Start    0    5    0    0        0        0
CYO              80 WEBSERV  Stop      0    0    0    0        0        0
CLUBWEB          80 WEBSERV  Stop      0    0    0    0      3899        0
JAL              80 WEBSERV  Start    0    10    0    0      1926        0
CLUBWEBS        443 WEBSERV  Stop      0    0    0    0        0        0
MEGWEB          80 WEBSERV  Start    0    10    0    0        0        0
MKIWEB          80 WEBSERV  Start    0    10    0    0        0        0
YODAWEB          80 WEBSERV  Start    0    10    0    0      1212        0
MKIWB2          81 WEBSERV  Stop      0    0    0    0        0        0
VIETNAM          80 WEBSERV  Start    0    10    0    0      1716        0
MKIWEBS        443 WEBSERV  Stop      0    0    0    0        0        0
HOCKEY          80 WEBSERV  Start    0    25    0    0      6748        0
CYO              80 WEBSERV  Stop      0    0    0    0        0        0
HOCKEYS        443 WEBSERV  Start    0    25    0    0      1997        0
JAL              80 WEBSERV  Start    0    10    0    0      1926        0
XTEND          7878 WEBSERV  Start    0    10    0    0        0        0
MEGWEB          80 WEBSERV  Start    0    10    0    0        0        0
XTENDS        7879 WEBSERV  Start    0    10    0    0        0        0
YODAWEB          80 WEBSERV  Start    0    10    0    0      1212        0
TNSERV        3270 TNSERV  Start    0    20    0    0        1        0
VIETNAM          80 WEBSERV  Start    0    10    0    0      1716        0
AGENTS        20002 OPENSERV Start    0    5    0    0        0        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
</p>
</p>
<p class="caption">JANUS TSTAT output</p>


==References==
==See also==
<ul>
<li>[[List of Janus commands]]
</ul>


See [[List of Janus commands]]
[[Category:Janus commands|JANUS TSTAT or TSTATUS]]
[[Category:Janus commands|JANUS TSTAT or TSTATUS]]

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

See also

Retrieved from "https://m204wiki.rocketsoftware.com/index.php?title=JANUS_TSTAT_or_TSTATUS&oldid=104609"