DCMT VARY AREA

The DCMT VARY AREA command allows you to change the status of an area, open or close the files associated with an area, and flush the buffers associated with the area.
idmscu19
The DCMT VARY AREA command allows you to change the status of an area, open or close the files associated with an area, and flush the buffers associated with the area.
The following topics are discussed on this page:
2
 
2
 
 
Syntax
►►─ DCMT ─┬───────────────────┬─ Vary ARea
segment-namearea-name
──────────► └─ broadcast-parms ─┘ ►─┬─ area-status ─┬─────────────┬─────────────────────────────────┬───────►◄ │ └─ PERmanent ─┘ │ ├─ file-status ─────────────────────────────────────────────────┤ ├─ Quiesce ─────────────────────────────────────────────────────┤ ├─ Active ──────────────────────────────────────────────────────┤ ├─ PUrge ───────────────────────────────────────────────────────┤ ├─ PRefetch ─┬─ ON ──┬──────────────────────────────────────────┤ │ └─ OFF ─┘ │ ├─ DATa SHaring ─┬─ ON ──┬──────────────────────────────────────┤ │ └─ OFF ─┘ │ ├─ MEMORY CACHE ┬──NO ◄─────────────────────────────────────────│ │ └─ YES ─┬───────────────────────────────────┬───│ │ └── STORAGE LIMIT NN ┬───────────┬──┘ │ │ └─ PERCENT ─┘ │ └─ SHAred CAche ─┬─
cache-name
─┬───────────────────────────────┘ └─ NO ─────────┘
Expansion of area-status
 
►─┬─┬─ Update ─┬─┬──────────┬─────────────────────────────────┬──────────► │ └─ ONline ─┘ └─ LOCKED ─┘ │ ├─ Retrieval ───────────┬─┬──────────────┬─┬─────────────┬──┘ ├─ Transient retrieval ─┤ └─ ID
dcmt-id
─┘ └─ IMMediate ─┘ └─ OFfline ─────────────┘
Expansion of file-status
 
►─┬─ ALlocate ──────────┬──────────────────────────────────────────────────► ├─ Close ─────────────┤ ├─ DEallocate ────────┤ └─ OPen ─┬──────────┬─┘ └─ Update ─┘
Parameters
Parameters are as follows:
  •  
    broadcast-parms
    Indicates to execute the DCMT command on all or a list of data sharing group members.
     For more information about broadcasting and 
    broadcast-parms
     syntax, see the section How to Broadcast System Tasks.
  •  
    Area
     Specifies an area to vary.
    • segment-name
       
       The name of the segment containing the area.
    • area-name
       
       The name of the area.
  • PERmanent
     Specifies that the new area status is assigned permanently. The status remains in effect until it is changed by another DCMT VARY command or the journal files are formatted.
    An area under the effect of a PERMANENT parameter is identified inthe journals by its page group and low-page number. If an area's page group or low-page number is changed while one of these commands is in effect, the specified usage-mode is not located and for subsequent startups CA IDMS defaults to the usage-mode specified in the DMCL. The old entry for the area remains in the journals until the journals are formatted.
  • Quiesce
     Brings the named area to an inactive state. New transactions receive an error condition if they try to access the area. Currently executing transactions are allowed to finish processing.
  • Active
     Brings the named area to an active state. You use this command to reactivate an area after you have brought the area to an inactive state by using the DCMT VARY AREA QUIESCE command.
  • PUrge
     Flushes the buffers associated with the area.
  • PRefetch ON/OFf
     Enables or disables prefetch processing for the named area.
  • DATa SHaring
     Specifies the sharability state of the named area. The change is made only if the area status is OFFLINE. Valid values are:
    • ON
       Specifies that this system is eligible to share update access to the area with other members of the system's data sharing group.
    • OFF
       Specifies that this system is no longer eligible to share update access to the area with other members of the system's data sharing group.
  • MEMORY CACHE
     Specifies whether or not to cache the file in memory. This option applies to all files in the area.
    • NO
        Specifies not to cache the file in memory. 
      Note:
       This is the default for SYSTRK files and cannot be changed.
    • YES
        Specifies to limit the amount of 64-bit storage allocated for a given file to a percentage of a total file size, instead of allocating storage for the entire file.
      • STORAGE LIMIT NN PERCENT
         Specifies, in percentage, how much of the area's file to cache in memory.
        Limit:
         0 through 100
        • The value zero or 100 specifies to cache the entire file in memory
        • The values 1 to 99 specify to limit the amount of 64-bit storage allocated for a given file to a percentage of a total file size, instead of allocating storage for the entire file.
  • SHAred CAche
     Specifies the name or status of shared cache for all files associated with the named area. Valid values are:
    • cache-name
       
       Specifies that all files associated with the named area are to be assigned to the named cache structure. 
      Cache-name
       must identify an XES cache structure defined to a coupling facility accessible to the CA IDMS system.
    • NO
       Specifies that the files associated with the named area are no longer assigned to a cache structure.
