STOP-DAB-CACHING Release existing DAB cache areas

Domain:	SYSTEM-TUNING
Privileges:	TSOS

Function

The /STOP-DAB-CACHING command serves to release existing DAB cache areas, thus releasing all storage areas allocated when the cache area was set up. Any cache data not yet updated in external storage is saved.
The released cache areas can subsequently be reassigned by new /START-DAB-CACHING commands.

Format

STOP-DAB-CACHING    Alias: SPDABC

CACHE-ID = *ALL / <name 1..32>

Operands

CACHE-ID = *ALL / <name 1..32>

Specifies the cache areas which are to be released.

CACHE-ID = *ALL

All cache areas existing are to be released.

The DAB subsystem remains loaded even if all cache areas are successfully released and no more PFA cache area exists.

CACHE-ID = <name 1..32>

The specified cache area is to be released.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No error
	32	CMD0221	Internal SDF error
	64	CMD0216	Required privilege missing
	64	NDB0005	No authorization to invoke the command
	64	NDB0010	Wrong syntax file version
	64	NDB0019	Specified cache area not found in specified medium
	64	NDB0023	Cache area could not be released
	64	NDB0024	No cache area exists
	64	NDB0029	Cache area could not be completely saved to disk
	64	NDB0030	Cache area is not released to permit subsequent reconstruction
	64	NDB0062	System error at disconnection
	64	NDB0067	Cache cannot be released due to system error
	64	NDB0068	Cache area not found
	64	NDB0069	No cache area in the specified medium is currently active
	64	NDB0070	command collides with /STOP-DAB-CACHING processed in parallel
	64	NDB0154	STOP-DAB-CACHING aborted because of pubset import
	64	NDB0178	Processing of the command has been interrupted for a cache area. It is not known how processing was concluded
	64	CMD2241	Subsystem not available

Examples

/show-dab-caching inf=*summary

CACHE-ID     = BUFFER4
CACHE-MEDIUM = M-M

CACHE-SIZE   = 40 MB

CACHING-MODE = READ

----------------------------------------------------------------------------

CURRENT STATISTIC INTERVAL SET UP AT:    <date> <time>

----------------------------------------------------------------------------

            # OF FILES   CACHE-USE  # OF READS  RD-HIT   # OF WRITES  WR-HIT

CACHED               2          2%       20249     99%             0      0%

(SEQUENTIAL)         0          0%           0      0%             0      0%
(RANDOM)             1          2%       20249     99%             0      0%

(UNDEFINED)          1          0%           0      0%             0      0%

CLOSED                          0%          44     93%             0      0%
UNCACHED             0          0%           0      0%             0      0%

CACHE-ID     = BUFFER#001

CACHE-MEDIUM = M-M

CACHE-SIZE   = 20 MB

CACHING-MODE = READ-WRITE(FORCE-OUT=AT-LOW-FILLING)

----------------------------------------------------------------------------

CURRENT STATISTIC INTERVAL SET UP AT:    <date> <time>

----------------------------------------------------------------------------

            # OF FILES   CACHE-USE  # OF READS  RD-HIT   # OF WRITES  WR-HIT
CACHED              50         42%        2206     86%          2185     44%

(SEQUENTIAL)         2          7%         455     95%             0      0%

(RANDOM)            16         34%        1722     84%          2116     44%
(UNDEFINED)         32          0%          29     83%            69     45%

CLOSED                          0%        4139     93%          2005     86%

UNCACHED             0          0%           0      0%             0      0%

/stop-dab-caching

NDB0022 DAB CACHE BUFFER 'BUFFER4' IN CACHE MEDIUM 'M-M' HAS BEEN DELETED

NDB0022 DAB CACHE BUFFER 'BUFFER#001' IN CACHE MEDIUM 'M-M' HAS BEEN DELETED

Notes

1. The cache area is not released if any of its data cannot be completely saved to disk.

2. Unconditional release of a cache area is requested by means of the /FORCE-STOP-DAB-CACHING command.