Previous Topic: Examples: BYPASS Control OptionNext Topic: CANCEL—Allow Operating System CANCEL


CACHE—Reserve Memory

Valid on z/OS.

Use the CACHE control option to provide an area of memory for CA Top Secret to place frequently used items from the security file. Provision for sufficient CACHE reduces I/O against the security file and increases system performance.

CA Top Secret uses virtual storage above the line within its address space as a method to keep commonly used records from the Security File.

CA Top Secret comes with the CACHE option off. Use the TSS MODIFY control option to activate CACHE or specify the CACHE option in the PARMFILE.

The CACHE provides benefits in two areas. The first is that users commonly sign on multiple times in a short duration of time. In some cases this is due to the log on mechanism as in TSO, or log on to multiple regions such as CICS. Secondly, the CACHE benefits profile sharing by allowing I/O performed on behalf of one user to benefit another user logging onto a different address space.

All entry methods are accepted.

This control option has the following format:

CACHE (nnnn|CLEAR|STATUS|OFF)
nnnn

Sets the number of kilobytes of storage allocated for caching. If previously set to OFF, providing this value activates the CACHE feature. CA Top Secret never allows the actual CACHE allocated to exceed the storage it needs to operate. Assure that there is adequate region size allocated for the TSS task to accommodate your cache request. The recommended value for the CACHE control option can be determined using the TSSFAR utility SFSTATS function. For information, see the Troubleshooting Guide.

When using large file sizes, the requested cache size might not be met due to operating system constraints. If your recommended cache size is not being met, an increase in the region size for CA Top Secret is recommended. Consult your system programmer regarding the maximum address space size set within your system.

CLEAR

Empties the CACHE. The CACHE starts to fill again as security records are requested by applications. Clear is also automatically performed when a CACHE request is issued that would cause the CURRENT SIZE to exceed the MAXSIZE.

STATUS

Provides statistics on how much CACHE is used and how efficient CACHE is in avoiding extra I/O. If CACHE is not active, message TSS1303I is displayed. If CACHE is active, the following statistics are displayed:

MAXSIZE

The maximum number of kilobytes used by CACHE as the storage threshold.

SIZE

The current number of kilobytes in use since the last CLEAR.

CALLS

The number of calls made to CACHE

SATISFIED

The number of calls satisfied in CACHE

CLEARED

How many times CACHE was clear for the life of this CA Top Secret address space.

OFF

(Default) Deactivates CACHE. The CACHE is emptied and is not used until requested by a CACHE(nnnn) command.