z/OS DFSMS Managing Catalogs
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Obtaining Information About Catalogs and CAS Activity

z/OS DFSMS Managing Catalogs
SC23-6853-00

Operator Commands Discussed in This Section:
  • MODIFY CATALOG,ALLOCATED
  • MODIFY CATALOG,CONTENTION
  • MODIFY CATALOG,ENTRY
  • MODIFY CATALOG,LIST
  • MODIFY CATALOG,LISTJ
  • MODIFY CATALOG,ECSHR
  • MODIFY CATALOG,REPORT
  • MODIFY CATALOG,REPORT,PERFORMANCE
  • Start of change MODIFY,CATALOG,REPORT,CATSTATS End of change
  • Start of change MODIFY,CATALOG,REPORT,CATSTATX End of change
  • MODIFY CATALOG,TAKEDUMP

You can use the MODIFY CATALOG command to list information about catalogs currently allocated to the catalog address space. Sometimes you need this information so that you can use another MODIFY command to close or otherwise manipulate a catalog in cache.

Table 1 provides an overview of the reporting capabilities of the MODIFY CATALOG command.

Table 1. Reporting Capabilities of MODIFY CATALOG
Option Message Purpose
ALLOCATED IEC348I Provides information on all catalogs referred to since the last IPL.
CONTENTION IEC359I Provides information on the reason classes or Catalog resources for which contention detection is available. It also indicates the current wait-time and any associated actions.
DUMP   Provides dynamic dumping of the catalog address space during diagnostic testing.
ENTRY IEC349I Provides the storage address and PTF level of a catalog management load module, so that a serviceability level indication processing (SLIP) trap can be set.

For more information on SLIP traps, refer to hz/OS MVS System Commands.

LIST IEC347I Provides the task identification and address of catalog address space tasks, so that the ID can be used in other MODIFY CATALOG commands. The listing also supplies information about job names, elapsed time of the job, and other selected information.
LISTJ IEC3471 Provides the information about a catalog address space task that is operating on behalf of a user job.
ECSHR IEC3801 Provides information about the current status of the enhanced catalog sharing (ECS) function, and catalogs that might be using the facility.
REPORT IEC359I

Provides general information on the status of the catalog address space. Current settings for CAS parameters and features are listed as well as CAS specialty tasks addresses and any CAS entry points that have been intercepted.

There are other forms of the REPORT command that provide information on other aspects of the catalog address space.

Start of change REPORT,CATSTATS End of change Start of change IEC359I End of change Start of change Displays information about I/O activity and catalog settings for all active catalogs. Information displayed here can be used to assess the usage of a particular catalog over time, as well as certain settings that can impact on catalog performance. See Evaluating Catalog I/O Activity and Settings for further discussion.

Other forms of the REPORT command provide information on different aspects of the catalog address space.

End of change
Start of change REPORT,CATSTATX End of change Start of change IEC359I End of change Start of change Extended catalog statistics displays information about I/O activitity and catalog settings for a specific catalog or a particular set of catalogs. Additional data not included in REPORT,CATSTATS is included here in a format intended to provide this extended information. See Evaluating Catalog I/O Activity and Settings for further discussion.

Other forms of the REPORT command provide information on different aspects of the catalog address space.

End of change
REPORT, PERFORMANCE IEC359I Displays information about the performance of specific events that catalog processing invokes. Each line shows the number of times (nnn) that event has occurred since IPL or the last reset of the statistics by MODIFYCATALOG,REPORT,PERFORMANCE(RESET), and the average time for each occurrence (nnn.nnn). The unit of measure of the average time (unit) is either milliseconds (MSEC), seconds (SEC), or the average shown as hours, minutes, and seconds (hh:mm:ss.th).

Other forms of the REPORT command provide information on different aspects of the catalog address space.

TAKEDUMP IEC359I Provides an SVCDUMP that contains the correct dump options to obtain all of the data needed to diagnose catalog problems. Use this command instead of the MVS™ DUMP command because some of the information needed for catalog problems might not be provided.
Note: This table does not reflect the detailed syntax of these commands. See MODIFY CATALOG Command Syntax for syntax information.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014