LOGCLOSET (JANUS DEFINE parameter): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
(Automatically generated page update)
 
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:LOGCLOSET}}
<span class="pageSubtitle">LOGCLOSET minutes &mdash; frequency of log 'closes'</span>
<span class="pageSubtitle"><section begin="desc" />minutes<section end="desc" /></span>


LOGCLOSET 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>LOGCLOSET</var> is a parameter on <var>[[JANUS DEFINE]]</var>, which defines and sets characteristics of a Janus port.  


This parameter indicates how often the <var class="product">[[Janus Web Server]]</var> log dataset is to be "closed", that is how often the DSCB is to be updated for the log dataset.


<var>LOGCLOSET</var> is followed by the number of minutes between TYPE=T closes (DSCB updates) performed for the web log dataset.


This parameter indicates how often the ''[[Janus Web Server]]'' log dataset is to be "closed", that is how often the DSCB is to be updated for the log dataset.
There are two main reasons to set <var>LOGCLOSET</var>:


LOGCLOSET is followed by the number of minutes between TYPE=T closes (DSCB updates) performed for the web log dataset.
There are two main reasons to set LOGCLOSET:
<ol>
<ol>
 
<li>If TYPE=T closes are not done for the log dataset, the log data for the current run cannot be seen by most MVS utilities (and some CMS utilities) until the port is stopped.</li>
<li>If TYPE=T closes are not done for the log dataset, the log data for the current run cannot be seen by most MVS utilities (and some CMS utilities) until the port is stopped.  
<li>If the Online should come down with a hard crash (say from a power outage or job cancellation) all the web log data from that run will be lost. If <var>LOGCLOSET</var> is set and a hard crash occurs, only the data logged after the last TYPE=T close would be lost.</li>
<li>If the Online should come down with a hard crash (say from a power outage or job cancellation) all the web log data from that run will be lost. If LOGCLOSET is set and a hard crash occurs, only the data logged after the last TYPE=T close would be lost.
</ol>
</ol>


If <var>LOGCLOSET</var> is not set for a port, no TYPE=T closes will be performed for the port.


If LOGCLOSET is not set for a port, no TYPE=T closes will be performed for the port.
Setting <var>LOGCLOSET</var> too low will cause lots of small blocks to be written to the log dataset, and it can cause a lot of DSCB activity, which is not very desirable (though no TYPE=T close will be performed if there were no requests since the last TYPE=T close). Setting <var>LOGCLOSET</var> too high could allow the loss of a lot of web log data. A reasonable setting for <var>LOGCLOSET</var> might be 60, which would risk the loss of up to an hour of web log data in the odd case of a hard Online crash, but it would ensure that no more than one DSCB update will be performed per hour for the log dataset.  
 
Setting LOGCLOSET too low will cause lots of small blocks to be written to the log dataset, and it can cause a lot of DSCB activity, which is not very desirable (though no TYPE=T close will be performed if there were no requests since the last TYPE=T close). Setting LOGCLOSET too high could allow the loss of a lot of web log data. A reasonable setting for LOGCLOSET might be 60, which would risk the loss of up to an hour of web log data in the odd case of a hard Online crash, but it would ensure that no more than one DSCB update will be performed per hour for the log dataset.
 
Valid only for WEBSERV ports.


==References==
Valid only for <var>[[JANUS DEFINE#type|WEBSERV]]</var> ports.


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


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

Latest revision as of 22:18, 16 April 2013

LOGCLOSET minutes — frequency of log 'closes'

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

This parameter indicates how often the Janus Web Server log dataset is to be "closed", that is how often the DSCB is to be updated for the log dataset.

LOGCLOSET is followed by the number of minutes between TYPE=T closes (DSCB updates) performed for the web log dataset.

There are two main reasons to set LOGCLOSET:

  1. If TYPE=T closes are not done for the log dataset, the log data for the current run cannot be seen by most MVS utilities (and some CMS utilities) until the port is stopped.
  2. If the Online should come down with a hard crash (say from a power outage or job cancellation) all the web log data from that run will be lost. If LOGCLOSET is set and a hard crash occurs, only the data logged after the last TYPE=T close would be lost.

If LOGCLOSET is not set for a port, no TYPE=T closes will be performed for the port.

Setting LOGCLOSET too low will cause lots of small blocks to be written to the log dataset, and it can cause a lot of DSCB activity, which is not very desirable (though no TYPE=T close will be performed if there were no requests since the last TYPE=T close). Setting LOGCLOSET too high could allow the loss of a lot of web log data. A reasonable setting for LOGCLOSET might be 60, which would risk the loss of up to an hour of web log data in the odd case of a hard Online crash, but it would ensure that no more than one DSCB update will be performed per hour for the log dataset.

Valid only for WEBSERV ports.

See also