restricted rights legend

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. and may not be used in any way without written authorization from Connectivity Systems, Inc.. This material may not be reproduced, in whole or in part, in any way, without prior written permission from Connectivity Systems, Inc.. 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/or promotion of Connectivity Systems, Inc.’s VSUM for VSE product or in accordance with a license agreement.

Published by Connectivity Systems, Inc. 8120 State Route 138, Williamsport OH 43164 Phone: 800-795-4914 Fax: 740-986-6022

E-Mail: [email protected]

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

Copyright © 2005 by Connectivity Systems, Inc.

VSUM for VSE Program Description and Operations Version 1 Release 1B

2nd Edition—April 2005

Table of Contents

Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1.1Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1VSUM Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3

Catalog List/Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3Modeling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3ANALYZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4Recommendations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4Reprint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4

Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2.1Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.1

Step 1: Prepare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.1Step 2: Process the VSUM Product Tape. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.2Step 4: Authorize VSUM for Use in Your Organization. . . . . . . . . . . . . . . . . . . . . . . . 2.3Step 5: Define VSUM As a VTAM Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.3Step 6: Define Statistical Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.3

Online Execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.5

Batch Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.1Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3.1

Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3.1Sub-parameter descriptions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3.2Batch Execution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3.4Optional DLBL/EXTENT Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3.5

Catalog List/Search. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.1Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.1Suggested Uses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.2Command and Online Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.3

Batch Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.3Online Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.3Batch Command Input. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.4LIST Parameter Descriptions—Batch and Online . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.5ANALYZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.5

Copyright © 2005 by Connectivity Systems, Inc.i

Program Description and Operations VSUM for VSE T able of Contents

BIND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.6BKUPDD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.6BUFFERTABLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.6CANDIDATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.7CASPLITS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.7CATALOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.7CISIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.7CISIZEINDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.8CISPLITS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.8CREATED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.8DELETED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.9DELETEDINDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.9DEVICETYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.10DSSTATDD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.10DSWAIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.10EMPTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.10ERASE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.10EXCPRATIO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.11EXCPRATIOINDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.11EXCPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.12EXCPSINDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.12EXPIRED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.12FREECYLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.13FREECYLSDATA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.13FREECYLSINDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.13FREESPACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.14FREETRKS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.14FREETRKSDATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.14FREETRKSINDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.15FULL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.15IMBED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.15INDEXLEVELS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.15INSERTED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.16INSERTEDINDEX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.16KEYRANGE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.16LASTUPDATED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.17LISTTOTAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.17NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.17NODETAIL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.18NOERASE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.18NOIMBED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.18NOKEYRANGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.18NONSPANNED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.19NONUNIQUEKEY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.19

Copyright © 2005 by Connectivity Systems, Inc.ii

Program Description and Operations VSUM for VSE Table of Contents

NOREPLICATE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.19NOREUSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.19NOTUSABLE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.20NOUPDATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.20NOWRITECHECK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.20ORDERED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.20OWNER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.20PHYRECSZ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.21RANGETOTALS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.21READ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.21READINDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.22RECOMMENDA-TIONS(…). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.22RECORDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.22RECORDSINDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.23RECOVERY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.23RECTOTALS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.23REPLICATE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.24REUSE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.24SAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.24SECALLOCATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.24SHAREOPTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.25SPANNED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.25SPEED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.25SUBALLOCATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.25TEMPEXPORTED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.25TOTALCYLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.26TOTALCYLSDATA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.26TOTALCYLS-INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.26TOTALTRKS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.27TOTALTRKSDATA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.27TOTALTRKS-INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.27TRKSCA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.28TRKUTIL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.28TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.28UNIQUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.29UNIQUEKEY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.29UNORDERED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.29UPDATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.29UPDATED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.30UPDATEDINDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.30USEDCYLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.30USEDCYLSDATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.31USEDCYLSINDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.31USEDTRKS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.31

Copyright © 2005 by Connectivity Systems, Inc.iii


USEDTRKSDATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.32USEDTRKSINDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.32VOLUME. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.32VOLUMELIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.32WRITECHECK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.33

Examples of Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.34List a Single Catalog Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.34List a Partial/Generic Name with Certain Attributes . . . . . . . . . . . . . . . . . . . . . . . . 4.34List All KSDS’S Containing 1 or More Free Cylinders . . . . . . . . . . . . . . . . . . . . . . 4.34List All KSDS’S with Secondary Allocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.34List All ESDS’S That Are 25 Percent Full. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.35List All KSDS’S with 10 or More CA SPLITS and Do Automatic Analysis . . . . . . . 4.35Determine CICS LSR Requirements by Printing a BUFFERTABLE Report . . . . . . 4.35List All Volumes Defined in a Catalog and Show the VSAM Space- Total, Used, and Free Tracks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.35List All VSAM Datasets in a Catalog and Save the Statistics Produced . . . . . . . . . . 4.36List All VSAM Datasets in a Catalog and Save the Statistics Produced . . . . . . . . . . 4.36VSUMDRD Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.36

Output Examples and Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.38. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .VSAM KSDS/AIX/UCAT Entries 4.38. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Batch Output 4.38Online Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.39Field Descriptions: KSDS/AIX Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.40Field Descriptions: Define Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.41Field Descriptions: Catalog Information: Data | Index Components. . . . . . . . . . . . 4.43VSAM ESDS/RRDS/VVDS/PAGE Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.45Field Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.46ESDS/RRDS Entry Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.46Field Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.47Path Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.50TField Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.50Volume Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.51Field Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.52

VSAM Buffertable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.54Buffer Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.54Buffer Totals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.56Buffer Total Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.56

Total Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.58Dataset Totals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.58Dataset Total Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.58VSAM Record Totals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.58VSAM Datasets Ranges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.59VSAM Dataset Ranges Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.60

Copyright © 2005 by Connectivity Systems, Inc.iv


VSAM Volume Totals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.61

Dataset ANALYZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.1Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.1

Suggested Uses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.1Command and Online Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.3

Batch Command Input. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.3Dataset Analysis Report Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.3Dataset Analysis Reporting Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.3Abbreviations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.4

ANALYZE Parameter Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.5CACOUNT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.5CAEND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.5CAGRAPH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.5CAREPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.7CASAMPLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.9CASTART. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.9CASTATDD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.9CAVOLUME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.10CIREPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.10DSREPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.11DSSTATDD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.12FREERCSZ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.12KRREPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.13RECOMMENDA-TIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.14STATEXIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.14

Examples of Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.15Analyze a Complete KSDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.15Analyze and Graph Area Usage for a KSDS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.15Analyze a Single Volume of a KSDS and Save Statistics . . . . . . . . . . . . . . . . . . . . . . 5.15Analyze a KSDS and Make Recommendations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.15Analyze a Control Area and Print a Control Interval Report . . . . . . . . . . . . . . . . . . 5.15Analyze a User Catalog’s Space Utilization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.16

Output Examples and Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.17Report Headings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.17Report Headings Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.17

Space Utilization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.19

CLUSTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.19Control Area Graph . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.28

Field Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.28Control Area Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.30

Copyright © 2005 by Connectivity Systems, Inc.v


Field Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.30Control Interval Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.33

Dataset Modeling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.1Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.1

Suggested Uses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.2Command and Online Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.3Batch Command Input. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.4Online Input Panels. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.4Design KSDS Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.5

MODEL Parameter Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.8ABBREVIATIONS: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.8BASECLUSTER-NAME. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.8ALLCISIZES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.8BASEKEYLN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.8CATALOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.8CISIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.9CYLINDERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.9DEFOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.9DEVICETYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.10FREERECORDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.10FREESPACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.11IMBED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.11KE YS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.11NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.12NOIMBED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.12NONSPANNED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.12NOREPLICATE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.12PMODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.13RECORDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.13RECSIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.14REPLICATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.14SHAREOPTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.14SPANNED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.15TRACKS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.15TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.15VOLUME. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.16

Examples of Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.17Model a KSDS with Free Records On a 3380 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.17Model an AIX with Non-Unique Keys On a 3350 . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.17Model an RRDS On a 3330 for Mixed Mode Processing . . . . . . . . . . . . . . . . . . . . . 6.17

Copyright © 2005 by Connectivity Systems, Inc.vi


Output Example and Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.18KSDS Dataset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.18Model Report for KSDS Dataset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.19AIX Dataset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.20Model Report for AIX Dataset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.20Model Report for ESDS Dataset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.21RRDS Dataset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.21Model Report for RRDS Dataset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.21Field Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.22

Dataset Recommendations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.1Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.1

VSAM Dataset Monitoring and Tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.1Suggested Uses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.1Command and Online Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.2Batch Command Input. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.2Online Input Panels. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.3Abbreviations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.3Recommendations Parameter Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.3ALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.3ATTRIBUTES. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.3BUFFERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.4CISIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.4FREESPACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.5NEWDEVICE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.6REORGANIZA-TION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.6SPACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.7Examples of Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.7Output Examples and Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.8Online Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.9Field Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.10

Messages and Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8.1Condition Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8.1Abend Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8.1

Reprint of Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9.1Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.1

Suggested Uses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.1Command Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.2ABBREVIATIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.2

REPRINT Parameter Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.3

Copyright © 2005 by Connectivity Systems, Inc.vii


CACOUNT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.3CAEND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.3CAGRAPH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.3CAREPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.5CASTART. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.6CASTATDD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.6CAVOLUME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.7CIREPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.7DSREPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.8DSSTATDD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.8FROM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.8KRREPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.8NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.9TO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.9RECOMMENDA-TIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.9

Examples of Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.11Reprint a KSDS Dataset Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.11Reprint DSReport and Control Area Graph for a KSDS. . . . . . . . . . . . . . . . . . . . . . 9.11Reprint DSReport and CAReport for Single Volume of a KSDS . . . . . . . . . . . . . . . . 9.11Reprint DSReport and Make Recommendations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.11Reprint a KSDS and Make Recommendations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.12Reprint a KSDS Dataset Reports for 1/1/20047 to 2/1/2004 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.12Output Examples and Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.12

VSUM Online Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10.1Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.1VSUM Online Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.2

Primary Option Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.2List and Search Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.3

List Selection Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.3List All Datasets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.5List VSAM Datasets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.6List KSDS Datasets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.7List ESDS Datasets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.9List RRDS Datasets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.10List AIX Datasets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.12List Path Type Datasets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.13

Designing Datasets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.15Design Selection Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.16Design KSDS Datasets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.19Design AIX Dataset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.21

Copyright © 2005 by Connectivity Systems, Inc.viii


Designed ESDS Datasets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.24Design RRDS Datasets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.24Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.26Dataset Analysis Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.26VSUM Dataset Design Profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.30Extended List Catalog Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.31Search/List Dataset Definition Parms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.32Search/List Dataset Execution Parm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.35Dataset Recommendations Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.39

Appendix A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11.1Statistical Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.1

Dataset Characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.1Space Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.1Record Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.2

Analyze Command User Exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.3

Appendix B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12.1Analyze Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.1List Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.2List Command (continued) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.3Model Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.4Recommenda-tion Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.5Reprint Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.6

Copyright © 2005 by Connectivity Systems, Inc.ix

1Getting Started

Introduction VSUM/VSE (hereafter VSUM) provides powerful design, monitoring, and tuning capabilities for VSE VSAM catalogs and datasets. VSUM provides five major functions that simplify many of the routine and complex tasks necessary for effective VSAM dataset design and management. VSUM can be executed as a VTAM APPL or as a batch job.

The five major VSUM functions are as follows:

• Extended Catalog Search/List—Provides intelligent search capabilities based on over 100 individual catalog search parameters. If DOCTOR D is installed, the LIST function can also produce the DOCTOR D JCL required to back up the selected files.

Copyright © 2005 by Connectivity Systems, Inc. 1.1

Program Description and Operations Version 1 Release 5.0 Getting Started

• Dataset Modeling and Design—Provides a simpler, more effective method for designing all types of VSAM datasets.

• Dataset Recommendations—Recommends tuning and design changes for datasets you list or analyzed.

• Dataset Space Utilization Analysis—Interrogates a complete or user-specified part of a VSAM dataset and produces a variety of valuable statistics.

• Batch Dataset Analysis Reports—Generated from statistics. VSUM can save them for later use.

VSUM saves your personnel many hours of valuable time. The hours spent scanning VSAM catalog listings and performing complex space calculations for new and existing datasets are greatly reduced. Improvements in DASD space utilization and job run performance are achieved through the efficient design and tuning of existing datasets based on VSUM’s recommendations.



VSUM Features

Catalog List/Search

Allows you to list and search catalog entries based on dataset names, types, attributes, and parameter thresholds with conditional values. This feature enables VSAM system programmers or DASD management personnel to establish VSAM dataset design criteria for an organization, and then to perform selective catalog searches to identify VSAM datasets not conforming to these criteria. VSUM also generates easy-to-read catalog lists of VSAM datasets with optional design and space utilization recommendations.

VSUM can save catalog statistics for reprinting later. Saving statistics allows you to evaluate dataset design changes over time.

For CICS users of LSR buffer pool options, there is an option to print a control interval size/buffer report. This report greatly assists system programmers with the LSR buffer pool calculations.

Modeling Permits you to experiment with dataset design parameters without performing an IDCAMS DEFINE or using DASD space. The modeling feature can describe KSDS, ESDS, RRDS, and AIX datasets. It can print space requirements, record statistics, design warnings, and IDCAMS DEFINE parameters. It can write the IDCAMS DEFINE parameters to a sequential dataset for later use.

Modeling can specify:

• Dataset space requirements in cylinders, tracks, or records

• Freespace as a percentage of bytes or free records

• Data control interval size (or have VSUM determine the best control interval size based on a processing mode of DIRECT, SEQUENTIAL, or MIXED

Modeling calculates the index control interval size, which can be influenced by using a compressed key length.

For VSAM AIX datasets, you can specify the maximum number of duplicate keys and the modeling feature will calculate the maximum record size and minimum buffer space required.

VSUM’s modeling feature is a very powerful dataset design tool that pays for itself many times over through improved programmer productivity and efficient dataset design.



ANALYZE Accurately analyzes space utilization by keyed VSAM datasets and catalogs.

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 shows whether keys are compressing poorly because of the size of the index control interval.

ANALYZE can evaluate control area and control interval freespace percentages. Control area space utilization can be graphed, showing immediately where control area splits have occurred. The graph also shows whether data control intervals have been lost because of poor key compression or to an insufficient index control interval size. The reports show whether index control intervals are too large and wasting valuable buffer storage.

VSUM can estimate the number of free records in the dataset or can estimate dataset growth in a specified key range. You can list the high and/or low keys in a dataset, or in selected control areas or control intervals. This can help determine dataset key range definitions.

Recommendations Can be requested when performing a CATALOG SEARCH/LIST or when REPRINTING dataset statistics from a VSUM statistical file. You can request recommendations for VSAM KSDS, ESDS, RRDS, and AIX datasets. VSUM recommends dataset attributes, buffer requirements based upon a processing mode, freespace, control interval size, reorganization, and space requirements for new or existing device types.

Reprint For evaluation of dataset trends and design changes, allows you to reprint catalog lists and dataset analysis reports from a VSUM statistical dataset. This function is not supported by the VSUM VTAM interface and can be performed in batch mode only.


2Installation

Procedure This section describes the installation of the VSUM product.

Installation steps are as follows;

Step 1 Prepare.

Step 2 Process the VSUM product tape .

Step 3 If one was received, process the VSUM PTF tape.

Step 4 Authorize VSUM for use in your organization.

Step 5 If online access is desired, define VSUM as a VTAM applica-tion.

Step 6 Define statistical files.

Step 1: Prepare VSUM requires 4,000 VSE/ESA library blocks.

Decide on a VSE/ESA library and sub-library to contain the VSUM modules. It is recommended, but not required, that VSUM be installed into its own sub-library. If necessary, define the lib.sublib to VSE.

VSUM is MSHP-Controlled. Decide whether to use the System History File or a Private History File.

If a new Private History File is to be used, define it. This alternatively can be done interactively during the installation process, if desired.)

Write down this information:

• VSE/ESA lib.sublib for VSUM

• If a private history file is used:


Program Description and Operations Version 1 Release 5.0 Installation

— File ID (max of 44 characters)

— Beginning track/block

— Number of tracks/blocks

• POWER USERID for SYSLST output

If your installation does not use the DEST parameter on the POWER LST JECL statement, write ‘NONE’.

The VSUM interactive installation dialog asks for the above information, so prior completion of the above entries will make the installation process easier.

Step 2: Process the VSUM Product Tape

The VSUM Product Tape is installed under control of the Maintain System History Program (MSHP).

Mount the VSUM Product Tape on a tape drive, and from the VSE console, type:

PSTART RDR,cuu

where cuu is the address of the tape drive with the mounted product tape.

A job named VSUMINST is loaded into Class 0 of the VSE/POWER reader queue. If it does not execute automatically, alter the VSE/POWER job class to allow VSUMINST to execute in a partition where the Linkage Editor can be executed.

Follow the instructions on the operator console. Use the entries completed above to assist you in answering the questions.

After the installation process has completed, remove the install tape and save it.

Step 3: Process the VSUM PTF

Tape

If present, a VSUM PTF Tape is installed under control of the Maintain System History Program (MSHP).

Mount the VSUM PTF tape on a tape drive, and from the VSE console, type:

PSTART RDR,cuu

where cuu is the address of the tape drive with the mounted PTF tape.



A job named VSUMPTF is loaded into Class 0 of the VSE/POWER reader queue. If it does not execute automatically, alter the VSE/POWER job class to allow VSUMPTF to execute in a partition where the linkage editor can be executed.

Follow the instructions on the operator console. They will be the same questions that were asked during the product tape installation.

After the installation process has completed, remove the PTF tape and save it.

Step 4: Authorize VSUM for Use in Your Organization.

Follow the directions in the authorization memorandum included in the VSUM package that you received.

Step 5: Define VSUM As a VTAM Application

If VSUM is to be used online, it must be defined to VTAM as an application (APPL).

This can be done using either of the following techniques:

• Adding this statement to an existing VBUILD TYPE=APPL

BIMVSUM APPL AUTH=ACQ

• Cataloging a “VSUM-only” VBUILD TYPE=APPL

Note The VTAM must be active before executing this script.

CATALOG xxxxxx.B xxxxxx.B VBUILD TYPE=APPL BIMVSUM APPL AUTH=ACQ /+

Step 6: Define Statistical Files

If you plan to use the historical statistical facility provided by VSUM, two (2) statistical files must be created to contain the historical VSUM data. This is optional and may be implemented at any time. The two datasets are:

• DSSTATS

• CASTATS

These files are defined as VSAM ESDS. Use the following record and block sizes when defining the files:



BLKSIZE=5500 | RECSZ (600 5492)

Space requirements for the files will vary according to which user datasets and VSUM reports are selected for processing. This chart can be used in estimating space requirements:

Important! The CIREPORT can generate a large number of records if you request that control interval statistics be saved for a large dataset or for large number of control areas.

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)



Online Execution

Defining VSUM as a VTAM APPL allows VSUM to execute as an interactive online application. After you log on to the VSUM APPL, the VSUM PRIMARY OPTION MENU is displayed. From this menu, you can select which VSUM function to perform.

This panel is displayed when a VTAM LOGAPPL (BIMVSUM) is done. The LOGMODE parameter is not used in the LOGAPPL.See "VSUM Online Interface," page 10.1, for more information on the VSUM Online panels.

------------------------ VSUM - PRIMARY OPTION MENU ---------------------------- COMMAND ==> INPUT TRACE==> NO L - SEARCH AND LIST VSAM CATALOG(S) - <<< EXTENDED SEARCH >>> D - DESIGN AND ALLOCATE VSAM DATASET(S) P - PROFILE UPDATE


3Batch Commands

Introduction The following describes how to code batch commands for VSUM. VSUM commands are submitted as SYSIPT records.

Syntax Data can be anywhere in positions 1-71 of a record.

COMMAND KEYWORD KEYWORD,KEYWORD(SUB-PARAMETERS),KEYWORD

Put comments on separate records with an asterisk (*) in position 1. They can be positioned between commands or in incomplete command records.

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

Explicitly specify the end of a command with a semicolon (;) as the last character of a command statement. Implicitly specify it by the absence of the continuation character (-).

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

Continuing a command line

Continue a command line from one record to another record after a complete KEYWORD or SUB-PARAMETER, specify a hyphen (-) in


Program Description and Operations Version 1 Release 5.0 Batch Commands

positions 1-71. The next keyword or sub-parameter can start anywhere on the next record in positions 1-71.

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

Continue a command line from one record to another record after an incomplete keyword or sub-parameter, place a non-blank character in position 72 and continue the incomplete keyword or sub-parameter in column 1 of the next record. Comments are not allowed between incomplete keyword or sub-parameter records.

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

Separating commands,

keywords, or sub-parameters

Separate commands, keywords, and sub-parameters by one or more blanks, a comma, or a comma and one or more blanks. If you specify more than one sub-parameter, you must enclose sub-parameters in parentheses. Specify keywords with one sub-parameter either in parentheses or separated by an equal sign (=). Positional keywords require a comma in place of an omitted sub-parameter if a subsequent sub-parameter is specified. Non-positional keywords are free form and do not require commas in place of omitted sub-parameters.

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

Parameter abbreviations

Most parameters have abbreviations or alternative spellings. Appendix B, "Command and Parameter Abbreviations," lists these completely. The more common abbreviations and alternative spellings are also included with each parameter description.

Any mutually exclusive parameters and default values are described with each parameter.

Sub-parameter descriptions

The following table lists VSUM sub-parameters and their descriptions.

Sub-parameter Description

dsname A valid, fully qualified dataset name.



SCAN Command Specifies to syntax-check all subsequent VSUM commands and whether to execute them.

This table describes the parameters of the SCAN command

PARM Command Specifies whether to issue a dump when a severe VSUM, operating system, or VSAM catalog error occurs.

This table describes the parameters of the PARM command.

partial dsname

A partially qualified dataset name.

catname A valid VSAM catalog name.ddname A valid DLBL name.number A valid numeric string in the range.qstring A valid quoted string that can be a character ccc or

hexadecimal x ’hhhh’. A single quotation mark in the string is specified by entering two single quotation marks.

string A valid character string not in quotation marks.volser A valid volume serial number.pct A valid numeric percentage from 1 to 100.:cond One of these logical conditionals:

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

/updatepw A valid VSAM update password./cntlpw A valid VSAM control password./masterpw A valid VSAM master password.

SCAN {OFF|ON}

Parameter Description

OFF Syntax-check and execute all subsequent VSUM commands.

ON Syntax-check but do not execute all subsequent VSUM commands.

PARM {NOABEND|ABEND}



Batch Execution VSUM batch execution is easy to set up and requires the following JCL.

// JOB ...... // LIBDEF *,SEARCH=lib.sublib (1) // EXEC VSUM command records /* /& (1) Unless the VSUM library is in the Library Search Chain

The command records specify 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 requested functions, additional DLBL/EXTENT statements may be required. These are listed on the next page.

Parameter Description

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 a dump. No subsequent VSUM commands are processed. An // OPTION PARTDUMP or // OPTION DUMP either in the job’s JCL or as a STDOPTION before the dump will be produced.



Optional DLBL/EXTENT Statements

The following JCL includes the optional DLBL/EXTENT Statements.

A N A L Y Z E F U N C T I O N // DLBL CASTATS,xxxx’ Required with CAREPORT/CAGRAPH=SAVE // DLBL DSSTATS,’xxxx’ Required with DSREPORT=SAVE L I S T F U N C T I O N // DLBL BUFPRINT,’xxxx’ Required with BFFERTABLE(ACCUM or PRINT) // DLBL DSSTATS,’xxxx’ Required with SAVE M O D E L F U N C T I O N // DLBL DEFOUT,’xxxx’ Required with DEFOUT R E P R I N T F U N C T I O N // DLBL CASTATS,’xxxx’ Required with CAREPORT/CAGRAPH=YES // DLBL DSSTATS,’xxxx’ Required with DSREPORT=YES

Filename Information Chart

FILENAME COMMAND(S) WHERE USED PROGRAM INFORMATION -------- --------------------- ------------------- RECFM LRECL BLKSIZE ----- ----- ------- BUFPRINT LIST FBA 133 DEFOUT MODEL FB 80 DSSTATS ANALYZE,LIST,REPRINT VB 5496 5500 SYSIPT ALL COMMANDS 80 SYSPRINT ALL COMMANDS FBA 133


4Catalog List/Search

Overview The VSUM LIST function provides a batch listing or an online display of datasets defined to a VSAM catalog in an easy-to-read format.

By using search parameters, you can limit output to datasets that meet user-defined criteria.

Your staff’s productivity can be increased because they will not have to visually scan catalog listings for possible problems, reorganizations, or for specific DASD. VSUM can do this automatically.

With the generic search capabilities VSUM provides, you can display all the datasets for a given application by knowing, for example, only a qualifier or a partial qualifier. If you combine the generic search capabilities with the BUFFERTABLE option, VSUM can determine LSR buffer requirements for a given application. From this, the CICS buffers can be adjusted and readied for a new or existing application.

The LIST function can also execute an automatic VSUM ANALYZE function for each VSAM KSDS dataset matching the search criteria.

VSAM datasets processed by the LIST function can have their current define and catalog statistics saved in a VSUM statistical file to be printed at a later time with the REPRINT function, or processed with a statistics program for dataset trend analysis.

If DOCTOR D is installed, the batch mode of the LIST function can also produce JCL and control statements to back up one or more selected datasets with DOCTOR D.


Program Description and Operations Version 1 Release 5.0 Catalog List/Search

Suggested Uses

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

• You can display all the entries of a specific VSAM catalog quickly and in an easy-to-read format in a batch report or in the online display panels.

• You can list datasets without having to know the entire qualified dataset name. You can use a single node, or even a partial node, for a selection criterion. Thus, you can list all files or datasets belonging to a specific application.

• If you specify VSUM’s BUFFERTABLE option, VSUM can determine LSR buffer pool size requirements automatically. Requirements can also be broken down by application with the help of the partial dataset name capability or other selection criteria.

• If you specify VSUM’s VOLUMELIST option, VSUM can determine DASD use automatically. DASD use can also be broken down by application, as with the BUFFERTABLE option. The report shows total allocated space, total used space, total free space, and total number of extents.

