Use this command to change the cache resource states for the 3990 record
cache subsystem (RCS) to perform cache error recovery options.
Requirements and Restrictions
- This command is valid for only 3990 RCSs.
- Use this command for cache recovery only. Incorrect use of this
command can cause loss of data.
Format
- sda
- is the 3- to 4-digit hexadecimal symbolic address of a device.
- SSCACHE
- sets the SSCACHE function, where:
- ON
- Allows the 3990 subsystem storage (volatile cache) to be logically brought
online for normal caching operations.
- OFF
- Allows the 3990 subsystem storage (volatile cache) to be logically taken
offline, preventing normal caching operations.
- FORCE
- Allows the 3990 subsystem storage (volatile cache) to be logically taken
offline from a pending offline state.
- REINIT
- Resets the 3990 cache and nonvolatile storage operating states to a
default state and reinitializes all status tracks. Use this option with
caution because all modified cache data is invalidated, possibly resulting in
data loss from the volatile and nonvolatile storage.
- CFW
- sets the CFW function, where:
- ON
- Allows the 3990 subsystem storage cache fast write function to be
logically brought online for the subsystem.
- OFF
- Allows the 3990 subsystem storage cache fast write function to be
logically taken offline for the subsystem.
- NVS
- sets the NVS function, where:
- ON
- Allows the 3990 subsystem nonvolatile storage to be logically brought
online for the subsystem.
- OFF
- Allows the 3990 subsystem nonvolatile storage to be logically taken
offline for the subsystem.
- DEVCACHE
- sets the DEVCACHE function, where:
- ON
- Allows caching to be started for the specified RCS device address.
- OFF
- Allows caching to be stopped for the specified RCS device address.
- DEVDFW
- sets the DEVDFW function, where:
- ON
- Allows DASD fast write to be started for the specified RCS device
address.
- OFF
- Allows DASD fast write to be stopped for the specified RCS device
address.
- FORCE
- Allows DASD fast write to be stopped by force from a pending offline state
for the specified RCS device address.
- DEVRECM
- sets the DEVRECM function, where:
- ON
- Allows record mode to be started for the specified RCS device
address.
- OFF
- Allows record mode to be stopped for the specified RCS device
address.
- Note:
- Some options for the ZBUFC SETCACHE function may be rejected by the 3990 RCS
control unit if they are not compatible with the existing cache status.
Additional Information
- Online help information is available for this command. To display
the help information, enter one of the following:
ZBUFC HELP
ZBUFC ?
- Use this command with the ZBUFC STATUS command, which displays the current
3990 caching status, to help you determine what cache recovery actions are
required.
- You can enter this command to an RCS device that is online or offline to
the TPF system. If you enter this command to an offline device, the
device address must be a valid DASD address that defined to the TPF
system.
- Processing for this command differs for the 3990 Model 3 and the IBM
Enterprise Storage Server (ESS). See TPF Database
Reference for more information about these processing
differences.
Examples
The SSCACHE function is turned on in the following example.
+---------------------------------------------------------------------------------------------+
|User: ZBUFC SETC 04E7 SSCACHE ON |
| |
|System: BUFC0059I 13.51.53 CACHE RECOVERY REQUEST INITIATED ON DEVICE 04E7 RCS SSID 0003 |
+---------------------------------------------------------------------------------------------+
The CFW function is turned off in the following example.
+---------------------------------------------------------------------------------------------+
|User: ZBUFC SETCACHE 04E7 CFW OFF |
| |
|System: BUFC0059I 13.52.24 CACHE RECOVERY REQUEST INITIATED ON DEVICE 1E53 RCS SSID 0003 |
+---------------------------------------------------------------------------------------------+
Related Information
See the following for more information about record caching:
- TPF Database Reference
- 3990 Storage Control Planning, Installation, and
Storage Administration
- 3990 Storage Control Operations and Recovery
Guide
- 3990 Transaction Processing Facility Support
RPQs.