z/Catalog Consultant

For IBM® z/OS and OS/390

www.centralcoastsoftware.com

Copyright (c) 2006 Central Coast Software, LLC. All Rights Reserved

Introduction......................................................................................................................... 3 Licensing and Support ........................................................................................................ 3 Overview............................................................................................................................. 4 System Requirements.......................................................................................................... 5 Client............................................................................................................................... 5 Server .............................................................................................................................. 5 Installation........................................................................................................................... 6 Overview......................................................................................................................... 6 Client............................................................................................................................... 6 Mainframe Server ......................................................................................................... 11 Mainframe Server System Requirements ..................................................................... 11 Installing Mainframe Server ......................................................................................... 11 Starting Mainframe Server (TCC) ................................................................................ 12 Stopping Mainframe Server (TCC) .............................................................................. 13 Canceling Mainframe Server (TCC)............................................................................. 13 Using Mainframe Server (TCC) ................................................................................... 13 Getting started using the client ......................................................................................... 14 Starting up the client ..................................................................................................... 14 Retrieving Data ............................................................................................................. 14 Viewing Collected Data.................................................................................................... 18 Catalog Collection Tree ................................................................................................ 19 Graphical Display of Catalog Structure........................................................................ 20 Alias Display................................................................................................................. 21 Data Component Volume Free Space........................................................................... 22 Index Component Volume Free Space ......................................................................... 23 CAS Allocated .............................................................................................................. 24 CAS Properties.............................................................................................................. 25 ListCat Properties.......................................................................................................... 26 Catalog Address Space Performance ............................................................................ 27 Combined Display ........................................................................................................ 28 Database Details................................................................................................................ 29 Tables with their field definitions ..................................................................................... 30 Alias .............................................................................................................................. 30 Catalogs......................................................................................................................... 31 Catalog_Allocated......................................................................................................... 33 Catalog_Properties........................................................................................................ 34 Catalog_Report_Performance....................................................................................... 36 DASD_Volume............................................................................................................. 40 LPAR ............................................................................................................................ 41 Master_UserCatalog ..................................................................................................... 42 System_Info .................................................................................................................. 43 UserCatalogs ................................................................................................................. 44 TCC Server Messages....................................................................................................... 45

Revised: February 28, 2006

2

Printed: February 28, 2006

Copyright (c) 2006 Central Coast Software, LLC. All Rights Reserved

Introduction
This software, z/Catalog Consultant, was created out of a desire to see and monitor, as a whole, the catalog system in IBM 1 ’s OS/390 and z/OS operating system. The catalog system is a vital part of the operating system and whose stability is crucial in areas of performance, the location of data and the proper functioning of the operating system. This software uses a data gathering procedure called “Catalog Collections”. These collections contain point-in-time information about the Catalog Address Space and the individual catalogs. Viewing the catalog system as a whole, allows the catalog administrator to monitor the health of the system from a high level (Catalog Address Space) down to the individual pieces with the end User Catalogs. Also, being able to easily refer to the system at various points-in-time allows for the detection of negative changes within the catalog system so that corrective action may be taken.

Licensing and Support
z/Catalog Consultant is a product of Central Coast Software, LLC. Licensing and support for this software is available at: Web: www.centralcoastsoftware.com Email: info@centralcoastsoftware.com support@centralcoastsoftware.com Voice: 805.542.9308 (U.S.A.)

1

IBM is a registered trademark of the IBM Corporation.

Revised: February 28, 2006

3

Printed: February 28, 2006

Copyright (c) 2006 Central Coast Software, LLC. All Rights Reserved

Overview

Revised: February 28, 2006

4

Printed: February 28, 2006

Copyright (c) 2006 Central Coast Software, LLC. All Rights Reserved

System Requirements
Client • PC running Microsoft Windows 2000, NT or XP • Color Monitor. • Memory: 256 Megabytes minimum, 512 Megabytes recommended. • Disk storage: 10 Megabytes minimum - will increase, as data is stored in database. • TCP/IP connection. Server • IBM Mainframe (or compatible) running os/390 2.8 and later or any release of z/OS. • TCP/IP connection. • Ability to upload in binary format from a PC to the mainframe. • APF Authorized Library. • A PROCLIB (Procedure Library) that is in the search chain when an Operator Start command is issued. • Mainframe userid and password (Mainframe security system will be queried to make sure user is authorized. All security systems that use the IBM security interfaces are supported). • Unix System Services (USS). • No data is stored on the Mainframe however, temporary storage will be used intermittently to generate the data packages.

Revised: February 28, 2006

5

Printed: February 28, 2006

• Mainframe Server. double-click on the setup. The package includes: • Microsoft Windows based client. Client Once activated. using the mouse. Click next to begin Revised: February 28. LLC. 2006 6 Printed: February 28. 2006 . the following screen is displayed. All Rights Reserved Installation Overview The entire package of z/Catalog Consultant is delivered in one compressed file.Copyright (c) 2006 Central Coast Software.exe file to activate the installation process. After placing the compressed file in your directory of choice (c:\Program Files is recommended).

2006 7 Printed: February 28. 2006 . the installation of z/Catalog Consultant will be canceled. All Rights Reserved If agreeable. do not accept the license agreement. LLC. accept the license agreement. If the license agreement is not accepted.Copyright (c) 2006 Central Coast Software. Revised: February 28. If not agreeable.

Revised: February 28. 2006 8 Printed: February 28. All Rights Reserved Enter your name and company and decide if this installation is just for the one user of the computer or for all users. 2006 .Copyright (c) 2006 Central Coast Software. LLC.

Copyright (c) 2006 Central Coast Software. LLC. 2006 9 Printed: February 28. All Rights Reserved This is the last screen before installation starts. Revised: February 28. 2006 . It provides an opportunity to go back and change installation options.

The installation process is now complete. Revised: February 28. 2006 10 Printed: February 28. LLC. 2006 .Copyright (c) 2006 Central Coast Software. All Rights Reserved Click the Finish button to close this screen and launch z/Catalog Consultant.