• VSUM can automatically notify you of the need for dataset reorganizations by setting up list search criteria based on the number of control interval splits, control area splits, secondary allocations, or percentage full.

• User-defined exception criteria, that print only datasets meeting the criteria, can eliminate unnecessary paper use when you are detecting and reporting performance or other problems.

• If you use the automatic ANAYLZE function, it eliminates the need to schedule a separate job to obtain detailed analysis after exception criteria have been satisfied. This can also help with problem analysis, since the problem does not have time to “disappear” before the schedule job is run.

• Accumulate statistical VSAM dataset catalog information for use with user-provided statistical programs to produce reports for dataset trending.



Command and Online Input

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

Batch Mode To perform this function, do one of the following:

• Specify a LIST command in a SYSIPT input statement and execute the VSUM program

• Select the BATCH processing mode of the Online LIST function

The LIST command specifies catalog search criteria and output options to use during the VSAM catalog search and list. The LIST command parameters that can be specified are described in this section.

If our DOCTOR D product is available, it can also produce JCL and control statements to back up one or more selected datasets with DOCTOR D.

Online Mode To perform the LIST function, specify “L” in the command line of VSUM’s PRIMARY OPTION MENU. This 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 Online LIST request is performed, it is translated into a VSUM command and either executed online, or submitted as a VSE/ESA batch job. VSUM displays output on your terminal, or if submitted for batch processing, prints the output on a printer.

Because of the number of Online LIST panels provided with VSUM, 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 are displayed for the LIST function. The online help panels describe all the online panels. See "VSUM Online Interface," page 10.1, for more information on the VSUM Online LIST panels.



Batch Command Input (continued)

ABBREVIATIONS: LIST can be abbreviated as L.

LIST Parameter Descriptions—Batch and Online

ANALYZE Performs an automatic VSUM dataset ANALYZE for KSDS and AIX datasets selected for processing. Refer to the section “ANALYZE Parameter Descriptions” (page 5.5) for a detailed description of ANALYZE sub parameters.

L I S T C O M M A N D K E Y W O R D S (continued) NOREUSE 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 SUBALLOCATE 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 UCAT MCAT) 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



Parameter syntax ANALYZE

BIND BIND

Define VSAME datasets with this attribute to select the dataset for processing.

Attributes Defaults: (null)

Mutually exclusive parameters: TYPE(PATH VOLUME )

BKUPDD (Batch mode only) Generates JCL and DOCTOR D control statements that can be used to backup the datasets specified on this LIST statement and creates a job in the POWER RDR queue.

Parameter syntax BKUPDD (library member name)

Variables and attributes

The variable library member name refers to a DOCTOR D backup template the user has cataloged into the VSE library where VSUM is installed as a .V member. Refer to the VSUMDRD Description section for additional information.

Note To process these statements, the DOCTOR D product must be installed.

BUFFERTABLE For datasets selected for processing.

Parameter syntax BUFFERTABLE (PRINT | ACCUM | NONE)


To bypass the BUFFERTABLE, use NONE

The datasets should have totals accumulated across VSUM commands, with ACCUM, or accumulated and printed for the current VSUM command, with PRINT.

If ACCUM is specified with no succeeding PRINT, the BUFFERTABLE report prints at the end of processing. The ACCUM and PRINT options can be used to print multiple BUFFERTABLE reports in one execution of VSUM. When you specify a ACCUM or PRINT, a DLBL/EXTENT for BUFPRINT is required.

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

Mutually Exclusive parameters: TYPE(PATH)

Abbreviations: BUFFTABLE, BUFTABLE, BUFFT, BUFT
Copyright © 2005 by Connectivity Systems, Inc.
4.6


CANDIDATE VSAM datasets that have a candidate, or empty, volume allocated to them are processed.

Parameter syntax CANDIDATE

VSAM datasets that have a candidate, or empty, volume allocated to them are processed.


Mutually exclusive parameters: TYPE(PATH)

Abbreviations: CANDT, CANDTVOL, CANDIDATEVOLUME

CASPLITS Only VSAM KSDS or AIX datasets whose CA splits are equal to or greater than the number specified are processed. If a conditional test is specified, only datasets that satisfy the test criterion are processed.

Parameter syntax CASPLITS (number [ :cond | GE ])


The number can be a valid numeric string from 0 to 99999.

Defaults: (null)

Mutually exclusive parameters: TYPE(ESDS RRDS)

Abbreviations: CASPL, CASP

CATALOG Specifies the VSAM catalog that the VSUM LIST function uses as the source for selecting datasets for processing.

Parameter syntax CATALOG (catname </masterpw])


The catalog master password, masterpw, is required when the ANALYZE parameter is specified for datasets that are control password protected and for which you do not want the operator to be prompted for the control password.

Also, if the catalog is read password protected, specify the password or the operator will be prompted for it. Catalog search time can be improved considerably when you specify a catalog.

Default catalog: MASTER CATALOG

Abbreviations: CAT

CISIZE VSAM datasets whose data components have a control size equal to the value of number specified are processed.



Parameter syntax CISIZE (number [ :cond | EQ ])


The number value must be a valid data component control interval size. If you include a conditional then VSUM LIST selects only datasets that satisfy the number and test criterion for processing.

Defaults: (null)

Mutually exclusive parameters: TYPE(PATH VOLUME)

Abbreviations: CISZD, CISIZEDATA

CISIZEINDEX VSAM KSDS or AIX datasets whose Index components have a control size equal to the value of number specified will be processed.

Parameter syntax CISIZEINDEX (number [ :cond | EQ ])


The number value must be a valid Index component control interval size. If you include a conditional, then VSUM LIST selects only datasets that satisfy the number and test criterion for processing.

Defaults: (null)

Mutually exclusive parameters: TYPE(PATH VOLUME ESDS RRDS)

Abbreviations: CISZI, CISIZEI

CISPLITS VSAM keyed datasets whose CI splits are equal to or greater than the value of number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax CISPLITS (number [ :cond | GE ])


The value of number can be a valid numeric string from 0 to 99999.

Defaults: (null)

Mutually exclusive parameters: TYPE(ESDS RRDS PATH VOLUME)

Abbreviations: CISPL, CISP

CREATED Specifies the creation date selection criteria for datasets to be processed. If you specify a conditional test, VSUM LIST selects datasets whose creation date meet the test criterion for processing.



Parameter syntax CREATED (mmddyyyy | mm/dd/yyyy | yyyyddd | < [:cond | :GE ])


The variables, mm, dd, and yyyy represent the month, day of the month, and year the file was created. The variable, ddd, represents the day of the year that the file was created.

Defaults: (null)

Mutually exclusive parameters: TYPE(VOLUME)

Abbreviations: CRDATE, CRDT, CREATIONDATE

DELETED Datasets with data component DELETED record statistics equal to or greater than the value of number specified will be processed.

Parameter syntax DELETED (number [ :cond | GE ])


If you specify a conditional test, only datasets that satisfy the test criterion will be processed. The number value can be a valid numeric string from 0 to 999999999.

Defaults: (null)


Abbreviations: DELTDATA, DELTD, DELETEDATA

DELETEDINDEX Datasets with Index component record DELETED statistics equal to or greater than the value of number specified will be processed. If a conditional test is specified, only datasets that satisfy the test criterion will be processed.

Parameter syntax DELETEDINDEX (number [ :cond | GE ])


The number value can be a valid numeric string from 0 to 999999999.

Defaults: (null)

Mutually Exclusive parameters: TYPE(PATH VOLUME ESDS RRDS)

Abbreviations: DELETEDI, DELTINDEX, DELTI



DEVICETYPE Specifies the device type selection criteria that VSUM LIST uses to determine which datasets to process. Only datasets defined on the specified device type are selected for processing.

Parameter syntax DEVICETYPE(3390 | 3380 | 3375 | 3350 | 3340 | 3330)


Mutually exclusive parameters: TYPE(PATH UCAT)

Abbreviations: DEVTYPE, DEVTYP, DEVT

DSSTATDD The DLBL File Name of the dataset statistics file, if a name other than DSSTATS is desired.

Parameter syntax DSSTATDD (ddname | DSSTATS [/updatepw])


If the dataset associated with the related ddname is password protected for update then you must also specify that password. This parameter is required when you specify SAVE or ANALYZE DSREPORT(SAVE).

Defaults: DSSTATS

Abbreviations: DSSTDD, DSDD

DSWAIT Define VSAM datasets with this attribute to select the dataset for processing.

Parameter syntax DSWAIT

Attributes Default: (null)


Abbreviations: DSW, DESTAGEWAIT

EMPTY Select empty VSAM datasets for processing.

Parameter syntax EMPTY


Mutually exclusive parameters: FULL TYPE(PATH VOLUME)

ERASE Define VSAM datasets with this attribute to select the dataset for processing.



Parameter syntax ERASE



Abbreviations: ERA

EXCPRATIO VSAM datasets with a DATA component EXCP-to-I/O ratio equal to or greater than the value of number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax EXCPRATIO (number [ :cond | GE ])

Variables and Attributes

The number value can be a valid numeric string from 0 to 999. The EXCP to I/O ratio represents the average number of EXCPs issued for each logical I/O request and is calculated as follows:

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

Defaults: (null)


Abbreviations: EXCPRD, EXCPRATIODATA

EXCPRATIOINDEX VSAM datasets with an Index component EXCP-to-I/O ratio equal to or greater than the value of number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax EXCPRATIOINDEX (number [ :cond | GE ])


The number value can be a valid numeric string from 0 to 999. The EXCP to I/O ratio represents the average number of EXCPs issued for each logical I/O request and is calculated as follows:

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

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

Important! VSUM uses the DATA component RECORDS, READ, UPDATED, and DELETED values 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 VSAM datasets with DATA component EXCP statistics equal to or greater than the value of number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax EXCPS (number [ :cond | GE ])

Variable and attributes


Defaults: (null)


Abbreviations: EXCP, EXCPSDATA, EXCPSD

EXCPSINDEX VSAM datasets with Index component catalog record EXCP statistics equal to or greater than the value of number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax EXCPSINDEX (number [ :cond | GE ])



Defaults: (null)


Abbreviations: EXCPINDEX, EXCPSI

EXPIRED Specifies the expiration date selection criteria for datasets to be processed. If you specify a conditional test, VSUM LIST selects datasets whose expiration date meet the test criterion for processing.

Parameter syntax EXPIRED(MMDDYYYY MM/DD/YYYY YYYYDDD [ :cond | GE ])


The variables, mm, dd, and yyyy represent the month, day of the month, and year that the file expires. The variable, ddd, represents the day of the year that the file expires.



Defaults: (null)


ABBREVIATIONS: EXPDATE, EXDT, EXPIRATIONDATE

FREECYLS VSAM datasets with data and index (keyed) components free cylinders equal to or greater than the value of number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax FREECYLS (number [ :cond | GE ])


The value of number can be a valid numeric string from 0 to 999999.

Defaults: (null)


Abbreviations: FCYLS, FREECYLINDERS

FREECYLSDATA VSAM datasets with data component free cylinders equal to or greater than the value of number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax FREECYLSDATA (number [ :cond | GE ])



Defaults: (null)


Abbreviations: FCYLSD, FCYLSDATA, FREECYLINDERSDATA

FREECYLSINDEX VSAM datasets with Index component free cylinders equal to or greater than the value of number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax FREECYLSINDEX (number [ :cond | GE ])



Defaults: (null)




Abbreviations: FCYLSI, FCYLSINDEX, FREECYLINDERSINDEX

FREESPACE VSAM keyed datasets with a defined CI and/or CA FREESPACE percentage equal to the percentage specified are processed. If you include a conditional, VSUM LIST selects only datasets satisfying the percentage and test criterion for processing.

Parameter syntax FREESPACE (cipct < :cond | EQ > capct < :cond | EQ ])



Abbreviations: FSPC

FREETRKS VSAM datasets with Data and Index component free tracks equal to or greater than the value of number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax FREETRKS (number [ :cond | GE ])



Defaults: (null)


Abbreviations: FTRKS, FREETRACKS

FREETRKSDATA VSAM datasets with data component free tracks equal to or greater than the value of number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax FREETRKSDATA (number [ :cond | GE ])



Defaults: (null)


Abbreviations: FTRKSD, FREETRACKSDATA



FREETRKSINDEX VSAM datasets with index component free tracks equal to or greater than the number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax FREETRKSINDEX (number [ :cond | GE ])


The number can be a valid numeric string from 0 to 999999.

Defaults: (null)


Abbreviations: FTRKSI, FREETRACKSINDEX

FULL VSAM datasets that are FULL (HURBA=HARBA) or whose percentage of total allocated space is being used for records are selected for processing.

Parameter syntax FULL (pct < :cond | EQ ])


The variable pct represents the percentage amount that the VSAM database is full.

Defaults: (null)

Mutually exclusive parameters: EMPTY TYPE(PATH VOLUME)

IMBED VSAM keyed datasets defined with this attribute are selected for processing.

Parameter syntax IMBED


Mutually exclusive parameters: TYPE(PATH RRDS ESDS)

Abbreviations: IMB

INDEXLEVELS Datasets with Index component “INDEXLEVELS” equal to or greater than the value of number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax INDEXLEVELS (number [ :cond | GE ])





Defaults: (null)

Mutually exclusive parameters: TYPE(PATH ESDS RRDS)

Abbreviations: ILEVEL, ILVL

INSERTED Datasets with a data component “INSERTED” value equal to or greater than the value of number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax INSERTED (number [ :cond | GE ])



Defaults: (null)


Abbreviations: INSRD, INSERTEDDATA

INSERTEDINDEX Datasets with an Index component “INSERTED” value equal to or greater than the value of number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax INSERTEDINDEX (number [ :cond | GE ])



Defaults: (null)


Abbreviations: INSRI, INSERTEDI

KEYRANGE Define the VSAM keyed datasets with KEYRANGES to select the datasets for processing.

Parameter syntax KEYRANGE


Mutually exclusive parameters: TYPE(PATH VOLUME RRDS ESDS)

Abbreviations: KEYR



LASTUPDATED VSAM datasets with a last updated date (SYSTEM-TIMESTAMP) greater than or equal the specified date are processed. If you specify a conditional test, VSUM LIST selects datasets whose last updated date meet the test criterion for processing.

Parameter syntax LASTUPDATED(MMDDYYYY | MM/DD/YYYY | YYYYDDD | [ :cond | :GE ])


The variables, mm, dd, and yyyy represent the month, day of the month, and year the file was last updated. The variable, ddd, represents the day of the year that the file was last updated.

Defaults: (null)

Mutually exclusive parameters: TYPE(VOLUME PATH)

Abbreviations: LASTUP, LASTUPD

LISTTOTAL Creates a list of totals after processing.

Parameter syntax LISTTOTALS(PRINT | ACCUM | NONE)


For datasets selected for processing, set LISTTOTALS to be.

• Bypassed, with NONE

• Accumulated across VSUM commands, with ACCUM

• Accumulated and printed, with PRINT.

If you specify ACCUM without a succeeding PRINT, 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 is written to SYSLST.

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

Abbreviations: LTOT

NAME Specifies the dataset name(s) to be processed.

Parameter syntax NAME(name | partial dsname)


The dataset name can be either fully or partially qualified. If the dataset name is partial, an asterisk denotes the unqualified portions of dsname. 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 node.

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

Defaults: Complete catalog


NODETAIL Do not produce detailed VSUM printed output for any datasets selected for processing, only the dataset names.

Parameter syntax NODETAIL

Attribute Defaults: (print detail output)

NOERASE VSAM datasets with this attribute are selected for processing.

Parameter syntax NOERASE



Abbreviations: NOERA

NOIMBED VSAM keyed datasets defined with this attribute are selected for processing.

Parameter syntax NOIMBED



Abbreviations: NOIMB

NOKEYRANGE VSAM keyed datasets defined without KEYRANGES are selected for processing.

Parameter syntax NOKEYRANGE





Abbreviations: NKEYR, NOKEYR

NONSPANNED VSAM datasets defined with this attribute are selected for processing.

Parameter syntax NONSPANNED


Mutually exclusive parameters: TYPE(PATH VOLUME AIX)

Abbreviations: NONSPAN, NSPA

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

Parameter syntax NONUNIQUEKEY


Mutually exclusive parameters: TYPE(PATH VOLUME RRDS ESDS KSDS)

Abbreviations: NONUNQKEY, NUNQK

NOREPLICATE VSAM keyed datasets defined with this attribute are selected for processing.

Parameter syntax NOREPLICATE



Abbreviations: NOREPL, NOREP

NOREUSE VSAM datasets defined with this attribute are selected for processing.

Parameter syntax NOREUSE


Mutually exclusive parameters: TYPE(PATH VOLUME REUSE UNIQUE)

Abbreviations: NOREU



NOTUSABLE VSAM datasets that are flagged as NOTUSABLE in their VSAM catalog are selected for processing.

Parameter syntax NOTUSABLE



Abbreviations: NOTUS, UNUSABLE

NOUPDATE VSAM datasets with this attribute are selected for processing.

Parameter syntax NOUPDATE



Abbreviations: NOUPDAT, NOUPD

NOWRITECHECK VSAM datasets defined with this attribute are selected for processing.

Parameter syntax NOWRITECHECK



Abbreviations: NOWCK, NOWRTCHK

ORDERED VSAM datasets defined with this attribute are selected for processing.

Parameter syntax ORDERED



Abbreviations: ORDER, ORD

OWNER VSAM datasets with this OWNERID are selected for processing. The string can be any valid VSAM OWNERID.

Parameter syntax OWNER (string)





Abbreviations: OWN

PHYRECSZ Datasets with data component physical record size equal to the number specified will be processed.

Parameter syntax PHYRECSZ (number [ :cond | EQ ])


The number must be a valid VSAM block size. If you include a conditional, cond, VSUM LIST selects only datasets that satisfy the number and test criterion for processing.



Abbreviations: PHYRCSZ, PHYRCSZDATA, PHYRECORDSIZEDATA

RANGETOTALS Datasets with RANGETOTALS are:




Parameter syntax RANGETOTALS (PRINT | ACCUM | NONE)


If you specify ACCUM without a succeeding PRINT, the RANGETOTAL report is printed at end of processing. The ACCUM and PRINT options can be used to print multiple RANGETOTAL reports in one execution of VSUM. RANGETOTALS are written to SYSLST.

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

Abbreviations: RTOT, RNGTOT

READ Datasets with a data component READ value equal to or greater than the value of number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax READ (number [ :cond | GE ])





Defaults: (null)


Abbreviations: READD, READDATA

READINDEX VSAM keyed datasets with an Index component READ value equal to or greater than the value of number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax READINDEX (number [ :cond | GE ])



Defaults: (null)


Abbreviations: READI, IREAD

RECOMMENDA-TIONS(…)

Specifies types of recommendations VSUM makes about the KSDS, ESDS, RRDS, and AIX datasets selected for processing.

Parameter syntax RECOMMENDATIONS(…)

Refer to the section Dataset Recommendations for a detailed description of the RECOMMENDATIONS parameters.

RECORDS VSAM datasets with a data component RECORDS value equal to or greater than the value of number specified will be processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax RECORDS (number [ :cond | GE ])



Defaults: (null)


Abbreviations: RECSD, RECORDSDATA

RECORDSINDEX VSAM keyed datasets with index component RECORDS value equal to or greater than the number specified are processed. If you specify a



conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax RECORDSINDEX (number [ :cond | GE ])



Abbreviations: RECSI, RECSINDEX

RECOVERY VSAM datasets defined with this attribute are selected for processing.

Parameter syntax RECOVERY



Abbreviations: REC

RECTOTALS Specifies that for datasets selected for processing, the RECTOTALS are:




Parameter syntax RECTOTALS(PRINT | ACCUM | NONE )


If you specify ACCUM without a succeeding PRINT, VSUM LIST prints the RECTOTALS report at end of processing. The ACCUM and PRINT options can be used to print multiple RECTOTALS reports in one execution of VSUM. RECTOTALS are written to SYSLST.

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

Abbreviations: RECT, RECORDTOTALS

REPLICATE VSAM keyed datasets with this attribute are selected for processing.

Parameter syntax REPLICATE





Abbreviations: REPL, REP

REUSE VSAM datasets defined with this attribute are selected for processing.

Parameter syntax REUSE


Mutually exclusive parameters: TYPE(PATH VOLUME) REUSE and UNIQUE

Abbreviations: REU

SAVE Specifies to VSUM LIST to save the statistics for any KSDS, RRDS, ESDS, AIX or Catalog datasets. Saving statistics allows the list output to be reprinted with the REPRINT function at a later time.

Parameter syntax SAVE

Variable and attribute

The DLBL/EXTENT specified by the DSSTATDD parameter is required during execution.

Defaults: (no saving)

SECALLOCATION Datasets with the number of secondary allocations equal to or greater than the value of number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter sytax SECALLOCATION (number [ :cond | GE ])



Defaults: (null)


Abbreviations: SECALLOC, SECA

SHAREOPTIONS Datasets with a single CPU (value1) and multiple-CPU (value2) SHAREOPTION value are processed. If datasets with data and index components have at least one component with the specified SHAREOPTION that dataset is processed.



Parameter syntax SHAREOPTIONS (value1 value2)


The valid SHAREOPTION’s values are the same as for the IDCAMS DEFINE CLUSTER SHAREOPTIONS parameter.

Defaults: (null)


Abbreviations: SHR

SPANNED VSAM datasets defined with this attribute are selected for processing.

Parameter syntax SPANNED


Mutually exclusive parameters: TYPE(PATH RRDS)

Abbreviations: SPAN

SPEED VSAM datasets defined with this attribute are selected for processing.

Parameter syntax SPEED



Abbreviations: SPE

SUBALLOCATE VSAM datasets defined with this attribute are selected for processing.

Parameter syntax SUBALLOCATE



ABBREVIATIONS: SUB, SUBALLOC, SUBALLOCATED

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

Parameter syntax TEMPEXPORTED





Abbreviations: TEMPEXP, TEXP

TOTALCYLS VSAM datasets with total allocated cylinder value for the cluster equal to or greater than the value of number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax TOTALCYLS (number [ :cond | GE ])



Defaults: (null)


Abbreviations: TCYL, TOTCYLS, TOTALCYLINDERS

TOTALCYLSDATA VSAM datasets with a data component total allocated cylinder value equal to or greater than the value of number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax TOTALCYLSDATA (number [ :cond | GE ])



Defaults: (null)


Abbreviations: TCYLSD, TOTCYLSDATA, TOTALCYLINDERSDATA

TOTALCYLS-INDEX

VSAM datasets with an Index component total allocated cylinder value equal to or greater than the value of number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax TOTALCYLSINDEX (number [ :cond | GE ])



Defaults: (null)




Abbreviations: TCYLSI, TOTCYLSINDEX, TOTALCYLINDERSINDEX

TOTALTRKS VSAM datasets with a cluster total allocated tracks value equal to or greater than the value of number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax TOTALTRKS (number [ :cond | GE ])



Defaults: (null)


Abbreviations: TTRKS, TOTTRKS, TOTALTRACKS

TOTALTRKSDATA VSAM datasets with a data component total allocated tracks value equal to or greater than the value of number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax TOTALTRKSDATA (number [ :cond | GE ])



Defaults: (null)


Abbreviations: TTRKSD, TOTTRKSDATA, TOTALTRACKSDATA

TOTALTRKS-INDEX

VSAM datasets with an Index component total allocated tracks value equal to or greater than the value of number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.

Parameter syntax TOTALTRKSINDEX (number [ :cond | GE ])



Defaults: (null)




Abbreviations: TTRKSI, TOTTRKSINDEX, TOTALTRACKSINDEX

TRKSCA Datasets with a data component tracks per control area equal to the value of number specified are processed. If you include a conditional, VSUM LIST selects only datasets satisfying the number of tracks per CA and test criterion for processing.

Parameter syntax TRKSCA (number [ :cond | EQ ])



Abbreviations: CASIZE, TRKSPERCA

TRKUTIL Datasets with a data component physical record size and device type giving a track utilization percentage equal to or greater than the percentage, pct, specified are processed.

Parameter syntax TRKUTIL (pct [ :cond | GE ])


If you include a conditional, cond, VSUM LIST selects only datasets satisfying the percentage and the test criterion 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 Specifies the type of datasets VSUM LIST selects for processing. Use this parameter whenever possible. When types are specified, the catalog search time can be significantly decreased.

Parameter syntax TYPE(ALL | VSAM KSDS AIX RRDS ESDS PATH VOLUME UCAT MCAT)


When ALL is specified or defaulted and other search parameters are specified, only catalog entries that match the search criteria are listed. Catalog entries that are not logically related to one or more search parameters are not listed. For example, if “CASPLITS” is specified as a search criterion, only keyed entries are listed. Catalog entries that do not have “CASPLITS” such as ESDS are not listed. Type VSAM includes KSDS, AIX, and ESDS dataset types.



Defaults: TYPE(ALL)

Mutually exclusive parameters: TYPE(ALL) cannot be specified with any other TYPE combination

UNIQUE VSAM datasets defined with this attribute are selected for processing.

Parameter syntax UNIQUE


Mutually exclusive parameters: TYPE(PATH VOLUME REUSE)

ABBREVIATIONS: UNQ

UNIQUEKEY VSAM keyed datasets defined with this attribute are selected for processing.

Parameter syntax UNIQUEKEY


Mutually exclusive parameters: TYPE(PATH VOLUME RRDS ESDS KSDS)

Abbreviations: UNQKEY, UNQK

UNORDERED VSAM datasets defined with this attribute are selected for processing.

Parameter syntax UNORDERED



Abbreviations: UNORD, UNORDER, NONORDERED

UPDATE VSAM datasets defined with this attribute are selected for processing.

Parameter syntax UPDATE



Abbreviations: UPD

UPDATED VSAM datasets with data component UPDATED record value equal to or greater than the value of number specified are processed.



Parameter syntax UPDATED (number [ :cond | GE ])


