Deactivate PFA cache area during session
Component: | BS2000 |
Functional area: | Caching media control |
Domain: | MULTI-CATALOG-AND-PUBSET-MGMT |
Privileges: | TSOS |
Function
Systems support staff can use this command during a session to withdraw (deactivate) a cache area activated with the START-PUBSET-CACHING command (or implicitly with IMPORT-PUBSET) from an imported SF pubset or from a volume set in an imported SM pubset.
The write data in the PFA cache area is written out to disk and PFA caching is deactivated for the pubset/volume set.
Systems support can obtain information about the currently applicable cache configuration by using the command SHOW-PUBSET-CACHE-ATTRIBUTES (and also SHOW-PUBSET-PARAMETERS).
This command is also supported for shared pubsets.
In a shared pubset network, the command can be issued on the master system or on a slave. A system message refers to the system which is issuing the command, unless it is preceded by message DMS136D, which then includes the name of the system (master or slave) on which the error has occurred. If the command is issued on a slave system, the system name may also be the local host name.
Format
STOP-PUBSET-CACHING | ||||||||||||||||
| ||||||||||||||||
Operands
PUBSET = <cat-id 1..4>
ID of the SF pubset from which the cache area is to be withdrawn or of the SM pubset.
PUBSET-TYPE = *SINGLE-FEATURE / *SYSTEM-MANAGED(...)
Indicates whether the pubset is an SF pubset or an SM pubset.
PUBSET-TYPE = *SINGLE-FEATURE
The pubset is an SF pubset. The cache is directly assigned to the SF pubset.
PUBSET-TYPE = *SYSTEM-MANAGED(...)
The pubset is an SM pubset. The cache is assigned to a single volume set.
VOLUME-SET = <cat-id 1..4>
Identifies the volume set to which the cache is assigned.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No errors | |
1 | 0 | DMS1357 | No cache area active |
32 | DMS1351 | Pubset management parameter error | |
32 | DMS135F | Internal system error | |
32 | DMS1398 | Reconfiguration no longer possible | |
64 | DMS1352 | Not authorized to use command | |
64 | DMS1353 | MRSCAT entry not found | |
64 | DMS1354 | Pubset not locally imported | |
64 | DMS1358 | Function is not supported | |
64 | DMS135E | Cache handler not available | |
64 | DMS1364 | Cache area still active, data not written out to disk, disk or cache error | |
64 | DMS1381 | Volume set conflict | |
64 | DMS138D | Pubset type conflict | |
64 | DMS1390 | Earlier reconfiguration job not yet completed | |
64 | DMS1397 | Reconfiguration by partner system not supported | |
64 | DMS139D | Volume not accessible | |
128 | DMS1363 | Class 4/5 memory shortage | |
128 | DMS1389 | Error in transmission to partner system | |
128 | DMS139A | Other pubset reconfiguration job still active | |
128 | DMS139B | Volume or volume set is reserved | |
128 | DMS139C | Pubset configuration file still locked |