Pre-allocate a data set on the mainframe using the following attributes: i. Number blocks . 2006 11 Printed: February 28.TCC. . Rrveb.XMIT 3. : FB iii. Any data set name may be used. LOAD. Access to a PROCLIB (Procedure Library) that is available when a START command is issued from an operator console. . . Record format . TCP/IP. 4. Number Blocks . . Unix System Services (USS)/OMVS. Use defaults for the dataset that gets allocated on the mainframe. To install. 2. Preallocate a load library on the Mainframe using the following attributes: a. SYS2. Record length . . : 80 iv. . Record format . . : PS ii. Block size . The transfer must be a binary transfer. 6. : 6144 e. . . All Rights Reserved Mainframe Server Mainframe Server System Requirements 1. do the following: 1. : 3120 v.Copyright (c) 2006 Central Coast Software. do the following: a. Block size . . An APF authorized library. : 375 b. : U c. Number directory blocks : 16 2 r_v_e_b stands for Release_Version_Edition_Build Number Revised: February 28. : 0 d. LLC. . . A suggested name is: i. . . 2006 .xmi” from the z/Catalog Consultant installation directory up to the Mainframe using IND$FILE or FTP. . . If there is trouble using the defaults. . no conversions are to take place. . . . . Upload the file “TCC Binaries Version r_v_e_b 2 . . 3. Record length . . . Mainframe userid and password. All security systems that interface to the standard IBM security interfaces are supported. TCC will query the OS security system to determine if a user is authorized to retrieve TCC data. . : 120 f. Organization . Installing Mainframe Server TCC is currently distributed in a TSO XMIT format within the z/Catalog Consultant distribution (installation) file. Organization . . . . 2. 5. . .10 and above and all levels of z/OS. . Mainframe Operating System: OS/390 2. . : PO b.

6. enter the following command: a. 2006 12 Printed: February 28. Rrveb. INMR901I Dataset SYS2. //TCC PROC //TCC EXEC PGM=TCC. however this can be changed at start-up time or within the TCC PROC. 2006 . Any data set name may be used. 8. TCC will use Port 8080. Rrveb.PARM='PORT=8080' //STEPLIB DD DISP=SHR. Enter the following command: i. Enter the following: a. All Rights Reserved g. If the suggested name was not used. INMR906A Enter restore parameters or 'DELETE' or 'END' + c.TCC. Rrveb.XMIT’) i. Rrveb. Check the operator console log and notice messages being issued that indicate TCC is active. The name here is the suggested name from above. Starting Mainframe Server (TCC) 1. RECEIVE INDSNAME(‘SYS2.Copyright (c) 2006 Central Coast Software. LOAD') 1. 7. 5. b.PARM=’PORT=8085’ 3. Again. Once this command is entered. DSNAME(' SYS2. LLC. In native TSO or ISPF Option 6.TCC. LOAD from your userid on NODENAME ii. LOAD c. LOAD 4.TIME=NOLIMIT. this is the suggested name from above. S TCC. replace this name with the one that was used. replace this name with the one that was used.TCC. place the following JCL: a. To start TCC using the default port number. TCC has now been installed on the Mainframe. enter the following command: a. Rrveb. S TCC 2.TCC.TCC. A suggested name is: SYS2. Note: The port number may be changed to any legitimate port number. replace this name with the one that was used. The messages will look like the following: Revised: February 28. By default. If the suggested name was not used.TCC. LOAD’ or if the suggested name was not used. to start TCC using a different port number. b. In a PROCLIB that is accessible from an operator START command. Or. Rrveb. LOAD.REGION=0K. from an operator console or equivalent.DSN= SYS2. the following message will appear on the screen: i. APF authorize the load library: ‘SYS2. Decide what Port number is to be used by TCC.

TCC can be forced to end by issuing the following command from an operator console or the equivalent: a. * ************************************************** TCC0024I . i. * * All rights reserved. does not allow any data retrieval to complete. d. The benefit to using the STOP command is that it allows current data retrieval to complete before shutting down.TCC Task is shutting down TCC0012I .TCC is executing as a Started Task.TCC Task Starting ************************************************** * Licensed Materials * * Property of Central Coast Software. TCC0010I .54. * * Copyright: 2006.08 TCC0001I . k. c. Central Coast Software.ENDED Canceling Mainframe Server (TCC) 1. j.TCC STOP Command Issued TCC Task Beginning Shutdown TCC0016I .TCC Communication Server Task Starting Up 4. b. enter the following command from an operator console or equivalent: a. IEF403I TCC .TCC STOP Command Issued TCC Task Beginning Shutdown TCC0007I . STOP TCC 2.TCC Communication Server Shutting Down. LLC. Therefore. 3. When the above messages appear. It is recommended that TCC only be cancelled when there is a need to end it immediately. Revised: February 28. f. l.STARTED . Stopping Mainframe Server (TCC) 1. 2006 13 Printed: February 28.Starting TCC Communication Server. h. To stop TCC. c. g. m. CANCEL TCC 2. it may take up to 30 seconds before shutdown indications are noticed. TCC is ready for use. Canceling TCC. g. d. Using Mainframe Server (TCC) Interfacing to TCC is accomplished through the use of the z/Catalog Consultant client. e. f. e. once the STOP command is entered.Build 1_0_0_08 TCC0031I . h. 2006 . • The client user must have a valid Mainframe userid and password. TCC0014I . TCC checks for a stop command every 30 seconds. LLC.TCC Task Now Ending IEF404I TCC . the following must be in place: • The client is using the same port number that TCC was started with. All Rights Reserved a.Copyright (c) 2006 Central Coast Software. b.TIME=18. For a client user to retrieve data from TCC. TCC0012I . The following messages will appear at shutdown time: a. LLC.TCC using Port number: 08085 TCC0008I . TCC0015I .

Selecting The Catalog Consultant. 5. 2006 . At start-up time.Copyright (c) 2006 Central Coast Software. 4. LLC. there will not be any data to display. 2006 14 Printed: February 28. Selecting Central Coast Software. select the Operations menu item. 3. 2. Selecting Launch TCC. To get data into the system. right-mouse-click on Launch TCC and select the menu item Pin to Start menu. It will then be part of the programs displayed when the Windows Start button is selected. Selecting All Programs. Selecting the Windows Start button. All Rights Reserved Getting started using the client Starting up the client After z/Catalog Consultant has been installed. (it is assumed that the TCC server has been installed on the mainframe) the initial client display is as follows: Retrieving Data If this is the first time z/Catalog Consultant is being used. it can be started by: 1. Revised: February 28. To launch z/Catalog Consultant faster.

