ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzaie_5.4.0.1/rzaiemod_as_cache.htm

1029 lines
69 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="topic" />
<meta name="DC.Title" content="Module mod_as_cache" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2002,2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2002,2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzaiemod_as_cache" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>Module mod_as_cache</title>
</head>
<body id="rzaiemod_as_cache"><a name="rzaiemod_as_cache"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<!--Java sync-link--><h1 class="topictitle1">Module mod_as_cache</h1>
<div><div class="important"><span class="importanttitle">Important:</span> Information
for this topic supports the latest PTF levels for HTTP Server for i5/OS .
It is recommended that you install the latest PTFs to upgrade to the latest
level of the HTTP Server for i5/OS. Some of the topics documented here are
not available prior to this update. See <a href="http://www-03.ibm.com/servers/eserver/iseries/software/http/services/service.html" target="_blank">http://www.ibm.com/servers/eserver/iseries/software/http/services/service.htm</a> <img src="www.gif" alt="Link outside Information Center" /> for more information. </div>
<p><strong>Summary</strong></p>
<p>The module mod_as_cache provides support for caching frequently referenced
files. It can be used to cache file content, file descriptors or both, or
mmap the file. </p>
<p><strong>Directives</strong></p>
<ul><li><a href="#cachelocalfd">CacheLocalFD</a></li>
<li><a href="#cachelocalfile">CacheLocalFile</a></li>
<li><a href="#cachelocalfilemmap">CacheLocalFileMmap</a></li>
<li><a href="#cachelocalfilepublic">CacheLocalFilePublic</a></li>
<li><a href="#cachelocalfilesizelimit">CacheLocalFileSizeLimit</a></li>
<li><a href="#cachelocalsizelimit">CacheLocalSizeLimit</a></li>
<li><a href="#dynamiccache">DynamicCache</a></li>
<li><a href="#frcacachelocalfileruntime">FRCACacheLocalFileRunTime</a></li>
<li><a href="#frcacachelocalfilesizelimit">FRCACacheLocalFileSizeLimit</a></li>
<li><a href="#frcacachelocalfilestartup">FRCACacheLocalFileStartUp</a></li>
<li><a href="#frcacachelocalsizelimit">FRCACacheLocalSizeLimit</a></li>
<li><a href="#frcacookieaware">FRCACookieAware</a></li>
<li><a href="#frcaenablefilecache">FRCAEnableFileCache</a></li>
<li><a href="#frcaenableproxy">FRCAEnableProxy</a></li>
<li><a href="#frcaendofurlmarker">FRCAEndofURLMarker</a></li>
<li><a href="#frcamaxcommbuffersize">FRCAMaxCommBufferSize</a></li>
<li><a href="#frcamaxcommtime">FRCAMaxCommTime</a></li>
<li><a href="#frcaproxycacheentitysizelimit">FRCAProxyCacheEntitySizeLimit</a></li>
<li><a href="#frcaproxycacheexpirylimit">FRCAProxyCacheExpiryLimit</a></li>
<li><a href="#frcaproxycacherefreshinterval">FRCAProxyCacheRefreshInterval</a></li>
<li><a href="#frcaproxycachesizelimit">FRCAProxyCacheSizeLimit</a></li>
<li><a href="#frcaproxypass">FRCAProxyPass</a></li>
<li><a href="#frcarandomizeresponse">FRCARandomizeResponse</a></li>
<li><a href="#livelocalcache">LiveLocalCache</a></li>
</ul>
</div>
<div class="hr" id="cachelocalfd"><a name="cachelocalfd"><!-- --></a><h2 class="topictitle2">CacheLocalFD</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: CacheLocalFD <em>filename</em> </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="cachelocalfd__cachelocalfd_context"><a name="cachelocalfd__cachelocalfd_context"><!-- --></a>server config </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="cachelocalfd__cachelocalfd_origin"><a name="cachelocalfd__cachelocalfd_origin"><!-- --></a>iSeries™ </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: CacheLocalFD some_image.gif </td>
</tr>
</tbody>
</table>
</div>
<p>The CacheLocalFD directive is used to specify the names of ASCII/BINARY
stream files whose descriptors you want to cache at server startup. The file
is opened (share read) and remains open while the server is active. The configuration
file can contain multiple directive occurrences. Include a separate directive
for each file that you want to remain open. By keeping your most frequently
requested files/images opened at server startup, you can improve your server's
response time for those files. For example, if you open your server's welcome
page files at startup, the server can handle requests for the page much more
quickly than if it had to open the files each time they are requested. </p>
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>filename </em></dt>
<dd><ul><li>The <em>filename</em> parameter specifies the names of ASCII/BINARY stream
files whose descriptors are cached at server startup.</li>
</ul>
</dd>
</dl>
<p>The advantage of using CacheLocalFD directive over CacheLocalFile is that
it does not cache the content of the file, and therefore does not allocate
a large amount of memory, yet provides similar performance. The disadvantage
of using CacheLocalFD directive over CacheLocalFile is that it only caches
the file descriptors of ASCII/BINARY stream files and it keeps the file open
(share read) while the server is active.</p>
<p>The LiveLocalCache directive setting does not apply to this directive and
if a cached file is updated, the cached entity is discarded and the updated
file is served from the file system. If a cached file is modified while at
the same time being served, the content of the response body is unpredictable.</p>
<div class="note"><span class="notetitle">Note:</span> You can use an asterisk ('*') as a wildcard character on the file names
(for example, CacheLocalFD *.gif). File name matching is not recursive through
subdirectories. The server will only cache files in the specified directory.
No files in subdirectories are affected.</div>
</div>
</div>
<div class="hr" id="cachelocalfile"><a name="cachelocalfile"><!-- --></a><h2 class="topictitle2">CacheLocalFile</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: CacheLocalFile <em>filename</em> </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="cachelocalfile__cachelocalfile_context"><a name="cachelocalfile__cachelocalfile_context"><!-- --></a>server
config </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="cachelocalfile__cachelocalfile_origin"><a name="cachelocalfile__cachelocalfile_origin"><!-- --></a>iSeries </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: CacheLocalFile bobwelcome.html </td>
</tr>
</tbody>
</table>
</div>
<p>The CacheLocalFile directive is used to specify the names of files that
you want to load into the server's memory each time that you start the server,
and is the recommended file cache method. You can have multiple occurrences
of this directive in the configuration file. Include a separate directive
for each file that you want to load into memory. By keeping your most frequently
requested files loaded in the server's memory, you can improve your server's
response time for those files. For example, if you load your server's welcome
page into memory at startup, the server can handle requests for the page much
more quickly than if it had to read the file from the file system. </p>
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>filename </em></dt>
<dd><ul><li>The <em>filename</em> parameter specifies the names of files that you want
to load into the server's memory each time that you start the server.</li>
</ul>
</dd>
</dl>
<div class="note"><span class="notetitle">Note:</span> You can use an asterisk ('*') as a wildcard character on the file names
(for example, CacheLocalFile *.html). File name matching is not recursive
through subdirectories. The server will only cache files in the specified
directory. No files in subdirectories are affected. </div>
</div>
</div>
<div class="hr" id="cachelocalfilemmap"><a name="cachelocalfilemmap"><!-- --></a><h2 class="topictitle2">CacheLocalFileMmap</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: CacheLocalFileMmap <em>filename</em> </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="cachelocalfilemmap__cachelocalfilemmap_context"><a name="cachelocalfilemmap__cachelocalfilemmap_context"><!-- --></a>server
config </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="cachelocalfilemmap__cachelocalfilemmap_origin"><a name="cachelocalfilemmap__cachelocalfilemmap_origin"><!-- --></a>iSeries </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: CacheLocalFileMmap bobwelcome.html </td>
</tr>
</tbody>
</table>
</div>
<p>The CacheLocalFileMmap directive is used to specify the names of files
that you want to map to the server's memory each time that you start the server.
This directive is similar to the CacheLocalFile directive. Whereas CacheLocalFile
allocates storage and copies (read/write) the content of the file to the allocated
storage, CacheLocalFileMmap maps the file content to the process storage space
without actually allocating storage.</p>
<p>The LiveLocalCache directive setting does not apply to this directive and
if a cached file is updated, the cached entity is discarded and the updated
file is served from the file system. If a cached file is modified while at
the same time being served, the content of the response body is unpredictable. </p>
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>filename </em></dt>
<dd><ul><li>The <em>filename</em> parameter specifies the names of files that you want
to map to the server's memory each time that you start the server. </li>
</ul>
</dd>
</dl>
<p>You can have multiple occurrences of this directive in the configuration
file. Include a separate directive for each file that you want to load into
memory. By keeping your most frequently requested files mapped in the server's
address space, you can improve your server's response time for those files.
For example, if you map your server's welcome at startup, the server can handle
requests for the page much more quickly than if it had to read the file from
the file system. </p>
<div class="note"><span class="notetitle">Note:</span> You can use an asterisk (*) as a wildcard character on the file names
(for example, CacheLocalFileMmap *.html). File name matching is not recursive
through subdirectories. The server will only cache files in the specified
directory. No files in subdirectories are affected. The relative/absolute
path rules apply to this directive, meaning that a path that begins without
a leading (/) character is considered to be absolute. Otherwise, the path
is based on the server's document root.</div>
</div>
</div>
<div class="hr" id="cachelocalfilepublic"><a name="cachelocalfilepublic"><!-- --></a><h2 class="topictitle2">CacheLocalFilePublic</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: CacheLocalFilePublic <var class="varname">filename</var></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: server</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: iSeries</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: CacheLocalFilePublic bobwelcome.html</td>
</tr>
</tbody>
</table>
</div>
<p> The CacheLocalFilePublic directive is used to specify the names of files
that you want to load into the server's memory each time that you start the
server. The files cached here are files that are served without any server
authentication. This directive is used by SSL sites which have pages that
are publicly available. This simulates the FRCA function completed by the
server for non-SSL publicly available files. You can have multiple occurrences
of this directive in the configuration file. Include a separate directive
for each file that you want to load into memory. By keeping your most frequently
requested public files loaded in the server's memory, you can improve your
server's response time for those files. For example, if you load your server's
welcome page into memory at startup, the server can handle requests for the
page much more quickly than if it had to read the file from the file system.</p>
<p><strong>Note:</strong> You can use an asterisk (''*'') as a wildcard character on
the file names, (for example, CacheLocalFile *.html).</p>
<p>File name matching is not recursive through subdirectories. The server
only caches files in the specified directory. No files in subdirectories
are affected. There is no authentication or authorization done before any
files in this cache are served. </p>
</div>
</div>
<div class="hr" id="cachelocalfilesizelimit"><a name="cachelocalfilesizelimit"><!-- --></a><h2 class="topictitle2">CacheLocalFileSizeLimit</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: CacheLocalFileSizeLimit <em>size</em> </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: CacheLocalFileSizeLimit 90000 </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="cachelocalfilesizelimit__cachelocalsizelimit_context"><a name="cachelocalfilesizelimit__cachelocalsizelimit_context"><!-- --></a>server
config </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="cachelocalfilesizelimit__cachelocalsizelimit_origin"><a name="cachelocalfilesizelimit__cachelocalsizelimit_origin"><!-- --></a>iSeries </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: CacheLocalFileSizeLimit 5000000 </td>
</tr>
</tbody>
</table>
</div>
<p>The CacheLocalFileSizeLimit directive is used to specify, in bytes, the
largest file that will be placed in the local memory cache. A file larger
than the value specified for CacheLocalFileSizeLimit will not be placed in
the cache. This prevents the cache from being filled by only a small number
of very large files. The upper limit for this directive is capped at 16,000,000.
If you specify a larger value the value 16,000,000 will be used. </p>
</div>
</div>
<div class="hr" id="cachelocalsizelimit"><a name="cachelocalsizelimit"><!-- --></a><h2 class="topictitle2">CacheLocalSizeLimit</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: CacheLocalSizeLimit <em>size</em> </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: CacheLocalSizeLimit 2000 </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="cachelocalsizelimit__cachelocalsizelimit_context"><a name="cachelocalsizelimit__cachelocalsizelimit_context"><!-- --></a>server
config </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="cachelocalsizelimit__cachelocalsizelimit_origin"><a name="cachelocalsizelimit__cachelocalsizelimit_origin"><!-- --></a>iSeries </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: CacheLocalSizeLimit 25000 </td>
</tr>
</tbody>
</table>
</div>
<p>The CacheLocalSizeLimit directive is used to specify the maximum amount
of memory, in kilobytes, that you want to allow for file caching. You must
specify the files that you want cached with the CacheLocalFile directive or
by setting DynamicCache to on. The number you specify is the upper limit (the
maximum upper limits 93 gigabytes (100,000,000,000 bytes)); the storage is
allocated as a file is cached. </p>
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>size</em></dt>
<dd><ul><li>The <em>size</em> parameter specifies the maximum amount of memory, in kilobytes,
that you want to allow for file caching. </li>
</ul>
<p><strong>Note:</strong> CacheLocalSizeLimit can help limit your cache size when
you are using the wildcard character to specify the files on the CacheLocalFile
directive.</p>
</dd>
</dl>
</div>
</div>
<div class="hr" id="dynamiccache"><a name="dynamiccache"><!-- --></a><h2 class="topictitle2">DynamicCache</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: DynamicCache <em>on | off </em></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: DynamicCache off </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="dynamiccache__dynamiccache_context"><a name="dynamiccache__dynamiccache_context"><!-- --></a>server config </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="dynamiccache__dynamiccache_origin"><a name="dynamiccache__dynamiccache_origin"><!-- --></a>iSeries </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: DynamicCache on </td>
</tr>
</tbody>
</table>
</div>
<p>The DynamicCache directive is used to specify if you want the server to
dynamically cache frequently accessed files. Setting the dynamic cache directive
to "on" instructs the server to cache the most frequently accessed files.
This results in better performance and system throughput. </p>
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>on | off </em></dt>
<dd><ul><li>If the parameter is set to <em>on</em> the server will dynamically cache
frequently accessed files.</li>
<li>If the parameter is set to <em>off</em> the server will not dynamically
cache frequently accessed files.</li>
</ul>
</dd>
</dl>
<div class="note"><span class="notetitle">Note:</span> Note requires links.If you know the files that are frequently accessed
or you have a large number of files, then it is better to use CacheLocalFile
, CacheLocalFD, or CacheLocalFileMmap to cache them at server startup. </div>
</div>
</div>
<div class="hr" id="frcacachelocalfileruntime"><a name="frcacachelocalfileruntime"><!-- --></a><h2 class="topictitle2">FRCACacheLocalFileRunTime</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCACacheLocalFileRunTime <em>filename</em> </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcacachelocalfileruntime__frcacachelocalfileruntime_context"><a name="frcacachelocalfileruntime__frcacachelocalfileruntime_context"><!-- --></a>server
config </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcacachelocalfileruntime__frcacachelocalfileruntime_origin"><a name="frcacachelocalfileruntime__frcacachelocalfileruntime_origin"><!-- --></a>iSeries </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCACacheLocalFileRunTime /www/html/index.html</td>
</tr>
</tbody>
</table>
</div>
<p>The FRCACacheLocalFileRunTime directive specifies the name of a file that
you want to load into the SLIC NFC during server run time if and when it is
requested by a client. The configuration file can contain multiple directive
occurrences. </p>
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>filename </em></dt>
<dd><ul><li>The <em>filename</em> parameter value specifies the name of a file that
you want to load into the SLIC NFC during server run time if and when it is
requested by a client.</li>
</ul>
</dd>
</dl>
<p>During server run time, the below example caches the specified file in
FRCA NFC if it is requested by a client.</p>
<pre class="block">FRCACacheLocalFileRunTime /www/html/index.html</pre>
<div class="note"><span class="notetitle">Note:</span> You can use an asterisk (*) as a wild card character on the file name.
Filename matching is not recursive through subdirectories. The server only
caches files in the specified directory. No files in other sub directories
are affected.</div>
<p>During server run time, the below example caches in the FRCA NFC any .gif
file in the /www/images directory that is requested by a client. For example, </p>
<pre class="block">FRCACacheLocalFileRunTime /www/images/*.gif</pre>
<div class="note"><span class="notetitle">Note:</span> You can use an asterisk (*) as a wild card character on the file name.
Filename matching is not recursive through subdirectories. The server will
only cache files in the specified directory and its subdirectories.</div>
<p>During server run time, the below example will dynamically cache in the
SLIC NFC (based on the file usage) any file that is in a directory path that
starts with /www/imag and its subdirectories. For example, </p>
<pre class="block">FRCACacheLocalFileRunTime /www/imag*</pre>
<div class="note"><span class="notetitle">Note:</span> If directory name begins with / it is absolute, otherwise it is relative
to the server's document root.</div>
<p>During server run time, the below example will dynamically cache in the
SLIC NFC (based on the file usage) any file in any directory.</p>
<pre class="block">FRCACacheLocalFileRunTime /*</pre>
<div class="note"><span class="notetitle">Note:</span> If a directory name begins with / it is absolute, otherwise it is relative
to the server's document root.</div>
<p>For caching files at the server run time, only specify the path name of
the files that are intended for public viewing. That is, do not specify or
configure file names containing sensitive information which is not intended
for general users. FRCACacheLocalFileRunTime only caches files that do not
require conversion. (IFS binary or ASCII files).</p>
</div>
</div>
<div class="hr" id="frcacachelocalfilesizelimit"><a name="frcacachelocalfilesizelimit"><!-- --></a><h2 class="topictitle2">FRCACacheLocalFileSizeLimit</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCACacheLocalFileSizeLimit <em>size</em> </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: FRCACacheLocalFileSizeLimit 92160 </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcacachelocalfilesizelimit__frcacachelocalfilesizelimit_context"><a name="frcacachelocalfilesizelimit__frcacachelocalfilesizelimit_context"><!-- --></a>server
config </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcacachelocalfilesizelimit__frcacachelocalfilesizelimit_origin"><a name="frcacachelocalfilesizelimit__frcacachelocalfilesizelimit_origin"><!-- --></a>iSeries </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCACacheLocalFileSizeLimit 32000 </td>
</tr>
</tbody>
</table>
</div>
<p>The FRCACacheLocalFileSizeLimit directive specifies the maximum file size
(in bytes) that you want to allow for file caching. The directive can control
cache storage for a number of smaller files when using wild card characters
to specify files in the FRCACacheLocalFileStartUp and FRCACacheLocalFileDynamic
directives</p>
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>size </em></dt>
<dd><ul><li>The <em>size</em> parameter value specifies the maximum file size (in bytes)
that you want to allow for file caching.</li>
</ul>
</dd>
</dl>
<p>The below example allows only caching of files that are equal to or less
than 32000 bytes. Files greater than 32000 bytes are not cached.</p>
<pre class="block">FRCACacheLocalFileSizeLimit 32000</pre>
</div>
</div>
<div class="hr" id="frcacachelocalfilestartup"><a name="frcacachelocalfilestartup"><!-- --></a><h2 class="topictitle2">FRCACacheLocalFileStartUp</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCACacheLocalFileStartUp <em>filename</em> </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcacachelocalfilestartup__frcacachelocalfilestartup_context"><a name="frcacachelocalfilestartup__frcacachelocalfilestartup_context"><!-- --></a>server
config</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcacachelocalfilestartup__frcacachelocalfilestartup_origin"><a name="frcacachelocalfilestartup__frcacachelocalfilestartup_origin"><!-- --></a>iSeries </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCACacheLocalFileStartUp /www/html/index.html </td>
</tr>
</tbody>
</table>
</div>
<p>The FRCACacheLocalFileStartUp directive specifies the file name that you
want to load into the SLIC NFC each time you start the server. The configuration
file can contain multiple directive occurrences. </p>
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>filename </em></dt>
<dd><ul><li>The <em>filename</em> parameter value specifies the file name that you want
to load into the SLIC NFC each time you start the server.</li>
</ul>
</dd>
</dl>
<p>The below example caches a specific file. </p>
<pre class="block">FRCACacheLocalFileStartUp /www/html/index.html</pre>
<div class="note"><span class="notetitle">Note:</span> You can use an asterisk (*) as a wild card character on the file name.
Filename matching is not recursive through subdirectories. The server only
caches files in the specified directory. No files in other sub directories
are affected.</div>
<p>The below example caches all .gif files in the /www/images directory. </p>
<pre class="block">FRCACacheLocalFileStartUp /www/images/*.gif</pre>
<div class="note"><span class="notetitle">Note:</span> If a directory name begins with / it is absolute, otherwise it is relative
to the server's document root.</div>
<p>FRCACacheLocalFileStartUp only caches files that do not require conversion.
(IFS binary or ASCII files). FRCA Proxy does not perform authentication or
authorization checking. Therefore, do not specify or configure file names
containing sensitive information that is not intended for public viewing. </p>
</div>
</div>
<div class="hr" id="frcacachelocalsizelimit"><a name="frcacachelocalsizelimit"><!-- --></a><h2 class="topictitle2">FRCACacheLocalSizeLimit</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCACacheLocalSizeLimit <em>size</em> </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: FRCACacheLocalSizeLimit 2000 </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcacachelocalsizelimit__frcacachelocalsizelimit_context"><a name="frcacachelocalsizelimit__frcacachelocalsizelimit_context"><!-- --></a>server
config </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcacachelocalsizelimit__frcacachelocalsizelimit_origin"><a name="frcacachelocalsizelimit__frcacachelocalsizelimit_origin"><!-- --></a>iSeries </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCACacheLocalSizeLimit 5000 </td>
</tr>
</tbody>
</table>
</div>
<p>The FRCACacheLocalSizeLimit directive specifies the maximum amount of storage
(in kilobytes) that you want to allow for FRCA file caching. </p>
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>size</em></dt>
<dd><ul><li>The <em>size</em> parameter value specifies the maximum amount of storage
(in kilobytes) that you want to allow for FRCA file caching.</li>
</ul>
</dd>
</dl>
<p>The below example caches files until the accumulated size reaches 5000
kilobytes. </p>
<pre class="block">FRCACacheLocalSizeLimit 5000</pre>
<div class="note"><span class="notetitle">Note:</span> The specified value is the upper limit, the actual amount of allocated
storage is the accumulated size of the cached files. This directive can limit
the cache size when using wild card character to specify the files in the
FRCACacheLocalFileStartUp directive. </div>
<p>If the specified directive size is greater than the amount of available
storage in the FRCA network file cache, the FRCA network file only caches
as many files as it has space for. </p>
</div>
</div>
<div class="hr" id="frcacookieaware"><a name="frcacookieaware"><!-- --></a><h2 class="topictitle2">FRCACookieAware</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCACookieAware <em>&lt;path&gt;</em></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcacookieaware__frcacookieaware_context"><a name="frcacookieaware__frcacookieaware_context"><!-- --></a>server
config </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcacookieaware__frcacookieaware_origin"><a name="frcacookieaware__frcacookieaware_origin"><!-- --></a>iSeries </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCACookieAware /some_path_segment </td>
</tr>
</tbody>
</table>
</div>
<p>This FRCACookieAware directive indicates URL prefix for which the cookie
should be included in cache lookup. This directive makes it possible to serve
a cached entity only for the requests with the same cookie</p>
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>&lt;path&gt;</em></dt>
<dd><ul><li>The <em>&lt;path&gt;</em> parameter value specifies a valid path name.</li>
</ul>
</dd>
</dl>
</div>
</div>
<div class="hr" id="frcaenablefilecache"><a name="frcaenablefilecache"><!-- --></a><h2 class="topictitle2">FRCAEnableFileCache</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCAEnableFileCache <em>on | off </em></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: FRCAEnableFileCache off </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcaenablefilecache__frcaenablefilecache_context"><a name="frcaenablefilecache__frcaenablefilecache_context"><!-- --></a>server
config</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcaenablefilecache__frcaenablefilecache_origin"><a name="frcaenablefilecache__frcaenablefilecache_origin"><!-- --></a>iSeries </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAEnableFileCache on </td>
</tr>
</tbody>
</table>
</div>
<p>The FRCAEnableFileCache directive enables or disables FRCA file caching
support for the specified server. </p>
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>on | off </em></dt>
<dd><ul><li>If the parameter value is <em>on</em>, FRCA file caching support is enabled
for the specified server. </li>
<li>If the parameter value is <em>off</em>, all other FRCA file cache related
directives in the configuration file are ignored.</li>
</ul>
</dd>
</dl>
<div class="note"><span class="notetitle">Note:</span> FRCA does not perform authentication or authorization checking for the
HTTP requests that are served from the FRCA cache.</div>
</div>
</div>
<div class="hr" id="frcaenableproxy"><a name="frcaenableproxy"><!-- --></a><h2 class="topictitle2">FRCAEnableProxy</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCAEnableProxy <em>on | off </em></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: FRCAEnableProxy off</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcaenableproxy__frcaenableproxy_context"><a name="frcaenableproxy__frcaenableproxy_context"><!-- --></a>server
config, virtual host</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcaenableproxy__frcaenableproxy_origin"><a name="frcaenableproxy__frcaenableproxy_origin"><!-- --></a>iSeries </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAEnableProxy on </td>
</tr>
</tbody>
</table>
</div>
<p>The FRCAEnableFileCache directive enables or disables FRCA proxy support. </p>
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>on | off </em></dt>
<dd><ul><li>If the parameter value is <em>on</em>, FRCA proxy support is enabled for
the specified container. </li>
<li>If the parameter value is <em>off</em>, only FRCA directives in the server
configuration section are ignored. If FRCAEnableProxy is set to off in a virtual
host container, only FRCA directives in that virtual host container are ignored.</li>
</ul>
</dd>
</dl>
<p>FRCA proxy does not perform authentication or authorization checking for
the HTTP requests that are served by the FRCA Proxy support. </p>
<div class="note"><span class="notetitle">Note:</span> Virtual host containers do not inherit the FRCAEnableProxy setting from
the server configuration.</div>
</div>
</div>
<div class="hr" id="frcaendofurlmarker"><a name="frcaendofurlmarker"><!-- --></a><h2 class="topictitle2">FRCAEndofURLMarker</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCAEndofURLMarker <em>&lt;string&gt;</em></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcaendofurlmarker__frcaendofurlmarker_context"><a name="frcaendofurlmarker__frcaendofurlmarker_context"><!-- --></a>server
config</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcaendofurlmarker__frcaendofurlmarker_origin"><a name="frcaendofurlmarker__frcaendofurlmarker_origin"><!-- --></a>iSeries </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAEndofURLMarker ###"</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAEndofURLMarker eou</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAEndofURLMarker #eou#</td>
</tr>
</tbody>
</table>
</div>
<p>The FRCAEndofURLMarker directive specifies the unique string that identifies
the end of URLs. Suppose a link in an html page is http://some.org/some_path/some_parms###.
Before the client sends this request to the server, it may pad the URL with
data such as client_padded_data. The some.org server will receive the path
/some_path/some_parms###client_padded_data.</p>
<p>By specifying FRCAEndofURLMarker ###", FRCA support can identify the end
of the original URL (link) before it was modified or padded by the client.
</p>
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>&lt;string&gt;</em></dt>
<dd><ul><li>The <em>&lt;string&gt;</em> parameter value specifies a string of one or more
characters including #, $.</li>
</ul>
</dd>
</dl>
</div>
</div>
<div class="hr" id="frcamaxcommbuffersize"><a name="frcamaxcommbuffersize"><!-- --></a><h2 class="topictitle2">FRCAMaxCommBufferSize</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCAMaxCommBufferSize <em>size</em> </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: FRCAMaxCommBufferSize 8000 </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcamaxcommbuffersize__frcamaxcommbuffersize_context"><a name="frcamaxcommbuffersize__frcamaxcommbuffersize_context"><!-- --></a>server
config</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcamaxcommbuffersize__frcamaxcommbuffersize_origin"><a name="frcamaxcommbuffersize__frcamaxcommbuffersize_origin"><!-- --></a>Apache </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAMaxCommBufferSize 4000000 </td>
</tr>
</tbody>
</table>
</div>
<p>The FRCAMaxCommBufferSize directive sets the communication buffer size
(in bytes) in FRCA for performance. The data being sent to HTTP Server (powered
by Apache) consists of log data, message data, and collection services data.
FRCA will buffer the size of data specified until the buffer is full. Once
the buffer is full, the data will be transmitted to Apache for processing. </p>
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>size</em></dt>
<dd><ul><li>The <em>size</em> parameter value sets the communication buffer size (in
bytes) in FRCA for performance.</li>
</ul>
</dd>
</dl>
</div>
</div>
<div class="hr" id="frcamaxcommtime"><a name="frcamaxcommtime"><!-- --></a><h2 class="topictitle2">FRCAMaxCommTime</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCAMaxCommTime <em>time</em> </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: FRCAMaxCommTime 120 </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcamaxcommtime__frcamaxcommtime_context"><a name="frcamaxcommtime__frcamaxcommtime_context"><!-- --></a>server
config</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcamaxcommtime__frcamaxcommtime_origin"><a name="frcamaxcommtime__frcamaxcommtime_origin"><!-- --></a>Apache </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAMaxCommTime 240 </td>
</tr>
</tbody>
</table>
</div>
<p>The FRCAMaxCommTime directive sets the maximum number of seconds to wait
before the data buffer is sent from FRCA to HTTP Server (powered by Apache).
The data being sent to HTTP Server consists of log data, message data, and
collection services data. Once the time limit has been reached, the data will
be transmitted to HTTP Server for processing. Valid values include integers
0 through 65,535. </p>
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>time </em></dt>
<dd><ul><li>The <em>time</em> parameter value sets the maximum number of seconds to
wait before the data buffer is sent from FRCA to HTTP Server (powered by Apache).</li>
</ul>
</dd>
</dl>
</div>
</div>
<div class="hr" id="frcaproxycacheentitysizelimit"><a name="frcaproxycacheentitysizelimit"><!-- --></a><h2 class="topictitle2">FRCAProxyCacheEntitySizeLimit</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCAProxyCacheEntitySizeLimit <em>size</em> </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: FRCAProxyCacheEntitySizeLimit 92160 </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcaproxycacheentitysizelimit__frcaproxycacheentitysizelimit_context"><a name="frcaproxycacheentitysizelimit__frcaproxycacheentitysizelimit_context"><!-- --></a>server
config </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcaproxycacheentitysizelimit__frcaproxycacheentitysizelimit_origin"><a name="frcaproxycacheentitysizelimit__frcaproxycacheentitysizelimit_origin"><!-- --></a>iSeries </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAProxyCacheEntitySizeLimit 8000 </td>
</tr>
</tbody>
</table>
</div>
<p>The FRCAProxyCacheEntitySizeLimit directive specifies the maximum proxy
response entity size (in bytes) for FRCA to cache. </p>
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>size </em></dt>
<dd><ul><li>The <em>size</em> parameter value specifies the maximum proxy response entity
size (in bytes) for FRCA to cache.</li>
</ul>
</dd>
</dl>
<p>The below example only allows caching of proxy responses that are equal
to, or less than, 8000 bytes. </p>
<pre class="block">FRCAProxyCacheEntitySizeLimit 8000</pre>
</div>
</div>
<div class="hr" id="frcaproxycacheexpirylimit"><a name="frcaproxycacheexpirylimit"><!-- --></a><h2 class="topictitle2">FRCAProxyCacheExpiryLimit</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCAProxyCacheExpiryLimit <em>&lt;time&gt;</em></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: FRCAProxyCacheExpiryLimit 86400</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcaproxycacheexpirylimit__frcaproxycacheexpirylimit_context"><a name="frcaproxycacheexpirylimit__frcaproxycacheexpirylimit_context"><!-- --></a>server
config</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcaproxycacheexpirylimit__frcaproxycacheexpirylimit_origin"><a name="frcaproxycacheexpirylimit__frcaproxycacheexpirylimit_origin"><!-- --></a>iSeries </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAProxyCacheExpiryLimit 3600</td>
</tr>
</tbody>
</table>
</div>
<p>The FRCAProxyCacheExpiryLimit directive sets the expiration (in seconds)
for FRCA proxy cached HTTP documents. Expiry time for FRCA proxy cached HTTP
documents will be set to at most <em>nnn</em> number of seconds into the future.
FRCA proxy cached HTTP documents can be at most <em>nnn</em> seconds out of
date. If the expire header is present with the document in the response, then
the lower of the two values is used. </p>
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>&lt;time&gt;</em></dt>
<dd><ul><li>The <em>&lt;time&gt;</em> parameter value sets the expiration (in seconds)
for FRCA proxy cached HTTP documents.</li>
</ul>
</dd>
</dl>
<p>FRCA proxy cached HTTP documents are limited by the specified time interval
(in seconds). This restriction is enforced even if an expiration date is supplied
with the HTTP document. </p>
</div>
</div>
<div class="hr" id="frcaproxycacherefreshinterval"><a name="frcaproxycacherefreshinterval"><!-- --></a><h2 class="topictitle2">FRCAProxyCacheRefreshInterval</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCAProxyCacheRefreshInterval <em>&lt;proxy&gt; &lt;time&gt;</em></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcaproxycacherefreshinterval__frcaproxycacherefreshinterval_context"><a name="frcaproxycacherefreshinterval__frcaproxycacherefreshinterval_context"><!-- --></a>server
config, virtual host </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcaproxycacherefreshinterval__frcaproxycacherefreshinterval_origin"><a name="frcaproxycacherefreshinterval__frcaproxycacherefreshinterval_origin"><!-- --></a>iSeries</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAProxyCacheRefreshInterval /mirror/ibm/test
30 </td>
</tr>
</tbody>
</table>
</div>
<p>The FRCAProxyCacehRefreshInterval directive sets the time period (in seconds)
to use each cached entity, for the specified URI, before refreshing the cache.</p>
<dl class="block"><dt class="dlterm"><strong>Parameter One</strong>: <em>&lt;path&gt;</em></dt>
<dd><ul><li>The <em>&lt;path&gt;</em> parameter value specifies the URI associated with
cached entity.</li>
</ul>
</dd>
</dl>
<dl class="block"><dt class="dlterm"><strong>Parameter Two</strong>: <em>&lt;time&gt;</em></dt>
<dd><ul><li>The <em>&lt;time&gt;</em> parameter value sets the time period (in seconds)
to use each cached entity, for the specified URI, before refreshing the cache.
Possible values include integers 0 through 2,147,483,647.</li>
</ul>
</dd>
</dl>
<div class="note"><span class="notetitle">Note:</span> If the value specified for <em>&lt;time&gt;</em> is zero, then the document
for the specified path are always current. That is the document is not cached. </div>
<p>FRCA proxy cached HTTP documents are limited by the specified interval
(in seconds). This restriction is enforced even if an expiration date is supplied
with the HTTP document. </p>
</div>
</div>
<div class="hr" id="frcaproxycachesizelimit"><a name="frcaproxycachesizelimit"><!-- --></a><h2 class="topictitle2">FRCAProxyCacheSizeLimit</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCAProxyCacheSizeLimit <em>size</em> </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: FRCAProxyCacheSizeLimit 2000 </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcaproxycachesizelimit__frcaproxycachesizelimit_context"><a name="frcaproxycachesizelimit__frcaproxycachesizelimit_context"><!-- --></a>server
config</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcaproxycachesizelimit__frcaproxycachesizelimit_origin"><a name="frcaproxycachesizelimit__frcaproxycachesizelimit_origin"><!-- --></a>iSeries </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAProxyCacheSizeLimit 5000 </td>
</tr>
</tbody>
</table>
</div>
<p>The FRCAProxyCacheSizeLimit directive specifies the maximum amount of storage
(in kilobytes) that FRCA proxy caching uses for the specified server. </p>
<dl class="block"><dt class="dlterm"><strong>Parameter One</strong>: <em>size </em></dt>
<dd><ul><li>The <em>size</em> parameter value specifies the maximum amount of storage
(in kilobytes) that FRCA proxy caching uses for the specified server.</li>
</ul>
</dd>
</dl>
<p>The below example caches proxy response entities until the accumulated
size reaches 5000 kilobytes.</p>
<pre class="block">FRCAProxyCacheSizeLimit 5000</pre>
<div class="note"><span class="notetitle">Note:</span> The specified value is the upper limit; the actual amount of allocated
storage is the accumulated proxy entity cache size.</div>
</div>
</div>
<div class="hr" id="frcaproxypass"><a name="frcaproxypass"><!-- --></a><h2 class="topictitle2">FRCAProxyPass</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCAProxyPass <em>&lt;path&gt; &lt;URL&gt;</em></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcaproxypass__frcaproxypass_context"><a name="frcaproxypass__frcaproxypass_context"><!-- --></a>server config,
virtual host </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcaproxypass__frcaproxypass_origin"><a name="frcaproxypass__frcaproxypass_origin"><!-- --></a>iSeries</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAProxyPass /mirror/foo/ http://foo.com/ </td>
</tr>
</tbody>
</table>
</div>
<p>The FRCAProxyPass directive allows remote servers to map into the local
server space. The local server does not act as a proxy in the conventional
sense; it acts a mirror of the remote server. </p>
<dl class="block"><dt class="dlterm"><strong>Parameter One</strong>: <em>&lt;path&gt;</em></dt>
<dd><ul><li>The <em>&lt;path&gt;</em> parameter value specifies the name of a local virtual
path. The value is case sensitive.</li>
</ul>
</dd>
</dl>
<dl class="block"><dt class="dlterm"><strong>Parameter Two</strong>: <em>&lt;URL&gt;</em></dt>
<dd><ul><li>The <em>&lt;URL&gt;</em> parameter value specifies the partial URL for the
remote server.</li>
</ul>
</dd>
</dl>
<p>If the local server address is <tt>http://ibm.com/ then FRCAProxyPass /mirror/ibm1/
http://ibm1.com/</tt> causes a local request for the <tt>http://ibm.com/mirror/ibm1/location</tt> to
be internally converted into a proxy request of <tt>http://ibm1.com/location</tt>.</p>
<div class="note"><span class="notetitle">Note:</span> FRCA Proxy does not perform authentication or authorization checking.
Therefore, do not specify or configure paths or URLs that would result in
responses with sensitive information that is not intended for public viewing.</div>
</div>
</div>
<div class="hr" id="frcarandomizeresponse"><a name="frcarandomizeresponse"><!-- --></a><h2 class="topictitle2">FRCARandomizeResponse</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCARandomizeResponse <em>&lt;path&gt; &lt;string&gt; &lt;nnn&gt; &lt;mmm&gt;</em></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcarandomizeresponse__frcarandomizeresponse_context"><a name="frcarandomizeresponse__frcarandomizeresponse_context"><!-- --></a>server
config</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcarandomizeresponse__frcarandomizeresponse_origin"><a name="frcarandomizeresponse__frcarandomizeresponse_origin"><!-- --></a>iSeries </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCARandomizeResponse /some_path/fileNNN.html
NNN 1 1000</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCARandomizeResponse /some_path/fileXXX.html
XXX 200 300</td>
</tr>
</tbody>
</table>
</div>
<p>The FRCARandomizeResponse directive specifies the path template, the replacement
string marker, and the random number range that you would like FRCA to randomly
use when selecting and serving files of that template. For example, if you
have 1000 files with names <em>file1.html</em> through <em>file1000.html</em>.
By configuring <tt>FRCARandomizeResponse /document_root_alias_path/fileNNN.html
NNN 1 1000</tt> and requesting the URL <tt>http://some_host:port/dirpath/fileNNN.html</tt>,
FRCA will randomly select and serve one of the 1000 files. </p>
<dl class="block"><dt class="dlterm"><strong>Parameter One</strong>: <em>&lt;path&gt;</em></dt>
<dd><ul><li>The <em>&lt;path&gt;</em> parameter value specifies valid paths in the form
of /some_path_segment/some_partial_file_name#.ext where "#" is replaced with
a randomly generated number by FRCA before serving the response. <div class="note"><span class="notetitle">Note:</span> the
path must begin with '/'. It cannot be a relative path. </div>
</li>
</ul>
</dd>
</dl>
<dl class="block"><dt class="dlterm"><strong>Parameter Two</strong>: <em>&lt;string&gt; </em></dt>
<dd><ul><li>Text <em>&lt;string&gt;</em> parameter value specifies the replacement string
marker ("NNN") in the path. </li>
</ul>
</dd>
</dl>
<dl class="block"><dt class="dlterm"><strong>Parameter Three</strong>: <em>&lt;nnn&gt;</em></dt>
<dd><ul><li>The <em>&lt;nnn&gt;</em> parameter value specifies the lower limit for random
numbers. </li>
</ul>
</dd>
</dl>
<dl class="block"><dt class="dlterm"><strong>Parameter Four</strong>: <em>&lt;mmm&gt;</em></dt>
<dd><ul><li>The <em>&lt;mmm&gt;</em> parameter value specifies the upper limit for random
numbers.</li>
</ul>
</dd>
</dl>
</div>
</div>
<div class="hr" id="livelocalcache"><a name="livelocalcache"><!-- --></a><h2 class="topictitle2">LiveLocalCache</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: LiveLocalCache <em>on | off </em></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: LiveLocalCache on </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="livelocalcache__livelocalcache_context"><a name="livelocalcache__livelocalcache_context"><!-- --></a>server
config </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="livelocalcache__livelocalcache_origin"><a name="livelocalcache__livelocalcache_origin"><!-- --></a>iSeries </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: LiveLocalCache off </td>
</tr>
</tbody>
</table>
</div>
<p>The LiveLocalCache directive is used to specify if the cache is updated
when a cached file is modified. Set this directive to "on" if you want users,
requesting a cached file, to receive the file with the latest updates. Setting
this directive to "off" is the optimum setting for performance. When LiveLocalCache
directive is set to "on", before responding to a request for a file that is
stored in memory, the server checks to see if the file has changed since the
server was started. If the file has changed, the server responds to this request
with the updated file. The server then deletes the older file version from
memory. Restart the server to load the new file into memory.</p>
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>on | off </em></dt>
<dd><ul><li>If the parameter value is set to <em>on</em>, the cache is updated when
a cached file is modified. </li>
<li>If the parameter value is set to <em>off</em>, the cache is not updated
when a cached file is modified. </li>
</ul>
</dd>
</dl>
</div>
</div>
</body>
</html>