If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion. The number value can be a valid numeric string from 0 to 999999999.

Defaults: (null)


Abbreviations: UPDTD, UPDATEDD, UPDATEDATA

UPDATEDINDEX VSAM keyed datasets with index component UPDATED record value equal to or greater than the value of number specified are processed.

Parameter syntax UPDATEDINDEX (number [ :cond | GE ])



Defaults: (null)


Abbreviations: UPDTI, UPDTINDEX

USEDCYLS VSAM datasets with used cylinder values for the cluster equal to or greater than the value of number specified are processed.

Parameter syntax USEDCYLS (number [ :cond | GE ])


If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion. The number can be a valid numeric string from 0 to 999999.

Defaults: (null)


Abbreviations: UCYLS, USEDCYLINDERSS

USEDCYLSDATA VSAM datasets with data component used cylinder values equal to or greater than the value of number specified are processed. If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.



Parameter syntax USEDCYLSDATA (number [ :cond | GE ])



Defaults: (null)


Abbreviations: UCYLSD, USEDCYLINDERSDATA

USEDCYLSINDEX VSAM datasets with Index component used cylinder values equal to or greater than the value of number specified are processed.

Parameter syntax USEDCYLSINDEX (number [ :cond | GE ])


If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.The number value can be a valid numeric string from 0 to 999999.

Defaults: (null)


Abbreviations: UCYLSI, UCYLSI, USEDCYLINDERSINDEX

USEDTRKS VSAM datasets with used track values for the cluster equal to or greater than the value of number specified are processed.

Parameter syntax USEDTRKS (number [ :cond | GE ])



Defaults: (null)


Abbreviations: UTRKS, USEDTRACKS

USEDTRKSDATA VSAM datasets with data component used track values equal to or greater than the value of number specified will be processed.



Parameter syntax USEDTRKSDATA (number [ :cond | GE ])


If a conditional test is specified, VSUM LIST processes only datasets that satisfy the test criterion.The number value can be a valid numeric string from 0 to 999999.

Defaults: (null)


Abbreviations: UTRKSD, USEDTRACKSDATA

USEDTRKSINDEX VSAM datasets with Index component used track values equal to or greater than the value of number specified will be processed.

Parameter syntax USEDTRKSINDEX (number [ :cond | GE ])


If you specify a conditional test, VSUM LIST processes only datasets that satisfy the test criterion.The number value can be a valid numeric string from 0 to 999999.

Defaults: (null)


Abbreviations: UTRKSI, USEDTRACKSINDEX

VOLUME Specifies the volume name entry when TYPE(VOLUME) is used to search the VSAM catalog. For TYPE(KSDS AIX RRDS ESDS), this parameter limits the listing to the dataset types defined fully or partially on the volume.

Parameter syntax VOLUME (volser)



Abbreviations: VOL

VOLUMELIST For datasets selected for processing, set volume totals to be



• Accumulated and printed, with PRINT



Parameter syntax VOLUMELIST (PRINT | ACCUM | NONE )


If you specify ACCUM without a succeeding PRINT, the VOLUMELIST report is 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 is written to SYSPRINT.

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


Abbreviations: VOLLIST, VOLL

WRITECHECK Datasets defined with this attribute are selected for processing.

Parameter syntax WRITECHECK



Abbreviations: WCHECK, WCK



Examples of Use

The following are some examples of the VSUM list facility.

List a Single Catalog Entry

Lists the dataset specified in the name parameter from the specified catalog.

Example // EXEC PGM=VSUM * LIST A DATASET EXAMPLE LIST CATALOG(YOUR.CATALOG.DSN) - NAME(YOURCAT.ANY.FILE) /*

List a Partial/Generic Name with Certain Attributes

List any dataset beginning with the character string in the name parameter that ends with an asterisk (*) from the specified catalog. If a match is found on the partial name, the attributes are checked to ensure that they also meet the input criteria.

Example // EXEC PGM=VSUM LIST CATALOG(YOUR.CATALOG.DSN) - NAME(YOURCAT.A*) - TYPE(KSDS AIX) - SUBALLOCATE - IMBED /*

List All KSDS’S Containing 1 or More Free Cylinders

List all VSAM KSDS datasets from a catalog that have more than one free (unused) cylinder. (Data and Index components combined).

Example // EXEC PGM=VSUM LIST CATALOG(YOUR.CATALOG.DSN) - TYPE(KSDS) - FREECYLINDERS(1:GT) /*

List All KSDS’S with Secondary Allocation

List all VSAM KSDS datasets from a catalog that have secondary allocations.

Example // EXEC PGM=VSUM LIST CATALOG(YOUR.CATALOG.DSN) - TYPE(KSDS) - SECALLOCATION(1:GE) /*



List All ESDS’S That Are 25 Percent Full

List all VSAM ESDS datasets from a catalog that are 25 percent full.

Example // EXEC PGM=VSUM * THIS IS A COMMENT LINE LIST CATALOG(YOUR.CATALOG.DSN) - TYPE(ESDS) - FULL(25:EQ) /*

List All KSDS’S with 10 or More CA SPLITS and Do Automatic Analysis

List all VSAM KSDS datasets that have 10 or more CA splits. When such a dataset is found, do a VSUM analysis and print the analysis report instead of printing a listing.

Example // EXEC PGM=VSUM LIST CATALOG(YOUR.CATALOG.DSN) - TYPE(KSDS) - CASPLITS(10:GE) - ANALYZE /*

Determine CICS LSR Requirements by Printing a BUFFERTABLE Report

Produce a VSUM BUFFERTABLE list of all VSAM datasets in a catalog. Listed with each dataset is its cisize, total EXCP’s, total logical I/O’s, and EXCP ratio. At the end of the report is the buffertable matrix showing the valid cisizes and how many datasets, if any, were found for each size. The normal list report is not printed this time.

Example // EXEC PGM=VSUM LIST CATALOG(YOURCAT) - TYPE(KSDS ESDS RRDS AIX) - BUFFERTABLE(PRINT) - NODETAIL /*

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

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



Example // EXEC PGM=VSUM LIST CATALOG(YOURCAT) - TYPE(VSAM) - VOLUMELIST(PRINT) - NODETAIL /*

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

The following example generates a list of all the VSAM datasets defined in a specific catalog, and saves the statistics in predefined dataset to be used at a later date or to be used in performance or capacity planning.

Example // EXEC PGM=VSUM LIST CATALOG(YOURCAT) - TYPE(VSAM) - DSSTATDD(DSSTATS) - SAVE /*

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

This example generates a list of all VSAM datasets defined in a catalog and creates a job in the POWER RDR queue with the DOCTOR D JCL and control statements required to backup the datasets. The DOCTOR D product must be available in order for these statements to be processed.

Example // EXEC PGM=VSUM LIST CATALOG(YOURCAT) - NAME(*) - BKUPDD(BACKCAT1) /*

VSUMDRD Description

If DOCTOR D is installed, the batch mode VSUM LIST function can produce JCL and control statements that can be used to backup the dataset(s) specified in the LIST function.

The user catalogs “Template” JCL into the VSUM VSE library that VSUM will use to generate the DOCTOR D job stream.

Each template must be cataloged as a .V member. There can be as many members as needed. The name of the member to be used is specified in the BKUPDD statement that is used as input to the VSUM LIST function.

An annotated example template follows:



:

Step 1 Change the name of the member to make it unique. The member type must be “V”

Step 2 Change the $$ JOB, $$ LST and // JOB statements to meet installation standards. DO NOT REMOVE the leading “$” in the $$ JOB and $$ LST statements. “CLASS” and “DISP” parameters must be present in the $$ JOB statement.

Step 3 The name of the VSE library-sublibrary where VSUM is installed. This statement is not required if the VSUM library is in the standard LIBDEF chain.

Step 4 Change the dataset name as desired. DO NOT CHANGE the TLBL name.

Step 5 Do not change the DLBL. It must have 44 “X’s” in it. VSUM will replace them with the name used in the CATALOG parameter used in the VSUM LIST parameters.

Step 6 Do not change “SA=LOC,SC=IJSYSUC”. Other parameters may be changed as desired.

Step 7 Do not change or remove “DATAHERE.”

Step 8 Do not remove the leading “$”.

(1) CATALOG BACKCAT1.V EOD=/+ R=Y (2)$ $$ JOB JNM=BACKCAT1,CLASS=A,DISP=H $ $$ LST CLASS=A,DEST=(,GJONES) / JOB BACKCAT1 // LIBDEF PHASE,SEARCH=vsumlib.sublib // TLBL TAPEOUT,’MYBACKUPTAPE’ // DLBL JSYSUC,’XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX’,,VSAM // UPSI 111 // EXEC DOCTOR D,SIZE=200K SAVE=NOP,BL=65496,UP=111,CP=YES,PR=YES SA=LO,SC=IJSYSUC,FAST=YES,PA=SE,VU=SA,AU=YE,AS=YE DATAHERE /@ /* /& $ $$ EOJ /+



-- C --VS V V REBU UNNONO AS VSVS---

Output Examples and Descriptions

VSAM KSDS/AIX/UCAT Entries

The following two examples are samples of the VSUM LIST COMMAND input and the report produced from the sample command.

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

Example description

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 through the use of the list exception criteria, the dataset shown meets all the applicable parameters.

---------------------------------------------------------------------------------------------------------------------------------- S I I N T E R N A T I O N A L VSUM CATALOG LIST PAGE=10 CAT=UCAT16 RUN DATE=07/23/1997 RUN TIME=07.50.13 RUN TYPE=NEW,LIST ---------------------------------------------------------------------------------------------------------------------------------- TAR.BOBS.OSS32.CONTROL.FILE (KSDS) CREATED=07/23/1997 EXPIRES=00/00/0000 STAR.BOBS.CONTROL.FILE.DATA (DATA) LASTUPDTE=07/UTA - UFO TRACKING STAR.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 CSZ (180 2000) FREESPACE(0 0) * TRKS/CA 12 CASPLTS 0 * TRKS/CA 1 CASPLTS 0 FSP (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 IQUE NOIMBED RECOVERY UPDATE NODSWAIT * RECORDS 105 EXCPS 1030 * RECORDS 1 EXCPS 77 REUSE NOREPL NOERASE UNQKEY STAGE * INSERTED 0 DELETED 0 * INSERTED 0 DELETED 0 SPANND NOKEYRNG NOWRTCHK UNORDERD * UPDATED 2303 READ 3107 * UPDATED 0 READ 0 * HARBA 393216 HURBA 393216 * HARBA 25600 HURBA 1024 SOCIATIONS: * 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)

UM-MSG LIST PROCESSING COMPLETED. CONDITION CODE=00000 UM-MSG PROGRAM PROCESSING COMPLETED. HIGHEST CONDITION CODE=00000 ----------------------------------------------------------------------------------------------------------------------------------



Online Output

List VSAM Dataset Information Panel

Example description

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 you press the ENTER key from this panel. The index component information panel is described on the next page.

List VSAM Dataset Information Panel

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 “Dataset Recommendations” (page 7.1) for a description of the RECOMMENDATIONS panels.

--------------- VSUM - VSAM DATASET CATALOG INFORMATION - PAGE 1-------------- COMMAND ==> SAMPLE.DATASET (KSDS) CREATED= 01/01/1997 SAMPLE.DATASET.DATA (DATA) EXPIRES= 02/06/1997 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



Field Descriptions: KSDS/AIX Information

This table describes the fields on the VSAM Dataset Catalog Information page that conatain basic informations about the datasets. These fields are on the top right side of the page.

--------------- VSUM - VSAM DATASET CATALOG INFORMATION - PAGE 2-------------- COMMAND ==> SAMPLE.DATASET (KSDS) CREATED= 01/01/1997 SAMPLE.DATASET.DATA (DATA) EXPIRES= 02/06/2006 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

Field Description

(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 appears.

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

* NOTUSABLE * | NOTUSABLE

If the dataset is flagged as NOTUSABLE, this flag appears.

* MISMATCH * | MISMATCH If the data and index component timestamps do not match, this flag appears.



Field Descriptions: Define Attributes

This tables describes the Define Attributes values on the VSAME Dataset Catalog Information page

.

Field Description

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 in 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 in the associated base cluster records.

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

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) in 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.

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.

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

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



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 key ranges.

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

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

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

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

Field Description



Field Descriptions: Catalog Information: Data | Index Components

This table describes the data and index components of the VSAM Dataset Catalog Informaiton panel.

Field Description

CISIZE Control interval size of the component.CISPLITS Number of times a control interval split

occurred.TRKS/CA Number of tracks in a control area.CASPLITS Number of times a control area split

occurred.CI’S/CA Number of control intervals in a control

area.SHR OPT The cross partition and cross system

share options.ENT/SEC Number of index entries per section in

the index component.LEVELS Number of index levels in the index

component.PHYRCSZ Size of the physical record for the

associated component.TRK-UTIL% Percentage of available bytes on a track

that can be used for control intervals.RECORDS Number of logical records in the

component.EXCPS Number of execute channel programs

issued for the component since the last define.

INSERTED Number of logical records inserted (added) to the component since the last define.

DELETED Number of logical records deleted from the component since the last define.

UPDATED Number of logical records updated in the component since the last define.

READ Number of logical records read from the component since the last define.

HARBA Highest allocated relative byte address for the component.

HURBA Highest used relative byte address for the component, rounded up to a control area boundary.



DEFCYLS/DEFTRKS Primary and secondary allocation amounts specified when the component was defined.

TOTCYLS/TOTTRKS Total number of cylinders/tracks currently allocated for the component.

USEDCYLS/USEDTRKS Total number of cylinders/tracks in the component that contains data.

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

EXCPRATIO Ratio of EXCP’s to logical I/O requests. This value can be used as a guide to determine if 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 Total number of free bytes in the data component that are in unused control areas.

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

Field Description



VSAM ESDS/RRDS/VVDS/PAGE Entries

Batch Output 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 through the use of the list exception criteria, the dataset shown met all the applicable parameters.

VOLUME DASD volume information for this component.

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

EXTS The total number of extents allocated to the component.

SEC-ALLOC Number of times that this component has gone into secondary allocation.

volser(tracks,extents | CANDT | IMB)

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.

Field Description

------------------------------------------------------------------------------------------------------------- VSAM.SAMPLE.LIST.ESDS (ESDS) CREATED=04/15/1997 EXPIRES=00/00/0000 VSAM.SAMPLE.LIST.ESDS.DATA (DATA) LASTUPDTE=05/01/1997 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.33 FREEBYTES 589824 * *------------------V O L U M E-------------------* * DEVT 3380 EXTS 1 SEC-ALLOC 0 * * VOL009(15,1) * ------------------------------------------------------------------------------------------------------------



Online Output 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.

Field Descriptions

ESDS/RRDS Entry Information

This table describes the ESDS/RRDS Entry Information fields in the VSAM Dataset Catalog Information report.

--------------- VSUM - VSAM DATASET CATALOG INFORMATION - PAGE 1-------------- COMMAND ==> SAMPLE.DATASET (ESDS) CREATED= 01/01/1997 SAMPLE.DATASET.DATA (DATA) EXPIRES= 02/06/1997 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

Fields Descriptions

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

CREATED= Date that this dataset was defined.EXPIRED= Date that this dataset is to expire.LASTUPDTE 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 appears.

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

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

* NOTUSABLE * | NOTUSABLE If the dataset is flagged as not usable, this flag appears.

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



Field Descriptions

ESDS/RRDS Entry Information

CATALOG INFORMATION

DATA COMPONENT

This table describes the Catalog Information and Data Component fields in the VSUM-VSAM Dataset Catalog Information report.

BUFSP (nnnnn) Minimum buffer space requirement defined for the dataset.

UNIQUE/SUBALLOC Dataset is defined in unique or suballocated dataspace.

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


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

ERASE/NOERASE Whether or not to overwrite the data component CIs with binary zeros when the dataset is deleted.

SPANNED/NONSPANND Whether SPANNED records are allowed to cross control interval boundaries.

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

ORDERED/UNORDERD Whether the volumes are to be used in the order specified.


ASSOCIATIONS The names of any associated alternate indexes or base clusters are listed.

Fields Descriptions

Fields Descriptions

CISIZE Control interval size of the component.TRKS/CA Number of tracks in a control area.



CI’S/CA Number of control intervals in a control area.

SHR OPT The cross partition and cross system share options.

PHYRCSZ Size of the physical record for the associated component.

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

RECORDS Number of logical records in the component.

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

INSERTED Number of logical records added to the component since the last define.

DELETED Number of logical records deleted from the component since the last define.

UPDATED Number of logical records updated in the component since the last define.

READ Number of logical records read from the component since the last define.

HARBA Highest allocated relative byte address for the component.

HURBA Highest used relative byte address for the component, rounded up to a control area boundary.



USEDCYLS/USEDTRKS Total number of cylinders/tracks in the component that contain data.

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

Fields Descriptions



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


RRDS Only:

EXCPS

------------------------------------INSERTED+READ+(UPDATED*2)+(DELETED*2)

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


FREEBYTES Number of free bytes in the data component that are in unused control areas.

VOLUME DASD volume information for this component.

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

EXTS The total number of extents allocated to the component.

SEC-ALLOC Number of times that this component has gone into secondary allocation.

Fields Descriptions



Path Entry

Batch Output 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 through the use of the list exception criteria, the dataset shown will have had to meet all the applicable parameters.

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

TField Descriptions

PATH Entry Information

This table describes the Path entry information at the top of the PATH/GDG Dataset Catalog Information panel.

volser(tracks,extents | CANDT)

The total number of tracks allocated to the volume entry and the total number of extents for the allocated tracks.

Fields Descriptions

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

---------------- VSUM - PATH/GDG DATASET CATALOG INFORMATION ------------------ COMMAND ==> DATASET NAME AND CATALOG: TYPE: SAMPLE.PATH.DATASET (PATH ) CREATED= 02/06/1997 SAMPLE.CATALOG.NAME (CATALOG) EXPIRES= 02/05/1997 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



Dataset Attributes This table describes the Dataset Attributes information on the PATH/GDG Dataset Catalog Informationpanel.

Volume Entry

Batch Output 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 has met all the applicable parameters. In order to list only a volume in 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 in order for any information to be found.

Device Characteristics

This table describes the fields in the batch output.

Field Description

(PATH) Dataset name of this path.CREATED= Date that this path was defined.EXPIRED= Date that this path is flagged to expire.** EXPIRED ** If the current date is greater than the expiration date,

this flag appears.

Field Description

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 are listed.

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

Field Description

DEVICE TYPE The DASD mnemonic device type.MAX BLKSIZE Maximum blocksize, in bytes, allowed on this

device.



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

Field Descriptions

Volume Entry Information

This table describes the Volume Entry Information fields on the report panel of the Volume Entry Catalog Information.

Device Characteristics

This table describes the Device Characteristics fields on the the Volume Entry Catalog Information report panel.

TOTAL CYLS Total number of cylinders available on this device.TRKS/CYL Number of tracks per cylinder on this device.BYTES/TRK Total number of bytes available on each track of this

device.

Field Description

----------------- VSUM - VOLUME ENTRY CATALOG INFORMATION --------------------- COMMAND ==> VOLUME NAME AND CATALOG: TYPE: VOLUME (VOLUME ) CREATED= 02/06/1997 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

Field Description

(VOLUME) DASD volume identification for this device.TIMESTAMP Date and time that the volume was defined to the

system.



Field Description

DEVICE TYPE The DASD mnemonic device type.MAX BLKSIZE Maximum blocksize, in bytes, allowed on this

device.TOTAL CYLS Total number of cylinders available on this device.TRKS/CYL Number of tracks per cylinder on this device.BYTES/TRK Total number of bytes available on each track of this

device.



D CI C C+CI C C CI V CI C C

VSAM Buffertable

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

Note This report is not available through the VSUM ONLINE LIST function.

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 through the use of the list exception criteria, the entries shown will be for datasets that have had to meet all the applicable parameters.

Buffer Report

BUFFERTABLE Report Information

CONTROL INTERVAL SIZES IN K 1 1 1 1 1 2 2 2 2 2 3 3 ATASET 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 _*_*___*_______*_______________*___*___*___*___*___*___* CSCAT.VSAM.CMASTR.AIX A ICSCAT.VSAM.CMASTR.AIX.DATA D X 15 15 1.00 ICSCAT.VSAM.CMASTR.AIX.INDEX I X 4 15 .26 CSCAT.VSAM.CMASTR.BASE K ICSCAT.VSAM.CMASTR.BASE.DATA D X 15 15 1.00 ICSCAT.VSAM.CMASTR.BASE.INDEX I X 4 15 .26 CSCAT.VSAM.FILE.DPAUDIT E SAMDSET.T25EE2F2.DFD83196.T95D8472.T25EE2F2D X 16 56 .28 CSCAT.VSAM.TEST K ICSCAT.VSAM.TEST.DT D X 15 15 1.00 ICSCAT.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

Field Description

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

• 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 data component values are used because the logical record requests for the dataset are not reflected in the index component values.

Field Description



Buffer Totals 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 through the use of the list exception criteria, the totals shown are for datasets that have met all the applicable parameters.

Buffer Total Information

Data | Index Components

This table describes the fields in the VSAM Dataset Buffer Totals report.

RATIO The ratio of EXCP’s to logical I/O requests. This value can be used as a guide to determining if the application programs processing this component are specifying insufficient buffers. 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.

Field Description

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 *------------------------------------------------*----------------------------------



Field Description

CISIZE An entry is made for each valid control interval size according to the component type such as 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 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.



Total Reports 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), and total space usage statistics for all volumes for which datasets listed were allocated (VSAM VOLUME TOTALS).

These reports are available only by BATCH execution.

Dataset Totals 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 through the use of the list exception criteria, the totals shown will be for datasets or entries that have had to meet all the applicable parameters.

Dataset Total Fields

This table describes the fields on the VSUM TOTALs report.

VSAM Record Totals

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 through the

TOTAL AIX DATASETS 0 TOTAL KSDS DATASETS 8 TOTAL ESDS DATASETS 0 TOTAL RRDS DATASETS 1 TOTAL PATH ENTRIES 0

Field Description

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 datasets encountered.

TOTAL RRDS DATASETS The total number of RRDS datasets encountered.

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



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

Data | Index Components

This table describes the fields on the VSAM Dataset Record Total report.

VSAM Datasets Ranges

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 through the use of the list exception criteria, the ranges/totals shown are for datasets that have met all the applicable parameters.

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 * * *------------------------------------------------*----------------------------------

Field Description

TOTAL RECORDS Total number of logical records occurring in all the datasets processed.

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

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

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

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

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



VSAM Dataset Ranges Information

DATA | INDEX Components

This table describes the fields on the VSAM Dataset Record Ranges Information report.

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 * * * *------------------------------------------------*----------------------------------

Field DescriptionCASPLITS

SMALLESTFewest number of control area splits occurring in any one of the datasets processed.

LARGESTLargest number of control area splits occurring in any one of the datasets processed.

TOTALTotal number of control area splits occurring in all the datasets processed.

CISPLITS

SMALLEST Smallest control interval size encountered in any one of the datasets processed.

LARGEST Largest control interval size encountered in any one of the datasets processed.

TOTAL Total number of control interval splits occurring in all the datasets processed.

EXCPRATIO

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

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

RECSZ



VSAM Volume Totals

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 use of the list exception criteria, the totals shown

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

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

IXLEVELS

SMALLEST Smallest number of index levels in the index component of any one of the datasets processed.

LARGEST Largest number of index levels in the index component of any one of the datasets processed.

TRK-UTIL%

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

LARGEST 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 Smallest defined key length encountered on any one of the datasets processed.

LARGEST Largest defined key length encountered on any one of the datasets processed.

PHYRCSZ

SMALLEST Smallest physical record size encountered on any one of the datasets processed.

LARGEST Largest physical record size encountered on any one of the datasets processed.

Field Description



will be for datasets or entries that have had to meet all the applicable parameters.

VSAM Volume Total Information

This table describes the fields on the VSAM Volume Total Information report.

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

Field Description

VOLSER DASD volume serial number.DEVTYP The mnemonic DASD device type.FREETRKS Total number of tracks on the device that are free

(contain no data).USEDTRKS Total number of tracks on the device that contains data.#EXTS Total number of extents allocated on the device.TOTTRKS Total number of tracks currently allocated on the

device.


5Dataset ANALYZE

Overview The VSUM ANALYZE function provides accurate space utilization analysis, and performance recommendations for VSAM KSDS and AIX datasets. VSAM catalogs can be analyzed for accurate space utilization only. VSUM accomplishes a truly accurate analysis through 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 the section “Dataset Recommendations” for a detailed description of the RECOMMENDATION options.

The ANALYZE function is a sub-function of the LIST function. Refer to the Catalog List/Search portion of the manual for a description of LIST.

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, key range, relative control area number(s), or control area sampling.

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 Online ANALYZE function provides you with the same capability as the batch analyze function except CI reporting and backup.

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:


Program Description and Operations Version 1 Release 5.0 Dataset ANALYZE

• Accurate display of free and used space in your VSAM catalog.

• Accurate free and used space 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.

• Detection of unusable or potentially unusable space due to 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 in existing freespace.

• Average and maximum record size calculations.

• Control area split detection by key range.

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

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




Batch Command Input

The VSUM ANALYZE function can be performed in batch or online mode.

Batch Mode A batch mode ANALYZE function can be performed by specifying the LIST ANALYZE command as an input statement and executing the program VSUM.

Online Mode A dataset may be analyzed by entering line option “A” in the VSUM Catalog Dataset Selection List. The user’s analysis profile is used to determine the report types to be produced for the dataset. These reporting selections may be changed by updating the user’s unique analysis profile and/or recommendations profile.

The selected ANALYZE reports are displayable by selection through VSUM’s DATASET ANALYSIS REPORT MENU.

Dataset Analysis Report Menu

This panel is displayed after an online analysis has been completed. The Dataset Analysis Report Menus is used to select the VSUM ANALYZE report you want displayed on your terminal. The reports are in the same format as the batch reports described later on in this section.

Dataset Analysis Reporting Options

