Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

SHOW-ISAM-CACHING

&pagelevel(3)&pagelevel

Show information on ISAM cache areas in data spaces

Component:

BS2000

Functional area:

System control and optimization

Domain:

FILE

Privileges:

TSOS
SW-MONITOR-ADMINISTRATION

Function

The SHOW-ISAM-CACHING provides information on the maximum number of data spaces for ISAM cache areas and how they are used. In addition to global information, detailed information on data spaces, the ISAM pool and the ISAM files buffered there can also be requested.

The command supports structured output in S variables (see "Output in S variables").

The maximum number of data spaces for ISAM cache areas can be changed dynamically using this command.

Format

SHOW-ISAM-CACHING                                                                                         

Alias: SHISAMC

SELECT = *ALL

,INFORMATION = *SUMMARY / *ALL

,OUTPUT = *SYSOUT / *SYSLST(...)


*SYSLST(...)



|


SYSLST-NUMBER = *STD / <integer 1..99>

Operands

SELECT = *ALL
Information for all data spaces which are available for ISAM cache areas is displayed.

INFORMATION = *SUMMARY / *ALL
Specifies the scope of the information which is to be displayed.

INFORMATION = *SUMMARY
General information on ISAM caching is displayed, plus, for each data space, an information block containing global information.

INFORMATION = *ALL
General information on ISAM caching is displayed, plus, for each data space, two information blocks containing global and detailed information.

OUTPUT = *SYSOUT / *SYSLST(...)
Specifies the output medium on which the information is to be displayed. Output to SYSOUT is the default.

OUTPUT = *SYSOUT
The information is output to SYSOUT.

OUTPUT = *SYSLST(...)
The information is output to SYSLST.

SYSLST-NUMBER = *STD / <integer 1..99>
Number of a SYSLST file from the set SYSLST01 through SYSLST99.
Specifying *STD (default value) means system file SYSLST.

Return codes

(SC2)

SC1

Maincode

Meaning/Guaranteed messages


0

CMD0001

Command executed without errors


32

CMD2009

VAS/OPS reports internal error


32

DMS0A66

Internal error when command is executed


64

CMD0216

Privileges error


130

OPS0001

Not enough memory for output in S variables

Output format

The display begins with a general information block:

The following two information blocks are then displayed for each data space which is currently in use:

Global information on ISAM caching

The heading “ISAM CACHING INFORMATION (SUMMARY)” is followed by the information below:

Output field

Meaning

MAXIMUM NUMBER OF DATA SPACES

Maximum number of data spaces (1..127)

NUMBER OF DATA SPACES CURRENTLY IN USE

Number of data spaces currently in use (1..127)

TOTAL DATA SPACE AMOUNT

Total amount of available memory space in MB
(multiple of 2048)

TOTAL USED SPACE

Total amount of memory space in use in MB

TOTAL FREE SPACE

Total amount of free memory space in MB

TOTAL NUMBER OF ISAM POOLS

Number of ISAM pools created

TOTAL NUMBER OF ISAM FILES

Number of buffered ISAM files

TOTAL NUMBER OF FREE AREAS

Number of free memory areas

Table 118: Global information on ISAM caching
Global information on the data space

The heading “DATA SPACE GLOBAL INFORMATION” is followed by the information below:

Output field

Meaning

DS#

Number of the data space (1..127)

USED SPACE

Memory space used in MB

#ISAM POOLS

Number of ISAM pools

#ISAM FILES

Number of buffered files

FREE SPACE

Free memory space in MB

#FREE AREAS

Number of free memory areas

Table 119: Global information on ISAM caching in a data space

Detailed information on the data space

The heading “DETAILED INFORMATION FOR DATA SPACE” is followed by a table providing information on the use of the data space. For every ISAM pool created there the table includes an output line containing the following information:

Information column

Meaning

SIZE

Size of the ISAM pool in MB

FILENAME

Path name of a file buffered in the ISAM pool.
If, as an exception, the pool is assigned multiple files (see FILE-ASS=SAT), each further path name is displayed in a continuation line.

FILE-ASS

Type of file assignment

  • DEF: assignment took place by means of standard processing by the system when the file was opened.

  • USER: the user specified the assignment by means of a command (/CREATE-ISAM-POOL, /ADD-ISAM-POOL-LINK).

  • SAT: assignment as with DEF, but no new cache area could be provided for the file. The ISAM cache area should be enlarged (/MODIFY-ISAM-CACHING).

Table 120: Detailed information on ISAM caching in a data space

Output in S variables

The command’s INFORMATION operand identifies the S variables which are to be created. The following entries are possible for:

Notation used in command

Abbreviated form used in table

INFORMATION = *SUMMARY

INF=*SUM

INFORMATION = *ALL

INF=*ALL

Output information

Name of the S variable

T

Contents                          

