Previous Topic: Define VSAM FilesNext Topic: Define Alternate Index File


Field Descriptions

Component DSNs:
Data

Updates the DSN of the data component of the VSAM file being defined. The DSN defaults to the cluster name with '.DATA' appended.

Index

Updates the DSN of the index component of the VSAM file being defined. The DSN defaults to the cluster name with '.INDEX' appended.

VSAM file type

Type one of the following values to indicate the VSAM file type. If the first letter of one of the valid values is typed, the rest of the VSAM File Type appears in the field.

K–KSDS

Key Sequence Data Set

E–ESDS

Entry Sequence Data Set

R–RRDS

Relative Record Data Set

L–Linear

Linear Data Set

Allocation:
Volume

Type the volume serial number of the volume that contains the data and index components of the VSAM file being defined.

If either the data or index component requires multiple volumes, type the first volume in this field and set the Multiple Volumes? option field to Y.

This requests a screen where the remaining volumes can be typed.

CI size

Type a control interval size for the data component and, if applicable, for the index component.

Unit

Specify the space allocation unit for the VSAM file component. The primary and secondary allocations are in the specified units.

Type the first position of one of the following valid values. The rest of the Allocation Unit appears in the field.

T–TRKS

Tracks

C–CYLS

Cylinders

R–RECS

Records

K–K

KB (Kilobytes)

M–M

MB (Megabytes)

Primary

Type the primary allocation amount for the VSAM file component. The amount of space allocated in the primary allocation is the specified number of tracks, cylinders, records, KB, or MB depending on the allocation unit.

Secondary

Type the secondary allocation amount for the VSAM file component. The amount of space allocated in each secondary allocation is the specified number of tracks, cylinders, records, KB, or MB depending on the allocation unit.

Key position

If the VSAM file being defined is a KSDS file, type the position of the key. The Key position value is specified as a position and not as a displacement. For example, if the key begins in the first position of the record, type a value of 1.

Key length

If the VSAM file being defined is a KSDS file, type the key length.

Avg record size

Type average length of records in the data component.

Max record size

Type length of records of the largest record that may be in the data component. For RRDS data sets, if the Maximum Record Size is equal to the Average Record Size, the VSAM file is allocated as an RRDS file without an index component; otherwise, the VSAM file is allocated as a variable RRDS file, which has an index component.

Expiration Date

If the VSAM cluster may be deleted after a certain date, type an Expiration Date in CCYYMMDD format.

Owner ID

This optional field can be used to specify an owner that is to be associated with the VSAM file being allocated. If the Owner ID is not specified, the TSO User ID is defined as the owner

Percent Free – CI & CA

CI – Type the amount of empty space to be left in each Control Interval when the file is initially loaded. The freespace lets records be inserted or expanded within a Control Interval before requiring a Control Interval split.

CA – Type the percentage of Control Intervals to be left unused in each Control Area as the file is initially loaded. The use of Control Area freespace lets some Control Interval splits occur before requiring a Control Area split.

Share options

Cross Region

Type a value of one- to –four to indicate how the file can be shared among regions within the same system or within multiple systems using GRS (Global Resource Serialization). The meaning of each value is as follows

1

The data set can be opened for read processing by an unlimited number of users, but the data set can be accessed by only one user when that user is doing read and write processing.

2

The data set can be opened by only one user at a time for read and write processing, but any number of users can also be accessing for read processing.

3

The data set can be fully shared by any number of users.

4

The data set can be fully shared by any number of users. VSAM immediately updates the data set for PUTs and refreshes all input buffers for GETs.

Cross-System

Type a value of 3 or 4 to indicate how the file can be shared among systems.This is the second of the two numbers displayed. The meaning of each value is:

3

The data set can be fully shared by any number of users.

4
Buffer space

Optional field used to specify the minimum buffer space to be allocated when this VSAM file is accessed.

If you do not specify this parameter, VSAM uses the default of two times the data CISIZE plus the index CISIZE if the file is indexed.

Options:
Multiple volumes?

When the data or index component of the VSAM file requires multiple volumes, set the Multiple Volumes? Field to Y to request a screen into which you can type the volume serial for additional volumes.

Load Restartable?

Type Y for the Load Restartable? option to request that the VSAM component definition use the RECOVERY parameter causing the data component to be preformatted previous to the initial load. Using this option causes the initial load to take longer, but loads that do not complete successfully can be restarted.

Type N for the Load Restartable? option to request that the VSAM component definition use the SPEED parameter causing the data component to not be preformatted previous to the initial load.

Erase on delete?

Type Y for the Erase on Delete? option to request that the VSAM component definition use the ERASE parameter causing all components of the file to be overwritten with binary zeros when the VSAM file is deleted from the catalog. Type N to define the VSAM component with the NOERASE parameter

Write check?

Type Y for the Write check? option to request that the VSAM component definition use the WRITECHECK parameter requesting each write to the VSAM file to be validated by a read without data transfer. Type N to define the VSAM component with the NOWRITECHECK parameter.

Replicate index?

Type Y for the Replicate Index? option to request that the VSAM component definition use the REPLICATE parameter requesting that the index records are replicated on a track as many times as it will fit. Type N to define the VSAM component with the NOREPLICATE parameter. Use of the REPLICATE parameter improves the time required to access index records, but usually causes the index to require more space.

Spanned records?

Type Y for the Spanned records? option to request the VSAM file to be allocated with the SPANNED parameter indicating that data records larger than a control interval are allowed to span multiple control intervals. Type N to request the VSAM file to be allocated with the NONSPANNED parameter. If you allocate your data set with the NONSPANNED parameter and the specified Maximum Record Size is greater than the Data Control Interval Size, VSAM automatically adjusts the Data Control Interval Size to be greater than or equal to the Maximum Record Size.

SMS Class:
Storage

Type the one-to-eight-position name of the SMS Storage Class to be used when allocating the VSAM file. The storage class can be used to control the storage hardware used for the data set.

Data

Type the one-to-eight-position name of the SMS Data Class to be used when allocating the VSAM file. The SMS data class can be used to control the attributes of the data set being allocated

Management

Type the one-to-eight-position name of the SMS Management Class to be used when allocating the VSAM file. The SMS Management Class can be used to control data set characteristics related to the backup, migration, and retention of the data set.