This panel is displayed by pressing PF6 from the ANALYZE VSAM KSDS OR AIX DATASET display. It is used to specify the ANALYZE report options for the ANALYZE function.

-------------------- VSUM - DATASET ANALYSIS REPORT MENU ---------------------- COMMAND ==> C - CONTROL AREA REPORT G - CONTROL AREA GRAPH REPORT K - KEY RANGE REPORT S - SYSPRINT DATASET REPORT



Abbreviations ANALYZE may be abbreviated as ANAL

----------------- 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



ANALYZE Parameter Descriptions

CACOUNT 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.

Parameter syntax CACOUNT (number)


Mutually exclusive parameters: CAVOLUME CAEND

Abbreviations: CACNT

CAEND 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 stops after the control area that contains a key greater than or equal to the quoted string. This parameter causes a partial dataset analysis.

Parameter syntax CAEND (number | qstring)


The value for number is a numeric value from 1 to 9999999.

The value for qstring is a full or partial key value in quotation marks. The key value can be specified in character ‘character’ or hexadecimal x’hexadecimal’ format and cannot exceed 255 characters or 510 hexadecimal characters. If there are quotation marks in the key, specify two quotation marks together (‘‘) for each occurrence of a quotation mark.

Defaults: (null)

Mutually exclusive parameters: CAVOLUME CACOUNT

CAGRAPH This parameter specifies whether to print the Control Area Graph Report for the control areas that are analyzed, and whether to save the control area statistics on the dataset specified in the CASTATS parameter. Optionally, the control areas graphed can be limited to control areas that

• Are full

• Are not full



• Are empty (free)

• Have caused or were used for a control area split

• Have or may have unusable (lost) control intervals due to poor key compression or insufficient index control interval size

• Have a specified percentage of freespace available

If no LIMITING PARAMETERS are specified, all control areas analyzed are graphed.

Parameter syntax CAGRAPH (YES | NO | OVERLAY SAVE | NOSAVE FULL NOTFULL EMPTY SPLIT LOSTCI FREESPACE (pct | 0 < :cond | GE ]) LINECNT(number | 55 ))

Command Sub-parameters and

variables


YES | NO | OVERLAY Specifies whether to print the control area graph. If “YES” or “OVERLAY” is specified the control area graph is printed. “OVERLAY” causes the control interval and byte graph lines to overlay each other and decrease the number of lines in the graph by 50%. Do not specify “OVERLAY” if the CAGRAPH is going to be printed on a 3800 printer.

SAVE | NOSAVE Specifies whether to save (write) the control area statistics to the dataset specified by the CASTATDD parameter.

LINECNT(number) Specifies how many lines to print on a page before a page break. The minimum value allowed is 16, and the maximum value is 999.

Limiting Parameters

FULL Specifies to print, of the control areas analyzed, the ones that are full. A control area is full when it has no free records.

NOTFULL Specifies to print, of the control areas analyzed, the ones that are not full. A control area is not full when is has one or more free records.

EMPTY Specifies to print, of the control areas analyzed, the ones that are empty.



Attributes Abbreviations: CAG

Mutually exclusive parameters: CAREPORT, CIREPORT, KRREPORT

CAREPORT This parameter specifies whether to print the Control Area Report for the control areas that are analyzed, and whether to save the control area statistics on the dataset specified in the CASTATS parameter. Optionally, the control areas 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.

Parameter syntax CAREPORT (YES | NO | SAVE | NOSAVE FULL NOTFULL EMPTY SPLIT LOSTCIFREESPACE (pct | 0 < :cond | GE ])LINECNT(number | 55 ))

Command sub-parameters and

variables

This table describes the sub-parameters for the CAREPORT parameter and any associated variables.

SPLIT Specifies to print the control areas that are out of relative sequence. 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 splits, out-of-sequence detection is impossible, and that control area split is not detectable.Mutually exclusive parameter: CASAMPLE

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: FSPCDefaults: NO,NOSAVE,LINECNT(55)


Sub-parameters Description

YES | NO Specifies whether to print the control area report. If “YES” is specified the control area report is printed.



Attributes Defaults: NO,NOSAVE,LINECNT(55)

Abbreviations: CAR

Mutually exclusive parameters: CAGRAPH, CIREPORT, KRREPORT

SAVE | NOSAVE Specifies whether to save (write) the control area statistics to the dataset specified by the CASTATDD parameter.

LINECNT(number) Specifies how many lines to print on a page before a page break. The minimum value allowed is 16, and the maximum value is 999.

Limiting Parameters

FULL Specifies to print, of the control areas analyzed, the ones that are full. A control area is full when it has no free records.

NOTFULL Specifies to print, of the control areas analyzed, the ones that are not full. A control area is not full when is has one or more free records.

EMPTY Specifies to print, of the control areas analyzed, the ones that are empty.

SPLIT Specifies to print the control areas that are out of relative sequence. 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 splits, out-of-sequence detection is impossible, and that control area split is not detectable.Mutually exclusive parameter: CASAMPLE

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: FSPCDefaults: NO,NOSAVE,LINECNT(55)

Sub-parameters Description



CASAMPLE 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.

Parameter syntax CASAMPLE (number)


The variable number is a numeric value from 1 to 9999999.

Defaults: (null)

Mutually exclusive parameters: CAREPORT(SPLIT) CAGRAPH(SPLIT)

Abbreviations: CASAMP

CASTART This parameter specifies the first control area in the VSAM dataset to analyze. If a number is specified, the analysis starts with the control area specified. If a quoted string is specified, the analysis starts with the control area that contains a key greater than or equal to the quoted string. This parameter causes a partial dataset analysis.

Parameter syntax CASTART (number)



The variable qstring is 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 dataset.

Mutually exclusive parameters: CAVOLUME

Abbreviations: CASTRT

CASTATDD This parameter specifies the name of the DLBL 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 for a description of how to create/define the statistical files. If the same DLBL 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 DLBL name specified is different from the previous function.



Parameter syntax CASTATDD (ddname | CASTATS /updatepw)


If the statistical file is a VSAM ESDS and is update password protected, the update password should be specified

Defaults: CASTATS

Abbreviations: CASTDD, CADD

CAVOLUME This parameter specifies a single volume in a multi-volume dataset to analyze. If this parameter is specified, a partial dataset analysis is performed. When specified for a LIST function, the dataset is not analyzed if the specified volume is not defined for the dataset.

Parameter syntax CAVOLUME (volser)


Mutually exclusive parameters: CACOUNT CAEND CASTART

Abbreviations: CAVOL

CIREPORT This parameter specifies for VSAM to

• To print the CONTROL INTERVAL REPORT for selected control areas

• To save the control interval statistics on the dataset specified in the CASTATDD parameter

Note 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 is very useful in analyzing the effect of current control interval freespace if printed for one control area after records are inserted into the dataset.