Condition  

Size of the ISAM pool in MB

var(*LIST).DATA-SPACE(*LIST).POOL(*LIST).SIZE

S

<integer 1..32766>

INF=*ALL
only

Number of files buffered in the data space

var(*LIST).DATA-SPACE(*LIST).FILE-NUM

S

<integer 1.. 2147483647>


Number of free memory areas in the data space

var(*LIST).DATA-SPACE(*LIST).FREE-AREA-NUM

S

<integer 1..2047>


Free memory space in the data space in MB

var(*LIST).DATA-SPACE(*LIST).FREE-SPACE

S

<integer 1..2048>

Type of file assignment

var(*LIST).DATA-SPACE(*LIST).POOL(*LIST).FILE(*LIST).FILE-ASS

S

DEF / USER / SAT

INF=*ALL
only

Name of the file which is buffered in the ISAM pool

var(*LIST).DATA-SPACE(*LIST).POOL(*LIST).FILE(*LIST).FILE-NAME

S

<filename>

INF=*ALL
only

Number of files which are buffered in the ISAM pool

var(*LIST).DATA-SPACE(*LIST).POOL(*LIST).NUM-FILES-IN-POOL

S

<integer 1..32766>

INF=*ALL
only

Number of ISAM pools in the data space

var(*LIST).DATA-SPACE(*LIST).POOL-NUM

S

<integer 1..2048>


Used memory space in the data space in MB

var(*LIST).DATA-SPACE(*LIST).USED-SPACE

S

<integer 1..2048>


Maximum number of data spaces

var(*LIST).DATA-SPACE-MAX-NUM

S

<integer 1..127>


Number of data spaces used

var(*LIST).DATA-SPACE-USED-NUM

S

<integer 1..127>


Total number of buffered files

var(*LIST).TOTAL-FILE-NUM

S

<integer 1..2147483647>


Total free memory areas in MB

var(*LIST).TOTAL-FREE-AREA-NUM

S

<integer 1..260095>


Total free memory space in MB

var(*LIST).TOTAL-FREE-SPACE

S

<integer 1..260096>


Total number of ISAM pools created

var(*LIST).TOTAL-POOL-NUM

S

<integer 1..260096>


Total memory space available in MB

var(*LIST).TOTAL-SPACE

S

<integer 1..260096>


Total memory space used in MB

var(*LIST).TOTAL-USED-SPACE

S

<integer 1..260096>


Examples

/show-isam-caching inf=*all

---------------------------------------------------------------------------
------------------- ISAM CACHING INFORMATION  (SUMMARY) -------------------
---------------------------------------------------------------------------
 MAXIMUM NUMBER OF DATA SPACES            :      2
 NUMBER OF DATA SPACES CURRENTLY IN USE   :      1
 TOTAL DATA SPACE AMOUNT                  :   2048 MB
 TOTAL USED SPACE                         :      7 MB
 TOTAL FREE SPACE                         :   2041 MB
 TOTAL NUMBER OF ISAM POOLS               :      6
 TOTAL NUMBER OF ISAM FILES               :      8
 TOTAL NUMBER OF FREE AREAS               :      1
   
---------------------------------------------------------------------------
-------------------    DATA SPACE GLOBAL INFORMATION    -------------------
---------------------------------------------------------------------------
 DS# :  1     USED SPACE  :      7 MB        FREE SPACE   :   2041 MB
              #ISAM POOLS :      6           #FREE AREAS  :      1
              #ISAM FILES :      8
---------------------------------------------------------------------------
------------------  DETAILED INFORMATION FOR DATA SPACE  ------------------
---------------------------------------------------------------------------
    SIZE    FILENAME                                            FILE-ASS
---------------------------------------------------------------------------
     1 MB   :SBZ8:$TSOS.SYS.HEL.2012-06-15.183613                   DEF
---------------------------------------------------------------------------
     2 MB   :SBZ8:$SYSAUDIT.SYSLOG.ESS.SYSTEM                       USER
---------------------------------------------------------------------------
     1 MB   :SBZ8:$TSOS.SYSDAT.BCAM.APPLICATIONS.IS1                USER
            :SBZ8:$TSOS.SYSDAT.BCAM.ETC.HOSTS.IS1                   USER
            :SBZ8:$TSOS.SYSDAT.BCAM.PROCESSORS.IS1                  USER
---------------------------------------------------------------------------
     1 MB   :SBZ8:$SYSFJAM.SYSFSA                                   DEF
---------------------------------------------------------------------------
     1 MB   :SBZ8:$SYSSPOOL.PRFILE                                  DEF
---------------------------------------------------------------------------
     1 MB   :SBZ8:$SYSMAREN.TEST.MARENCAT                           DEF
---------------------------------------------------------------------------
Powered by Atlassian Confluence and Scroll Viewport.