Password – valid mainframe password. 2006 15 Printed: February 28. 2006 . click on this button to test the connection between the client and the server. and optionally additional data.Copyright (c) 2006 Central Coast Software. The following screen will appear: This is the communications screen. click on this button to actually Revised: February 28. Password.After supplying the UserID. This userid is presented to the mainframe security system along with the password to test whether the user is authorized or not. Port – The port number that the TCC server was started up with. Test Button – After supplying the UserID. IP Address – The mainframe IP Address that the TCC server is running on. it is where data is requested and received from the Mainframe TCC server. IP Address and Port number. This password is presented to the security system along with the userid to determine if the user is authorized or not. IP Address and Port number. Details of the screen layout are as follows: UserID – valid mainframe userid. LLC. Retrieve Data Button . All Rights Reserved and select the Communications sub-menu item. Password.

PERFORMANCE. data retrieval will always retrieve: • Mainframe system information: o Sysplex name. o CPC Type o CPC Model. Information is extracted for each catalog contained within the chain. Once clicked.ALLOCATED. the button will change to a Cancel button to stop the data retrieval process. CAS Allocated – Catalog Address Space Allocated. LLC. 2006 . o Whether under PR/SM or not. o CPC Manufacturer o CPC Sequence Number. This is the information one gets when issuing the operator command F CATALOG. Catalog Properties – This is the information retrieved when scanning the Catalog Address Space Chain of catalogs. All Rights Reserved retrieve data from the TCC server and store the data in the client database.Copyright (c) 2006 Central Coast Software. o Number of LPARS. o System name o LPAR name. Additional Data Retrieval – By default. The following additional information may also be retrieved: ListCat information – This is the information that one gets back when issuing the IDCAMS command: LISTCAT ALLOCATION CATALOG(catalog name). Master Catalog information. • CAS Performance – Catalog Address Space Performance. 2006 16 Printed: February 28. o Name of Master Catalog Usercatalog information. o Date o Time o Operating System. o Names of Usercatalogs attached to the Master Catalog. o Names of LPARs o LPAR operating system where available. • • • • Revised: February 28.REPORT. o CPC Tag Number • LPAR information. This is the information one gets when issuing the operator command F CATALOG.

All Rights Reserved • • Alias’s – List of Aliases pointing to each usercatalog is retrieved.Copyright (c) 2006 Central Coast Software. Activity Log – A log of the actions being taken by z/Catalog Consultant during the retrieval and storing of the requested information. Revised: February 28. 2006 17 Printed: February 28. LLC. Connection Output – This is a display of the requested data in XML format. It is provided as a visual re-assurance that data is being transferred. Volume Free Space – Free space information is retrieved for each volume that a usercatalog resides on. 2006 .

whenever data is retrieved (gotten from the TCC server on the mainframe) it is stored (in the client) based upon: • Sysplex name • System name • LPAR name • Date • Time This provides the ability to look at data based upon where it is located within the mainframe complex. 2006 18 Printed: February 28. All Rights Reserved Viewing Collected Data After data has been retrieved. the client retrieves data from the database keying upon the items mentioned above. Revised: February 28. That is.Copyright (c) 2006 Central Coast Software. The database is Microsoft Access based and located on the client. When it is decided to view the data within the client. 2006 . LLC. The data is stored under a general philosophy of collections. it is stored in various tables of a database.

it will look as follows: Catalog Collection Tree The tree list represents all the collections thus far. Using the mouse to double-click on any of the 3 items will retrieve all the data for that collection. the System name and the LPAR name. 2006 . LLC. select the View menu item and select the sub-menu item Catalog Collections.Copyright (c) 2006 Central Coast Software. Revised: February 28. Depending on how much data you collected. you will now see a tree list of the Catalog Collections. All Rights Reserved To view collected data. 2006 19 Printed: February 28. Each collection is represented by the Sysplex name.

2006 20 Printed: February 28. LLC. By double-clicking on the word Alias. Revised: February 28. a screen. All Rights Reserved After an item is double-clicked. a list of the Aliases pointing to that catalog will be displayed (assuming you selected Alias information to be retrieved for the selected collection). similar to the following appears: Graphical Display of Catalog Structure z/Catalog Consultant graphically displays the Master Catalog and all the Usercatalogs connected to it. 2006 .Copyright (c) 2006 Central Coast Software.

All Rights Reserved If there is Alias information. Revised: February 28.Copyright (c) 2006 Central Coast Software. a floating menu with the following items appears: • Aliases • Data Component Volume Free Space • Index Component Volume Free Space • CAS Allocated • CAS Properties • ListCat Properties Selecting Aliases will display the same information as double-clicking on the Alias word. LLC. 2006 . 2006 21 Printed: February 28. double-clicking the word Alias produces the following result: Alias Display By placing the mouse pointer within any of the catalog boxes and performing a right-mouse-click.

LLC. All Rights Reserved Selecting Data Component Volume Free Space will produce the following display: Data Component Volume Free Space Revised: February 28.Copyright (c) 2006 Central Coast Software. 2006 . 2006 22 Printed: February 28.

All Rights Reserved Selecting Index Component Volume Free Space will produce the following display: Index Component Volume Free Space Revised: February 28.Copyright (c) 2006 Central Coast Software. LLC. 2006 . 2006 23 Printed: February 28.

All Rights Reserved Selecting CAS Allocated will produce the following display: CAS Allocated Revised: February 28. 2006 . 2006 24 Printed: February 28.Copyright (c) 2006 Central Coast Software. LLC.

2006 25 Printed: February 28. All Rights Reserved Selecting CAS Properties will produce the following display: CAS Properties Revised: February 28.Copyright (c) 2006 Central Coast Software. LLC. 2006 .

2006 26 Printed: February 28. LLC.Copyright (c) 2006 Central Coast Software. 2006 . All Rights Reserved Selecting ListCat Properties will produce the following display: ListCat Properties Revised: February 28.

