TCPLOG (JANUS DEFINE parameter): Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Created page with "{{DISPLAYTITLE:TCPLOG}} <span class="pageSubtitle"><section begin="desc" /><section end="desc" /></span> TCPLOG is a parameter on JANUS DEFINE, which defines and sets charac...")
 
m (remove displaytitle)
 
(17 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:TCPLOG}}
<span class="pageSubtitle">TCPLOG filename &mdash; Log TCP activity to flatfile</span>
<span class="pageSubtitle"><section begin="desc" /><section end="desc" /></span>


TCPLOG is a parameter on [[JANUS DEFINE]], which defines and sets characteristics of a Janus port. See the [[JANUS DEFINE#parmlist|List of JANUS DEFINE parameters]].
<var>TCPLOG</var> is a parameter on <var>[[JANUS DEFINE]]</var>, which defines and sets characteristics of a Janus port.  


A <var class="product">[[Janus Web Server]]</var> port definition parameter, <var>TCPLOG</var> tells <var class="product">Janus Web Server</var> to log in a sequential dataset all inbound and outbound TCP data transmitted for this port. The dataset name is specified as the value that follows the <code>TCPLOG</code> keyword.


The log file is opened and cleared when the associated Janus port is started, and it is closed when the port is stopped or if an error occurs writing data to the dataset.
The log data is written in variable length blocks. The first four bytes of a block contain the length of the block. Each block contains at least one record. No character translation or formatting is done for the actual TCP data. Since the blocks are standard variable length blocks, they all start with a Block Descriptor Word (BDW) which consists of a halfword block length followed by two bytes of zero.
The layout of the records in each block is described in detail below:
<table>
<tr class="head"><th>Offset</th><th>Length</th><th>Type</th><th>Description</th></tr>
<tr><td style="text-align:right">0</td><td style="text-align:right">2</td><td>Unsigned binary</td><td>RDW (Record descriptor word): the length of the current record</td></tr>
<tr><td style="text-align:right">2</td><td style="text-align:right">2</td><td>Unused</td><td>Unused</td></tr>


A new ''[[Janus Web Server]]'' port definition parameter, TCPLOG, tells ''[[Janus Web Server]]'' to log in a sequential dataset all inbound and outbound TCP data transmitted for this port. The dataset name is specified as the value that follows the <code>TCPLOG</code> keyword.
<tr><td style="text-align:right">4</td><td style="text-align:right">8</td><td>Unsigned binary</td><td>Unique TCP connection number</td></tr>


The log file is opened and cleared when the associated Janus port is started, and it is closed when the port is stopped or if an error occurs writing data to the dataset.
<tr><td style="text-align:right">12</td><td style="text-align:right">4</td><td>Unsigned binary</td><td>Record number</td></tr>
 
<tr><td style="text-align:right">16</td><td style="text-align:right">8</td><td>Unsigned binary</td><td>Time of day in clock units</td></tr>
 
<tr><td style="text-align:right">24</td><td style="text-align:right">4</td><td>Unsigned binary</td><td>Remote IP address</td></tr>
 
<tr><td style="text-align:right">28</td><td style="text-align:right">4</td><td>Unsigned binary</td><td>Local IP address</td></tr>


The log data is written in variable length blocks. The first four bytes of a block contain the length of the block. Each block contains at least one record. No character translation or formatting is done for the actual TCP data.
<tr><td style="text-align:right">32</td><td style="text-align:right">2</td><td>Unsigned binary</td><td>Remote port number</td></tr>


<tr><td style="text-align:right">34</td><td style="text-align:right">2</td><td>Unsigned binary</td><td>Local port number</td></tr>


The layout of a block and record is described in detail below:
<tr><td style="text-align:right">36</td><td style="text-align:right">1</td><td>EBCDIC character</td><td>Direction: S (Sent) or R (Received)</td></tr>
<p class="code"> Offset Length Type Description
------ ------ --------------- -----------------------------------
0-3 4 Unsigned binary BDW (Block descriptor word):
the length of the block
4-5 2 Unsigned binary RDW (Record descriptor word):
the length of the current record
6-7 2 Unused
8-15 8 Unsigned binary Unique TCP connection number
16-23 8 Unsigned binary Time of day in clock units
24-27 4 Unsigned binary Remote IP address
28-31 4 Unsigned binary Local IP address
32-33 2 Unsigned binary Remote port number
34-35 2 Unsigned binary Local port number
36-36 1 EBCDIC character Direction: S (Sent) or R (Received)
37-37 1 Unused
38-39 2 Unsigned binary Length of TCP data
39-n v Any TCP data
</p>


<tr><td style="text-align:right">37</td><td style="text-align:right">1</td><td>Unused</td><td>Unused</td></tr>


The TCPLOG dataset '''cannot''' be shared by multiple Janus ports.
<tr><td style="text-align:right">38</td><td style="text-align:right">2</td><td>Unsigned binary</td><td>Length of TCP data</td></tr>


The TCPLOG parameter is valid only for WEBSERV ports.  
<tr><td style="text-align:right">40</td><td style="text-align:right">v</td><td>Binary</td><td>Any TCP data</td></tr>
</table>
The <var>TCPLOG</var> dataset '''cannot''' be shared by multiple Janus ports.  


This parameter was introduced in ''[[Sirius Mods]]'' version 7.2.
The <var>TCPLOG</var> parameter is valid only for <var>[[JANUS DEFINE#type|WEBSERV]]</var> ports.  


==References==
==See also==
<ul>
<li>[[List of Janus commands]]
<li>[[JANUS DEFINE#parmlist|List of JANUS DEFINE parameters]]
</ul>


See: [[List of Janus commands]] | [[JANUS DEFINE#parmlist|List of JANUS DEFINE parameters]].


[[Category:JANUS DEFINE parameters|TCPLOG]]
[[Category:JANUS DEFINE parameters|TCPLOG]]

Latest revision as of 00:08, 8 June 2016

TCPLOG filename — Log TCP activity to flatfile

TCPLOG is a parameter on JANUS DEFINE, which defines and sets characteristics of a Janus port.

A Janus Web Server port definition parameter, TCPLOG tells Janus Web Server to log in a sequential dataset all inbound and outbound TCP data transmitted for this port. The dataset name is specified as the value that follows the TCPLOG keyword.

The log file is opened and cleared when the associated Janus port is started, and it is closed when the port is stopped or if an error occurs writing data to the dataset.

The log data is written in variable length blocks. The first four bytes of a block contain the length of the block. Each block contains at least one record. No character translation or formatting is done for the actual TCP data. Since the blocks are standard variable length blocks, they all start with a Block Descriptor Word (BDW) which consists of a halfword block length followed by two bytes of zero.

The layout of the records in each block is described in detail below:

OffsetLengthTypeDescription
02Unsigned binaryRDW (Record descriptor word): the length of the current record
22UnusedUnused
48Unsigned binaryUnique TCP connection number
124Unsigned binaryRecord number
168Unsigned binaryTime of day in clock units
244Unsigned binaryRemote IP address
284Unsigned binaryLocal IP address
322Unsigned binaryRemote port number
342Unsigned binaryLocal port number
361EBCDIC characterDirection: S (Sent) or R (Received)
371UnusedUnused
382Unsigned binaryLength of TCP data
40vBinaryAny TCP data

The TCPLOG dataset cannot be shared by multiple Janus ports.

The TCPLOG parameter is valid only for WEBSERV ports.

See also