area-status
 
  • Update/ONline
     Allows transactions executing in this DC/UCF system to update data in the area.
  • LOCKED
     For an area that is offline, specifies that the area is to be varied online with an update lock. This allows you to vary online an area that was varied offline while an update lock was placed on it.
  • Retrieval
     Allows transactions executing in this DC/UCF system to retrieve, but not update, data in the area. Retrieval locks against records accessed in the area are maintained based on the setting of the RETRIEVAL LOCK/NOLOCK parameter on the SYSTEM statement of the SYSGEN.
  • Transient retrieval
     Allows transactions executing in this DC/UCF system to retrieve, but not update, data in the area. Retrieval locks are never maintained for records accessed from an area in Transient Retrieval mode.
  • ID 
    dcmt-id
     
     Specifies the identifier that is to be assigned to this vary operation. Must be a 1 to 8 alphanumeric character string that is unique across all outstanding DCMT operations originating on this node.
    If no dcmt-id is specified, the VARY operation is assigned an internally generated identifier. The identifier can subsequently be used to monitor or terminate the vary operation using DCMT DISPLAY ID and DCMT VARY ID commands.
  • IMMediate
     Specifies that CA IDMS will cancel any tasks or user sessions that prevent the VARY from completing.
  • OFfline
     Makes the area unavailable to transactions running under the DC/UCF system.
file-status
 
  • ALlocate
     (z/OS and z/VM systems only) Dynamically allocates all files associated with the specified area or segment. The files are allocated using their currently assigned data set name.
  • Close
     Closes all files associated with the area or segment. This option is valid only when all areas or segments associated with the files are currently offline.
  • DEallocate
     (z/OS and z/VM systems only) Dynamically deallocates all files associated with the specified area or segment.
  • Open
     Opens all files associated with the area or segment in read-only mode. If the files are already opened in read/write mode, DC/UCF closes the files and reopens them in read-only mode.
  • Update
     Opens all files associated with the area or segment in read/write mode. If the files are already opened in read-only mode, DC/UCF closes the files and reopens them in read/write mode.
Usage
The DCMT VARY AREA command allows changes to the named area. Associated files, buffers, shared cache, and data sharing can also be affected.
Example
DCMT VARY AREA area-name OFFLINE
 
V AREA APPLDICT.DDLDML OFFLINE ---------- Area ----------- Lock Lo-Page Hi-Page #Ret #Upd #Tret #Ntfy APPLDICT.DDLDML Ofl 60001 62000 0 0 0 0 Stamp: 1999-05-05-09.48.14.948912 Pg grp: 0 NoShare NoICVI NoPerm
DCMT VARY AREA APPLDICT.DDLDML RETRIEVAL
 
V AREA APPLDICT.DDLDML RETRIEVAL ---------- Area ----------- Lock Lo-Page Hi-Page #Ret #Upd #Tret #Ntfy APPLDICT.DDLDML Ret 60001 62000 0 0 0 0 Stamp: 1999-05-05-09.48.14.948912 Pg grp: 0 NoShare NoICVI NoPerm