All Rights Reserved Information on the Catalog Address Space can also be displayed by placing the mouse-pointer in any of blank area (has the words.Copyright (c) 2006 Central Coast Software. within it as a watermark). LLC. 2006 . 2006 27 Printed: February 28. Catalog Address Space. This will produce the following display: Catalog Address Space Performance Revised: February 28. right-mouse-clicking and selecting the floating menu item Performance.

All Rights Reserved All these displays can be displayed at once so that whole collection can be viewed as one: Combined Display Revised: February 28.Copyright (c) 2006 Central Coast Software. 2006 . LLC. 2006 28 Printed: February 28.

The tables are: Table Name Alias Catalog Catalog_Allocated Description Table to hold Catalog Alias entries. 2006 . Catalog_Properties Data details of catalogs in the Catalog Address Space. F CATALOG. F CATALOG. All Rights Reserved Database Details A Microsoft Access database is the repository for the data collected by z/Catalog Consultant. System_Info System details. Master_UserCatalog A transient table that gets deleted and recreated repeatedly by z/Catalog Consultant. Output from operator command. Table to hold catalog listcat information. 2006 29 Printed: February 28.Copyright (c) 2006 Central Coast Software. Catalog_Report_Performance Output from operator command. LLC.ALLOCATED.PERFORMANCE DASD_Volume DASD Free space information.REPORT. UserCatalogs Maps Usercatalogs to their Master Catalogs Revised: February 28. It is shipped with 10 empty tables. LPAR LPAR information. used as anchor for catalog collections.

2006 30 Printed: February 28. LLC. Time of record in HH:MM:SS format. Revised: February 28. Name of LPAR Name of catalog containing Alias. Alias name. All Rights Reserved Tables with their field definitions Alias Field Name Date Time Sysplex System LPAR Catalog_Name Alias_Name Related_Catalog Data Type Text Text Text Text Text Text Text Text Data Length 8 8 8 8 8 44 44 44 Description Date of record in YYYYMMDD format. Name of System. 2006 . Name of Sysplex.Copyright (c) 2006 Central Coast Software. Name of catalog Alias points to.

All Rights Reserved Catalogs Field Name Date Time Sysplex System LPAR Creation Expiration BWO_Status BWO_Timestam p BWO Catalog_Data DSpace_Primary DSpace_Second ary DSpace_Type DHigh_ALRBA DHigh_USRBA Data_Percentage _Used DVolume DPhysrecSize DDevType DPhyrecs_per_T rack DTracks_per_CA DNbr_Extents DExtent_Type Data Type Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Data Length 8 8 8 8 8 8 8 8 8 8 44 15 15 8 15 15 5 6 8 15 15 15 15 3 Description Date of record in YYYYMMDD format. 40=The extents are not preformatted. Name of Sysplex. LLC. 80=A sequence set occupies a track adjacent to a control area. 2006 . Time of record in HH:MM:SS format. Name of System.Copyright (c) 2006 Central Coast Software. 2006 31 Printed: February 28. FF=A candidate volume Catalog data component low relative byte address Catalog data component high relative byte address Catalog data component size in tracks Catalog index component name Catalog index component primary allocation amount DLowRBA DHighRBA DTracks Catalog_Index ISpace_Primary Text Text Text Text Text 15 15 15 44 15 Revised: February 28. Name of LPAR Date catalog created Date catalog expires Catalog backup while open status Catalog backup while open time stamp Catalog backup while open flag Catalog data component name Catalog data component primary allocation amount Catalog data component secondary allocation amount Catalog data component type of space allocation Catalog data component high allocated relative byte address Catalog data component high used relative byte address Catalog data component percentage used Catalog data component volume Catalog data component physical record size Catalog data component device type Catalog data component physical records per track Catalog data component number of tracks per control area Catalog data component number of extents Catalog data component type of extent. 00=The extents are contiguous.

2006 32 Printed: February 28. 2006 . LLC. FF=A candidate volume Catalog index component low relative byte address Catalog index component high relative byte address Catalog index component size in tracks ILowRBA IHighRBA ITracks Text Text Text 15 15 15 Revised: February 28. 40=The extents are not preformatted. All Rights Reserved Field Name ISpace_Seconda ry ISpace_Type IHigh_ALRBA IHigh_USRBA Index_Percentag e_Used IVolume IPhysrecSize IDevType IPhyrecs_per_Tr ack ITracks_per_CA INbr_Extents IExtent_Type Data Type Text Text Text Text Text Text Text Text Text Text Text Text Data Length 15 15 15 15 5 15 15 15 15 15 15 3 Description Catalog index component secondary allocation amount Catalog index component type of space allocation Catalog index component high allocated relative byte address Catalog index component high used relative byte address Catalog index component percentage used Catalog index component volume Catalog index component physical record size Catalog index component device type Catalog index component physical records per track Catalog index component number of tracks per control area Catalog index component number of extents Catalog index component type of extent.Copyright (c) 2006 Central Coast Software. 00=The extents are contiguous. 80=A sequence set occupies a track adjacent to a control area.

Copyright (c) 2006 Central Coast Software. If it is higher than one. it might mean that other jobs are using the catalog as a JOBCAT or STEPCAT Catalog DASD Volume The catalog is or is not allocated to the catalog address space The catalog is or is not managed by the Storage Management Subsystem The catalog is or is not using the catalog data space cache (VLF) The catalog is or is not using the in-storage catalog The catalog is or is not closed The catalog has or has not been deleted The catalog is or is not using cross systems sharing The catalog is or is not a tape volume catalog The catalog is or is not shared and is or is not using the Enhanced Catalog Sharing facility The catalog has or has not been locked by an IDCAMS ALTER LOCK or IMPORT LOCK command Percentage of the catalog that is allocated Volser Allocated_To_Ad dress_Space Managed_By_S MS Using_Catalog_ Data_Space_Ca che Using_In_Storag e_Catalog Catalog_Is_Clos ed Catalog_Has_Be en_Deleted Catalog_Using_ Cross_System_S haring Tape_Volume_C atalog Catalog_Is_Shar ed_And_Using_E nh_Cat_Shr_Faci lity Catalog_Is_Lock ed Percentage_Allo cated Text Text Text Text 6 3 3 3 Text Text Text Text 3 3 3 3 Text Text 3 3 Text Text 3 3 Revised: February 28. All Rights Reserved Catalog_Allocated Field Name Date Time Sysplex System LPAR Catalog_Name Nbr_Address_Sp aces_Using Data Type Text Text Text Text Text Text Text Data Length 8 8 8 8 8 50 4 Description Date of record in YYYYMMDD format. LLC. Time of record in HH:MM:SS format. This Catalog Address Space number is normally one. 2006 33 Printed: February 28. 2006 . Name of Sysplex. Name of System. Name of LPAR Name of catalog The number of address spaces that have allocated this catalog.

