vsum for z/os 5.2.1 program description and operations

VSUM FOR z/OS

VSAM Analysis Tool

Program Description and Operations Guide

Release 5.2.1

VSUM offers powerful design, monitoring, and tuning capabilities for VSAM catalogs and datasets

• With VSUM, time spent scanningVSAM catalog listings andperforming complex spacecalculations for new and existingdata sets is greatly reduced, savingpersonnel hours of valuable time.

• VSUM can be executed eitherONLINE, using an ISPF interface,or by BATCH.

• VSUM provides five functionsthat simplify many of the routineand complex tasks necessary foreffective VSAM dataset designand management:

— An extended catalog search/list function provides intelligent search capabilities based on over 100 individual catalog search parameters.

— A dataset modeling and design feature provides a simpler and more effective way to design all types of VSAM datasets. It includes support for SMS-controlled files and extended addressing.

— A dataset recommendations feature provides tuning and design recommendations for

datasets being listed or analyzed.

— A dataset space-utilization analysis and backup option can interrogate a complete or user-specified part of a VSAM dataset, providing many valuable statistics.

— Batch dataset analysis reports can be generated from statistics VSUM can save.

• Compatible with z/OS 2.2 through2.4.

ii

Copyright © 2020 by Connectivity Systems, Inc.

All Rights Reserved

RESTRICTED RIGHTS LEGEND

Use, duplication, or disclosure by the Government is subject to the restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013. This material contains confidential and proprietary material of Connectivity Systems, Inc. (hereafter referred to as CSI International and CSI) and may not be used in any way without written authorization from CSI International. This material may not be reproduced, in whole or in part, in any way, without prior written permission from CSI International.

Permission is hereby granted to copy and distribute this document as follows:

• Each copy must be a complete and accurate copy.

• All copyright notices must be retained.

• No modifications may be made.

• Use of each copy is restricted to the evaluation and/orpromotion of the VSUM FOR Z/OS product from CSIInternational or in accordance with a license agreement.

VSUM FOR z/OS Program Description and Operations GuideRelease 5.2.1

September 2020

Published by CSI International

Phone: 800-795-4914 Email: [email protected] Internet: http://www.csi-international.com

mailto:[email protected]

http://www.csi-international.com/

iii

Monday through Friday, 9:00 A.M. through 5:00 P.M. EST/EDT:

Telephone: Toll Free in the USA Worldwide

800-795-4914740-420-5400

Email: [email protected]

Web: http://csi-international.com/problemreport_zos.htm

After business hours and 24 hours on Saturday and Sunday. Calls are routed based on issue severity.

Telephone: Toll Free in the USA Worldwide:

800-795-4914740-420-5400

During Business Hours

Emergency Service 24/7

CSI International Technical Support

iv

Contents

Chapter 1. Getting Started ...................................................................................... 1

Introduction ............................................................................................................. 1 VSUM Features ...................................................................................................... 3 Batch Command Syntax ......................................................................................... 5 Summary of Recent Changes .................................................................................. 9 Batch Execution .................................................................................................... 10 ISPF Execution ..................................................................................................... 13 Installation ............................................................................................................ 14

Chapter 2. Catalog List/Search ............................................................................. 20

Overview............................................................................................................... 20 Suggested Uses ..................................................................................................... 21 Command and ISPF Input .................................................................................... 22 Examples of Use ................................................................................................... 53 Output Examples and Descriptions ...................................................................... 57

Chapter 3. Dataset Analyze/Backup ...................................................................... 86

Overview............................................................................................................... 86 Suggested Uses ..................................................................................................... 88 Command and ISPF Input .................................................................................... 89 Examples of Use ................................................................................................. 104 Output Examples and Descriptions .................................................................... 106

Chapter 4. Dataset Modeling .............................................................................. 122

Overview............................................................................................................. 122 Suggested Uses ................................................................................................... 124 Command and ISPF Input .................................................................................. 125 Examples of Use ................................................................................................. 137 Output Example and Descriptions ...................................................................... 139

Chapter 5. Dataset Recommendations ................................................................. 146

Overview............................................................................................................. 146 Suggested Uses ................................................................................................... 147 Command and ISPF Input .................................................................................. 148 Examples of Use ................................................................................................. 154 Output Examples and Descriptions .................................................................... 156

VSUM FOR z/OS Program Description and Operations Guide Table of Contents

v

Chapter 6. Reprint of Reports ............................................................................. 165

Overview............................................................................................................. 165 Suggested Uses ................................................................................................... 166 Command Input .................................................................................................. 167 Examples of Use ................................................................................................. 174 Output Examples and Descriptions .................................................................... 176

Chapter 7. Messages and Codes .......................................................................... 177

Appendix A. Statistical Files .................................................................................. 210

Appendix B. Command/Parameter Abbreviations ................................................. 213

Index. ... ....................................................................................................... 219

1

1 Getting Started

Introduction

VSUM provides powerful design, monitoring, and tuning capabilities for MVS VSAM catalogs and datasets. VSUM provides five major functions that will simplify many of the routine and complex tasks necessary for effective VSAM dataset design and management. VSUM can be executed in either TSO/ISPF or batch mode.

Reports

TSO/ISPF

Saved Stats

TSO/ISPF

Batch Job Dataset Design

Dataset Space Analysis

Intelligent Catalog List

Dataset Design

Dataset Design

VSUM FOR z/OS Program Description and Operations Guide Getting Started

2

The five major functions of VSUM are

• An extended catalog search/list function to provide intelligent search capabilities based on over 100 individual catalog search parameters

• A dataset modeling and design feature to provide a simpler and more effective method for designing all types of VSAM datasets

• A dataset recommendations feature which will make tuning and design recommendations for datasets being listed or analyzed

• A dataset space utilization analysis and backup option to interrogate a complete or user-specified part of a VSAM dataset and produce a variety of valuable statistics

• Batch dataset analysis reports can be generated from statistics that can optionally be saved by VSUM

VSUM will save your personnel many hours of valuable time. The hours spent scanning VSAM catalog listings and performing complex space calculations for new and existing datasets will be greatly reduced. Improved DASD space utilization and job run performance improvements will be achieved through the efficient design and tuning of existing datasets.


3

VSUM Features

CATALOG LIST/SEARCH allows searching and listing of catalog entries based on dataset names, type, attributes, and parameter thresholds with conditional values. This feature gives VSAM system programmers or DASD management personnel the flexibility of setting up VSAM dataset design criteria by installation, and performing selective catalog searches listing VSAM dataset not conforming to design objectives. VSUM also generates easy to read catalog lists of VSAM datasets with optional design and space utilization recommendations. Catalog statistics can be saved for reprinting later, which gives the ability to evaluate dataset design changes over a specified period. For CICS users or users of VSAM’S LSR/GSR buffer options there is also an option to print a control interval size/buffer report. This report will greatly assist systems programmers with the LSR/GSR buffer pool calculations.

MODELING allows experimentation with dataset desn parameters without performing an IDCAMS DEFINE or requiring the DASD space. A VSAM KSDS, ESDS, RRDS, or AIX dataset can be described and a printout of space requirements, record statistics, design warnings, and IDCAMS DEFINE parameters can be obtained. The IDCAMS DEFINE parameters can be written to a sequential or partitioned dataset. Dataset space requirements can be specified in cylinders, tracks, or records. Freespace can be specified as a percentage of bytes or free records. The data control interval size can be specified or VSUM will determine the best control interval size based on a processing mode of DIRECT, SEQUENTIAL, or MIXED. The index control interval size will be calculated by VSUM and may be influenced by the specification of a compressed key length. For VSAM AIX datasets the maximum number of duplicate keys can be specified and VSUM will calculate the maximum record size and minimum buffer space required. The MODELING feature of VSUM is a powerful dataset design tool that will pay for itself many times over through improved programmer productivity and efficient dataset design.

ANALYZE provides accurate space utilization analysis of keyed VSAM datasets and catalogs. Keyed VSAM datasets can be optionally backed-up during the space analysis process. This feature is very helpful for analyzing problem VSAM datasets that require more space than expected, are poor performers, or have a large number of control interval-control area splits. VSUM will show that keys are compressing poorly resulting in the loss of valuable space in the data component due to the size of the index control interval. Control area and control interval freespace percentages can be evaluated.

Control area space utilization can be graphed, showing immediately where control area splits have occurred. The graph will also show if data control intervals have been lost due to poor key compression or to an

CATALOG LIST/SEARCH

MODELING

ANALYZE


4

insufficient index control interval size. The reports will show if index control intervals are too large and wasting valuable buffer storage.

The number of free records in the dataset or within a specified keyrange can be estimated for dataset growth analysis. The high and/or low keys can be listed within a dataset, within selected control areas or control intervals which can be helpful in determining dataset keyrange definitions.

RECOMMENDATIONS can be specified when performing a CATALOG SEARCH/LIST, an ANALYZE of a dataset, or when REPRINTING dataset statistics from a VSUM statistical file. Recommendations can be made for VSAM KSDS, ESDS, RRDS, or AIX datasets. The types of recommendations that VSUM will make are on dataset attributes, buffer requirements based upon a processing mode, freespace recommended, control interval size, reorganization recommendations, and space requirements for a new or existing device types.

REPRINT allows catalog lists and dataset analysis reports to be reprinted from a VSUM statistical dataset for evaluation of dataset trends and design changes. This function is not supported by the VSUM ISPF interface and can only be performed in batch mode.

RECOMMENDATIONS

REPRINT


5

Batch Command Syntax

VSUM command syntax is a command and keyword format specified in the SYSIN DD statement. Command data can be placed anywhere within positions 1–71 of an input statement.

COMMAND KEYWORD KEYWORD,KEYWORD(SUBPARAMETERS),KEYWORD

Comments can be specified on separate statements and must begin with an asterisk (*) in position 1. They can be positioned between commands or within incomplete command statements.

0 77 Example: 1..............................................12 MODEL NAME(dsname) TYPE(AIX) - * COMMENT RECORDS(2000) RECSIZE(100)

End of a command is explicitly specified by placing a semicolon (;) as the last character of a command statement, or implicitly by the absence of the continuation character (-).

0 77 Example: 1..............................................12 LIST NAME(dataset) TYPE(KSDS) CAT(YOURCAT)- IMBED

Continuation of a command on another statement is accomplished by placing a dash (-) after a complete KEYWORD or SUBPARAMETER within positions 1–71. The next keyword or subparameter can start anywhere on the next statement within positions 1–71.

0 77 Example: 1..............................................12 ANALYZE NAME(dataset) DSREPORT (YES,SAVE), - CAREPORT (YES,EMPTY,NOSAVE)

Continuation of an incomplete keyword or subparameter onto another statement is accomplished by placing a non-blank character in position 72 and continuing the incomplete keyword or subparameter in column 1 of the next statement. Comments are not allowed between incomplete keyword or subparameter statements.

Comments

End of a Command

Continuation of a Command

Continuation of an Incomplete Keyword


6

0 77 Example: 1..............................................12 ANALYZE NAME(dataset) DSREPORT (YES,SAVE),CAREx PORT (YES,EMPTY,NOSAVE)

Separation of commands, keywords, and subparameters is by one or more blanks, a comma, or a comma and one or more blanks. Keyword subparameters must be enclosed in parenthesis if more than one subparameter is specified. Keywords with one subparameter can be specified in parentheses or separated by an equal (=) sign. Keywords identified as positional will require a comma (,) in place of a null subparameter if a subsequent subparameter is to be specified. Keywords not identified as positional are free-form and will not require a comma in place of null (not specified) subparameters.

0 77 Example: 1..............................................12 COMMAND KEYWORD KEYWORD,KEYWORD, KEYWORD(,X)- KEYWORD(X)

Most parameters have abbreviations or alternate spellings available. These are listed completely in Appendix B: Command/Parameter Abbreviations, but the more common ones are included with each parameter description. Also, mutually exclusive parameters and default values, if any, are described with each parameter.

dsname is a valid, fully qualified dataset name.

partial dsname is a partially qualified dataset name.

catname is a valid VSAM catalog name.

ddname is a valid DD name.

number is a valid numeric string within the range.

qstring is a valid quoted string that can be in character 'ccc' or hexadecimal x'hhhh'. A single quote within the string can be specified by entering two single quotes.

Separators

Abbreviations and Alternate Spellings

Subparameter Descriptions


7

string is a valid character string not in quotes.

volser is a valid volume serial number.

pct is a valid numeric percent from 1 to 100.

:cond is a conditional operator that can be

:EQ – equal :NE – not equal :LT – less than :LE – less than or equal :GT – greater than :GE – greater than or equal

/updatepw is a valid VSAM update password.

/cntlpw is a valid VSAM control password.

/masterpw a valid VSAM master password.

SCAN OFF|ON

This command specifies whether VSUM commands will be syntax checked and not executed, or syntax checked and executed.

OFF All subsequent VSUM commands will be syntax checked and executed.

ON All subsequent VSUM commands will only be checked for syntax errors but will NOT be executed.

SCAN Command


8

PARM NOABEND|ABEND

This command specifies whether an abend dump will be issued when a severe VSUM, operating system, or VSAM catalog error is encountered.

NOABEND When a severe VSUM, operating system, or VSAM catalog error occurs during VSUM command processing, a descriptive VSUM message is printed, the command is terminated with condition code 12, and the next VSUM command is processed.

ABEND When a severe VSUM, operating system, or VSAM catalog error occurs during VSUM command processing, a descriptive VSUM message is printed, the VSUM step is terminated with U012 abend. No subsequent VSUM commands are processed. A “SYSUDUMP” or “SYSABEND” DD statement is required for dump output.

PARM Command


9

Summary of Recent Changes

Support for the years 2000 and above.

Fix integration.

Addition of device support.

Secondary allocation parameter added to MODEL command.

Fix integration.

Addition of a modeling parameter, ALLCISIZES. This permits reports for all possible control interval sizes to be produced from one request.

Documentation update: Release 3.2 and 3.3 new features are included, and common abbreviations for parameters have been added to the parameter description text sections.

3390 disk support.

Automatic calculation of max record size on ISPF AIX Design.

Automatic generation of Define Path when doing an AIX Design.

Secondary allocations may be calculated automatically based on a percentage of the primary allocation. This requires a zap to be implemented.

3380 Model K drives (triple density) are supported for dataset designing/modeling.

New physical block sizes from .5K to 8K (in .5 increments), and continue from 8K to 32K in 2K increments (only for DFP 2.2.0 or higher releases).

New index CI size support from .5K to 8K (in .5 K increments) and 8K to 32K in 2K increments (only for DFP 2.2.0 or higher releases).

Release 4.0

Release 3.4

Release 3.3

Release 3.2

Release 3.1


10

Batch Execution

VSUM batch execution is easy to set up and requires the following minimum and optional JCL.

The COMMAND and PARAMETERS(S) that are specified by the user indicate the VSUM function and associated processing options to be performed. Refer to each functional section in the manual for the proper command and parameter syntax. Depending on the command and optional parameters specified, there may be other JCL requirements such as CAREPORT DD statement for the “ANALYZE CAREPORT(...)” command. Other DD statements that may be required are listed in the section “Optional DD Statements” (page 11).

//JOBNAME JOB ...... //STEPNAME EXEC PGM=VSUM,REGION=300K //* REGION=300K for LIST function. //* 300K-500K for LIST ANALYZE function. //* 500K-1000K for ANALYZE function. //* 1000K for ANALYZE function with backup. //* The virtual storage requirement //* depends on the control interval //* size of the input dataset and //* how many control intervals read //* with rpl chaining. //STEPLIB DD DSN=PROD.VSUM.R51.LOADLIB,DISP=SHR //SYSPRINT DD SYSOUT=* //SYSIN DD * COMMAND PARAMETER ,.... /*


11

Optional DD Statements

//* A N A L Y Z E F U N C T I O N //CAREPORT DD SYSOUT=A *required with CAREPORT=YES //CAGRAPH DD SYSOUT=A *required with CAGRAPH=YES //KRREPORT DD SYSOUT=A *required with KRREPORT pecified //CIREPORT DD SYSOUT=A *required with CIREPORT=YES //BKUPDD DD DSN=backup.dataset,DISP=OLD //BKERDD DD DSN=backup.error.dataset,DISP=OLD //CASTATS DD DSN=VSUM.CASTATS,DISP=OLD * required with //* CAREPORT/CAGRAPH=SAVE //DSSTATS DD DSN=VSUM.DSSTATS,DISP=OLD * required with //* DSREPORT=SAVE //* L I S T F U N C T I O N //BUFPRINT DD SYSOUT=A * required with BFFERTABLE(ACCUM //* or PRINT) //DSSTATS DD SYSOUT=A * required with SAVE //* M O D E L F U N C T I O N //DEFOUT DD DSN=IDCAMS.DEFINE.OUTPUT,DISP=SHR *required //* with DEFOUT //* R E P R I N T F U N C T I O N //CAREPORT DD SYSOUT=A *required with CAREPORT=YES //CAGRAPH DD SYSOUT=A *required with CAGRAPH=YES //KRREPORT DD SYSOUT=A *required with KRREPORT specified //CIREPORT DD SYSOUT=A *required with CIREPORT=YES //CASTATS DD DSN=VSUM.CASTATS,DISP=OLD * required with //* CAREPORT/CAGRAPH=YES //DSSTATS DD DSN=VSUM.DSSTATS,DISP=OLD * required with //* DSREPORT=YES


12

DDNAME COMMAND(S) WHERE USED PROGRAM DCB INFO ------ --------------------- ---------------- RECFM LRECL BLKSIZE ----- ----- ------- BKUPDD ANALYZE VB *BL-8 *BL BKERDD ANALYZE VB *BL-8 *BL BUFPRINT LIST FBA 133 CAGRAPH ANALYZE,REPRINT FBA 133 CAREPORT ANALYZE,REPRINT FBA 133 CASTATS ANALYZE,REPRINT VB 5496 5500 CIREPORT ANALYZE,REPRINT FBA 133 DEFOUT MODEL FB 80 DSSTATS ANALYZE,LIST,REPRINT VB 5496 5500 KRREPORT ANALYZE,REPRINT FBA 133 SYSIN ALL COMMANDS 80 SYSPRINT ALL COMMANDS FBA 133 *BL = maximum block size specified in JCL or if not specified: 32760 TAPE 32760 3390, 3380, 3375 19069 3350 8368 3340 13030 3330

DDNAME-DCB Information Chart


13

ISPF Execution VSUM ISPF execution is possible after the VSUM selection has been added to your installation’s primary option menu. When this has been done and the VSUM ISPF libraries have been added to your installation TSO LOGON procedure, you can execute VSUM by selecting “V” from your ISPF primary option menu. This will display VSUM’s PRIMARY OPTION MENU listed below. From this menu you can select which VSUM function you want to perform.

Alternatively, you can execute directly from the VSUM CLIST dataset. Edit the CLIST member VSUMRUN to supply the dataset names for the files you restored from Step 4 on the Installation Checklist. VSUMRUN contains the following SET statements, which must be edited:

SET VSCLST=<vsum.clist.library.dsn> SET VSLODL=<vsum.load.library.dsn> SET VSPANL=<vsum.panel.library.dsn> SET VSMESG=<vsum.message.library.dsn> SET VSSKEL=<vsum.skeleton.library.dsn> SET VSTABL=<vsum.table.library.dsn>

After these edits are saved, you can execute this CLIST directly. Here is an example ISPF command to activate VSUM and display the PRIMARY OPTION MENU:

TSO EXEC 'TEST.VSUM.CLIST(VSUMRUN)'

------------------------ VSUM - PRIMARY OPTION MENU ---------------------------- COMMAND ==> L - SEARCH AND LIST VSAM CATALOG(S) - <<< EXTENDED LIST >>> D - DESIGN AND ALLOCATE VSAM DATASET(S) A - ANALYZE VSAM KSDS OR AIX DATASET(S) P - PROFILE UPDATE


14

Installation

This section describes how to install the VSUM product. VSUM was designed with ease of installation in mind, and it is a self-contained software package. No changes to any IBM component are required.

You can download VSUM directly from CSI’s website. The steps necessary to upload the software to your z/OS system are listed below.

The following can be used as a checklist for each step of the VSUM product installation. Each step listed here corresponds to a step of the same number described in detail in the pages that follow.

___ STEP 1: Contact a CSI Account Representative.

___ STEP 2: Download the VSUM zip installation file from the CSI International website.

___ STEP 3: Transfer the seven VSUM software files to temporary sequential datasets.

___ STEP 4: Receive and restore each of the seven sequential datasets into the corresponding PDSs.

___ STEP 5: View and apply any applicable fixes from the CSI International website.

___ STEP 6: Install the VSUM product key.

___ STEP 7: Define-allocate VSUM statistical files (optional).

___ STEP 8: Modify your TSO logon PROC(s) to include VSUM ISPF datasets.

___ STEP 9: Add the VSUM option to your ISPF menu.

___ STEP 10: Execute the installation verification procedure (USERIVP).

___ STEP 11: Execute VSUM option and functions from ISPF.

___ STEP 12: Prepare and execute VSUM batch mode requests.

Contact a CSI Account Representative at 800-795-4914 or [email protected] to obtain an account number and a product key.

Using the account number, download the VSUM zip installation file from the CSI International website at the following address:

http://www.csi-international.com/products/zOS/VSUM/VSUM.htm

Installation Checklist

Step 1

Step 2

mailto:[email protected]

http://www.csi-international.com/products/zOS/VSUM/VSUM.htm


15

The VSUM download zip file contains the following:

• VSUM software files

• Documentation PDFs for VSUM

• Documentation on how to transfer software to your z/OS system

• Documentation on product keys

Transfer the seven VSUM software files to temporary sequential datasets on your z/OS system. These datasets should be FB, LRECL 80, and BLKSIZE 3120 (or larger).

The included MvsUploadInstrMovableFiles PDF explains in more detail how to accomplish this transfer.

These distribution files were created with the XMIT function. Use the RECEIVE function from the ISPF Option 6 panel to receive and restore each of the seven sequential datasets into the corresponding PDSs.

The following are the VSUM software files included:

1. VSUM Load Library:

Content: All VSUM batch and ISPF load modules. Filename: VSUM.LOADLIB Format: PDS,RECFM=U,BLKSIZE=23476 (or larger) 3390: 1 Cylinder, 10 directory blocks

If you plan to analyze VSAM catalogs, the VSUM loadlib must be APF authorized.

2. VSUM Control Library:

Content: Product key members, installation verification procedure, ASSEMBLER DSECTS,SAS examples.

Filename: VSUM.INSTALL Format: PDS,RECFM=FB,LRECL=80,BLKSIZE=3200 (or larger) 3390: 3 Tracks, 2 directory blocks

3. VSUM ISPF Panel Library:

Content: All VSUM ISPF panels. Filename: VSUM.PANEL Format: PDS,RECFM=FB,LRECL=80,BLKSIZE=3200 (or larger) 3390: 3 Cylinders, 65 directory blocks

Step 3


16

4. VSUM ISPF Message Library:

Content: All VSUM ISPF messages. Filename: VSUM.MESSAGE Format: PDS,RECFM=FB,LRECL=80,BLKSIZE=3200 (or larger) 3390: 2 Tracks, 3 directory blocks

5. VSUM ISPF CLIST Library:

Content: All VSUM ISPF CLISTs. Filename: VSUM.CLIST Format: PDS,RECFM=FB,LRECL=80,BLKSIZE=3200 (or larger) 3390: 1 Track, 2 directory blocks

6. VSUM ISPF Skeleton Library:

Content: All VSUM ISPF Skeletons. Filename: VSUM.SKELETON Format: PDS,RECFM=FB,LRECL=80,BLKSIZE=3200 (or larger) 3390: 3 Tracks, 2 directory blocks

7. VSUM ISPF Table Library.

Content: All VSUM ISPF Tables. Filename: VSUM.TABLE Format: PDS,RECFM=FB,LRECL=80,BLKSIZE=3200 (or larger) 3390: 1 Track, 1 directory block

View and apply any applicable fixes from the CSI International website support page at the following address:

http://www.csi-international.com/support.htm

Install the VSUM product key. A sample member $INSTKEY is included in the VSUM.INSTALL PDS.

The process to install the product key is explained in the included INSTKEY PDS member and on the CSI website at the following address:

http://www.csi-international.com/authcodes/Product Keys in zOS.pdf

Optionally, define statistical files. If you are planning to use the historical statistical facility VSUM provides, two (2) statistical files must be allocated to contain the historical VSUM data. This is optional and may be implemented at any time. The two datasets are

//DSSTATS DD ........ //CASTATS DD ........

Step 5

Step 6

Step 7

http://www.csi-international.com/support.htm

http://www.csi-international.com/authcodes/Product%20Keys%20in%20zOS.pdf


17

These files can be defined as QSAM (variable blocked) or as a VSAM ESDS.

The following DCB or VSAM ESDS information should be used as a reference for creating the historical files.

QSAM: RECFM=VB,LRECL=5496, | ESDS: DEFINE CLUSTER BLKSIZE=5500 | RECSZ (600 5492)

Space requirements for the statistical files will vary according to which user datasets and VSUM reports are selected for processing. Refer to the chart below for estimates of space requirements.

FILE FUNCTION:PARM(S) SELECTED RECORDS WRITTEN DSSTATS ANALYZE: DSREPORT 1 DSRECORD per dataset LIST: SAVE 1 DSRECORD per dataset CASTATS ANALYZE: CAGRAPH/CAREPORT 1 DSRECORD per dataset 1 CARECORD per CA ANALYZE: CIREPORT 1 CIRECORD per CI RECORD SIZES DSRECORD 5492 bytes (maximum) CARECORD 92 bytes + (Keylen * 2) CIRECORD 66 bytes + (Keylen * 2)

NOTE: The CIREPORT can generate many records if you request to save control interval statistics for a large dataset or large number of control areas.

To use the VSUM ISPF interface, you can either edit the supplied VSUMRUN member of the CLIST library, or add or concatenate all the VSUM ISPF libraries to your current TSO logon procedure.

Edit the VSUMRUN member according to the instructions within it. You will be modifying the SET statements to supply the dataset names that you used for VSUM libraries. Then, run the VSUMRUN in ISPF to start the interface. An example of an ISPF primary command to do this is:

TSO EXEC 'TEST.VSUM.CLIST(VSUMRUN)'

You can also copy VSUMRUN into a CLIST library already in the TSO startup concatenation. In that case, all that is necessary to run the VSUM interface is the command:

TSO VSUMRUN

If you choose to add or concatenate instead of using VSUMRUN, see the figure below for the logon procedure DDNAMEs that are affected. The VSUM DSNAME shown assumes the convention in Step 3 has been

Step 8


18

followed, but if not, use the corresponding data set name that you assigned.

DDNAME VSUM DSNAME TO BE CONCATENATED SYSPROC ****.VSUM.CLIST RECFM=FB,LRECL=80,BLKSIZE=800 ISPLLIB ****.VSUM.LOADLIB RECFM=U,LRECL=0,BLKSIZE=6144 ISPPLIB ****.VSUM.PANEL RECFM=FB,LRECL=80,BLKSIZE=3120 ISPMLIB ****.VSUM.MESSAGE RECFM=FB,LRECL=80,BLKSIZE=3120 ISPSLIB ****.VSUM.SKELETON RECFM=FB,LRECL=80,BLKSIZE=3120 ISPTLIB ****.VSUM.TABLE RECFM=FB,LRECL=80,BLKSIZE=3120

A sample VSUM user profile is automatically generated for each new VSUM user. You may want to update the VSUM STEPLIB and/or JOB statement in the VSUM PROFILE TABLE LIBRARY(MEMBER=VSUMPROF), to conform to your installation’s STEPLIBDSNAME and JCL standards prior to making VSUM available to your users.

The VSUM option should be added to your current ISPF primary (or other) option dialog panel. A sample ISPF primary option panel name “ISR@PRIM” has been included as a reference model. Your installation’s “ISR@PRIM” panel should be modified as described below for VSUM support.

Add the following two (2) option lines to the “)BODY” section:

V +VSUM - EXTENDED CATALOG LIST AND CATALOG ANALYSIS; - VSAM DATASET DESIGN, ANALYSIS, AND RECOMMENDATIONS

Add the following line to the “)PROC” section “&ZSEL..” statement:

V,'PANEL(VSUMPRIM) NEWAPPL(VSUM)'

Modify and execute the installation verification procedure (member=USERIVP) provided in the VSUM control library. This member must be modified to conform to your installation’s JCL

Step 9

Step 10


19

standards. The installation verification procedure instructions are included as part of the USERIVP member.

Execute VSUM from TSO/ISPF. Logon to TSO with the VSUM proc, and execute VSUM by selecting the ‘V’ option.

Prepare VSUM JCL for batch execution. A sample JCL is shown below. USERIVP (Step 10) should also provide usable JCL, and there are examples in the parts in the manual pertinent to each function. Refer to the command descriptions for detailed explanations of input parameters.

NOTE: The command descriptions are also available as VSUM ISPF tutorial panels.

//YOURSTEP EXEC PGM=VSUM,REGION=300K //STEPLIB DD DSN=****.VSUM.R51.LOADLIB,DISP=SHR //VSAMIN DD DSN=YOUR.VSAM.KSDS.DISP=OLD //CASTATS DD DSN=ANYNAME,DISP=(NEW,DELETE),..... //DSSTATS DD DSN=ANYNAME,DISP=(NEW,DELETE),..... //SYSPRINT DD SYSOUT=A REQUIRED FOR ALL FUNCTIONS //BUFPRINT DD SYSOUT=A LIST BUFFERTABLE OPTION //CAREPORT DD SYSOUT=A ANALYZE FUNCTION ONLY //CAGRAPH DD SYSOUT=A ANALYZE FUNCTION ONLY //CIREPORT DD SYSOUT=A ANALYZE FUNCTION ONLY //KRREPORT DD SYSOUT=A ANALYZE FUNCTION ONLY //SYSIN DD * REQUIRED FOR ALL FUNCTIONS * Place your VSUM commands here * Refer to appropriate sections for command syntax /*

Execute the VSUM job with the desired input parameters. The output reports produced are described in detail in the part of the manual pertinent to each command.

Step 11

Step 12

Sample JCL for VSUM Batch Mode

20

2 Catalog List/Search

Overview

The VSUM LIST function provides a quick batch listing and online display of datasets defined to a VSAM catalog in an easy-to-read format. Using search parameters provided by VSUM, the catalog output can be limited to only those datasets that meet certain user-defined exception criteria. Productivity can be increased by not having to visually scan catalog listings for possible problems, reorganizations, or for specific DASD—VSUM can do all this automatically.

With the generic search capabilities provided, the user can display all the datasets for a given application, for example, by knowing only the first node, or only a partial node. Combining this with the BUFFERTABLE option, the LSR buffer requirements can be determined by VSUM for a given application. From this, the CICS buffers could be adjusted and readied for a new or existing application.

The LIST function can also execute an automatic VSUM ANALYZE function for each of the VSAM keyed datasets that matched the search criteria.

VSAM datasets processed by the LIST function can have their current define and catalog statistics saved on a VSUM statistical file and be reprinted at a later time with the REPRINT function, or processed with a program like SAS for user-generated dataset trending.

The ISPF LIST function provides most of the capability of the batch list function and gives you a fast and easy way to search and display selected VSAM catalog entries in both on-line and TSO batch job submissions. This feature will display logically related ISPF panels to help you specify the catalog search criteria to be used for the VSUM LIST function.

VSUM for z/OS Program Description and Operations Guide Catalog List/Search

21

Suggested Uses

The VSUM LIST function can be useful in managing your VSAM and non-VSAM datasets and files in the following ways:

• All the entries of a specific VSAM catalog can be displayed quickly and in an easy-to-read format in a batch report or in ISPF display panels.

• Datasets can be listed without having to know the entire qualified DSNAME, a single node or even a partial node can be used for selection criteria. This is especially helpful in being able to list all the files or datasets belonging to a specific application.

• LSR buffer pool size requirements can be determined automatically using VSUM’s BUFFERTABLE option. The requirements can also be broken down by application with the help of the partial DSNAME capability or other selection criteria.

• DASD utilization can be determined automatically using VSUM’s VOLUMELIST option. They can also be broken down by application as with the BUFFERTABLE option. The report shows the total allocated space, the total used space, the total free space, and the total number of extents.

• Notification of the need for dataset reorganizations can be done automatically by setting up list search criteria based on the number of control interval splits, control area splits, secondary allocations, or percent full.

• Unnecessary paper can be eliminated in detecting performance or other problems by setting up user-defined exception criteria such that only datasets needing to be looked at will be printed.

• Using the automatic ANALYZE function, the need to schedule a separate job to get detailed analysis done when exception criteria have been hit has been eliminated. This can also help with problem analysis because the problem will not have time to ‘disappear’. The analysis can easily be selected to execute in foreground or background using the ISPF interface.

• Periodic statistical file accumulation of VSAM dataset catalog information can be used with user-written SAS programs or other user programs to generate your own reports for dataset trending.


22

Command and ISPF Input

The VSUM LIST function can be performed in batch mode or by selecting the VSUM ISPF LIST function.

A VSUM LIST function can be performed by specifying a LIST command in the SYSIN DD statement and executing the program VSUM or by selecting the BATCH processing mode of the ISPF LIST function. The LIST command specifies all the catalog search criteria and output options for VSUM to use during the batch VSAM catalog search and list. The LIST command parameters that can be specified are described in this section.

A VSUM LIST function can be performed by specifying “L” in the command line of VSUM’s PRIMARY OPTION MENU described in the “INTRODUCTION” section. This ISPF panel is the first in a series of panels that guides you in selecting appropriate LIST command parameters without having to know the LIST command syntax. Whenever a VSUM ISPF LIST request is performed, it is translated into a VSUM command and executed in your TSO region or submitted as a batch MVS job. The VSUM output is then displayed on your terminal through ISPF output panels or, if submitted for batch processing, printed on one of your installation’s printers. The VSUM LIST command that is executed under ISPF can be displayed on your terminal by turning on the VSUM ISPF “INPUT TRACE” option.

Because of the number of ISPF LIST panels VSUM provides, not all the LIST panels are described in this manual. The LIST command panels described give you an idea of the format and flow of the panels that will be displayed for the VSUM LIST function. All ISPF panels are described completely and comprehensively by online tutorial panels.

Batch Mode

ISPF Mode


24

L I S T C O M M A N D K E Y W O R D S (continued) NOREUSE NOSWAP NOTUSABLE NOUPDATE NOWRITECHECK ORDERED OWNER (string) PHYRECSZ (number < :cond | :EQ >) RANGETOTALS (PRINT | ACCUM | NONE ) READ (number < :cond | :GE >) READINDEX (number < :cond | :GE >) RECOMMENDATIONS (...) See DATASET RECOMMENDATIONS section RECORDS (number < :cond | :GE >) RECORDSINDEX (number < :cond | :GE >) RECOVERY RECTOTALS (PRINT | ACCUM | NONE ) REPLICATE REUSE SAVE SECALLOCATION (number < :cond | :GE >) SHAREOPTIONS (cr cs) SPANNED SPEED STAGE SUBALLOCATE SWAP TEMPEXPORTED TOTALCYLS (number < :cond | :GE >) TOTALCYLSDATA (number < :cond | :GE >) TOTALCYLSINDEX (number < :cond | :GE >) TOTALTRKS (number < :cond | :GE >) TOTALTRKSDATA (number < :cond | :GE >) TOTALTRKSINDEX (number < :cond | :GE >) TRKSCA (number < :cond | :EQ >) TRKUTIL (pct < :cond | :GE >) TYPE (ALL VSAM KSDS ESDS RRDS AIX PATH GDG ALIAS VOLUME NONVSAM UCAT MCAT PAGE) UNIQUE UNIQUEKEY UNORDERED UPDATE UPDATED (number < :cond | :GE >) UPDATEDINDEX (number < :cond | :GE >) USEDCYLS (number < :cond | :GE >) USEDCYLSDATA (number < :cond | :GE >) USEDCYLSINDEX (number < :cond | :GE >) USEDTRKS (number < :cond | :GE >) USEDTRKSDATA (number < :cond | :GE >) USEDTRKSINDEX (number < :cond | :GE >) VOLUME (volser) VOLUMELIST (PRINT | ACCUM | NONE ) WRITECHECK


25

----------------------- VSUM - LIST SELECTION MENU ---------------------------- COMMAND ==> ******* STANDARD TYPES ******* A - ALL (ALL DATASET TYPES LISTED BELOW) V - VSAM (KSDS, ESDS, RRDS, AND AIX DATASETS) K - KSDS (VSAM KEY SEQUENCED DATASETS) E - ESDS (VSAM ENTRY SEQUENCED DATASETS) R - RRDS (VSAM RELATIVE RECORD DATASETS) X - AIX (VSAM ALTERNATE INDEX DATASETS) P - PATH (VSAM PATHS) G - GDG (GENERATION DATA GROUPS) N - NONVSAM (NON-VSAM DATASETS) ******* ADDITIONAL TYPES ******* 1 - ALIAS (DATASET ALIASES) 2 - VOLUME (VOLUME ENTRIES) 3 - CATALOG (VSAM CATALOG DATASETS (ICF AND NON-ICF) 4 - VVDS (VSAM VOLUME DATASETS) 5 - PAGE (PAGE DATASETS)

This panel is the first panel of the LIST function and is displayed when “L” is selected from VSUM’s PRIMARY OPTION MENU described in the “INTRODUCTION” section. This panel is used to select the TYPE of entries to be listed from a VSAM catalog.

ISPF Input Panels

LIST SELECTION PANEL (TYPE)


26

------------------------ VSUM - LIST "KSDS" TYPES ----------------------------- COMMAND==> INPUT TRACE==> NO DATASET NAME ==> SAMPLE.DATASET.* CATALOG NAME/PSWD ==> SAMPLE.CATALOG.NAME / PASSWORD VOLUME ==> (VOLUME NAME) OWNER ==> (VSAM OWNER ID) SELECT DEVICE TYPES(S) TO SEARCH FOR: (Y/N) (CHOOSE ONLY 1) ALL ==> Y 3375 ==> (TYPE 'ALL' IS MUTUALLY 3380 ==> 3390 ==> EXCLUSIVE WITH OTHER 3350 ==> MSS ==> DEVICE TYPES) ADDITIONAL SELECTION OPTIONS: (Y/N) REPLICATE ==> ERASE ==> (NULL ENTRY YIELDS BOTH OPTIONS) IMBED ==> WRITECHECK ==> I.E. ERASE=Y LISTS ERASED ONLY SPEED ==> SPANNED ==> ERASE=N LISTS NOERASE "" UNIQUE ==> REUSE ==> ERASE='' LISTS ERASE AND UPDATE ==> DSWAIT ==> NOERASE ORDERED ==> TEMPEXPORTED ==> CANDIDATE ==> KEYRANGE ==> BIND/CYLFLT/STAGE ==> (B,C,S) PF1=HELP PF6=PROFILE MODE= ONLINE EXTENDED SEARCH= YES RECOMMENDATIONS= NO

This panel is displayed when “K” is selected in the VSUM LIST SELECTION PANEL and used to specify catalog list/search criteria for VSAM keyed sequenced datasets. If the PF6 key is pressed from this panel additional catalog list/search criteria can be specified in the LIST PROFILE PANELS. Refer to “DATASET DEFINITION” and “DATASET EXECUTION” parameter panels in this section for which additional catalog list/search parameters that are available. The MODE (ONLINE or BATCH), EXTENDED SEARCH (YES or NO), and RECOMMENDATIONS (YES or NO) can be dynamically selected when panel is displayed.

LIST SELECTION PANEL (KSDS)


27

------------------------ VSUM - LIST "NONVSAM" TYPES -------------------------- COMMAND==> INPUT TRACE==> NO DATASET NAME ==> SAMPLE.NONVSAM.DATASET.* CATALOG NAME/PSWD ==> SAMPLE.CATALOG.NAME / PASSWORD VOLUME ==> (VOLUME NAME) OWNER ==> (VSAM OWNER ID) SELECT DEVICE TYPES(S) TO SEARCH FOR: (Y/N) (CHOOSE ONLY 1) ALL ==> Y 3375 ==> MSS ==> (TYPE 'ALL'IS MUTUALLY 3380 ==> 3390 ==> 3480 ==> EXCLUSIVE WITH OTHER 3350 ==> DEVICE TYPES) PF1=HELP PF6=PROFILE MODE= ONLINE EXTENDED SEARCH= YES RECOMMENDATIONS= NO

This panel is displayed when “N” is selected in the VSUM LIST SELECTION MENU and is used to specify catalog search criteria for non-VSAM datasets.

---------------- VSUM - LIST CATALOG DATASET SELECTION LIST ------------------- COMMAND ==> SCROLL===> CUR OPTIONS: (S,R,P,A,B,E) PF6= PROFILE PF11= CANCEL PRINT/ANALYZE PF12= REPEAT FIND S ACTION DATA SET NAME TYPE CREATED ------------------------------------------------------------------------------- S | SELCT | DETAILED.DATASET.STATISTICS.SELECTED | KSDS | 02/06/2017 P | PRINT | DETAILED.DATASET.STATISTICS.BACKGROUND.PRINT | KSDS | 02/07/2017 R | RECOM | DATASET.DESIGN.RECOMMENDATIONS | ESDS | 02/08/2017 A | ANALZ | DETAILED.DATASET.BACKGROUND.ANALYSIS | AIX | 02/09/2017 . . . . . . . . .

LIST SELECTION PANEL (NONVSAM)

LIST SELECTION PANEL (DATASET)


28

This panel is displayed after a VSUM LIST function is executed and more than one dataset met the search criteria. This panel is scrollable and FIND commands can be specified to further search on DATASET NAME, TYPE, or CREATED date. Datasets displayed in this panel can be selected for a DETAIL DISPLAY (“S”) of dataset information, VSUM RECOMMENDATIONS (“R”), background printing of dataset information (“P”), or VSUM dataset ANALYZE in background.

When “P” or “A” is selected the entries to be printed or analyzed will be submitted for batch processing when this panel is exited.

---------------- VSUM - SEARCH/LIST DATASET DEFINITION PARMS ------------

------ COMMAND ==> DATASET NAME ==> SAMPLE.DATASET.* CATALOG NAME/PSWD ==> SAMPLE.CATALOG.NAME / PASSWORD VOLUME ==> OWNER ==> DATASET DEFINITION SELECTION OPTIONS: SHAREOPTIONS ==>( 3 , 3 ) (X-REGION,X-SYSTEM) FREESPACE ==>( 20 : GT 30 : GT ) (I.E. (10:GE 30:LT) ) DATA CI SIZE ==>( 2048 : ) (I.E. 8096:EQ) INDEX CI SIZE ==>( : ) (I.E. 2048:EQ) PHYSICAL REC SIZE ==>( : ) (I.E. 1024:EQ) CREATION DATE ==>( 01 / 01 / 2017 : ) (I.E. 01/01/2017:GE) EXPIRATION DATE ==>( / / : ) (JANUARY 1, 2017) LAST UPDATE DATE ==>( / / : ) ENTER=SAVE AND EXIT

This panel is displayed when “P.L.1” is specified in VSUM’s PRIMARY OPTION MENU, or the PF6 key is pressed from a LIST TYPE selection menu. This panel is used to specify catalog search criteria for subsequent VSUM catalog list requests. This panel should be selected and the appropriate parameters specified when you wish to search a VSAM catalog for datasets matching any of the above criteria.

LIST DATASET DEFINITION

PARAMETER PANELS


29

----------------- VSUM - SEARCH/LIST DATASET EXECUTION PARMS ------------

------ COMMAND ==> CI SPLITS ==>( : ) (0-99999:EQ) VALID OPERATORS: CA SPLITS ==>( 100 : GT ) (0-99999) (EQ,NE,LT,LE,GT,GE) DATA EXCP RATIO ==>( : ) (0-999) INDEX EXCP RATIO ==>( : ) (0-999) SECONDARY ALLOC. ==>( 1 : GT ) (0-125) INDEX LEVELS ==>( : ) (0-10) PERCENT FULL ==>( : ) MUTUALLY EXCLUSIVE WITH EMPTY EMPTY ==> (Y/N) ADDITIONAL SELECTION CRITERIA: FREE TRACKS ==>( : ) (0-999999:EQ) USED TRACKS ==>( : ) " " TOTAL TRACKS ==>( : ) " " FREE CYLINDERS ==>( : ) (0-999999:EQ) USED CYLINDERS ==>( : ) " " TOTAL CYLINDERS ==>( : ) " " ENTER=SAVE AND EXIT

This panel is displayed when “P.L.2” is specified in VSUM’s PRIMARY OPTION MENU, or PF6 key is pressed from a LIST TYPE selection menu. This panel is used to specify catalog search criteria for subsequent VSUM catalog list requests. This panel should be selected and the appropriate parameters specified when you want to search a VSAM catalog for datasets matching any of the above criteria.

ABBREVIATIONS: LIST may be abbreviated as L

ANALYZE .... Specifies that an automatic VSUM dataset ANALYZE is to be performed for those KSDS and AIX datasets selected for processing. Refer to chapter 0, “Dataset Analyze/Backup,” for a detailed description of ANALYZE sub parameters.

BIND Specifies that VSAM datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: TYPE(PATH GDG VOLUME NONVSAM ALIAS)

BUFFERTABLE (PRINT | ACCUM | NONE ) Specifies that for those datasets selected for processing, the buffertable should be bypassed, with NONE, should be printed and have totals accumulated across VSUM commands, with ACCUM, or

LIST DATASET EXECUTION

PARAMETERS PANEL

LIST Parameter Descriptions


30

accumulated and printed for the current VSUM command, with PRINT. If ACCUM is specified with no succeeding PRINT, the BUFFERTABLE report will be printed at end of processing. The ACCUM and PRINT options can be used to print multiple BUFFERTABLE reports in one execution of VSUM. When ACCUM or PRINT is specified the ddname BUFPRINT is required.

DEFAULTS: (NONE), no accumulation or printing of the BUFFERTABLE report.

MUTUALLY EXCLUSIVE parameters: TYPE(PATH GDG ALIAS NONVSAM VOLUME)

ABBREVIATIONS: BUFFTABLE, BUFTABLE, BUFFT, BUFT

CANDIDATE Specifies that VSAM datasets that have a candidate volume(empty) allocated to them will be processed.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: TYPE(PATH GDG ALIAS NONVSAM)

ABBREVIATIONS: CANDT, CANDTVOL, CANDIDATEVOLUME

CASPLITS (number < :cond | GE >) Specifies that only those VSAM KSDS or AIX datasets whose CA splits are equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0-99999.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: TYPE(ESDS RRDS PATH GDG ALIAS NONVSAM VOLUME)

ABBREVIATIONS: CASPL, CASP

CATALOG (catname </masterpw>) Specifies the VSAM catalog that will be used as the source for selecting datasets for processing. The catalog master password is required when the ANALYZE parameter is specified for datasets that are control password protected and the user does not want the operator to be prompted for the control password for those datasets. Also, if the catalog is read password protected, the password should be specified, or the operator will be prompted for it. Catalog search time can be improved considerably when a catalog is specified.

DEFAULT catalog: STEPCAT, JOBCAT, ALIAS, MASTER CATALOG

ABBREVIATIONS: CAT


31

CISIZE (number < :cond | EQ >) Specifies that VSAM datasets whose DADA components have a control size equal to the “number” specified will be processed. The number must be a valid data component control interval size. If a conditional is included, then only those datasets that satisfy the number and test criteria will be selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: CISZD, CISIZEDATA

CISIZEINDEX (number < :cond | EQ >) Specifies that VSAM KSDS or AIX datasets whose INDEX components have a control size equal to the “number” specified will be processed. The number must be a valid index component control interval size. If a conditional is included, then only those datasets that satisfy the number and test criteria will be selected for processing.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: TYPE(PATH GDG ALIAS NONVSAM VOLUME ESDS RRDS)

ABBREVIATIONS: CISZI, CISIZEI

CISPLITS (number < :cond | GE >) Specifies that only those VSAM keyed datasets whose CI splits are equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–99999.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: TYPE(ESDS RRDS PATH GDG ALIAS NONVSAM VOLUME)

ABBREVIATIONS: CISPL, CISP

CREATED (MMDDYYYY | MM/DD/YYYY | YYYYDDD | < :cond | :GE >) Specifies the creation date selection criteria for datasets to be processed. If a conditional test is specified datasets whose creation date meet the test criteria are selected for processing.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: TYPE(ALIAS VOLUME)

ABBREVIATIONS: CRDATE, CRDT, CREATIONDATE


32

CYLFAULT Specifies that VSAM datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: CYLF, CYLINDERFAULT

DELETED (number < :cond | GE >) Specifies that datasets whose data component DELETED record statistics are equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999999.

DEFAULTS: (null)


ABBREVIATIONS: DELTDATA, DELTD, DELETEDATA

DELETEDINDEX (number < :cond | GE >) Specifies that datasets whose index component record DELETED statistics are equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999999.

DEFAULTS: (null)


ABBREVIATIONS: DELETEDI, DELTINDEX, DELTI

DEVICETYPE (3390 | 3380 | 338K | 338E | 3375 | 3350 | 3340 | 3330 | 3480 | MSS | TAPE) Specifies the device type selection criteria to be used in determining which datasets are to be processed. Only those datasets that are defined on the specified device type will be selected for processing.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: TYPE(PATH ALIAS GDG UCAT)

ABBREVIATIONS: DEVTYPE, DEVTYP, DEVT

DSSTATDD (ddname | DSSTATS </updatepw>) Specifies the ddname of the dataset statistics file if a ddname of other than DSSTATS is desired. If the dataset associated with the related ddname is password protected for update then that password must


33

also be specified. This parameter is required when SAVE or ANALYZE DSREPORT(SAVE) is specified.

DEFAULTS: DSSTATS

ABBREVIATIONS: DSSTDD, DSDD

DSWAIT Specifies that VSAM datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: DSW, DESTAGEWAIT

EMPTY Specifies that VSAM datasets that are empty (HURBA is zero) will be selected for processing.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: FULL TYPE(PATH GDG ALIAS NONVSAM VOLUME)

ERASE Specifies that VSAM datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: ERA

EXCPRATIO (number < :cond | GE >) Specifies that VSAM datasets whose DATA component EXCP to I/O ratio is equal to or greater than the “number” specified will be processed. If a conditional test is specified, only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999. The EXCP to I/O ratio represents the average number of EXCP’s issued for each logical I/O request and is calculated as follows:

EXCPS ------------------------------------ RECORDS+READ+(UPDATED*2)+(DELETED*2)

DEFAULTS: (null)


ABBREVIATIONS: EXCPRD, EXCPRATIODATA


34

EXCPRATIOINDEX (number < :cond | GE >) Specifies that VSAM datasets whose INDEX component EXCP to I/O ratio is equal to or greater than the “number” specified will be processed. If a conditional test is specified, only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999. The EXCP to I/O ratio represents the average number of EXCP’s issued for each logical I/O request and is calculated as follows:

EXCPS (INDEX) –––----------------------------------

RECORDS+READ+(UPDATED*2)+(DELETED*2) (DATA)

NOTE: The DATA component RECORDS, READ, UPDATED, and DELETED values are used to calculate the EXCPRATIO for the index because the data component statistics represent logical record requests and the index component statistics do not.

DEFAULTS: (null)


ABBREVIATIONS: EXCPRI

EXCPS (number < :cond | GE >) Specifies that VSAM datasets whose DATA component catalog record EXCP statistics are equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999999.

DEFAULTS: (null)


ABBREVIATIONS: EXCP, EXCPSDATA, EXCPSD

EXCPSINDEX (number < :cond | GE >) Specifies that VSAM datasets whose INDEX component catalog record EXCP statistics are equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0-999999999.

DEFAULTS: (null)


ABBREVIATIONS: EXCPINDEX, EXCPSI


35

EXPIRED(MMDDYYYY MM/DD/YYYY YYYYDDD < :cond | GE >) Specifies the expiration date selection criteria for datasets to be processed. If a conditional test is specified datasets whose expiration date meet the test criteria are selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: EXPDATE, EXDT, EXPIRATIONDATE

FREECYLS (number < :cond | GE >) Specifies that those VSAM datasets whose data and index (keyed) components free cylinders (not used) are equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999.

DEFAULTS: (null)


ABBREVIATIONS: FCYLS, FREECYLINDERS

FREECYLSDATA (number < :cond | GE >) Specifies that the VSAM datasets whose data components free cylinders (not used) are equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999.

DEFAULTS: (null)


ABBREVIATIONS: FCYLSD, FCYLSDATA, FREECYLINDERSDATA

FREECYLSINDEX (number < :cond | GE >) Specifies that the VSAM datasets whose index components free cylinders (not used) are equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999.

DEFAULTS: (null)


ABBREVIATIONS: FCYLSI, FCYLSINDEX, FREECYLINDERSINDEX


36

FREESPACE (cipct < :cond | EQ > capct < :cond | EQ >) Specifies that VSAM keyed datasets that have a defined CI and/or CA freespace percentage equal to the percentage, “pct”, specified will be processed. If a conditional is included then only those datasets that satisfy the percentage and test criteria will be selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: FSPC

FREETRKS (number < :cond | GE >) Specifies that those VSAM datasets whose data and index (keyed) components free tracks (not used) are equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999.

DEFAULTS: (null)


ABBREVIATIONS: FTRKS, FREETRACKS

FREETRKSDATA (number < :cond | GE >) Specifies that the VSAM datasets whose data components free tracks (not used) are equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999.

DEFAULTS: (null)


ABBREVIATIONS: FTRKSD, FREETRACKSDATA

FREETRKSINDEX (number < :cond | GE >) Specifies that the VSAM datasets whose index components free tracks (not used) are equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999.

DEFAULTS: (null)


ABBREVIATIONS: FTRKSI, FREETRACKSINDEX


37

FULL (pct < :cond | EQ >) Specifies that VSAM datasets that are FULL (HURBA=HARBA) or whose percentage of total allocated space is being used for records will be selected for processing.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: EMPTY TYPE(PATH GDG ALIAS NONVSAM VOLUME)

IMBED Specifies that VSAM keyed datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: TYPE(PATH GDG VOLUME NONVSAM ALIAS RRDS ESDS)

ABBREVIATIONS: IMB

INDEXLEVELS (number < :cond | GE >) Specifies that datasets whose index component catalog “INDEXLEVELS” statistic is equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–10.

DEFAULTS: (null)


ABBREVIATIONS: ILEVEL, ILVL

INSERTED (number < :cond | GE >) Specifies that datasets whose data component record “INSERTED” value is equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999999.

DEFAULTS: (null)


ABBREVIATIONS: INSRD, INSERTEDDATA

INSERTEDINDEX (number < :cond | GE >) Specifies that datasets whose index component record “INSERTED” value is equal to or greater than the “number” specified will be processed. If a conditional test is specified, only those datasets that


38

satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999999.

DEFAULTS: (null)


ABBREVIATIONS: INSRI, INSERTEDI

KEYRANGE Specifies that VSAM keyed datasets defined with KEYRANGES are to be selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: KEYR

LASTUPDATED(MMDDYYYY | MM/DD/YYYY | YYYYDDD | < :cond | :GE >) Specifies that VSAM datasets whose last updated date (SYSTEM-TIMESTAMP) is greater than or equal the specified date will be processed. If a conditional test is specified datasets whose last updated date meet the test criteria are selected for processing.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: TYPE(ALIAS VOLUME PATH NONVSAM)

ABBREVIATIONS: LASTUP, LASTUPD

LISTTOTALS(PRINT | ACCUM | NONE ) Specifies that for those datasets selected for processing, the LISTTOTALS should be bypassed, with NONE, should be accumulated across VSUM commands, with ACCUM, or should be accumulated and printed, with PRINT. If ACCUM and no succeeding PRINT is specified, the LISTTOTALS report will be printed at end of processing. The ACCUM and PRINT options can be used to print multiple LISTTOTALS reports in one execution of VSUM. LISTTOTALS will be written to SYSPRINT.

DEFAULTS: (NONE) no accumulation or printing of LISTTOTALS report.

ABBREVIATIONS: LTOT

NAME (name | partial dsname) Specifies the dataset name of the file(s) to be processed. The dataset name can be either fully or partially qualified. If the dataset name is partial an asterisk will denote the unqualified portions of the dsname.


39

An asterisk can be specified in place of a full or partial dataset name level, and up to two asterisks are allowed in a dsname. An asterisk must be the last character specified in a dsname level.

PARTIAL DSNAME EXAMPLES: *.*.PAYROLL TEST.*.PAYROLL TES*.*.PAYROLL TES*.A*.PAYROLL

DEFAULTS: Complete catalog

MUTUALLY EXCLUSIVE parameters: TYPE(VOLUME)

NODSWAIT Specifies that the VSAM datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: NODSW, NODESTAGEWAIT

NODETAIL Specifies that you do not want the VSUM SYSPRINT output for any datasets selected for processing. This option will suppress the SYSPRINT output for any datasets selected for processing. However the SYSPRINT DD statement is still required for command and message display.

DEFAULTS: (print detail output)

NOERASE Specifies that the VSAM datasets defined with attribute are to be selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: NOERA

NOIMBED Specifies that the VSAM keyed datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: NOIMB


40

NOKEYRANGE Specifies that VSAM keyed datasets defined without KEYRANGES are to be selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: NKEYR, NOKEYR

NONSPANNED Specifies that VSAM datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: TYPE(PATH GDG VOLUME NONVSAM ALIAS AIX)

ABBREVIATIONS: NONSPAN, NSPA

NONUNIQUEKEY Specifies that VSAM alternate index (AIX) datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: TYPE(PATH GDG VOLUME NONVSAM ALIAS RRDS ESDS KSDS)

ABBREVIATIONS: NONUNQKEY, NUNQK

NOREPLICATE Specifies that the VSAM keyed datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: NOREPL, NOREP

NOREUSE Specifies that the VSAM datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: TYPE(PATH GDG VOLUME NONVSAM ALIAS) REUSE and UNIQUE

ABBREVIATIONS: NOREU


41

NOSWAP Specifies that the VSAM page datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: TYPE(PATH GDG VOLUME NONVSAM ALIAS KSDS ESDS RRDS AIX)

ABBREVIATIONS: NOTSWAPPABLE

NOTUSABLE Specifies that the VSAM datasets that are flagged as NOTUSABLE in their VSAM catalog are to be selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: NOTUS, UNUSABLE

NOUPDATE Specifies that the VSAM datasets with this attribute are to be selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: NOUPDAT, NOUPD

NOWRITECHECK Specifies that the VSAM datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: NOWCK, NOWRTCHK

ORDERED Specifies that the VSAM datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: ORDER, ORD


42

OWNER (string) Specifies that VSAM datasets with the specified ownerid will be selected for processing. The string can be any valid VSAM OWNERID that can be specified in character format.

DEFAULTS: (null)


ABBREVIATIONS: OWN

PHYRECSZ (number < :cond | EQ >) Specifies that datasets whose data component’s physical record size is equal to the “number” specified will be processed. The number must be a valid VSAM blocksize. If a conditional is included then only those datasets that satisfy the number and test criteria will be selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: PHYRCSZ, PHYRCSZDATA, PHYRECORDSIZEDATA

RANGETOTALS (PRINT | ACCUM | NONE ) Specifies that for those datasets selected for processing, the RANGETOTALS should be bypassed, with NONE, should be accumulated across VSUM commands, with ACCUM, or should be accumulated and printed, with PRINT. If ACCUM and no succeeding PRINT is specified, the RANGETOTAL report will be printed at end of processing. The ACCUM and PRINT options can be used to print multiple RANGETOTAL reports in one execution of VSUM. RANGETOTALS will be written to SYSPRINT.

DEFAULTS: (NONE) no accumulation or printing of RANGETOTALS report.

ABBREVIATIONS: RTOT, RNGTOT

READ (number < :cond | GE >) Specifies that datasets whose data component records READ value is equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999999.

DEFAULTS: (null)


ABBREVIATIONS: READD, READDATA


43

READINDEX (number < :cond | GE >) Specifies that VSAM keyed datasets whose index component records READ value is equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999999.

DEFAULTS: (null)


ABBREVIATIONS: READI, IREAD

RECOMMENDATIONS(...) Specifies the types of recommendations you want VSUM to make about those KSDS, ESDS, RRDS, and AIX datasets selected for processing. Refer to chapter 0, “Dataset Recommendations,” for a detailed description of the RECOMMENDATIONS parameters.

RECORDS (number < :cond | GE >) Specifies that VSAM datasets whose data component RECORDS value is equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999999.

DEFAULTS: (null)


ABBREVIATIONS: RECSD, RECORDSDATA

RECORDSINDEX (number < :cond | GE >) Specifies that VSAM keyed datasets whose index component RECORDS value is equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed.

DEFAULTS: (null)


ABBREVIATIONS: RECSI, RECSINDEX

RECOVERY Specifies that the VSAM datasets defined with the specified attribute are to be selected for processing.

DEFAULTS: (null)


44


ABBREVIATIONS: REC

RECTOTALS(PRINT | ACCUM | NONE ) Specifies that for those datasets selected for processing, the RECTOTALS should be bypassed, with NONE, should be accumulated across VSUM commands, with ACCUM, or should be accumulated and printed, with PRINT. If ACCUM and no succeeding PRINT is specified, the RECTOTALS report will be printed at end of processing. The ACCUM and PRINT options can be used to print multiple RECTOTALS reports in one execution of VSUM. RECTOTALS will be written to SYSPRINT.

DEFAULTS: (NONE) no accumulation or printing of RANGETOTALS report.

ABBREVIATIONS: RECT, RECORDTOTALS

REPLICATE Specifies that VSAM keyed datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: TYPE(PATH GDG VOLUME NONVSAM ALIAS ESDS RRDS)

ABBREVIATIONS: REPL, REP

REUSE Specifies that VSAM datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: TYPE(PATH GDG VOLUME NONVSAM ALIAS) REUSE and UNIQUE

ABBREVIATIONS: REU

SAVE Specifies that the statistics should be saved for any KSDS, RRDS, ESDS, AIX or catalog datasets. Saving the statistics will allow the list output to be reprinted with the REPRINT function at a later time. The ddname specified by the DSSTATDD parameter will also be required during execution.

DEFAULTS: (no saving)


45

SECALLOCATION (number < :cond | GE >) Specifies that datasets that have gone into secondary allocation for a number equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–125.

DEFAULTS: (null)


ABBREVIATIONS: SECALLOC, SECA

SHAREOPTIONS (cr cs) Specifies that datasets that have a cross region or cross system shareoption value of what is specified will be processed. If datasets with data and index components have at least one component with the specified shareoption that dataset will be processed. The valid shareoptions allowed are the same as those for the SHAREOPTIONS parameter of the IDCAMS DEFINE command.

DEFAULTS: (null)


ABBREVIATIONS: SHR

SPANNED Specifies that VSAM datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: TYPE(PATH GDG VOLUME NONVSAM ALIAS RRDS)

ABBREVIATIONS: SPAN

SPEED Specifies that VSAM datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: SPE

STAGE Specifies that VSAM datasets defined with this attribute are to be selected for processing.


46

DEFAULTS: (null)


ABBREVIATIONS: STG

SUBALLOCATE Specifies that VSAM datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: SUB, SUBALLOC, SUBALLOCATED

SWAP Specifies that the VSAM page datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: TYPE(PATH GDG VOLUME NONVSAM ALIAS KSDS ESDS RRDS AIX)

ABBREVIATIONS: SWAPPABLE

TEMPEXPORTED Specifies that VSAM datasets that have been temporarily exported are to be selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: TEMPEXP, TEXP

TOTALCYLS (number < :cond | GE >) Specifies that those VSAM datasets whose total allocated cylinder value for the cluster is equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999.

DEFAULTS: (null)


ABBREVIATIONS: TCYL, TOTCYLS, TOTALCYLINDERS


47

TOTALCYLSDATA (number < :cond | GE >) Specifies that those VSAM datasets whose data component total allocated cylinder value is equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999.

DEFAULTS: (null)


ABBREVIATIONS: TCYLSD, TOTCYLSDATA, TOTALCYLINDERSDATA

TOTALCYLSINDEX (number < :cond | GE >) Specifies that those VSAM datasets whose index component total allocated cylinder value is equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999.

DEFAULTS: (null)


ABBREVIATIONS: TCYLSI, TOTCYLSINDEX, TOTALCYLINDERSINDEX

TOTALTRKS (number < :cond | GE >) Specifies that those VSAM datasets whose cluster total allocated tracks value is equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999.

DEFAULTS: (null)


ABBREVIATIONS: TTRKS, TOTTRKS, TOTALTRACKS

TOTALTRKSDATA (number < :cond | GE >) Specifies that those VSAM datasets whose data component total allocated tracks value is equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999.

DEFAULTS: (null)


ABBREVIATIONS: TTRKSD, TOTTRKSDATA, TOTALTRACKSDATA


48

TOTALTRKSINDEX (number < :cond | GE >) Specifies that those VSAM datasets whose index component total allocated tracks value is equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999.

DEFAULTS: (null)


ABBREVIATIONS: TTRKSI, TOTTRKSINDEX, TOTALTRACKSINDEX

TRKSCA (number < :cond | EQ >) Specifies that datasets whose data component tracks per control area is equal to the “number” specified will be processed. If a conditional is included, then only those datasets that satisfy the “number” of tracks per ca and test criteria will be selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: CASIZE, TRKSPERCA

TRKUTIL (pct < :cond | GE >) Specifies that datasets whose data component physical record size and device type give a track utilization percentage equal to or greater than the percentage, “pct”, specified will be processed. If a conditional is included, then only those datasets that satisfy the percentage and the test criteria will be selected for processing. The track utilization is the percentage of available bytes on a track that can be used for VSAM control intervals.

DEFAULTS: (null)


ABBREVIATIONS: TRKU, TRKU%, TRKUTIL

TYPE(ALL | VSAM KSDS AIX RRDS ESDS PATH GDG ALIAS VOLUME NONVSAM UCAT MCAT PAGE) Specifies the type of datasets to be selected for processing. This parameter should be used when possible because when specific types are specified, the catalog search time can be significantly decreased.

When ALL is specified or defaulted and other search parameters are specified, then only those catalog entries that match the search criteria will be listed. Catalog entries that are not logically related to one or more search parameters will not be listed. For example, if


49

“CASPLITS” is specified as a search criteria only keyed entries will be listed. Catalog entries that could not have “CASPLITS” such as ESDS, RRDS, and NONVSAM entries will not be listed. Type VSAM includes KSDS, AIX, ESDS, and RRDS dataset types.

DEFAULTS: TYPE(ALL)

MUTUALLY EXCLUSIVE parameters: TYPE(ALL) cannot be specified with any other TYPE combination

UNIQUE Specifies that VSAM datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: TYPE(PATH GDG VOLUME NONVSAM REUSE ALIAS)

ABBREVIATIONS: UNQ

UNIQUEKEY Specifies that VSAM keyed datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: TYPE(PATH GDG VOLUME NONVSAM ALIAS RRDS ESDS KSDS)

ABBREVIATIONS: UNQKEY, UNQK

UNORDERED Specifies that VSAM datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: UNORD, UNORDER, NONORDERED

UPDATE Specifies that datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: UPD


50

UPDATED (number < :cond | GE >) Specifies that VSAM datasets whose data component UPDATED record value is equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed.

DEFAULTS: (null)


ABBREVIATIONS: UPDTD, UPDATEDD, UPDATEDATA

UPDATEDINDEX (number < :cond | GE >) Specifies that VSAM keyed datasets whose index component UPDATED record value is equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed.

DEFAULTS: (null)


ABBREVIATIONS: UPDTI, UPDTINDEX

USEDCYLS (number < :cond | GE >) Specifies that VSAM datasets whose used cylinder values for the cluster are equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999.

DEFAULTS: (null)


ABBREVIATIONS: UCYLS, USEDCYLINDERSS

USEDCYLSDATA (number < :cond | GE >) Specifies that those VSAM datasets whose data component used cylinder values are equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999.

DEFAULTS: (null)


ABBREVIATIONS: UCYLSD, USEDCYLINDERSDATA


51

USEDCYLSINDEX (number < :cond | GE >) Specifies that those VSAM datasets whose index component used cylinder values are equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999.

DEFAULTS: (null)


ABBREVIATIONS: UCYLSI, UCYLSI, USEDCYLINDERSINDEX

USEDTRKS (number < :cond | GE >) Specifies that those VSAM datasets whose used track values for the cluster are equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999.

DEFAULTS: (null)


ABBREVIATIONS: UTRKS, USEDTRACKS

USEDTRKSDATA (number < :cond | GE >) Specifies that those VSAM datasets whose data component used track values are equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999.

DEFAULTS: (null)


ABBREVIATIONS: UTRKSD, USEDTRACKSDATA

USEDTRKSINDEX (number < :cond | GE >) Specifies that those VSAM datasets whose index component used track values are equal to or greater than the “number” specified will be processed. If a conditional test is specified only those datasets that satisfy the test criteria will be processed. The “number” can be a valid numeric string from 0–999999.

DEFAULTS: (null)


ABBREVIATIONS: UTRKSI, USEDTRACKSINDEX


52

VOLUME (volser) Specifies the volume name entry when TYPE(VOLUME) is specified that will be used to search the VSAM catalog. For TYPE(KSDS AIX RRDS ESDS NONVSAM GDG) this parameter will limit the listing to only the dataset types defined fully or partially on the volume.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: TYPE(PATH ALIAS)

ABBREVIATIONS: VOL

VOLUMELIST (PRINT | ACCUM | NONE ) Specifies that for those datasets selected for processing, the volume totals should be bypassed, with NONE, should be accumulated across VSUM commands, with ACCUM, or should be accumulated and printed, with PRINT. If ACCUM and no succeeding PRINT is specified, the VOLUMELIST report will be printed at end of processing. The ACCUM and PRINT options can be used to print multiple VOLUMELIST reports in one execution of VSUM. The VOLUMELIST will be written to SYSPRINT.

DEFAULTS: (NONE) no accumulation or printing of VOLUMELIST report.

MUTUALLY EXCLUSIVE parameters: TYPE(PATH ALIAS NONVSAM)

ABBREVIATIONS: VOLLIST, VOLL

WRITECHECK Specifies that datasets defined with this attribute are to be selected for processing.

DEFAULTS: (null)


ABBREVIATIONS: WCHECK, WCK


53

Examples of Use

Following are several examples of possible uses for VSUM’s list facility.

The following example will list any dataset specified in the name parameter from the catalog specified. If a catalog is not specified, the order of catalog search will be STEPCAT, JOBCAT, ALIAS, and then the Master Catalog.

//LIST EXEC PGM=VSUM,REGION=1024K //STEPLIB DD DSN=XXXX,DISP=SHR //SYSPRINT DD SYSOUT=A //SYSIN DD * * COMMENT LIST CATALOG(YOURCAT) - NAME(YOURCAT.ANY.FILE) /*

The following example will list any dataset beginning with the specified character string in the name parameter, from the catalog specified. If a match is found on the partial name, then the attributes are checked to ensure that they also meet the input criteria. In the example given, we have chosen to select VSAM KSDS or AIX datasets that have IMBED and SUBALLOCATE specified.

//LIST EXEC PGM=VSUM,REGION=1024K //STEPLIB DD DSN=XXXX,DISP=SHR //SYSPRINT DD SYSOUT=A //SYSIN DD * * COMMENT LIST CATALOG(YOURCAT) - NAME(YOURCAT.A*) - TYPE(KSDS AIX) - SUBALLOCATE - IMBED /*

List Single Entry

List a Catalog for a Partial Name With Certain Attributes


54

The following example will list all VSAM KSDS datasets from a specified catalog that have a total of more than one free (unused) cylinder. (data and index combined).

//LIST EXEC PGM=VSUM,REGION=1024K //STEPLIB DD DSN=XXXX,DISP=SHR //SYSPRINT DD SYSOUT=A //SYSIN DD * * LIST CATALOG(YOURCAT) - TYPE(KSDS) - FREECYLINDERS(1:GT) /*

The following example will list all VSAM KSDS datasets from a specified catalog that have gone into secondary allocation.

//LIST EXEC PGM=VSUM,REGION=1024K //STEPLIB DD DSN=XXXX,DISP=SHR //SYSPRINT DD SYSOUT=A //SYSIN DD * * LIST CATALOG(YOURCAT) - TYPE(KSDS) - SECALLOCATION(1:GE) /*

The following example will list all VSAM ESDS datasets from a specified catalog that are 25 percent full.

//LIST EXEC PGM=VSUM,REGION=1024K //STEPLIB DD DSN=XXXX,DISP=SHR //SYSPRINT DD SYSOUT=A //SYSIN DD * * LIST CATALOG(YOURCAT) - TYPE(ESDS) - FULL(25:EQ) /*

List a Catalog for All KSDSs Containing One or More Free Cylinders

List a Catalog for All KSDSs With Secondary Allocation

List a Catalog for All ESDSs Only 25 Percent Full


55

The following example will list all VSAM KSDS datasets from a specified catalog that have 10 or more casplits. Then, when a dataset is found meeting these criteria, rather than just printing a listing, it performs an automatic VSUM analysis and gives a detailed report on the dataset.

//LIST EXEC PGM=VSUM,REGION=1024K //STEPLIB DD DSN=XXXX,DISP=SHR //SYSPRINT DD SYSOUT=A //SYSIN DD * * LIST CATALOG(YOURCAT) - TYPE(KSDS) - CASPLITS(10:GE) - ANALYZE /*

The following example will list all the VSAM datasets from a specified catalog in the VSUM BUFFERTABLE REPORT. With each dataset will be its cisize, total EXCPs, total logical I/Os, and EXCP ratio. At the end of the report will be the buffertable matrix showing the valid cisizes and how many datasets, if any, were found for each size. The normal list report will not be printed this time.

//LIST EXEC PGM=VSUM,REGION=1024K //STEPLIB DD DSN=XXXX,DISP=SHR //SYSPRINT DD SYSOUT=A //BUFPRINT DD SYSOUT=A //SYSIN DD * * LIST CATALOG(YOURCAT) - TYPE(KSDS ESDS RRDS AIX) - BUFFERTABLE(PRINT) - NODETAIL /*

List All KSDSs With 10 or More CASPLITS and Get Automatic Analysis

Print the BUFFERTABLE Report to Determine the LSR Requirements of a CICS System


56

The following example will list all the DASD volumes containing VSAM datasets defined in a specific catalog, and show the amount of space being allocated to those VSAM datasets. The space usage will be broken down into total, used, and free tracks as well as the total number of extents found on the given volume. The individual dataset list reports will not be printed this time.

//LIST EXEC PGM=VSUM,REGION=1024K //STEPLIB DD DSN=XXXX,DISP=SHR //SYSPRINT DD SYSOUT=A //SYSIN DD * * LIST CATALOG(YOURCAT) - TYPE(VSAM) - VOLUMELIST(PRINT) - NODETAIL /*

The following example will list all the VSAM datasets defined in a specific catalog, and save the statistics in predefined dataset to be used later, or to be used in performance or capacity planning.

//LIST EXEC PGM=VSUM,REGION=1024K //STEPLIB DD DSN=XXXX,DISP=SHR //SYSPRINT DD SYSOUT=A //DSSTATS DD DSN=YOUR.SAVED.STATS.FILE,DISP=SHR //SYSIN DD * * LIST CATALOG(YOURCAT) - TYPE(VSAM) - DSSTATDD(DSSTATS) - SAVE /* *

List All Volumes Defined in a Catalog and Show the VSAM Space—Total, Used, and Free Tracks

List All VSAM Datasets in a Catalog and Save the Statistics Produced


57

Output Examples and Descriptions

SAMPLE VSUM LIST COMMAND INPUT AND OUTPUT

LIST NAME(VSTAR.BOBS.CONTROL.FILE) TYPE(KSDS) - CAT(CATALOG.MVSICFU.VSTAR01)

------------------------------------------------------------------------------------------------------------------------------------ F A N T O M S Y S T E M S VSUM CATALOG LIST PAGE=10 CAT=UCAT16 RUN DATE=07/23/2017 RUN TIME=07.50.13 RUN TYPE=NEW,LIST ------------------------------------------------------------------------------------------------------------------------------------ VSTAR.BOBS.OSS32.CONTROL.FILE (KSDS) CREATED=07/23/2017 EXPIRES=00/00/0000 VSTAR.BOBS.CONTROL.FILE.DATA (DATA) LASTUPDTE=07/UTA - UFO TRACKING VSTAR.BOBS.CONTROL.FILE.INDEX (INDX) CICS145 - MVS2 CICS 1.5 TEST *--------------------D A T CICS------------------*------------I N D E X------------- * CISIZE 4096 CISPLTS 0 * CISIZE 1024 CISPLTS 0 RECSZ (180 2000) FREESPACE(0 0) * TRKS/CA 12 CASPLTS 0 * TRKS/CA 1 CASPLTS 0 BUFSP (9216) KEYS (24 0) * CI'S/CA 96 SHR OPT (3 3) * CI'S/CA 25 SHR OPT (3 3) * PHYRCSZ 4096 TRK-UTIL% 80 * ENT/SEC 9 LEVELS 1 UNIQUE NOIMBED RECOVERY UPDATE NODSWAIT * RECORDS 105 EXCPS 1030 * RECORDS 1 EXCPS 77 NOREUSE NOREPL NOERASE UNQKEY STAGE * INSERTED 0 DELETED 0 * INSERTED 0 DELETED 0 NOSPANND NOKEYRNG NOWRTCHK UNORDERD * UPDATED 2303 READ 3107 * UPDATED 0 READ 0 * HARBA 393216 HURBA 393216 * HARBA 25600 HURBA 1024 ASSOCIATIONS: * DEFCYLS (1 1) TOTCYLS 1 * DEFTRKS (1 1) TOTTRKS 1 * USEDCYLS 1 FREECYLS 0 * USEDTRKS 1 FREETRK 0 * EXCPRATIO .13 FREEBYTES 315392 * EXCPRATIO .01 HLVLIDX 0 *------------------V O L U M E-------------------*-----------V O L U M E------------ * DEVT 3375 EXTS 1 SEC-ALLOC 0 * DEVT 3375 EXTS 1 SEC-ALLOC 0 * STAR01(12,1) * STAR01(1,1) VSUM-MSG LIST PROCESSING COMPLETED. CONDITION CODE=00000 VSUM-MSG PROGRAM PROCESSING COMPLETED. HIGHEST CONDITION CODE=00000 ------------------------------------------------------------------------------------------------------------------------------------

The VSUM list report shown is the one produced for a single VSAM KSDS or AIX dataset. The report reflects the VSAM catalog statistics for the entire dataset. If limiting input parameters are specified using the list exception criteria, the dataset shown will have met all the applicable parameters.

VSAM KSDS/AIX/ UCAT Entries

Batch Output


58

LIST VSAM DATASET INFORMATION PANEL

--------------- VSUM - VSAM DATASET CATALOG INFORMATION - PAGE 1-------------- COMMAND ==> SAMPLE.DATASET (KSDS) CREATED= 01/01/2017 SAMPLE.DATASET.DATA (DATA) EXPIRES= 02/06/2017 SAMPLE.DATASET.INDEX (INDX) LAST UPDATE= 00/00/0000 SAMPLE.CATALOG.NAME (CATL) TIME= 00:00:00 DATASET ATTRIBUTES: DATASET ACTION FLAGS: UNIQUE IMBED SPEED UPDATE NODSWAIT –EMPTY NOREUSE NOREPL NOERASE UNQKEY BIND SPANNED NOKEYRNG NOWRTCHK UNORDERD *-------------------------------- RECSZ (200 200) BUFSPACE 8704 * DATA COMPONENT ALLOCATION INFO. KEYS (15 10) FREESPACE (20 30) * PRIMARY 1 DEVICE= 3380 ASSOCIATIONS: * SECONDARY 0 TYPE= TRACKS SAMPLE.DATASET.ASSOCIATION * TOTAL 1 (AIX ) * USED 0 FREE 1 -------------------------D A T A C O M P O N E N T--------------------------- VSAM OWNER STAR CI SIZE 4096 RECORDS 0 VOLUMES ALT RKP N/A TRKS/CA 1 INSERTED 0 #1 VOLUM1 EXTENTS 1 CI'S/CA 10 UPDATED 0 #2 SEC. ALLOC 0 PHYRECSZ 4096 DELETED 0 #3 EXCPS 0 CI SPLITS 0 READ 0 #4 EXCPRATIO .0 CA SPLITS 0 HARBA 40960 #5 ---------------------- SHR OPT (3 4) HURBA 0 #6 PF10 = PRINT SCREEN > TRK-UTIL 86 FREEBYTES 40960 #7

This is the first panel displayed when a VSAM KSDS, AIX, or UCAT dataset is selected for display. This panel displays all the cluster and data component information, and any action flags. The index component information is displayed on a similar panel when the <Enter> key is pressed from this panel. The index component information panel is described on the next page.

LIST VSAM DATASET INFORMATION PANEL

--------------- VSUM - VSAM DATASET CATALOG INFORMATION - PAGE 2-------------- COMMAND ==> SAMPLE.DATASET (KSDS) CREATED= 01/01/2017 SAMPLE.DATASET.DATA (DATA) EXPIRES= 02/06/2017 SAMPLE.DATASET.INDEX (INDX) LAST UPDATE= 00/00/0000 SAMPLE.CATALOG.NAME (CATL) TIME= 00:00:00 DATASET ATTRIBUTES: DATASET ACTION FLAGS: UNIQUE IMBED SPEED UPDATE NODSWAIT –EMPTY NOREUSE NOREPL NOERASE UNQKEY BIND SPANNED NOKEYRNG NOWRTCHK UNORDERD *-------------------------------- RECSZ (200 200) BUFSPACE 8704 * INDEX COMPONENT ALLOCATION INFO. KEYS (15 10) FREESPACE (20 30) * PRIMARY 1 DEVICE= 3380 ASSOCIATIONS: * SECONDARY 0 TYPE= TRACKS SAMPLE.DATASET.ASSOCIATION * TOTAL 1 (AIX ) * USED 0 FREE 1 ------------------------I N D E X C O M P O N E N T-------------------------- VSAM OWNER STAR CI SIZE 512 RECORDS 0 VOLUMES ALT RKP N/A TRKS/CA 1 INSERTED 0 #1 VOLUM1 EXTENTS 1 CI'S/CA 46 UPDATED 0 #2 SEC. ALLOC 0 ENT/SECT 3 DELETED 0 #3 EXCPS 0 CI SPLITS 0 READ 0 #4 EXCPRATIO .0 CA SPLITS 0 HARBA 23552 #5 ---------------------- SHR OPT (3 4) HURBA 0 #6 PF10 = PRINT SCREEN > LEVELS 1 HLVLINDX 0 #7

ISPF Output


59

This is the second panel displayed when a VSAM KSDS, AIX, MCAT or UCAT dataset is selected for display. This panel displays all the cluster VSAM defined information, action flags, and index component information. When the <Enter> key is pressed from this panel and the RECOMMENDATIONS option is NO, the data component information will be re-displayed. When the <Enter> key is pressed from this panel and the RECOMMENDATIONS option is YES, the first RECOMMENDATIONS OUTPUT panel will be displayed. Refer to the section “ISPF Output” (page 157) for a description of the RECOMMENDATIONS panels.

KSDS/AIX INFORMATION

(KSDS) (AIX): The cluster level dataset name (DSN) for this dataset.

NOTE: The cluster name for ICF catalog entries is low values (x‘00’s).

CREATED=: The date that this dataset was defined.

EXPIRED=: The date that this dataset is flagged to expire.

LASTUPDTE: The date the associated component was last opened and successfully closed for update processing.

** EXPIRED ** | -EXPIRED- If the current date is greater than the expiration date of the dataset, this flag will appear.

** EMPTY ** | -EMPTY- If the dataset does not contain any records, this flag will appear. HURBA is zero.

* NOTUSABLE * | NOTUSABLE If the dataset is flagged as notusable, this flag will appear.

** RACF ** | -RACF- If the dataset is RACF protected, this flag will appear.

* MISMATCH * | MISMATCH If the data and index component time stamps do not match, this flag will appear.

Field Descriptions


60

DEFINE ATTRIBUTES

RECSZ(avg max): The defined average and maximum record sizes for the dataset.

FREESPACE(CI% CA%): The current control interval and control area freespace values defined for the dataset.

BUFSP (nnnnn): The minimum buffer space requirement defined for the dataset.

KEYS (length offset): The defined key information for the dataset. For KSDS types this is the true key length and offset within each logical record. For AIX types this is the alternate key length and the offset of the AIX key in the VSAM AIX cluster.

ALT-RKP (offset): This is the offset of the alternate key within the associated base cluster records.

UPGRADE/NOUPGRADE: The alternate index dataset is defined as upgradeable or not upgradeable.

UNIQUE/SUBALLOC: The dataset is defined in unique or suballocated dataspace.

IMBED/NOIMBED: The index sequence set is imbedded (IMBED) or is not imbedded (NOIMBED) within the data component control areas.

SPEED/RECOVERY: EOF control interval is written (RECOVERY) or not written (SPEED) after each data CI is written during load processing.

UPDATE/NOUPDATE: The data and/or index component can or cannot be updated. The NOUPDATE can be set by the AMS alter/export commands.

DSWAIT/NODSWAIT: Wait or do not wait for MSS de-staging when VSAM close is issued.

REUSE/NOREUSE: Allows (REUSE) or does not allow (NOREUSE) reloading the dataset without an AMS delete-define.

REPL/NOREPL: The high level index (and sequence set if “NOIMBED”) records are replicated (REPL) or are not replicated (NOREPL) on a track.


61

ERASE/NOERASE: Whether (ERASE) or not (NOERASE) the data component CI’s are to be overwritten with binary zeros when the dataset is deleted.

UNQKEY/NOUNQKEY: The dataset contains unique or non-unique keys.

STAGE/BIND/CYLFAULT: How dataset is to be staged if defined on MSS.

SPANNED/NONSPANND: Whether (SPANNED) or not (NONSPANND) records are allowed to cross control interval boundaries.

KEYRANGE/NOKEYRNG: Whether (KEYRANGE) or not (NOKEYRNG) the dataset is divided into keyranges.

WRTCHK/NOWRTCHK: Whether (WRTCHK) or not (NOWRTCHK) the data written to the dataset is to be tested for a “data check” condition after each write.

ORDERED/UNORDERD: Whether (ORDERED) or not (UNORDERD) the volumes are to be used in the order specified.

TEMPEXPR: The dataset or index has been temporarily exported and is not to be deleted.

SWAP/NOSWAP Whether (SWAP) or not (NOSWAP) the PAGESPACE is defined as SWAPPABLE.

ASSOCIATIONS: The names of any associated alternate indexes or base clusters will be listed.

CATALOG INFORMATION

DATA | INDEX COMPONENTS

CISIZE: The control interval size of the component.

CISPLITS: The number of times a control interval split occurred.

TRKS/CA: The number of tracks in a control area.


62

CASPLITS: The number of times a control area split occurred.

CI’S/CA: The number of control intervals in a control area.

SHR OPT: The cross region and cross system share options.

ENT/SEC: The number of index entries per section in the index component.

LEVELS: The number of index levels in the index component.

PHYRCSZ: The size of the physical record for the associated component.

TRK-UTIL%: The percentage of available bytes on a track that can be used for control intervals.

RECORDS: The number of logical records in the component.

EXCPS: The number of execute channel programs issued for the component since the last define.

INSERTED: The number of logical records inserted (added) to the component since the last define.

DELETED: The number of logical records deleted from the component since the last define.

UPDATED: The number of logical records updated in the component since the last define.

READ: The number of logical records read from the component since the last define.

HARBA: The highest allocated relative byte address for the component.

HURBA: The highest used relative byte address for the component (rounded up to a control area boundary).


63

DEFCYLS/DEFTRKS: The primary and secondary allocation amounts specified when the component was defined.

TOTCYLS/TOTTRKS: The total number of cylinders/tracks currently allocated for the component.

USEDCYLS/USEDTRKS: The total number of cylinders/tracks in the component that contains data.

FREECYLS/FREETRKS: The total number of cylinders/tracks in the component that are free (contain no data).

EXCPRATIO: The ratio of EXCP’s to logical I/O requests. This value can be used as a guide to determine whether insufficient buffers are being specified by the application programs processing this component. The value represents the average number of EXCP’s issued for each logical I/O request and is calculated as follows:


For the index component calculation, the RECORDS, READ, UPDATED, and DELETED values from the data component are used with the EXCPS value of the index component. This is because all logical record requests are maintained in the data component not the index component statistics.

NOTE: When a component is opened for control interval processing by a program, the EXCPS value is the only value incremented and could cause an unusually high EXCPRATIO and does not reflect insufficient buffers.

FREEBYTES: The total number of free bytes in the data component that are in unused control areas.

HLVLIDX: The number of records in the high level(s) of the index. This value does not include the sequence set records.

VOLUME: The DASD volume information for this component.

DEVT: The mnemonic DASD device type that the component is defined on.


64

EXTS: The total number of extents allocated to the component.

SEC-ALLOC: The number of times that this component has gone into secondary allocation.

volser(tracks,extents | CANDT | IMB): The total number of tracks allocated to the volume(keyrange) entry, and the total number of extents for the allocated tracks.

CANDT indicates that the volume does not contain any allocated tracks but is a candidate for allocation if needed.

IMB indicates that the index volume entry’s tracks are imbedded in the associated data component because the “IMBED” option was specified during DEFINE.

------------------------------------------------------------------------------------------------------------------------------------ VSAM.SAMPLE.LIST.ESDS (ESDS) CREATED=04/15/2017 EXPIRES=00/00/0000 VSAM.SAMPLE.LIST.ESDS.DATA (DATA) LASTUPDTE=05/01/2017 06:01:00 *--------------------D A T A---------------------* * CISIZE 16384 * RECSZ (1800 2040) * TRKS/CA 15 * BUFSP (33280) * CI'S/CA 37 SHR OPT (2 3) * * PHYRCSZ 4096 TRK-UTIL% 86 * UNIQUE NOIMBED SPEED UPDATE NODSWAIT * RECORDS 1 EXCPS 21 * NOREUSE NOREPL NOERASE UNQKEY STAGE * INSERED 0 DELETED 0 * NOSPANND NOKEYRNG NOWRTCHK UNORDERD TEMPEXPR * UPDATED 0 READ 8 * * HARBA 606208 HURBA 606208 * ASSOCIATIONS: * DEFCYLS (1 0) TOTCYLS 1 * * USEDCYLS 1 FREECYLS 0 * * EXCPRATIO 2.3 FREEBYTES 589824 * *------------------V O L U M E-------------------* * DEVT 3380 EXTS 1 SEC-ALLOC 0 * * VOL009(15,1) * ------------------------------------------------------------------------------------------------------------------------------------

The VSUM list report shown is the one produced for a single VSAM ESDS or RRDS dataset. The report reflects the VSAM catalog statistics for the entire dataset. If limiting input parameters are specified using the list exception criteria, the dataset shown will have had to meet all the applicable parameters

VSAM ESDS/RRDS/ VVDS/PAGE Entries

Batch Output


65

--------------- VSUM - VSAM DATASET CATALOG INFORMATION - PAGE 1-------------- COMMAND ==> SAMPLE.DATASET (ESDS) CREATED= 01/01/2017 SAMPLE.DATASET.DATA (DATA) EXPIRES= 02/06/2017 LAST UPDAT LAST UPDATE= 00/00/0000 SAMPLE.CATALOG.NAME (CATL) TIME= 00:00:00 DATASET ATTRIBUTES: DATASET ACTION FLAGS: UNIQUE NOIMBED SPEED UPDATE NODSWAIT –EMPTY NOREUSE NOREPL NOERASE UNQKEY BIND SPANNED NOKEYRNG NOWRTCHK UNORDERD *-------------------------------- RECSZ (200 200) BUFSPACE 8704 * DATA COMPONENT ALLOCATION INFO. KEYS N/A FREESPACE N/A * PRIMARY 1 DEVICE= 3380 ASSOCIATIONS: * SECONDARY 0 TYPE= TRACKS * TOTAL 1 * USED 0 FREE 1 -------------------------D A T A C O M P O N E N T--------------------------- VSAM OWNER STAR CI SIZE 4096 RECORDS 0 VOLUMES ALT RKP N/A TRKS/CA 1 INSERTED 0 #1 VOLUM1 EXTENTS 1 CI'S/CA 10 UPDATED 0 #2 SEC. ALLOC 0 PHYRECSZ 4096 DELETED 0 #3 EXCPS 0 CI SPLITS N/A READ 0 #4 EXCPRATIO .0 CA SPLITS N/A HARBA 40960 #5 ---------------------- SHR OPT (3 4) HURBA 0 #6 PF10 = PRINT SCREEN > TRK-UTIL 86 FREEBYTES 40960 #7

This is the only panel displayed when a VSAM ESDS, RRDS, VVDS, or PAGE dataset is selected for display. This panel displays all the cluster VSUM defined information, action flags, and data component information.

ESDS/RRDS ENTRY INFORMATION

(ESDS) | (RRDS): The cluster level dataset name (DSN) for this dataset.

CREATED=: The date that this dataset was defined.

EXPIRED=: The date that this dataset is flagged to expire.

LASTUPDTE: The date the associated component was last opened and successfully closed for update processing.

If the current date is greater than the expiration date of the dataset, this flag will appear.

** EXPIRED ** | -EXPIRED- If the current date is greater than the expiration date of the dataset, this flag will appear.

ISPF Output

Field Descriptions


66

** EMPTY ** | -EMPTY- If the dataset does not contain any records, this flag will appear. HURBA is zero.

* NOTUSABLE * | NOTUSABLE If the dataset is flagged as notusable, this flag will appear.

** RACF ** | -RACF- If the dataset is RACF protected, this flag will appear.




SPEED/RECOVERY: EOF control interval is written (recovery) or not written (speed) after each data CI is written during load processing.


DSWAIT/NODSWAIT: Wait or do not wait for MSS de-staging when VSAM close is issued.

REUSE/NOREUSE: Allows (REUSE) or does not allow (NOREUSE) reloading the dataset without an AMS delete-define.

ERASE/NOERASE: Whether (ERASE) or not (NOERASE) the data component CIs are to be overwritten with binary zeros when the dataset is deleted.

STAGE/BIND/CYLFAULT: How dataset is to be staged if defined on| MSS.




67

SWAP/NOSWAP: Whether (SWAP) or not (NOSWAP) the page dataset is defined as swappable.



ASSOCIATIONS: The names of any associated alternate indexes or base cluster’s will be listed.

CATALOG INFORMATION

DATA COMPONENT











68








USEDCYLS/USEDTRKS: The total number of cylinders/tracks in the component that contain data.

FREECYLS/FREETRKS: The total number of cylinders/tracks in the component that are free (contain no data).

EXCPRATIO: The ratio of EXCP’s to logical I/O requests. This value can be used as a guide to determine whether insufficient buffers are being specified by the application programs processing this component. The value represents the average number of EXCP’s issued for each logical I/O request and is calculated as follows:


EXCPS RRDS ONLY ------------------------------------ INSERTED+READ+(UPDATED*2)+(DELETED*2)


69

The INSERTED value is used in place of the RECORDS value for RRDS datasets because the RECORDS value reflects total possible records not actual or loaded records in the dataset.


FREEBYTES: The total number of free bytes in the data component that are in unused control areas.





volser(tracks,extents | CANDT): The total number of tracks allocated to the volume entry, and the total number of extents for the allocated tracks.


-------------------------------------------------------------------------------------------------------- CICSCAT.PRIMARY.PATH (PATH) CREATED=04/19/2017 EXPIRED=00/00/0000 ATTRIBUTES: UPGRADE ASSOCIATIONS: CICSCAT.PRIMARY.ALTRNAT.INDEX (AIX) --------------------------------------------------------------------------------------------------------

The VSUM list report shown is the one produced for a single PATH entry. The report reflects the VSAM catalog information for the entry. If limiting input parameters are specified using the list exception criteria, the dataset shown will have had to meet all the applicable parameters.

Path Entry

Batch Output


70

---------------- VSUM - PATH/GDG DATASET CATALOG INFORMATION ------------------ COMMAND ==> DATASET NAME AND CATALOG: TYPE: SAMPLE.PATH.DATASET (PATH ) CREATED= 02/06/2017 SAMPLE.CATALOG.NAME (CATALOG) EXPIRES= 02/05/2017 DATASET ATTRIBUTES: DATASET ACTION FLAGS: UPGRADE * EXPIRED * ASSOCIATIONS: NUM DATASET NAME TYPE: #01 SAMPLE.AIX.DATASET (AIX) #02 #03 #04 #05 #06 #07 #08 PF1=HELP PF10=PRINT SCREEN

This panel is displayed when a PATH entry is selected for display.

PATH ENTRY INFORMATION

(PATH): The dataset name of this path.

CREATED=: The date that this path was defined.

EXPIRED=: The date that this path is flagged to expire.

** EXPIRED **: If the current date is greater than the expiration date, this flag will appear.

ATTRIBUTES

UPGRADE: Whenever the base cluster associated with this path is updated, the update should also be made to the path and alternate index.

ASSOCIATIONS: The names of any associated alternate indexes will be listed.

ISPF Output

Field Descriptions


71

-------------------------------------------------------------------------------------------------------------------------- UCAT.BACKUP.CONTROL.FILE.G0786V00 (NONVSAM) CREATED=01/01/2017 EXPIRED=00/00/0000 ASSOCIATIONS: UCAT.BACKUP.CONTROL.FILE (GDGBASE) DEVICE TYPE: TAPE VOLSER: 001001 FILESEQ: 1 --------------------------------------------------------------------------------------------------------------------------

The VSUM list report shown is the one produced for a single NONVSAM file. The report reflects the VSAM catalog information for the file. If limiting input parameters are specified using the list exception criteria, the file shown will have had to meet all the applicable parameters.

---------------- VSUM - NON-VSAM DATASET CATALOG INFORMATION ------------------ COMMAND ==> DATASET NAME AND CATALOG: TYPE: SAMPLE.NONVSAM.DATASET (NONVSAM) CREATED= 02/06/2017 SAMPLE.CATALOG.NAME (CATALOG) EXPIRES= 02/25/2017 DATASET ACTION FLAGS: DEVICE TYPE 3380 VOLUME VOLUM1 FILE NUMBER 000001 ASSOCIATIONS: NUM DATASET NAME TYPE #01 #02 #03 #04 #05 #06 #07 #08 PF1=HELP PF10=PRINT SCREEN

This panel is displayed when a non-VSAM entry is selected for display.

NONVSAM ENTRY INFORMATION

(NONVSAM): The dataset name (DSN) for this NONVSAM file.

CREATED=: The date that this NONVSAM file was defined to the system.

NONVSAM Entry

Batch Output

ISPF Output

Field Descriptions


72

EXPIRED=: The date that this file is flagged to expire.

** EXPIRED **: If the current date is greater than the expiration date of the file, this flag will appear.

ASSOCIATIONS: The names of any associated generation dataset bases or other files will be listed. A maximum of 38 association names will be listed or displayed. If a GDG has more than 38 associations, they can be listed with the IDCAMS LISTCAT function.

-------------------------------------------------------------------------------------------------------------------------- VOLUM01 (VOLUME) TIMESTAMP=12/03/2017 19:16:17 DEVICE CHARACTERISTICS: DEVICE TYPE: 3380 MAX BLKSIZE: 32760 TOTAL CYLS: 886 TRKS/CYL: 15 BYTES/TRK: 47968 --------------------------------------------------------------------------------------------------------------------------

The VSUM list report shown is the one produced for a single DASD volume. The report reflects the VSAM catalog characteristics for the specified volume. If list exception criteria are used, the volume shown will have had to meet all the applicable parameters. To list only a volume within a catalog, the volume serial number must be entered in the VOLUME parameter rather than the NAME parameter. The catalog where the volume is defined must also be entered in the CATALOG parameter for any information to be found.

Volume Entry

Batch Output


73

----------------- VSUM - VOLUME ENTRY CATALOG INFORMATION --------------------- COMMAND ==> VOLUME NAME AND CATALOG: TYPE: VOLUME (VOLUME ) CREATED= 02/06/2017 TIME= 12:15:37 SAMPLE.CATALOG.NAME (CATALOG) DEVICE TYPE 3380 TOTAL CYLINDERS 886 MAXIMUM BLOCKSIZE 32760 TRACKS/CYLINDER 15 BYTES/TRACK 47968 PF1=HELP PF10=PRINT SCREEN

This panel is displayed when a VOLUME entry is selected for display.

VOLUME ENTRY INFORMATION

(VOLUME): The DASD volume identification for this device.

TIMESTAMP: The date and time that the volume was defined to the system.

DEVICE CHARACTERISTICS

DEVICE TYPE: The DASD mnemonic device type.

MAX BLKSIZE: The maximum block size, in bytes, allowed on this device.

TOTAL CYLS: The total number of cylinders available on this device.

TRKS/CYL: The number of tracks per cylinder on this device.

BYTES/TRK: The total number of bytes available on each track of this device.

ISPF Output

Field Descriptions


74

-------------------------------------------------------------------------------------------------------------------------- CICS (ALIAS) CREATED=01/01/2017 EXPIRED=00/00/0000 ASSOCIATIONS: CICSCAT (USERCAT) --------------------------------------------------------------------------------------------------------------------------

The VSUM list report shown is the one produced for a single ALIAS entry. The report reflects the VSAM catalog information for the entry. If limiting input parameters are specified using the list exception criteria, the entry shown will have had to meet all the applicable parameters.

----------------- VSUM - ALIAS DATASET CATALOG INFORMATION -------------------- COMMAND ==> ALIAS NAME AND CATALOG: TYPE: SAMPLE.USER.CATALOG (USERCAT) SAMPLE.MASTER.CATALOG (CATALOG) DATASET ACTION FLAGS: ASSOCIATIONS: NUM DATASET NAME TYPE: #01 #02 #03 #04 #05 #06 #07 #08 PF1=HELP PF10=PRINT SCREEN

This panel is displayed when an ALIAS entry is selected for display.

ALIAS ENTRY INFORMATION

(ALIAS): The name of this alias.

CREATED=: The date that this alias was defined.

EXPIRED=: The date that this alias is flagged to expire.

Alias Entry

Batch Output

ISPF Output

Field Descriptions


75


ASSOCIATIONS: The names of any associated catalogs will be listed. A maximum of 38 association names will be listed or displayed. If a GDG has more than 38 associations, they can be listed with the IDCAMS LISTCAT function.

DEVICE TYPE: The mnemonic device type of the device that the file is defined on.

VOLSER: The volume serial information for this file.

FILESEQ: For tapes only, this is the file sequence associated with the displayed volume serial number.

---------------------------------------------------------------------------------------------------------------- UCAT.BACKUP.CONTROL.FILE (GDG BASE) CREATED=06/20/2017 EXPIRED=00/00/0000 ATTRIBUTES: GDGLIMIT 3 DELETE LAST SCRATCH DSCB ASSOCIATIONS: UCAT.BACKUP.CONTROL.FILE.G0786V00 (NONVSAM) UCAT.BACKUP.CONTROL.FILE.G0787V00 (NONVSAM) UCAT.BACKUP.CONTROL.FILE.G0788V00 (NONVSAM) ----------------------------------------------------------------------------------------------------------------

The VSUM list report shown is the one produced for a single GDGBASE entry. The report reflects the VSAM catalog information for the entry. If limiting input parameters are specified using the list exception criteria, the entry shown will have had to meet all the applicable parameters.

GDGBASE Entry

Batch Output


76

---------------- VSUM - PATH/GDG DATASET CATALOG INFORMATION ------------------ COMMAND ==> DATASET NAME AND CATALOG: TYPE: SAMPLE.GDG.BASE (GDGBASE) CREATED= 02/06/2017 SAMPLE.CATALOG.NAME (CATALOG) EXPIRES= 02/05/2017 DATASET ATTRIBUTES: DATASET ACTION FLAGS: GDGLIMIT 1 * EXPIRED * DELETE LAST SCRATCH DSCB ASSOCIATIONS: NUM DATASET NAME TYPE: #01 SAMPLE.GDG.BASE.G00V0001 (NONVSAM) #02 #03 #04 #05 #06 #07 #08 PF1=HELP PF10=PRINT SCREEN

This panel is displayed when a GDG entry is selected for display.

GDGBASE ENTRY INFORMATION

(GDGBASE): The name assigned this GDGbase.

CREATED=: The date that this GDGbase was defined.

EXPIRED=: The date that this GDGbase is flagged to expire.


ATTRIBUTES

GDGLIMIT: The maximum number of generations to be catalogued for this GDGbase.

DELETE LAST: Once the maximum number of generations to be catalogued for this GDGbase has been reached, the oldest member should be scratched.

SCRATCH DSCB: When the GDGbase is uncatalogued, its DSCB should be scratched.

ISPF Output

Field Descriptions


77

ASSOCIATIONS: The names of any existing generations associated with this GDGbase will be listed. A maximum of 38 association names will be listed or displayed. If a GDG has more than 38 associations, they can be listed with the IDCAMS LISTCAT function.

The VSUM BUFFERTABLE REPORT and TOTALS can be printed by specifying the “BUFERTABLE” parameter in the LIST command. These reports are printed to the BUFPRINT DD statement.

NOTE: This report is not available through the VSUM ISPF LIST function.

CONTROL INTERVAL SIZES IN K 1 1 1 1 1 2 2 2 2 2 3 3 DATASET NAME TYPE . 1 . 2 . 3 . 4 . 5 . 6 . 7 . 8 0 2 4 6 8 0 2 4 6 8 0 2 EXCPS TOTALIO RATIO _*_*___*_______*_______________*___*___*___*___*___*___* CICSCAT.VSAM.CMASTR.AIX A CICSCAT.VSAM.CMASTR.AIX.DATA D X 15 15 1.00 CICSCAT.VSAM.CMASTR.AIX.INDEX I X 4 15 .26 +CICSCAT.VSAM.CMASTR.BASE K CICSCAT.VSAM.CMASTR.BASE.DATA D X 15 15 1.00 CICSCAT.VSAM.CMASTR.BASE.INDEX I X 4 15 .26 CICSCAT.VSAM.FILE.DPAUDIT E VSAMDSET.T25EE2F2.DFD83196.T95D8472.T25EE2F2D X 16 56 .28 CICSCAT.VSAM.TEST K CICSCAT.VSAM.TEST.DT D X 15 15 1.00 CICSCAT.VSAM.TEST.ID I X 4 15 .26 _*_*___*_______*_______________*___*___*___*___*___*___* 1 1 1 1 1 2 2 2 2 2 3 3 . 1 . 2 . 3 . 4 . 5 . 6 . 7 . 8 0 2 4 6 8 0 2 4 6 8 0 2

The VSUM list report shown is the one produced when BUFFERTABLE(ACCUM) or BUFFERTABLE(PRINT) is chosen for VSUM LIST processing. Entries are shown for all VSAM KSDS, ESDS, RRDS, and AIX datasets processed during the current list. If limiting parameters are specified using the list exception criteria, the entries shown will be for those datasets that have had to meet all the applicable parameters.

BUFFERTABLE REPORT INFORMATION

DATASET NAME The cluster, data, or index dataset name (DSN) associated with this dataset.

A ‘+’ preceding the dataset name indicates that this is a base cluster with an alternate index associated with it.

TYPE The type of the associated dataset name.

A: AIX (alternate index) cluster name

E: ESDS cluster name

VSAM Buffertable

Buffer Report


78

K: KSDS cluster name

D: data component name

I: index component name

CONTROL INTERVAL SIZES IN K An entry is made for the corresponding control interval size of each component of each dataset processed.

The control interval sizes shown with a ‘*’ on the rule line indicate that the size is valid for use in the VSAM LSR buffer pool. Datasets with other control interval sizes would need the next larger LSR buffer pool size.

EXCPS The number of execute channel programs issued for the component since the last define.

TOTALIO The total logical I/O requests associated with the given component. It is calculated as follows:

TOTALIO=RECORDS + READ + (UPDATED*2) + (DELETED*2)

For the index component, the RECORDS, READ, UPDATED, and DELETED values are taken from the data component. The reason the data component values are used is because the logical record requests for the dataset are not reflected in the index component values.

RATIO The ratio of EXCP’s to logical I/O requests. This value can be used as a guide to determine whether insufficient buffers are being specified by the application programs processing this component. The value represents the average number of EXCP’s issued for each logical I/O request and is calculated as follows:


For the index component calculation, the RECORDS, READ, UPDATED, and DELETED values from the data component are used with the EXCPS value of the index component.



79

VSAM DATASETS BUFFER TOTALS *--------------------D A T A---------------------*------------I N D E X------------- * * * CISIZE TOTAL DS * CISIZE TOTAL DS HIGH LEVEL INDX * * * 512 1 * 512 1 0 * 1024 0 * 1024 0 0 * 1536 0 * 1536 1 0 * 2048 0 * 2048 0 0 * 2560 1 * 2560 0 0 * 3072 0 * 3072 0 0 * 3584 0 * 3584 0 0 * 4096 1 * 4096 0 0 * 4608 1 * 4608 0 0 * 5120 0 * 5120 0 0 * 5632 0 * 5632 0 0 * 6144 0 * 6144 0 0 * 6656 0 * 6656 0 0 * 7168 0 * 7168 0 0 * 7680 0 * 7680 0 0 * 8192 0 * 8192 0 0 * 10240 0 * 10240 0 0 * 12288 0 * 12288 0 0 * 14336 0 * 14336 0 0 * 16384 0 * 16384 0 0 * 18432 0 * 18432 0 0 * 20480 0 * 20480 0 0 * 22528 0 * 22528 0 0 * 24576 0 * 24576 0 0 * 26624 0 * 26624 0 0 * 28672 0 * 28672 0 0 * 30720 0 * 30720 0 0 * 32768 0 * 32768 0 0 *------------------------------------------------*----------------------------------

The VSUM total report shown is produced when BUFFERTABLE(ACCUM) or BUFFERTABLE(PRINT) is chosen for VSUM list processing. Totals are shown for all KSDS, ESDS, RRDS, or AIX datasets processed during the current list or combination of lists in the case of (ACCUM). If limiting parameters are specified using the list exception criteria, the totals shown will be for those datasets that have had to meet all the applicable parameters.

BUFFER TOTAL INFORMATION


CISIZE: An entry is made for each valid control interval size according to the component type (i.e. data or index).

TOTAL DS: The total number of datasets found with each valid control interval size listed.

HIGH LEVEL INDX: The total number of high level index records for all keyed datasets for this index control interval size. This value plus total strings can be used as a minimum if you which to provide enough index buffers in your GSR or LSR pool to hold the high level index records for the datasets sharing the buffer pool. The advantage of having the high level index records in the buffer pools is more “successful look-asides” and subsequently fewer EXCPS to the index components.

Buffer Totals


80

The VSUM TOTAL reports are optional reports that can be requested by LIST command options. These reports are printed accumulations of values such as; Totals of dataset entry types listed (DATASET TOTALS); Totals of VSAM record statistics for all VSAM datasets listed (VSAM RECORD TOTALS); High-low values of VSAM dataset statistics for all VSAM datasets listed (VSAM DATASET RANGES). Total space utilization statistics for all volumes for which datasets listed were allocated (VSAM VOLUME TOTALS).

All these total reports are printed to the SYSPRINT DD statement and are available only by BATCH execution, not through the VSUM ISPF LIST function.

TOTAL AIX DATASETS 0 TOTAL KSDS DATASETS 8 TOTAL ESDS DATASETS 0 TOTAL RRDS DATASETS 1 TOTAL PATH ENTRIES 0 TOTAL ALIAS ENTRIES 0 TOTAL GDGBASE ENTRIES 2 TOTAL NONVSAM FILES 33

The VSUM total report shown is the one produced when LISTTOTALS(ACCUM) or LISTTOTALS(PRINT) is chosen for VSUM list processing. Totals are shown for all datasets or entries processed during the current list or combination of lists in the case of (ACCUM). If limiting parameters are specified using the list exception criteria, the totals shown will be for those datasets or entries that have had to meet all the applicable parameters.

TOTAL AIX DATASETS: The total number of alternate index datasets encountered.

TOTAL KSDS DATASETS: The total number of KSDS, UCAT, and MCAT datasets encountered.

TOTAL ESDS DATASETS: The total number of ESDS, VVDS, PAGE datasets encountered.

TOTAL RRDS DATASETS: The total number of RRDS datasets encountered.

TOTAL PATH ENTRIES: The total number of PATH’s encountered.

TOTAL ALIAS ENTRIES: The total number of ALIAS’s encountered.

TOTAL GDGBASE ENTRIES: The total number of GDGBASE’s encountered.

Total Reports

Dataset Totals


81

TOTAL NONVSAM FILES: The total number of NONVSAM files encountered.

VSAM DATASETS RECORD TOTALS: *--------------------D A T A---------------------*------------I N D E X------------- * * * TOTAL RECORDS 67655 * TOTAL RECORDS 189 * TOTAL INSERTED 5090 * TOTAL INSERTED 0 * TOTAL UPDATED 229403 * TOTAL UPDATED 699 * TOTAL DELETED 1796 * TOTAL DELETED 0 * TOTAL READ 5718534 * TOTAL READ 0 * TOTAL EXCPS 1916010 * TOTAL EXCPS 489179 * * *------------------------------------------------*----------------------------------

The VSUM total report shown is the one produced when RECTOTALS(ACCUM) or RECTOTALS(PRINT) is chosen for VSUM list processing. Totals are shown for all VSAM KSDS, RRDS, ESDS, or AIX datasets process during this list or combination of lists in the case of (ACCUM). If limiting parameters are specified using the list exception criteria, the totals shown will be for those datasets that have had to meet all the applicable parameters.


TOTAL RECORDS: The total number of logical records occurring in all the datasets processed.

TOTAL INSERTED: The total number of logical records inserted (added) to the datasets processed since their last define.

TOTAL DELETED: The total number of logical records deleted from the datasets processed since their last define.

TOTAL UPDATED: The total number of logical records updated in the datasets processed since their last define.

TOTAL READ: The total number of logical records read from the datasets processed since their last define.

TOTAL EXCPS: The total number of execute channel programs issued for the datasets processed since their last define.

VSAM Record Totals


82

VSAM DATASET RANGES: *--------------------D A T A---------------------*------------I N D E X------------- * * * CASPLITS SMALLEST 0 * CASPLITS SMALLEST 0 * LARGEST 9 * LARGEST 1 * TOTAL 9 * TOTAL 1 * CISPLITS SMALLEST 0 * CISPLITS SMALLEST 0 * LARGEST 147 * LARGEST 9 * TOTAL 9 * TOTAL 9 * CISIZE SMALLEST 512 * CISIZE SMALLEST 512 * LARGEST 16384 * LARGEST 4096 * * * EXCPRATIO SMALLEST .06 * EXCPRATIO SMALLEST .00 * LARGEST 2.33 * LARGEST 4.88 * * * RECSZ SMALLEST 100 * IXLEVELS SMALLEST 1 * LARGEST 2000 * LARGEST 3 * * * TRK-UTIL% SMALLEST 72 * * LARGEST 94 * * * * KEYS SMALLEST 9 * * LARGEST 44 * * * * PHYRCSZ SMALLEST 512 * * LARGEST 4096 * * * *------------------------------------------------*----------------------------------

The VSUM total report shown is the one produced when RANGETOTALS(ACCUM) or RANGETOTALS(PRINT) is chosen for VSUM list processing. Totals are shown for all VSAM KSDS, RRDS, ESDS, or AIX datasets processed during this list or combination of lists in the case of (ACCUM). If limiting parameters are specified using the list exception criteria, the ranges/totals shown will be for those datasets that have had to meet all the applicable parameters.

VSAM DATASETS RANGES INFORMATION


CASPLITS

SMALLEST: The fewest number of control area splits occurring in any one of the datasets processed.

LARGEST: The largest number of control area splits occurring in any one of the datasets processed.

TOTAL: The total number of control area splits occurring in all the datasets processed.

VSAM Datasets Ranges


83

CISPLITS

SMALLEST: The fewest number of control interval splits occurring in any one of the datasets processed.

LARGEST: The largest number of control interval splits occurring in any one of the datasets processed.

TOTAL: The total number of control interval splits occurring in all the datasets processed.

CISIZE

SMALLEST: The smallest control interval size encountered in any one of the datasets processed.

LARGEST: The largest control interval size encountered in any one of the datasets processed.

EXCPRATIO

SMALLEST: The smallest ratio of EXCP’s to logical I/O requests encountered in any one of the datasets processed.

LARGEST: The largest ratio of EXCP’s to logical I/O requests encountered in any one of the datasets processed.

RECSZ

SMALLEST: The smallest defined average or maximum record size encountered in any one of the datasets processed.

LARGEST: The largest defined average or maximum record size encountered in any one of the datasets processed.

IXLEVELS

SMALLEST: The smallest number of index levels in the index component of any one of the datasets processed.


84

LARGEST: The largest number of index levels in the index component of any one of the datasets processed.

TRK-UTIL%

SMALLEST: The smallest percentage of available bytes on a track that can be used for control intervals encountered on any one of the datasets processed.

LARGEST: The largest percentage of available bytes on a track that can be used for control intervals encountered on any one of the datasets processed.

KEYS

SMALLEST: The smallest defined key length encountered on any one of the datasets processed.

LARGEST: The largest defined key length encountered on any one of the datasets processed.

PHYRCSZ

SMALLEST: The smallest physical record size encountered on any one of the datasets processed.

LARGEST: The largest physical record size encountered on any one of the datasets processed.

VOLUME TOTALS: *--------*------*----------------*----------------*---------------*----------------* * VOLSER *DEVTYP*F REETRKS * USEDTRKS * #EXTS * TOTTRKS * *--------*------*----------------*----------------*---------------*----------------* * * * * * * * * VOL004 * 3380 * 478 * 497 * 2 * 975 * * VOL009 * 3380 * 921 * 304 * 6 * 1225 * * VOLB04 * 3350 * 1594 * 266 * 13 * 1860 * * MSSVL2 * MSS * 567 * 953 * 2 * 1520 * * MSSVL1 * MSS * 567 * 953 * 2 * 1520 * *--------*------*----------------*----------------*---------------*----------------* * * * 4127 * 2973 * 25 * 7100 * *--------*------*----------------*----------------*---------------*----------------*

The VSUM total report shown is the one produced when VOLUMETOTALS(ACCUM) or VOLUMETOTALS(PRINT) is chosen for VSUM list processing. Totals are shown for all KSDS, ESDS, RRDS, or AIX datasets processed during the current list or combination of lists in the case of (ACCUM). If limiting parameters are specified through the

VSAM Volume Totals


85

use of the list exception criteria, the totals shown will be for those datasets or entries that have had to meet all the applicable parameters.

VSAM VOLUME TOTAL INFORMATION

VOLSER: The DASD volume serial number.

DEVTYP: The mnemonic DASD device type.

FREETRKS: The total number of tracks on the device that are free (contain no data).

USEDTRKS: The total number of tracks on the device that contains data.

#EXTS: The total number of extents allocated on the device.

TOTTRKS: The total number of tracks currently allocated on the device.

86

3 Dataset Analyze/Backup

Overview

The VSUM ANALYZE function allows accurate space utilization analysis, backup, and performance recommendations for VSAM KSDS and AIX datasets. VSAM catalogs can also be analyzed for accurate space utilization only, the backup function must not be used as the main backup mechanism for VSAM catalogs. VSUM accomplishes a truly accurate analysis via actual dataset interrogation coupled with catalog information. The VSUM ANALYZE function reports provide graphic and statistical information at the Dataset, Control Area, and Control Interval level. The ANALYZE function can optionally make recommendations on dataset attributes, control interval sizes, freespace percentages, reorganization considerations, buffer space requirements, and space requirements for new device types. Refer to chapter 0, “Dataset Recommendations,” for a detailed description of the RECOMMENDATION options.

The ANALYZE function can be performed for more than one dataset per execution by specifying multiple ANALYZE commands or by the LIST ANALYZE function (refer to chapter 0, “Catalog List/Search”). The VSAM file(s) to be analyzed will be dynamically allocated with a disposition of SHR when the ANALYZE NAME (no BKUPDD option) or LIST ANALYZE function is specified. A disposition of OLD will be dynamically allocated when the ANALYZE NAME BKUPDD function is specified.

The reports are all optional, and the analysis of the dataset can be performed on a complete dataset (default) or on a partial dataset based on volume, keyrange, relative control area number(s), or control area sampling. The VSAM KSDS/AIX can be BACKED UP to another VSAM or sequential dataset during complete ANALYZE functions only.

VSUM FOR Z/OS PROGRAM DESCRIPTION AND OPERATIONS GUIDE Dataset Analyze/Backup

87

The largest record size allowed during backup is 32752. The backup dataset can be a VSAM KSDS, ESDS, or RRDS (fixed length records) or a variable blocked, non-spanned sequential dataset. If duplicate or out of sequence keys are encountered during backup and the index component has valid pointers, the backup will continue minus those records whose keys were duplicates or out of sequence, and the backup totals will reflect all errors encountered. You can optionally write all records with duplicate or out of sequence keys to an ERROR file for subsequent inspection. This option can be beneficial when you do not have a valid backup for a KSDS that becomes corrupted and the IDCAMS REPRO function will not copy the dataset because of too many errors. Dataset integrity cannot be maintained if the ANALYZE/BACKUP function is performed while a dataset is being updated by another job.

The statistics used for the ANALYZE reports may be saved on a statistical file and reprinted at a later time with the REPRINT function.

The ISPF ANALYZE function provides you with the same capability as the batch analyze function except CI reporting, and can be executed in either foreground or background (batch) mode. Because the ANALYZE function must read all the control intervals of a dataset being analyzed, foreground execution should be limited to small datasets. The VSUM ANALYZE reports are available for selection and viewing when foreground ANALYZE is executed. When a background ANALYZE is selected by the ISPF interface, the ANALYZE reports are not available for on-line viewing using the VSUM ISPF interface, however, they may be selected and viewed as normal batch job output.

VSAM catalogs can ONLY be analyzed in batch or ISPF background mode. Attempts to analyze VSAM catalogs in ISPF foreground mode will result in an “authorization failure”. In order to analyze VSAM catalogs in batch or ISPF background mode, the VSUM modules must be in an authorized load library, the VSAM catalog being analyzed must be specified in a STEPCAT DD statement, and the master password of the VSAM catalog being analyzed must be specified in the ANALYZE NAME parameter.


88

Suggested Uses

The VSUM ANALYZE function and its various reports can be useful in managing your VSAM keyed datasets and catalogs in the following ways:

• Accurate display of free and used space within your VSAM ICF and non-ICF catalog.

• Accurate free and used space utilization statistics at dataset, control area, and control interval levels for your VSAM keyed datasets and catalogs.

• Graphic display of used, free, and unusable control area space for your VSAM keyed datasets and catalogs.

• Backup of keyed (non-catalog) datasets.

• Backup of keyed (non-catalog) datasets with duplicate/out of sequence keys.

• Detection of unusable or potentially unusable space because of insufficient INDEX control interval sizes and/or poor key compression.

• Detection of excessive index control interval sizes

• Compressed key length determination.

• Effective analysis of freespace percentages for the dataset, and within control areas and control intervals

• Free record estimates within existing freespace.

• Average and maximum record size calculations.

• Control area split detection by keyrange.

• Average and maximum alternate key occurrences for non-unique alternate indexes.

• Recommendations on dataset design, reorganization, number of buffers, and freespace.


89


The VSUM ANALYZE function can be performed in batch mode or by selecting the ANALYZE function ISPF option(s).

A batch mode ANALYZE function can be performed by specifying an ANALYZE or LIST ANALYZE command in the SYSIN DD statement and executing the program VSUM. A batch mode ANALYZE function can also be submitted for batch processing by selecting the background ANALYZE function in the VSUM ISPF panels.

The ISPF ANALYZE function can be performed by specifying option “A” in the command line of VSUM’s PRIMARY OPTION MENU. The user then has the choice of performing the analysis in the foreground or background.

Optionally, a dataset may be analyzed by entering line option “A” in the VSUM LIST DATASET SELECTION PANEL. Regardless of the method chosen, the user’s analysis profile is used to determine the types of reports to be produced for the dataset. These reporting selections may be changed by updating the user’s unique ISPF analysis profile and/or recommendations profile.

When a background ANALYZE function is executed by the ISPF interface, the output is not available for display on your TSO terminal except by normal batch job output display capabilities. However, when a foreground ANALYZE is executed all of the selected ANALYZE reports are displayable by selection through VSUM’s DATASET ANALYSIS REPORT MENU.

Batch Command Input

Batch Mode

ISPF Mode


91

---------------------- VSUM - ANALYZE SELECTION MENU -------------------------- COMMAND ==> B - BACKGROUND VSAM KSDS OR AIX DATASET ANALYSIS F - FOREGROUND VSAM KSDS OR AIX DATASET ANALYSIS

This panel is the first panel of the ANALYZE function and is displayed when “A” is specified in the command line of VSUM’s PRIMARY OPTION MENU described in the “INTRODUCTION” section.

This panel is used to select whether you wish to execute the VSUM ANALYZE function in background or foreground mode.

A note of caution about using the foreground mode option. The ANALYZE function must read all the control intervals of the data and index components of keyed VSAM dataset being analyzed. This is necessary to provide the high degree of accuracy of our dataset statistics and space utilization reports-graphs. Only very small datasets should be ANALYZED in foreground mode in order to prevent unnecessarily long terminal wait times.

ISPF Input Panels

ANALYZE SELECTION MENU


92

------------ VSUM - ANALYZE VSAM KSDS OR AIX DATASET (FOREGROUND) -----------

-- COMMAND ==> DATASET NAME/PSWD ==> ANALYZED.DATASET / CONTRLPW BACKUP DSNAME/PWSD ==> BACKUP.DATASET / ERROR DSNAME/PWSD ==> BACKUP.ERRORS.DATASET / CA STAT DSN/PWSD ==> CONTROL.AREA.STATISTICS.SAVED / DSET STATS DSN/PWSD ==> DATASET.ANALYSIS.STATISTICS.SAVED / BEGIN ANALYSIS AT: (CHOOSE ONE) > END ANALYSIS AT: (CHOOSE ONE) CA NUMBER ==> 1 > CA NUMBER ==> 50 (1-9999999) RECORD KEY ==> > RECORD KEY ==> (IN QUOTES) VOLUME ==> > AFTER OF CA'S ==> (1-9999999) CALCULATE NUMBER OF FREE RECORDS BASED UPON: (CHOOSE ONE) DEFINED AVERAGE ==> (Y/N) (USE DATASET DEFINITION AVERAGE) CALCULATED AVERAGE ==> Y (Y/N) (USE VSUM CALCULATED AVERAGE) RECORD SIZE ==> (USER DEFINED RECORD SIZE) ARE DATASET RECOMMENDATIONS WANTED? ==> Y (Y/N) PF1=HELP PF6=PROFILE UPDATE ENTER=ANALYZE DATASET

This panel is displayed when “F” or “B” is specified in the command line of the ANALYZE SELECTION MENU and is used to specify the options and dataset to be analyzed in foreground or background mode. If specified, the backup errors, control area statistics, and dataset statistics datasets must exist prior to running the analysis.

-------------------- VSUM - DATASET ANALYSIS REPORT MENU ---------------------- COMMAND ==> B - BACKUP DATASET C - CONTROL AREA REPORT E - BACKUP ERROR FILE G - CONTROL AREA GRAPH REPORT K - KEY RANGE REPORT S - SYSPRINT DATASET REPORT

ANALYZE FOREGROUND/

BACKGROUND MENU

DATASET ANALYSIS REPORT MENU


93

This panel is displayed after a foreground mode analysis has been completed and is used to select the VSUM ANALYZE report you wish displayed on your terminal. The reports are in the same format as the batch reports described later in this section, and are displayed in ISPF BROWSE mode.

----------------- VSUM - DATASET ANALYSIS REPORTING OPTIONS ------------------- COMMAND ==> DATASET REPORT OPTIONS: DATASET REPORT WANTED ==> Y (Y/N) (DEFAULT=YES) SAVE ANALYSIS STATS ==> Y (Y/N) (DEFAULT=NO) CONTROL AREA REPORT OPTIONS: CA REPORT WANTED ==> Y (Y/N) (DEFAULT=NO) SAVE ANALYSIS STATS ==> Y (Y/N) (DEFAULT=NO) LIMITING PARAMETERS ==> S (F=FULL,N=NOTFULL,E=EMPTY,S=SPLIT,L=LOSTCI) PERCENT FREESPACE ==>( 20 : GT ) (PRINT CA'S WITH,FREESPACE:OPERATOR) OF LINES/PAGE ==> (MINIMUM=16 : MAXIMUM=999)(DEFAULT=55) CONTROL AREA GRAPH OPTIONS: CA GRAPH WANTED ==> O (Y/N/O) (O=OVERLAY)(DEFAULT=NO) SAVE ANALYSIS STATS ==> Y (Y/N) (DEFAULT=NO) LIMITING PARAMETERS ==> S (F=FULL,N=NOTFULL,E=EMPTY,S=SPLIT,L=LOSTCI) PERCENT FREESPACE ==>( 20 : GT ) (PRINT CA'S WITH, FREESPACE:OPERATOR) OF LINES/PAGE ==> (MINIMUM=16 : MAXIMUM=999)(DEFAULT=55) KEY RANGE REPORT OPTIONS: ==> ( DSHI , DSLO , CAHI , CALO , CIHI , CILO ) (DEFAULT=NONE) (VALID OPTIONS ARE: DSHI,DSLO,CAHI,CALO,CIHI,CILO) USER EXIT ROUTINE ==> USEREXIT ENTER=SAVE AND EXIT

This panel is displayed when “P.A” is entered in the command line of VSUM’s PRIMARY OPTION MENU and is used to specify the ANALYZE report options for the ANALYZE function.

DATASET ANALYSIS REPORTING OPTIONS


94

----------------------- VSUM - BACKGROUND JOB PROFILE ------------------------- COMMAND ==> JOB CARD INFORMATION: ==> //JOBNAME JOB (ACCOUNTING),'NAME' ==> // MSGLEVEL=1,CLASS=A,NOTIFY=TSOID ==> /*JOBPARM N=1 ==> /*ROUTE PRINT LOCAL VSUM STEPLIB DSN ==> VSUM.STEPLIB.DATASET REQUIRED VSUM STEPCAT DSN ==> USERS.CATALOG.FOR.BACKGROUND.ANALYSIS.ANDPRINT DATASET ANALYSIS OPTIONAL DATASET NAMES: BACKUP DSNAME/PWSD ==> BACKUP.DATASET / PASSWORD ERROR DSNAME/PWSD ==> BACKUP.ERRORS.DATASET / CA STAT DSN/PWSD ==> CONTROL.AREA.STATISTICS.SAVED / DSET STATS DSN/PWSD ==> DATASET.STATISTICS.SAVED / ENTER=SAVE AND EXIT

This panel is displayed when “P.B” is entered in the command line of VSUM’s PRIMARY OPTION MENU and is used to specify the ANALYZE background JCL and optional datasets to be used when submitting the ANALYZE function for batch processing. If specified, the backup errors, control area statistics, and dataset statistics datasets must exist prior to running the analysis.

ABBREVIATIONS: ANALYZE may be abbreviated as ANAL

BKERDD (ddname/updatepw) This parameter specifies a valid MVS ddname that is also specified in the execute JCL, and it will cause all DUPLICATE or OUT OF SEQUENCE keys to be written to the specified DDNAME. The password should be specified for VSAM datasets that are update password protected if the MVS operator should not be prompted for the password.

This parameter is not valid when using the automatic ANALYZE feature of the LIST FUNCTION.

DEFAULTS: BKERDD

MUTUALLY EXCLUSIVE parameters: CASTART CAEND CAVOLUME CASAMPLE CACOUNT BKUPDD

BKUPDD (ddname/updatepw) This parameter must be specified if a backup of the dataset is wanted during analysis. The “ddname” must be a valid password should be

BACKGROUND JOB PROFILE

ANALYZE Parameter Descriptions


95

specified for VSAM datasets that are update password protected if the MVS operator should not be prompted for the password.

This parameter is not valid when using the automatic ANALYZE feature of the LIST FUNCTION.

DEFAULTS: BKUP

MUTUALLY EXCLUSIVE parameters: START CAEND CAVOLUME CASAMPLE CACOUNT

CACOUNT (number) This parameter specifies how many control areas are to be analyzed for a dataset. This parameter will cause a partial dataset analysis to be performed.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE Parameters: BKUPDD BKERDD CAVOLUME CAEND

ABBREVIATIONS: CACNT

CAEND (number | qstring) This parameter specifies the last control area in the VSAM dataset to be analyzed. If a number is specified, the analysis will stop after the control area is processed. If a quoted string is specified, the analysis will stop after the control area that contains a key greater than or equal to the quoted string. This parameter will cause a partial dataset analysis to be performed.

number: A numeric value from 1 to 9999999.

qstring: A full or partial key value in quotes. The key value can be specified in character 'character' or hexadecimal x'hexadecimal' format and cannot exceed 255 characters or 510 hexadecmal characters in length. If there are quotes (') in the key then two quotes together ('') can be specified for each occurrence of a quote.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: BKUPDD BKERDD CAVOLUME CACOUNT

CAGRAPH (YES | NO | OVERLAY SAVE | NOSAVE FULL NOTFULL EMPTY SPLIT LOSTCI FREESPACE (pct | 0 < :cond | GE >) LINECNT(number | 55 )) This parameter specifies whether the CONTROL AREA GRAPH report should be printed for the control areas that are analyzed, and also if the control area statistics should be saved on the dataset


96

specified in the CASTATS parameter. Optionally, the control areas that will be graphed can be limited to those control areas that are; full; notfull; empty(free); have caused or were used for a control area split; have or may have unusable(lost) control intervals because of poor key compression or insufficient index control interval size; have a specified percentage of freespace available. If no LIMITING PARAMETERS are specified, then all control areas analyzed will be graphed.

YES | NO | OVERLAY Indicates whether the control area graph should be printed. If “YES” or “OVERLAY” is specified, the control area graph will be printed, and the “CAGRAPH” DD statement is required. “OVERLAY” will cause the control interval and byte graph lines to overlay each other and decrease the number of lines in the graph by 50%. “OVERLAY” should not be specified if the CAGRAPH is going to be printed on a 3800 printer.

SAVE | NOSAVE Indicates whether the control area statistics are to be saved (written) to the dataset specified by the CASTATDD parameter.

LINECNT(number) Indicates how many lines to be printed on a page before a page break is performed. The minimum value allowed is 16 and the maximum value is 999.

LIMITING PARAMETERS

FULL Indicates that, of the control areas analyzed, those that are full are to be printed. A control area is considered to be full when there are no free records.

NOTFULL Indicates that, of the control areas analyzed, those that are not full are to be printed. A control area is not full when there are one or more free records.

EMPTY Indicates that, of the control areas analyzed, those that are empty are to be printed.

SPLIT Indicates that the control areas that are out of relative sequence will be printed. When a control area split occurs, an empty control area is used. If the empty control area is the next relative control area to the one that is splitting, no out-of-sequence detection can be made, and that control area split will not be detectable. MUTUALLY EXCLUSIVE parameters: CASAMPLE


97

LOSTCI Indicates that, of the control areas analyzed, those that do have or could have lost or unusable control intervals because of poor key compression or an insufficient index control interval size will be printed.

FREESPACE Indicates that, of the control areas analyzed, those that have the specified percentage of freespace available will be printed.

ABBREVIATIONS: FSPC

DEFAULTS: NO,NOSAVE,LINECNT(55)

ABBREVIATIONS: CAG

CAREPORT (YES | NO | OVERLAY SAVE | NOSAVE FULL NOTFULL EMPTY SPLIT LOSTCI FREESPACE (pct | 0 < :cond | GE >) LINECNT(number | 55 )) This parameter specifies whether the CONTROL AREA REPORT should be printed for the control areas that are analyzed, and also if the control area statistics should be saved on the dataset specified in the CASTATS parameter. Optionally, the control areas that will be printed can be limited to those control areas that are; full; notfull; empty(free); have caused or were used for a control area split; have or may have unusable(lost) control intervals because of poor key compression or insufficient index control interval size; have a specified percentage of freespace available. If no LIMITING PARAMETERS are specified, then all control areas analyzed will be printed.

ABBREVIATIONS: FSPC

YES | NO Indicates whether the control area report should be printed. If “YES” is specified, the control area report will be printed and the “CAREPORT” DD statement is required.

Refer to the CAGRAPH parameter on page 95 for an explanation of the “SAVE | NOSAVE” “FULL NOTFULL EMPTY SPLIT LOSTCI FREESPACE and LINECNT” subparameters.

DEFAULTS: NO,NOSAVE,LINECNT(55)

ABBREVIATIONS: CAR


98

CASAMPLE (number) This parameter specifies that a sampling of the control areas will be analyzed. Every “Nth” control area will be analyzed, “N” being the number specified in this parameter. This can be used for statistical sampling of control areas.


DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: BKUPDD BKERDD CAREPORT(SPLIT) CAGRAPH(SPLIT)

ABBREVIATIONS: CASAMP

CASTART (number) This parameter specifies the first control area in the VSAM dataset to be analyzed. If a number is specified, the analysis will start with the control area specified. If a quoted string is specified, the analysis will start with the control area that contains a key greater than or equal to the quoted string. This parameter will cause a partial dataset analysis to be performed.


qstring: A full or partial key value in quotes. The key value can be specified in character 'character' or hexadecimal x'hexadecimal' format and cannot exceed 255 characters or 510 hexadecmal characters in length. If there are quotes (') in the key then a double quote ('') can be specified for each occurrence of a quote.

DEFAULTS: (null) Beginning of dataset.

MUTUALLY EXCLUSIVE parameters: BKUPDD BKERDD CAVOLUME

ABBREVIATIONS: CASTRT

CASTATDD (ddname | CASTATS /updatepw) This parameter specifies the name of the DD statement for the dataset that will be used to save the CONTROL AREA GRAPH, CONTROL AREA REPORT, and CONTROL INTERVAL REPORT statistics for subsequent processing by the REPRINT function. Refer to Appendix A: Statistical Files for a description of how to create/define the statistical files. If the same DD name is specified between multiple ANALYZE or LIST functions the file will be left open and the statistics will be written to the end of the dataset. The dataset will be closed when the DD name specified is different from the previous function. If the statistical file is a VSAM ESDS and is update


99

password protected the update password should be specified if the MVS operator should not be prompted for the dataset password.

DEFAULTS: CASTATS

ABBREVIATIONS: CASTDD, CADD

CAVOLUME (volser) This parameter specifies a single volume in a multi-volume dataset that will be analyzed. If this parameter is specified a partial dataset analysis will be performed. When specified for a LIST function the dataset will not be analyzed if the specified volume is not defined for the dataset.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: BKUPDD BKERDD CACOUNT CAEND CASTART

ABBREVIATIONS: CAVOL

CIREPORT (YES | NO SAVE | NOSAVE LINECNT(number | 55 ) FROMCA(number | 1 COUNT(number | 1 )) This parameter specifies whether the CONTROL INTERVAL REPORT should be printed for selected control areas, and also if the control interval statistics should be saved on the dataset specified in the CASTATDD parameter. This report can produce a large volume of output and should be limited to those control areas to be analyzed at the control-interval level. This report can be especially useful in analyzing the effect of current control-interval freespace if printed for one control area after records are inserted into the dataset.

YES | NO Indicates whether the control interval report should be printed. If “YES” is specified, the control interval report will be printed, and the “CIREPORT” DD statement is required.

SAVE | NOSAVE Indicates whether the control interval statistics are to be saved (written) to the dataset specified by the CASTATDD parameter.

LINECNT(number) Indicates how many lines to be printed on a page. The minimum allowed is 16 and the maximum is 999.

FROMCA Indicates the control area to begin printing control interval statistics on. If the control area number specified does not exist or is not analyzed because of the CASTART, CAEND, CACOUNT, CASAMPLE, or CAVOLUME parameters, then there will be no control interval report printed. The number can range from 0 to 999999999.


100

COUNT Indicates how many control areas the control interval report will be produced for. The report will go for the specified number of control areas or until end of dataset or CAEND, CACOUNT, CAVOLUME. The number can range from 0 to 9999999.

DEFAULTS: NO,NOSAVE,LINECNT(55),FROMCA(1),COUNT(1)

ABBREVIATIONS: CIR

DSREPORT (YES | NO SAVE | NOSAVE ) **Positional** This parameter specifies whether the DATASET REPORT should be printed, and also if the dataset statistics should be saved on the dataset specified in the DSSTATDD parameter. The default is “YES” and will cause a single page dataset report to be printed for the dataset specified in the ANALYZE function or each keyed dataset selected by the LIST ANALYZE function.

YES | NO Indicates whether the dataset report should be printed.

SAVE | NOSAVE Indicates whether the dataset statistics are to be saved (written) to the dataset specified by the DSSTATDD parameter.

DEFAULTS: YES,NOSAVE

ABBREVIATIONS: DSR

DSSTATDD (ddname | DSSTATS /updatepw) This parameter specified the DD statement name for the dataset that will be used to save the DATASET REPORT statistics for subsequent processing by the REPRINT function. Refer to Appendix A: Statistical Files for a description of how to create/define the statistical files. If the same DD name is specified between multiple ANALYZE or LIST functions the file will be left open and the statistics will be written to the end of the dataset. The dataset will be closed when the DD name specified is different from the previous function. If the statistical file is a VSAM ESDS and is update password protected the update password should be specified if the MVS operator should not be prompted for the dataset password.

DEFAULTS: DSSTATS


FREERCSZ (DEFAVG | CALCAVG | number) The FREERCSZ parameter is used to determine which average record size value will be used for free record calculations. The average record size value will be used to estimate the number of free records in control interval freespace, free control intervals, and free control areas.


101

DEFAVG: The average record size defined for the dataset will be used for the “ESTIMATED NO. OF FREE RECS” calculation.

number: Any numeric value (not greater than the defined maximum) to be used as the average record size. This option can be very helpful when a new record size will be used on an existing VSAM file. VSUM will calculate the number of free record slots within existing freespace.

CALCAVG: VSUM will calculate the actual average record size for each control interval and control area processed. The calculated average record size for each control interval will be used for the free space in that control interval. The calculated average record size for a control area will be used for the free control intervals in that control area. The calculated average record size for the dataset will be used for free control areas.

DEFAULTS: CALCAVG

ABBREVIATIONS: FRCSZ, FREERECORDSIZE

KRREPORT (DSLO DSHI CALO CAHI CIHI CILO LINECNT(number | 55 )) This parameter specifies whether you want to print the KEYRANGE REPORT, and also high or low keyranges you wish to print. When a partial dataset analysis is performed because of the CACOUNT, CAEND, CASTART, CASAMPLE, or CAVOLUME, the highest and lowest keys for the dataset will be the highest and lowest within the control areas analyzed.

DSHI Indicates that the highest key in the dataset should be printed.

DSLO Indicates that the lowest key in the dataset should be printed.

CAHI Indicates that the highest key in each control area analyzed should be printed.

CALO Indicates that the lowest key in each control area analyzed should be printed.

CIHI Indicates that the highest key in each control interval of each control area analyzed should be printed.


102

CILO Indicates that the lowest key in each control interval of each control area analyzed should be printed.


DEFAULTS: LINECNT(55)

ABBREVIATIONS: KRR

NAME (dsname/cntrlpw) This parameter specifies the fully qualified name of the VSAM KSDS or AIX dataset to be analyzed/backed up. The VSAM control password must also be specified if the dataset has a control password defined and the MVS operator should not be prompted for the password. This parameter will be ignored if a VSAMINDD DD statement is specified in your execution JCL, and the dataset referenced by the VSAMINDD will be used for ANALYZE processing.

If the automatic ANALYZE feature of the LIST command is being used, then refer to “NAME” (page 38) in the “Catalog List/Search” chapter for a description of this parameter.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: VSAMINDD

RECOMMENDATIONS (.....) This parameter defines the types of recommendations VSUM should make about the dataset. Refer to chapter 0, “Dataset Recommendations,” for a detailed description of the RECOMMENDATIONS parameter and subparameters available.

STATEXIT=module This parameter specifies a user written exit routine that will be loaded by the VSUM ANALYZE function and linked to via standard OS program linkage conventions each time a CONTROL INTERVAL, CONTROL AREA, and DATASET statistical record is created. Refer to Appendix A: Statistical Files for a description of the STATISTICAL exit and the register usage when control is passed to the exit.

VSAMINDD (ddname/cntrlpw) This parameter specifies the DD name and/or control password for the VSAM KSDS or AIX dataset you wish to analyze/backup. The VSAM control password must be specified if the dataset has a control password defined and the MVS operator should not be prompted for


103

the password. This parameter is not valid when using the automatic ANALYZE feature of the LIST FUNCTION.

DEFAULTS: VSAMINDD

MUTUALLY EXCLUSIVE parameters: NAME

ABBREVIATIONS: VINDD, INDD


104

Examples of Use

This example will cause dataset VSAM.KSDS to be completely analyzed and backed up to dataset YOUR.BACKUP.FILE, and print a dataset report.

//JOBNAME JOB ... //STEPNAME EXEC PGM=VSUM,REGION=1000K //STEPLIB DD DSN=STAR.VSUM.LOADLIB,DISP=SHR //SYSPRINT DD SYSOUT=A //BKUPDD DD DSN=YOUR.BACKUP.FILE,DISP=SHR //SYSIN DD * ANALYZE NAME(VSAM.KSDS) BKUPDD(BKUPDD) /*

This example will cause dataset VSAM.KSDS to be completely analyzed, its control area space utilization to be graphed, and a dataset report to be printed.

//JOBNAME JOB ... //STEPNAME EXEC PGM=VSUM,REGION=1000K //STEPLIB DD DSN=STAR.VSUM.LOADLIB,DISP=SHR //SYSPRINT DD SYSOUT=A //CAGRAPH DD SYSOUT=A //SYSIN DD * ANALYZE NAME(VSAM.KSDS) CAGRAPH(YES) /*

This example will cause dataset VSAM.KSDS to be partially analyzed. The control areas on the specified volume will be the only part analyzed, and a dataset’s report statistics will be saved and not printed.

//JOBNAME JOB ... //STEPNAME EXEC PGM=VSUM,REGION=1000K //STEPLIB DD DSN=STAR.VSUM.LOADLIB,DISP=SHR //SYSPRINT DD SYSOUT=A //DSSTATS DD DSN=VSUM.DSSTATS.FILE,DISP=SHR //SYSIN DD * ANALYZE NAME(VSAM.KSDS) VOLUME(VOL002) - DSREPORT(NO,SAVE) /*

Analyze and Backup a Complete KSDS

Analyze and Graph Control Area Usage for a KSDS

Analyze and Single Volume of a KSDS and Save Stats


105

This example will cause dataset VSAM.KSDS to be completely analyzed with a dataset and recommendations report printed for attributes, buffers, and reorganization.

//JOBNAME JOB ... //STEPNAME EXEC PGM=VSUM,REGION=1000K //STEPLIB DD DSN=STAR.VSUM.LOADLIB,DISP=SHR //SYSPRINT DD SYSOUT=A //SYSIN DD * ANALYZE NAME(VSAM.KSDS) RECOMMENDATIONS(ATTRIBUTES - BUFFERS REORGANIZATION) /*

This example will cause the first control area in dataset VSAM.AIX to be analyzed and a control interval report to be printed for its control areas.

//JOBNAME JOB ... //STEPNAME EXEC PGM=VSUM,REGION=1000K //STEPLIB DD DSN=STAR.VSUM.LOADLIB,DISP=SHR //SYSPRINT DD SYSOUT=A //CIREPORT DD SYSOUT=A //SYSIN DD * ANALYZE NAME(VSAM.AIX) DSREPORT(NO) CACOUNT(1) - CIREPORT(YES,FROMCA(1),COUNT(1)) /*

This example will analyze the space utilization of a VSUM user catalog. When analyzing VSAM catalogs, the VSUM load library must be APF authorized, the STEPCAT DD statement must be specified and point to the VSUM user catalog being analyzed, and the NAME parameter of the VSUM ANALYZE command must specify the VSAM user catalog master password.

//JOBNAME JOB ... //STEPNAME EXEC PGM=VSUM,REGION=1000K //STEPLIB DD DSN=STAR.VSUM.LOADLIB,DISP=SHR //STEPCAT DD DSN=YOUR.USERCAT,DISP=SHR //SYSPRINT DD SYSOUT=A //CAGRAPH DD SYSOUT=A //SYSIN DD * ANALYZE NAME(YOUR.USERCAT/MASTERPW) DSREPORT(YES) - CAGRAPH(YES) /*

Analyze a KSDS and Make Recommendations

Analyze a Control Area and Print a Control Interval Report

Analyze a User Catalog’s Space Utilization


106


F A N T O M S Y S T E M S (1) VSUM CONTROL INTERVAL REPORT (3) PAGE=1 KSDS=VSAM.SAMPLE.KSDS (2) (4) RUNDATE=04/16/2017 (6) DATA=VSAM.SAMPLE.KSDS.DATA FREERCSZ=180(DEF) RUNTIME=09.22.00 INDX=VSAM.SAMPLE.KSDS.INDEX CREATED=02/21/2017 EXPIRED=00/00/0000 OWNER=(NULL) (5) RUNTYPE=NEW,COMPLETE

This section defines the standard VSUM report headings. All VSUM reports have a standard heading format and the fields within the heading are described in this section. Each field in the above report is numbered.

1 VSUM Identification Line

2 Cluster Name: Data Component Name: Index Component Name:

KSDS=VSAM.SAMPLE.KSDS DATA=VSAM.SAMPLE.KSDS.DATA INDX=VSAM.SAMPLE.KSDS.INDEX

3 Report Type Identifier: This heading will state which report is being produced, e.g., VSUM CONTROL INTERVAL REPORT.

4 Parameter Lines: This area is used to list any partial analysis parameters specified for this ANALYZE function of VSUM, e.g., CAEND=20

5 VSAM dataset creation, expiration, and owner information for the user dataset being analyzed.

6 Run Type and Time

RUNDATE: The date the report (RUNTYPE=NEW) was produced.

RUNTIME: The time the report (RUNTYPE=NEW) was produced.

RUNTYPE: New, Complete, Old, Partial, Sampling: New VSAMIN DD dataset was

analyzed.

Old CASTATS/DSSTATS was used for report (historical).

Complete The entire dataset was analyzed.

Partial Part of dataset was analyzed.

Sampling A sampling of the dataset was taken.

Report Headings

Report Headings Description


107

The VSUM dataset report is a one-page report for a VSAM KSDS or AIX dataset. The report reflects the actual space utilization and associated statistics for an entire VSAM dataset, or portion thereof, if limiting input parameters are specified by the user. All space utilization values are calculated by processing the actual data and index component control intervals. The catalog information values are derived from the associated VSAM catalog.

-----------------------------------------------------S P A C E U T I L I Z A T I O N--------------------------------------------- C L U S T E R * D A T A * I N D E X ------------------------------------------------------------------------------------------------------------------------------------ USED FREE TOTAL * USED FREE LOST * USED FREE * * TRACKS 16 0 16 * CYLNDERS 1 0 * TRACKS 1 0 100.0 % .0 % * 100.0 % .0 % * 100.0 % .0 % * * BYTES 15148 636116 651264 * BYTES 13100 601300 0 * SSBYTES 204 1844 2.3 % 97.7 % * 2.1 % 97.9 % .0 % * 10.0 % 90.0 % * * RECORDS 35 * USED 3284 0 * --------------------------------- * CI'S .5 % .0 % * * * HIGH LEVEL INDEX RECORDS 0 --------------CALCULATED STATISTICS------------- FREE 598016 * * CI'S 97.3 % * SS-RECORDS USED 1 AVG-CMPKL 3 AVG-IXENL 6 * * AVG-RECSZ 371 MAX-RECSZ 804 * ALL 4 146 0 * SS-RECORDS TOO SMALL 0 * CI'S 2.7 % 97.3 % .0 % * .0 % ESTIMATED NO. OF FREE RECORDS 3228 * * BASED ON FREERCSZ(180) * ALL 1 0 * SS-RECORDS TOO LARGE 0 * CA'S 100.0 % .0 % * .0 % --------------------------------------------------------C A T A L O G I N F O R M A T I O N-------------------------------------- C L U S T E R * D A T A * I N D E X ------------------------------------------------------------------------------------------------------------------------------------ DEFINE ATTRIBUTES: * LASTUPD 07/15/2017 * LASTUPD 07/15/2017 * CISIZE 4096 CISPLITS 0 * CISIZE 2048 CISPLITS 0 RECSZ (180 2000) FREESPACE(0 0) * TRKS/CA 15 CASPLITS 0 * TRKS/CA 1 CASPLITS 0 BUFSP (10240) KEYS (9 0) * CI'S/CA 150 SHR OPT (3 3) * CI'S/CA 18 SHR OPT (3 3) * PHYRCSZ 4096 TRK-UTIL% 86 * ENT/SEC 12 LEVELS 1 UNIQUE NOIMBED SPEED UPDATE NODSWAIT * RECORDS 35 EXCPS 53 * RECORDS 1 EXCPS 12 NOREUSE NOREPL NOERASE UNQKEY STAGE * INSERTED 0 DELETED 0 * INSERTED 0 DELETED 0 NOSPANND NOKEYRNG NOWRTCHK UNORDERD * UPDATED 0 READ 8 * UPDATED 0 READ 0 * HARBA 614400 HURBA 614400 * HARBA 36864 HURBA 2048 ASSOCIATIONS: * DEFCYLS (1 1) TOTCYLS 1 * DEFTRKS (1 1) TOTTRKS 1 * USEDCYLS 1 FREECYLS 0 * USEDTRKS 1 FREETRKS 0 * EXCPRATIO 1.51 * EXCPRATIO .34 *------------------V O L U M E-------------------*-----------V O L U M E------------ * DEVT 3380 EXTS 1 SEC-ALLOC 0 * DEVT 3380 EXTS 1 SEC-ALLOC 0 * VOL009(15,1) * VOL009(1,1) ------------------------------------------------------------------------------------------------------------------------------------

CLUSTER: (NOTE: If limiting parameters are specified then all statistics will be reflective of just that portion of the dataset.)

CYLNDERS/TRACKS USED: The number and percent of cylinders/tracks in the data and index components used to contain data.

CYLNDERS/TRACKS FREE: The number and percent of cylinders/tracks in the data and index components that do not contain any data.

Dataset Report

Dataset Report Example

SPACE UTILIZATION


108

CYLNDERS/TRACKS TOTAL: The total number of cylinders/tracks allocated to the data and index components.

BYTES USED: The number and percent of bytes in the data and index component that are used for data.

BYTES FREE: The number and percent of bytes in the data and index components that are free (includes data component CI and CA component CI and CA freespace bytes, and index component unused control intervals).

BYTES TOTAL: The total number of bytes allocated to the data and index components.

RECORDS: The actual number of records in the dataset.

AVG-CMPKL: The calculated average compressed key length for the dataset.

AVG-IXENL: The calculated average index entry length for the dataset.

AVG-RECSZ: The calculated average record size for the dataset.

MAX-RECSZ: The largest record currently in the dataset.

AVG-AKO: (Alternate indexes w/non-unique keys only) The average number of alternate key occurrences (duplicates), for non-unique keys, in the base cluster.

MAX-AKO: (Alternate indexes w/non-unique keys only) The largest number of alternate key occurrences (duplicates), for non-unique keys, in the base cluster.

ESTIMATED NO. OF FREE RECORDS: The number of records that could fit in the data component freespace. The calculations used to derive this value use the recordsize associated with the “FREERCSZ” parameter, and reflects the actual number of free records of that recordsize that could currently fit in the available freespace.


109

DATA: (NOTE: If limiting parameters are specified then all statistics will be reflective of just that portion of the dataset.)

CYLNDERS/TRACKS USED: The number and percent of cylinders or tracks in the data component used to contain data.

CYLNDERS/TRACKS FREE: The number and percent of cylinders or tracks in the data component that do not contain data.

BYTES USED: The number and percent of bytes in the data component that are used for data.

BYTES FREE: The number and percent of bytes in the data component that are free (available for new records).

BYTES LOST: The number and percent of bytes in the data component that do not currently and can never contain new records. Lost bytes can occur in two situations: The first situation is if the index control interval size is too small to contain the number of index entries needed to address all the control intervals in the associated data control area. The second situation, which can only happen with spanned datasets, is when a record has to span a control interval. When that occurs the control interval that contains the last segment of the spanned record can only be used for that record segment. So unused bytes in the control interval can only be used for the expansion of that spanned record, and not for new records.

BYTES USED CI’S FREE: The number and percent of bytes in used control intervals (control intervals not free) that are free. This number is analogous to control interval freespace.

BYTES USED CI’S LOST: (SPANNED DATASETS ONLY) The number and percent of bytes in end-segment control intervals that cannot be used for new records. If your data CI size is incompatible with your spanned record sizes then this number will be excessive.

BYTES FREE CI’S FREE: The number and percent of bytes in free control intervals.

ALL CI’S USED: The number and percent of control intervals in the data component that contain or contained data (used control intervals).


110

ALL CI’S FREE: The number and percent of control intervals in the data component that are free (free control intervals).

ALL CI’S LOST: The number and percent of control intervals in the data component that are unusable (lost control intervals) because the associated index control interval is too small to contain all the required index entries. This will happen if the index CI size is too small (too many CI’s per CA). If the index CI size is the maximum allowed (4096) then the data CI size can be increased. Increasing the data CI size will decrease the number of index entries needed in an index control interval. If the index CI size is not 4096, then consider increasing it to the next size.

ALL CA’S USED: The number and percent of the control areas in the data component that contain data (used control areas).

ALL CA’S FREE: The number and percent of the control areas in the data component that are free control areas. If this number is excessive the dataset may be overallocated.

INDEX: (NOTE: If limiting parameters are specified they will only affect the sequence set statistics.)

TRACKS USED: The number and percent of tracks in the index component that are used. If “IMBED” is specified on the AMS DEFINE CLUSTER/AIX then this number reflects only the tracks used by the high level index. The tracks used by the sequence set are included in the data component statistics.

TRACKS FREE: The number and percent of tracks in the index component that are free. If “IMBED” is specified on the AMS DEFINE CLUSTER/AIX then this number reflects only the tracks free in the high level index. The free tracks in the sequence set are included in the data component statistics.

HIGH LEVEL INDEX RECORDS: The number of records in the high level(s) of the index. This does not include the sequence set records.

SS BYTES USED: The number and percent of bytes in the sequence set records that are used for index entries.


111

SS BYTES FREE: The number and percent of bytes in the sequence set records that are free (not used for index entries).

SS-RECORDS USED: The number of sequence records in the dataset that contain data.

SS-RECORDS TOO SMALL: The estimated number of “SS-RECORDS USED” that were found to be insufficient to address all the associated data component control intervals. The calculation performed that is the basis for this value is number of free bytes in a sequence set record divided by the average index entry length (average compressed key length plus control info). The quotient is compared to the number of free control intervals in the associated data control area. If there is not enough index freespace to address all the free control intervals, then this counter is increased by one. This counter is also increased by one if there are lost CI’s in the data component control area. If a high percentage of the “SS-RECORDS USED” are found to be too small, then the index CI size should be increased to the next size. If the index cisize is currently at the maximum allowed (4096), then consider increasing the data component cisize.

SS-RECORDS TOO LARGE: The estimated number of “SS-RECORDS USED” that were found to be excessive. Excessive means that the cisize could be decreased to the next lower cisize and could still address all the control intervals in the data control area. This calculation is based on the average index entry length (average compressed key length plus control information) multiplied by the number of CI’s per CA plus index header length. If 100 percent of the “SS-RECORDS USED” are too large, decreasing the index CI size to the next lower size should be considered. Before decreasing the Index CI size, a control area report should be looked at to see if decreasing the Index CI size will leave enough space should the average compressed key length increase slightly.

CLUSTER: (Refer to VSAM ACCESS METHOD SERVICES for AMS parameter descriptions.)

DEFINE ATTRIBUTES: FREESPACE(CI% CA%):

The current control interval and control area freespace values defined for the dataset.

CATALOG INFORMATION


112



KEYS(length offset): The defined key information for the dataset. For KSDS types this is the true key length and offset within each logical record. For AIX types this is the alternate key length and the offset of the AIX key in the VSAM AIX cluster.

ALT-RKP (offset): This is the offset of the alternate key within the associated base cluster records.


IMBED/NOIMBED: The index sequence set is imbedded (IMBED) or is not imbedded (NOIMBED) imbedded within the data component control areas.

SPEED/RECOVERY: EOF control interval is written (RECOVERY) or not written (SPEED) after each data CI is written during load processing.


DSWAIT/NODSWAIT: Wait or don’t wait for MSS de-staging when VSAM close is issued.

REUSE/NOREUSE: Allows (REUSE) or does not allow (NOREUSE) reloading the dataset without an AMS delete- define.

REPL/NOREPL: The high level index (and sequence set if “NOIMBED”) records are replicated (REPL) or are not replicated (NOREPLICATE) on a track.

ERASE/NOERASE: Whether (ERASE) or not (NOERASE) the data component CI’s are to be overwritten with binary zeros when the dataset is deleted.

UNQKEY/NOUNQKEY: The dataset contains unique or non-unique keys.


113

STAGE/BIND/CYLFAULT: How dataset is to be staged if defined on| MSS.


KEYRANGE/NOKEYRNG: Whether (KEYRANGE) or not (NOKEYRNG) the dataset is divided into keyranges.




UPGRADE/NOUPGRADE: The alternate index will (UPGRADE) or will not (NOUPGRADE) be updated when the associated base cluster is updated.

ASSOCIATIONS: The names of any associated alternate indices or base cluster’s will be listed.

DATA | INDEX: LASTUPD:

The date the associated component was last opened for update processing.


CISPLITS: The number of times a control interval split occurred.


CASPLITS: The number of times a control area split occurred.


114



ENT/SEC: The number of index entries per section in the index component.

LEVELS: The number of index levels in the index component.












115



USEDCYLS/USEDTRKS: The total number of cylinders/tracks in the component that contains data.

FREECYLS/FREETRKS: The total number of cylinders/tracks in the component that are free (contains no data).

EXCPRATIO: The ratio of excp’s to logical I/O requests. This value can be used as a guide to determine whether insufficient buffers are being specified by the application programs processing this component. The value represents the average number of EXCP’s issued for each logical I/O request and is calculated as follows:


For the index component calculation, the RECORDS, READ, UPDATED, and DELETED values from the data component are used with the EXCPS value of the index component.







116

volser(tracks,extents | CANDT | IMB): The total number of tracks allocated to the volume(keyrange) entry, and the total number of extents for the allocated tracks.


IMB indicates that the index volume entry’s tracks are imbedded in the associated data component because the “IMBED” option was specified during DEFINE.

The VSUM control area graph is a multi-page report which displays valuable space utilization statistics in graphic format. The control areas displayed can be for a complete dataset or for the range specified by any ANALYZE function LIMITING parameters.

CASIZE= 1 CYLINDER (70 CI'S PER CA) LOST ACTUAL EST FREE CA NO. ----------------------------------------------------------------------------------------------------- CI'S RECORDS RECORDS 1 I CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC I 0 2440 786 I BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB I 2 I CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC I 0 2443 815 I BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB I 3 I CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC I 0 1394 1442 I BBBBBBBBBBBBBBBBBBBBBBBBBBB I 4 I I 0 0 0 I I 5 I I 0 0 0 I I 6 I I 0 0 0 I I 7 I I 0 0 0 I I 8 I I 0 0 0 I I 9 I I 0 0 0 I I 10 I I 0 0 0 I I 11 I I 0 0 0 I I ------------------------------------------------------------------------------------------------------ PERCENT:0....0....1....1....2....2....3....3....4....4....5....5....6....6....7....7....8....8....9....9....1 5 0 5 0 5 0 5 0 5 0 5 0 5 0 5 0 5 0 5 0 0 LEGEND: C=USED CI'S +=LOST CI'S B=USED BYTES <=LOST BYTES

CA NO.: Data component Control Area number associated with this line of statistics. Control Area number is the relative Control Area from the beginning of the dataset. NOTE: When an “*” appears to the left of a Control Area number, it indicates a break in the ascending order of Control Area Numbers, and most likely this is where a Control Area split has occurred.

LOST CI’s: The number of Control Intervals in the dat Control Area that are unusable because the Index CISIZE is too small.

ACTUAL-RECORDS: The number of records in the Control Area.

Control Area Graph

FIELD DESCRIPTIONS


117

EST-FREE RECORDS: The estimated number of free records in this Control Area. The estimate is based on the “FREERCSZ” parameter for the ANALYZE function.

LEGEND: C=USED CI’s:

Percentage of used CI’s in the CA.

+=LOST CI’s: Percentage of CI’s in the CA that are unusable because the Index CI size is insufficient (too small).

B=USED BYTES: Percentage of used bytes (NOT-FREE) in the CA.

<=LOST BYTES: Percentage of bytes in lost CI’s and (spanned files) percentage of bytes in end-segment spanned CI’s unavailable for new records in the CA.

BLANKS: Percentage of free CI’s and free bytes in the CA.

The VSUM control area report is a multi-page report which displays valuable space utilization and record statistics about each control area and associated index sequence set record. The control areas displayed can be for a complete dataset or for the range specified by any ANALYZE function LIMITING parameters.

---------------------------------------------------------------------*----------------------B Y T E S------------------------------ CA NO. * CONTROL INTERVALS * RECORDS * INDEX-SS * USED * FREE * LOST ----------------------------------------------------------------------------------------------------------------------------------- * USED FREE * AVG MAX EST. * CMPK FREE * TOTAL * USED CI'S FREE CI'S * USED CI'S FREE CI'S * #-% #-% * TOTAL SIZE SIZE FREE * LEN BYTES * #-% * #-% #-% * #-% #-% *--------------------------------------------------------------------------------------------------------------------------- * * * * * * 1 * 56-80 14-20 * 2400 140 606 786 * +16 83 * 344703-60 * 114049-19 114688-20 * 0-0 0-0 2 * 56-80 14-20 * 2443 134 606 815 * +151 68 * 335878-58 * 122877-21 114688-20 * 0-0 0-0 3 * 27-38 43-61 * 1394 114 606 1442 * 116 08 * 163380-28 * 57804-10 352256-61 * 0-0 0-0 4 * 0-0 70-100 * 0 0 0 2030 * 0 0 * 0-0 * 0-0 573440-100 * 0-0 0-0 5 * 0-0 70-100 * 0 0 0 2030 * 0 0 * 0-0 * 0-0 573440-100 * 0-0 0-0 6 * 0-0 70-100 * 0 0 0 2030 * 0 0 * 0-0 * 0-0 573440-100 * 0-0 0-0 7 * 0-0 70-100 * 0 0 0 2030 * 0 0 * 0-0 * 0-0 573440-100 * 0-0 0-0 8 * 0-0 70-100 * 0 0 0 2030 * 0 0 * 0-0 * 0-0 573440-100 * 0-0 0-0 9 * 0-0 70-100 * 0 0 0 2030 * 0 0 * 0-0 * 0-0 573440-100 * 0-0 0-0 10 * 0-0 70-100 * 0 0 0 2030 * 0 0 * 0-0 * 0-0 573440-100 * 0-0 0-0 11 * 0-0 70-100 * 0 0 0 2030 * 0 0 * 0-0 * 0-0 573440-100 * 0-0 0-0

CA NO.: Data component Control Area number associated with this line of statistics. Control Area number is the relative Control Area from the beginning of the dataset. NOTE: When an “*” appears to the left of a Control Area number, it indicates a break in the ascending order of

Control Area Report

Field Descriptions


118

Control Area Numbers, and most likely this is where a Control Area split has occurred.

CONTROL INTERVALS: USED:

The number and percent of Control Intervals in this Control Area that contain data.

FREE: The number and percent of Control Intervals in this Control Area that are free. This is analogous to Control Area free space.

RECORDS: TOTAL:

The number of data records in this Control Area.

AVG-SIZE: Calculated average record size for this Control Area.

MAX-SIZE: The maximum record size in this Control Area.

EST-FREE: The estimated number of free records in this Control Area. The estimate is based on the “FREERCSZ” parameter discussed earlier in this section.

INDEX-SS: CMPK LEN:

The calculated average compressed key length plus two (2) for this Control Area.

“+” or “-” FLAG:

If a “+” or “-” appears to the left of “CMPK LEN” value, then it was estimated that the index CISIZE for this Control AREA should be “increased” or “decreased,” respectively, because it was estimated to be too small or too large to address the number of Control Intervals in the Control Area based on the compressed key length, “CMPK LEN”, value.

FREE BYTES: The number of index sequence set bytes that are unused.

BYTES: USED TOTAL:

The number and percent of bytes in this Control Area used to contain data.


119

FREE-USED CI’s: The number and percent of free bytes within used Control Intervals. This number is analogous to Control Interval free space.

FREE-FREE CI’s: The number and percent of free bytes within free Control Intervals. This number is analogous to Control Area free space.

LOST-USED CI’s: (Spanned Datasets Only) The number and percent of bytes in spanned record end segment Control Intervals that are unusable for new records.

LOST-FREE CI’s: The number and percent of bytes in unusable Control Intervals. An unusable Control Interval is one that cannot be addressed by its associated index sequence set record because the index CISIZE is insufficient for the number of Control Intervals per Control Area and the compressed key length.

The VSUM keyrange report is a multi-page report that is optional and can list the HIGH/LOW keys by dataset, control area, and/or control interval. This report can be generated by specifying the KRREPORT parameter of the ANALYZE function.

------------------------------------------------------------ K E Y D A T A ------------------------------------------------------ CA NO. * CI NO. * LO-HI ----------------------------- 1...0....1....1....2....2....3....3....4....4....5....5....6....6....7....7....8....8....9....9....100 * * 5 0 5 0 5 0 5 0 5 0 5 0 5 0 5 0 5 0 5 DATASET* * LO 000000000..S001...... * * 00 000000 * * 00 000000 * * HI 999999999..9901001001 * * 00 * * 00

NOTE: VSUM can report on the HI/LO key ranges of selected control areas and control intervals as well as the dataset.

CA NO.: Data Component Control Area number associated with the corresponding key range. If “DATASET” is displayed the corresponding keys are the LOW and/or HIGH keys for the dataset.

CI NO.: Relative Control Interval number or range (spanned datasets) in the associated Control Area for the corresponding key range.

LO-HI: Associated Key is the Low or High key for the Dataset, Control Area, or Control Interval(s).

Key Range Report


120

KEY: The key will be displayed in character form for the characters “A” through “Z” and “0” through “9”. Any other characters will appear as a period “.” in the character line and the hexadecimal equivalent will be displayed on the next two lines in vertical hexadecimal format.

The VSUM control interval report is a multi-page report which displays valuable space utilization and record statistics about each control interval within a range of control areas. The range of control areas displayed can be for a complete dataset or within the range specified by any ANALYZE function LIMITING parameters. This report can be generated by the CIREPORT parameter of the ANALYZE function.

---------------------------------------------------------------------------------------- CA NO. * CI NO. * R E C O R D S * B Y T E S ---------------------------------------------------------------------------------------- * * AVG MAX EST. * USED * FREE * LOST * * TOTAL SIZE SIZE FREE * #-% * #-% * #-% * *------------------------------------------------------------------- 1 * 1 * 50 119 462 7 * 6108-74 * 2004-25 * 0-0 * 2 * 48 120 354 8 * 5904-72 * 2288-27 * 0-0 * 3 * 43 136 426 7 * 5992-73 * 2200-26 * 0-0 * 4 * 41 138 282 8 * 5760-70 * 2432-29 * 0-0 * 5 * 43 139 426 7 * 6099-74 * 2093-25 * 0-0 * 6 * 38 146 462 8 * 4698-69 * 2494-30 * 0-0

CA NO.: The data component control area number associated with control interval(s) for which the statistics were calculated.

CI NO.: The relative control interval number(s) (in ascending key-sequence) within the control area for which the statistics were calculated. This may be a range for spanned files.

RECORDS: TOTAL:

The number of data records in this control interval.

AVG-SIZE: The calculated average record size in this control interval.

MAX-SIZE: The largest record in this control interval.

EST.FREE: The estimated number of free records in this control interval. The estimate is based on the “FREERCSZ” parameter and the number of free bytes in this control interval.

Control Interval Report


121

BYTES: USED:

The number and percent of used bytes (bytes that are used for records) in this control interval.

FREE: The number and percent of free bytes (bytes available for new records) in this control interval.

LOST: The number and percent of bytes that are unusable for new records in the end-segment control interval.

122

4 Dataset Modeling

Overview

The VSUM MODELING feature allows experimentation with VSAM dataset design parameters without performing an IDCAMS DEFINE or requiring the DASD space. This function can be performed under TSO ISPF or by batch VSUM execution.

A VSAM KSDS, ESDS, RRDS, or AIX dataset can be designed and its space requirements, record statistics, design warnings, and IDCAMS DEFINE parameters will be displayed and generated for later or immediate use. The VSUM ISPF DESIGN function provides an option to allocate the dataset after it has been designed and the VSUM generated IDCAMS DEFINE statements will be saved on a user-specified sequential or partitioned dataset for future reference and use.

Dataset space requirements can be specified in cylinders, or tracks for a specific volume or device type, and VSUM will calculate how many records the dataset will contain. Or, dataset space requirements can be specified in records for a specific volume or device type and VSUM will calculate how many tracks or cylinders are required for the specified number of records.

Freespace can be specified as a percentage of bytes or free records. The data control interval size can be specified or VSUM will determine the best control interval size based on a processing mode of DIRECT, SEQUENTIAL, or MIXED. The index control interval size will be calculated by VSUM and may be influenced by specifying a compressed key length. For Alternate Indexes, the maximum number of duplicate keys can be specified, and VSUM will calculate the maximum record size and minimum buffer space required.

VSUM for z/OS Program Description and Operations Guide Dataset Modeling

123

The MODELING feature of VSUM is a powerful dataset design tool that will pay for itself many times over through improved programmer productivity and efficient dataset design.

All VSUM modeling calculations for required space and freespace are based on the specified or defaulted average record size and not on the maximum record size. If an average record size is entered into the modeling function that is not a true average record size, the space and record capacity values may be insufficient or excessive. VSUM calculates the INDEX control interval size based on an average compressed key length of 5 plus required index pointers. If a model of a keyed dataset that has a compressed key length larger than 5 is needed, then the compressed key length can be specified in the KEYS modeling parameter. The compressed key length will be used for the INDEX control interval size calculation.


124

Suggested Uses

The VSUM MODEL function is extremely helpful for designing VSAM datasets in the following ways:

• Allocation of VSAM datasets with TSO/ISPF without IDCAMS DEFINE command familiarity.

• Calculation of required space is based on the number of records, and the device type.

• Selection of an efficient data control interval size is based on the dataset processing mode, such as DIRECT, SEQUENTIAL, or MIXED.

• Index control interval size can be calculated based on a compressed key length for datasets whose keys compress poorly.

• Free space can be specified in bytes and VSUM will automatically calculate how many average record size records will be left free after loading.

• Free space can be specified in records and VSUM will automatically calculate the freespace percentage for each selected control interval size.

• Alternate indexes can be designed and VSUM will calculate the maximum record size required based on maximum occurrences of the alternate key within the base cluster.

• DASD migration can be a much easier task since calculations can be made based on a device type.

• Standardized IDCAMS DEFINE parameters are possible by using the IDCAMS parameters generated with the VSUM modeling feature.

• The index component size will be calculated based on the data component size eliminating excessive or insufficient index allocation.

• The ability to calculate VSAM dataset space requirements during a system design phase with minimal VSAM experience, and to optionally create the IDCAMS DEFINE parameters to be used during system testing and implementation.


125


The VSUM MODEL function can be performed in batch mode or by selecting the VSUM ISPF DESIGN function.

A batch mode MODEL function can be performed by specifying a MODEL command in the SYSIN DD statement and executing the program VSUM. The MODEL command specifies the dataset design criteria and output options for VSUM to use during the model function calculations. The batch mode MODEL function will calculate the necessary VSAM allocation values, display any design warnings, and generate the IDCAMS define parameters needed to allocate the dataset. The batch mode MODEL function will not allocate the VSAM dataset, but allocation of the VSAM dataset can be requested with the ISPF DESIGN function. The MODEL command parameters that can be specified are described in this section.

An ISPF design function can be performed by specifying “D” in the command line of VSUM’s PRIMARY OPTION MENU described in the “INTRODUCTION” section. This ISPF panel is the first in a series of panels that guides you in selecting the appropriate dataset design parameters without having to know the VSUM MODEL command or IDCAMS DEFINE command syntax. Whenever the VSUM design function is specified, it is translated into a VSUM MODEL command and executed in your TSO region. The VSUM output is then displayed on your terminal through VSUM ISPF output panels. The VSUM MODEL command that is executed under ISPF can be displayed on your terminal by turning on the VSUM ISPF “INPUT TRACE” option.

Batch Mode

ISPF Mode


126

MODEL ALLCISIZES BASECLUSTERNAME (name) BASEKEYLN (number) CATALOG (catalog) CISIZE (number) CYLINDERS (primary secondary) DEFOUT (ddname | DEFDD ) DEVICETYPE (3390 | 3380 | 338E | 338K | 3375 | 3350 | 3340 | 3330 | MSS) DUPKEYS (number) FREERECORDS(cinumber canumber) FREESPACE (cipct capct) IMBED KEYS (length offset <cmplength>) NAME (dsname) NOIMBED NONSPANNED NOREPLICATE PMODE (DIRECT | SEQUENTIAL | MIXED ) RECORDS (primary secondary) RECSIZE (avg max) REPLICATE SHAREOPTIONS (cr cs | 2 3 ) SPANNED TRACKS (primary secondary) TYPE (KSDS | AIX | ESDS | RRDS) VOLUME (volume)

----------------------- VSUM - DESIGN SELECTION MENU -------------------------- COMMAND ==> K - KSDS (VSAM KEYED SEQUENCED DATASET) DESIGN AND ALLOCATE X - AIX (VSAM ALTERNATE INDEX DATASET) DESIGN AND ALLOCATE E - ESDS (VSAM ENTRY SEQUENCED DATASET) DESIGN AND ALLOCATE R - RRDS (VSAM RELATIVE RECORD DATASET) DESIGN AND ALLOCATE

Batch Command Input

ISPF Input Panels

DESIGN SELECTION PANEL (TYPE)


127

This panel is the first panel of the DESIGN function and is displayed when “D” is selected from VSUM’s PRIMARY OPTION MENU described in the “INTRODUCTION” section. This panel is used to select the TYPE of VSAM dataset to be designed and/or allocated.

----------------------- VSUM - DESIGN \"KSDS\" DATASET -------------------------- COMMAND==> INPUT TRACE==> NO DATASET NAME ==> SAMPLE.KK (NO QUOTES) CATALOG NAME ==> SAMPLE.MVSICFU.VSTAR01 (NO QUOTES) OUTPUT DATASET NAME ==> 'STAR.TEST.KK(ONE)' (SEE HELP) DASD SPACE TYPE ==> CYL (CYL,TRK,REC) DASD SPACE ==>( 950 , 450 ) (PRIMARY,SECONDARY) (1-9999999) DEVICE TYPE ==> 338K (338K,338E,3380,3375, 3350,3390,MSS) RECORD SIZE ==>( 100 , 100 ) (AVERAGE, MAXIMUM) VOLUME ==> VOLUME (VOLUME NAME) SHAREOPTIONS ==>( 2 , 3 ) (X-REGION, X-SYSTEM) PROCESSING MODE ==> (M=MIXED,D=DIRECT,S=SEQUENTIAL) CI SIZE DATA ==> 32768 (MUTUALLY EXCL. WITH PROC. MODE) OTHER DESIGN OPTIONS: KEYS ==>( 6 , 6 , 3 ) (LENGTH, OFFSET, COMPRESS KEYLN) FREERECORDS ==>( , ) (NUMBER/CI, NUMBER/CA) FREESPACE ==>( , ) (PERCENT/CI, PERCENT/CA) REPLICATE ==> N (Y/N) (DEFAULT=NOREPLICATE) IMBED ==> N (Y/N) (DEFAULT=NOIMBED) SPANNED ==> N (Y/N) (DEFAULT=NONSPANNED) PF1=HELP ENTER=EXECUTE PF6=PROFILE EDIT=YES ALLOCATE=YES DYNALLOC= YES

This panel is displayed when “K” is selected from VSUM’s DESIGN SELECTION PANEL and is used to describe the VSAM KSDS dataset characteristics. When this panel is filled in and ENTER is pressed, the IDCAMS DEFINE parameters will be created and written to “OUTPUT DATASET NAME” specified in the panel. If the EDIT option is YES, then the next panel displayed will be the “OUTPUT DATASET NAME” in EDIT mode.

DESIGN KSDS PANEL


128

----------------------- VSUM - DESIGN \"ESDS\" DATASET -------------------------- COMMAND==> INPUT TRACE==> NO DATASET NAME ==> SAMPLE.KK (NO QUOTES) CATALOG NAME ==> SAMPLE.MVSICFU.VSTAR01 (NO QUOTES) OUTPUT DATASET NAME ==> 'STARR.TEST.KK(ONE)' (SEE HELP) DASD SPACE TYPE ==> CYL (CYL,TRK,REC) DASD SPACE ==>( 950 , 450 ) (PRIMARY,SECONDARY) (1-9999999) DEVICE TYPE ==> 338K (3350,3375,3380,338E,338K,3390,MSS) RECORD SIZE ==>( 100 , 100 ) (AVERAGE, MAXIMUM) VOLUME ==> VOLUME (VOLUME NAME) SHAREOPTIONS ==>( 2 , 3 ) (X-REGION, X-SYSTEM) PROCESSING MODE ==> (M=MIXED,D=DIRECT,S=SEQUENTIAL) CI SIZE DATA ==> 32768 (MUTUALLY EXCL. WITH PROC. MODE) OTHER DESIGN OPTIONS: SPANNED ==> N (Y/N) (DEFAULT=NONSPANNED) PF1=HELP ENTER=EXECUTE PF6=PROFILE EDIT=YES ALLOCATE=YES DYNALLOC= YES

This panel is displayed when “E” is selected from VSUM’s DESIGN SELECTION PANEL and is used to describe the VSAM ESDS dataset characteristics. When this panel is filled in and ENTER is pressed, the IDCAMS DEFINE parameters will be created and written to “OUTPUT DATASET NAME” specified in the panel.

----------------------- VSUM - DATASET DESIGN PROFILE ------------------------- COMMAND ==> AUTOMATIC ISPF EDIT OF VSUM GENERATED STATEMENTS? ==> Y (Y/N) AUTOMATIC ALLOCATION OF THE DESIGNED DATASET? ==> Y (Y/N) VSUM INPUT TRACE? ==> N (Y/N) DYNAMICALLY ALLOCATE OUTPUT DATASET IF IT DOESN'T EXIST? ==> Y (Y/N) ENTER=SAVE AND EXIT

DESIGN ESDS PANEL

DATASET DESIGN PROFILE PANEL


129

This panel is displayed when “P.D” is selected from VSUM’s PRIMARY OPTION MENU and is used to select the VSUM DESIGN function options.

------------------- VSUM - DATASET ALLOCATION CONFIRMATION --------------------

COMMAND ==> TO CONFIRM DATASET ALLOCATION ENTER \"Y\" OR \"N\". ==> Y (REQUIRED) NOTE: THE FOLLOWING VALUES ARE THOSE SELECTED IN THE DESIGN PANEL. ANY CHANGES MADE TO THESE VALUES IN ISPF EDIT ARE NOT REFLECTED HERE. DATASET NAME ==> SAMPLE.DATASET CATALOG NAME ==> SAMPLE.CATALOG.NAME DASD SPACE TYPE ==> CYL DASD SPACE ==>( 5 , 1 ) DEVICE TYPE ==> 3380 RECORD SIZE ==>( 100 , 200 ) VOLUME ==> VOLUME

This panel is displayed when the ALLOCATE option is YES and EDIT mode is ended when the EDIT option is yes. This panel displays the current VSAM dataset allocation values and provides the user with the option of allocating or not allocating the VSAM dataset just designed.

DATASET ALLOCATION CONFIRMATION PANEL


130

------------------------ VSUM - IDCAMS DEFINE MESSAGES ------------------------- COMMAND ==> MESSAGES FOR DEFINE OF: SAMPLE.DATASET IDCAMS MESSAGES: IDC3013I DUPLICATE DATASET NAME. IDC3009I ** VSAM CATALOG RETURN CODE IS 8 - REASON CODE IS IGG0CLEH-38 IDC3003I FUNCTION TERMINATED. CONDITION CODE IS 12 IDC0002I IDCAMS PROCESSING COMPLETE. MAXIMUM CONDITION CODE WAS 12 **********************************************************************

This panel is displayed if a VSAM dataset fails allocation and will contain the errors received from the VSAM DEFINE request. Refer to your IBM MVS MESSAGES AND CODES publication for a description of the messages that are displayed in this panel.

ABBREVIATIONS: MODEL may be abbreviated as M

BASECLUSTERNAME (dsname) Specifies the VSAM base cluster dataset name that the alternate index (AIX) being modeled is related to. The name specified will be put in the RELATE keyword for the IDCAMS DEFINE AIX generated command.

DEFAULTS: “PUT.YOUR.BASE.CLUSTER.NAME.HERE”

MUTUALLY EXCLUSIVE parameters: TYPE (KSDS ESDS RRDS)

ABBREVIATIONS: BASE, BASECLNAME, BASEN

ALLCISIZES This parameter has the effect of requesting multiple reports using the remaining parameters, varying the CISIZE value to include all possible control interval sizes.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: CISIZE PMODE

ABBREVIATIONS: ALLCI

IDCAMS DEFINE MESSAGES PANEL

MODEL Parameter Descriptions


131

BASEKEYLN (number) Specifies, for AIX datasets, the length of the base key to be used in combination with the DUPKEYS parameter for the maximum records size calculation. If the base cluster is an ESDS then this value should be 4.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: TYPE(KSDS ESDS RRDS) DUPKEYS

ABBREVIATIONS: BASEKEYL, BASEKEYLENGTH

CATALOG (catalogname) Specifies the VSAM catalog name to be used in the generated IDCAMS DEFINE command.

DEFAULTS: (null)

ABBREVIATIONS: CAT

CISIZE (number) Specifies the data component control interval size to be modeled. The “number” must be a valid VSAM control interval size. For NONSPANNED datasets, the “number” must be at least 7 bytes larger than the specified or defaulted maximum record size.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: PMODE ALLCISIZES

ABBREVIATIONS: CISZ, CISIZED, CISIZEDATA

CYLINDERS (primary secondary) Specifies the number of cylinders that will be allocated for the data component. If the number of cylinders exceeds the maximum RBA allowed for a VSAM dataset, the model function will fail. The values for “primary” and “secondary” can be a valid numeric string from 1-9999999.

REQUIRED: YES

MUTUALLY EXCLUSIVE parameters: TRACKS RECORDS

ABBREVIATIONS: CYL, CYLS

DEFOUT (ddname | DEFDD ) Specifies that the VSUM generated IDCAMS define parameters should be written to the specified or defaulted DDNAME. The dataset can be a sequential or partitioned dataset member and must have a logical record length of 80.

DEFAULTS: DEFDD


132

DEVICETYPE (3390 | 3380 | 338E | 338K | 3375 | 3350 | 3340 | 3330 | MSS) Specifies the DASD device type to be used for the modeling calculations.

DEFAULTS: 3380

ABBREVIATIONS: DEVTYPE, DEVICE, DEV

DUPKEYS (number) Specifies, for AIX datasets, the maximum number of duplicate alternate keys expected within the base cluster. If not specified, the default is one “1” and the alternate index IDCAMS define parameters will be generated with UNIQUEKEYS. If specified, this number will be used to calculate a maximum record size value for NONUNIQUEKEY alternate indexes. If the calculated maximum record size is greater than the maximum record size specified, it will be used for the IDCAMS define generation and minimum buffer space requirements. When this parameter is specified, the BASEKEYLN parameter is required. The “number” must be a valid numeric string from 1–99999.

DEFAULTS: 1

MUTUALLY EXCLUSIVE parameters: TYPE(KSDS ESDS RRDS)

ABBREVIATIONS: MAXDUPKEYS, MAXDUPLICATEKEYS

FREERECORDS (cinumber canumber) Specifies the number of control interval and control area free records that VSUM will use for the modeling calculations. The numbers represent free average record size records. The “cinumber” value will cause the modeling feature to calculate a corresponding control interval freespace percentage that equates to the specified number of free records. The “canumber” value will cause the modeling feature to calculate a corresponding control area freespace percentage that equates to the specified number of free records. The “cinumber” and “canumber” values can be a valid numeric string from 0–99999.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: FREESPACE TYPE(ESDS RRDS)

ABBREVIATIONS: FREERECS, FRECS

FREESPACE (cipct capct) Specifies the control interval and control area freespace percentages that VSUM will use for the modeling calculations. The freespace percentages are analogous to the IDCAMS DEFINE FREESPACE parameter and represent “free bytes” for the “cipct” percentage and “free control intervals” for the “capct” percentage.

DEFAULTS: (null)


133

MUTUALLY EXCLUSIVE parameters: FREERECORDS TYPE(ESDS RRDS)

ABBREVIATIONS: FSPC

IMBED Specifies that the indexed dataset will have the index sequence set records imbedded and replicated on the first track of each data component control area.

DEFAULTS: NOIMBED

MUTUALLY EXCLUSIVE parameters: IMBED TYPE(ESDS RRDS)

ABBREVIATIONS: IMB

KEYS(length offset <cmplength>) Specifies, for indexed datasets, the key “length” and key “offset” within the VSAM record. For AIX datasets, the key “length” and key “offset” are for the alternate key within a record on the associated base cluster. The “cmplength” represents the compressed key length and cannot be larger than the “length” value. It can be specified for datasets with poor key compression. If specified, the “cmplength” will be used for the index control interval size calculation in place of the standard 5 byte average compressed key length value. If the “cmplength” value specified is smaller than five bytes, the calculated index control interval size may be too small.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: TYPE(ESDS RRDS)

ABBREVIATIONS: KEY

NAME (dsname) Specifies the VSAM dataset name to be modeled. This name will be used to name the VSAM CLUSTER, DATA and INDEX components when generating the required IDCAMS define parameters. The cluster name will be “dsname”. The data component name will be “dsname.DATA” and the index component name will be “dsname.INDEX”. If the “dsname” specified is longer than 38 characters it will be truncated when used for the data and index component name generation.

REQUIRED: YES

NOIMBED Specifies that the indexed dataset WILL NOT have the index sequence set records imbedded and replicated on the first track of each data component control area.

DEFAULTS: NOIMBED

MUTUALLY EXCLUSIVE parameters: IMBED

ABBREVIATIONS: NOIMB


134

NONSPANNED Specifies that records are not allowed to span control intervals.

DEFAULTS: NONSPANNED

MUTUALLY EXCLUSIVE parameters: SPANNED TYPE(AIX)

ABBREVIATIONS: NONSPAN, NSPA

NOREPLICATE Specifies that the index records WILL NOT BE replicated on a track.

DEFAULTS: NOREPLICATE

MUTUALLY EXCLUSIVE parameters: REPLICATE

ABBREVIATIONS: NOREPL, NOREP

PMODE (DIRECT | SEQUENTIAL | MIXED ) Specifies the processing mode, “DIRECT”, “SEQUENTIAL”, or “MIXED”, which will be used by the programs when they open the dataset to be modeled. VSUM will select the best data control interval size based on the specified processing mode. The control interval size determined to be the best is the one that can fit the most average size records per control area within the processing mode range. If more than one control interval size within a processing mode range can fit an equal amount of records, then the smallest control interval size will be selected by VSUM. If the maximum record size for NONSPANNED datasets is larger than any control intervals within the processing mode range, then the next range will be used to determine the best control interval size.

The PROCESSING MODE Control Interval ranges used are

DIRECT 512 to 4096 MIXED 2048 to 8192 SEQUENTIAL 4096 to 32760

DEFAULTS: MIXED

MUTUALLY EXCLUSIVE parameters: CISIZE ALLCISIZES

ABBREVIATIONS: PROCESSINGMODE, PROCMODE

RECORDS (primary secondary) Specifies the number of average record size records that will be used to calculate the required number of cylinders or tracks for the data component. If FREESPACE or FREERECORDS is also specified, the number of records represents the number of records in the dataset during load mode (not including freespace/freerecords). If the number of cylinders or tracks calculated exceeds the maximum RBA allowed for a VSAM dataset, the model function will fail. The values for


135

“primary” and “secondary” can be a valid numeric string from 1 to 999999999.

REQUIRED: YES

MUTUALLY EXCLUSIVE parameters: CYLINDERS TRACKS

ABBREVIATIONS: RECS, REC

RECSIZE (avg max) Specifies the average and the maximum record size for the dataset to be modeled. If the average record size is not entered, the maximum record size will be used for the average record size. If the maximum record size is not entered, the average record size will be used for the maximum record size. The average record size is used for all allocation and freespace calculations. If it does not represent a true average record size for the dataset, the modeling output may be excessive or insufficient. For NONSPANNED datasets the maximum record size cannot be greater than the CISIZE minus 7. If the processing mode, PMODE, is specified, the maximum record size will influence the chosen data control interval size for NONSPANNED datasets, and could be selected from the next higher processing mode range. For relative record datasets, the “avg” and “max” values must equal. The “avg” and “max” can be a valid numeric string from 1–9999999.

REQUIRED: YES

ABBREVIATIONS: RECSZ, RECORDSIZE

REPLICATE Specifies that the indexed dataset to be modeled will have the high level index records replicated on each track of the index. REPLICATE without IMBED is not recommended because DASD seeks between the INDEX and DATA components will not be avoided unless the INDEX is on a different volume.

DEFAULTS: NOREPLICATE

MUTUALLY EXCLUSIVE parameters: NOREPLICATE TYPE(ESDS RRDS)

ABBREVIATIONS: REPL, REP

SHAREOPTIONS (cr cs) Specifies the VSAM cross region (cr) and cross system (cs) shareoptions to be used in the IDCAMS DEFINE command generation. Valid cross region share options are 1, 2, 3, or 4, and valid cross system share option are 3 or 4. Share option 1 will allow only one update user *OR* multiple read only users to share the dataset for processing on a CPU. Share option 2 will allow one update *AND* multiple read only users to share the dataset for processing on a CPU. Share option 3 will allow multiple update *AND* read only users to


136

share the dataset for processing on one or more CPU’s, but provides no data integrity. Share option 4 allows multiple update *AND* read only users to share the dataset for processing on one or more CPU’s with limited integrity support without full data integrity. Refer to the IBM IDCAMS DEFINE command for detailed information on each share option and the data integrity considerations.

DEFAULTS: 2,3

ABBREVIATIONS: SHARE, SHR

SPANNED Specifies that the dataset to be modeled will have records that are allowed to span control intervals.

DEFAULTS: NONSPANNED

MUTUALLY EXCLUSIVE parameters: NONSPANNED

ABBREVIATIONS: SPAN

TRACKS (primary secondary) Specifies the number of tracks that will be allocated for the data component. If the number of tracks exceeds the maximum RBA allowed for a VSAM dataset, the model function will fail. The values for “primary” and “secondary” can be a valid numeric string from 1 to 9999999.

REQUIRED: YES

MUTUALLY EXCLUSIVE parameters: CYLINDERS RECORDS

ABBREVIATIONS: TRK

TYPE (KSDS | AIX | ESDS | RRDS) Specifies the type of VSAM dataset to be modeled.

KSDS is a keyed sequence dataset.

AIX is an alternate index.

ESDS is an entry sequence dataset.

RRDS is a relative record dataset.

REQUIRED: YES

VOLUME (volser) Specifies the volume to be used in the VOLUME parameter of the generated IDCAMS DEFINE parameters.

DEFAULTS: Device type plus a 2-byte numeric suffix. For example: 338001

ABBREVIATIONS: VOL,V


137

Examples of Use

The following are examples of how to use VSUM’s MODEL feature.

The following example will generate the IDCAMS define parameters and modeling dataset statistics for a KSDS on a 3380. During load processing, 100,000 two-hundred-byte records will be loaded. The data component control interval size selected will be for direct processing and will be the most efficient in the range of 512 to 4096 (DIRECT MODE). Free space percentages for control interval and control area freespace will be calculated by VSUM to allow for 2 free records per control interval, and a minimum of 100 free records in free control intervals for each control area.

//MODL EXEC PGM=VSUM,REGION=300K //STEPLIB DD DSN=VSUM.LOADLIB,DISP=SHR //SYSPRINT DD SYSOUT=A //SYSIN DD * MODEL NAME(SAMPLE.KSDS) TYPE(KSDS) RECORDS(100000) - RECSIZE(200 300) KEYS(10 2) DEVICETYPE(3380) - FREERECS(2 100) PROCMODE(DIRECT) /*

The following example will generate the IDCAMS define parameters and modeling dataset statistics for an AIX on a 3350. Space is requested by cylinders and the total number of average record size records that will fit in 50 cylinders on a 3350 will be listed in the modeling report statistics. The data component control interval size selected will be for sequential processing and will be the most efficient from a range of 4096 to 32760. The maximum record size will be calculated by VSUM based on the DUPKEYS and BASEKEYLN parameters.

//MODL EXEC PGM=VSUM,REGION=300K //STEPLIB DD DSN=VSUM.LOADLIB,DISP=SHR //SYSPRINT DD SYSOUT=A //SYSIN DD * MODEL NAME(SAMPLE.AIX) TYPE(AIX) CYLINDERS(50) - RECSIZE(300) KEYS(20 12) DEVICE(3350) - DUPKEYS(1000) BASEKEYLN(10) - PMODE(SEQUENTIAL) /*

The following example will generate the IDCAMS define parameters and modeling dataset statistics for an ESDS on an MSS. Space is requested by tracks and the total number of average record size records that will fit in 10 tracks on an MSS will be listed in the modeling report statistics. The

Model a KSDS With Free Records on a 3380

Model an AIX With Nonunique Keys on a 3350

Model an ESDS With Spanned Records on an MSS Device


138

data component control interval size selected will be for sequential processing and will be the most efficient from a range of 4096 to 32760.

//MODL EXEC PGM=VSUM,REGION=300K //STEPLIB DD DSN=VSUM.LOADLIB,DISP=SHR //SYSPRINT DD SYSOUT=A //SYSIN DD * MODEL NAME(SAMPLE.ESDS) TYPE(ESDS) TRACKS(10) - RECSIZE(1000 32000) DEVICE(MSS) - SPANNED PMODE(SEQUENTIAL) /*

The following example will generate the IDCAMS define parameters and modeling dataset statistics for an RRDS on a 3330. Space is requested by records. The data component control interval size selected will be for mixed processing (direct and sequential) and will be the most efficient from a range of 2048 to 8192.

//MODL EXEC PGM=VSUM,REGION=300K //STEPLIB DD DSN=VSUM.LOADLIB,DISP=SHR //SYSPRINT DD SYSOUT=A //SYSIN DD * MODEL NAME(SAMPLE.RRDS) TYPE(RRDS) RECORDS(125678) - RECSIZE(200 200) DEVICE(3330) - PROCMODE(MIXED) /*

Model an RRDS on a 3330 for Mixed Mode Processing


139

Output Example and Descriptions

VSUM-MSG SYSIN CONTROL STATEMENTS: MODEL NAME(SAMPLE.KSDS) CATALOG(VSAM.CATALOG) - VOLUME(VOLUME) REC(100) TYPE(KSDS) - DEVICETYPE(3380) PMODE(DIRECT) - SHAREOPTIONS(2,3) RECSIZE(500,700) - KEYS(12,5,4) NOIMBED REPLICATE - FREERECORDS(2 20)

F A N T O M S Y S T E M S VSUM MODEL REPORT PAGE=1 RUN DATE=02/06/2017 RUN TIME=07.50.30 ------------------------------------------------------------------------------------------------------------------------------------ SAMPLE.KSDS (KSDS) ----------------- IDCAMS DEFINE PARAMETERS -----------------* -------------------D A T A------------------- * --- I N D E X --- DEFINE /* KSDS DIRECT MODE PROCESSING */ - * ------- RECORDS ------ * CLUSTER ( - * CISIZE 4096 CI-TOTL 8.00 * CISIZE 512 NAME - * TRKS/CA 2 CI-LOAD 6.00 * TRKS/CA 1 (SAMPLE.KSDS) - * CI/CA-FREE 3 CI-FREE 2.00 * CI/CA 1 SPEED - * CI/CA 20 CA-TOTL 160 * ENT/SECT 5 UNIQUE - * PHYRCSZ 4096 CA-LOAD 102 * LEVELS 1 /* COMMENT */ - * TRKUTIL% 86 CA-FREE 58 * HLVLINDX 0 /* COMMENT */ - * DEVTYPE 3380 DS-TOTL 160 * DEVTYPE 3380 RECSZ (500 700) - * TRACKS 2 DS-LOAD 102 * TRACKS 1 KEYS (12 5) - * DS-FREE 58 * FSPC (25 15) - * * NOIMBED - * * REPLICATE - * *** WARNING *** "REPLICATE" WITHOUT "IMBED" IS NOT RECOMMENDED. NONSPANNED - * * SHR(2 3) ) - * * CATALOG(VSAM.CATALOG ) - * * DATA ( - * * NAME - * * (SAMPLE.KSDS.DATA) - * * CISZ (4096) - * * TRK (2 0) - * * VOLUMES(VOLUME) ) - * * INDEX ( - * * NAME - * * (SAMPLE.KSDS.INDEX) - * * CISZ (512) - * * TRK (1 0) - * * VOLUMES(VOLUME) ) * * VSUM-MSG MODEL PROCESSING COMPLETED. CONDITION CODE=00000

KSDS Dataset


140

VSUM-MSG SYSIN CONTROL STATEMENTS: MODEL NAME(SAMPLE.AIX) CATALOG(VSAM.CATALOG) - VOLUME(VOLUME) TRK(100) TYPE(AIX) - DEVICETYPE(3380) PMODE(DIRECT) - SHAREOPTIONS(2,3) RECSIZE(500,700) - IMBED REPLICATE DUPKEYS(15) - KEYS(10 8 6) FREESPACE (10 15) - BASEKEYLN(15) - BASECLUSTERNAME(SAMPLE.KSDS)

F A N T O M S Y S T E M S VSUM MODEL REPORT PAGE=1 RUN DATE=02/06/2017 RUN TIME=07.50.31 ------------------------------------------------------------------------------------------------------------------------------------ SAMPLE.AIX (AIX) ----------------- IDCAMS DEFINE PARAMETERS -----------------* -------------------D A T A------------------- * --- I N D E X --- DEFINE /* AIX DIRECT MODE PROCESSING */ - * ------- RECORDS ------ * ALTERNATEINDEX ( - * CISIZE 4096 CI-TOTL 8.00 * CISIZE 2048 NAME - * TRKS/CA 15 CI-LOAD 7.00 * TRKS/CA 1 (SAMPLE.AIX) - * CI/CA-FREE 21 CI-FREE 1.00 * CI/CA 1 SPEED - * CI/CA 140 CA-TOTL 1120 * ENT/SECT 12 UNIQUE - * PHYRCSZ 4096 CA-LOAD 833 * LEVELS 2 RELATE - * TRKUTIL% 86 CA-FREE 287 * HLVLINDX 1 (SAMPLE.KSDS ) - * DEVTYPE 3380 DS-TOTL 7840 * DEVTYPE 3380 RECSZ (500 700) - * CYLINDERS 7 DS-LOAD 5831 * TRACKS 1 KEYS (10 8) - * DS-FREE 2009 * FSPC (10 15) - * *** WARNING *** CI FREESPACE TOO SMALL FOR ONE AVGRECSZ RECORD. IMBED - * *** WARNING *** "IMBED" WILL COST 6.7% OF YOUR DATA SPACE. REPLICATE - * * UPGRADE - * * NONUNIQUEKEY - * * SHR(2 3) ) - * * CATALOG(VSAM.CATALOG ) - * * DATA ( - * * NAME - * * (SAMPLE.AIX.DATA) - * * CISZ (4096) - * * CYL (7 0) - * * VOLUMES(VOLUME) ) - * * INDEX ( - * * NAME - * * (SAMPLE.AIX.INDEX) - * * CISZ (2048) - * * TRK (1 0) - * * VOLUMES(VOLUME) ) * * VSUM-MSG MODEL PROCESSING COMPLETED. CONDITION CODE=00000

AIX Dataset


141

VSUM-MSG SYSIN CONTROL STATEMENTS: MODEL NAME(SAMPLE.ESDS) CATALOG(VSAM.CATALOG) - VOLUME(VOLUME) TRK(100) TYPE(ESDS) - DEVICETYPE(3380) PMODE(DIRECT) - SHAREOPTIONS(2,3) RECSIZE(500,700)

F A N T O M S Y S T E M S VSUM MODEL REPORT PAGE=1 RUN DATE=02/06/2017 RUN TIME=07.50.31 ------------------------------------------------------------------------------------------------------------------------------------ SAMPLE.ESDS (ESDS) ----------------- IDCAMS DEFINE PARAMETERS -----------------* -------------------D A T A------------------- * DEFINE /* ESDS DIRECT MODE PROCESSING */ - * ------- RECORDS ------ * CLUSTER ( - * CISIZE 4096 CI-TOTL 8.00 * NAME - * TRKS/CA 15 * (SAMPLE.ESDS) - * * SPEED - * CI/CA 150 CA-TOTL 1200 * UNIQUE - * PHYRCSZ 4096 * NONINDEXED - * TRKUTIL% 86 * /* COMMENT */ - * DEVTYPE 3380 DS-TOTL 8400 * RECSZ (500 700) - * CYLINDERS 7 * NONSPANNED - * * SHR(2 3) ) - * * CATALOG(VSAM.CATALOG ) - * * DATA ( - * * NAME - * * (SAMPLE.ESDS.DATA) - * * CISZ (4096) - * * CYL (7 0) - * * VOLUMES(VOLUME) ) * * VSUM-MSG MODEL PROCESSING COMPLETED. CONDITION CODE=00000

ESDS Dataset


142

VSUM-MSG SYSIN CONTROL STATEMENTS: MODEL NAME(SAMPLE.RRDS) CATALOG(VSAM.CATALOG) - VOLUME(VOLUME) CYL(100) TYPE(RRDS) - DEVICETYPE(3380) PMODE(DIRECT) SPANNED - SHAREOPTIONS(2,3) RECSIZE(5000,5000)

F A N T O M S Y S T E M S VSUM MODEL REPORT PAGE=1 RUN DATE=02/06/2017 RUN TIME=07.50.31 ------------------------------------------------------------------------------------------------------------------------------------ SAMPLE.RRDS (RRDS) ----------------- IDCAMS DEFINE PARAMETERS -----------------* -------------------D A T A------------------- * DEFINE /* RRDS DIRECT MODE PROCESSING */ - * ------- RECORDS ------ * CLUSTER ( - * CISIZE 4096 CI-TOTL .81 * NAME - * TRKS/CA 15 * (SAMPLE.RRDS) - * * SPEED - * CI/CA 150 CA-TOTL 122 * UNIQUE - * PHYRCSZ 4096 * NUMBERED - * TRKUTIL% 86 * /* COMMENT */ - * DEVTYPE 3380 DS-TOTL 12200 * RECSZ (5000 5000) - * CYLINDERS 100 * SPANNED - * * SHR(2 3) ) - * * CATALOG(VSAM.CATALOG ) - * * DATA ( - * * NAME - * * (SAMPLE.RRDS.DATA) - * * CISZ (4096) - * * CYL (100 0) - * * VOLUMES(VOLUME) ) * * VSUM-MSG MODEL PROCESSING COMPLETED. CONDITION CODE=00000

The VSUM modeling report is a single-page report that displays valuable record and dataset statistics for the dataset the user describes with the MODEL parameters. The IDCAMS parameters required to define a dataset of the specified type and characteristics are also printed on the report along with any warning messages about insufficient design parameters. The user may optionally request that the IDCAMS define parameters be written to a sequential output file (DEFOUT parameter) for modification and eventual submission to IDCAMS.

CISIZE: The control interval size calculated for the data or index component. For a data component, it will be the control interval size specified by the user, either explicitly or implicitly, via the PMODE parameter. When the PMODE parameter is specified, the control interval size chosen will be the one that can contain the most average size records within the specified processing mode range. Refer to section “MODEL Parameter Descriptions” on page 130 for a description of the control interval ranges for a processing mode. For an index component, the one chosen will be the smallest possible control interval size capable of addressing all of the data components CI’s per CA. The compressed key length used in the index control interval size calculation is 5 bytes plus pointers unless otherwise specified in the KEYS parameter of the MODEL function.

RRDS Dataset

Field Descriptions


143


CI/CA-FREE: The number of free control intervals in a control area (KSDS and AIX datasets only) based on the specified or calculated control area freespace percentage.

CI/CA: Number of control intervals per control area.

PHYRCSZ: The physical record size for this control interval size.

TRKUTIL%: The percentage of available bytes on a track that can be used for data control intervals.

DEVTYPE: The device type that the calculations were performed for.

CYLINDERS/TRACKS: The total number of cylinders/tracks specified, or required to contain the specified number of records. For the index component, it is the number of cylinders/tracks required to address the number of cylinders/tracks in the data component.

RECORDS: CI-TOTL:

The total number of average record size records that can fit in a control interval.

CI-LOAD: The number of average record size records that can fit in a control interval during load mode.

CI-FREE: The number of average record size records in a control interval that will be free after loading.

CA-TOTL: The total number of average record size records that can fit in a control area.

CA-LOAD: The number of average record size records that can fit in a control area during load mode.


144

CA-FREE: The number of average record size records in control area that will be free after loading.

DS-TOTL: The total number of average record size records that can fit in the dataset.

DS-LOAD: The total number of average record size records that can fit in the dataset after load mode.

DS-FREE: The total number of average record size records that will be free after loading.

ENT/SECT: The number of index entries per index section.

LEVELS: The highest number of index levels required to address the number of cylinders/tracks in the data component.

HLVLIDX: The number of high level index records calculated for the index component.

WARNINGS: CI FREESPACE TOO SMALL FOR ONE AVGRECSZ RECORD:

The freespace specified in the modeling parameters is too small to contain one record of the specified average record size.

‘REPLICATE’ WITHOUT ‘IMBED’ IS NOT RECOMMENDED: REPLICATE without IMBED is not recommended because DASD seeks between the INDEX and DATA components will not be avoided unless the INDEX is on a different volume.

‘TRKS/CA’ IS LESS THAN A CYLINDER: Due to the dataset’s compressed key length, the index cannot address an entire cylinder, so the number of tracks for each control area has had to be reduced to less than a cylinder.

‘IMBED’ WILL COST XXX % OF YOUR DATA SPACE : This caution is made to point out how much of the data component space is being used for the IMBEDDED index sequence set. It is not made to suggest that IMBED be eliminated, but to help in evaluating the cost of the IMBED option in DASD space for an existing device or a new device.


145

“BUFSP” CALCULATED BECAUSE MAXRECSZ GREATER THAN 2 DATA CI’S The specified or calculated maximum recordsize for the spanned dataset is greater than 2 data CI’s. If bufferspace is allowed to default 2 data buffers will be insufficient to contain the largest record possible. The calculated buffer space is the maximum recordsize rounded up to a data control interval boundary plus an index control interval size.

146

5 Dataset Recommendations

Overview

The task of tuning VSAM datasets is one that requires ongoing monitoring of VSAM dataset space utilization and characteristics. Although most information required for successful monitoring of VSAM datasets can be obtained from an IDCAMS list catalog, the VSAM user must have experience reading the output. Then, the VSAM users with the required experience must still perform time consuming calculations from the listed output to monitor VSAM datasets. Additional calculations must also be performed for tuning when it is determined that control interval sizes, freespace, or space values must change. The combination of VSUM’s LIST, ANALYZE, MODELING and RECOMMENDATIONS output will provide all the necessary statistical and tuning information in an easy to read format.

VSUM’s RECOMMENDATION feature can be used by both system and application personnel that are responsible for the ongoing monitoring and tuning of VSAM datasets. This feature will provide the required statistical and tuning information needed that would normally have had to be calculated, and can be executed under TSO/ISPF or by batch execution.

The actual process of using the information available and performing the required dataset changes is one that will still be the responsibility of an installation. It is suggested that users of VSUM’s RECOMMENDATION feature obtain and read the IBM Technical Bulletin “OS/VS VSAM Performance Guidelines” (GG22-9295) which was used as a foundation for many of VSUM’s recommendations.

VSAM Dataset Monitoring and Tuning

VSUM for z/OS Program Description and Operations Guide Dataset Recommendations

147

Suggested Uses

The VSUM RECOMMENDATION function is extremely helpful for monitoring and tuning VSAM datasets in the following ways:

• Buffer allocation recommendations for improved program performance can be made for direct, sequential, or mixed mode processing.

• Efficient control interval sizes for data and index components can be recommended based on a processing mode or average compressed keylength.

• VSAM dataset attributes or characteristics that can cause performance problems can be monitored and have recommendations made for them.

• VSAM dataset reorganization recommendations can be made based on full datasets, control area splitting, and secondary allocation.

• Freespace percentage recommendations can be made based on the even or uneven distribution of free bytes or free records.

• Allocation recommendations can be made based on used or allocated tracks or cylinders for a different device type to assist in DASD migrations.


148


The VSUM RECOMMENDATIONS function can be performed in batch mode, by selecting the “R” line option on a LIST DATASET SELECTION PANEL, or by specifying “YES” in the RECOMMENDATIONS field of the “ANALYZE FOREGROUND/BACKGROUND MENU”

A batch mode RECOMMENDATIONS function can be performed by specifying the RECOMMENDATIONS parameter and subparameters on a VSUM LIST, ANALYZE, or REPRINT command in the SYSIN DD statement and executing the program VSUM.

An ISPF RECOMMENDATIONS function can be performed by specifying “YES” on the RECOMMENDATIONS option on a LIST SELECTION PANEL, by specifying “R” as a line option in the LIST DATASET SELECTION PANEL, or by specifying “YES” on the RECOMMENDATIONS option of the “ANALYZE FOREGROUND / BACKGROUND MENU”. The RECOMMENDATIONS subparameters are specified in the VSUM RECOMMENDATIONS PROFILE PANEL. This panel can be selected by specifying “P.R” on the command line of VSUM’s PRIMARY OPTION MENU.

RECOMMENDATIONS ( ALL | ATTRIBUTES BUFFERS CISIZE (DIRECT | SEQUENTIAL | MIXED ) FREESPACE ( EVEN | UNEVEN pct | INSERTRATE BYTES | RECORDS) NEWDEVICE (3390 | 3380 | 338E | 338K | 3375 | 3350 | 3340 | MSS) REORGANIZATION SPACE (USED | ALLOCATED | RECORDS | pct) )

Batch Mode

ISPF Mode

Batch Command Input


149

------------------- VSUM - DATASET RECOMMENDATIONS PROFILE -------------------- COMMAND ==> DATASET DEFINITION RECOMMENDATIONS: (CHOOSE ONE OR MORE) ALL ==> Y (Y/N) TYPE 'ALL' IS MUTUALLY EXCLUSIVE ATTRIBUTES ==> WITH OTHER DATASET DEFINITION BUFFERS ==> RECOMMENDATIONS. REORGANIZATION ==> CI SIZE ==> (D=DIRECT,S=SEQUENTIAL,M=MIXED); DEFAULT=MIXED DATASET FREESPACE RECOMMENDATIONS: (CHOOSE ONE OR MORE) KEY INSERTION ==> E (E=EVEN,U=UNEVEN); DEFAULT=EVEN PERCENT ==> (TOTAL FREESPACE (1-100)); DEFAULT=DATASET DEFINITION TYPE ==> R (B=BYTES,R=RECORDS); DEFAULT=BYTES INSERTRATE ==> (Y/N) MUTUALLY EXCLUSIVE W/FREESPACE PERCENT DATASET SPACE RECOMMENDATIONS: (CHOOSE ONE OR MORE) TYPE ==> A (U=USED,A=ALLOCATED,R=RECORDS) DATASET GROWTH ==> 20 (FUTURE GROWTH RATE; (1-100)) NEW DEVICE TYPE RECOMMENDATIONS: (SPACE RECOMMENDATIONS ARE MUTUALLY REQUIRED) DEVICE TYPE ==> 3380 (3380,338E,338K,3375,3350,3390,MSS) ENTER=SAVE AND EXIT

This panel is displayed when “P.R” is specified in the command line of VSUM’s PRIMARY OPTION MENU and is used to select the RECOMMENDATIONS options to be used with subsequent RECOMMENDATIONS requests.

ABBREVIATIONS: RECOMMENDATIONS may be abbreviated as RECOMM

ALL Specifies that the ATTRIBUTES, BUFFERS, REORGANIZATION, and CISIZE(MIXED) recommendations will be made for all the VSAM KSDS, AIX, ESDS, and RRDS datasets listed by the LIST command or the VSAM KSDS and AIX datasets processed by the ANALYZE command.

DEFAULTS: ALL

MUTUALLY EXCLUSIVE parameters: ATTRIBUTES BUFFERS REORGANIZATION CISIZE

ATTRIBUTES Specifies that the dataset attribute recommendations will be made for each dataset processed. The attributes that are checked recommendations made for are: RECOVERY, ERASE, WRITECHECK, REPLICATE, SHAREOPTIONS, and IMBED.

ISPF Input Panels

RECOMMENDATIONS PROFILE Panel

RECOMMENDATIONS Parameter Descriptions


150

DEFAULTS: (yes if ALL specified or defaulted)

MUTUALLY EXCLUSIVE parameters: ALL

ABBREVIATIONS: ATTR

BUFFERS Specifies that buffer recommendations will be made for the datasets processed. The buffer recommendations will be made for DATA and INDEX components and will show the minimum and maximum buffer numbers required for DIRECT, SEQUENTIAL, and MIXED mode processing. Utilization of the recommended maximum buffers can provide significant performance improvements. If CISIZE or NEWDEVICE is specified, the control interval sizes used for the buffer calculations will be the new control interval size(s).

DEFAULTS: (yes if ALL)


ABBREVIATIONS: BUFF, BUF

CISIZE (DIRECT | SEQUENTIAL | MIXED ) Specifies that control interval recommendations for the specified processing mode will be made for the datasets processed. If the NEWDEVICE parameter is also specified, the control interval sizes recommended will apply to the new device type.

VSUM will select the most efficient data control interval size based on the specified processing mode and average record size. The average record size used will be the defined average record size for LIST functions, and the calculated average record size for LIST ANALYZE and ANALYZE functions. The most efficient control size is the one that can fit the most average record size records per control area within a given processing mode range. If the defined average size does not represent a true average record size, the data control interval size recommended during a LIST function may not be the most efficient possible.

PROCESSING MODE Control Interval ranges

DIRECT 512 to 4096 MIXED 2048 to 8192 SEQUENTIAL 4096 to 32760

The index control interval size is calculated based on the recommended or current data control interval size and the average compressed key length. The average compressed key length is 5 for LIST functions, and the greater of 5 or the calculated compressed key length for LIST ANALYZE and ANALYZE function.

DEFAULTS: MIXED if ALL is specified or defaulted


151


ABBREVIATIONS: CISZ

FREESPACE (EVEN | UNEVEN <pct | INSERTRATE > BYTES | RECORDS ) Specifies that freespace recommendations based on the specified subparameters will be made for the datasets processed. The VSAM control interval and control area freespace percentages will be calculated based on the even or uneven distribution of a single percentage of free bytes or free average record size records. Even freespace should be specified when the keys of the inserted records are evenly distributed throughout the dataset. Uneven freespace should be specified when the keys of the inserted records are unevenly distributed (grouped) throughout the dataset.

If the NEWDEVICE parameter is also specified, the freespace recommendations will apply to the new device type.

The single percentage of freespace can be specified by the “pct | INSERTRATE” subparameter. If the “pct | INSERTRATE” subparameter is not specified, the control interval and control area freespace percentages currently defined for the dataset will be converted to an equivalent single percentage value. If the “pct | INSERTRATE” is not specified and there is no freespace defined for the dataset, the freespace recommendations will not be made.

EVEN distribution is a 3 to 1 ratio for control interval freespace and control area freespace respectively. If a freespace percentage of forty percent (40) is specified, then thirty percent (30) of the bytes in a control area will be allocated to control interval freespace and ten percent (10) will be allocated to control area freespace.

UNEVEN distribution is a 1 to 3 ratio for control interval and control area freespace respectively.

The “pct” value can be a percentage value from 1 to 100 and represents a single percentage to be distributed evenly or unevenly in the dataset. The “INSERTRATE” indicates that instead of specifying an explicit percentage or using the defined percentage(s), VSUM will calculate the logical record insertion rate and use that rate as the percentage. If the logical insertion rate is greater than 100 percent, 100 percent will be used. Freespace will be calculated in free average record size records when INSERRATE is specified.

BYTES indicates that the single percentage used for the freespace calculations represents bytes. BYTES is ignored if INSERTRATE is also specified. RECORDS indicates that the single percentage used for the freespace calculations represents free average record size records. If “INSERTRATE” or “RECORDS” is specified, the average


152

record size used will be the defined average for LIST functions, and the calculated average for LIST ANALYZE and ANALYZE functions.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: TYPE(ESDS RRDS)

ABBREVIATIONS: FSPC

NEWDEVICE (3390 | 3380 | 338E | 338K | 3375 | 3350 | 3340 | MSS) Specifies that the CISIZE, FREESPACE, and SPACE recommendations are to be made for the datasets processed based on the new device type.

DEFAULTS: (current device type)

ABBREVIATIONS: NEWDEVICE, NEWDEV

REORGANIZATION Specifies that reorganization recommendations will be made for the datasets processed. The reorganization recommendations will be made for those datasets that have gone into secondary allocation, have one or more control area splits, and are full (HIGH USED RBA equal to HIGH ALLOCATED RBA) with no secondary space allocation or additional volumes (candidate).

DEFAULTS: (yes if ALL specified or defaulted)


ABBREVIATIONS: REORG

SPACE (USED | ALLOCATED | RECORDS <pct>) Specifies that space allocation recommendations based on the specified subparameters will be made for the datasets processed. If the NEWDEVICE parameter is also specified, the allocation recommendations will apply to the new device type. The data component space recommendations will be made according to the USED, ALLOCATED, and RECORDS subparameters. The index component space recommendations will be made according the recommended data component space allocation amount and not on the existing allocation amount.

USED specifies that the space recommendation is to be made based on the number or equivalent number cylinders or tracks currently used (not free) in the data component.

ALLOCATED specifies that the space recommendations be made based on the number or equivalent number of cylinders or tracks currently allocated (used and free) in the data component.


153

RECORDS specifies that the current logical record count will be used to calculate the data component space amount. The defined average record size will be used for LIST function space calculations, and the calculated average record size will be used for LIST ANALYZE and ANALYZE function space calculations.

The “pct” value can be a valid numeric percentage from 1 to 100. It represents a growth rate or additional percentage to be added to the cylinder, track, or record value used for the data component space calculations.

DEFAULTS: (null)


154

Examples of Use

The following example will list the VSAM catalog named UCAT1 and make buffer recommendations for all KSDS datasets that have a data control interval size of 4096.

//RECOM EXEC PGM=VSUM,REGION=500K //STEPLIB DD DSN=STAR.VSUM.LOADLIB,DISP=SHR //SYSPRINT DD SYSOUT=A //SYSIN DD * LIST CAT(UCAT1) TYPE(KSDS) CISIZE(4096:EQ) - RECOMM(BUFFERS) /*

The following example will analyze a KSDS and make freespace recommendations based on the current freespace percentages for even key distribution.

//RECOM EXEC PGM=VSUM,REGION=500K //STEPLIB DD DSN=STAR.VSUM.LOADLIB,DISP=SHR //SYSPRINT DD SYSOUT=A //SYSIN DD * ANALYZE NAME(THIS.IS.A.KSDS) RECOMM(FREESPACE(EVEN)) /*

The following example will list all VSAM datasets that are defined fully or partially on volume 333001, and make recommendations about space allocation requirements on a new device type.

//RECOM EXEC PGM=VSUM,REGION=500K //STEPLIB DD DSN=STAR.VSUM.LOADLIB,DISP=SHR //SYSPRINT DD SYSOUT=A //SYSIN DD * LIST CAT(UCAT2) VOLUME(333001) TYPE(KSDS ESDS AIX RRDS) - RECOMM(SPACE(ALLOCATED) NEWDEVICE(3380)) /*

The following example will analyze the AIX specified, list the statistics along with a recommendation for data and index control interval sizes for direct-processing mode. The index control interval size will be recommended based on the compressed key length calculated from the dataset analysis, and on the recommended data control interval size.

List All KSDSs in a Catalog and Make Recommendations

Analyze a KSDS and Make Freespace Recommendations

List All Selected Datasets and Recommend Allocation for New Device

Analyze an AIX and Make CISIZE Recommendations for Direct Processing


155

//RECOM EXEC PGM=VSUM,REGION=750K //STEPLIB DD DSN=STAR.VSUM.LOADLIB,DISP=SHR //SYSPRINT DD SYSOUT=A //SYSIN DD * ANALYZE NAME(THIS.IS.AN.AIX) RECOMM(CISIZE(DIRECT)) /*


156


----------------------------------------------------- R E C O M M E N D A T I O N S ---------------------------------------------- ATTRIBUTES: "RECOVERY" IS NOT RECOMMENDED UNLESS LOAD JOBS ARE RESTARTED. "ERASE" IS NOT RECOMMENDED UNLESS YOUR DATA IS EXTREMELY SENSITIVE. "WRITECHECK" IS NOT RECOMMENDED. "REPLICATE" WITHOUT IMBED IS NOT RECOMMENDED. "SHR(3)" CROSS REGION SHARE OPTION PROVIDES NO DATA INTEGRITY. "SHR(4)" CROSS REGION SHARE OPTION CAN CAUSE SLOWER PERFORMANCE. "SHR(,4)" CROSS SYSTEM SHARE OPTION CAN CAUSE SLOWER PERFORMANCE. "IMBED" IS COSTING 6.7% OF YOUR DATA SPACE. REORGANIZATION: "FULL" DATASET IS FULL, NO SECONDARY ALLOCATION OR CANDIDATE VOLUMES SPECIFIED. "CASPLITS" 6.7% OF YOUR CONTROL AREAS HAVE SPLIT. "SEC-ALLOC" DATA COMPONENT HAS ENTERED SECONDARY ALLOCATION 11 TIME(S). BUFFERS: PROCESSING MODE: BUFND(MIN/MAX) BUFNI(MIN/MAX) DIRECT 2/2 1/4 SEQUENTIAL 4/60 1/1 MIXED 4/60 1/4 CISIZE: "DATA CISIZE(8192) FOR MIXED MODE PROCESSING BASED ON MAXRECSZ REQUIREMENTS. WILL GIVE YOU 19% BETTER TRACK UTILIZATION. "INDEX CISIZE(2048) FOR AN AVERAGE COMPRESSED KEY LENGTH OF 10. FREESPACE: "FSPC(15 9)" FOR 25% FREESPACE(RECORDS) WITH EVEN DISTRIBUTION. SPACE: "DATA CYL(522)" FOR USED SPACE PLUS A 10% GROWTH RATE. "INDEX TRK(100)"

The VSUM recommendations report will be a single-page report with ANALYZE and REPRINT functions, and additional section for a VSAM KSDS, ESDS, RRDS, or AIX entry with a LIST function. This report will also be generated when a TSO/ISPF ANALYZE function with RECOMMENDATIONS is performed. If a foreground TSO/ISPF ANALYZE function was selected, this report can be viewed by selecting the “S” option on the DATASET ANALYSIS REPORT MENU.

Batch Output


157

---------------- VSUM - DATASET RECOMMENDATIONS - PAGE 1 OF 2 ---------------

-- COMMAND ==> RECOMMENDATIONS FOR: SAMPLE.DATASET (KSDS) ON A 3330 DEVICE. ATTRIBUTES: \"SHR(3)\" CROSS SYSTEM SHARE OPTION PROVIDES NO DATA INTEGRITY. \"SHR(4)\" CROSS REGION SHARE OPTION CAN CAUSE SLOWER PERFORMANCE. REORGANIZATION: \"DATASET IS FULL\" NO SECONDARY ALLOCATION OR CANDIDATE VOLUMES SPECIFIED. END=EXIT ENTER=NEXT PAGE PF10=PRINT SCREEN

This panel is the first of two panels that will be displayed when recommendations are selected for a dataset from the LIST DATASET SELECTION PANEL. When RECOMMENDATIONS are performed during a foreground or background ANALYZE function, the batch RECOMMENDATIONS report format is generated. The recommendations that can be made are described in the “Field Descriptions” section below.

ISPF Output

ISPF Recommendations

Output Panel (1 of 2)


158

---------------- VSUM - DATASET RECOMMENDATIONS - PAGE 2 OF 2 ---------------

-- COMMAND ==> RECOMMENDATIONS FOR: SAMPLE.DATSET (KSDS) ON A 3330 DEVICE. BUFFERS: BUFND(MIN/MAX) BUFNI(MIN/MAX) DIRECT 2/2 1/2 SEQUENTIAL 3/3 1/1 MIXED 3/3 1/2 CISIZE: \"DATA CISIZE(4096)\" FOR MIXED MODE PROCESSING BASED ON MAXRECSZ REQUIREMENTS. \"INDEX CISIZE(512)\" FREESPACE: \"FSPC(15,5)\" FOR 20% FREESPACE(BYTES) WITH EVEN DISTRIBUTION. SPACE: \"DATA CYL(13)\" FOR ALLOCATED SPACE PLUS A 20% GROWTH RATE. \"INDEX TRK(1)\" END=EXIT ENTER=PREVIOUS PAGE PF10=PRINT SCREEN

This panel is the second of two panels that will be displayed when recommendations are selected for a dataset from the LIST DATASET SELECTION PANEL. When RECOMMENDATIONS are performed during a foreground or background ANALYZE function, the batch RECOMMENDATIONS report format is generated. The recommendations that can be made are described in the “Field Descriptions” section below.

ISPF Recommendations

Output Panel (2 of 2)


159

RECOMMENDATIONS THAT CAN BE MADE

1. ATTRIBUTES: a. "RECOVERY" IS NOT RECOMMENDED UNLESS LOAD JOBS ARE RESTARTED. b. "ERASE" IS NOT RECOMMENDED UNLESS YOUR DATA IS EXTREMELY SENSITIVE. c. "WRITECHECK" IS NOT RECOMMENDED. d. "REPLICATE" WITHOUT IMBED IS NOT RECOMMENDED. e. "SHR(3)" CROSS REGION SHARE OPTION PROVIDES NO DATA INTEGRITY. f. "SHR(4)" CROSS REGION SHARE OPTION CAN CAUSE SLOWER PERFORMANCE. f. "SHR(,4)" CROSS SYSTEM SHARE OPTION CAN CAUSE SLOWER PERFORMANCE. g. "IMBED" IS COSTING nn.n% OF YOUR DATA SPACE. g. "IMBED" WILL COST nn.n% OF YOUR SPACE ON A "devt" DEVICE. 2. REORGANIZATION: a. "FULL" DATASET IS FULL, NO SECONDARY ALLOCATION OR CANDIDATE VOLUMES SPECIFIED. b. "CASPLITS" nn.n% OF YOUR CONTROL AREAS HAVE SPLIT. c. "SEC-ALLOC" DATA COMPONENT HAS ENTERED SECONDARY ALLOCATION nn TIME(S). 3. BUFFERS: PROCESSING MODE: BUFND(MIN/MAX) BUFNI(MIN/MAX) a. DIRECT 2/2 1/4 b. SEQUENTIAL 4/60 1/1 c. MIXED 4/60 1/4 4. NEW DEVICE TYPE RECOMMENDATIONS: DEVICE TYPE = devt 5. CISIZE: a. "DATA CISIZE(xxxx) FOR modetype MODE PROCESSING BASED ON MAXRECSZ REQUIREMENTS. b. "DATA CISIZE(xxxx) FOR modetype MODE PROCESSING BASED ON FREE RECORDS AND MAXRECSZ REQUIREMENTS. c. "DATA CISIZE(xxxx) FOR modetype MODE PROCESSING BASED ON FREE RECORDS. d. WILL GIVE YOU nn% BETTER TRACK UTILIZATION. e. "INDEX CISIZE(xxxx) FOR AN AVERAGE COMPRESSED KEY LENGTH OF nn. 6. FREESPACE: a. "FSPC(ci ca)" FOR xx% FREESPACE(RECORDS) WITH EVEN DISTRIBUTION. b. "FSPC(ci ca)" FOR xx% FREESPACE(RECORDS) WITH UNEVEN DISTRIBUTION. c. "FSPC(ci ca)" FOR xx% FREESPACE(BYTES) WITH EVEN DISTRIBUTION. d. "FSPC(ci ca)" FOR xx% FREESPACE(BYTES) WITH UNEVEN DISTRIBUTION. e. "FSPC(ci ca)" FOR xx% INSERT RATE(RECORDS) WITH EVEN DISTRIBUTION. f. "FSPC(ci ca)" FOR xx% INSERT RATE(RECORDS) WITH UNEVEN DISTRIBUTION. 7. SPACE: a. "DATA CYL(xxxx)" FOR "nnnnn" RECORDS. b. "DATA CYL(xxxx)" FOR "nnnnn" RECORDS PLUS A nn% GROWTH RATE. c. "DATA CYL(xxxx)" FOR USED SPACE d. "DATA CYL(xxxx)" FOR USED SPACE PLUS A nn% GROWTH RATE. e. "DATA CYL(xxxx)" FOR ALLOCATED SPACE. f. "DATA CYL(xxxx)" FOR ALLOCATED SPACE PLUS A nn% GROWTH RATE. g. "INDEX TRK(xxxx)"

1. ATTRIBUTE RECOMMENDATIONS

The attribute recommendations will be made when the ALL or ATTRIBUTE subparameter is specified in the RECOMMENDATIONS parameter or a LIST, ANALYZE, or REPRINT function.

a. “RECOVERY” This recommendation is made so that control interval preformatting is not performed during the load process. The preformatting of control intervals is not required unless the load jobs must be restarted.

b. “ERASE” This recommendation is made so that when a dataset is deleted by IDCAMS, its control intervals are not written over with binary zeros.

c. “WRITECHECK” This recommendation is made due to the dependability of current DASD devices. Valuable processing time may be wasted by asking VSAM to verify each control interval it writes to DASD. Note: WRITECHECK may still be valid for datasets for which write integrity is an absolute requirement.

Field Descriptions


160

d. “REPLICATE” This recommendation is made because the DASD seeks between the data and index components will not be minimized with this option unless the index is on a different volume. Even with the data and index components placed on a different volumes, the number of index seeks is dependent on other volume activity.

e. “SHR(3)” This recommendation is made because an unnecessary dataset integrity risk is being taken unless all the programs that update the dataset use their own MVS ENQ/RESERVE logic to guarantee it. VSAM will let more than one job open the dataset for update processing on the same CPU.

f. “SHR(4)” This recommendation is made because unless programs require that buffers be refreshed for each request and/or the dataset not be extended, unnecessary DASD activity will cause job execution to be slower.

g. “IMBED” This recommendation or caution is made to point out how much of the data component space is being used for an IMBEDDED index sequence set. It is not made to suggest that IMBED be eliminated, but to help in evaluating the cost of the IMBED option in DASD space for an existing device or a new device.

2. REORGANIZATION RECOMMENDATIONS

The reorganization recommendations will be made when the ALL or REORG subparameter is specified in the RECOMMENDATIONS parameter of a LIST, ANALYZE, or REPRINT function.

a. “FULL” This recommendation is made when the high used RBA is equal to the high allocated RBA for the data component, and there were no secondary allocation amounts or additional volumes specified during the dataset define. If records are added or updated on the data component, a control area split or dataset extension will be required and the job will fail.

b. “CASPLITS” This recommendation or caution is made to assist in deciding if reorganization is needed because of excessive control area splitting. Insufficient or zero freespace, or uneven key distribution of inserted records can have caused excessive control area splitting. If the freespace appears to be insufficient or zero, the MODELING function can be used to calculate the freespace percentages based on free record values. If record insertions are unevenly distributed, within one or more key ranges and not evenly throughout the dataset, the RECOMMENDATION FREESPACE parameter can be used to calculate freespace percentages based on UNEVEN distribution of keys.


161

c. “SEC-ALLOC” This recommendation or caution is made to point out that secondary allocation has been entered and that a larger PRIMARY allocation amount, additional volumes, or larger/redistributed FREESPACE may be needed.

3. BUFFER RECOMMENDATIONS

The buffer recommendations will be made when the ALL or BUFFERS subparameter is specified in the RECOMMENDATIONS parameter or a LIST, ANALYZE, or REPRINT function.

a. DIRECT The direct buffer recommendations are made for programs that process the dataset for DIRECT processing with a string number(STRNO) of one(1). The BUFND values are STRNO plus one (1) for minimum and maximum. The BUFNI values are the number of index levels - 1 plus STRNO for minimum, and the number of index set records plus STRNO for maximum. If a program requires more than one string (STRNO) to open the dataset, then the minimum and maximum values for BUFND and BUFNI should be increased by STRNO-1.

b. SEQUENTIAL The sequential buffer recommendations are made for programs that process the dataset for SEQUENTIAL processing with a string number(STRNO) of one(1). The BUFND values are four (4) for minimum, and 2 times the data CI’s per track plus STRNO for maximum. If performance is extremely critical and virtual storage is not a problem, the maximum value can be increased by its original value for each additional track to be processed until additional paging becomes a problem. The BUFNI minimum and maximum value is equal to the STRNO. If more than one string (STRNO) is required to open the dataset, then the minimum and maximum values for BUFND and BUFNI should be increased by STRNO-1.

c. MIXED The mixed buffer recommendations are made for programs that process the dataset for skip sequential or mixed mode processing. The BUFND values are made based on SEQUENTIAL processing BUFND requirements in the previous paragraph, and the BUFNI values are made based on DIRECT processing BUFNI requirements explained in the previous paragraph (1. a.)

4. NEW DEVICE TYPE RECOMMENDATIONS

The recommendations that can be made based on a new device type are CISIZE, FREESPACE, or SPACE recommendations. These are specified in the RECOMMENDATIONS parameter of a LIST, ANALYZE, or REPRINT function with the NEWDEVICE parameter. Any recommendation categories that follow this line are based on the new device type.


162

5. CISIZE

a. This recommendation gives the best fit control interval size based on the specified processing mode, average record size, and the maximum defined recordsize. The defined average recordsize is used for LIST functions and the calculated average record size is used for ANALYZE functions.

b. This recommendation gives the best fit control interval size based on the specified processing mode, average record size, the number of free records needed in a control interval, and the maximum defined recordsize. The defined average recordsize is used for LIST functions and the calculated average record size is used for ANALYZE functions.

c. This recommendation gives the best fit control interval size based on the specified processing mode, average record size, and the number of free records needed in a control interval. The defined average recordsize is used for LIST functions and the calculated average recordsize is used for ANALYZE functions.

d. This line is printed when the recommended DATA CISIZE will improve VSAM’s track utilization over the current control interval size.

e. This recommendation shows an index control interval size based on CI’s per CA for the recommended data control interval size, and a compressed key length of 5 for LIST functions and a compressed key length of 5 or greater for ANALYZE functions.

6. FREESPACE

The freespace percentage can be specified by the user or taken from the defined freespace values. It can be a percentage of FREE BYTES, FREE RECORDS, or the INSERT RECORD PERCENTAGE RATE. The INSERT RECORD PERCENTAGE RATE is calculated by dividing the number of inserted records by the total number of records minus inserted records. For EVEN distribution, the specified freespace percentage is divided in favor of control interval freespace with a 3:1 ratio. For UNEVEN distribution, the specified freespace percentage is divided in favor of control area freespace with a 3:1 ratio. The average record size used for freespace calculations is the DEFINED average for the LIST function, and the calculated for the ANALYZE function.

a. This freespace recommendation is based on the even distribution of the specified percentage of free average record size records.

b. This freespace recommendation is based on the uneven distribution of the specified percentage of free average record size records.


163

c. This freespace recommendation is based on the even distribution of the specified percentage of free bytes.

d. This freespace recommendation is based on the uneven distribution of the specified percentage of free bytes.

e. This freespace recommendation is based on the even distribution of the current insert record rate percentage.

f. This freespace recommendation is based on the uneven distribution of the current insert record rate percentage.

7. SPACE

The space recommendations can be made based on the current number of records on the dataset, the used space in the dataset, or the total allocated space for the dataset. A growth rate can be specified for the space recommendations. The device type that the recommendation will be made for can either be the current device type(default) or a new device type specified in the NEWDEVICE parameter.

The number of records used for a LIST function will be the number of records for the dataset shown in the catalog. The number of records used for an ANALYZE function will be the calculated number of records for the entire dataset or for the part of the dataset that will be analyzed.

The number of used tracks/cylinders for a LIST and a complete ANALYZE function will be the total number of tracks/cylinders used for the dataset. The number of used tracks/cylinders for a partial ANALYZE function will be the number of used tracks/cylinders analyzed.

The number of allocated tracks/cylinders for a LIST and a complete ANALYZE function will be the total allocated tracks/cylinders for the data component. The number of allocated tracks/cylinders for a partial ANALYZE function will be the number of allocated tracks/cylinders analyzed.

a. This recommendation indicates the number of tracks or cylinders required for the number of average recordsize records indicated.

b. This recommendation indicates the number of tracks or cylinders required for the number of average record size records indicated plus the specified growth.

c. This recommendation indicates the number of tracks or cylinders required based on used space in the dataset.


164

d. This recommendation indicates the number of tracks or cylinders required based on used space in the dataset plus the specified growth rate.

e. This recommendation indicates the number of tracks or cylinders required based on allocated space in the dataset.

f. This recommendation indicates the number of tracks or cylinders required based on allocated space in the dataset plus the specified growth rate.

g. This recommendation indicates the number of tracks or cylinders required for the index component to support the data component space recommendation.

165

6 Reprint of Reports

Overview

The VSUM REPRINT function allows the reprinting of any previously produced catalog lists, analysis, or performance recommendations for VSAM KSDS, ESDS, RRDS, or AIX datasets. VSUM can list for a specific date or a range of dates, and if the previous report was produced using the VSUM ANALYZE function, all the reports providing graphic and statistical information at the Dataset, Control Area, and Control Interval level can be reproduced. The recommendations on dataset attributes, control interval sizes, freespace percentages, reorganization considerations, buffer space requirements, and space requirements for new device types can also be reproduced.

The REPRINT function is only available through batch mode, and is NOT AVAILABLE with the TSO/ISPF interface.

The REPRINT function can be performed for more than one dataset per execution by specifying multiple REPRINT commands. The CASTATS reprint will only reprint one Control Area report, Control Interval report, or Keyrange report per VSUM command. With the use of the FROM and TO parameters, all the Dataset Reports for a dataset over a given period can be reprinted.

VSUM for z/OS Program Description and Operations Guide Reprint of Reports

166

Suggested Uses

The VSUM REPRINT function and its various reports can be useful in tracking your VSAM datasets in the following ways:

• All reports can be reproduced as long as the original run specified SAVE, so there is no more concern over lost listings or reports.

• Dataset trending is made possible since there is now a way to save dataset statistics over a period. With the statistical records described to SAS, for example, many monthly or yearly trends could be graphed or reported on.

• DASD space utilization can be monitored, and trends could help determine when more DASD would be needed.

• Growth rate of key datasets could be monitored.


167

Command Input

REPRINT CACOUNT (number) CAEND (number | qstring) CAGRAPH (YES | NO | OVERLAY FULL NOTFULL EMPTY SPLIT LOSTCI FREESPACE (pct | 0 < :cond | GE >) LINECNT (number | 55 ) ) CAREPORT (YES | NO FULL NOTFULL EMPTY SPLIT LOSTCI FREESPACE (pct | 0 < :cond | GE >) LINECNT (number | 55 ) ) CASTART (number | qstring) CASTATDD (ddname | CASTATS /readpw) CAVOLUME (volser) CIREPORT (YES | NO LINECNT (number | 55 ) FROMCA (number | 1 ) COUNT (number | 1 ) ) DSREPORT (YES | NO,SAVE | NOSAVE ) DSSTATDD (ddname | DSSTATS /readpw) FROM (mmddyyyy | mm/dd/yyyy | yyyyddd) KRREPORT (DSHI,DSLO,CAHI,CALO,CIHI,CILO LINECNT(number | 55 ) ) NAME (dsname/cntrlpw) RECOMMENDATIONS(...) (See DATASET RECOMMENDATIONS section) TO (mmddyyyy | mm/dd/yyyy | yyyyddd)

ABBREVIATIONS: REPRINT may be abbreviated as R or REPR

CACOUNT (number) This parameter specifies how many control areas are to be reprinted for a dataset. This parameter will cause a partial dataset analysis to be performed, and can only be done for control areas that were saved on the initial run.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: CAVOLUME CAEND

ABBREVIATIONS: CACNT

CAEND (number qstring) This parameter specifies the last control area in the VSAM dataset to be reprinted. If a number is specified the reprint will stop after the

Batch Command Input

REPRINT Parameter Descriptions


168

control area is processed. If a quoted string is specified, the reprint will stop after the control area that contains a key greater than or equal to the quoted string. This parameter will cause a partial dataset reprint to take place, and can only be done if the statistics were saved on the original run.


qstring: A full or partial key value in quotes. The key value can be specified in character 'character' or hexadecimal x'hexadecimal' format and cannot exceed 255 characters or 510 hexadecimal characters in length. If there are quotes (') in the key then a double quote ('') can be specified for each occurrence of a quote.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: CAVOLUME CACOUNT

CAGRAPH (YES | NO | OVERLAY FULL NOTFULL EMPTY SPLIT LOSTCI FREESPACE (pct | 0 < :cond | GE >) LINECNT(number | 55 )) This parameter specifies whether the CONTROL AREA GRAPH report for the control area’s that were analyzed should be printed. Optionally, the control areas that will be graphed can be limited to those control areas that are: full; notfull; empty(free); have caused or were used for a control area split; have or may have unusable (lost) control intervals because of poor key compression or insufficient index control interval size; have a specified percentage of freespace available. If no LIMITING PARAMETERS are specified, then all control areas previously saved will be graphed.

YES | NO | OVERLAY Indicates whether the control area graph should be reprinted. If “YES” or “OVERLAY” is specified, the control area graph will be reprinted, and the “CAGRAPH” DD statement is required. “OVERLAY” will cause the control interval and byte graph lines to overlay each other and decrease the number of lines in the graph by 50%.

LINECNT(number) Indicates how many lines to be printed on a page. The minimum value is 16 and the maximum is 999.

LIMITING PARAMETERS FULL

Indicates that, of the control areas saved, those that are full are to be reprinted. A control area is considered to be full when there are no free records.


169

NOTFULL Indicates that, of the control areas saved, those that are not full are to be reprinted. A control area is not full when there are one or more free records.

EMPTY Indicates that, of the control areas saved, those that are empty are to be reprinted.

SPLIT Indicates that, of the control areas saved, those that have split or were used for a split will be reprinted. The original run could not have specified this parameter with the CASAMPLE parameter.

LOSTCI Indicates that, of the control areas saved, those that do have or could have lost or unusable control intervals because of poor key compression or an insufficient index control interval size will be reprinted.

FREESPACE (pct | 0 < :cond | GE >) Indicates that, of the control areas saved, those that have the specified percentage of freespace available will be reprinted.

ABBREVIATIONS: FSPC

DEFAULTS: NO,LINECNT(55)

ABBREVIATIONS: CAG

CAREPORT (YES | NO FULL NOTFULL EMPTY SPLIT LOSTCI FREESPACE (pct | 0 < :cond | GE >) LINECNT(number | 55 ) ) This parameter specifies whether the CONTROL AREA REPORT should be reprinted for the control area’s that are saved, from the statistics on the dataset specified in the CASTATS parameter. Optionally, the control areas that will be reprinted can be limited to those control areas that are; full; notfull; empty(free); have caused or were used for a control area split; have or may have unusable(lost) control intervals because of poor key compression or insufficient index control interval size; have a specified percentage of freespace available. If no LIMITING PARAMETERS are specified, then all control areas saved will be reprinted.

YES | NO Indicates whether to reprint the control area report. If “YES” is specified, the control area report will be reprinted and the “CAREPORT” DD statement is required.


170

Refer to the CAGRAPH parameter on page 168 for an explanation of the FULL, NOTFULL, EMPTY, SPLIT, LOSTCI, FREESPACE, and LINECNT subparameters.

ABBREVIATIONS: CAR

CASTART (number | qstring) This parameter specifies which control area to begin reprinting with. If a number is specified, the reprint will start with that control area. If a quoted string is specified, the reprint will start with the control area that contains a key greater than or equal to the quoted string. This parameter will cause a partial reprint to be performed.


qstring: A full or partial key value in quotes. The key value can be specified in character 'character' or hexadecimal x'hexadecimal' format and cannot exceed 255 characters or 510 hexadecimal characters in length. If there are quotes (') in the key, then a double quote ('') can be specified for each occurrence of a quote.

DEFAULTS: (null) Beginning of the collected statistics.

MUTUALLY EXCLUSIVE parameters: CAVOLUME

ABBREVIATIONS: CASTRT

CASTATDD (ddname | CASTATS /readpw) This parameter specifies the name of the DD statement for the dataset that used to save the CONTROL AREA GRAPH, CONTROL AREA REPORT, and CONTROL INTERVAL REPORT statistics. If the statistical file is a VSAM ESDS and is read password protected, the read password should be specified if the MVS operator should not be prompted for the dataset password.

DEFAULTS: CASTATS

ABBREVIATIONS: CASTDD, CADD

CAVOLUME (volser) This parameter specifies a single volume in a multi-volume dataset that will be reprinted. If this parameter is specified a partial dataset reprint will be performed.

DEFAULTS: (null)

MUTUALLY EXCLUSIVE parameters: CACOUNT CAEND CASTART

ABBREVIATIONS: CAVOL


171

CIREPORT (YES | NO LINECNT(number | 55 ) FROMCA(number | 1 COUNT(number | 1 )) This parameter specifies whether to reprint the CONTROL INTERVAL REPORT for selected control areas. This report can produce a large volume of output and should be limited to those control areas which need to be analyzed at the control interval level. This report can be especially useful in analyzing the effect of current control interval freespace if printed for one control area after records are inserted into the dataset.

YES | NO Indicates whether to reprint the control interval report. If “YES” is specified, the control interval report will be reprinted and the “CIREPORT” DD statement is required.

LINECNT(number) Indicates how many lines to be printed on a page . The minimum allowed is 16 and the maximum is 999.

FROMCA Indicates what control area number to begin reprinting the control interval statistics on. If the control area number specified does not exist or was not saved because of the CASTART, CAEND, CACOUNT, CASAMPLE, or CAVOLUME parameters on the original run, then there will be no control interval report printed. The number can range from 0 to 999999999.

COUNT Indicates for how many control areas the control interval report will be reprinted for. It will reprint for this number or until end of dataset or CAEND, CACOUNT, CAVOLUME. The number specified can be from 0 to 9999999.

DEFAULTS: NO,LINECNT(55),FROMCA(1),COUNT(1)

ABBREVIATIONS: CIR

DSREPORT (YES | NO) This parameter specifies whether to reprint the DATASET REPORT from the dataset statistics on the dataset specified in the DSSTATDD parameter. The default is “YES” and will cause a single page dataset report to be printed for the dataset specified in the REPRINT function.

YES | NO Indicates whether to reprint the dataset report.

ABBREVIATIONS: DSR


172

DSSTATDD (ddname | DSSTATS /readpw) This parameter specifies the DD statement name for the dataset that contains the statistics and will be used to reprint the DATASET REPORT. If the statistical file is a VSAM ESDS and is read password protected the read password should be specified if the MVS operator should not be prompted for the dataset password.

DEFAULTS: DSSTATS


FROM (mmddyyyy | mm/dd/yyyy | yyyyddd) This parameter specifies the date to be used as a search argument against the statistical files to start reprinting the requested reports. It may be specified in either Julian or Gregorian format.

DEFAULTS: (null)

KRREPORT (DSLO DSHI CALO CAHI CIHI CILO LINECNT(number | 55 )) This parameter specifies whether the KEYRANGE REPORT should be reprinted, and also which high or low keyranges should be reprinted. When a partial dataset analysis is performed because of the CACOUNT, CAEND, CASTART, CASAMPLE, or CAVOLUME, the highest and lowest keys for the dataset will be the highest and lowest within the control areas saved.

DSHI Indicates that the highest key in the dataset should be reprinted.

DSLO Indicates that the lowest key in the dataset should be reprinted.

CAHI Indicates that the highest key in each control area analyzed should be reprinted.

CALO Indicates that the lowest key in each control area analyzed should be reprinted.

CIHI Indicates that the highest key in each control interval of each control area analyzed should be reprinted.

CILO Indicates that the lowest key in each control interval of each control area analyzed should be reprinted.


173


DEFAULTS: LINECNT(55)

ABBREVIATIONS: KRR

NAME (dsname/cntrlpw) This parameter specifies the fully qualified name of the VSAM dataset to be reprinted.

DEFAULTS: (null)

TO (mmddyyyy | mm/dd/yyyy | yyyyddd) This parameter specifies the date to be used as a search argument against the DSSTATS statistical files to stop reprinting the specified DSREPORT(s). It may be specified in either Julian or Gregorian format.

DEFAULTS: (null)

RECOMMENDATIONS (.....) This parameter defines the types of recommendations that VSUM should make about the dataset being reprinted. Refer to chapter 0, “Dataset Recommendations,” for a detailed description of the RECOMMENDATIONS parameter and subparameters available.


174

Examples of Use

This example will cause the statistics for VSAM.KSDS to be reprinted producing a single page dataset report.

//JOBNAME JOB ... //STEPNAME EXEC PGM=VSUM,REGION=1000K //STEPLIB DD DSN=STAR.VSUM.LOADLIB,DISP=SHR //SYSPRINT DD SYSOUT=A //DSSTATS DD DSN=VSUM.DSSTATS.FILE,DISP=SHR //SYSIN DD * REPRINT NAME(VSAM.KSDS) DSSTATDD(DSSTATS) /*

This example will cause dataset VSAM.KSDS to have the dataset report reprinted and its control area space utilization graph to be reprinted.

//JOBNAME JOB ... //STEPNAME EXEC PGM=VSUM,REGION=1000K //STEPLIB DD DSN=STAR.VSUM.LOADLIB,DISP=SHR //SYSPRINT DD SYSOUT=A //DSSTATS DD DSN=VSUM.DSSTATS.FILE,DISP=SHR //CASTATS DD DSN=VSUM.CASTATS.FILE,DISP=SHR //CAGRAPH DD SYSOUT=A //SYSIN DD * REPRINT NAME(VSAM.KSDS) CAGRAPH(YES) - DSSTATDD(DSSTATS) CASTATDD(CASTATS) /*

This example will cause the control areas on the specified volume to be reprinted for the dataset VSAM.KSDS. A dataset report will also be reprinted.

//JOBNAME JOB ... //STEPNAME EXEC PGM=VSUM,REGION=1000K //STEPLIB DD DSN=STAR.VSUM.LOADLIB,DISP=SHR //SYSPRINT DD SYSOUT=A //DSSTATS DD DSN=VSUM.DSSTATS.FILE,DISP=SHR //CASTATS DD DSN=VSUM.CASTATS.FILE,DISP=SHR //SYSIN DD * REPRINT NAME(VSAM.KSDS) VOLUME(VOL002) - DSSTATDD(DSSTATS) CASTATDD(CASTATS) - CAREPORT(YES)} /*

Reprint a KSDS Dataset Report

Reprint DSREPORT and Control Area Graph for a KSDS

Reprint DSREPORT and CAREPORT for Single Volume of a KSDS


175

This example will cause dataset VSAM.KSDS to have a dataset and a recommendations report reprinted, with recommendations for attributes, buffers, and reorganization.

//JOBNAME JOB ... //STEPNAME EXEC PGM=VSUM,REGION=1000K //STEPLIB DD DSN=STAR.VSUM.LOADLIB,DISP=SHR //DSSTATS DD DSN=VSUM.DSSTATS.FILE,DISP=SHR //SYSPRINT DD SYSOUT=A //SYSIN DD * REPRINT NAME(VSAM.KSDS) RECOMMENDATIONS(ATTRIBUTES - BUFFERS REORGANIZATION) DSSTATDD(DSSTATS) /*

This example will cause the first control area of dataset VSAM.AIX to be reprinted and a control interval report to be reprinted for its control areas.

//JOBNAME JOB ... //STEPNAME EXEC PGM=VSUM,REGION=1000K //STEPLIB DD DSN=STAR.VSUM.LOADLIB,DISP=SHR //SYSPRINT DD SYSOUT=A //CASTATS DD DSN=VSUM.CASTATS.FILE,DISP=SHR //CIREPORT DD SYSOUT=A //SYSIN DD * REPRINT NAME(VSAM.AIX) DSREPORT(NO) CACOUNT(1) - CIREPORT(YES,FROMCA(1),COUNT(1)) CASTATDD(CASTATS) /*

This example will cause the statistics for VSAM.KSDS to be reprinted, producing a single-page dataset report for every time the statistics were saved for the dataset.

//JOBNAME JOB ... //STEPNAME EXEC PGM=VSUM,REGION=1000K //STEPLIB DD DSN=STAR.VSUM.LOADLIB,DISP=SHR //SYSPRINT DD SYSOUT=A //DSSTATS DD DSN=VSUM.DSSTATS.FILE,DISP=SHR //SYSIN DD * REPRINT NAME(VSAM.KSDS) DSSTATDD(DSSTATS) - FROM(1/1/2017) TO(2/1/2017) /*

Reprint DSREPORT and Make Recommendations

Reprint a KSDS and Make Recommendations

Reprint a KSDS Dataset Reports for 1/1/2017 to 2/1/2017


176


All the reports produced by the REPRINT function are the same reports produced by the ANALYZE and RECOMMENDATIONS functions. Refer to chapter 0, “Dataset Analyze/Backup,” and chapter 0, “Dataset Recommendations,” for detailed descriptions of the reports and the report fields produced.

177

7 Messages and Codes

CONDITION CODES 4 Indicates that a syntax error occurred while processing a

command.

8 Indicates that during an ANALYZE BKUPDD backup function an out of sequence or duplicate key condition was encountered.

12 Indicates that during a command function a severe error occurred, and processing was terminated.

ABEND CODES U012 This user abend will occur when a severe VSUM, operating

system, or VSAM catalog error has occurred, and the “PARM ABEND” command was specified. Refer to the section “PARM Command” (page 8).

VSUM-MSG SYSIN CONTROL STATEMENTS: ACTION: PROCESSING CONTINUES. MODULE: VSUM EXPLANATION: This message is displayed preceding the display of the SYSIN statements read.

VSUM-MSG SPECIFIED PARAMETERS ACCEPTED. ACTION: PROCESSING CONTINUES. MODULE: VSUMANAL EXPLANATION: This message is displayed preceding the display of the SYSIN statements read, specifying the user specified settings for the “ABEND” or “NOABEND” option. Refer to the section “PARM Command” (page 8) for more information about the ABEND and NOABEND options.

VSUM for z/OS Program Description and Operations Guide Messages and Codes

178

VSUM-MSG EXEC PARM (SYSIN OVERRIDE): ACTION: PROCESSING CONTINUES. MODULE: VSUM EXPLANATION: This message is displayed preceding the display of the parameters read off the JCL EXEC card.

VSUM-MSG XXXXXXXX PROCESSING COMPLETED. CONDITION CODE=AAAA (ABEND) ACTION: PROCESSING TERMINATED, WITH ABEND IF ABEND SPECIFIED. MODULE: VSUM EXPLANATION: This message is displayed after the completion of a VSUM function. ‘XXXXXXX’ will be the process completed, and the condition code will be displayed with ‘AAAA’. If an abend occurred ‘ABEND’ will be displayed, and the abend should then be reported to CSI International.

VSUM-MSG SYNTAX SCAN COMPLETED SUCCESSFULLY. ACTION: PROCESSING TERMINATED. MODULE: VSUM EXPLANATION: This message will display after a ‘scan’ of the VSUM control statements has been completed.

VSUM-MSG SYNTAX SCANNING TURNED OFF. ACTION: PROCESSING TERMINATED. MODULE: VSUM EXPLANATION: This message will display after a ‘scan’ of the VSUM control statements has been completed, and another function has been started.

VSUM-MSG PARAMETER DEFAULTS TAKEN: OPTIONS: DSREPORT=(YES,NOSAVE) CAREPORT=(NO,NOSAVE) CAGRAPH=(NO,NOSAVE) KRREPORT=NO CIREPORT=(,,NOSAVE) RUNTYPE=NEW FREERCSZ=DEFAVG ACTION: PROCESSING CONTINUES. MODULE: VSUMANAL EXPLANATION: This message will display if any default parameters are taken during the current function of VSUM. All the defaults possible are shown.


179

VSUM-WARNNG XXXXXXXX DATASET RAN OUT OF SPACE AND PROCESSING CONTINUED. ACTION: PROCESSING CONTINUES. MODULES: VSUM, VSUMANAL EXPLANATION: This message is displayed when one of the VSUM statistical datasets (shown by DD statement as ‘XXXXXXXXX’) has run out of space for storing the statistical records. The rest of the VSUM analysis continues.

VSUM-WARNNG CI SPLIT (BUSY BIT) IN PROGRESS, CI RBA=AAAAAA, DSN=XXXXXXXXXXXXXX. ACTION: PROCESSING CONTINUES. MODULES: VSUMANAL EXPLANATION: This message is displayed when a control interval is found to have a busy bit on. The rest of the VSUM analysis continues.

VSUM-WARNNG CASTART KEY SEQUENTIALLY GREATER THAN CAEND. ONE CA WILL BE PROCESSED, DSN=NNNNNNNNNN... ACTION: PROCESSING CONTINUES. MODULE: VSUMANAL EXPLANATION: This message is displayed when the CASTART and CAEND parameters have been specified, but the key associated with the CA number in the CASTART is higher than the key associated with the CA number in the CAEND parameter. Because this is illogical, only 1 CA will be processed. NNNNNNNN... is the dsname of the dataset being processed.

VSUM-ERRA01 VSUM SUWA STORAGE IS INVALID. LOGIC ERROR. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMAUTO EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRB00 LOGIC ERROR, CLOSE CANNOT PRECEDE OPEN IN MODULE=VSUMBKUP. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMBKUP EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.


180

VSUM-ERRB01 RDJFCB MACRO FAILURE IN VSUMBKUP MODULE FOR DDN=XXXXXXXX. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMBKUP EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRB03 RRDS BACKUP FILE REQUIRES FIXED LENGTH RECORDS FOR INPUT. ACTION: PROCESSING TERMINATED. MODULE: VSUMBKUP EXPLANATION: This message occurs when a VSAM RRDS file has been specified as the backup file, but the input file is not fixed-length records. An alternative file to backup should be chosen, then the backup tried again.

VSUM-ERRB04 NO DD PRESENT FOR BACKUP FILE, DDN=XXXXXXXX. ACTION: PROCESSING TERMINATED. MODULE: VSUMBKUP EXPLANATION: The BKUPDD parameter was specified, but no DD statement was present for the name given. Check the spelling of the DDname, or give another DDname, and then try the backup again.

VSUM-ERRB06 MAXIMUM VSAM RECORD LENGTH GREATER THAN 32752. ACTION: PROCESSING TERMINATED. MODULE: VSUMBKUP EXPLANATION: The specified record length of the VSAM input file to be backed up exceeds the maximum of 32752. VSUM cannot backup files above this size.

VSUM-ERRB07 OPEN ERROR ON QSAM BACKUP FILE, DDN=XXXXXXXX. ACTION: PROCESSING TERMINATED. MODULE: VSUMBKUP EXPLANATION: An error occurred when VSUM tried to open sequential backup file specified in the BKUPDD parameter. Check the file’s attributes ensure that it is variable blocked, then try the backup again.


181

VSUM-ERRB08 OPEN ERROR ON QSAM BACKUP ERROR FILE DDN=XXXXXXXX. ACTION: PROCESSING TERMINATED. MODULE: VSUMBKUP EXPLANATION: An error occurred when VSUM tried to open the backup error file specified in the BKERDD parameter. Check the file’s attributes and ensure that it is variable blocked, then try the backup again.

VSUM-ERRB09 QSAM BACKUP FILE MUST BE VARIABLE BLOCKED, DDN=XXXXXXXX. ACTION: PROCESSING TERMINATED. MODULE: VSUMBKUP EXPLANATION: The backup file specified in the BKUPDD parameter is not variable blocked. Re-specify the file’s attributes and ensure that it is variable blocked, then try the backup again.

VSUM-ERRB0A QSAM BACKUP ERROR FILE MUST BE VARIABLE BLOCKED, DDN=XXXXXXXX. ACTION: PROCESSING TERMINATED. MODULE: VSUMBKUP EXPLANATION: The backup file specified in the BKERDD parameter is not variable blocked. Re-specify the file’s attributes and ensure that it is variable blocked, then try the backup again.

VSUM-ERRB0B BACKUP DDN=XXXXXXXX LRECL=‘AAAAA’ IS LESS THAN INPUT FILE LRECL=‘BBBBB’. ACTION: PROCESSING TERMINATED. MODULE: VSUMBKUP EXPLANATION: The backup file specified in the BKUPDD parameter has a record length of ‘AAAAA’, which is smaller than the input record length of ‘BBBBB’, so a successful backup is impossible. A backup file with a larger record length should be specified, then the backup should be tried again.

VSUM-ERRB0C ERROR DDN=XXXXXXXX LRECL=‘AAAAA’ LESS THAN THE INPUT FILE LRECL=‘BBBBB’. ACTION: PROCESSING TERMINATED. MODULE: VSUMBKUP EXPLANATION: The backup error file specified in the BKERDD parameter has a record length of ‘AAAAA’, which is smaller than the input record length of ‘BBBBB’. If an error occurs on the backup, no error file processing would be possible. A backup error file with a larger record length should be specified, then the backup should be tried again.


182

VSUM-ERRB0D BACKUP RRDS DDN=XXXXXXXX LRECL=‘AAAAA’ IS NOT EQUAL TO THE FILE LRECL=‘BBBBB’. ACTION: PROCESSING TERMINATED. MODULE: VSUMBKUP EXPLANATION: The backup error file specified in the BKUPDD parameter is a VSAM RRDS file has a record length of ‘AAAAA’, which is not equal to the input VSAM RRDS file record length of ‘BBBBB’. Successful processing is not possible. Another backup file should be specified, then the backup should be tried again.

VSUM-ERRB0E ERROR RRDS LRECL=‘AAAAA’ IS NOT EQUAL TO THE FILE LRECL=‘BBBBB’. ACTION: PROCESSING TERMINATED. MODULE: VSUMBKUP EXPLANATION: The file specified in the BKERDD parameter is a VSAM RRDS file has a record length of ‘AAAAA’, which is not equal to the input VSAM RRDS file record length of ‘BBBBB’. Successful processing is not possible. Another backup error file should be specified, then the backup should be tried again.

VSUM-ERRB0F VSAM CATALOG BACKUP IS NOT SUPPORTED. ACTION: PROCESSING TERMINATED. MODULE: VSUMBKUP EXPLANATION: This message is issued when a VSAM catalog is being analyzed and the backup option has been selected. The backup option is not supported for VSUM catalogs. Re-execute the ANALYZE command without the backup option specified.

VSUM-ERRC01 LOGIC ERROR, DATA CISIZE CALCULATION FAILURE. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMRCRP EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRC02 DATASET SIZE AFTER GROWTH FACTOR EXCEEDS MAXIMUM XXXXXX RBA ADDRESSABILITY. ACTION: PROCESSING TERMINATED. MODULE: VSUMRCRP EXPLANATION: This message occurs when the SPACE subparameter of RECOMMENDATIONS has been specified with a growth percentage, but the space needed cannot be addressed on the current device type (i.e. the dataset is too large). Specify a lower growth percentage, or possibly a different device type and run VSUM again.


183

VSUM-ERRC03 CURRENT DATA CISIZE CALCULATION FAILURE. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMRCRP EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRC04 RECORDS RECOMMENDATIONS IMPOSSIBLE. ACTION: PROCESSING CONTINUES. MODULE: VSUMRCRP EXPLANATION: Recommendations were requested for a dataset that is empty!

VSUM-ERRD01 DYNAMIC ALLOCATION FAILURE R15=AA, ERRCODE=BB, INFOCODE=CCC. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMDYN EXPLANATION: Dynamic allocation failed, the return codes from Job Management are displayed: register 15=AA, error code=BB, and information code=CCC. These return, error, and information code descriptions can be found in the IBM Job Management manual.

VSUM-ERRD01 DYNAMIC DEALLOCATION FAILURE R15=AA, ERRCODE=BB, INFOCODE=CCC. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMDYN EXPLANATION: Dynamic deallocation failed, the returns from Job Management are displayed; register 15=AA, the error code=BB, and the information code=CCC. These return codes and meanings are described in IBM’s Job Management manual.

VSUM-ERRD03 INVALID REQUEST TO VSUMDYN MODULE. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMDYN EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRD04 DSNAME NOT FOUND, NAME=‘XXXXXXXXXXXXXXXXXXXXX’. ACTION: PROCESSING TERMINATED. MODULE: VSUMDYN EXPLANATION: The dataset name shown, ‘XXXXXXXXXX’ could not be located. Check the spelling of the dsname, and the catalogs specified for execution, then try the function again.


184

VSUM-ERRI01 FUNCTION ‘XXXXXXXXXXXXXXX’ LONGER THAN 16. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The function, specified in ‘XXXXXXXX’, is invalid, and longer than 16 characters. Correct the parameter and try the function again.

VSUM-ERRI02 GROUP/KEYWORD ‘XXXXXXXXXXXXXXXX’ LONGER THAN 16. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The group/keyword, specified in ‘XXXXXXXX’, is invalid, and longer than 16 characters. Correct the parameter and try the function again.

VSUM-ERRI03 FUNCTION ‘AAAAAAAA’ KEYWORD ‘BBBBBBBB’ SUBPARM(‘CCC’)=‘XXXXXXXXXXXXXXXX’ TOO LONG. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The sub-parameter ‘XXXXXXXXXXXXXXXX’, sequentially number ‘CCC’ of the function ‘AAAAAAAA’ and the keyword ‘BBBBBBBB’, is invalid, and longer than 16 characters. Correct the parameter and try the function again.

VSUM-ERRI04 FUNCTION ‘AAAAAAAA’ KEYWORD ‘BBBBBBBB’ SUBPARM(‘CCC’)=‘XXXXXXXXXXXXXXXX’ HAS AN INVALID STRING. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The sub-parameter ‘XXXXXXXXXXXXXXXX’, sequentially number ‘CCC’ of the function ‘AAAAAAAA’ and the keyword ‘BBBBBBBB’, is invalid. Correct the parameter and try the function again.

VSUM-ERRI05 UNMATCHED PARENTHESIS IN INPUT. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The input parameters contain an unmatched set of parentheses. Correct the parameter and try the function again.


185

VSUM-ERRI06 OPEN PARENTHESIS NOT FOUND AFTER GROUP ‘XXXXXXXX’. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The XXXXXXXX parameter is a group parameter and requires that the subparameters be enclosed in parenthesis. Correct the parameter and try the function again.

VSUM-ERRI07 OPEN PARENTHESIS NOT EXPECTED AFTER FUNCTION ‘XXXXXXXX’. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: Open parenthesis is invalid after the function ‘XXXXXXXX’. Correct the parameter and try the function again.

VSUM-ERRI08 OPEN PARENTHESIS OUT OF ORDER. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: Parentheses were not expected in the order that they were found. Correct the parameters and try the function again.

VSUM-ERRI09 INVALID EQUAL SIGN IN INPUT. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: An equal sign should not have been input in the parameter. Correct the parameter and try the function again.

VSUM-ERRI10 DUPLICATE KEYWORD ‘XXXXXXXX’. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The keyword ‘XXXXXXXX’ was previously specified. Eliminate the duplicate and try the function again.

VSUM-ERRI11 LOGIC ERROR-INVALID MACRO ID. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMIN00 EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.


186

VSUM-ERRI12 DUPLICATE GROUP ‘XXXXXXXX’. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMIN00 EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRI13 LOGIC ERROR-INFORM NOT FOUND/INVALID. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMIN00 EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRI14 LOGIC ERROR-INLEN NOT FOUND. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMIN00 EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRI15 LOGIC ERROR-INVALID SCON. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMIN00 EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRI16 LOGIC ERROR-INMASK ERROR. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMIN00 EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRI17 LOGIC ERROR-OUTMASK ERROR. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMIN00 EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.


187

VSUM-ERRI18 LOGIC ERROR-OUTFLD FORMAT ERROR. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMIN00 EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRI19 LOGIC ERROR-REQUIRED GROUP/KEYWORD MACRO ERROR. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMIN00 EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRI20 LOGIC ERROR-MUTUALLY EXCL GROUP/KEYWORD MACRO ERROR. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMIN00 EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRI21 PREMATURE END OF KEYWORD ‘XXXXXXXX’. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The keyword ‘XXXXXXXX’ had more required subparameters that were not specified. Correct the keyword and try the function again.

VSUM-ERRI22 ‘XXXXXXXX’ KEYWORD HAS AN INVALID EQUAL SIGN. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The keyword ‘XXXXXXXX’ has an equal sign that should not have been input in the parameter. Correct the keyword and try the function again.

VSUM-ERRI23 ‘XXXXXXXX’ KEYWORD HAS AN INVALID OPEN PARENTHESIS. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The keyword ‘XXXXXXXX’ has an open parenthesis that is out of place of not required. Correct the keyword and try the function again.


188

VSUM-ERRI24 LOGIC ERROR-IN INPUT PARAMETER PROCESSING. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMIN00 EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRI26 ‘XXXXXXXX’ IS AN UNDEFINED KEYWORD FOR ‘AAAAAAAA’ FUNCTION. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The keyword ‘XXXXXXXX’ is not defined for the function ‘AAAAAAAA’. Correct the keyword and try the function again.

VSUM-ERRI27 KEYWORD ‘AAAAAAAA’ SUBPARM(‘BBB’) HAS AN INVALID CONDITIONAL OPERATOR. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The sub-parameter number ‘bbb’ of keyword ‘AAAAAAAA’ has a conditional operator that is not valid. Valid conditional operators are: EQ, NE, GT, LT, GE, or LE. Correct the keyword and try the function again.

VSUM-ERRI28 KEYWORD ‘AAAAAAAA’ IS UNDEFINED FOR ‘BBBBBBBB’ GROUP OF ‘CCCCCCCC’ FUNCTION. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The keyword ‘AAAAAAAA’ is not valid for the group parameter ‘BBBBBBBB’ and the function ‘CCCCCCCC’. Correct the keyword and try the function again.

VSUM-ERRI29 KEYWORD ‘AAAAAAAA’ CONTAINS TOO MANY SUBPARAMETERS. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The keyword ‘AAAAAAAA’ has too many subparameters specified for it. Correct the keyword and try the function again.


189

VSUM-ERRI30 KEYWORD ‘AAAAAAAA’ INVALID DSNAME ‘BBBBBBBBBBBBBB’. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The keyword ‘AAAAAAAA’ has an invalid dataset name specified for it, shown in ‘BBBBBBBBBBBBBB’. Correct the dataset name keyword and try the function again.

VSUM-ERRI31 KEYWORD ‘AAAAAAAA’ INVALID DDNAME ‘BBBBBBBBB’. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The keyword ‘AAAAAAAA’ has an invalid DDNAME name specified for it, shown in ‘BBBBBBBB’. Correct the DDNAME keyword and try the function again.

VSUM-ERRI32 KEYWORD ‘AAAAAAAA’ INVALID PASSWORD ‘BBBBBBBB’. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The keyword ‘AAAAAAAA’ has an invalid password specified for it, shown in ‘BBBBBBBB’. Correct the password parameter and try the function again.

VSUM-ERRI33 KEYWORD ‘AAAAAAAA’ SUBPARM(‘BBB’)=‘CCCCCCCC’ LESS THAN MINIMUM LENGTH/VALUE. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The subparameter ‘CCCCCCCC’, sequence ‘BBB’, is invalid for keyword ‘AAAAAAAA’. It is invalid because it is less than the minimum value allowed. Correct the parameter and try the function again.

VSUM-ERRI34 KEYWORD ‘AAAAAAAA’ SUBPARM(‘BBB’)=‘CCCCCCCC’ GREATER THAN MAXIMUM LENGTH/VALUE. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The subparameter ‘CCCCCCCC’, sequence ‘BBB’, is invalid for keyword ‘AAAAAAAA’. It is invalid because it is greater than the maximum value allowed. Correct the parameter and try the function again.


190

VSUM-ERRI35 KEYWORD ‘AAAAAAAA’ SUBPARM(‘BBB’)=‘CCCCCCCC’ IS NOT NUMERIC. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The subparameter ‘CCCCCCCC’, sequence ‘BBB’, is invalid for keyword ‘AAAAAAAA’ because it is not numeric. Correct the parameter and try the function again.

VSUM-ERRI37 LOGIC ERROR-INPUT LONGER THAN OUTFLD. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMIN00 EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRI38 LOGIC ERROR-BINARY OUTFLD LONGER THAN 4 BYTES. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMIN00 EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRI39 LOGIC ERROR-PACKED DECIMAL OUTFLD LONGER THAN 15 BYTES. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMIN00 EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRI40 VOLUME ‘AAAAAA’ LONGER THAN 6 CHARACTERS. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The volume serial number specified as ‘AAAAAA’ is longer than 6 characters, so it is invalid. Correct the parameter and try the function again.


191

VSUM-ERRI41 INPUT FORMAT NOT CURRENTLY SUPPORTED. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The input format encountered was unrecognizable by VSUM. Correct the format to conform with the parameters described in this manual and try the function again.

VSUM-ERRI42 KEYWORD ‘AAAAAAAA’ SUBPARM(‘BBB’)=‘CCCCCCCC’ IS INVALID. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The subparameter ‘CCCCCCCC’, sequence ‘BBB’, is invalid for keyword ‘AAAAAAAA’. Correct the parameter and try the function again.

VSUM-ERRI43 KEYWORD ‘AAAAAAAA’ SUBPARM(‘BBB’)=‘CCCCCCCC’ IS AN INVALID PARTIAL DSNAME. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The partial dsname specified in subparameter ‘CCCCCCCC’, sequence ‘BBB’, keyword ‘AAAAAAAA’ is invalid as input. Correct this parameter and try the function again.

VSUM-ERRI44 MODULE NAME ‘XXXXXXXX’ IS LONGER THAN 8 BYTES. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The module name specified in ‘XXXXXXXX’ is invalid as input. Correct this parameter and try the function again.

VSUM-ERRI45 KEYWORD ‘AAAAAAAA’ SUBPARM(‘BBB’)=‘CCCCCCCC’ DATE FORMATE ERROR. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The date specified in subparameter ‘CCCCCCCC’, sequence ‘BBB’, keyword ‘AAAAAAAA’ is invalid as input. Correct this parameter and try the function again.

VSUM-ERRI46 KEYWORD ‘AAAAAAAA’ IS REQUIRED. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The keyword ‘AAAAAAAA’ is a required parameter. Enter this keyword and try the function again.


192

VSUM-ERRI47 GROUP ‘AAAAAAAA’ IS REQUIRED. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The group ‘AAAAAAAA’ is required for this function. Enter this group and try the function again.

VSUM-ERRI48 KEYWORD ‘AAAAAAAA’ AND GROUP ‘BBBBBBBB’ ARE MUTUALLY EXCLUSIVE. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The keyword ‘AAAAAAAA’ and the group ‘BBBBBBBB’ are mutually exclusive for this function. Enter only one and try the function again.

VSUM-ERRI48 KEYWORD ‘AAAAAAAA’ AND KEYWORD ‘BBBBBBBB’ ARE MUTUALLY EXCLUSIVE. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The keyword ‘AAAAAAAA’ and the keyword ‘BBBBBBBB’ are mutually exclusive for this function. Enter only one and try the function again.

VSUM-ERRI48 GROUP ‘AAAAAAAA’ AND KEYWORD ‘BBBBBBBB’ ARE MUTUALLY EXCLUSIVE. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The group ‘AAAAAAAA’ and the keyword ‘BBBBBBBB’ are mutually exclusive for this function. Enter only one and try the function again.

VSUM-ERRI48 GROUP ‘AAAAAAAA’ AND GROUP ‘BBBBBBBB’ ARE MUTUALLY EXCLUSIVE. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The group ‘AAAAAAAA’ and the group ‘BBBBBBBB’ are mutually exclusive for this function. Enter only one and try the function again.

VSUM-ERRI49 SYSIN CONTAINS ALL BLANK DATA. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: There were no valid parameters entered in SYSIN, only blanks, so no processing was needed.


193

VSUM-ERRI50 ‘XXXXXXXX’ IS NOT A VALID FUNCTION. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: What was specified, ‘AAAAAAAA’, is an invalid or unrecognizable function. Correct this parameter with a valid function and try the function again.

VSUM-ERRI51 ‘AAAAAAAA’ IS INVALID FOR ‘BBBBBBBB’ FUNCTION. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: What was specified, ‘AAAAAAAA’, is an invalid keyword or group parameter for the ‘BBBBBBBB’ function. Correct the parameter and try the function again.

VSUM-ERRI52 LOGIC ERROR-SUBLIST STRING GT 31 BYTES. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMIN00 EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRI53 LOGIC ERROR-PASSWORD OUTPUT FIELD LESS THAN 8 BYTES. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMIN00 EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRI54 OPEN PARENTHESIS IS NOT VALID AS FIRST CHARACTER OF A COMMAND. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: A parenthesis was found as the first character of a command, which is not valid. Correct this, then try the function again.

VSUM-ERRI55 INVALID OPEN PARENTHESIS WITHIN KEYWORD ‘XXXXXXXX’. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: A parenthesis was found for the keyword ‘XXXXXXXX’, but is invalid in this position. Correct this, then try the function again.


194

VSUM-ERRI56 KEYWORD ‘AAAAAAAA’ AND GROUP ‘BBBBBBBB’ ARE MUTUALLY REQUIRED. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: Both the keyword ‘AAAAAAAA’ and the group ‘BBBBBBBB’ are required for this function when either is specified. Enter the missing one and try the function again.

VSUM-ERRI56 KEYWORD ‘AAAAAAAA’ AND KEYWORD ‘BBBBBBBB’ ARE MUTUALLY REQUIRED. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: Both the keyword ‘AAAAAAAA’ and the keyword ‘BBBBBBBB’ are required when either is specified. Enter the missing one and try the function again.

VSUM-ERRI56 GROUP ‘AAAAAAAA’ AND KEYWORD ‘BBBBBBBB’ ARE MUTUALLY REQUIRED. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: Both the group ‘AAAAAAAA’ and the keyword ‘BBBBBBBB’ are required when either is specified. Enter the missing one and try the function again.

VSUM-ERRI57 LOGIC ERROR-MUTUALLY REQD GROUP/KEYWORD MACRO ERROR. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMIN00 EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRI58 KEYWORD ‘AAAAAAAA’ SUBPARM(‘BBB’)=‘CCCCCCCC’ IS AN INVALID DATA CISIZE. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The control interval size specified for the data component in subparameter ‘CCCCCCCC’, sequence ‘BBB’ of keyword ‘AAAAAAAA’ is invalid. Correct this parameter and try the function again.


195

VSUM-ERRI59 KEYWORD ‘AAAAAAAA’ SUBPARM(‘BBB’)=‘CCCCCCCC’ IS AN INVALID INDEX CISIZE. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The control interval size specified for the index component in subparameter ‘CCCCCCCC’, sequence ‘BBB’ of keyword ‘AAAAAAAA’ is invalid. Correct this parameter and try the function again.

VSUM-ERRI59 KEYWORD ‘AAAAAAAA’ SUBPARM(‘BBB’)=‘CCCCCCCC’ IS AN INVALID VSAM BLOCKSIZE. ACTION: PROCESSING TERMINATED. MODULE: VSUMIN00 EXPLANATION: The blocksize specified in subparameter ‘CCCCCCCC’, sequence ‘BBB’ of keyword ‘AAAAAAAA’ is invalid. Correct this parameter and try the function again.

VSUM-ERRI60 LOGIC ERROR-MINIMUM VALUE GT THAN MAXIMUM VALUE ‘AAA’ KEYWORD ‘BBBBBBBB’ SUBPARM(‘CCC’)=‘DDDDDDDD’. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMIN00 EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRL01 CATALOG LOCATE ERROR=‘XXX’, PROCESSING TERMINATED. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMLCAT EXPLANATION: This message denotes VSAM catalog locate error has occurred (SVC26). Refer to IBM’s OS/VS2 CATALOG MANAGEMENT LOGIC manual and/or IBM message description IDC3009I for a description of any return codes not listed below.

RETURN CODE 40, 44 Too many associations to list. Use IDCAMS LISTCAT.

48 Catalog specified or defaulted is a non-VSAM catalog.

50 VVDS error. Make sure the DASD volume for the entry being listed is available to the CPU which is executing VSUM.


196

56 Authorization failure, dataset password is missing or specified incorrectly.

72 A required volume is not mounted.

VSUM-ERRL02 BUFPRINT DDNAME NOT PRESENT FOR BUFFERTABLE PROCESSING. ACTION: PROCESSING TERMINATED. MODULE: VSUMLCAT EXPLANATION: The BUFFERTABLE parameter was specified, but the required BUFPRINT DD statement is missing. Enter the BUFPRINT DD statement and try the function again.

VSUM-ERRL03 THE SPECIFIED VOLUMES CATALOG RECORD ‘XXXXXX’ WAS NOT FOUND. ACTION: PROCESSING TERMINATED. MODULE: VSUMLCAT EXPLANATION: The VOLUME parameter was specified, but no associated catalog record was found for it. Correct the VOLUME specified, or verify that is in the specified catalog and try the function again.

VSUM-ERRL04 NO DATASETS MET THE CRITERIA CHOSEN. ACTION: PROCESSING TERMINATED. MODULE: VSUMLCAT EXPLANATION: No datasets were found meeting all the input criteria simultaneously.

VSUM-ERRL06 INPUT PARAMETERS SPECIFIED RESULT IN NO PRINTING. ACTION: PROCESSING TERMINATED. MODULE: VSUMLCAT EXPLANATION: The selection of the NODETAIL parameter in conjunction with the other LIST report parameters specified require no printing, so no processing was necessary.

VSUM-ERRL07 NO CATALOG WAS FOUND WITH THE SPECIFIED NAME OF XXXXXXXX. ACTION: PROCESSING TERMINATED. MODULE: VSUMLCAT EXPLANATION: The CATALOG parameter was input, but no VSAM catalog was found with that name. Correct this parameter and run the function again.


197

VSUM-ERRM01 NO MODCWA ADDRESS FOUND IN VSUMWA. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMMODC EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRM02 DEVICE TYPE ‘XXXX’ NOT SUPPORTED. ACTION: PROCESSING TERMINATED. MODULE: VSUMMODC EXPLANATION: The DEVICETYPE parameter was specified with the value ‘XXXX’, but this type is not currently supported by VSUM. Change this parameter and try the function again.

VSUM-ERRM03 ALLOCATION TYPE ‘X’ IS NOT A (C,T,R). ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMMODC EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRM05 FREERECORDS PER CI IS GREATER THAN LARGEST CI POSSIBLE. ACTION: PROCESSING TERMINATED. MODULE: VSUMMODC EXPLANATION: The space required to leave the number of free records specified in the FREERECORDS parameter is greater than the maximum control interval size allowed by VSAM. Correct this parameter and try the function again.

VSUM-ERRM12 AVGRECSZ IS GREATER THAN MAXRECSZ. ACTION: PROCESSING TERMINATED. MODULE: VSUMMODL EXPLANATION: The average record size specified in the AVGRECSZ parameter is greater than the maximum record size specified in the MAXRECSZ parameter which is not allowed by VSAM. Correct these parameters and try the function again.

VSUM-ERRM13 MAXRECSZ IS GREATER THAN SPECIFIED CISIZE-7 FOR NONSPANNED DATASET. ACTION: PROCESSING TERMINATED. MODULE: VSUMMODL EXPLANATION: The maximum record size specified in the MAXRECSZ parameter is greater than the control interval size less seven bytes. This is not


198

allowed by VSAM for a non-spanned dataset. Correct this parameter and try the function again.

VSUM-ERRM14 KEYLENGTH PLUS KEY OFFSET IS GREATER THAN CISIZE-10 FOR A SPANNED DATASET. ACTION: PROCESSING TERMINATED. MODULE: VSUMMODL EXPLANATION: The keylength plus the key offset specified is greater than the control interval size less ten bytes. This is not allowed by VSAM for a non-spanned dataset. Correct one of the parameters and try the function again.

VSUM-ERRM15 COMPRESS KEYLENGTH GREATER THAN KEYLENGTH. ACTION: PROCESSING TERMINATED. MODULE: VSUMMODL EXPLANATION: The compressed keylength, specified as the third subparameter of the KEYS parameter, is greater than the specified keylength which cannot occur. Correct this parameter and try the function again.

VSUM-ERRM16 AVGRECSZ AND MAXRECSZ MUST BE THE SAME FOR AN RRDS. ACTION: PROCESSING TERMINATED. MODULE: VSUMMODL EXPLANATION: The average record size specified in the AVGRECSZ parameter must be equal to the maximum record size specified in the MAXRECSZ parameter, which is required by VSAM for a RRDS dataset. Correct these parameters and try the function again.

VSUM-ERRM17 AVGRECSZ OR MAXRECSZ WAS NOT SPECIFIED. ACTION: PROCESSING TERMINATED. MODULE: VSUMMODL EXPLANATION: Neither the average record size specified in the AVGRECSZ parameter or the maximum record size specified in the MAXRECSZ parameter was specified. Add one or both of these parameters and try the function again.

VSUM-ERRM18 CALCULATION ERROR FOR SPECIFIED CISIZE. ACTION: PROCESSING TERMINATED. MODULE: VSUMMODL EXPLANATION: Check to see whether the specified average or maximum recordsize exceeds the CISIZE specified. If not, obtain a dump and contact CSI International support. Refer the ABEND option of the section “PARM Command” (page 8).


199

VSUM-ERRM19 CALCULATION ERROR FOR MODERANGE CISIZE. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMMODL EXPLANATION: Check to see whether the specified average or maximum recordsize exceeds the CISIZE for the processing mode as follows. DIRECT 512 to 4096 MIXED 2048 to 8192 SEQUENTIAL 4096 to 32768 If not, obtain a dump and contact CSI International support. Refer the ABEND option of the section “PARM Command” (page 8).

VSUM-ERRM20 DATASET SIZE EXCEEDS MAXIMUM RBA ADDRESSABILITY. ACTION: PROCESSING TERMINATED. MODULE: VSUMMODL EXPLANATION: The dataset size specified exceeds the maximum byte addressability of a VSAM dataset. Correct this parameter and try the function again.

VSUM-ERRM21 INVALID CISIZE CALCULATION - LOGIC ERROR. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMMODL EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERRM22 KEYLENGTH PLUS OFFSET IS GREATER THAN MAXRECSZ. ACTION: PROCESSING TERMINATED. MODULE: VSUMMODL EXPLANATION: The keylength plus the key offset specified is greater than the maximum record size. This is not allowed by VSAM. Correct the parameter and try the function again.

VSUM-ERRM23 SPECIFIED CISIZE IS TOO SMALL FOR A ‘XXXX’ DEVICE TYPE. ACTION: PROCESSING TERMINATED. MODULE: VSUMMODL EXPLANATION: The control interval size specified is too small for the device ‘XXXX’, and is not allowed by VSAM. Correct the parameter and try the function again.


200

VSUM-ERRM24 SPECIFIED CISIZE IS TOO SMALL FOR A ‘3375’ DEVICE TYPE. ACTION: PROCESSING TERMINATED. MODULE: VSUMMODC EXPLANATION: During model processing, a device type of ‘3375’ was requested with a CI size less than ‘2048’. Increase the CI size to at least ‘2048’ and try the function again.

VSUM-ERRR01 OPEN FAILURE FOR FILE=‘XXXXXXXXXXXXXXXXXXXXXX’. ACTION: PROCESSING TERMINATED. MODULE: VSUMRERN EXPLANATION: During REPRINT processing, the file (dsname shown by ‘XXXXXXXXXXXXXXXX’) had an open error. Verify that the file is the one required for the statistical file being processed and try the function again.

VSUM-ERRR02 NO DD STATEMENT PRESENT FOR FILE=‘XXXXXXXX’. ACTION: PROCESSING TERMINATED. MODULE: VSUMRERN EXPLANATION: During REPRINT processing, the statistical file required for processing had a missing DD statement (DDname shown by ‘XXXXXXXX’). Add the required DD statement and try the function again.

VSUM-ERRR03 NO RECORDS FOUND MEETING CRITERIA ON FILE=‘XXXXXXXX’. ACTION: PROCESSING TERMINATED. MODULE: VSUMRERN EXPLANATION: During REPRINT processing, no saved statistical records were found on the specified file, shown by DD statement ‘XXXXXXXX’, meeting the input criteria specified for the function. If other results were expected, verify the statistical file used and the input criteria chosen, and then try the function again.

VSUM-ERRR04 CISTATS WERE NOT SAVED ON RUNTYPE=NEW FOR DSN=‘XXXXXXXXXXXX’. ACTION: PROCESSING TERMINATED. MODULE: VSUMRERN EXPLANATION: During REPRINT processing, no control interval statistical records were found for the specified dataset on the CASTATDD file. If other results were expected, verify the statistical file used and the input criteria chosen and then try the function again.


201

VSUM-ERRR06 CASTATS WERE NOT SAVED ON RUNTYPE=NEW FOR DSN=‘XXXXXXXXXXXX’.. ACTION: PROCESSING TERMINATED. MODULE: VSUMRERN EXPLANATION: During REPRINT processing, no control area statistical records were found for the specified dataset on the CASTATDD file. If other results were expected, verify the statistical file used and the input criteria chosen and then try the function again.

VSUM-ERRR07 STARTING CA -CASTART/VOLUME- NOT FOUND FOR DSN=‘XXXXXXXXXXXX’.. ACTION: PROCESSING TERMINATED. MODULE: VSUMRERN EXPLANATION: During REPRINT processing, the chosen starting control area sequence number was not found among the statistical records for the specified dataset on the CASTATDD file. If other results were expected, verify the statistical file used and the input criteria chosen and then try the function again.

VSUM-ERRR08 NO CA STATISTICS FOR THE CIREPORT WERE FOUND FOR DSN=‘XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX’ ACTION: PROCESSING TERMINATED. MODULE: VSUMRERN EXPLANATION: During REPRINT processing, no control area statistics for the control interval report were found for the specified dataset on the CASTATDD file. If other results were expected, verify the statistical file used and the input criteria chosen and then try the function again.

VSUM-ERR000 (Release 1 input parameter editing text) ACTION: PROCESSING TERMINATED. MODULE: VSUMEDIT

TEXT: UNKNOWN KEYWORD FOUND - AAAAAAAA. EXPLANATION: The keyword ‘AAAAAAAA’ is not valid for release 1 processing.

TEXT: INVALID PARAMETER FOR ‘AAAAAAAA’. EXPLANATION: The parameter specified for keyword ‘AAAAAAAA’ is not valid for release 1 processing.

TEXT: INVALID SUBPARAMETER OF ‘AAAAAAAA’. EXPLANATION: The sub-parameter specified for keyword ‘AAAAAAAA’ is not valid for release 1 processing.


202

TEXT: CASTART AND VOLUME PARAMETERS ARE MUTUALLY EXCLUSIVE.

EXPLANATION: The parameters of CASTART and VOLUME cannot be specified at the same time for release 1 processing.

TEXT: CAEND AND CACOUNT PARAMETERS ARE MUTUALLY EXCLUSIVE.

EXPLANATION: The parameters of CAEND and CACOUNT cannot be specified at the same time for release 1 processing.

TEXT: CAEND AND VOLUME PARAMETERS ARE MUTUALLY EXCLUSIVE.

EXPLANATION: The parameters of CAEND and VOLUME cannot be specified at the same time for release 1 processing.

TEXT: CACOUNT AND VOLUME PARAMETERS ARE MUTUALLY EXCLUSIVE.

EXPLANATION: The parameters of CACOUNT and VOLUME cannot be specified at the same time for release 1 processing.

TEXT: SPECIFIED PARMS AND DEFAULTS REQUIRE NO PROCESSING.

EXPLANATION: The parameters specified do not produce any reports, so no processing is required (release 1).

TEXT: CASAMPLE NOT ALLOWED WITH RUNTYPE=OLD. EXPLANATION: The CASAMPLE parameter can only be specified on a RUNTYPE=NEW for release 1 processing.

TEXT: DATASET PARM REQUIRED WITH RUNTYPE=OLD. EXPLANATION: The DATASET parameter must be specified with the dataset name of the file to be reprinted on a RUNTYPE=OLD for release 1 processing.

TEXT: INVALID DSNAME IN DATASET PARAMETER. EXPLANATION: The DATASET parameter has a dataset name that doesn’t pass the dataset name edits. Correct the dataset name and try the function again.


203

VSUM-ERR001 SPECIFIED PARAMETERS AND DEFAULTS REQUIRE NO PROCESSING. ACTION: PROCESSING TERMINATED. MODULE: VSUMANAL EXPLANATION: The parameters specified, and the defaults taken do not produce any reports or require any analysis, so no processing is required.

VSUM-ERR002 XXXXXXXXX DD STATEMENT IS REQUIRED. ACTION: PROCESSING TERMINATED. MODULES: VSUM,VSUMCBLK,VSUMANAL EXPLANATION: The DD statement shown in ‘XXXXXXXX’ is required for the processing chosen. Add the DD statement and try the function again.

VSUM-ERR003 EXPECTED CONTINUATION FOR SYSIN NOT FOUND. ACTION: PROCESSING TERMINATED. MODULE: VSUM EXPLANATION: A SYSIN statement was left incomplete, so a continuation was expected, but not found, when scanned. Complete the statement and try the function again.

VSUM-ERR004 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX DATASET HAS NOT BEEN LOADED. ACTION: PROCESSING TERMINATED. MODULE: VSUMANAL EXPLANATION: The dataset specified by ‘XXXXXXXXX’ has not been loaded yet, so dataset analysis cannot be done.

VSUM-ERR007 SYSIN PARAMETER WORKAREA OVERFLOW. CHECK SYSIN FOR EXTRANEOUS DATA. ACTION: PROCESSING TERMINATED. MODULE: VSUM EXPLANATION: The internal SYSIN workarea has reached its capacity. Check to ensure that only valid parameters in the correct format were used. If the condition is not correctable, contact CSI International support with a copy of the SYSIN statements used.

VSUM-ERR008 CASTART IS GREATER THAN HIGH KEY OR HIGH USED CA NO, DSN=AAAAAAAAA ACTION: PROCESSING TERMINATED. MODULE: VSUMANAL EXPLANATION: The control area number specified in the CASTART parameter is beyond the current limits of the dataset (identified by AAAAAAAA)


204

—greater than the highest key or the highest used control area number. Correct this parameter and try the function again.

VSUM-ERR009 ZERO CIDF FIELD IN NON-FREE CI, CI RBA=XXXXXXXX, DSN=AAAAAAAAAA ACTION: PROCESSING TERMINATED. MODULE: VSUMANAL EXPLANATION: This error indicates that the dataset (identified by AAAAAAAAAA) being analyzed could be in the middle of a control area split, or if this is not the case, the index pointers for the dataset are bad. The relative byte address of the control interval in which the error was encountered is shown as ‘XXXXXXXX’.

VSUM-ERR011 NO DATA BUFFER FOUND IN VSAGETDC ROUTINE. LOGIC ERROR. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMANAL EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERR013 FREERCSZ PARM VALUE IS GREATER THAN MAXIMUM RECSIZE, DSN=AAAAAAAAAA ACTION: PROCESSING TERMINATED. MODULE: VSUMANAL EXPLANATION: The record size specified in the FREERCSZ parameter, to be used in the calculation of the number of free records remaining on the dataset, is greater than the defined maximum record size for the dataset (identified by AAAAAAAAAA). Correct this parameter and try the function again.

VSUM-ERR014 XXXXXXXX OPEN FAILURE. ACTION: PROCESSING TERMINATED. MODULE: VSUMANAL EXPLANATION: An open failure occurred on the DD statement shown by ‘XXXXXXXX’. Verify the dataset/file associated with this DD, correct any mistakes, then try the function again.

VSUM-ERR096 VSAM AAAAAA FAILURE, R15=‘BB’, ERROR=‘CCC’, MODULE=XXXXXXXX AT ADDR=‘DDDDDD’. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULES: VSUMBKUP, VSUMCBLK, VSUMRERN EXPLANATION: A VSAM macro failure has occurred. The macro type is shown by ‘AAAAA’, register 15’s contents are shown in ‘BB’ and the VSAM feedback code is given by ‘CCC’. These errors are documented in the


205

VSAM PROGRAMMER’S GUIDE. The module in which the error occurred is denoted by ‘XXXXXXXX’ with the displacement into that same module shown by ‘DDDDDD’.

VSUM-ERR097 LOGIC ERROR-ERROR CODE NOT FOUND IN ERROR MESSAGE TABLE OF MODULE=XXXXXXXX ACTION: PROCESSING TERMINATED. MODULE: VSUMBKUP, VSUMCBLK, VSUMIN00, VSUMLCAT, VSUMMODC, VSUMMODL, VSUMRCRP, VSUMRERN EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERR098 LOGIC ERROR-ERROR MESSAGE BUILD ERROR IN MODULE=XXXXXXXX ACTION: PROCESSING TERMINATED. MODULE: VSUMBKUP, VSUMCBLK, VSUMIN00, VSUMLCAT, VSUMMODC, VSUMMODL, VSUMRCRP, VSUMRERN EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERR099 LOGIC ERROR-ERROR MESSAGE BUILD OVERFLOW IN MODULE=XXXXXXXX ACTION: PROCESSING TERMINATED. MODULE: VSUMBKUP, VSUMCBLK, VSUMIN00, VSUMLCAT, VSUMMODC, VSUMMODL, VSUMRCRP, VSUMRERN EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERR102 INVALID REQUEST TO VSUMCBLK MODULE ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMCBLK EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.


206

VSUM-ERR103 RDJFCB MACRO FAILURE IN VSUMCBLK MODULE ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMCBLK EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERR104 XXXXXXXX ACB NOT OPEN. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMCBLK EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERR105 XXXXXXXX VSAM PLH NOT FOUND. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMCBLK EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERR106 VSAM RBA NO FOUND IN VOLUME LIST. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMCBLK EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERR112 SPECIFIED VOLUME IS NOT ALLOCATED TO DSN=AAAAAAAAAA ACTION: PROCESSING TERMINATED. MODULE: VSUMCBLK EXPLANATION: The volume serial number specified in the VOLUME parameter is not allocated to the specified dataset (identified by AAAAAAAAAA). Correct this parameter and try the function again.

VSUM-ERR113 XXXXXX IS A CANDIDATE VOLUME AND CONTAINS NO DATA, DSN=AAAAAAAAAA. ACTION: PROCESSING TERMINATED. MODULE: VSUMCBLK EXPLANATION: The volume serial number specified in the VOLUME parameter is only a CANDIDATE VOLUME for the specified dataset (identified by AAAAAAAAAA), so it doesn’t contain any data.


207

VSUM-ERR114 VOLUME XXXXXX CONTAINS NO DATA, DSN=AAAAAAAAAA. ACTION: PROCESSING TERMINATED. MODULE: VSUMCBLK EXPLANATION: The volume serial number specified in the VOLUME parameter doesn’t contain any data. Dataset is identified by AAAAAAAAAA.

VSUM-ERR115 NUMBER OF VOLUMES OR KEYRANGES EXCEEDS 16, DSN=AAAAAAAAAA. ACTION: PROCESSING TERMINATED. MODULE: VSUMCBLK EXPLANATION: The dataset (identified by AAAAAAAAAA) being processed has been found to use more than 16 volumes or keyranges, so processing cannot continue.

VSUM-ERR116 NUMBER OF EXTENTS FOR VOLUME XXXXXX EXCEEDS 256, DSN=AAAAAAAAAA. ACTION: PROCESSING TERMINATED. MODULE: VSUMCBLK EXPLANATION: The VOLUME specified by ‘XXXXXX’ has more than 256 extents on it, so processing cannot continue. Dataset is identified by AAAAAAAAAA.

VSUM-ERR117 NOT ENOUGH VIRTUAL STORAGE TO PROCESS REQUEST MODULE=XXXXXXXX ACTION: PROCESSING TERMINATED. MODULE: VSUMANAL, VSUMAUTO, VSUMBKUP, VSUMCBLK, VSUMLCAT, VSUMPRNT, VSUMRCRP EXPLANATION: There was not enough REGION specified to process the function specified. Increase the REGION and try the function again.

VSUM-ERR118 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX CATALOG LOCATE ERROR=‘AAA’ PROCESSING TERMINATED. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMCBLK EXPLANATION: This message denotes VSAM catalog locate error has occurred (SVC26). Refer to IBM’s OS/VS2 CATALOG MANAGEMENT LOGIC manual and/or IBM message description IDC3009I for a description of any return codes not listed below.

RETURN CODE 40, 44 Too many associations to list. Use IDCAMS LISTCAT.

48 Catalog specified or defaulted is a non-VSAM catalog.


208

50 VVDS error. Make sure the DASD volume for the entry being listed is available to the CPU which is executing VSUM.

56 Authorization failure, dataset password is missing or specified incorrectly. VSAM catalogs cannot be analyzed in ISPF foreground mode.

72 A required volume is not mounted.

VSUM-ERR119 CATALOG LOCATE ERROR (CAT ACB NOT FOUND) PROCESSING TERMINATED. ACTION: ABEND ISSUED ON “PARM ABEND”. MODULE: VSUMCBLK EXPLANATION: This message denotes an internal VSUM programming problem. If it should occur, notify CSI International support and send the associated dump.

VSUM-ERR120 DATASET IS NOT A KSDS OR AIX, DSN=AAAAAAAAAA. ACTION: PROCESSING TERMINATED. MODULE: VSUMCBLK EXPLANATION: The dataset shown with dsname=‘AAAAAAAAAA’ is not a VSAM KSDS or AIX, so processing cannot continue.

VSUM-ERR122 DATASET IS NOT A KSDS/AIX/ESDS/RRDS/PATH, DSN=AAAAAAAAAA. ACTION: PROCESSING TERMINATED. MODULE: VSUMCBLK EXPLANATION: The dataset shown with dsname=‘AAAAAAAAAA’ is not a VSAM KSDS, ESDS, RRDS, PATH or AIX, so processing cannot continue.

VSUM-ERR123 DEVICE ‘AAAA’ IS NOT SUPPORTED, DSN=AAAAAAAAAA. ACTION: PROCESSING TERMINATED. MODULE: VSUMCBLK EXPLANATION: The dataset shown with dsname=‘AAAAAAAAAA’ is on device ‘AAAA’, which is not supported by VSUM.

VSUM-ERR124 XXXXXXXX QSAM PUT FAILURE. ACTION: PROCESSING TERMINATED. MODULE: VSUMCBLK EXPLANATION: A QSAM put failure occurred with the DD statement denoted by ‘XXXXXXXX’. Check all the file/dataset parameters and try the function again.


209

VSUM-ERR125 XXXXXXXX QSAM OPEN FAILURE. ACTION: PROCESSING TERMINATED. MODULE: VSUMCBLK EXPLANATION: A QSAM open failure occurred with the DD statement denoted by ‘XXXXXXXX’. Check all the file/dataset parameters and try the function again.

VSUM-ERR126 AUTHORIZATION ERROR OPENING DSN=‘dsname’ ACTION: PROCESSING TERMINATED. MODULE: VSUMANAL EXPLANATION: An attempt was made to ANALYZE a dataset or catalog that can only be opened by a load module located in a MVS authorized library. Make sure the VSUM load library being used in an authorized MVS load library.

VSUM-ERR806 MODULE=XXXXXXXX COULD NOT BE LOADED. ACTION: PROCESSING TERMINATED. MODULE: VSUM EXPLANATION: The module with the name ‘XXXXXXXX’ could not be loaded by VSUM. Verify that the modules are all contained in a library available to the job (via joblib, steplib, etc.), then try the function again.

VSUM-ERR996 *** VSUM HAS EXPIRED, CONTACT VENDOR SUPPORT ACTION: PROCESSING TERMINATED. MODULE: VSUM EXPLANATION: The software license or trial expiration date has expired. Check with your system programmer or call CSI International support for software renewal information.

VSUM-ERR997 *** VSUM WILL EXPIRE WITHIN 30 DAYS, CONTACT VENDOR SUPPORT ACTION: NONE. MODULE: VSUM EXPLANATION: The software license expiration date will expire within 30 days (usually the end of the current month). Check with your system programmer or call CSI International support for software renewal information.

210

A Statistical Files

The VSUM historical facility for dataset statistics requires two (2) statistical files. These statistical files must be allocated by the user prior to or in the VSUM step that requires them. This facility is optional and can be specified when the “SAVE” parameter is used in the LIST command or in the DSREPORT, CAREPORT, CAGRAPH, or CIREPORT parameters of the ANALYZE command. The default DD statement names for these two statistical files are

//DSSTATS DD ........

//CASTATS DD ........

These files can be allocated as QSAM (variable blocked) datasets or defined as a VSAM ESDS dataset. The following DCB or VSAM ESDS information should be used as a reference for creation of the historical files.

QSAM: RECFM=VB,LRECL=5496,BLKSIZE=5500

ESDS: DEFINE CLUSTER RECSZ (600 5492)

Space requirements for the statistical files will vary according to reports and user file size selected. Listed below is a description of record types that are written for each type of report for which the “SAVE” parameter is specified.

CASTATS File

Type Report # of Records Written CAREPORT/CAGRAPH One DS record per file and one CA record

per CA processed. CIREPORT *One CI record per CI processed.

Dataset Characteristics

Space Requirements

VSUM for z/OS Program Description and Operations Guide Statistical Files

211

DSSTATS File

DSREPrt # of Records Written CAREPORT/CAGRAPH One DS record per file and one CA record

per CA processed. CIREPORT 66 bytes + (Keylen * 2) * Note: The CI report can generate an enormous amount of records if

the saving of control interval statistics is requested for many control areas.

The “VSUMRECS” macro will generate the necessary ASSEMBLER DSECT fields required for each VSUM statistical file record type. Each “VSUMRECS” macro should be preceded by a DSECT statement.

The following “VSUMRECS” macro examples will generate the indicated record descriptions.

DSRECORD DSECT VSUMRECS PFIX=xx,RECTYPE=DS

CARECORD DSECT VSUMRECS PFIX=xx,RECTYPE=CA

CIRECORD DSECT VSUMRECS PFIX=xx,RECTYPE=CI

where xx = 2-character label prefix of your choice that be part of each symbol generated.

If the user wishes to intercept the records that are written to the VSUM statistical file(s) during an ANALYZE function, you may specify the STATEXIT parameter in the command. The STATEXIT parameter refers to a valid load module that will be loaded by VSUM and linked to before each record is written to a VSUM statistical file.

The user exit module must have an entry point of zero and adhere to the following register conventions.

Record Descriptions

Dataset Record Description

Control Area Record Description

Control Interval Record Description

Analyze Command User Exit

VSUM for z/OS Program Description and Operations Guide Statistical Files

212

Register contents upon entry to the user exit module:

R1 Address of the statistical record to be written. (See VSUMSAS and VSUMRECS members in the VSUM INSTALL as described in SAS EXAMPLE section below.)

R13 Callers (VSUM) register save area.

R14 Return register.

R15 Entry point to the user exit module.

The first record and last record passed to the user exit for each dataset will always be a dataset record. The first dataset record will not have all the statistical fields set and should only be used to identify the dataset name being processed. The second or last dataset record will be a complete dataset record with all statistical fields set. After the first dataset record is passed, the first and succeeding control interval records will be passed followed by the control area record for those control intervals. This sequence will be repeated for each control area processed.

The second dataset record will be your last record received for each dataset. Each record is in standard variable-length format with a four-byte length field in the beginning of each record followed by a record type byte. Refer to the “VSUMRECS” macro in section “Record Descriptions” on page 211 for information on how to get a printed description of each type of VSUM statistical record.

The VSUM INSTALL (File 7) on the distribution tape contains a member called VSUMSAS. This member is a COMMENTED example of a SAS program that performs the following function.

VSUM dataset records are read from the DSSTATS file, and the number of INSERTED records is graphed against the number of control area and control interval splits. Totals and maximums are printed at the end of the DSSTATS file processing.

NOTE: This example contains only commented SAS statements, and each statement must be un-commented before being used by SAS.

The VSUMSAS member contains SAS record descriptions for VSUM dataset, control area, and control interval records. These record descriptions correspond to duplicate ASSEMBLER DSECT field names in the VSUMRECS assembler macro. This example can be used as a base for user-written SAS programs that may be needed for additional reports not provided by VSUM.

SAS Example

213

B Command/Parameter Abbreviations

ANALYZE COMMAND: ABBREVIATIONS: ANALYZE ANAL, A BKERDD BKUPDD CACOUNT CACNT CAEND CAGRAPH CAG CAREPORT CAR CASAMPLE CASAMP CASTART CASTRT CASTATDD CASTATS, CASTDD, CADD CAVOLUME CAVOL CIREPORT CIR DSREPORT DSR DSSTATDD DSSTATS, DSSTDD, DSDD FREERECORDSIZE FREERECSIZE, FREERCSZ, FRRCSZ, FRCSZ KRREPORT KRR NAME RECOMMENDATIONS RECOMMEND, RECOMM STATEXIT VSAMINDD VINDD, INDD

Appendix B: Command/Parameter Abbreviations

214

LIST COMMAND: ABBREVIATIONS: LIST L ANALYZE ANAL BIND BUFFERTABLE BUFFTABLE, BUFTABLE, BUFFT, BUFT CANDIDATEVOLUME CANDIDATE, CANDTVOLUME, CANDTVOL, CANDT CASPLITS CASPLIT, CASPL, CASP CATALOG CAT CISIZEDATA CISIZE, CISIZED, CISZD, DATACISIZE CISIZEINDEX CISIZEI, CISZI, INDEXCISIZE CISPLITS CISPLIT, CISPL, CISP CREATIONDATE CREATED, CRDATE, CRDT CYLINDERFAULT CYLFAULT, CYLF DELETEDDATA DELETED, DELETEDD, DELTDATA, DELTD DELETEDINDEX DELETEDINDEX, DELETEDI, DELTINDEX, DELTI DESTAGEWAIT DSWAIT, DSW DEVICETYPE DEVTYPE, DEVTYP, DEVT DSSTATDD DSSTATS, DSSTDD, DSDD EMPTY ERASE ERA EXCPSDATA EXCPS, EXCP, EXCPDATA, EXCPSD, DATAEXCPRATIO, DEXCPR EXCPSINDEX EXCPINDEX, EXCPSI, INDEXEXCPRATIO, IEXCPR EXCPRATIODATA EXCPRATIO, EXCPRD EXCPRATIOINDEX EXCPRATIOINDEX, EXCPRI EXPIRATIONDATE EXPIRED, EXPDATE, EXDT FREECYLINDERS FREECYLS, FCYLS FREECYLINDERSDATA FREECYLINDERSD, FREECYLSDATA, FREECYLSD, FCYLSDATA, FCYLSD FREECYLINDERSINDEX FREECYLINDERSI, FREECYLSINDEX, FREECYLSI, FCYLSINDEX, FCYLSI FREESPACE FSPC FREETRACKS FREETRKS, FTRKS FREETRACKSDATA FREETRACKSD, FREETRKSDATA, FREETRKSD, FTRKSDATA, FTRKSD FREETRACKSINDEX FREETRACKSI, FREETRKSINDEX, FREETRKSI, FTRKSINDEX, FTRKSI FULL IMBED IMB INDEXLEVELS ILEVELS, ILEVEL, ILVL INSERTEDDATA INSERTED, INSERTEDD, INSRDATA, INSRD INSERTEDINDEX INSERTEDI, INSRINDEX, INSRI KEYRANGE KEYR LASTUPDATED LASTUPDATE, LASTUPD, LASTUP LISTTOTALS LISTTOTAL, LSTTOTALS, LTOTALS, LTOT NAME NODESTAGEWAIT NODSWAIT, NODSW NODETAIL NOERASE NOERA NOIMBED NOIMB


215

LIST COMMAND: (cont.) ABBREVIATIONS: NOKEYRANGE NOKEYRNG, NOKEYR, NKEYR NONSPANNED NOSPANND, NONSPAN, NONSPA, NSPA NONUNIQUEKEY NONUNQKEY, NONUNQK, NUNQK NOREPLICATE NOREPL, NOREP NOREUSE NOREU NOSWAP NOTSWAPPABLE NOTUSABLE NOTUS, UNUSABLE NOUPDATE NOUPDAT, NOUPD NOWRITECHECK NOWCHECK, NOWCK, NOWRTCHK ORDERED ORDER, ORD OWNER OWN PHYRECORDSIZEDATA PHYRECORDSIZE, PHYRECSZ, PHYRECZDATA PHYRCSZ, PHYRCSZDATA RANGETOTALS RANGETOTAL, RANGTOTALS, RNGTOTALS, RTOTALS, RNGTOT, RANGETOT, RTOT READDATA READ, READD, DATAREAD, DREAD READINDEX READI, INDEXREAD, IREAD RECOMMENDATIONS RECOMMEND, RECOMM, RECOM RECORDS RECORDSDATA, RECORDSD, RECSDATA, RECSD RECORDSINDEX RECORDSI, RECSINDEX, RECSI RECORDTOTALS RECTOTALS, RECTOTAL, RECT RECOVERY REC REPLICATE REPL, REP REUSE REU SAVE SECALLOCATION SECALLOC, SECAL, SECA SHAREOPTIONS SHR SPANNED SPAN, SPA SPEED SPE STAGE STG SUBALLOCATED SUBALLOCATE, SUBALLOC, SUB SWAP SWAPPABLE TEMPEXPORTED TEMPEXPR, TEMPEXP, TEXP TOTALCYLINDERS TOTCYLINDERS, TOTALCYLS, TOTCYLS, TCYLS TOTALCYLINDERSDATA TOTALCYLSDATA, TOTCYLSDATA, TOTCYLINDERSD , TOTCYLSD, TCYLSDATA, TCYLSD TOTALCYLINDERSINDEX TOTALCYLSINDEX, TOTCYLSINDEX, TOTCYLINDERSI, TOTCYLSI, TCYLSINDEX, TCYLSI TOTALTRACKS TOTTRACKS, TOTALTRKS, TOTTRKS, TTRKS TOTALTRACKSDATA TOTALTRKSDATA, TOTTRKSDATA, TOTTRACKSD, TOTTRKSD, TTRKSDATA, TTRKSD TOTALTRACKSINDEX TOTALTRKSINDEX, TOTTRKSINDEX, TOTTRACKSI, TOTTRKSI, TTRKSINDEX, TTRKSI TRACKUTILIZATION TRKUTIL%, TRKU%, TRKUTIL, TRKU TRKSCA CASIZE, TRKS/CA, TRK/CA, TRKSPERCA, TRKCA, TYPE


216

LIST COMMAND: (cont.) ABBREVIATIONS: UNIQUE UNQ UNIQUEKEY UNQKEY, UNQK UNORDERED UNORDERD, UNORDER, UNORD, NONORDERED UPDATE UPD UPDATED UPDATEDDATA, UPDATEDD, UPDTDATA, UPDTD UPDATEDINDEX UPDATEDINDEX, UPDATEDI, UPDTINDEX, UPDTI USEDCYLINDERS USEDCYLS, UCYLS USEDCYLINDERSDATA USEDCYLSDATA, USEDCYLINDERSD, USEDCYLSD UCYLSDATA, UCYLSD USEDCYLINDERSINDEX USEDCYLSINDEX, USEDCYLINDERSI, USEDCYLSI UCYLSINDEX, UCYLSI USEDTRACKS USEDTRKS, UTRKS USEDTRACKSDATA USEDTRKSDATA, USEDTRACKSD, USEDTRKSD, UTRKSDATA, UTRKSD USEDTRACKSINDEX USEDTRKSINDEX, USEDTRACKSI, USEDTRKSI, UTRKSINDEX, UTRKSI VOLUME VOL VOLUMELIST VOLLIST, VOLL WRITECHECK WCHECK, WCK


217

MODEL COMMAND: ABBREVIATIONS: MODEL M ALLCISIZES ALLCI, ALLCIS BASECLUSTERNAME BASECLNAME, BASENAME, BASEN, BASE BASEKEYLENGTH BASEKEYLEN, BASEKEYLN, BASEKEYL CATALOG CAT CISIZE CISIZEDATA, CISIZED, CISZD, CISZ, DCISZ CYLINDERS CYLINDER, CYLS, CYL DEFOUT DEVICETYPE DEVTYPE, DEVICE, DEV FREERECORDS FREERECS, FRECS FREESPACE FSPC IMBED IMB KEYS KEY MAXDUPLICATEKEYS DUPKEYS, MAXDUPLKEYS, MAXDUPKEYS NAME NOIMBED NOIMB NONSPANNED NONSPAN, NONSPA, NSPA, NOSPANND NOREPLICATE NOREPL, NOREP PROCESSINGMODE PROCESSMODE, PROCMODE, PROMODE, PMODE RECORDS RECS, REC RECORDSIZE RECSIZE, RECSZ REPLICATE REPL, REP SHAREOPTIONS SHAREOPTION, SHARE, SHR SPANNED SPAN, SPA TRACKS TRKS, TRK TYPE VOLUME VOL, V

RECOMMENDATION COMMAND: ABBREVIATIONS: RECOMMENDATIONS RECOMMEND, RECOMM ALL ATTRIBUTES ATTRIBUTE, ATTR BUFFERS BUFF, BUF CISIZE CISZ FREESPACE FSPC NEWDEVICETYPE NEWDEVICE, NEWDEV REORGANIZATION REORGANIZE REORG SPACE


218

REPRINT COMMAND: ABBREVIATIONS: REPRINT REPR, R CACOUNT CACNT CAEND CAGRAPH CAG CAREPORT CAR CASTART CASTRT CASTATDD CASTDD, CADD CAVOLUME CAVOL CIREPORT CIR DSREPORT DSR DSSTATDD DSSTDD, DSDD FROM KRREPORT KRR NAME TO RECOMMENDATIONS RECOMMEND, RECOMM

219

Index

A Abbreviated commands, 213 Abbreviated parameters, 213 Abend

requesting, 8 Abend codes, 177 ALIAS

report fields, 74 total of, 80

Alternate Index modeling

base cluster name, 130 base key length, 131 duplicate keys, 132 non-unique keys, 132


ANALYZE input

example, 104 output

example, 106, 119 overview, 86 parameter abbreviations, 213 suggested uses, 88 VSAM catalog restrictions, 87

Appendixes

abbreviated commands and parameters, 213

statistical file user exit, 211 statistical files, 210

Associations, 113 ALIAS, 75 alternate index, 61 ESDS, 67 GDGBASE, 77 KSDS, 61 NONVSAM, 72 PATH, 70 RRDS, 67

Attributes BIND, 61, 66, 113 CYLINDERFAULT, 61, 66, 113 DESTAGEWAIT, 33, 60, 66 ERASE, 33, 61, 66, 112 IMBED, 37, 60, 112 KEYRANGE, 61, 113 NODESTAGEWAIT, 39, 60, 66 NOERASE, 39, 61, 66, 112 NOIMBED, 39, 60, 112 NOKEYRANGE, 61, 113 NONSPANNED, 40, 61, 66, 113 NONUNIQUEKEY, 40, 61, 112 NOREPLICATE, 40, 60, 112 NOREUSE, 40, 60, 66, 112 NOSWAP, 41, 61, 67 NOTUSABLE, 41

Index

220

NOUPDATE, 60, 66, 112 NOUPGRADE, 60, 113 NOWRITECHECK, 41, 61, 66, 113 ORDERED, 61, 67, 113 Recommendations, 159 RECOVERY, 43, 60, 66, 112 REPLICATE, 44, 60, 112 REUSE, 44, 60, 66, 112 SPANNED, 45, 61, 66, 113 SPEED, 45, 60, 66, 112 STAGE, 61, 66, 113 SUBALLOCATE, 46 SUBALLOCATED, 60, 66, 112 SWAP, 46, 61, 67 TEMPEXPORTED, 46 TEMPEXPR, 61, 67, 113 UNIQUE, 49, 60, 66, 112 UNIQUEKEY, 40, 49, 61, 112 UNORDERED, 41, 49, 61, 67, 113 UPDATE, 60, 66, 112 UPGRADE, 60, 113 WRITECHECK, 52, 61, 66, 113

B Backup

duplicate keys, 86 error file, 86 error file parameter, 94 errors, 86 how to specify, 94 KSDS, 86 out of sequence keys, 86

Batch JCL requirements, 10 Buffer

recommendations, 161 Bufferspace

defined, 60, 66 dataset, 112

BUFFERTABLE detail report

example, 77 report fields, 77

how to generate, 29 TOTAL report

report fields, 79 Bytes

free control area, 119 control interval, 121 data component, 63, 69, 109

free control intervals, 109 used control intervals, 109

dataset, 108 index component

sequence set, 111, 118 lost

control area, 119 spanned datasets, 119

control interval(end segment spanned), 121

data component, 109 spanned datasets, 109

total dataset, 108

used control area, 118 control interval, 121 data component, 109 dataset, 108 index component

sequence set, 110

C Candidate volumes, 30 CISIZES

modeling, 130 Commands

MODEL, 125 PARM, 8 SCAN, 7

Condition codes, 177 Control Area

empty data component, 110

free data component, 110

freespace, 118 number of splits, 62, 113, 116, 117

recommendations, 160 ranges of splits, 82 used

data component, 110 Control area graph

Index

221

controlling number of lines per page, 96 how to specify, 95 how to specify REPRINT, 168 limiting control areas

analyzed, 98, 99 printed, 96

overlay of graph output, 96 Control area report

controlling number of lines per page, 96 how to specify, 97 how to specify REPRINT, 169 limiting control areas

analyzed, 98, 99 printed, 96

Control Interval defined size, 61, 67, 113 free

control area, 143 data component, 110

control area, 118 modeling, 143

freespace dataset, 109

index component too large, 111, 118 too small, 111, 116, 118

lost control area, 116, 119 data component, 110

number of splits, 61, 113 number per ca, 62, 67, 114 per ca, 143 ranges by processing mode, 134 ranges of size, 83 ranges of splits, 83 Size

catalog search, 31 data component, 142 in BUFFERTABLE, 78, 79 index component, 142 modeling, 131, 142 recommendations, 150, 162

used data component, 109

control area, 118 index component

high level, 110 Control interval report

controlling number of lines per page, 99 how to specify, 99 limiting control areas printed, 99

Cylinders allocated

cluster, 46 data component, 47, 63, 68, 115 index component, 47, 63, 115

defined, 63, 68, 115 free

cluster, 35 data component, 35, 63, 68, 115 index component, 35, 63, 115

modeling, 131 required

data component, 143 modeling, 143

used data component, 63, 68, 115 index component, 63, 115

D Dataset

analysis control area sampling, 98 limiting control areas analyzed, 95

dynamic allocation, 86 EMPTY, 33 full

percentage of, 37 recommendations, 160

full, 37 Name

ALIAS, 74 alternate index, 59 BUFFERTABLE, 77 ESDS, 65 GDGBASE, 76 KSDS, 59 NONVSAM, 71 PATH, 70 RRDS, 65 VOLUME, 73

type in BUFFERTABLE, 77 DATASET RANGES

report fields, 82

Index

222

DATASET TOTALS report fields, 80

Date Creation

ALIAS, 74 alternate index, 59 ESDS, 65 GDGBASE, 76 KSDS, 59 NONVSAM, 71 PATH, 70 RRDS, 65 VOLUME, 73

Expiration ALIAS, 74 alternate index, 59 ESDS, 65 GDGBASE, 76 KSDS, 59 NONVSAM, 72 PATH, 70 RRDS, 65

last updated data component, 65, 113 index component, 113

Last Updated data component, 59 index component, 59

DDnames DEFDD, 131

Device type data component, 63, 69, 115 index component, 63, 115 modeling, 132, 143 new

recommendations, 161 NONVSAM, 75 VOLUME, 73 VOLUME TOTALS, 85

Direct processing buffer recommendations, 161 modeling, 134

E ERASE

recommendations, 159

ESDS report fields, 64 total of, 80

Examples Input

list a partial name with certain attributes, 53

list all ESDSs only 25 percent full, 54 KSDSs

and make buffer recommendations, 154

with casplits and auto analysis, 55 with freespace, 54 with secondary allocation, 54

volumes defined in a catalog, 56 VSAM datasets and save statistics, 56

print buffertable to determine LSR requirements, 55

Output BUFFERTABLE detail report, 77

EXCPS Data Component

catalog searching, 34 I/O Ratio

catalog searching, 33, 34 data component, 63, 68, 115 index component, 63, 115 ranges of, 83

Index Component catalog searching, 34

Number of BUFFERTABLE, 78 data component, 62, 67, 81, 114 index component, 62, 81, 114

Extents data component, 64, 69, 115 index component, 64, 115 VOLUME TOTALS, 85

F Fileseq

NONVSAM, 75 Flag

Empty alternate index, 59

Index

223

ESDS, 66 KSDS, 59 RRDS, 66

Expired ALIAS, 75 alternate index, 59 ESDS, 65 GDGBASE, 76 KSDS, 59 NONVSAM, 72 PATH, 70 RRDS, 65

Mismatch alternate index, 59 KSDS, 59

Notusable alternate index, 59 ESDS, 66 KSDS, 59 RRDS, 66

RACF alternate index, 59 ESDS, 66 KSDS, 59 RRDS, 66

Freespace bytes, 162 catalog search, 36 defined

alternate index, 60 dataset, 111 KSDS, 60

even distribution, 162 insert rate, 162 modeling, 132

warning, 144 recommendations, 151, 160, 162 records, 162 uneven distribution, 162

G GDGBASE

associations, 77 attributes

delete last, 76 GDGlimit, 76

scratch DSCB, 76 report fields, 75 total of, 80

H High level index

index component, 63 High level index records, 144

I IMBED

modeling, 133 warning, 144

recommendations, 160 Index entry length

average dataset, 108

Index levels, 62, 114, 144 catalog searching, 37 ranges of, 83

Input Parameters ALLCISIZES, 130 ANALYZE, 29 ATTRIBUTES, 149 BASECLUSTERNAME, 130 BASEKEYLN, 131 BIND, 29 BKERDD, 94 BKUPDD, 94 BUFFERS, 150 BUFFERTABLE, 29 CACOUNT, 95, 167 CAEND, 95, 167 CAGRAPH, 95, 168 CANDIDATE, 30 CASAMPLE, 98 CASPLITS, 30 CASTART, 98, 170 CASTATDD, 98, 170 CATALOG, 30, 131 CAVOLUME, 99, 170 CIREPORT, 99, 171 CISIZE, 31, 131, 150 CISIZEINDEX, 31

Index

224

CREATED, 31 CYLINDERS, 131 DEFOUT, 131 DELETED, 32 DELETEDINDEX, 32 DEVICETYPE, 32, 132 DSSTATDD, 32, 100, 172 DSWAIT, 33 DUPKEYS, 132 EMPTY, 33 ERASE, 33 EXCPRATIO, 33 EXCPRATIOINDEX, 34 EXCPS, 34 EXPIRED, 35 FREECYLS, 35 FREECYLSDATA, 35 FREECYLSINDEX, 35 FREERECORDS, 132 FREESPACE, 36, 132, 151 FREETRKS, 36 FREETRKSDATA, 36 FREETRKSINDEX, 36 FROM, 172 FULL, 37 IMBED, 37, 133 INDEXLEVELS, 37 INSERTED, 37 KEYRANGE, 38 KEYS, 133 LASTUPDATED, 38 LIST command, 29 LISTTOTALS, 38 MODEL command, 125 NAME, 38, 102, 133, 173 NODETAIL, 39 NODSWAIT, 39 NOERASE, 39 NOIMBED, 39, 133 NOKEYRANGE, 40 NONSPANNED, 40, 134 NONUNIQUEKEY, 40 NOREPLICATE, 40, 134 NOREUSE, 40 NOSWAP, 41 NOTUSABLE, 41 NOUPDATE, 41 NOWRITECHECK, 41

OWNER, 42 PHYRECSZ, 42 PROCMODE, 134 RANGETOTALS, 42 READ, 42 READINDEX, 43 RECORDS, 43, 134 RECORDSINDEX, 43 RECOVERY, 43 RECSIZE, 135 RECTOTALS, 44 REORGANIZATION, 152 REPLICATE, 44, 135 REUSE, 44 SAVE, 44 SHAREOPTIONS, 45, 135 SPACE, 152 SPANNED, 45, 136 SPEED, 45 STAGE, 45 SUBALLOCATE, 46 SWAP, 46 TEMPEXPORTED, 46 TO, 173 TOTALCYLS, 46 TOTALCYLSDATA, 47 TOTALCYLSINDEX, 47 TOTALTRKS, 47 TOTALTRKSDATA, 47 TOTALTRKSINDEX, 48 TRACKS, 136 TRKSCA, 48 TRKUTIL, 48 TYPE, 48, 136 UNIQUE, 49 UNIQUEKEY, 40, 49 UNORDERED, 41, 49 UPDATE, 49 UPDATED, 50 UPDATEDINDEX, 50 USEDCYLS, 50 USEDCYLSDATA, 50 USEDCYLSINDEX, 51 USEDTRKS, 51 USEDTRKSDATA, 51 USEDTRKSINDEX, 51 VOLUME, 52, 136 VOLUMELIST, 52

Index

225

VSAMINDD, 102 WRITECHECK, 52

INSTALLATION checklist, 18 overview, 14

Introduction, 1 ISPF

INPUT TRACE, 22 ISPF interface

CATALOG LIST, 20

K Key

alternate index, 112 KEYRANGE REPORT

report fields, 119 Keys

average compressed keylength control area, 118 dataset, 108

modeling, 132, 133 base key length

alternate index modeling, 131

dataset modeling, 131

defined alternate index, 60 dataset, 112 ranges of, 84

high control area, 120 control interval, 120 dataset, 120

low control area, 120 control interval, 120 dataset, 120

modeling, 133 duplicate keys, 132

non-unique average occurrences, 108 maximum occurrences, 108

KSDS backup, 86 report fields, 57

total of, 80

L List

explanation, 20 ISPF interface, 20 output

example, 77 suggested uses, 21 Totals

how to generate, 38

M Messages

RELEASE 1 INPUT PARAMETER EDITING, 201

VSUM-ERR000, 201 VSUM-ERR001, 203 VSUM-ERR002, 203 VSUM-ERR003, 203 VSUM-ERR004, 203 VSUM-ERR007, 203 VSUM-ERR008, 203 VSUM-ERR009, 204 VSUM-ERR011, 204 VSUM-ERR013, 204 VSUM-ERR014, 204 VSUM-ERR096, 204 VSUM-ERR097, 205 VSUM-ERR098, 205 VSUM-ERR099, 205 VSUM-ERR102, 205 VSUM-ERR103, 206 VSUM-ERR104, 206 VSUM-ERR105, 206 VSUM-ERR106, 206 VSUM-ERR112, 206 VSUM-ERR113, 206 VSUM-ERR114, 207 VSUM-ERR115, 207 VSUM-ERR116, 207 VSUM-ERR117, 207 VSUM-ERR118, 207 VSUM-ERR119, 208 VSUM-ERR120, 208

Index

226

VSUM-ERR122, 208 VSUM-ERR123, 208 VSUM-ERR124, 208 VSUM-ERR125, 209 VSUM-ERR126, 209 VSUM-ERR806, 209 VSUM-ERR996, 209 VSUM-ERR997, 209 VSUM-ERRA01, 179 VSUM-ERRB00, 179 VSUM-ERRB01, 180 VSUM-ERRB03, 180 VSUM-ERRB04, 180 VSUM-ERRB06, 180 VSUM-ERRB07, 180 VSUM-ERRB08, 181 VSUM-ERRB09, 181 VSUM-ERRB0A, 181 VSUM-ERRB0B, 181 VSUM-ERRB0C, 181 VSUM-ERRB0D, 182 VSUM-ERRB0E, 182 VSUM-ERRB0F, 182 VSUM-ERRC01, 182 VSUM-ERRC02, 182 VSUM-ERRC03, 183 VSUM-ERRC04, 183 VSUM-ERRD01, 183 VSUM-ERRD02, 183 VSUM-ERRD03, 183 VSUM-ERRD04, 183 VSUM-ERRI01, 184 VSUM-ERRI02, 184 VSUM-ERRI03, 184 VSUM-ERRI04, 184 VSUM-ERRI05, 184 VSUM-ERRI06, 185 VSUM-ERRI07, 185 VSUM-ERRI08, 185 VSUM-ERRI09, 185 VSUM-ERRI10, 185 VSUM-ERRI11, 185 VSUM-ERRI12, 186 VSUM-ERRI13, 186 VSUM-ERRI14, 186 VSUM-ERRI15, 186 VSUM-ERRI16, 186 VSUM-ERRI17, 186 VSUM-ERRI18, 187

VSUM-ERRI19, 187 VSUM-ERRI20, 187 VSUM-ERRI21, 187 VSUM-ERRI22, 187 VSUM-ERRI23, 187 VSUM-ERRI24, 188 VSUM-ERRI26, 188 VSUM-ERRI27, 188 VSUM-ERRI28, 188 VSUM-ERRI29, 188 VSUM-ERRI30, 189 VSUM-ERRI31, 189 VSUM-ERRI32, 189 VSUM-ERRI33, 189 VSUM-ERRI34, 189 VSUM-ERRI35, 190 VSUM-ERRI37, 190 VSUM-ERRI38, 190 VSUM-ERRI39, 190 VSUM-ERRI40, 190 VSUM-ERRI41, 191 VSUM-ERRI42, 191 VSUM-ERRI43, 191 VSUM-ERRI44, 191 VSUM-ERRI45, 191 VSUM-ERRI46, 191 VSUM-ERRI47, 192 VSUM-ERRI48, 192 VSUM-ERRI49, 192 VSUM-ERRI50, 193 VSUM-ERRI51, 193 VSUM-ERRI52, 193 VSUM-ERRI53, 193 VSUM-ERRI54, 193 VSUM-ERRI55, 193 VSUM-ERRI56, 194 VSUM-ERRI57, 194 VSUM-ERRI58, 194 VSUM-ERRI59, 195 VSUM-ERRI60, 195 VSUM-ERRL01, 195 VSUM-ERRL02, 196 VSUM-ERRL03, 196 VSUM-ERRL04, 196 VSUM-ERRL06, 196 VSUM-ERRL07, 196 VSUM-ERRM01, 197 VSUM-ERRM02, 197 VSUM-ERRM03, 197

Index

227

VSUM-ERRM05, 197 VSUM-ERRM12, 197 VSUM-ERRM13, 197 VSUM-ERRM14, 198 VSUM-ERRM15, 198 VSUM-ERRM16, 198 VSUM-ERRM17, 198 VSUM-ERRM18, 198 VSUM-ERRM19, 199 VSUM-ERRM20, 199 VSUM-ERRM21, 199 VSUM-ERRM22, 199 VSUM-ERRM23, 199 VSUM-ERRM24, 200 VSUM-ERRR01, 200 VSUM-ERRR02, 200 VSUM-ERRR03, 200 VSUM-ERRR04, 200 VSUM-ERRR06, 201 VSUM-ERRR07, 201 VSUM-ERRR08, 201 VSUM-MSG, 177, 178 VSUM-WARNING, 179

Mixed mode processing buffer recommendations, 161 modeling, 134

MODEL parameter abbreviations, 217 Modeling

alternate index, 122 base cluster name, 130 base key length, 131 catalog name, 131 control interval size, 142 cylinders required, 143 description, 122 device type, 132, 143 duplicate keys, 132 entry sequence dataset, 122 examples, 137 free control intervals, 143 free records, 132 freespace, 132 generating IDCAMS define parameters, 131 high level index records, 144 imbedded indexes, 133 index levels, 144 keyed sequence dataset, 122 keys, 133

physical record size, 143 processing mode, 134 records

free control area, 144 control interval, 143 dataset, 144

loaded control area, 143 control interval, 143 dataset, 144

total, 143 control area, 143 control interval, 143 dataset, 144

relative record dataset, 122 replicated indexes, 135 shareoptions, 135 spanned datasets, 136 suggested uses, 124 track utilization percentage, 143 tracks

required, 143 warnings

bufferspace, 145 freespace, 144 imbed, 144 replicate without imbed, 144 tracks per ca, 144

MODELING REPORT example

KSDS, 139

N New device type

recommendations, 161 Non-spanned datasets

modeling, 134 NONVSAM


P PAGESPACE

Index

228

report fields, 64 partial dsname, 38 PATH

attributes upgrade, 70


Physical record size catalog searching, 42

R RANGETOTALS list

how to generate, 42 RBA

high allocated data component, 62, 68, 114 index component, 62, 114

high used data component, 62, 68, 114 index component, 62, 114

Recommendations buffers, 150, 161

direct processing, 161 mixed mode processing, 161 sequential processing mode, 161

control area splits, 160 control interval size, 162 control interval sizes, 150 dataset attributes, 149 description, 146 ERASE attribute, 159 freespace, 151, 160, 162 full datasets, 160 IMBED attribute, 160 RECOVERY attribute, 159 REORGANIZATION, 152 REPLICATE attribute, 160 secondary allocation, 161 SHAREOPTION, 160 space, 152, 163

growth rate, 152 new device type, 161

WRITECHECK attribute, 159 RECOMMENDATIONS

input examples, 154

suggested uses, 147 Record Size

average calculated control area, 118 control interval, 120 dataset, 108

Average Defined alternate index, 60 dataset, 112 ESDS, 66 KSDS, 60 ranges of, 84 RRDS, 66

maximum calculated control area, 118 control interval, 120 dataset, 108

Maximum Defined alternate index, 60 dataset, 112 ESDS, 66 ranges of, 83 RRDS, 66

Maximum Defined, 60 modeling, 135

average, 135 maximum, 135

physical, 62, 67, 114, 143 modeling, 143 ranges of, 84

RECORD TOTALS report fields, 81

Records free

control area, 117, 118, 144 control interval, 120, 143 dataset, 108, 144 modeling, 132

loaded control area, 143 control interval, 143 dataset, 144

modeling, 134 used

index component high level, 110 sequence set, 111

Records Deleted

Index

229

data component, 62, 68, 81, 114 dataset catalog searching, 32 index catalog searching, 32 index component, 62, 81, 114

Records Inserted data component, 62, 67, 81, 114 dataset

catalog searching, 37 index component, 62, 81, 114

catalog searching, 37 Records Read

data component, 62, 68, 81, 114 dataset

catalog searching, 42 index


Records Total control area, 116, 118, 143 control interval, 120, 143 data component, 62, 67, 81, 114, 143

modeling, 143 dataset, 108, 144

catalog searching, 43 index


Records Updated data component, 50, 62, 68, 81, 114 index component, 50, 62, 81, 114

RECOVERY recommendations, 159

RECTOTALS list how to generate, 44

Relative byte address high allocated

data component, 62, 68, 114 index component, 62, 114

high used data component, 62, 68, 114 index component, 62, 114

Reorganization recommendations, 160

Replicate modeling

warning, 144 REPLICATE

modeling, 135

recommendations, 160 Report fields

CONTROL INTERVAL REPORT, 120 KEYRANGE REPORT, 119 List

ALIAS, 74 alternate index, 57 BUFFERTABLE, 77 BUFFERTABLE TOTALS, 79 DATASET RANGES, 82 DATASET TOTALS, 80 ESDS, 64 GDGBASE, 75 KSDS, 57 NONVSAM, 71 PATH, 69 RECORD TOTALS, 81 RRDS, 64 VOLUME, 72 VOLUME TOTALS, 84

REPRINT control area graph

controlling lines per page, 168 how to specify, 168 limiting control areas analyzed, 170 limiting control areas printed, 168 overlay of graph output, 168

control area report controlling lines per page, 168 how to specify, 169 limiting control areas analyzed, 170 limiting control areas printed, 168

control area statistics how to specify, 170

control interval report controlling lines per page, 171 how to specify, 171 limiting control areas printed, 171

limiting control areas analyzed, 167 overview, 165 report descriptions, 176 suggested uses, 166

REPRINT parameter abbreviations, 218 RRDS


Index

230

S Saving statistics

control area, 96 control interval, 99 dataset, 100

Saving Statistics from LIST, 44 Secondary allocation

data component, 64, 69, 115 index component, 64, 115 recommendations, 161

Sequential processing mode buffer recommendations, 161 modeling, 134

Shareoptions, 45, 62, 67, 114 recommendations, 160

SHAREOPTIONS modeling, 135

Skip sequential processing buffer recommendations, 161

Space allocated

data component, 63, 68, 115 index component, 63, 115 VOLUME TOTALS, 85

defined data component, 63, 68, 115 index component, 63, 115

free data component, 63, 68, 109, 115 dataset, 107 index component, 63, 110, 115

sequence set, 111 VOLUME TOTALS, 85

recommendations, 152, 163 records, 163 required for a new device, 163 total

dataset, 108 used, 163

data component, 63, 68, 109, 115 dataset, 107 index component, 63, 110, 115

sequence set, 110 VOLUME TOTALS, 85

Spanned datasets modeling, 136

Statistical file control area statistics

how to save, 96 how to specify, 98

control interval statistics how to save, 99

dataset statistics how to save, 100 how to specify, 100 how to specify for REPRINT, 172

Statistical files allocating, 16 record sizes, 17 space requirements, 17

Suggested Uses ANALYZE, 88 LIST, 21 MODEL, 124 RECOMMENDATIONS, 147 reprint, 166

Suppressing LIST output, 39 syntax checking, 7

T Timestamp

VOLUME, 73 Total datasets

BUFFERTABLE, 79 Total highlevel index

BUFFERTABLE, 79 Total I/O requests

BUFFERTABLE, 78 Totals

BUFFERTABLE report fields, 79

DATASET RANGES report fields, 82

DATASET TOTALS report fields, 80

VOLUME TOTALS report fields, 84

TOTALS RECORD TOTALS

report fields, 81 Tracks

allocated

Index

231

cluster, 47 data component, 47, 63, 68, 115 index component, 48, 63, 115 VOLUME TOTALS, 85

defined, 63, 68, 115 free

cluster, 35, 36 data component, 36, 63, 68, 115 index component, 36, 115 index component, 63 VOLUME TOTALS, 85

modeling, 136 number imbedded

index component, 116 number per ca, 61, 67, 113

modeling warning, 144

per control area catalog searching, 48

required data component, 143

modeling, 143 used

data component, 63, 68, 115 index component, 63, 115 VOLUME TOTALS, 85

used,cluster, 50, 51 used,data component, 50, 51 used,index component, 51 utilization percentage, 62, 67, 114

catalog searching, 48 modeling, 143 ranges of, 84

Tuning buffers, 150 dataset attributes, 149

U Update inhibit catalog indicator, 49

V Volume

candidate, 64, 69, 116 data component, 63, 69, 115 index component, 63, 115 List

data component, 64, 69, 116 how to generate, 52 index component, 64, 116

NONVSAM, 75 VOLUME TOTALS, 85

VOLUME attributes

bytes per track, 73 maximum blocksize

device, 73 total cylinders, 73 tracks per cylinder, 73

report fields, 72 VOLUME TOTALS

report fields, 84 VVDS

report fields, 64

W Warnings

modeling bufferspace, 145 freespace, 144 imbed, 144 replicate without imbed, 144 tracks per ca, 144

WRITECHECK recommendations, 159

vsum for z/os 5.2.1 program description and operations

Documents