Stop PFA caching for file
Component: | BS2000 |
Functional area: | File processing |
Domain: | FILE |
Privileges: | STD-PROCESSING |
Function
The STOP-FILE-CACHING command terminates caching for an open file or for a closed file for which data is still stored in the cache for further processing (see CLOSE-MODE=*KEEP-DATA-IN-CACHE in the ADD-FILE-LINK command). The data in the cache will be written back, except in the case of read-only caching, and will then be invalidated.
This requires the file to be on a pubset for which a cache configuration is defined in the MRSCAT and the cache to be active, i.e. PFA caching has to be activated for the pubset. The command caller must have access authorization for the file.
The pubset where the file is stored must be accessible on the local host.
Format
STOP-FILE-CACHING |
FILE-NAME = <filename 1..54> |
Operands
FILE-NAME = <filename 1..54>
Name of the file for which caching is to be terminated.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed | |
1 | 0 | CMD0001 | The desired state had already been reached |
1 | CMD0202 | Syntax error | |
32 | DMS1D0E | MSCF connection error | |
32 | DMS1D10 | Internal error | |
64 | DMS1D03 | User does not have access authorization for the file | |
64 | DMS1D05 | File not open (on the local host) | |
64 | DMS1D06 | No cache available | |
64 | DMS1D0A | File not allowed (or not available) | |
64 | DMS1D0D | Storage bottleneck | |
64 | DMS1D0F | Error during catalog management call | |
64 | DMS1D11 | 'DAB' subsystem not found | |
80 | DMS1D0C | Error during file update/invalidation |