All Rights Reserved Catalog_Properties Field Name Date Time Sysplex System LPAR Catalog_Name Type Master SystemID Catalog_Locked Close_In_Control Catalog_Managem ent_Invoked Scheduler_Invoke d Catalog_Deleted Recoverable_Catal og ICF_Share_Option ICF_Cat_On_Shar ed_DASD VLF_Cache_Activ e Number_Of_Recor ds Number_Of_Searc hes Number_Records_ Found Number_Records_ Deleted Number_Records_ Updated Number_Records_ Purged Hit_Percentage Catalog_Volser Catalog_UCB_Add ress Catalog_UCB_Typ e Data Type Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Data Length 8 8 8 8 8 44 6 3 8 3 3 3 3 3 3 3 3 3 15 15 15 15 15 15 4 6 8 8 Description Date of record in YYYYMMDD format. Time of record in HH:MM:SS format. 2006 . 2006 34 Printed: February 28. LLC. Name of LPAR Name of catalog Type of Catalog Master Catalog or not System name Catalog locked or not Close processing in effect for catalog Catalog Management Invoked Scheduler Invoked Catalog has been deleted Catalog is recoverable Catalog can be shared Catalog resides on shared DASD Catalog is eligible for VLF Number of records in catalog Number of searches performed on catalog Number of times searches found record in catalog Number of records deleted from catalog Number of records updated in catalog Number of records purged from catalog Percentage of time search found what it was looking for Catalog DASD Volume UCB address of catalog Catalog UCB device type Revised: February 28. Name of System. Name of Sysplex.Copyright (c) 2006 Central Coast Software.

2006 35 Printed: February 28. LLC. All Rights Reserved Field Name Catalog_Device_A ddress Catalog_UCB_Stat us_Online Catalog_UCB_Dev ice_Status_To_Ch ange Catalog_UCB_Dev ice_Status_Is_Res erved Catalog_UCB_Op erator_Unload_Co mmand Catalog_UCB_Dev ice_Is_Allocated Catalog_UCB_Mo unt_Status_Is_Per manently_Residen t Catalog_UCB_Na me Data Type Text Text Text Data Length 4 3 3 Description Catalog UCB device address Catalog UCB online Catalog UCB status is about to change Text 3 Catalog UCB is in a reserved state Text 3 An operator unload command has been issued against this UCB Catalog UCB in an allocated state Catalog UCB mounted permanently resident Text Text 3 3 Text 4 Catalog UCB name Revised: February 28. 2006 .Copyright (c) 2006 Central Coast Software.

2006 . 2006 Printed: February 28. Name of LPAR Number of entries presented to be cataloged Average length of time to catalog an entry Number of shared ENQs issued against a BCS Average length of time for a BCS shared ENQ Number of exclusive ENQs issued against a BCS Average length of time for a BCS exclusive ENQ Number of DEQs issued against a BCS Average length of time taken for a DEQ against a BCS Number of reserves issued against a VVDS CI Average length of time taken for a reserve against a VVDS CI Number of DEQs issued against a VVDS CI Average length of time taken for a DEQ against a VVDS CI Number of shared reserves issued against a VVDS Average length of time taken for a reserve against a VVDS Number of exclusive reserves issued against a VVDS Average length of time taken for an exclusive reserve against a VVDS Number of DEQs issued against a VVDS Average length of time taken for a DEQ against a VVDS Number of exlusive ENQs issued against a Revised: February 28. Name of System. LLC. Time of record in HH:MM:SS format. All Rights Reserved Catalog_Report_Performance Field Name Date Time Sysplex System LPAR Entries_to_Catalog _Count Entries_to_Catalog _Average BCS_ENQ_Shr_C ount BCS_ENQ_Shr_A verage BCS_ENQ_Excl_C ount BCS_ENQ_Excl_A verage BCS_DEQ_Count BCS_DEQ_Averag e VVDS_RESERVE _CI_Count VVDS_RESERVE _CI_Average VVDS_DEQ_CI_C ount VVDS_DEQ_CI_A verage VVDS_RESERVE _Shr_Count VVDS_RESERVE _Shr_Average VVDS_RESERVE _Excl_Count VVDS_RESERVE _Excl_Average VVDS_DEQ_Coun t VVDS_DEQ_Aver age SPHERE_ENQ_E Data Type Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Data Length 8 8 8 8 8 15 15 15 15 15 15 15 15 15 15 15 15 15 15 15 15 15 15 15 36 Description Date of record in YYYYMMDD format.Copyright (c) 2006 Central Coast Software. Name of Sysplex.

