Domain: | SYSTEM-TUNING |
Privileges: | TSOS SW-MONITOR-ADMINISTRATION |
Function
The /SHOW-DAB-CACHING
command supplies systems support staff with information about the cache areas currently installed. The information displayed can include either all status data, a summary of statistic data or (with AREA=*BY-SYSTEM) the currently served and unserved data areas for each cache area.
/SHOW-DAB-CACHING
.The command supports structured output in S variables (see "SHOW-DAB-CACHING Display information on current DAB configuration").
Format
SHOW-DAB-CACHING | Alias: SHDABC | ||||||||||||||||
|
Operands
CACHE-ID = *ALL / <alphanum-name 1..32>
Identifies the DAB cache area about which information is to be displayed.
CACHE-ID = *ALL
The configuration and statistical data of all existing cache areas is to be displayed.
CACHE-ID = <alphanum-name 1..32>
Name of the cache area for which configuration and statistical data is to be displayed.
INFORMATION = *STD / *SUMMARY / *SYSTEM-CACHED-FILES(...)
Determines the scope of information output.
INFORMATION = *STD
All information available for the cache area is to be output, including the volume/file list.
INFORMATION = *SUMMARY
Only global information about the cache area is to be output (no volume/file list but cumulated statistics).
INFORMATION = *SYSTEM-CACHED-FILES(...)
The selection of files for which information is to be displayed can be restricted for cache areas using automatic caching.
CACHING = *ANY / *ACTIVE / *SUSPENDED
Defines the selection of files for which information is to be output.
CACHING = *ANY
All files using DAB are included.
CACHING = *ACTIVE
Information is output about the files being currently served.
CACHING = *SUSPENDED
Information is output about all files whose caching has been (temporarily) stopped.
Return codes
(SC2) | SC1 | Maincode | Meaning |
---|---|---|---|
0 | CMD0001 | No error | |
32 | CMD0221 | Internal SDF error | |
64 | CMD0216 | Required privilege missing | |
64 | CMD2009 | Error while generating the S variables | |
64 | NDB0005 | No authorization to invoke the command | |
64 | NDB0010 | Wrong syntax file version | |
64 | NDB0024 | No cache area currently active | |
64 | NDB0068 | Cache area not found | |
64 | NDB0079 | Command not executed due to a system error | |
65 | CMD2241 | Subsystem not available |
Format of information output
The following information is output for each selected cache area:
Name of the cache area (cache ID)
The name can be freely selected for the/START-DAB-CACHING
command (DEFAULT=BUFFER#nnn) .Cache medium of the cache area
Cache medium used by this cache area: main memory (M-M).Specified (desired) size of the cache area
This can be varied by specifying AREA=*BY-FILE, which is flagged using the suffix “(BY-FILE)”.Current size of the cache area (in the case of MEMORY=*ANY/*ABOVE-MIN-MEM-SIZE/*BELOW-MIN-MEM-SIZE)
This can differ from the specified (desired) value because of the specification MEMORY=*ANY/ *ABOVE-MIN-MEM-SIZE. This is flagged using the suffix “(ANY)”, “(ABOVE)” or “(BELOW)”.Segment size of the cache area (not with AutoDAB)
Caching mode (READ, READ-WRITE, WRITE or BY-CACHE-MEDIUM)
With caching modes other than READ, additional information about the cache occupancy level which will cause write data of the cache area to be saved to an external volume (FORCE-OUT operand).When a cache area used with any of the caching modes mentioned above is released, information about the percentage of write data transferred to the associated external volumes (DESTAGED) is output.
Support for shared pubsets (with AREA=*FILE)
(definition whether read caching of a data area is to be performed even if the associated disk is operated in shared pubset mode at initial allocation; write caching will not be performed for the data area in this case).
The information is output only in conjunction with SHARED-DISK-SUPPORT=*YES.Start of the current monitoring interval with date/time.
If applicable, the end of the monitoring interval with date/time if statistical values have overflowed.
With INFORMATION=*STD or =*SYSTEM-CACHED-FILES(...), the list of data areas served is additionally output:
For cache areas with automatic caching, first the list of specified volumes (pubsets/private disks) with catalog ID or VSN
File name (AREA=*FILE/*BY-SYSTEM )
Data area served (file: size in LHP)
With INFORMATION=*SYSTEM-CACHED-FILES(CACHING=*ANY), additionally the amount of cache occupied by this file (CACHE-USE)
Operating state of the data area served (SERVICE)
information as to whether any areas are currently being served by DAB (Y) or
not (N)
specification as to whether the disk is shared Y(SHARED) or not (N(SHARED)
indication that the cache area is being released (Y(STOPPED))
indication that a file is being served and is encrypted (Y(ENCRYPTED))
Example
% :CN31:$TSOS.FALAST.2.FILE.004.3ALE % 1-129 Y(ENCRYPTED) 7068868 100% 2512446 0% % :CN31:$TSOS.FALAST.2.FILE.007.3ALH % 1-129 Y(ENCRYPTED) 4915150 100% 2662941 0%
For files:
indication that the file / partial qualification is being served (Y)
indication whether the file is not being served (N) or is not being served and is closed (N(CLOSED))
indication whether a shared file is being served (Y(SHARED)) or not being served (N(SHARED))
indication of partial buffering of the file (Y(PARTIAL)) as a result of the file being distributed over several disks, not all of which are allocated exclusively
cache data of the data area could not be saved the last time the data area was saved due to a hardware or software error (Y(PINNED-DATA) or N(PINNED-DATA))
data description of DAB does not match data description of disk space allocator due to an error (N(INVALID))
indication that the file / partial qualification has been explicitly removed (N(REMOVED))
indication that the file / partial qualification is being served explicitly (Y(MANDATORY))
indication that the encrypted file is being served (Y(ENCRYPTED)) or not being served (N(ENCRYPTED)). Encrypted files are not write-cached.
indication that the encrypted file is being explicitly cached (Y(MAND/CRYPT)). Write caching also takes place for this file.
indication that the encrypted file is not being served because it is closed (N(CLOSED/CRYPT)).
indication that the encrypted and shared file is being served (Y(SHARED/CRYPT)), but it is not write-cached.
indication that an encrypted and shared file is being explicitly cached (Y(SH/MAND/CRYPT)), but it is not write-cached.
Statistics about read and write accesses to the data area and the associated hit rates.
With INFORMATION=*SUMMARY, statistics about read and write accesses to the data area and the associated hit rates are additionally output.
For automatic caching, the statistics are split according to the currently buffered files (CACHED). These are classified into sequentially processed (SEQUENTIAL), randomly processed (RANDOM) and undefined access method (UNDEFINED), the files excluded from caching (UNCACHED) and the files which are already closed (CLOSED).
Output in S variables
The S variables form a structure with elements for each cache area. The substructures for the file/volume lists or the statistical data are generated for each cache area.
The INFORMATION operand of the /SHOW-DAB-CACHING
command defines which S variables are assigned values. The following values are possible for INFORMATION:
Value of the INFORMATION operand | Abbreviation in table |
INFORMATION = *STD / *SYSTEM-CACHED-FILES | 1 |
Additional conditions which define the assignment of values to S variables:
Additional conditions | Abbreviation in table |
var(*LIST).AREA = *FILE / *BY-SYSTEM | a |
Output information | Name of the S variable | T | Contents | Condition |
AREA specification: | var(*LIST).AREA-TYPE | S | *FILE | |
Name of the cache area | var(*LIST).CACHE-ID | S | <c-string 1..32> | |
Cache medium of the cache area | var(*LIST).CACHE-MED | S | *MAIN-MEM | |
Segment size of the cache area | var(*LIST).CACHE-SEGMENT-SIZE | I | *UNDEF | |
Requested size of the cache area | var(*LIST).CACHE-SIZE | I | <integer 1..8388608> | |
Size of the cache area in: | var(*LIST).SIZE-DIM | S | *KB | |
Current size of the cache area | var(*LIST).CACHE-SIZE-ACTUAL | I | <integer 1..8388608> | a |
Size of the current cache area in: | var(*LIST).SIZE-DIM-ACTUAL | S | *KB | a |
Location of the cache area in main | var(*LIST).MEMORY | S | *ABOVE | a |
Share of the cache occupied by | var(*LIST).CACHE-USE-RATIO | I | <integer 0..100> | 3c |
Share of the cache occupied by | var(*LIST).CACHED.CACHE-USE-RATIO | I | <integer 0..100> | 3d |
Number of cached files for | var(*LIST).CACHED.NUM-OF-FILE | i | <integer | 3d |
Number of read accesses to the | var(*LIST).CACHED.NUM-OF-READ | I | <integer | 3d |
Number of write accesses to the | var(*LIST).CACHED.NUM-OF-WRITE | I | <integer | 3d |
Read hit rate of the cached files for | var(*LIST).CACHED.READ-HIT-RATIO | I | <integer 0..100> | 3d |
Write hit rate of the cached files for | var(*LIST).CACHED.WRITE-HIT-RATIO | I | <integer 0..100> | 3d |
Caching mode | var(*LIST).CACHING-MODE | S | *READ | |
Number of closed files | var(*LIST).CLOSE.NUM-OF-FILES | I | <integer | 3d |
Number of read accesses to | var(*LIST).CLOSE.NUM-OF-READ | I | <integer | 3d |
Number of write accesses to | var(*LIST).CLOSE.NUM-OF-WRITE | I | <integer | 3d |
Read hit rate of closed files | var(*LIST).CLOSE.READ-HIT-RATIO | I | <integer 0..100> | 3d |
Write hit rate of closed files | var(*LIST).CLOSE.WRITE-HIT-RATIO | I | <integer 0..100> | 3d |
Share of cache occupied by file | var(*LIST).FILE(*LIST).CACHE-USE-RATIO | I | <integer 0..100> | 2d |
File name | var(*LIST).FILE(*LIST).F-NAME | S | <c-string 1..54> | 1b |
Size of file | var(*LIST).FILE(*LIST).F-SIZE | I | <integer | 1b |
Number of read accesses | var(*LIST).FILE(*LIST).NUM-OF-READS | I | <integer | 1b |
Number of write accesses | var(*LIST).FILE(*LIST).NUM-OF-WRITES | I | <integer | 1b |
Read hit rate | var(*LIST).FILE(*LIST).READ-HIT-RATIO | I | <integer 0..100> | 1b |
Status of the served file | var(*LIST).FILE(*LIST).SERVICE | S | *Y | 1b |
Write hit rate | var(*LIST).FILE(*LIST).WRITE-HIT-RATIO | I | <integer 0..100> | 1b |
Cache utilization level as of which | var(*LIST).FORCE-OUT | S | *UNDEF | |
Number of served files | var(*LIST).NUM-OF-FILE | I | <integer | 3b |
Number of read accesses | var(*LIST).NUM-OF-READ | I | <integer | 3c |
Number of write accesses | var(*LIST).NUM-OF-WRITE | I | <integer | 3c |
Status of cached private disks | var(*LIST).PRIV(*LIST).SERVICE | S | *N | 1d |
VSN of cached private disks for | var(*LIST).PRIV(*LIST).VOL | S | <c-string 1..6> | 1d |
Pubset ID of the cached pubsets | var(*LIST).PUBSET(*LIST).PUBSET | S | <cat-id> | 1d |
Type of pubset | var(*LIST).PUBSET(*LIST).PUBSET-TYPE | S | *SINGLE-FEATURE | 1d |
Status of pubset | var(*LIST).PUBSET(*LIST).SERVICE | S | *N | 1d |
Share of cache allocated (random | var(*LIST).RANDOM.CACHE-USE-RATIO | I | <integer 0..100> | 3d |
Number of files recognized as | var(*LIST).RANDOM.NUM-OF-FILE | I | <integer | 3d |
Number of read accesses (random | var(*LIST).RANDOM.NUM-OF-READ | I | <integer | 3d |
Number of write accesses | var(*LIST).RANDOM.NUM-OF-WRITE | I | <integer | 3d |
Read hit rate (random access) | var(*LIST).RANDOM.READ-HIT-RATIO | I | <integer 0..100> | 3d |
Write hit rate (random access) | var(*LIST).RANDOM.WRITE-HIT-RATIO | I | <integer 0..100> | 3d |
Read hit rate | var(*LIST).READ-HIT-RATIO | I | <integer 0..100> | 3c |
Share of cache allocated | var(*LIST).SEQ.CACHE-USE-RATIO | I | <integer 0..100> | 3d |
Number of files recognized as | var(*LIST).SEQ.NUM-OF-FILE | I | <integer | 3d |
Number of write accesses | var(*LIST).SEQ.NUM-OF-WRITE | I | <integer | 3d |
Number of read accesses | var(*LIST).SEQ.NUM-OF-READ | I | <integer | 3d |
Read hit rate (sequential access) | var(*LIST).SEQ.READ-HIT-RATIO | I | <integer 0..100> | 3d |
Write hit rate (sequential access) | var(*LIST).SEQ.WRITE-HIT-RATIO | I | <integer 0..100> | 3d |
Defines whether shared allocated | var(*LIST).SHARED-DISK-SUP | B | *UNDEF | |
Displays whether a cache area | var(*LIST).SIZE-BY-FILE | B | *UNDEF | |
Number of uncached files | var(*LIST).UNCACHED.NUM-OF-FILE | I | <integer | 3d |
Read accesses to uncached files | var(*LIST).UNCACHED.NUM-OF-READ | I | <integer | 3d |
Write accesses to uncached files | var(*LIST).UNCACHED.NUM-OF-WRITE | I | <integer | 3d |
Share of cache allocated (access | var(*LIST).UNDEF.CACHE-USE-RATIO | I | <integer 0..100> | 3d |
Number of files for AREA=*BY- | var(*LIST).UNDEF.NUM-OF-FILE | I | <integer | 3d |
Number of read accesses (access | var(*LIST).UNDEF.NUM-OF-READ | I | <integer | 3d |
Number of write accesses (access | var(*LIST).UNDEF.NUM-OF-WRITE | I | <integer | 3d |
Write hit rate | var(*LIST).WRITE-HIT-RATIO | I | <integer 0..100> | 3c |
Examples
Example 1 (output of various cache areas)
|
|
|
Example 2 (output in S variables)
The following example illustrates how the information for a SHOW-DAB-CACHING command is saved in a previously declared S variable (in this case LVAR3).
|
LVAR3(*LIST).STATIS(*LIST).STA = *ACTIVE LVAR3(*LIST).STATIS(*LIST).DATA-RESET-DATE = <date> LVAR3(*LIST).STATIS(*LIST).DATA-RESET-TIME = <time> LVAR3(*LIST).AREA-TYPE = *BY-SYSTEM LVAR3(*LIST).PRIV(*LIST).VOL = WK51EB LVAR3(*LIST).PRIV(*LIST).SERVICE = *Y LVAR3(*LIST).PRIV(*LIST).VOL = WK51E1 LVAR3(*LIST).PRIV(*LIST).SERVICE = *N(SHARED) LVAR3(*LIST).UNCACHED(*LIST).NUM-OF-FILE = 0 LVAR3(*LIST).UNCACHED(*LIST).NUM-OF-READ = 0 LVAR3(*LIST).UNCACHED(*LIST).NUM-OF-WRITE = 0