Force a PCA cache area to be deleted
Component: | BS2000 |
Functional area: | Caching media control Pubset and MRSCAT management |
Domain: | MULTI-CATALOG-AND-PUBSET-MGMT |
Privileges: | TSOS |
Function
Using this command, the system administration can force a PCA cache area in a cache medium to be deleted. As part of the “PFA concept” (Performant File Access) the user is given the possibility of using the DMS interfaces to provide buffer storage for files (“caching” them). The cache medium supported via the PFA interfaces is: main memory (MM). The DAB subsystem is required as the cache handler driver software for the use of the cache medium.
The FORCE-DESTROY-CACHE command enables systems support to force PFA cache areas to be deleted without writing the data in the cache out to disk. No allowance is made for resultant data inconsistency on the disks which are affected. Hence, the command is intended only for exceptional circumstances (such as disk or cache defects) in which the buffered data can no longer be transferred to disk by a STOP-PUBSET-CACHING or EXPORT-PUBSET command.
Before the command is executed a dialog (message ECC0501) asks if the action is really to be performed in spite of the risk of data inconsistency. Once the command has executed successfully, message ECC0502 is sent to SYSOUT and the console.
The effect of the command is global; i.e. it applies to all the systems which are attached to the cache area.
The command should be applied only to exported pubsets. FORCE-DESTROY-CACHE cannot be used to delete ADM-PFA cache areas. These areas can be released using the FORCE-STOP-DAB-CACHING command (see the “DAB” manual [5]).
Format
FORCE-DESTROY-CACHE |
CACHE-MEDIUM = *MAIN-MEMORY ,CACHE-ID = <alphanum-name 1..4> |
Operands
CACHE-MEDIUM =
Identifies the storage medium which is used as the buffer store for the data.
The cache area to be deleted is in main memory. If the identifier of the cache area is not found in this medium, the command is rejected with an error message.
CACHE-ID = <alphanum-name 1..4>
The identifier of the cache area which is to be deleted from the specified cache medium (corresponds to the ID of the pubset whose data is being buffered).
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
1 | CMD2201 | Error at the interface between SDF and the command server | |
3 | CMD2203 | SDF version is not supported | |
32 | ECC0001 | Internal error | |
64 | CMD0216 | No authorization to call command | |
64 | ECC0301 | Cache area does not exist | |
64 | ECC0302 | Cache area could not be destroyed | |
64 | ECC0006 | Cache handler DAB not loaded | |
64 | ECC0502 | Cache area was destroyed | |
64 | ECC0005 | Command withdrawn by the user |
Example
Cache area ABCD (the pubset ID of a pubset which is attached to the computer) is in main memory:
/force-destroy-cache cache-medium=*main-mem,cache-id=abcd
% ECC0501 DO YOU REALLY WANT TO DESTROY THE CACHE WITH CACHE-ID 'ABCD'? REPLY (YES; NO)
yes
% ECC0502 CACHE WITH CACHE-ID 'ABCD' HAS BEEN DESTROYED