Copyright (c) 2006 Central Coast Software. LLC. 2006 . 2006 37 Printed: February 28. All Rights Reserved Field Name xcl_Count SPHERE_ENQ_E xcl_Average SPHERE_DEQ_C ount SPHERE_DEQ_A verage CAXWA_ENQ_Shr _Count CAXWA_ENQ_Shr _Average CAXWA_DEQ_Co unt CAXWA_DEQ_Av erage BCS_Get_Count BCS_Get_Average BCS_Put_Count BCS_Put_Average BCS_Erase_Count BCS_Erase_Avera ge VVDS_I_O_Count VVDS_I_O_Avera ge VLF_Create_Minor _Count VLF_Create_Minor _Average VLF_Retrieve_Min or_Count VLF_Retrieve_Min or_Average VLF_Delete_Minor _Count VLF_Delete_Minor _Average VLF_Define_Major _Count VLF_Define_Major _Average VLF_Identify_Cou Data Type Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Data Length 15 15 15 15 15 15 15 15 15 15 15 15 15 15 15 15 50 15 15 15 15 15 15 15 Description Sphere Average length of time taken for an exclusive ENQ against a Sphere Number of DEQs issued against a Sphere Average length of time taken for a DEQ against a Sphere Number of shared ENQs issued against the Catalog Address Space Average length of time taken for a shared ENQ against the catalog address space Number of DEQs issued against the Catalog Address Space Average length of time taken for a DEQ against the catalog address space Number of gets issued against a BCS Average length of time taken to get a record from a BCS Number of puts issued against a BCS Average length of time taken to put a record in a BCS Number of erases issued against a BCS Average length of time taken to erase a record from a BCS Number of I/O's issued against a VVDS Average length of time taken to perform I/O against a VVDS Number of minor entries created within a Major VLF object Average minor ENQ length of time taken against CAS to create an entry Number of minor entries retrieved from a Major VLF object Average length of time taken to retrieve a minor entry from a Major VLF object Number of major entries deleted from a Major VLF object Average length of time taken to delete a minor entry from a Major VLF object Number of minor entries deleted from a Minor VLF object Number of major entries created for a Major VLF object Number of users identified to VLF Revised: February 28.

LLC. 2006 38 Printed: February 28.Copyright (c) 2006 Central Coast Software. 2006 . All Rights Reserved Field Name nt VLF_Identify_Aver age RMM_Tape_Exit_ Count RMM_Tape_Exit_ Average OEM_Tape_Exit_ Count OEM_Tape_Exit_ Average BCS_Allocate_Co unt BCS_Allocate_Ave rage IXLCONN_Count IXLCONN_Averag e MVS_Allocate_Co unt MVS_Allocate_Av erage Lookup_Pin_UCB_ Count Lookup_Pin_UCB_ Average Unpin_UCB_Count Unpin_UCB_Avera ge Capture_UCB_Co unt Capture_UCB_Ave rage Uncapture_UCB_ Count Uncapture_UCB_A verage RACROUTE_Auth _Count RACROUTE_Auth _Average RACROUTE_Defin e_Count Data Type Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Text Data Length 15 15 15 15 15 15 15 15 15 15 15 15 15 15 15 15 15 15 15 15 15 15 Description Average length of time for a VLF Identify Number of times the RMM Tape Exit invoked Average length of time for taken for the RMM Tape Exit Number of times the OEM Tape Exit invoked Average length of time for taken for an OEM Tape Exit Number of time a BCS was allocated Average length of time for a BCS Allocate Number of times connected to a Coupling Facility Structure Average length of time when connecting to a Coupling Facility Structure Number of MVS Allocates Average length of time for taken for a MVS Allocate Number of UCB Pin lookups Average length of time for taken for an UCB Pin Lookup Number of UCBs unpinned Average length of time for taken to unpin a UCB Number of UCB captures Average length of time to capture a UCB Number of UCB uncaptures Average length of time to uncapture a UCB Number of RACROUTE authorizations Average length of time taken for a RACROUTE authorization Number of RACROUTE defines Revised: February 28.

2006 39 Printed: February 28. 2006 . LLC. All Rights Reserved Field Name RACROUTE_Defin e_Average DADSM_Allocate_ Count DADSM_Allocate_ Average ENQ_SYSZPCCB _Count ENQ_SYSZPCCB _Average DEQ_SYSZPCCB _Count DEQ_SYSZPCCB _Average Data Type Text Text Text Text Text Text Text Data Length 15 15 15 15 15 15 15 Description Average length of time for taken for a RACROUTE Define Number of DADSM allocates performed Average length of time for taken for a DADSM Allocate Number of ENQs issued on name SYSZPCCB Average length of time for taken for a SYSZPCCB ENQ Number of DEQs issued on name SYSZPCCB Average length of time for taken for a SYSZPCCB DEQ Revised: February 28.Copyright (c) 2006 Central Coast Software.

Time of record in HH:MM:SS format. Name of System. Name of LPAR DASD volume volume serial number VTOC Index exist? VTOC Index active Number of free extents on the DASD volume Total number of free cylinders on dasd volume The number of additional free tracks available on the dasd volume in addition to the total free cyclinders on the dasd volume Largest number of contiguous cyclinders on the dasd volume Largest number of contiguous tracks in addition to the largest number of contiguous cyclinders on the dasd volume Number of available Format 0 DSCB's (Data Set Control Blocks) in the VTOC Number of free VTOC Index Records available on the dasd volume Fragmentation index on dasd volume (the higher the number. 2006 . 2006 40 Printed: February 28. Name of Sysplex. the more fragmented it is) Text 6 Text 6 Text Text Text 6 6 6 Revised: February 28. All Rights Reserved DASD_Volume Field Name Date Time Sysplex System LPAR Volser Index_Exists_For_ VTOC Index_VTOC_Activ e Number_Of_Free_ Extents Total_Free_Cylind ers Total_Additional_F ree_Tracks Number_Of_Cylind ers_In_Largest_Fr ee_Extent Number_Of_Additi onal_Tracks_In_La rgest_Free_Extent Format_0_Count Free_VIR_Count Fragmentation_Ind ex Data Type Text Text Text Text Text Text Text Text Text Text Text Data Length 8 8 8 8 8 8 3 3 6 6 6 Description Date of record in YYYYMMDD format.Copyright (c) 2006 Central Coast Software. LLC.

All Rights Reserved LPAR Field Name LPAR Sysplex System Date Time OP_SYS Data Type Text Text Text Text Text Text Data Length 8 8 8 8 8 25 Description Name of LPAR Name of Sysplex Name of System Date of record in YYYYMMDD format. LLC.Copyright (c) 2006 Central Coast Software. 2006 41 Printed: February 28. 2006 . Operating System (May not always be available) Revised: February 28. Time of record in HH:MM:SS format.

Date of record in YYYYMMDD format. All Rights Reserved Master_UserCatalog Field Name UserCatalog MasterCatalog Date Time Sysplex System LPAR_Name Data Type Text Text Text Text Text Text Text Data Length 44 44 8 8 8 8 8 Description User Catalog Name Master Catalog the User Catalog is connected to. Name of LPAR Revised: February 28. LLC. Name of System. 2006 42 Printed: February 28. 2006 . Time of record in HH:MM:SS format. Name of Sysplex.Copyright (c) 2006 Central Coast Software.