Parameter syntax CIREPORT (YES | NO SAVE | NOSAVELINECNT(number | 55 )FROMCA(number | 1 COUNT(number | 1 ))


This table describes the sub-parameters and associated variables for the CIREPORT parameter.


YES | NO Indicates whether to print the control interval report.



DSREPORT This parameter specifies for VSUM to

• To print the DATASET REPORT

• To save 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 ANALYZE function or each keyed dataset selected by the LIST ANALYZE function.

Parameter syntax DSREPORT (YES | NO SAVE | NOSAVE) **Positional**

Variable This table describes the sub-parameters and associated variables for the DSREPORT parameter

SAVE | NOSAVE Indicates whether to save (write) the control interval statistics to the dataset specified by the CASTATDD parameter.

LINECNT(number) Indicates how many lines to print 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 value for number can range from 0 to 999999999.

COUNT Indicates the number of control areas that VSUM uses to produce the control interval report. The report is created for the specified number of control areas or until end of dataset or CAEND, CACOUNT, CAVOLUME. The value for number can range from 0 to 9999999.Defaults: NO, NOSAVE, LINECNT(55), FROMCA(1), COUNT(1)Abbreviations: CIR



YES | NO Indicates to VSUM to print the dataset report.



DSSTATDD This parameter specified the DLBL statement name for the dataset that VSUM uses to save the DATASET REPORT statistics for subsequent processing by the REPRINT function. Refer to Appendix A for a description of how to create/define the statistical files. If the same DLBL 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 DLBL name specified is different from the previous function.

Parameter syntax DSSTATDD (ddname | DSSTATS /updatepw)


If the statistical file is a VSAM ESDS and is update password protected the update password must be specified.

Defaults: DSSTATS


FREERCSZ The FREERCSZ parameter specifies which average record size value to use for free record calculations. VSUM uses the average record size value to estimate the number of free records in control interval freespace, free control intervals, and free control areas.

Parameter syntax FREERCSZ (DEFAVG | CALCAVG | number)


This table describes the sub-parameters and associated variables for the FREECSZ parameter

SAVE | NOSAVE Indicates to VSUM to save (write) the dataset statistics to the dataset specified by the DSSTATDD parameter.Defaults: YES,NOSAVEAbbreviations: DSRMutually exclusive parameters: CAREPORT, CAGRAPH, KRREPORT

DEFAVG Specifies to use the average record size defined for the dataset for the “ESTIMATED NO. OF FREE RECS” calculation.

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




Attributes Defaults: CALCAVG

Abbreviations: FRCSZ, FREERECORDSIZE

KRREPORT This parameter specifies whether to print the Keyrange Report, and the high or low key ranges to print in the report.

Parameter syntax KRREPORT (DSLO DSHI CALO CAHI CIHI CILO LINECNT(number | 55 ))


When a partial dataset analysis is performed because of the CACOUNT, CAEND, CASTART, CASAMPLE, or CAVOLUME, the highest and lowest keys for the dataset are the highest and lowest in the control areas analyzed.


DEFAVG Specifies to use the average record size defined for the dataset for the “ESTIMATED NO. OF FREE RECS” calculation.

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

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


DSLO Indicates to VSUM to print the lowest key in the dataset.

DSHI Indicates to VSUM to print the highest key in the dataset.

CALO Indicates to VSUM to print the lowest key in each control area analyzed.

CAHI Indicates to VSUM to print the highest key in each control area analyzed.



RECOMMENDA-TIONS

This parameter defines the types of recommendations VSUM makes about the dataset. Refer to the section “Dataset Recommendations” for a detailed description of the RECOMMENDATIONS parameter and sub-parameters available.

Parameter syntax RECOMMENDATIONS (...)

STATEXIT This parameter specifies a user written exit routine that the VSUM ANALYZE function loads and links to through standard VSE program linkage conventions each time a CONTROL INTERVAL, CONTROL AREA, and DATASET statistical record is created. Refer to “Appendix A” for a description of the STATISTICAL exit and the register usage when control is passed to the exit.

Parameter syntax STATEXIT=module

CIHI Indicates to VSUM to print the highest key in each control interval of each control area analyzed.

CILO Indicates to VSUM to print the lowest key in each control interval of each control area analyzed.

LINECNT(number) Specifies how many lines to print on a page. The minimum allowed is 16, and the maximum is 999.Defaults: LINECNT(55)Mutually exclusive parameters: CAREPORT, CGRAPH, CIREPORTAbbreviations: KRR




Examples of Use

The ANALYZE function is performed as part of the LIST function.

Analyze a Complete KSDS

This example will cause dataset VSAM.KSDS to be completely analyzed and printed to SYSLST.

// EXEC PGM=VSUM LIST CATALOG(your catalog) NAME(VSAM.KSDS) - ANALYZE /*

Analyze and Graph Area Usage for a KSDS

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.

// EXEC PGM=VSUM LIST CATALOG(your catalog) NAME(VSAM.KSDS) - ANALYZE CAGRAPH(YES) /*

Analyze a Single Volume of a KSDS and Save Statistics

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 report statistics will be saved and not printed.

// DLBL DSSTATS,’VSUM.DSSTATS.FILE’ // EXEC PGM=VSUM LIST CATALOG(your catalog) NAME(VSAM.KSDS) - ANALYZE VOLUME(VOL002) - DSREPORT(NO,SAVE) /*

Analyze a KSDS and Make Recommendations

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

// EXEC PGM=VSUM LIST CATALOG(your catalog) NAME(VSAM.KSDS) - ANALYZE RECOMMENDATIONS(ATTRIBUTES - BUFFERS REORGANIZATION) /*

Analyze a Control Area and Print a Control Interval Report

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.

// EXEC PGM=VSUM LIST CATALOG(your catalog) NAME(VSAM.AIX) - ANALYZE DSREPORT(NO) CACOUNT(1) - CIREPORT(YES,FROMCA(1),COUNT(1))



/*

Analyze a User Catalog’s Space Utilization

This example will analyze the space utilization of a VSUM user catalog.

// EXEC PGM=VSUM LIST CATALOG(your catalog/masterpw) - ANALYZE DSREPORT(YES) - CAGRAPH(YES) /*




Report Headings This is an example of a VSUM report heading.

Report Headings Description

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.

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

Field Description

1 CSI Identification Line2 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 user dataset being analyzed.

6 Run Type and TimeRUNDATE: The date the report (RUNTYPE=NEW) was produced.RUNTIME: The time the report (RUNTYPE=NEW) was produced.



Dataset Report 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.

Dataset ReportExample

This is an example of the Dataset Report.

RUNTYPE: New, Complete, Old, Partial, Sampling

New VSAMIN dataset was analyzed.

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

CompleteThe entire dataset was analyzed.

Partial Part of dataset was analyzed.SamplingA sampling of the dataset was taken.

Field Description

-----------------------------------------------------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/1997 * LASTUPD 07/15/1997 * CISIZE 4096 CISPLITS 0 * CISIZE 2048 CISPLITS 0RECSZ (180 2000) FREESPACE(0 0) * TRKS/CA 15 CASPLITS 0 * TRKS/CA 1 CASPLITS 0BUFSP (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 1UNIQUE NOIMBED SPEED UPDATE NODSWAIT * RECORDS 35 EXCPS 53 * RECORDS 1 EXCPS 12NOREUSE NOREPL NOERASE UNQKEY STAGE * INSERTED 0 DELETED 0 * INSERTED 0 DELETED 0NOSPANND NOKEYRNG NOWRTCHK UNORDERD * UPDATED 0 READ 8 * UPDATED 0 READ 0 * HARBA 614400 HURBA 614400 * HARBA 36864 HURBA 2048ASSOCIATIONS: * 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) ------------------------------------------------------------------------------------------------------------------------------------



Space Utilization

CLUSTER This table describes the fields in the CLUSTER area of the Space Utilization report.

Note If limiting parameters are specified then all statistics are reflective of just that portion of the dataset.

Field Description

CYLNDERS/ TRACKS USED

The number and percentage of cylinders/tracks in the data and index components used to contain data.

CYLNDERS/ TRACKS FREE

The number and the percentage of cylinders/tracks in the data and index components that do not contain any data.

CYLNDERS/ TRACKS TOTAL

The total number of cylinders/tracks allocated to the data and index components.

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

BYTES FREE Number and percentage 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 Total number of bytes allocated to the data and index components.

RECORDS Actual number of records in the dataset.AVG-CMPKL Calculated average compressed key length for the

dataset.AVG-IXENL Calculated average index entry length for the dataset.AVG-RECSZ Calculated average record size for the dataset.MAX-RECSZ Largest record currently in the dataset.AVG-AKO (Alternate Indexes with Non-Unique Keys Only)

Average number of alternate key occurrences (duplicates), for non-unique keys, in the base cluster.

MAX-AKO (Alternate Indexes with Non-Unique Keys Only)

The largest number of alternate key occurrences (duplicates), for non-unique keys, in the base cluster.



DATA This table describes the fields in the DATA area of the Space Utilization report.

Note If limiting parameters are specified, all statistics will be reflective of just that portion of the dataset.

ESTIMATED NO. OF FREE RECORDS

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 they reflect the actual number of free records of that recordsize that could currently fit in the available freespace.

Field Description

Field Description

CYLNDERS/TRACKS USED

Number and percentage of cylinders or tracks in the data component used to contain data.

CYLNDERS/TRACKS FREE

Number and percentage of cylinders or tracks in the data component that do not contain data.

BYTES USED Number and percentage of bytes in the data component that are used for data.

BYTES FREE Number and percentage of bytes in the data component that are free (available for new records.)



BYTES LOST Number and percentage of bytes in the data component that do not currently and can never contain new records. Lost bytes can occur in two situations:

• 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.

• If a record has to span a control interval which can only happen with spanned datasets. 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

Number and percentage 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 percentage 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, this number is excessive.

BYTES FREE CI’S FREE

Number and percentage of bytes in free control intervals.

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

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

ALL CI’S LOST The number and percentage 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 happens if the index CI size is too small (too many CIs per CA). If the index CI size is the maximum allowed (4096), the data CI size can be increased. Increasing the data CI size decreases the number of index entries needed in an index control interval. If the index CI size is not 4096, consider increasing it to the next size.

Field Description



INDEX This table describes the fields in the INDEX area of the Space Utilization report.

Note If limiting parameters are specified they will only affect the sequence set statistics.

ALL CA’S USED Number and percentage of the control areas in the data component that contain data (used control area.)

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

Field Description

Field Description

TRACKS USED Number and percentage of tracks in the index component that are used. If IMBED is specified on the AMS DEFINE CLUSTER/AIX, 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 Number and percentage of tracks in the index component that are free. If IMBED is specified on the AMS DEFINE CLUSTER/AIX, 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

Number of records in the high level(s) of the index. This does not include the sequence set records.

SS BYTES USED Number and percentage of bytes in the sequence set records that are used for index entries.

SS BYTES FREE Number and percentage of bytes in the sequence set records that are free (not used for index entries.)

SS-RECORDS USED Number of sequence records in the dataset that contain data.



Catalog Information

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

DEFINE ATTRIBUTES

This table describes the fields in the Define Attributes area under CLUSTER on the Space Utilization report.

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 CIs in the data component control area. If a high percentage of the SS-RECORDS USED is 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 CIs 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, look at a control area report to see if decreasing the Index CI size will leave enough space if the average compressed key length increases slightly.

Field Description

Field Description

RECSZ(avg max) Defined average and maximum record sizes for the dataset.



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

BUFSP (nnnnn) 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 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.

UNIQUE/SUBALLOC Dataset is defined in unique or suballocated dataspace.

IMBED/NOIMBED Index sequence set is imbedded or is not 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.


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

REPL/NOREPL The high-level index and sequence set, if NOIMBED records are replicated or are not replicated on a track.

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

SPANNED/NONSPANND Whether records are allowed to cross control interval boundaries.

KEYRANGE/NOKEYRNG Whether or not the dataset is divided into key ranges.

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

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


Field Description



Data | Index This table describes the fields in the DATA and INDEX areas under CATALOG INFORMATION on the Space Utilization report

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

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

Field Description

Field Description

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

CISIZE Control interval size of the component.CISPLITS Number of times a control interval split occurred.TRKS/CA Number of tracks in a control area.CASPLITS Number of times a control area split occurred.CI’S/CA Number of control intervals in a control area.SHR OPT The cross partition and cross system share options.ENT/SEC Number of index entries per section in the index

component.LEVELS Number of index levels in the index component.PHYRCSZ Size of the physical record for the associated

component.TRK-UTIL% Percentage of available bytes on a track that can be

used for control intervals.RECORDS Number of logical records in the component.EXCPS Number of execute channel programs issued for the

component since the last define.INSERTED Number of logical records added to the component

since the last define.DELETED Number of logical records deleted from the

component since the last define.UPDATED Number of logical records updated in the

component since the last define.READ Number of logical records read from the

component since the last define.HARBA Highest allocated relative byte address for the

component.HURBA Highest used relative byte address for the

component, rounded up to a control area boundary.





USEDCYLS/USEDTRKS Total number of cylinders/tracks in the component that contains data.

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

EXCPRATIO Ratio of EXCPs to logical I/O requests. This value can be used as a guide to determining if the application programs processing this component are specifying insufficient buffers. The value represents the average number of EXCPs 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.


VOLUME DASD volume information for this component.DEVT The mnemonic DASD device type that the

component is defined on.EXTS Total number of extents allocated to the

component.SEC-ALLOC Number of times that this component has gone into

secondary allocation.

Field Description



volser(tracks,extents | CANDT | IMB)

Total number of tracks allocated to the volume 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 components because the IMBED option was specified during DEFINE.

Field Description



CA PERC LEG

Control Area Graph

The VSUM Control Area Graph is a multi-page report displaying 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.

Field Descriptions This table describes the fields on the Control Area Graph.

CASIZE= 1 CYLINDER (70 CI'S PER CA) LOST ACTUAL EST FREE 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 ------------------------------------------------------------------------------------------------------ ENT: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

END: C=USED CI'S +=LOST CI'S B=USED BYTES <=LOST BYTES

Field Description

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 asterisk (*) appears to 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 CIs Number of control intervals in the control area that are unusable because the index CISIZE is too small.

ACTUAL-RECORDS Number of records in the control area.EST-FREE RECORDS Estimated number of free records in this Control area.

The estimate is based on the FREERCSZ parameter for the ANALYZE function.

LEGEND

C=USED CIs Percentage of used CIs in the CA.+=LOST CIs Percentage of CIs 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 CIs and (spanned files) percentage of bytes in end-segment spanned CIs unavailable for new records in the CA.

BLANKS Percentage of free CIs and free bytes in the CA.

Field Description



-- C -

Control Area Report

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.

Field Descriptions This table describes the fields on the Control Area report.

-------------------------------------------------------------------*----------------------B Y T E S------------------------------ A 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

Field Description

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 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.

Control Intervals

USED Number and percentage of control intervals in this control area that contain data.

FREE Number and percentage 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 percentage of bytes in this control area used to contain data.

FREE-USED CIs The number and percentage of free bytes within used control intervals. This number is analogous to control interval free space.

FREE-FREE CIs The number and percentage of free bytes within free control intervals. This number is analogous to control area free space.

LOST-USED CIs (Spanned Datasets Only)

The number and percentage of bytes in spanned record end segment control intervals that are unusable for new records.

LOST-FREE CIs Number and percentage 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.

Field Description



--- CA --- DAT

Key Range Report

The VSUM Key Range 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.

Field Descriptions This table describes the fields on the Key Range report.

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

--------------------------------------------------------- K E Y D A T A ------------------------------------------------------

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 ASET* * LO 000000000..S001...... * * 00 000000 * * 00 000000 * * HI 999999999..9901001001 * * 00 * * 00

Fields Descriptions

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 The key is displayed in character form for the characters “A” through “Z” and “0” through “9”. Any other characters appear as a period “.” in the character line and the hexadecimal equivalent is displayed on the next two lines in vertical hexadecimal format.



Control Interval Report

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

Field Descriptions This table describes the fields on the Control Interval report.

---------------------------------------------------------------------------------------- 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

Field Description

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.

BYTES

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

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



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

Field Description


6Dataset Modeling

Overview The VSUM MODELING feature allows experimentation with VSAM dataset design parameters without performing an IDCAMS DEFINE or requiring DASD space. This function can be performed in Online or Batch modes.

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 ONLINE DESIGN function provides an option to allocate the dataset after it has been designed and the VSUM generated IDCAMS DEFINE statements could be saved on a user specified sequential 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. The MODELING feature of VSUM is a very powerful dataset design tool that will pay for itself many times over through improved programmer productivity and efficient dataset design.


Program Description and Operations Version 1 Release 5.0 Dataset Modeling

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.

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

• Allocating VSAM datasets without IDCAMS DEFINE command familiarity.

• Calculating required space based on the number of records and the device type.

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

• Calculation of index control interval size is based on a compressed key length for datasets whose keys compress poorly.

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

• Freespace 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 is 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.


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

Batch Mode A batch mode MODEL function can be performed by specifying a MODEL command in the batch input to the VSUM program. 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 MODEL command parameters that can be specified are described in this section.

Online Mode The Online design function is begun by specifying D in the command line of VSUM’s PRIMARY OPTION MENU described in the “Introduction” section. This Online panel is the first in a series of panels that guide you in selecting the appropriate dataset design parameters without having to know the VSUM MODEL command or IDCAMS DEFINE command syntax. The VSUM output is then displayed on your terminal through VSUM Online panels.



Batch Command Input

This is a list of parameters for the MODEL command.

Online Input Panels

Design Selection Panel (TYPE)

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 Getting Started section. This panel is used to select the TYPE of VSAM dataset to be designed and/or allocated.

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 | FBA) 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



Design KSDS Panel

This panel is displayed when K is selected from VSUM’s DESIGN SELECTION PANEL and is used to describe the VSAM KSDS dataset characteristics.

Design ESDS Panel

This panel is displayed when D is selected from VSUM’s DESIGN SELECTION PANEL and is used to describe the VSAM ESDS dataset characteristics.

----------------------- VSUM - DESIGN \"KSDS\" DATASET -------------------------- COMMAND==> INPUT TRACE==> NO DATASET NAME ==> SAMPLE.KK (NO QUOTES) CATALOG NAME ==> SAMPLE.MVSICFU.VSTAR01 (NO QUOTES) DASD SPACE TYPE ==> CYL (CYL,TRK,REC) DASD SPACE ==>( 950 , 450 ) (PRIMARY,SECONDARY) (1-9999999) DEVICE TYPE ==> 338K (338K,338E,3380,3375, 3350,3390,FBA) 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 BROWSE=N ALLOCATE=YES

----------------------- VSUM - DESIGN \"ESDS\" DATASET -------------------------- COMMAND==> INPUT TRACE==> NO DATASET NAME ==> SAMPLE.KK (NO QUOTES) CATALOG NAME ==> SAMPLE.MVSICFU.VSTAR01 (NO QUOTES) DASD SPACE TYPE ==> CYL (CYL,TRK,REC) DASD SPACE ==>( 950 , 450 ) (PRIMARY,SECONDARY) (1-9999999) DEVICE TYPE ==> 338K (3350,3375,3380,338E,338K,3390,FBA) 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 BROWSE=NO ALLOCATE=NO



DATASET DESIGN PROFILE PANEL

This panel is displayed when PF6 is pressed a VSUM - DESIGN xxxx DATASET and is used to select the VSUM DESIGN function options.

Dataset Allocation Confirmation

Panel

This panel is displayed when the ALLOCATE 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.

IDCAMS Define Messages Panel

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.

----------------------- VSUM - DATASET DESIGN PROFILE ------------------------- COMMAND ==> AUTOMATIC BROWSE OF VSUM GENERATED STATEMENTS? ==> Y (Y/N) AUTOMATIC ALLOCATION OF THE DESIGNED DATASET? ==> Y (Y/N) VSUM INPUT TRACE? ==> N (Y/N) ENTER=SAVE AND EXIT

------------------- 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. 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



------------------------ 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 **********************************************************************



MODEL Parameter Descriptions

ABBREVIATIONS: MODEL may be abbreviated as M.

BASECLUSTER-NAME

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.

Parameter syntax BASECLUSTERNAME (dsname)

Attributes 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.

Parameter syntax ALLCISIZES


Mutually exclusive parameters: CISIZE PMODE

Abbreviations: ALLCI

BASEKEYLN 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.

Parameter syntax BASEKEYLN (number)


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 Specifies the VSAM catalog name to be used in the generated IDCAMS DEFINE command.



Parameter syntax CATALOG (catalogname)


Specifies the VSAM catalog name to be used in the generated IDCAMS DEFINE command.

Defaults: (null)

Abbreviations: CAT

CISIZE Specifies the data component control interval size to be modeled.

Parameter syntax CISIZE (number)


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 Specifies the number of cylinders that are allocated for the data component. If the number of cylinders exceeds the maximum RBA allowed for a VSAM dataset, the model function fails.

Parameter syntax CYLINDERS (primary secondary)


The values for primary and secondary can be a valid numeric string from 1 to 9999999.

Required: YES

Mutually exclusive parameters: TRACKS RECORDS

Abbreviations: CYL, CYLS

DEFOUT Specifies that the VSUM generated IDCAMS define parameters should be written to the specified or defaulted DDNAME.

Parameter syntax DEFOUT (ddname | DEFDD )


The dataset can be a sequential or partitioned dataset member and must have a logical record length of 80.

Defaults: DEFDD



DEVICETYPE Specifies the DASD device type to be used for the modeling calculations.

Parameter syntax DEVICETYPE (3390 | 3380 | 338E | 338K | 3375 | 3350 | 3340 | 3330 | FBA)

Attributes Defaults: 3380

Abbreviations: DEVTYPE, DEVICE, DEV

DUPKEYS Specifies, for AIX datasets, the maximum number of duplicate alternate keys expected within the base cluster.

Parameter syntax DUPKEYS (number)


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 to 99999.

Defaults: 1

Mutually exclusive parameters: TYPE(KSDS ESDS RRDS)

Abbreviations: MAXDUPKEYS, MAXDUPLICATEKEYS

FREERECORDS 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.

Parameter syntax FREERECORDS (cinumber canumber)


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 to 99999.

Defaults: (null)



Mutually exclusive parameters: FREESPACE TYPE(ESDS RRDS)

Abbreviations: FREERECS, FRECS

FREESPACE Specifies the control interval and control area freespace percentages that VSUM uses for the modeling calculations.

Parameter syntax FREESPACE (cipct capct)


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)

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.

Parameter syntax IMBED

Attributes Defaults: NOIMBED

Mutually exclusive parameters: IMBED TYPE(ESDS RRDS)

Abbreviations: IMB

KEYS Specifies, for indexed datasets, the key length and key offset within the VSAM record.

Parameter syntax KEYS(length offset <cmplength])


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 is 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)


Abbreviations: KEY

NAME 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.

Parameter syntax NAME (dsname)


The cluster name is 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.

Parameter syntax NOIMBED

Attributes Defaults: NOIMBED

Mutually exclusive parameters: IMBED

Abbreviations: NOIMB

NONSPANNED Specifies that records are not allowed to span control intervals.

Parameter syntax NONSPANNED

Attributes Defaults: NONSPANNED

Mutually exclusive parameters: SPANNED TYPE(AIX)

Abbreviations: NONSPAN, NSPA

NOREPLICATE Specifies that the index records will not be replicated on a track.

Parameter syntax NOREPLICATE

Attributes Defaults: NOREPLICATE

Mutually exclusive parameters: REPLICATE



Abbreviations: NOREPL, NOREP

PMODE Specifies the processing mode, “DIRECT”, “SEQUENTIAL”, or “MIXED”, which will be used by the programs when they open the dataset to be modeled. VSUM selects 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 is 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 is used to determine the best control interval size.

Parameter syntax PMODE (DIRECT | SEQUENTIAL | MIXED )


The PROCESSING MODE control interval ranges used are:

• DIRECT 512 to 4096

• MIXED2048 to 8192

• SEQUENTIAL4096 to 32760

Defaults: MIXED

Mutually exclusive parameters: CISIZE ALLCISIZES

Abbreviations: PROCESSINGMODE, PROCMODE

RECORDS Specifies the number of average record size records that is 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 fails.

Parameter syntax RECORDS (primary secondary)



Required: YES

Mutually exclusive parameters: CYLINDERS TRACKS



Abbreviations: RECS, REC

RECSIZE Specifies the average and the maximum record size for the dataset to be modeled.

Parameter syntax RECSIZE (avg max)


If the average record size is not entered, the maximum record size is used for the average record size. If the maximum record size is not entered, the average record size is used for the maximum record size. VSUM uses the average record size for all allocation and freespace calculations. If the average record size 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 you specify the processing mode, PMODE, the maximum record size influences 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 to 9999999.

Required: YES

Abbreviations: RECSZ, RECORDSIZE

REPLICATE Specifies that the indexed dataset modeled 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 are not avoided unless the INDEX is on a different volume.

Parameter syntax REPLICATE

Attributes Defaults: NOREPLICATE

Mutually exclusive parameters: NOREPLICATE TYPE(ESDS RRDS)

Abbreviations: REPL, REP

SHAREOPTIONS Specifies the VSAM cross-region (cr) and cross system (cs) share options to be used in the IDCAMS DEFINE command generation.



Parameter syntax SHAREOPTIONS (cr cs)


Valid cross region share options are 1, 2, 3, or 4, and valid cross system share option are 3 or 4. Share option 1 allows only one update user *OR* multiple read only users to share the dataset for processing on a CPU. Share option 2 allows one update *AND* multiple read only users to share the dataset for processing on a CPU. Share option 3 allows multiple update *AND* read only users to 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 has records that are allowed to span control intervals.

Parameter syntax SPANNED

Attributes Defaults: NONSPANNED

Mutually exclusive parameters: NONSPANNED

Abbreviations: SPAN

TRACKS Specifies the number of tracks allocated for the data component. If the number of tracks exceeds the maximum RBA allowed for a VSAM dataset, the model function fails.

Parameter syntax TRACKS (primary secondary)



Required: YES

Mutually exclusive parameters: CYLINDERS RECORDS

Abbreviations: TRK

TYPE Specifies the type of VSAM dataset to be modeled.



Parameter syntax TYPE (KSDS | AIX | ESDS | RRDS)

Variables and attribute

The type values are:

• KSDSis a keyed sequence dataset

• AIXis an alternate index

• ESDSis an entry sequence dataset

• RRDSis a relative record dataset

Required: YES

VOLUME Specifies the volume to be used in the VOLUME parameter of the generated IDCAMS DEFINE parameters.

Parameter syntax VOLUME (volser)

Attributes Defaults: Device type plus a 2 byte numeric suffix. For example: 338001

Abbreviations: VOL,V



Examples of Use

The following are examples of how to use VSUM’s MODEL feature.

Model a KSDS with Free Records On a 3380

The following example generates 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 is 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.

// EXEC PGM=VSUM MODEL NAME(SAMPLE.KSDS) TYPE(KSDS) RECORDS(100000) - RECSIZE(200 300) KEYS(10 2) DEVICETYPE(3380) - FREERECS(2 100) PROCMODE(DIRECT) /*

Model an AIX with Non-Unique Keys On a 3350

The following example generates 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 fits in 50 cylinders on a 3350 is listed in the modeling report statistics. The data component control interval size selected is for sequential processing and is the most efficient from a range of 4096 to 32760. VSUM calculates the maximum recordsize based on the DUPKEYS and BASEKEYLN parameters.

// EXEC PGM=VSUM MODEL NAME(SAMPLE.AIX) TYPE(AIX) CYLINDERS(50) - RECSIZE(300) KEYS(20 12) DEVICE(3350) - DUPKEYS(1000) BASEKEYLN(10) - PMODE(SEQUENTIAL) /*

Model an RRDS On a 3330 for Mixed Mode Processing

The following example generates 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 is for mixed processing (direct and sequential) and is the most efficient from a range of 2048 to 8192.

// EXEC PGM=VSUM MODEL NAME(SAMPLE.RRDS) TYPE(RRDS) RECORDS(125678) - RECSIZE(200 200) DEVICE(3330) - PROCMODE(MIXED) /*



Output Example and Descriptions

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 can request that the IDCAMS define parameters be written to a sequential output file (DEFOUT parameter) for modification and eventual submission to IDCAMS.

KSDS Dataset This is an example of code used to produce a VSUM Model report for a KSDS dataset.

VSUM-MSG SYSIPT 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)



Model Report for KSDS Dataset

This is an example of the VSUM Model report for KSDS datasets.

C S I I N T E R N A T I O N A L .

VSUM MODEL REPORT PAGE=1

RUN DATE=02/06/2005

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



C S ---- SAMP ---- DEF VSUM

AIX Dataset This is an example of code used to produce a VSUM Model report for a AIX dataset.

Model Report for AIX Dataset

This is an example of the VSUM Model report for AIX datasets.

ESDS Dataset This is an example of code used to produce a VSUM Model report for an ESDS dataset.

VSUM-MSG SYSIPT 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)

I I N T E R N A T I O N A L . VSUM MODEL REPORT PAGE=1 RUN DATE=02/06/2005 RUN TIME=07.50.31 -------------------------------------------------------------------------------------------------------------------------------- LE.AIX (AIX) ------------- IDCAMS DEFINE PARAMETERS -----------------* -------------------D A T A------------------- * --- I N D E X --- INE /* 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) ) * * -MSG MODEL PROCESSING COMPLETED. CONDITION CODE=00000

VSUM-MSG SYSIPT 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)



C - S - V

C - S - V

Model Report for ESDS Dataset

This is an example of the VSUM Model report for ESDS datasets.

RRDS Dataset This is an example of code used to produce a VSUM Model report for an ESDS dataset.

Model Report for RRDS Dataset

This is an example of the VSUM Model report for RRDS datasets.

S I I N T E R N A T I O N A L . VSUM MODEL REPORT PAGE=1 RUN DATE=02/06/2005 RUN TIME=07.50.31 --------------------------------------------------------------------------------------------------------------------------------- AMPLE.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) ) * * SUM-MSG MODEL PROCESSING COMPLETED. CONDITION CODE=00000

VSUM-MSG SYSIPT 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)

S I I N T E R N A T I O N A L . VSUM MODEL REPORT PAGE=1 RUN DATE=02/06/2005 RUN TIME=07.50.31 ----------------------------------------------------------------------------------------------------------------------------------- AMPLE.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) ) * * SUM-MSG MODEL PROCESSING COMPLETED. CONDITION CODE=00000



Field Descriptions This table describes the fields on a VSUM Model Report.

Field Description

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 is the one that contains the most average size records within the specified processing mode range. Refer to section MODEL Parameter Descriptions for a description of the control interval ranges for a processing mode. For an index component, the one chosen is the smallest possible control interval size capable of addressing all the data components CIs 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.

TRKS/CA Number of tracks in a control area.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.

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 are 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

Because of the dataset’s compressed key length, the index cannot address an entire cylinder, so the number of tracks for each control area is 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.

“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 CIs. If buffer space 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.

Field Description


7Dataset Recommendations

Overview

VSAM Dataset Monitoring and Tuning

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 in order 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 provides 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 provides the required statistical and tuning information needed that would normally have had to be calculated 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.

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.


Program Description and Operations Version 1 Release 5.0 Dataset Recommendations

• Efficient control interval sizes for data and index components can be recommended based on a processing mode or average compressed key length.

• 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.


The VSUM RECOMMENDATIONS function can be performed in online mode, by entering “YES” in RECOMMENDATIONS option on a LIST DATASET SELECTION PANEL.

Batch Mode A batch mode RECOMMENDATIONS function can be performed by specifying the RECOMMENDATIONS parameter and sub-parameters on a VSUM LIST, ANALYZE, or REPRINT command in an input statement to the VSUM program.

Online Mode An ONLINE RECOMMENDATIONS function can be performed by specifying “YES” on the RECOMMENDATIONS option on a LIST SELECTION PANEL or by specifying “R” as a line option in the LIST DATASET SELECTION PANEL.

Batch Command Input

RECOMMENDATIONS ( ALL | ATTRIBUTES BUFFERS CISIZE (DIRECT | SEQUENTIAL | MIXED ) FREESPACE ( EVEN | UNEVEN pct | INSERTRATE BYTES | RECORDS) NEWDEVICE (3390 | 3380 | 338E | 338K | 3375 | 3350 | 3340 | FBA) REORGANIZATION SPACE (USED | ALLOCATED | RECORDS | pct) )



Online Input Panels

Recommendations Profile Panel

This panel is displayed when “P “ is specified in the command line of VSUM’s PRIMARY OPTION MENU and then “R” from the PROFILE UPDATE panel, and is used to select the RECOMMENDATIONS options to be used with subsequent RECOMMENDATIONS requests.

Abbreviations RECOMMENDATIONS may be abbreviated as RECOMM.

Recommendations Parameter Descriptions

Specifies to VSUM to make the ATTRIBUTES, BUFFERS, REORGANIZATION, and CISIZE (MIXED) recommendations 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.

ALL

Parameter syntax ALL

Attributes Defaults: ALL

Mutually exclusive parameters: ATTRIBUTES BUFFERS REORGANIZATION CISIZE

ATTRIBUTES Specifies to VSUM to make the dataset attribute recommendations for each dataset processed.

------------------- 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,FBA) ENTER=SAVE AND EXIT



Parameter syntax ATTRIBUTES


The attributes that recommendations are made for are: RECOVERY, ERASE, WRITECHECK, REPLICATE, SHAREOPTIONS, and IMBED.

Defaults: (yes if ALL specified or defaulted)

Mutually exclusive parameters: ALL

Abbreviations: ATTR

BUFFERS Specifies to VSUM to make buffer recommendations for the datasets processed. The buffer recommendations are made for DATA and INDEX components and 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 are the new control interval size(s).

Parameter syntax BUFFERS

Attributes Defaults: (yes if ALL)


Abbreviation: BUFF, BUF

CISIZE Specifies that control interval recommendations for the specified processing mode will be made for the datasets to be processed. If the NEWDEVICE parameter is also specified the control interval sizes recommended will apply to the device type.

Parameter syntax CISIZE (DIRECT | SEQUENTIAL | MIXED)


VSUM selects 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.


Abbreviations: CISZ

FREESPACE Specifies to VSUM to make Freespace recommendations based on the specified sub-parameters 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.

Parameter syntax FREESPACE (EVEN | UNEVEN <pct | INSERTRATE > BYTES |RECORDS)


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 sub-parameter. If the pct | INSERTRATE sub-parameter is not specified, the control interval and control area freespace percentages currently defined for the dataset are 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 are not 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 are allocated to control interval freespace and ten percent (10) are 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 calculates the logical record insertion rate and uses that rate as the percentage. If the logical insertion rate is greater than 100 percent, 100 percent will be used. Freespace is calculated in free average record size records when INSERRATE is specified.

BYTES indicates that the single percentage used for the freespace calculations represents bytes. BYTE 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 record size used is the defined average for LIST functions, and the calculated average for LIST ANALYZE and ANALYZE functions.

Defaults: (null)


Abbreviations: FSPC

NEWDEVICE Specifies to VSUM to make the CISIZE, FREESPACE, and SPACE recommendations for the datasets processed based on the new device type.

Parameter syntax NEWDEVICE (3390 | 3380 | 338E | 338K | 3375 | 3350 | 3390 | FBA)

Attributes Defaults: (current device type)

Abbreviations: NEWDEVICE, NEWDEV

REORGANIZA-TION

Specifies to VSUM to make reorganization recommendations for the datasets processed. The reorganization recommendations are 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).

Parameter syntax REORGANIZATION

Attributes Defaults: (yes if ALL specified or defaulted)




Abbreviations: REORG

SPACE Specifies to VSUM to make space allocation recommendations based on the specified sub-parameters for the datasets processed. If the NEWDEVICE parameter is also specified, the allocation recommendations apply to the new device type.

Parameter syntax SPACE (USED | ALLOCATED | RECORDS <pct])


The data component space recommendations are made according to the USED, ALLOCATED, and RECORDS sub-parameters. The index component space recommendations are made according the recommended data component space allocation amount and not on the existing allocation amount.

USED specifies to VSUM to make the space recommendation based on the number or equivalent number cylinders or tracks currently used (not free) in the data component.

ALLOCATED specifies to VSUM to make the space recommendations based on the number or equivalent number of cylinders or tracks currently allocated (used and free) in the data component.

RECORDS specifies that the current logical record count is 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)

Examples of Use

List All KSDS’S in a Catalog and

Make Recommendations

The following example lists the VSAM catalog named UCAT1 and make buffer recommendations for all KSDS datasets that have a data control interval size of 4096.

// EXEC PGM=VSUM LIST CAT(UCAT1) TYPE(KSDS) CISIZE(4096:EQ) - RECOMM(BUFFERS)



/*

Analyze a KSDS and Make

Freespace Recommendations

The following example will analyze a KSDS and make freespace recommendations based on the current freespace percentages for even key distribution.

// EXEC PGM=VSUM LIST CAT(CAT1) TYPE (KSDS) NAME (THIS.IS.A.KSDS) - ANALYZE RECOMM(FREESPACE(EVEN)) /*

List All Selected Datasets and Recommend

Allocation for New Device

The following example lists all VSAM datasets that are defined fully or partially on volume 333001, and make recommendations about space allocation requirements on a new device type.

// EXEC PGM=VSUMHR LIST CAT(UCAT2) VOLUME(333001) TYPE(KSDS ESDS AIX RRDS) - RECOMM(SPACE(ALLOCATED) NEWDEVICE(3380)) /*

Analyze an AIX and Make CISIZE

Recommendations for Direct

Processing

The following example analyzes the AIX specified, lists the statistics along with a recommendation for data and index control interval sizes for direct processing mode. The index control interval size is recommended based on the compressed key length calculated from the dataset analysis, and on the recommended data control interval size.

// EXEC PGM=VSUM LIST CAT(CAT1) TYPE (AIX) NAME (THIS.IS.AN.AIX) - ANALYZE RECOMM(CISIZE(DIRECT)) /*


Batch Output The VSUM recommendations report is 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.



Online Output

Online Recommendations Output Panel (1 of

2)

This panel is the first of two panels that is displayed when recommendations are selected for a dataset from the LIST DATASET SELECTION PANEL.

Online Recommendations Output Panel (2 of

2)

This panel is the second of two panels that are displayed when recommendations are selected for a dataset from the LIST DATASET SELECTION PANEL.

----------------------------------------------------- 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)"

---------------- 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. PF3=EXIT ENTER=NEXT PAGE



Field Descriptions

Recommendations That Can Be Made

1. Attributes Recommendations

The attribute recommendations are made when the ALL or ATTRIBUTE sub-parameter is specified in the RECOMMENDATIONS parameter or a LIST, ANALYZE, or REPRINT function.

---------------- 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)\" PF3=EXIT ENTER=PREVIOUS PAGE

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)"



a. “RECOVERY” This recommendation is made so that control interval preformatting is not performed during the load pro-cess. 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 because of the dependability of current DASD devices. Asking VSAM to verify each control interval it writes to DASD may waste valuable processing time. Note: WRITECHECK may still be valid for datasets for which write integrity is an absolute requirement.

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 unneces-sary dataset integrity risk is being taken unless all the pro-grams that update the dataset use their own ENQUEUE 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 pro-grams 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 sub-parameter 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 compo-nent, and there no secondary allocation amounts or addi-tional volumes are specified during the dataset define. If records are added or updated on the data component, a con-



trol area split or dataset extension is required and the job fails.

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 cause 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 distrib-uted, within one or more key ranges and not evenly through-out the dataset, the RECOMMENDATION FREESPACE parameter can be used to calculate freespace percentages based on UNEVEN distribution of keys.

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 are made when the ALL or BUFFERS sub-parameter 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 val-ues 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 SEQUEN-TIAL processing with a string number (STRNO) of one (1). The BUFND values are four (4) for minimum, and 2 times the data CIs per track plus STRNO for maximum. If perfor-mance is extremely critical and virtual storage is not a prob-lem, the maximum value can be increased by its original value for each additional track to be processed until addi-tional 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 min-imum 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.

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 record size. The defined average record size 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 record size. The defined average record size 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 record size is used for LIST functions and the calculated average record size is used for ANALYZE functions.

d. This line is printed when the recommended DATA CISIZE will improve VSAM’s track utilization over the current con-trol interval size.

e. This recommendation shows an index control interval size based on CIs per CA for the recommended data control inter-val size, and a compressed key length of 5 for LIST func-tions and a compressed key length of 5 or greater for ANALYZE functions.

6. Frees pace 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 or the LIST function, and the calculated for the ANALYZE function.

a. This freespace recommendation is based on the even distribu-tion of the specified percentage of free average record size records.

b. This freespace recommendation is based on the uneven distri-bution of the specified percentage of free average record size records.

c. This freespace recommendation is based on the even distribu-tion of the specified percentage of free bytes.

d. This freespace recommendation is based on the uneven distri-bution of the specified percentage of free bytes.

e. This freespace recommendation is based on the even distribu-tion of the current insert record rate percentage.

f. This freespace recommendation is based on the uneven distri-bution 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 is 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 is the number of records for the dataset shown in the catalog. The number of records used for an ANALYZE function is 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 is the number of used tracks/cylinders analyzed.

The number of allocated tracks/cylinders for a LIST and a complete ANALYZE function is the total allocated tracks/cylinders for the data component. The number of allocated tracks/cylinders for a partial ANALYZE function is the number of allocated tracks/cylinders analyzed.



a. This recommendation indicates the number of tracks or cylin-ders required for the number of average record size records indicated.

b. This recommendation indicates the number of tracks or cylin-ders required for the number of average record size records indicated plus the specified growth.

c. This recommendation indicates the number of tracks or cylin-ders required based on used space in the dataset.

d. This recommendation indicates the number of tracks or cylin-ders required based on used space in the dataset plus the specified growth rate.

e. This recommendation indicates the number of tracks or cylin-ders required based on allocated space in the dataset.

f. This recommendation indicates the number of tracks or cylin-ders required based on allocated space in the dataset plus the specified growth rate.

g. This recommendation indicates the number of tracks or cylin-ders required for the index component to support the data component space recommendation.


8Messages and Codes

Condition Codes

4 Indicates that a syntax error occurred while processing a command.

12 Indicates that during a command function a severe error occurred and processing was terminated.

Abend Codes U012 This user ABEND occurs 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 3.

VSUM-MSG SYSIPT CONTROL STATEMENTS:.

ACTION:Processing continues.

MODULE:VSUM

EXPLANATION:

Displayed preceding the display of the SYSIPT statements read.

VSUM-MSG SPECIFIED PARAMETERS ACCEPTED..


MODULE:VSUMANAL

EXPLANATION:

Displayed preceding the display of the input control statements read, specifying the user specified settings for the “ABEND” or


Program Description and Operations Version 1 Release 5.0 Messages and Codes

“NOABEND” option. Refer to the section “PARM Command,“ page 3, for more information about the “ABEND” and “NOABEND” options.

VSUM-MSG EXEC PARM (SYSIPT OVERRIDE):.


MODULE:VSUM

EXPLANATION:

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:

Displayed after the completion of a VSUM function. ‘XXXXXXX’ when the process is completed, and the condition code is displayed with ‘AAAA’. If an ABEND occurs, ‘ABEND’ is displayed. Report the ABEND to Connectivity Systems, Inc., technical support.

VSUM-MSG SYNTAX SCAN COMPLETED SUCCESS-FULLY..

ACTION:Processing terminated.

MODULE:VSUM

EXPLANATION:

Displays after a scan of the VSUM control statements has been completed.

VSUM-MSG SYNTAX SCANNING TURNED OFF..




MODULE:VSUM

EXPLANATION:

Displays 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


MODULE:VSUMANAL

EXPLANATION:

Displays if any default parameters are taken during the current function of VSUM. All the defaults possible are shown.

VSUM-WARNNG XXXXXXXX DATASET RAN OUT OF SPACE AND PROCESSING CONTINUED..


MODULES:VSUM, VSUMANAL

EXPLANATION:

Displays when one of the VSUM statistical datasets (shown by DLBL 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..


MODULES:VSUMANAL

EXPLANATION:

Displays 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....


MODULE:VSUMANAL

EXPLANATION:

Displays when the CASTART and CAEND parameters are 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. Since 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:

Denotes an internal VSUM programming problem. If it should occur, notify Connectivity Systems technical support and send the associated dump.

VSUM-ERRB00 LOGIC ERROR, CLOSE CANNOT PRE-CEDE OPEN IN MODULE=VSUMBKUP..




MODULE:VSUMBKUP

EXPLANATION:

Denotes an internal VSUM programming problem. If this message occurs, notify Connectivity Systems technical support and send the associated dump.

VSUM-ERRB01 RDJFCB MACRO FAILURE IN VSUMBKUP MODULE FOR DDN=XXXXXXXX..


MODULE:VSUMBKUP

EXPLANATION:


VSUM-ERRC01 LOGIC ERROR, DATA CISIZE CALCULATION FAILURE..


MODULE:VSUMRCRP

EXPLANATION:


VSUM-ERRC02 DATASET SIZE AFTER GROWTH FACTOR EXCEEDS MAXIMUM XXXXXX RBA ADDRESSABILITY..


MODULE:VSUMRCRP

EXPLANATION:



Displays when the SPACE sub- parameter of RECOMMENDATIONS has been specified with a growth percentage, but the space needed cannot be addressed on the current device type (the dataset is too large, for example). Specify a lower growth percentage or possibly a different device type and run VSUM again.

VSUM-ERRC03 CURRENT DATA CISIZE CALCULATION FAILURE..


MODULE:VSUMRCRP

EXPLANATION:


VSUM-ERRC04 RECORDS RECOMMENDATIONS IMPOSSI-BLE..


MODULE:VSUMRCRP

EXPLANATION:

Recommendations were requested for a dataset that is empty.

VSUM-ERRD03 INVALID REQUEST TO VSUMDYN MOD-ULE..


MODULE:VSUMDYN

EXPLANATION:


VSUM-ERRD04 DSNAME NOT FOUND, NAME=‘XXXXXXXXXXXXXXXXXXXXX’..




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.

VSUM-ERRI01 FUNCTION ‘XXXXXXXXXXXXXXX’ LONGER THAN 16..


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..


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:VSUMIN00EXPLANATION:

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..


The input parameters contain an unmatched set of parenthesis. Correct the parameter and try the function again.

VSUM-ERRI06 OPEN PARENTHESIS NOT FOUND AFTER GROUP ‘XXXXXXXX’..


MODULE:VSUMIN00

EXPLANATION:

The XXXXXXXX parameter is a group parameter and requires that the sub-parameters be enclosed in parenthesis. Correct the parameter and try the function again.

VSUM-ERRI07 OPEN PARENTHESIS NOT EXPECTED AFTER FUNCTION ‘XXXXXXXX’..


MODULE:VSUMIN00

EXPLANATION:



An open parenthesis is invalid after the function XXXXXXXX. Correct the parameter and try the function again.

VSUM-ERRI08 OPEN PARENTHESIS OUT OF ORDER..


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..


MODULE:VSUMIN00

EXPLANATION:

An equal sign is not expected as input in the parameter. Correct the parameter and try the function again.

VSUM-ERRI10 DUPLICATE KEYWORD ‘XXXXXXXX’..


MODULE:VSUMIN00

EXPLANATION:

The keyword XXXXXXXX was previously specified. Eliminate the duplicate and try the function again.

VSUM-ERRI11 LOGIC ERROR-INVALID MACRO ID..


MODULE:VSUMIN00

EXPLANATION:




VSUM-ERRI12 DUPLICATE GROUP ‘XXXXXXXX’..


MODULE:VSUMIN00

EXPLANATION:


VSUM-ERRI13 LOGIC ERROR-INFORM NOT FOUND/INVALID..


MODULE:VSUMIN00

EXPLANATION:


VSUM-ERRI14 LOGIC ERROR-INLEN NOT FOUND..


MODULE:VSUMIN00

EXPLANATION:


VSUM-ERRI15 LOGIC ERROR-INVALID SCON..




MODULE:VSUMIN00

EXPLANATION:


VSUM-ERRI16 LOGIC ERROR-INMASK ERROR..


MODULE:VSUMIN00

EXPLANATION:


VSUM-ERRI17 LOGIC ERROR-OUTMASK ERROR..


MODULE:VSUMIN00

EXPLANATION:


VSUM-ERRI18 LOGIC ERROR-OUTFLD FORMAT ERROR..


MODULE:VSUMIN00

EXPLANATION:




VSUM-ERRI19 LOGIC ERROR-REQUIRED GROUP/KEY-WORD MACRO ERROR..


MODULE:VSUMIN00

EXPLANATION:


VSUM-ERRI20 LOGIC ERROR-MUTUALLY EXCL GROUP/KEYWORD MACRO ERROR..


MODULE:VSUMIN00

EXPLANATION:


VSUM-ERRI21 PREMATURE END OF KEYWORD ‘XXXXXXXX’..


MODULE:VSUMIN00

EXPLANATION:

The keyword XXXXXXXX had more required sub-parameters that were not specified. Correct the keyword and try the function again.

VSUM-ERRI22 ‘XXXXXXXX’ KEYWORD HAS AN INVALID EQUAL SIGN..


MODULE:VSUMIN00



EXPLANATION:

The keyword XXXXXXXX has an equal sign that is not expected as input in the parameter. Correct the keyword and try the function again.

VSUM-ERRI23 ‘XXXXXXXX’ KEYWORD HAS AN INVALID OPEN PARENTHESIS..


MODULE:VSUMIN00

EXPLANATION:

The keyword XXXXXXXX has an open parenthesis that is out of place or not required. Correct the keyword and try the function again.

VSUM-ERRI24 LOGIC ERROR-IN INPUT PARAMETER PRO-CESSING..


MODULE:VSUMIN00

EXPLANATION:


VSUM-ERRI26 ‘XXXXXXXX’ IS AN UNDEFINED KEYWORD FOR ‘AAAAAAAA’ FUNCTION..


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..




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..


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 SUB-PARAMETERS..


MODULE:VSUMIN00

EXPLANATION:

The keyword AAAAAAAA has too many sub-parameters specified for it. Correct the keyword and try the function again.

VSUM-ERRI30 KEYWORD ‘AAAAAAAA’ INVALID DSNAME ‘BBBBBBBBBBBBBB’..


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’..


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 PASS-WORD ‘BBBBBBBB’..


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’ SUB-PARM(‘BBB’)=‘CCCCCCCC’ LESS THAN MINIMUM LENGTH/VALUE..


MODULE:VSUMIN00

EXPLANATION:

The sub-parameter 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’ SUB-PARM(‘BBB’)=‘CCCCCCCC’ GREATER THAN MAXIMUM LENGTH/VALUE..


MODULE:VSUMIN00

EXPLANATION:

The sub-parameter 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.

VSUM-ERRI35 KEYWORD ‘AAAAAAAA’ SUB-PARM(‘BBB’)=‘CCCCCCCC’ IS NOT NUMERIC..


MODULE:VSUMIN00

EXPLANATION:

The sub-parameter 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 OUT-FLD..


MODULE:VSUMIN00

EXPLANATION:

Denotes an internal VSUM programming problem. If this message occurs, notify Connectivity Systems support and send the associated dump.

VSUM-ERRI38 LOGIC ERROR-BINARY OUTFLD LONGER THAN 4 BYTES..




MODULE:VSUMIN00

EXPLANATION:


VSUM-ERRI39 LOGIC ERROR-PACKED DECIMAL OUTFLD LONGER THAN 15 BYTES..


MODULE:VSUMIN00

EXPLANATION:


VSUM-ERRI40 VOLUME ‘AAAAAA’ LONGER THAN 6 CHAR-ACTERS..


MODULE:VSUMIN00

EXPLANATION:

The volume serial number specified as AAAAAA is invalid because it is longer than 6 characters. Correct the parameter and try the function again.

VSUM-ERRI41 INPUT FORMAT NOT CURRENTLY SUP-PORTED..


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’ SUB-PARM(‘BBB’)=‘CCCCCCCC’ IS INVALID..


MODULE:VSUMIN00

EXPLANATION:

The sub-parameter CCCCCCCC, sequence BBB, is invalid for keyword AAAAAAAA. Correct the parameter and try the function again.

VSUM-ERRI43 KEYWORD ‘AAAAAAAA’ SUB-PARM(‘BBB’)=‘CCCCCCCC’ IS AN INVALID PARTIAL DSNAME..


MODULE:VSUMIN00

EXPLANATION:

The partial dsname specified in sub-parameter 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..


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’ SUB-PARM(‘BBB’)=‘CCCCCCCC’ DATE FORMATE ERROR..


MODULE:VSUMIN00

EXPLANATION:

The date specified in sub-parameter CCCCCCCC, sequence BBB, keyword AAAAAAAA is invalid as input. Correct this parameter and try the function again.

VSUM-ERRI46 KEYWORD ‘AAAAAAAA’ IS REQUIRED..


MODULE:VSUMIN00

EXPLANATION:

The keyword AAAAAAAA is a required parameter. Enter this keyword and try the function again.

VSUM-ERRI47 GROUP ‘AAAAAAAA’ IS REQUIRED..


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..


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..


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..


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..


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 SYSIPT CONTAINS ALL BLANK DATA..


MODULE:VSUMIN00

EXPLANATION:



Only blanks and no valid parameters were entered in SYSIPT. No processing was needed.

VSUM-ERRI50 ‘XXXXXXXX’ IS NOT A VALID FUNCTION..


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..


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..


MODULE:VSUMIN00

EXPLANATION:


VSUM-ERRI53 LOGIC ERROR-PASSWORD OUTPUT FIELD LESS THAN 8 BYTES..




MODULE:VSUMIN00

EXPLANATION:


VSUM-ERRI54 OPEN PARENTHESIS IS NOT VALID AS FIRST CHARACTER OF A COMMAND..


MODULE:VSUMIN00

EXPLANATION:

A parenthesis was found as the first character of a command, which is invalid. Correct this and try the function again.

VSUM-ERRI55 INVALID OPEN PARENTHESIS WITHIN KEY-WORD ‘XXXXXXXX’..


MODULE:VSUMIN00

EXPLANATION:

A parenthesis was found for the keyword XXXXXXXX, but is invalid in this position. Correct this and try the function again.

VSUM-ERRI56 KEYWORD ‘AAAAAAAA’ AND GROUP ‘BBBBBBBB’ ARE MUTUALLY REQUIRED..


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..


MODULE:VSUMIN00

EXPLANATION:

Both the keyword AAAAAAAA and the keyword BBBBBBBB are required when either is specified. Enter the missing keyword and try the function again.

VSUM-ERRI56 GROUP ‘AAAAAAAA’ AND KEYWORD ‘BBBBBBBB’ ARE MUTUALLY REQUIRED..


MODULE:VSUMIN00

EXPLANATION:

Both the group AAAAAAAA and the keyword BBBBBBBB are required when either is specified. Enter the missing keyword and try the function again.

VSUM-ERRI57 LOGIC ERROR-MUTUALLY REQD GROUP/KEYWORD MACRO ERROR..


MODULE:VSUMIN00

EXPLANATION:


VSUM-ERRI58 KEYWORD ‘AAAAAAAA’ SUB-PARM(‘BBB’)=‘CCCCCCCC’ IS AN INVALID DATA CISIZE..




MODULE:VSUMIN00

EXPLANATION:

The control interval size specified for the data component in sub-parameter CCCCCCCC, sequence BBB of keyword AAAAAAAA is invalid. Correct this parameter and try the function again.

VSUM-ERRI59 KEYWORD ‘AAAAAAAA’ SUB-PARM(‘BBB’)=‘CCCCCCCC’ IS AN INVALID INDEX CISIZE..


MODULE:VSUMIN00

EXPLANATION:

The control interval size specified for the index component in sub-parameter CCCCCCCC, sequence BBB of keyword AAAAAAAA is invalid. Correct this parameter and try the function again.

VSUM-ERRI59 KEYWORD ‘AAAAAAAA’ SUB-PARM(‘BBB’)=‘CCCCCCCC’ IS AN INVALID VSAM BLOCK-SIZE..


MODULE:VSUMIN00

EXPLANATION:

The blocksize specified in sub-parameter 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’ SUB-PARM(‘CCC’)=‘DDDDDDDD’..


MODULE:VSUMIN00

EXPLANATION:




VSUM-ERRL01 CATALOG LOCATE ERROR=‘XXX’, PRO-CESSING TERMINATED..


MODULE:VSUMLCAT

EXPLANATION:

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 that is executing VSUM.

56 Authorization failure.Dataset password is missing or specified incorrectly.

72 A required volume is not mounted.

VSUM-ERRL03 THE SPECIFIED VOLUMES CATALOG RECORD ‘XXXXXX’ WAS NOT FOUND..


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 CHO-SEN..


MODULE:VSUMLCAT

EXPLANATION:

No datasets were found meeting all the input criteria simultaneously.

VSUM-ERRL06 INPUT PARAMETERS SPECIFIED RESULT IN NO PRINTING..


MODULE:VSUMLCAT

EXPLANATION:

The selection of the NODETAIL parameter in conjunction with the other LIST report parameters specified require no printing. No processing was necessary.

VSUM-ERRL07 NO CATALOG WAS FOUND WITH THE SPECIFIED NAME OF XXXXXXXX..


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.

VSUM-ERRM01 NO MODCWA ADDRESS FOUND IN VSUMWA..


MODULE:VSUMMODC

EXPLANATION:




VSUM-ERRM02 DEVICE TYPE ‘XXXX’ NOT SUPPORTED..


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)..


MODULE:VSUMMODC

EXPLANATION:


VSUM-ERRM05 FREERECORDS PER CI IS GREATER THAN LARGEST CI POSSIBLE..


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..




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..


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 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..


MODULE:VSUMMODL

EXPLANATION:

The key length 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..


MODULE:VSUMMODL



EXPLANATION:

The compressed key length, specified as the third sub-parameter of the KEYS parameter, is greater than the specified key length which cannot occur. Correct this parameter and try the function again.

VSUM-ERRM16 AVGRECSZ AND MAXRECSZ MUST BE THE SAME FOR AN RRDS..


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..


MODULE:VSUMMODL

EXPLANATION:

Neither the average record size specified in the AVGRECSZ parameter nor 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..


MODULE:VSUMMODL

EXPLANATION:

Check to see whether the specified average or maximum recordsize exceeds the CISIZE specified. If not, obtain a dump and contact



Connectivity Systems technical support. Refer the ABEND option of the “PARM Command“, page 3.

VSUM-ERRM19 CALCULATION ERROR FOR MODERANGE CISIZE..


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 Connectivity Systems technical support. Refer the ABEND option of the “PARM Command,“ page 3.

VSUM-ERRM20 DATASET SIZE EXCEEDS MAXIMUM RBA ADDRESSABILITY..


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..


MODULE:VSUMMODL

EXPLANATION:


VSUM-ERRM22 KEYLENGTH PLUS OFFSET IS GREATER THAN MAXRECSZ..




MODULE:VSUMMODL

EXPLANATION:

The key length 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..


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.

VSUM-ERRM24 SPECIFIED CISIZE IS TOO SMALL FOR A ‘3375’ DEVICE TYPE..


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’..


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 DLBL STATEMENT PRESENT FOR FILE=‘XXXXXXXX’..


MODULE:VSUMRERN

EXPLANATION:

During REPRINT processing, the statistical file required for processing had a missing DLBL statement (DDname shown by XXXXXXXX). Add the required DLBL statement and try the function again.

VSUM-ERRR03 NO RECORDS FOUND MEETING CRITERIA ON FILE=‘XXXXXXXX’..


MODULE:VSUMRERN

EXPLANATION:

During REPRINT processing, no saved statistical records were found on the specified file, shown by DLBL 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’..


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.

VSUM-ERRR06 CASTATS WERE NOT SAVED ON RUNTYPE=NEW FOR DSN=‘XXXXXXXXXXXX’...


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’...


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’.


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).


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 SUB-PARAMETER OF ‘AAAAAAAA’.

EXPLANATION:

The sub-parameter specified for keyword AAAAAAAA is not valid for release 1 processing.

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. 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.



VSUM-ERR001 SPECIFIED PARAMETERS AND DEFAULTS REQUIRE NO PROCESSING..


MODULE:VSUMANAL

EXPLANATION:

The parameters specified, and the defaults taken do not produce any reports or require any analysis. No processing is required.

VSUM-ERR002 XXXXXXXXX DLBL STATEMENT IS REQUIRED..


MODULES:VSUM,VSUMCBLK,VSUMANAL

EXPLANATION:

The DLBL statement shown in XXXXXXXX is required for the processing chosen. Add the DLBL statement and try the function again.

VSUM-ERR003 EXPECTED CONTINUATION FOR SYSIPT NOT FOUND..


MODULE:VSUM

EXPLANATION:

A SYSIPT 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..


MODULE:VSUMANAL



EXPLANATION:

Because the dataset specified by XXXXXXXXX has not been loaded yet, dataset analysis cannot be done.

VSUM-ERR007 SYSIPT PARAMETER WORKAREA OVER-FLOW. CHECK SYSIPT FOR EXTRANEOUS DATA..


MODULE:VSUM

EXPLANATION:

The internal SYSIPT work area has reached its capacity. Check to ensure that only valid parameters in the correct format were used. If the condition is not correctable, contact Connectivity Systems technical support with a copy of the SYSIPT statements used.

VSUM-ERR008 CASTART IS GREATER THAN HIGH KEY OR HIGH USED CA NO, DSN=AAAAAAAAA.


MODULE:VSUMANAL

EXPLANATION:

The control area number specified in the CASTART parameter is beyond the current limits of the dataset (identified by AAAAAAAA) -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.


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..


MODULE:VSUMANAL

EXPLANATION:


VSUM-ERR013 FREERCSZ PARM VALUE IS GREATER THAN MAXIMUM RECSIZE, DSN=AAAAAAAAAA.


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..


MODULE:VSUMANAL

EXPLANATION:

An open failure occurred on the DLBL statement shown by XXXXXXXX. Verify the dataset/file associated with this DLBL, correct any mistakes and try the function again.



VSUM-ERR096 VSAM AAAAAA FAILURE, R15=‘BB’, ERROR=‘CCC’, MODULE=XXXXXXXX AT ADDR=‘DDDDDD’..


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 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.


MODULE:VSUMBKUP, VSUMCBLK, VSUMIN00, VSUMLCAT, VSUMMODC, VSUMMODL, VSUMRCRP, VSUMRERN

EXPLANATION:


VSUM-ERR098 LOGIC ERROR-ERROR MESSAGE BUILD ERROR IN MODULE=XXXXXXXX.



EXPLANATION:




VSUM-ERR099 LOGIC ERROR-ERROR MESSAGE BUILD OVERFLOW IN MODULE=XXXXXXXX.



EXPLANATION:


VSUM-ERR102 INVALID REQUEST TO VSUMCBLK MOD-ULE.


MODULE:VSUMCBLK

EXPLANATION:


VSUM-ERR103 RDJFCB MACRO FAILURE IN VSUMCBLK MODULE.


MODULE:VSUMCBLK

EXPLANATION:


VSUM-ERR104 XXXXXXXX ACB NOT OPEN..




MODULE:VSUMCBLK

EXPLANATION:


VSUM-ERR105 XXXXXXXX VSAM PLH NOT FOUND..


MODULE:VSUMCBLK

EXPLANATION:


VSUM-ERR106 VSAM RBA NO FOUND IN VOLUME LIST..


MODULE:VSUMCBLK

EXPLANATION:


VSUM-ERR112 SPECIFIED VOLUME IS NOT ALLOCATED TO DSN=AAAAAAAAAA.


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..


MODULE:VSUMCBLK

EXPLANATION:

The volume serial number specified in the VOLUME parameter is only a CANDIDATE VOLUME for the specified dataset (identified by AAAAAAAAAA). It does not contain any data.

VSUM-ERR114 VOLUME XXXXXX CONTAINS NO DATA, DSN=AAAAAAAAAA..


MODULE:VSUMCBLK

EXPLANATION:

The volume serial number specified in the VOLUME parameter does not contain any data. Dataset is identified by AAAAAAAAAA.

VSUM-ERR115 NUMBER OF VOLUMES OR KEYRANGES EXCEEDS 16, DSN=AAAAAAAAAA..


MODULE:VSUMCBLK

EXPLANATION:

The dataset (identified by AAAAAAAAAA) being processed has been found to use more than 16 volumes or key ranges. Processing cannot continue.

VSUM-ERR116 NUMBER OF EXTENTS FOR VOLUME XXXXXX EXCEEDS 256, DSN=AAAAAAAAAA..


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 PRO-CESS REQUEST MODULE=XXXXXXXX.


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 TERMI-NATED..


MODULE:VSUMCBLK

EXPLANATION:

Denotes that a 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 that is executing VSUM.

56 Authorization failure. Dataset password is missing or specified incorrectly.



72 A required volume is not mounted.

VSUM-ERR119 CATALOG LOCATE ERROR (CAT ACB NOT FOUND) PROCESSING TERMINATED..


MODULE:VSUMCBLK

EXPLANATION:


VSUM-ERR120 DATASET IS NOT A KSDS OR AIX, DSN=AAAAAAAAAA..


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..


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..


MODULE:VSUMCBLK



EXPLANATION:

The dataset shown with dsname=AAAAAAAAAA is on device AAAA, which is not supported by VSUM.

VSUM-ERR806 MODULE=XXXXXXXX COULD NOT BE LOADED..


MODULE:VSUM

EXPLANATION:

The module with the name XXXXXXXX cannot be loaded by VSUM. Verify that the modules are all contained in a library available to the job and try the function again.

VSUM-ERR996 *** VSUM HAS EXPIRED, CONTACT VENDOR SUPPORT.


MODULE:VSUM

EXPLANATION:

The software license or trial expiration date has expired. Check with your system programmer or call Connectivity Systems technical 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 Connectivity Systems technical support for software renewal information.


9Reprint of Reports

Overview The VSUM REPRINT function reprints 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.

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 Key range report per VSUM command. With the use of the FROM and TO parameters, all the Dataset Reports for a dataset over a given period of time can be reprinted.

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 of time. With the statistical records described to SAS, for example, many monthly or yearly trends could be graphed or reported on.



REPRINT Parameter Descriptions

CACOUNT This parameter specifies how many control areas are to be reprinted for a dataset. This parameter causes a partial dataset analysis to be performed. A partial dataset analysis can only be done for control areas that were saved on the initial run.

Parameter syntax CACOUNT (number)


Mutually exclusive parameters: CAVOLUME CAEND

Abbreviations: CACNT

CAEND This parameter specifies the last control area in the VSAM dataset to be reprinted. If a number is specified, the reprint stops after the control area is processed. If a quoted string is specified the reprint stops after the control area that contains a key greater than or equal to the quoted string. This parameter causes a partial dataset reprint to take place, and can only be done if the statistics were saved on the original run.

Parameter syntax CAEND (number qstring)



The variable qstring is 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 This parameter specifies whether or not the CONTROL AREA GRAPH report for the control areas that were analyzed are printed. Optionally, the control areas that are graphed can be limited to those control areas that are: full; not full; 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 are graphed.



Parameter syntax CAGRAPH (YES | NO | OVERLAY FULL NOTFULL EMPTY SPLIT LOSTCI FREESPACE (pct | 0 < :cond | GE ]) LINECNT(number | 55 ))


This table describes the sub-parameters and associated variables for the CAGRAPH parameter.

Abbreviations: CAG


YES | NO | OVERLAY Indicates whether or not the control area graph should be reprinted. If “YES” or “OVERLAY” is specified, the control area graph is reprinted and the “CAGRAPH” DLBL statement is required. “OVERLAY” causes the control interval and byte graph lines to overlay each other and decrease the number of lines in the graph by 50%.

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.

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 split or were used for a split are reprinted. The original run cannot have specified this parameter with the CASAMPLE parameter.

LOSTCI Indicates that, of the control areas saved, those that do have or might have lost or unusable control intervals because of poor key compression or an insufficient index control interval size are 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: FSPCDefaults: NO,LINECNT(55)Abbreviations: CAG

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



CAREPORT This parameter specifies whether or not the CONTROL AREA REPORT should be reprinted for the control areas that are saved, from the statistics on the dataset specified in the CASTATS parameter. Optionally, the control areas that are reprinted can be limited to those control areas that are; full; not full; 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 are reprinted.

Parameter syntax CAREPORT (YES | NO FULL NOTFULL EMPTY SPLIT LOSTCI FREESPACE (pct | 0 < :cond | GE ]) LINECNT(number | 55))


This table describes the sub-parameters and associated variables for the CAREPORT parameter.


YES | NO Indicates whether or not to reprint the control area report. If “YES” is specified the control area report is reprinted.

Refer to the CAGRAPH parameter for an explanation of the “FULL NOTFULL EMPTY SPLIT LOSTCI FREESPACE and LINECNT sub-parameters.

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.

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 split or were used for a split are reprinted. The original run cannot have specified this parameter with the CASAMPLE parameter.

LOSTCI Indicates that, of the control areas saved, those that do have or might have lost or unusable control intervals because of poor key compression or an insufficient index control interval size are reprinted.



Abbreviations: CAR

CASTART This parameter specifies which control area to begin reprinting with. If a number is specified, the reprint starts with that control area. If a quoted string is specified, the reprint starts with the control area that contains a key greater than or equal to the quoted string. This parameter causes a partial reprint to be performed.

Parameter syntax CASTART (number | qstring)


The value number is a numeric value from 1 to 9999999.

The value qstring is 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 This parameter specifies the name of the DLBL statement for the dataset that used to save the CONTROL AREA GRAPH, CONTROL AREA REPORT, and CONTROL INTERVAL REPORT statistics.

Parameter syntax CASTATDD (ddname | CASTATS /readpw)


If the statistical file is a VSAM ESDS and is read password protected, the read password must be specified if you do not want the MVS operator to be prompted for the dataset password.

Defaults: CASTATS

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: FSPCDefaults: NO,LINECNT(55)

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




Abbreviations: CASTDD, CADD

CAVOLUME This parameter specifies a single volume in a multi-volume dataset that is reprinted. If this parameter is specified a partial dataset reprint will be performed.

Parameter syntax CAVOLUME (volser)


Mutually exclusive parameters: CACOUNT CAEND CASTART

Abbreviations: CAVOL

CIREPORT This parameter specifies whether to reprint the CONTROL INTERVAL REPORT for selected control areas. This report can produce a large volume of output. Limit the CONTROL INTERVAL REPORT to those control areas that need to be analyzed at the control interval level. This report can be very useful in analyzing the effect of current control interval freespace if printed for one control area after records are inserted into the dataset.

Parameter syntax CIREPORT (YES | NO LINECNT(number | 55 ) FROMCA(number | 1 COUNT(number | 1 ))


This table describes the sub-parameters and associated variables for the CIREPORT parameter.

Operand Description

YES | NO Indicates whether to reprint the control interval report. If “YES” is specified, the control interval report is reprinted.

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, no control interval report is printed. The number can range from 0 to 999999999.



DSREPORT Specifies whether to reprint the DATASET REPORT from the dataset statistics on the dataset specified in the DSSTATDD parameter.

Parameter syntax DSREPORT (YES | NO)


The values YES or NO indicate whether to reprint the dataset report.The default is YES and will cause a single page dataset report to be printed for the dataset specified in the REPRINT function.

Abbreviations: DSR

DSSTATDD Specifies the DLBL statement name for the dataset that contains the statistics and is used to reprint the DATASET REPORT.

Parameter syntax DSSTATDD (ddname | DSSTATS /readpw)


If the statistical file is a VSAM ESDS and is read password protected, the read password should be specified if you do not want the MVS operator to be prompted for the dataset password.

Defaults: DSSTATS


FROM Specifies the date to be used as a search argument against the statistical files to start reprinting the requested reports.

Parameter syntax FROM (mmddyyyy | mm/dd/yyyy | yyyyddd)


You can specify the date in either Julian or Gregorian format.

Defaults: (null)

KRREPORT Specifies whether to reprint the KEYRANGE REPORT and also which high or low key ranges to 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 are the highest and lowest within the control areas saved.

COUNT Indicates for how many control areas the control interval report is reprinted. It reprints 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

Operand Description



Parameter syntax KRREPORT (DSLO DSHI CALO CAHI CIHI CILO LINECNT(number | 55))

This table describes the sub-parameters and associated variables for the KRREPORT parameter.

NAME Specifies the fully qualified name of the VSAM dataset to be reprinted.

Parameter syntax NAME (dsname/cntrlpw)

Attribute Defaults: (null)

TO Specifies the date to be used as a search argument against the DSSTATS statistical files to stop reprinting the specified DSREPORT(s).

Parameter syntax TO (mmddyyyy | mm/dd/yyyy | yyyyddd)

Variables and attribute

You can specify the date values in either Julian or Gregorian format.

Defaults: (null)

RECOMMENDA-TIONS

Defines the types of recommendations that VSUM makes about the dataset being reprinted. Refer to the section “Dataset Recommendations“ for a detailed description of the RECOMMENDATIONS parameter and sub-parameters available.


DSHI Indicates to VSUM to reprint that the highest key in the dataset.

DSLO Indicates to VSUM to reprint the lowest key in the dataset.

CAHI Indicates to VSUM to reprint the highest key in each control area analyzed should be reprinted.

CALO Indicates to VSUM to reprint the lowest key in each control area analyzed.

CIHI Indicates to VSUM to reprint the highest key in each control interval of each control area analyzed.

CILO Indicates to VSUM to reprint the lowest key in each control interval of each control area analyzed.

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



Parameter syntax RECOMMENDATIONS (…)



Examples of Use

Reprint a KSDS Dataset Report

This example will cause the statistics for VSAM.KSDS to be reprinted producing a single page dataset report.

// EXEC PGM=VSUM // DLBL DSSTATS,’VSUM.DSSTATS.FILE’ REPRINT NAME(VSAM.KSDS) DSSTATDD(DSSTATS) /*

Reprint DSReport and Control Area Graph for a KSDS

This example will cause dataset VSAM.KSDS to have the dataset report reprinted and its control area space utilization graph to be reprinted.

// EXEC PGM=VSUM // DLBL DSSTATS,’VSUM.DSSTATS.FILE’ // DLBL CASTATS,’VSUM.CASTATS.FILE’ REPRINT NAME(VSAM.KSDS) CAGRAPH(YES) - DSSTATDD(DSSTATS) CASTATDD(CASTATS) /*

Reprint DSReport and CAReport for Single Volume of a KSDS

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.

// EXEC PGM=VSUM // DLBL DSSTATS,’VSUM.DSSTATS.FILE’ // DLBL CASTATS,’VSUM.CASTATS.FILE’ REPRINT NAME(VSAM.KSDS) VOLUME(VOL002) - DSSTATDD(DSSTATS) CASTATDD(CASTATS) - CAREPORT(YES)} /*

Reprint DSReport and Make Recommendations

This example will cause dataset VSAM.KSDS to have a dataset and a recommendations report reprinted, with recommendations for attributes, buffers, and reorganization.

// EXEC PGM=VSUM // DLBL DSSTATS,’VSUM.DSSTATS.FILE’ REPRINT NAME(VSAM.KSDS) RECOMMENDATIONS(ATTRIBUTES - BUFFERS REORGANIZATION) DSSTATDD(DSSTATS) /*



Reprint a KSDS and Make Recommendations

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.

// EXEC PGM=VSUM // DLBL CASTATS,’VSUM.CASTATS.FILE’ REPRINT NAME(VSAM.AIX) DSREPORT(NO) CACOUNT(1) - CIREPORT(YES,FROMCA(1),COUNT(1)) CASTATDD(CASTATS) /*

Reprint a KSDS Dataset Reports for 1/1/20047 to 2/1/2004

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.

// EXEC PGM=VSUM // DLBL DSSTATS,’VSUM.DSSTATS.FILE’ REPRINT NAME(VSAM.KSDS) DSSTATDD(DSSTATS) - FROM(1/1/1997) TO(2/1/1997) /*


All the reports produced by the REPRINT function are the same reports produced by the ANALYZE and RECOMMENDATIONS functions. Refer to the sections DATASET ANALYZE, and “Dataset Recommendations“for detailed descriptions of the reports and the report fields produced.


10VSUM Online Interface

Overview The VSUM online interface takes requests you make through the online interface and translatestem into a VSUM command. VSUM either executes the command online, or submits the command as a VSE/ESA batch job. VSUM displays output on your terminal, or if submitted for batch processing, prints the output on a printer.

The VSUM Online interface performs these three functions:

• Searches and lists VSAM catalogs based on dataset types and multiple dataset criteria

• Design and allocate VSAM datasets

• Update profiles that automatically create search and list reports


Program Description and Operations Version 1 Release 5.0 VSUM Online Interface

VSUM Online Utility

Primary Option Menu

The Primary Option Menu allows you to select from searching and listing existing datasets, designing new datasets, and adjusting your profile for output reports.

VSUMPRIM--------------- VSUM - PRIMARY OPTION MENU ----------------------- COMMAND ==> INPUT TRACE==> L - SEARCH AND LIST VSAM CATALOG(S) -- <<< EXTENDED SEARCH >>> D - DESIGN AND ALLOCATE VSAM DATASET(S) P - PROFILE UPDATE



List and Search Utility

List Selection Menu

The List Selection Menu displays when you select L from the Primary Option Menu.

To search or list VSUM datasets, enter the letter of the dataset type that you want to search or list. Enter A to search or list all dataset types.

VSUM displays a unique panel of specific parameters for each of the VSAM dataset types. For each panel, VSUM always displays these fields:

VSUMLIST--------------- 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)

Field Description Values

Command A - ALL- All types of datasets.V -VSAM- KSDS, FSDS, RRDS, and AIX datasets.K- KSDS-VSAM key Sequence datasetsE-ESDS-VSAM Entry Sequenced datasetsR-RRDS -VSAM Relative Record datasets.X-AIX-VSAM Alternate Index dataestsP-Path-VSAM Paths

A, V, K, E, R, X or P




Dataset Name

The specific name of the dataset. You can specify either a fully or partially qualified dataset name If the dataset name is partial, you can specify an asterisk in place of a full or partial dataset name level. Up to two asterisks are allowed in a dataset name. You must specify an asterisk as the last character in a dataset name.

A complete or partially qualified dataset name.Examples: *.*.PAYROLLTEST.*.PAYROLLTES*.*.PAYROLLTES*.A*.PAYROLL

Catalog Name/PSWD

The specific name of the VSAM catalog that the VSUM LIST function uses as the source for selecting datasets for processing.


A VSAM catalog name.

Volume The specific volume name used to search the VSAM catalog. For KSDS, AIX, RRDS, and ESDS listings, VSUM limits the listing to the dataset types defined fully or partially on the volume.

A valid volume name

Owner The OWNERID of the VSAM dataset selected for processing. The string can be any valid VSAM OWNERID.

Owner ID

Select Device Types to Search For

The device type selection criterion that VSUM LIST uses to determine which datasets to process.VSUM selects only datasets defined on the specified device type are selected for processing.

Note This field does not appear on the List All Types and List Path Types panels.

Enter Y, for Yes, next to a device type.



List All Datasets The VSUM List All Types panel allows you to search and list from all dataset types based on the criteria on the panel.

The following table lists the options specific to the List All Types panel.

Additional Selection Options

The Additional Selection Options vary depending on what VSAM dataset type you are listing.

Note This field does not appear on the List All Types panel.

See Type specific tables.


VSULALL ----------------- VSUM - LIST "ALL" TYPES ----------------------------- COMMAND==> INPUT TRACE==> NO DATASET NAME ==> CATALOG NAME/PSWD ==> / VOLUME ==> (VOLUME NAME) OWNER ==> (VSAM OWNER ID) SELECT DATASET TYPE(S) TO SEARCH FOR: (Y/N) (CHOOSE 1 OR MORE) ALL ==> Y PATH ==> (TYPE 'ALL' IS MUTUALLY KSDS ==> AIX ==> EXCLUSIVE WITH OTHER ESDS ==> DATASET TYPES) RRDS ==> SELECT DEVICE TYPES(S) TO SEARCH FOR: (Y/N) (CHOOSE ONLY 1) ALL ==> Y 3375 ==> 3380 ==> 3390 ==> 3350 ==> FBA ==> PF1=HELP PF6=PROFILE RECOMMENDATIONS= NO


Select Dataset Type(s) to Search For

Allows you to search or list one or more dataset types.

Note If you enter Y for ALL, the datasets selected must match all criteria.

Y - YesN - No

Recommendations

Provides the required statistical and tuning information about VSAM datasets that would normally be calculated by batch execution.

Yes/No



List VSAM Datasets

The VSUM List VSAM Types panel allows you to search and list from all VSAM type datasets based on the criteria on the panel.

The following table lists the options specific to the List VSAM Types panel.

VSULVSAM---------------- VSUM - LIST "VSAM" TYPES ----------------------------- COMMAND==> INPUT TRACE==> DATASET NAME ==> CATALOG NAME/PSWD ==> / 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 ==> FBA ==> DEVICE TYPES) ADDITIONAL SELECTION OPTIONS: (Y/N) SPEED ==> ERASE ==> (NULL ENTRY YIELDS BOTH OPTIONS) UNIQUE ==> WRITECHECK ==> I.E. ERASE=Y LISTS ERASED ONLY UPDATE ==> REUSE ==> ERASE=N LISTS NOERASE "" ORDERED ==> KEYRANGE ==> ERASE='' LISTS ERASE AND CANDIDATE ==> SPANNED ==> NOERASE IMBED ==> UNIQUEKEY ==> REPLICATE ==> TEMPEXPORTED ==> PF1=HELP PF6=PROFILE RECOMMENDATIONS= NO


Speed VSUM does not write the EOF control interval after each data CI is written during load processing.

Y - YesN - No

Unique VSUM defines the dataset in unique, and not suballocated, dataspace.

Y - YesN - No

Update VSUM can update the data and/or index component.

Y - YesN - No

Ordered VSUM uses the volumes in the order specified.

Y - YesN - No

Candidate VSAM datasets that have a candidate, or empty, volume allocated to them.

Y - YesN - No

Imbed VSUM imbeds the index sequence set into the data components control areas.

Y - YesN - No

Replicate VSUM replicates the high-level index, and sequence set if the Imbed value is N, on a track.

Y - YesN - No



List KSDS Datasets

The VSUM List KSDS Types panel allows you to search and list from KSDS type datasets based on the criteria on the panel.

The following table lists the options specific to the List KSDS Types panel.

Tempexported VSAM datasets that have been temporarily exported are selected for processing.

Y - YesN - No

Erase VSUM overwrites the data component CIs with binary zeros when the dataset is deleted.

Y - YesN - No

Writecheck VSUM tests the data written to the dataset for a data check condition after each write.

Y - YesN - No

Reuse Allows VSUM to reload the dataset without an AMS delete-define.

Y - YesN - No

Spanned VSUM allows records to cross control interval boundaries.

Y - YesN - No

UniqueKey VSUM places every alternate key is in one and only one data record in the base cluster.

Y - YesN - No

Recommendations Provides the required statistical and tuning information about VSAM datasets that would normally be calculated by batch execution.

Yes/No


VSULKSDS---------------- VSUM - LIST "KSDS" TYPES ----------------------------- COMMAND==> INPUT TRACE==> DATASET NAME ==> CATALOG NAME/PSWD ==> / 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 ==> FBA ==> 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 ==> TEMPEXPORTED ==> NOERASE ORDERED ==> KEYRANGE ==> CANDIDATE ==> PF1=HELP PF6=PROFILE RECOMMENDATIONS= NO





Y - YesN - No


Y - YesN - No


Y - YesN - No


Y - YesN - No


Y - YesN - No


Y - YesN - No


Y - YesN - No


Y - YesN - No


Y - YesN - No


Y - YesN - No


Y - YesN - No


Y - YesN - No

Keyrange VSUM places portions of the alternate index’s data component on different volumes. Every portion of the alternate index is called a key range.

Y - YesN - No



List ESDS Datasets

The List ESDS Types panel allows you to search and list from ESDS type datasets based on the criteria on the panel.

The following table lists the options specific to the List ESDS Types panel.


Yes/NoField Description Values

VSULESDS---------------- VSUM - LIST "ESDS" TYPES ----------------------------- COMMAND==> INPUT TRACE==> DATASET NAME ==> CATALOG NAME/PSWD ==> / 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 ==> FBA ==> DEVICE TYPES) ADDITIONAL SELECTION OPTIONS: (Y/N) SPEED ==> ERASE ==> (NULL ENTRY YIELDS BOTH OPTIONS) UNIQUE ==> WRITECHECK ==> I.E. ERASE=Y LISTS ERASED ONLY UPDATE ==> SPANNED ==> ERASE=N LISTS NOERASE "" REUSE ==> TEMPEXPORTED ==> ERASE='' LISTS ERASE AND ORDERED ==> NOERASE CANDIDATE ==> PF1=HELP PF6=PROFILE RECOMMENDATIONS= NO



Y - YesN - No


Y - YesN - No


Y - YesN - No


Y - YesN - No


Y - YesN - No



List RRDS Datasets

The List RRDS Types panel allows you to search and list from RRDS type datasets based on the criteria on the panel.

The following table lists the options specific to the List RRDS Types panel.


Y - YesN - No


Y - YesN - No


Y - YesN - No


Y - YesN - No


Y - YesN - No


Yes/No


VSULRRDS---------------- VSUM - LIST "RRDS" TYPES ----------------------------- COMMAND==> INPUT TRACE==> DATASET NAME ==> CATALOG NAME/PSWD ==> / 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 ==> FBA ==> DEVICE TYPES) ADDITIONAL SELECTION OPTIONS: (Y/N) SPEED ==> WRITECHECK ==> (NULL ENTRY YIELDS BOTH OPTIONS) UNIQUE ==> REUSE ==> I.E. ERASE=Y LISTS ERASED ONLY UPDATE ==> TEMPEXPORTED ==> ERASE=N LISTS NOERASE "" ERASE ==> ERASE='' LISTS ERASE AND ORDERED ==> NOERASE CANDIDATE ==> PF1=HELP PF6=PROFILE RECOMMENDATIONS= NO





Y - YesN - No


Y - YesN - No


Y - YesN - No


Y - YesN - No


Y - YesN - No


Y - YesN - No

Writecheck VSAM texts the data written to the dataset for a data check condition after each write.

Y - YesN - No


Y - YesN - No


Y - YesN - No


Yes/No



List AIX Datasets The List AIX Types panel allows you to search and list from AIX type datasets based on the criteria on the panel.

The following table lists the options specific to the List AIX Types panel.

VSULAIX ----------------- VSUM - LIST "AIX" TYPES ----------------------------- COMMAND==> INPUT TRACE==> DATASET NAME ==> CATALOG NAME/PSWD ==> / 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 ==> FBA ==> DEVICE TYPES) ADDITIONAL SELECTION OPTIONS: (Y/N) REPLICATE ==> ERASE ==> (NULL ENTRY YIELDS BOTH OPTIONS) IMBED ==> WRITECHECK ==> I.E. ERASE=Y LISTS ERASED ONLY SPEED ==> UPDATE ==> ERASE=N LISTS NOERASE "" UNIQUE ==> REUSE ==> ERASE='' LISTS ERASE AND ORDERED ==> TEMPEXPORTED ==> NOERASE CANDIDATE ==> KEYRANGE ==> UNIQUEKEY ==> PF1=HELP PF6=PROFILE RECOMMENDATIONS= NO



Y - YesN - No


Y - YesN - No


Y - YesN - No


Y - YesN - No


Y - YesN - No


Y - YesN - No

UniqueKey VSUM places every alternate key is in one and only one data record in the base cluster.

Y - YesN - No



List Path Type Datasets

The List Path Types panel allows you to search and list from datasets based on the dataset name, catalog name, and owner of the dataset.


Y - YesN - No

Writecheck VSAM texts the data written to the dataset for a “data check” condition after each write.

Y - YesN - No


Y - YesN - No


Y - YesN - No


Y - YesN - No

Keyrange VSUM places portions of the alternate index’s data component on different volumes. Every portion of the alternate index is called a key range.

Y - YesN - No


Yes/No


VSULPATH---------------- VSUM - LIST "PATH" TYPES -------------------------COMMAND==> INPUT TRACE==> DATASET NAME ==> CATALOG NAME/PSWD ==> / OWNER ==> (VSAM OWNER ID)



The following table lists the options specific to the List Path Types panel.


Dataset Name

The specific name of the dataset. You can specify either a fully or partially qualified dataset name If the dataset name is partial, you can specify an asterisk in place of a full or partial dataset name level. Up to two asterisks are allowed in a dataset name. You must specify an asterisk as the last character in a dataset name.


Catalog Name/PSWD




Owner The OWNERID of the VSAM datasets selected for processing. The string can be any valid VSAM OWNERID.

The VSAM owner ID



Designing Datasets

The Design function in the VSUM Online interface allows you to create and test dataset models for efficiency before allocating dataset space.

You can design VSAM KSDS, AIX, ESDS, and RRDS datasets and allocate them online. The VSAM datasets are available immediately for use. VSUM determines the best allocation for the dataset based on any of three processing modes: direct, sequential, or mixed.

The VSUM DESIGN function provides design VSAM datasets in the following ways:

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

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

• Calculates an index control interval size based on a compressed key length for datasets whose keys compress poorly

• Allows you to specify free space in bytes and VSUM automatically calculates how many average record size records will be left free after loading

• Allows you to specify free space in records and VSUM automatically calculates the freespace percentage for each selected control interval size

• Allows you to design alternate indexes and VSUM calculates the maximum recordsize required based on maximum occurrences of the alternate key within the base cluster

• Allows you to make calculations for DASD migration based on a device type.

• Allows for standardized IDCAMS DEFINE parameters using the IDCAMS parameters generated with the VSUM designed feature.

• Calculates the index component size based on the data component size, eliminating excessive or insufficient index allocation.



• Allows you to pre-define datasets without the requirements of needing the DASD space and executing an IDCAMS define

Design Selection Menu

The Design Selection Menu allows you to select the dataset type to design and allocate.

To design a VSUM dataset, enter the letter of the dataset type.

The following are common fields for each of the VSUM Design Datasets panels.

VSUMDESN--------------- 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


Command Enter the associated letter to select the dataset type.K- KSDS-VSAM key Sequence datasetsX-AIX-VSAM Alternate Index datasetsE-ESDS-VSAM Entry Sequenced datasetsR-RRDS -VSAM Relative Record datasets.

K, X, E, and R,


Dataset Name

Name of the dataset that you are modeling. This name is used to name the VSAM cluster, data, and index components.

Example: sample.dsnamesample.dsname.DATAsample.dsname.



Catalog Name

The name of the VSAM catalog where VSUM catalogs the dataset.

Default values: STEPCAT, JOBCAT, ALIAS, MASTER CATALOG

DASD Space Type

The type of DASD space the VSUM allocates for the dataset

CYL-CylindersTRK-TracksREC-Records

DASD Space The amount of DASD space that VSUM allocates for the dataset.

A valid numeric value of 1 to 999999.

Record Size The average and the maximum record size for the dataset being modeled. If the average record size is not entered, the maximum record size is used for the average record size. If the maximum record size is not entered, the average record size is used for the maximum record size. VSUM uses the average record size for all allocation and freespace calculations. If it does not represent a true average records size for the dataset, the modeling output may be excessive or insufficient.

Note For NonSpanned datasets, the maximum record size cannot be greater than the CISIZE minus 7. If the processing mode is specified, the maximum record size influences the chosen data control interval size for NonSpanned datasets and could be selected from the next higher processing mode range. See Processing Mode for more information. For relative record datasets, the values for the average and maximum values must be equal.

The average and maximum values can be valid numeric strings from 1-9999999.




Volume The volume name on which VSUM places the data and index component datasets during dataset allocation. If a design run requires more than a single volume to hold the entire dataset, volumes two through the last are named generically.

Note Change the names of the generically named volumes before dataset allocation.

A valid pre-existing volume name.

Shareoptions The datasets that have a cross region or cross system share option value of what is specified is processed. If datasets with data and index components have at least one component with the specified share option, that dataset will be processed the valid share options all are the same as those for the Share options parameter for the IDCAMS DEFINE command.

1,2,3, or 4 for Region3 or 4 for System

Processing Mode

The processing mode used by programs when the programs open the dataset. VSUM selects 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, 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 is used to determine the best control interval size.

Direct (512 to 4096)Mixed (2048 to 8192)Sequential (4096 to 32768)




Design KSDS Datasets

The Design "KSDS" Datasets panel designs and allocates key sequenced datasets.

The following table describes the fields for the Other Options on the Design "KSDS" Dataset panel.

Space The allocation method used to allocate data space. Either the cluster’s components are allocated space of their own, outside of VSAM data space (Unique), or a portion of previously defined VSE/VSAM data space is used for that component (Suballocate).

S - SuballocateU - Unique

CI Size Data The data component control interval size for the dataset. This value must be a valid VSAM control interval size.

Note For NonSpanned datasets, the value must be at least 7 bytes larger than the specified or defaulted maximum record size.


VSUDKSDS--------------- VSUM - DESIGN "KSDS" DATASET --------------------------COMMAND==> INPUT TRACE==> NO DATASET NAME ==> SAMPLE.KSDS.DATASET (NO QUOTES) CATALOG NAME ==> (NO QUOTES) DASD SPACE TYPE ==> TRK (CYL,TRK,REC) DASD SPACE ==> 1 (1-9999999) DEVICE TYPE ==> (338K,338E,3380,3375, 3350,3390,FBA) RECORD SIZE ==>( 100 , 500 ) (AVERAGE, MAXIMUM) VOLUME ==> (VOLUME NAME) SHAREOPTIONS ==>( 2 , 3 ) (X-REGION, X-SYSTEM) PROCESSING MODE ==> (M=MIXED,D=DIRECT,S=SEQUENTIAL) SPACE ==> S (S=SUBALLOCATE,U=UNIQUE) CI SIZE DATA ==> (MUTUALLY EXCL. WITH PROC. MODE) OTHER OPTIONS: KEYS ==>( 12 , 0 , ) (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 BROWSE= NO ALLOCATE= NO




Keys For indexed datasets, these are the key length and key offset within the VSAM record. The Compress Keyln represents the compressed key length and cannot be larger than the Length value. You can specify it for datasets with poor key compression. If you specify the Compress Keyln, it is used for the index control interval size calculation in place of the standard 5 byte average compressed key length value.

Note If you specify a Compress Keyln value that is smaller than five bytes, the calculated index control interval size may be too small.

Length, Offset, Compress Keyln

Freerecords The value for the control interval and control area free records that VSUM uses for the modeling calculations. The values represent free average record size records. The Number/CI value causes the modeling feature to calculate a corresponding control interval freespace percentage that equates to the specified number of free records. The Number/CA value causes the modeling feature to calculate a corresponding control area freespace percentage the equates to the specified number of free records. The Number/CI and Number/CA values can be valid numeric strings from 0-99999.

Number/CI, Number/CA

Freespace The control interval and control area freespace percentages that VSUM uses for the modeling calculations. The freespace percentages are similar to the IDCAMS DEFINE FREESPACE parameter and represent free bytes for the CI percentage and free control intervals for the CA percentage

CI percentage, CA percentage



Design AIX Dataset

The Design AIX Datasets panel designs and allocates key sequenced datasets.

The following table describes the fields for the Other Options on the Design AIX Dataset panel.

Replicate The high-level index, and sequence set if the value of Imbed is N for No, are replicated or are not replicated on a track.

VSUM imbeds and replicates the index sequence set records on the first track of each data component CA in the indexed dataset.

Y - YesN - No

Imbed VSUM imbeds the index sequence set records on the first track of each data component in the indexed dataset.

Y - YesN - No

Spanned VSUM allows the records in the modeled dataset to span control intervals.

Y - YesN - No

Allocate VSUM defines the file, if you specify Y (Yes). If you specify N (No), VSUM shows you what the file would look like if it had been defined.

Y - YesN - No


VSUDAIX --------------- VSUM - DESIGN "AIX" DATASET --------------------------COMMAND==> INPUT TRACE==> NO DATASET NAME ==> SAMPLE.AIX.DATASET (NO QUOTES) CATALOG NAME ==> (NO QUOTES) DASD SPACE TYPE ==> TRK (CYL,TRK,REC) DASD SPACE ==> 1 (1-9999999) DEVICE TYPE ==> (3350,3380,338E,338K,3390,FBA) RECORD SIZE ==>( 100 , 500 ) (AVERAGE, MAXIMUM) VOLUME ==> (VOLUME NAME) SHAREOPTIONS ==>( 2 , 3 ) (X-REGION, X-SYSTEM) PROCESSING MODE ==> D (D=DIRECT,M=MIXED,S=SEQUENTIAL) SPACE ==> S (S=SUBALLOCATION,U=UNIQUE) CI SIZE DATA ==> (MUTUALLY EXCL. WITH PROC. MODE) OTHER OPTIONS: KEYS ==>( 1 , , ) (LENGTH, OFFSET, COMPRESS KEYLN) FREERECORDS ==>( , ) (NUMBER/CI, NUMBER/CA) FREESPACE ==>( , ) (PERCENT/CI, PERCENT/CA) DUPLICATE KEYS ==> (NUMBER OF DUP. KEYS) BASE KEY LENGTH ==> (1-255) REPLICATE ==> N (Y/N) (DEFAULT=NOREPLICATE) IMBED ==> N (Y/N) (DEFAULT=NOIMBED) BASE CLUSTER NAME ==> (NO QUOTES)PF1=HELP ENTER=EXECUTE PF6=PROFILE BROWSE= NO ALLOCATE= NO




Keys For indexed datasets, these are the key length and key offset within the VSAM record. The Compress Keyln represents the compressed key length and cannot be larger than the Length value. You can specify it for datasets with poor key compression. If you specify the Compress Keyln, it is used for the index control interval size calculation in place of the standard 5 byte average compressed key length value.

Note If you specify a Compress Keyln value that is smaller than five bytes, the calculated index control interval size may be too small.

Length, Offset, Compress Keyln

Freerecords The value for the control interval and control area free records that VSUM uses for the modeling calculations. The values represent free average record size records. The Number/CI value causes the modeling feature to calculate a corresponding control interval freespace percentage that equates to the specified number of free records. The Number/CA value causes the modeling feature to calculate a corresponding control area freespace percentage the equates to the specified number of free records. The Number/CI and Number/CA values can be valid numeric strings from 0-99999.

Number/CI, Number/CA

Freespace The control interval and control area freespace percentages that VSUM uses for the modeling calculations. The freespace percentages are similar to the IDCAMS DEFINE FREESPACE parameter and represent free bytes for the CI percentage and free control intervals for the CA percentage.

CI percentage, CA percentage



Duplicate Keys

For AIX datasets, the maximum number of duplicate alternate keys expected within the base cluster. If not specified, the default is one “1” and VSUM generates the alternate index IDCAMS define parameters with UniqueKeys. If specified, VSUM uses this number to calculate a maximum record size value for non-uniquekeys alternate indexes. If the calculated maximum record size is greater than the maximum record size specified, VSUM uses it for the IDCAMS define generation and minimum bufferspace requirements. When this parameter is specified, the Base Key Length value is required.

A valid numeric string from 1-99999

Base Key Length

For AIX datasets, the length of the base key VSUM uses used in combination with the Duplicate Keys value for the maximum records size calculation. If the base cluster is an ESDS, this value should be 4.

A valid numeric string from 1-255

Replicate The high-level index, and sequence set if the value of Imbed is N for No, are replicated or are not replicated on a track.

VSUM imbeds and replicates the index sequence set records on the first track of each data component CA in the indexed dataset.

Y - YesN - No

Imbed VSUM imbeds the index sequence set records on the first track of each data component in the indexed dataset.

Y - YesN - No

Base Cluster Name

The name of the primary file that is the base for the alternate index.

A valid primary file name.


Yes/No




Design ESDS Datasets

The Design ESDS Datasets panel designs and allocates key sequenced datasets.

The following table describes the fields for the Other Design Options on the Design ESDS Dataset panel.

Design RRDS Datasets

The Design RRDS Datasets panel designs and allocates key sequenced datasets.

VSUDESDS--------------- VSUM - DESIGN "ESDS" DATASET -------------------------- COMMAND==> INPUT TRACE==> NO DATASET NAME ==> SAMPLE.ESDS.DATASET (NO QUOTES) CATALOG NAME ==> (NO QUOTES) DASD SPACE TYPE ==> TRK (CYL,TRK,REC) DASD SPACE ==> 1 (1-9999999) DEVICE TYPE ==> 3380 (3350,3375,3380,338E,338K,3390,FBA) RECORD SIZE ==>( 100 , 100 ) (AVERAGE, MAXIMUM) VOLUME ==> (VOLUME NAME) SHAREOPTIONS ==>( 2 , 3 ) (X-REGION, X-SYSTEM) PROCESSING MODE ==> D (M=MIXED,D=DIRECT,S=SEQUENTIAL) SPACE ==> S (S=SUBALLOCATE,U=UNIQUE) CI SIZE DATA ==> (MUTUALLY EXCL. WITH PROC. MODE) OTHER DESIGN OPTIONS: SPANNED ==> N (Y/N) (DEFAULT=NONSPANNED) PF1=HELP ENTER=EXECUTE PF6=PROFILE BROWSE= NO ALLOCATE= NO


Spanned VSUM allows the records in the modeled dataset to span control intervals

Y - YesN - No


Yes/No



The following table describes the additional fields on the Design RRDS Dataset panel.

VSUDRRDS--------------- VSUM - DESIGN "RRDS" DATASET -------------------------- COMMAND==> INPUT TRACE==> NO DATASET NAME ==> SAMPLE.RRDS.DATASET (NO QUOTES) CATALOG NAME ==> (NO QUOTES) OUTPUT DATASET NAME ==> (SEE HELP) DASD SPACE TYPE ==> TRK (CYL,TRK,REC) DASD SPACE ==> 1 (1-9999999) DEVICE TYPE ==> 3380 (338K,338E,3380,3375, 3350,3390,FBA) RECORD SIZE ==> 100 (1-9999999) VOLUME ==> (VOLUME NAME) SHAREOPTIONS ==>( 2 , 3 ) (X-REGION, X-SYSTEM) PROCESSING MODE ==> D (M=MIXED,D=DIRECT,S=SEQUENTIAL) SPACE ==> S (S=SUBALLOCATE,U=UNIQUE) CI SIZE DATA ==> (MUTUALLY EXCL. WITH PROC. MODE) PF1=HELP ENTER=EXECUTE PF6=PROFILE BROWSE= NO ALLOCATE= NO


Allocate VSUM defines the file, if you specify Yes. If you specify No, VSUM shows you what the file would look like if it had been defined.

Yes/No



Profile For each user, VSUM creates a profile that is invoked when the online VSUM application is started. This profile contains unique information regarding the particular user.

To create or modify a user profile, enter the letter of the profile type

Dataset Analysis Reporting

The Dataset Analysis Reporting Options panel creates a profile that produces reports based on specified parameters. Use the Dataset Analysis Reporting Options parameters to create a report that VSUM uses whenever a foreground or background analysis is needed.

VSUMPROF------------------- VSUM - PROFILE UPDATE ----------------------------- COMMAND==> A - ANALYSIS REPORTING PROFILE D - VSAM DATASET DESIGN PROFILE L - EXTENDED LIST CATALOG PROFILE R - DATASET RECOMMENDATIONS PROFILE


Command Enter the type of profile:

A - Analysis Reporting

D - VSAM Dataset Design

L - Extended List Catalog

R - Dataset Recommendations

A, D, L, or R



The following parameters determine the data presented on the Dataset Analysis reports:

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


Command Not used. Not used.Dataset Report Options

Dataset Report Wanted

Specifies whether the DATASET REPORT should be printed. The default is "YES" and will cause a single page dataset report to be printed for the dataset specified in the ANALYZE function.

Y - YesN - No

Control Areal Report Options

CA Report Wanted

Indicates whether VSUM prints the control area report.

Y - YesN - No



Limiting Parameters

Full|NotFull - Indicates to VSUM to print the full/not full control areas out of the control areas analyzed. A control area is considered to be full when there are no free records.

Empty - Indicates to VSUM to print the control areas that are empty out of the control areas analyzed.

Split - Indicates to VSUM to print the control areas that are out of relative sequence. 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.

LostCI - Indicates to VSUM to print of the control areas analyzed, the control areas that do or could have lost or unusable control intervals because of poor key compression or an insufficient index control interval size.

F- FullN - Not FullE- EmptyS- SplitL-LostCI

Percent Freespace

Indicates to VSUM to print the control areas that have the specified percentage of freespace.

A valid numeric value

# of Lines/Page

The number if lines VSUM prints on a report page.

A valid numeric value between 16 and 999.




Control Area Graph Options

CA Graph Wanted

Indicates whether VSUM prints the control area graph. If you specify Yes (Y) or Overlay (O), VSUM prints the control area graph. Overlay causes the control interval and byte graph lines to overlay each other and decrease the number of lines in the graph by 50.

Note Overlay is not available with the CA Report.

Y - YesN - NoO - Overlay

Limiting Parameters

Full|Not Full - Indicates to VSUM to print the full/not full control areas out of the control areas analyzed. A control area is considered to be full when there are no free records.

Empty - Indicates to VSUM to print the control areas that are empty out of the control areas analyzed.

Split - Indicates to VSUM to print the control areas that are out of relative sequence. 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.

LostCI - Indicates to VSUM to print of the control areas analyzed, the control areas that do or could have lost or unusable control intervals because of poor key compression or an insufficient index control interval size.

F- FullN - Not FullE- EmptyS- SplitL-LostCI

Percent Freespace

Indicates to VSUM to print the control areas that have the specified percentage of freespace.

Y - YesN - No




VSUM Dataset Design Profile

The Dataset Design Profile allows you to

• Edit the IDCAMS input created by VSUM

• Allocate the designed dataset

• Trace the input to VSUM which created the dataset definition

# of Lines/Page

The number if lines VSUM prints on a report page.


Key Range Report Options

Specifies whether to print the Keyrange Report, and also the high or low keyranges you want 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.

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

DSHI, DSLO, CAHI, CALO, CIHI, or CILO




The following parameters determine the data presented on the Dataset Analysis reports:

Extended List Catalog Profile

The Extended List Catalog Profile or Search and List Profile, allows you to use permanent selection criteria in searching a catalog. You can optionally select the profile parameters as extended catalog search parameters by specifying Yes for the Extended Search field.


Command Not used Not usedAutomatic Allocation of the Designed Dataset?

Sets the default value for the Allocate field on the Dataset Design panels.

Y - YesN - No

VSUPDESN--------------- VSUM - DATASET DESIGN PROFILE ---------------COMMAND ==> AUTOMATIC BROWSE OF VSUM GENERATED STATEMENTS? ==> Y (Y/N) AUTOMATIC ALLOCATION OF THE DESIGNED DATASET? ==> Y (Y/N) VSUM INPUT TRACE? ==> N (Y/N)

VSUPLIST-------------- VSUM - SEARCH AND LIST PROFILE ----------------COMMAND ==> 1 - CRITERIA ASSIGNED AT DATA SET DEFINITION TIME (I.E. DSNAME) 2 - CRITERIA ASSIGNED BY CHANGING THE DATASET (I.E. CI SPLITS)



Search/List Dataset Definition Parms

The Search/List Dataset Definition Parms panel allows you to select datasets for reporting based on the dataset size and date parameters.

The following parameters determine the data presented on the Search/List Dataset Definition reports:


Command

Enter the type of Search and List profile:

1 - Criteria Assigned at Dataset Definition Time (such as dsname)

2 - Criteria Assigned by Changing the Dataset (such as CI Splits)

1 or 2

VSUPDEFP-------- VSUM - SEARCH/LIST DATASET DEFINITION PARMS ----------------- COMMAND ==> DATASET NAME ==> CATALOG NAME/PSWD ==> / VOLUME ==> OWNER ==> DATASET DEFINITION SELECTION OPTIONS: SHAREOPTIONS ==>( , ) (X-REGION,X-SYSTEM) FREESPACE ==>( : : ) (I.E. (10:GE 30:LT) ) DATA CI SIZE ==>( : ) (I.E. 8096:EQ) INDEX CI SIZE ==>( : ) (I.E. 2048:EQ) PHYSICAL REC SIZE ==>( : ) (I.E. 1024:EQ) CREATION DATE ==>( / / : ) (I.E. 01/01/86:GE) EXPIRATION DATE ==>( / / : ) (JANUARY 1, 1986) LAST UPDATE DATE ==>( / / : ) ENTER=SAVE AND EXIT


Command Not used. Not used.



Dataset Name

Name of the dataset that you are modeling. This name is used to name the VSAM cluster, data, and index components.


Catalog Name/Pswd




Volume The specific volume name used to search the VSAM catalog. For KSDS, AIX, RRDS, and ESDS listings, VSUM limits the listing to the dataset types defined fully or partially on the volume.

A valid volume name

Owner The OWNERID of the VSAM datasets selected for processing. The string can be any valid VSAM OWNERID.

Owner ID

Dataset Definition Selection Options

Share Options

Specifies to VSUM to process datasets that have a cross region or cross system share option value matching the value specified. If datasets with data and index components have at least one component with the specified share option, VSUM processes that dataset. The valid share options allowed are the same as those for the SHAREOPTIONS parameter of the IDCAMS DEFINE command.

1,2,3, or 4 for Region3 or 4 for System




Freespace Specifies to VSUM to process datasets that have a defined CI or CA freespace percentage equal to the percentage, pct, that you specify. If a conditional is included, then only those datasets that satisfy the percentage and test criteria will be selected for processing.

A valid numeric value and a conditional value.

Data CI Size Specifies to VSUM to process datasets that have a defined CI or CA freespace percentage equal to the percentage, pct, that you specify. If you include a conditional, then VSUM selects only those datasets that satisfy the percentage and test criteria.


Index CI Size

Specifies to VSUM to process datasets whose data components have a control size equal to the you value specify.

The number must be a valid data/index component control interval size. If you include a conditional, VSAM selects only those datasets that satisfy the number and test criteria for processing.


Physical Rec Size

Specifies to VSUM to process datasets whose data component's physical record size is equal to the value you specify. The number must be a valid VSAM blocksize. If you include a conditional, VSUM selects only those datasets that satisfy the number and test criteria for processing.


Creation Date

Specifies to VSUM to process datasets with a specific creation date. If a conditional test is specified datasets whose creation date meet the test criteria are selected for processing.

A valid creation date and a conditional value




Search/List Dataset Execution Parm

The Search/List Dataset Execution Parms allows you to select datasets for reporting based on the dataset execution parameters.

The following parameters determine the data presented on the Search/List Dataset Execution reports:

Expiration Date

Specifies to VSUM to process datasets with a specific expiration date. If you specify a conditional test, VSUM selects datasets whose expiration date meet the test criteria for processing.

A valid expiration date.

Last Update Date

Specifies to VSUM to process datasets with a specific last updated date. If you specify a conditional test, datasets whose last updated date meet the test criteria are selected for processing.

A valid last update date.


VSUPEXEP--------- VSUM - SEARCH/LIST DATASET EXECUTION PARMS -----------------COMMAND ==> CI SPLITS ==>( : ) (0-99999:EQ) VALID OPERATORS: CA SPLITS ==>( : ) (0-99999) (EQ,NE,LT,LE,GT,GE) DATA EXCP RATIO ==>( : ) (0-999) INDEX EXCP RATIO ==>( : ) (0-999) SECONDARY ALLOC. ==>( : ) (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


Command Not used. Not used.



CI Splits Specifies to VSUM to processes only those datasets whose CI splits are equal to or greater than the value you specified. If you specify a conditional test, VSUM processes only those datasets that satisfy the test criterion.

The value can be a valid numeric string from 0-99999.

CA Splits Specifies to VSUM to process only those datasets whose CA splits are equal to or greater than the value you specified. If you specify a conditional test, VSUM processes only those datasets that satisfy the test criterion.


Data Excp Ratio

Specifies that 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)


Index Excp Ratio

Specifies to VSUM to process datasets that have index component EXCP to I/O ratio that are equal to or greater than the value specified. If you specify a conditional test, VSUM processes only those datasets that satisfy the test criterion. 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)





Secondary Alloc.

Specifies to VSUM to process datasets that have gone into secondary allocation for a number equal to or greater than the value you specified. If you specify a conditional test, VSUM processes only those datasets that satisfy the test criterion.

The value can be a valid numeric string from 0-125 and a conditional argument.

Index Levels Specifies to VSUM to choose the datasets that meet the criterion for number of index levels.

The value can be a number between 0 and 10and a conditional argument.

Percent Full Specifies to VSUM to process datasets with a specific amount of data contained in the dataset.

Note If you specify a value for this field, the value for the Empty field must be N for No.


Empty Specifies to VSUM to process only datasets that are empty.

Note If you specify Y for this field, the Percent Full field must be left blank.

Y - YesN - No

Additional Selection Criteria

Free Tracks Specifies to VSUM to process those datasets that have free track values that are equal to or greater than the value specified. If you specify a conditional test, VSUM processes only those datasets that satisfy the test criterion.


Used Tracks Specifies to VSUM to process those datasets that have used track values that are equal to or greater than the value specified. If you specify a conditional test, VSUM processes only those datasets that satisfy the test criterion.





Total Tracks Specifies to VSUM to process those datasets that have allocated track that are equal to or greater than the value specified. If you specify a conditional test, VSUM processes only those datasets that satisfy the test criterion.


Free Cylinders

Specifies to VSUM to process those datasets that have free cylinder values that are equal to or greater than the value specified. If you specify a conditional test, VSUM processes only those datasets that satisfy the test criterion.


Used Cylinders

Specifies to VSUM to process those datasets that have used cylinder values that are equal to or greater than the value specified. If you specify a conditional test, VSUM processes only those datasets that satisfy the test criterion.


Total Cylinders

Specifies to VSUM to process those datasets that have allocated cylinder values that are equal to or greater than the value specified. If you specify a conditional test, VSUM processes only those datasets that satisfy the test criterion.





Dataset Recommendations Profile

The Dataset Recommendations Profile allows you a convenient way to get recommendations about the performance, space utilization, and growth for VSAM datasets.

The following parameters determine the data presented on the Dataset Recommendations reports:

VSUPRECM----------- VSUM - DATASET RECOMMENDATIONS PROFILE --------------------COMMAND ==> DATASET DEFINITION RECOMMENDATIONS: (CHOOSE ONE OR MORE) ALL ==> (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=EVEN,U=UNEVEN); DEFAULT=EVEN PERCENT ==> (TOTAL FREESPACE (1-100)); DEFAULT=DATASET DEFINITION TYPE ==> (B=BYTES,R=RECORDS); DEFAULT=BYTES INSERTRATE ==> (Y/N) MUTUALLY EXCLUSIVE W/FREESPACE PERCENT DATASET SPACE RECOMMENDATIONS: (CHOOSE ONE OR MORE) TYPE ==> (U=USED,A=ALLOCATED,R=RECORDS) DATASET GROWTH ==> (FUTURE GROWTH RATE; (1-100)) NEW DEVICE TYPE RECOMMENDATIONS: (SPACE RECOMMENDATIONS ARE MUTUALLY REQUIRED) DEVICE TYPE ==> (3380,338E,338K,3375,3350,3390,FBA) ENTER=SAVE AND EXIT


Command Not used. Not used.Dataset Definition Recommendations

All Specifies to VSUM to make ATTRIBUTES, BUFFERS, REORGANIZATION, and CISIZE(MIXED) recommendations 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.

Note Note: If you specify Yes for the All field, any other specifications for Dataset Definition Recommendations

Y- YesN - No



Attributes Specifies to VSUM to make dataset attribute recommendations for each dataset processed. The attributes checked and the recommendations made are: RECOVERY, ERASE, WRITECHECK, REPLICATE, SHAREOPTIONS, IMBED.

Y- YesN - No

Buffers Specifies to VSUM to make buffer recommendations for the datasets processed. VSUM makes buffer recommendations for DATA and INDEX components and shows the minimum and maximum buffer numbers required for DIRECT, SEQUENTIAL, and MIXED mode processing. Utilizing the recommended maximum buffers provides significant performance improvements. If you request CISIZE recommendations, the buffer requirement recommendations are based upon the recommended CISIZE.

Y- YesN - No

Reorganization Specifies to VSUM to make reorganization recommendations for the datasets processed. VSUM makes the reorganization recommendations 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).

Y- YesN - No




CI Size Specifies to VSUM to make control interval recommendations for the specified processing mode for the datasets processed. If you specify the New Device Type Recommendations field, the control interval sizes recommended will apply to the new device type.

VSUM selects the most efficient data control interval size based on the specified processing mode and average record size. The average record size used is 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.

DIRECT 512 to 4096

MIXED 2048 to 8192

SEQUENTIAL 4096 to 32768

VSUM calculates the index control interval size 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.

D - DirectS - SequentialM-Mixed




Dataset Freespace Recommendations

Key Insertion Specifies to VSUM to make freespace recommendations based on the specified sub-parameters for the datasets processed. VSUM calculates the VSAM control interval and control area freespace percentages based on the even or uneven distribution of a single percentage of free bytes or free average record size records.

Specify Even (E) freespace when the keys of the inserted records are evenly distributed throughout the dataset. Specify Uneven (U) freespace when the keys of the inserted records are unevenly distributed (grouped) throughout the dataset.

If the New Device Type Recommendations field is also specified, the freespace recommendations will apply to the new device type.

Even distribution is a 3 to 1 ratio for control interval freespace and control area freespace respectively. If a freespace percentage (Percent) of forty percent (40) is specified, then thirty percent (30) of the bytes in a control area are allocated to control interval freespace and ten percent (10) are allocated to control area freespace.

Uneven distribution is a 1 to 3 ratio for control interval and control area freespace respectively.

E - EvenU - Uneven




Percent Specifies the single percentage of freespace. If the Insertrate field 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 Insertrate field is not specified and there is no freespace defined for the dataset, VSUM does not make the freespace recommendations.

The Percent field value can be a percentage from 1 to 100 and represents a single percentage to be distributed evenly or unevenly in the dataset.

A valid percentage value of 1 to 100.

Type Bytes (B) indicates that the single percentage used for the freespace calculations represents bytes. The Bytes value is ignored if Insertrate is also specified. Records (R) indicates that the single percentage used for the freespace calculations represents free average record size records. If the Insertrate value or Records is specified, the average record size used will be the defined average for LIST functions, and the calculated average for LIST ANALYZE and ANALYZE functions.

B- BytesR - Records

Insertrate The Insertrate value indicates that instead of specifying an explicit percentage or using the defined percentage(s), VSUM calculates the logical record insertion rate and uses 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 you specify the Insertrate value.

Y- YesN - No




Dataset Space Recommendations

Type Specifies to VSUM to make space allocation recommendations based on the specified fields for the datasets processed. If you specify the New Device Type Recommendations: Device Type field, the allocation recommendations will apply to the new device type. The data component space recommendations will be made according the Type field value (Used, Allocated, or Records.) VSUM makes the index component space recommendations according to the recommended data component space allocation amount and not on the existing allocation amount.

Used - the space recommendation are to be made based on the number or equivalent number cylinders or tracks currently used (not free) in the data component.

Allocated - 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.

Records - 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.

U- UsedA - AllocatedR - Records

Dataset Growth

Specifies the growth rate or additional percentage to be added to the cylinder, track, or record value VSUM uses for the data component space calculations.

The field value can be a valid numeric percentage from 1 to 100.




New Device Type Recommendations

Device Type Specifies to VSUM to make the CISIZE, FREESPACE, and SPACE recommendations a for the datasets processed based on the new device type.

3380, 338E. 338K, 3375, 3350, 3390, FBA



Appendix A

Statistical Files The VSUM historical facility for dataset statistics requires two (2) statistical files. You must allocate these statistical files 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 DLBL names for these two statistical files are:

// DLBL DSSTATS ........ // DLBL CASTATS ........

Dataset Characteristics

These files are defined as a VSAM ESDS dataset. The following VSAM ESDS information should be used as a reference for creation of the historical files.

ESDS:DEFINE CLUSTER RECSZ (600 5492)

Space Requirements

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.

DSSTATS File

Copyright © 2005 by Connectivity Systems, Inc. A.1

Program Description and Operations Version 1 Release 5.0 Appendix A

• DSREPORTOne DS record per file processed.

• Record Sizes:

— DS Record:5492 bytes (maximum)

— CA Record:92 bytes + (Keylen * 2)

— CI Record: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 a large number of control areas.

Record Descriptions

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 generate the indicated record descriptions.

Dataset Record Description

DSRECORD DSECT VSUMRECS PFIX=xx,RECTYPE=DS

Control Area Record

Description

CARECORD DSECT VSUMRECS PFIX=xx,RECTYPE=CA

Control Interval Record

Description

CIRECORD DSECT VSUMRECS PFIX=xx,RECTYPE=CI

Note xx = Two-character label prefix of your choice that be part of each symbol generated.


Program Description and Operations Version 1 Release 5.0 Appendix A

Analyze Command User Exit

If you want to intercept the records that are written to the VSUM statistical file(s) during an ANALYZE function, you can specify the STATEXIT parameter in the command. The STATEXIT parameter refers to a valid load module that is 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:

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 CNTL 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 is always a dataset record. The first dataset record does not have all the statistical fields set and is used only to identify the dataset name being processed. The second or last dataset record is a complete dataset record with all statistical fields set. After the first dataset record is passed, the first and succeeding control interval records are passed followed by the control area record for those control intervals. This sequence is repeated for each control area processed. The second dataset record is your last record received for each dataset. Each record is in standard variable length format with a four-byte field in the beginning of each record followed by a record type byte. Refer to the “VSUMRECS” macro in section “Record Descriptions “for information on how to get a printed description of each type of VSUM statistical record.


Appendix B

Command and Parameter Abbreviations

Analyze Command

ANALYZE COMMAND: ABBREVIATIONS: ANALYZE ANAL, A 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 RECOMMENDATIONS RECOMMEND, RECOMM STATEXIT VSAMINDD VINDD, INDD

Copyright © 2005 by Connectivity Systems, Inc. B.1

Program Description and Operations Version 1 Release 5.0 Appendix B

List Command 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 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



List Command (continued)

LIST COMMAND: (cont.) ABBREVIATIONS: 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 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



Model Command

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



Recommenda-tion Command

RECOMMENDATION COMMAND: ABBREVIATIONS: RECOMMENDATIONS RECOMMEND, RECOMM ALL ATTRIBUTES ATTRIBUTE, ATTR BUFFERS BUFF, BUF CISIZE CISZ FREESPACE FSPC NEWDEVICETYPE NEWDEVICE, NEWDEV REORGANIZATION REORGANIZE REORG SPACE



Reprint Command

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


restricted rights legend

Documents