z/OS DFSMS Access Method Services Commands
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


SETCACHE

z/OS DFSMS Access Method Services Commands
SC23-6846-01

You can use the SETCACHE command to:
  • Make cache available or unavailable to the subsystem for caching operations
  • Make an addressed device (actuator) eligible or ineligible for caching operations
  • Make cache unavailable to the subsystem when cache is in pending state
  • Make nonvolatile storage (NVS) available or unavailable to the subsystem
  • Activate or deactivate DASD fast write for a device
  • Make DASD fast write unavailable for a device when DASD fast write is in pending state
  • Make cache fast write access available or unavailable to the subsystem
  • Schedule DASD writes for all modified data in cache and NVS (destage modified data)
  • Discard pinned data for a device in cache and NVS
  • Establish a duplex pair
  • Establish a duplex pair from an existing suspended duplex pair
  • Reestablish a duplex pair from the primary volume of a suspended duplex pair and an alternate device
  • Reset a duplex pair to two simplex volumes
  • Suspend the primary or secondary volume of a duplex pair
  • Reinitialize the subsystem, setting all subsystem and device status to the Storage Control's initial installation default values

The format of the SETCACHE command is:

Command Parameters
SETCACHE {FILE(ddname)|{VOLUME(volser)+
  UNIT(unittype)}|
  UNITNUMBER(devid)}
  [DEVICE|SUBSYSTEM|NVS|DASDFASTWRITE|CACHEFASTWRITE]
  [ON|OFF|PENDINGOFF]
  SUBCHSET(n)
  [DISCARDPINNED|DESTAGE|REINITIALIZE|
  SETSECONDARY(devid)|SUSPENDPRIMARY|
  SUSPENDSECONDARY|RESETTODUPLEX|
  REESTABLISHDUPLEX(devid)|RESETTOSIMPLEX]
  [COPY|NOCOPY]
  [PACE(n)]
Note:
  1. The IBM® Enterprise Storage Server® (ESS) cache/DFW is on by default and you are not allowed to modify it. In addition, the ESS does not support the dual-copy function. Any SETCACHE command issued for the ESS that attempts to modify the cache/DFW or use dual-copy function will be rejected.
  2. When the SETCACHE command parameter SETSECONDARY, RESETTODUPLEX, or REESTABLISHDUPLEX is specified, the JCL JOB statement should include the parameter 'TIME=1440' because the IDCAMS step will very likely exceed the execution time allowed by the installation time limit.
  3. The SETCACHE command and the DISCARDPINNED, PENDINGOFF, REINITIALIZE, and SUBSYSTEM parameters may be protected by using the System Authorization Facility (SAF).

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014