Name of System. Date of record in YYYYMMDD format.Copyright (c) 2006 Central Coast Software. 2006 43 Printed: February 28. 2006 . All Rights Reserved System_Info Field Name Sysplex System Date Time OP_SYS LPAR PR_SM Nbr_Of_LPARs CPC_Type CPC_Model CPC_Manufacture r CPC_Sequence_N umber CPC_TAG_Numbe r Data Type Text Text Text Text Text Text Text Text Text Text Text Text Text Data Length 8 8 8 8 25 8 3 4 12 12 12 12 12 Description Name of Sysplex. Time of record in HH:MM:SS format. Operating System Name of LPAR Whether system is running under PR/SM or not Number of LPARs CPC Type CPC Model CPC Manufacturer CPC Sequence Number CPC Tag Number Revised: February 28. LLC.

2006 44 Printed: February 28. 2006 . Date of record in YYYYMMDD format. Name of System.Copyright (c) 2006 Central Coast Software. Name of Sysplex. All Rights Reserved UserCatalogs Field Name UserCatalog MasterCatalog Data Type Text Text Data Length 44 44 Date Text 8 Time Text 8 Sysplex System LPAR_Name Text Text Text 8 8 8 Description User Catalog Name Master Catalog the User Catalog is connected to. LLC. Name of LPAR Revised: February 28. Time of record in HH:MM:SS format.

LLC. Msg Nbr Msg Text Description Action Msg Nbr Msg Text Description Action Msg Nbr Msg Text Description Action Msg Nbr Msg Text Description Action Msg Nbr Msg Text Description Action Revised: February 28. Contact z/Catalog Consultant technical support. it indicates corrupted client software. Provide a valid userid that will be recognized by the mainframe security system. The z/Catalog Consultant Mainframe Server has been started via an operator command and is running as a started task. it should never happen. As this is totally controlled by the client. The z/Catalog Consultant Mainframe Server has been stopped.Copyright (c) 2006 Central Coast Software. No Action required. TCC0006E Invalid login command. TCC0009I TCC is executing as a Batch Job. If it does. TCC0008I TCC is executing as a Started Task. All Rights Reserved TCC Server Messages Msg Nbr Msg Text Description Action Msg Nbr Msg Text Description Action TCC0001I TCC Task Starting. No Action required. TCC0005E User Not Authorized. 2006 . 2006 45 Printed: February 28. The z/Catalog Consultant server has rejected the login command presented to it by the client. The z/Catalog Consultant Mainframe Server has been started. An operator STOP command has been issued for The z/Catalog Consultant Mainframe Server and is in the process of completing any outstanding communication before shutting down. TCC0010I TCC Task is shutting down. TCC0007I TCC Task Now Ending. No Action required. No Action required. A mainframe userid provided to the z/Catalog Consultant client has been rejected by the mainframe security system. No Action required. The z/Catalog Consultant Mainframe Server has been started via a batch job and is running as a batch job.

Issued when the communication server task is starting up. The command is ignored. This message indicates that it is starting the communication server task which performs the communication with the client. The z/Catalog Consultant is starting up. It may take up to 30 seconds after the STOP command is issued before this message is seen. No Action required. Action Msg Nbr Msg Text Description Action Msg Nbr Msg Text Description Action Revised: February 28. All Rights Reserved Msg Nbr Msg Text Description Action Msg Nbr Msg Text Description Action TCC0011I TCC MODIFY Command Accepted. No Action required. Refrain from issuing MODIFY commands to The z/Catalog Consultant. No Action required. 2006 . TCC0012I TCC STOP Command Issued. This message indicates that it has recognized this command and is terminating the TCC started task. TCC0014I Starting TCC Communication Server. An operator command that was nether a MODIFY or STOP command was issued to The z/Catalog Consultant. TCC0016I TCC Communication Server Shutting Down. No Action required.Copyright (c) 2006 Central Coast Software. TCC0015I TCC Communication Server Task Starting Up. An operator STOP command has been issued for The z/Catalog Consultant Mainframe Server and is in the process of shutting down. the client may be used to communicate with it. 2006 46 Printed: February 28. Msg Nbr Msg Text Description Action Msg Nbr Msg Text Description TCC0013E Not MODIFY/STOP Command. LLC. Once this message is issued. No Action required. An operator STOP command has been issued to The z/Catalog Consultant. Currently there are not any MODIFY commands implemented. An operator MODIFY command has been issued for The z/Catalog Consultant Mainframe Server.

it verifies that the port number it will use is syntactically valid. All Rights Reserved Msg Nbr Msg Text Description Action Msg Nbr Msg Text Description TCC0017E Invalid login command structure. it verifies that the port number it will use is syntactically valid. Verify that the port number provided to the TCC Server at start-up time is valid and that it is available for use. it should never happen. check with the systems people in charge of TCP/IP and ask them for a valid port number. During the TCC start-up process. A valid port number is any number between 1 and 65535 however your TCP/IP implementation may only allow a few of these to be used. it indicates corrupted client software. If the port number is valid. The z/Catalog Consultant server recived an indication that a command was sent to it but when it checked. If the port number is valid. Contact z/Catalog Consultant technical support. Verify that the port number provided to the TCC Server at start-up time is valid and that it is available for use. The port number provided was not valid. there was any command. 2006 47 Printed: February 28. Contact z/Catalog Consultant technical support. The z/Catalog Consultant server has rejected the login command presented to it by the client. it should never happen. The port number provided was not valid. As this is totally controlled by the client. TCC0018E No Data Received. LLC. A valid port number is any number between 1 and 65535 however your TCP/IP implementation may only allow a few of these to be used. As this is totally controlled by the client. If it does. TCC0025E Invalid Port number. it indicates corrupted client software. check with the systems people in charge of TCP/IP and ask them for a valid port number. 2006 . During the TCC start-up process. TCC0026E Invalid Port number length. Action Msg Nbr Msg Text Description Action Msg Nbr Msg Text Description Action Revised: February 28. If it does.Copyright (c) 2006 Central Coast Software.

TCC0028E Invalid PARM = value specified. During the TCC start-up process. check with the systems people in charge of TCP/IP and ask them for a valid port number. it verifies that the port number it will use is syntactically valid. it verifies that the port number it will use is syntactically valid. 2006 . The port number provided was not valid. Verify that the port number provided to the TCC Server at start-up time is valid and that it is available for use. A valid port number is any number between 1 and 65535 however your TCP/IP implementation may only allow a few of these to be used. If the port number is valid. Verify that the port number provided to the TCC Server at start-up time is valid and that it is available for use. Correct format would be (for example): S TCC. During the TCC start-up process. Correct the specification of this parm and retry the command. check with the systems people in charge of TCP/IP and ask them for a valid port number.PARM=”PORT=8085” TCC0029E Invalid Port Number. The START command issued to activate the z/Catalog Consultant contained a PARM= value that was not valid. Currently the only PARM= value supported is the PORT= value. All Rights Reserved Msg Nbr Msg Text Description Action TCC0027E Invalid Port number length. The port number provided was not valid. During the TCC start-up process. 2006 48 Printed: February 28. If the port number is valid. it verifies that the port number it will use is syntactically valid. LLC. Verify that the port number provided to the TCC Server at start-up time is valid and that it is available for use. check with the systems people in charge of TCP/IP and ask them for a valid port number. TCC0030E Invalid Port Number. Msg Nbr Msg Text Description Action Msg Nbr Msg Text Description Action Msg Nbr Msg Text Description Action Revised: February 28. A valid port number is any number between 1 and 65535 however your TCP/IP implementation may only allow a few of these to be used. The port number provided was not valid.Copyright (c) 2006 Central Coast Software. A valid port number is any number between 1 and 65535 however your TCP/IP implementation may only allow a few of these to be used. If the port number is valid.

A valid port number is any number between 1 and 65535 however your TCP/IP implementation may only allow a few of these to be used. it tries to bind to the port number provided to it via the TCC started task. retry command. retry the client data retrieval command. If there is till a failure. retry command. All Rights Reserved Msg Nbr Msg Text Description Action Msg Nbr Msg Text Description TCC0031E TCC using Port number: During the TCC start-up process. The z/Catalog Consultant mainframe server was unable to generate this report. Verify that the port number provided to the TCC Server at start-up time is valid and that it is available for use. The z/Catalog Consultant mainframe server was unable to generate this report. The binding to this port number failed. contact technical support. check with the systems people in charge of TCP/IP and ask them for a valid port number. Check Mainframe log for error conditions. TCC0032E Unable to bind to Port. Check Mainframe log for error conditions. TCC shuts down. The report is generated via a command from the client. If no errors. Action Msg Nbr Msg Text Description Action Msg Nbr Msg Text Description Action Revised: February 28. During the communication server start-up process. TCC0036E Generation of System Information payload failed. 2006 . retry the client data retrieval command. If no errors. This message indicates that the port number is syntactically valid and is being presented to the communication server for use. If there is till a failure. The report is generated via a command from the client. No Action required. 2006 49 Printed: February 28. TCC0035E Generation of Catalog Report failed. If no error messages are found and the server appears to be still executing normally. If the port number is valid. Check the server to make sure it is still active and look for any error messages issued there. If no error messages are found and the server appears to be still executing normally. it verifies that the port number it will use is syntactically valid. Check the server to make sure it is still active and look for any error messages issued there. LLC.Copyright (c) 2006 Central Coast Software. contact technical support.

LLC. If no errors. The report is generated via a command from the client. If there is till a failure. If there is till a failure. 2006 . Check Mainframe log for error conditions. Check the server to make sure it is still active and look for any error messages issued there. Check the server to make sure it is still active and look for any error messages issued there. contact technical support. retry command. retry command. The z/Catalog Consultant mainframe server was unable to generate this report. contact technical support. If no errors. 2006 50 Printed: February 28. TCC0039E Generation of Test payload failed.Copyright (c) 2006 Central Coast Software. contact technical support. If there is till a failure. contact technical support. The report is generated via a command from the client. retry the client data retrieval command. retry the client data retrieval command. retry command. Check the server to make sure it is still active and look for any error messages issued there. If no error messages are found and the server appears to be still executing normally. The report is generated via a command from the client. The z/Catalog Consultant mainframe server was unable to generate this report. Check Mainframe log for error conditions. TCC0040E Generation of Master Catalog name failed. The z/Catalog Consultant mainframe server was unable to generate this report. retry the client data retrieval command. The report is generated via a command from the client. If no errors. If no error messages are found and the server appears to be still executing normally. retry command. Check Mainframe log for error conditions. Check Mainframe log for error conditions. If no error messages are found and the server appears to be still executing normally. All Rights Reserved Msg Nbr Msg Text Description Action TCC0037E Generation of Operator Command payload failed. Msg Nbr Msg Text Description Action Msg Nbr Msg Text Description Action Msg Nbr Msg Text Description Action Revised: February 28. retry the client data retrieval command. The z/Catalog Consultant mainframe server was unable to generate this report. If there is till a failure. If no errors. Check the server to make sure it is still active and look for any error messages issued there. If no error messages are found and the server appears to be still executing normally. TCC0038E Generation of IDCAMS payload failed.

LLC. The z/Catalog Consultant mainframe server was unable to generate this report. Check the server to make sure it is still active and look for any error messages issued there. 2006 51 Printed: February 28. contact technical support. The report is generated via a command from the client. Check Mainframe log for error conditions. The z/Catalog Consultant mainframe server was unable to generate this report. Check Mainframe log for error conditions. retry command. The report is generated via a command from the client. TCC0042E Generation of free space information failed. If no error messages are found and the server appears to be still executing normally. All Rights Reserved Msg Nbr Msg Text Description Action TCC0041E Generation of ListCat for a catalog failed.Copyright (c) 2006 Central Coast Software. If there is till a failure. Check the server to make sure it is still active and look for any error messages issued there. retry command. If no errors. Msg Nbr Msg Text Description Action Revised: February 28. 2006 . If no errors. If there is till a failure. contact technical support. retry the client data retrieval command. retry the client data retrieval command. If no error messages are found and the server appears to be still executing normally.

Sign up to vote on this title
UsefulNot useful