Allocate New Dataset panel

The Allocate New Dataset function is the same function as the Allocate Data set option of the ISPF Dataset Utility.

To allocate a new non-VSAM data set, fill in the following fields on the Dataset Utility screen (Dataset Utility Screen):

  • Enter A in the select option field to allocate a non-VSAM data set, either a non-SMS managed or an SMS managed data set using the extended fields and options for SMS data sets.
  • Enter the new data set name in the data set name field.
  • If the data set is to be cataloged in a catalog which is not connected to the master catalog through the high level qualifier, enter the catalog name in the catalog name field and the catalog Password in the catalog password field, if necessary.
  • Enter a model dataset name if the new data set is to have the same allocation characteristics as an existing data set. The model data set must be cataloged and must be accessible through a normal catalog search. If no model is specified, attributes from the last data set information display or allocation are used.

When you press Enter, File-AID displays the Allocate New Dataset screen, shown in the following figure.

Important

Option A now includes allocating SMS data sets (formerly option M).

File-AID --------------- Allocate New Dataset -------------------------------
COMMAND ===>
Dataset name: USERID9.FASAMP.NEW

  Management Class    ===>         (Blank for default)
  Storage Class       ===>         (Blank for default)
  Data Class          ===>         (Blank for default)
  Volume serial       ===> P13003  (Blank for authorized default volume)
  Generic unit        ===>         (Generic group name or unit)
  Space units         ===> CYLS    (BLKS; TRKS; CYLS; KB; or MB)
  Primary quantity    ===> 5       (In above units)
  Secondary quantity  ===> 1       (In above units)
  Directory quantity  ===> 0       (Partitioned only)
  Record format       ===> FB
  Record length       ===> 80      (Use 32768 for LRECL=X)
  Block size          ===> 3200
  Multi Volume        ===> N        (Y, N or 2-59)
  Expiration date     ===>          (YYYY/MM/DD or blank)
  Dataset Name Type   ===>          (Library, PDS, LArge, Basic, EXTReq,
                                     EXTPref or blank)
  Dataset Version    ===>          (For PDSE only)
  Maximum Generations ===>          (For Version 2 PDSE only)
  Keylabel      (Name of the Key Label to be used for encryption)
   ===>  .........................................................

Field Descriptions

If you specified a model dataset name, the displayed attributes are those of the model data set. If a model dataset name was not specified, the attributes are those of the last referenced data set. You can accept the displayed values or change them by overtyping.

Dataset name

Name of new data set specified on the Dataset Utility screen.

Management Class

Specify the SMS management class to use for the allocation of the data set. The management class describes the migration, backup, and retention for the data set.

Storage Class

Specify the SMS storage class to use for the allocation of the data set. The storage class describes the hardware requirements of the data set.

Data Class

Specify the SMS data class to use for the allocation of the data set. The data class describes the attributes of the data set such as RECORG, KEYLEN, KEYOFF, SPACE, etc.

Volume serial

Specify the volume serial of the direct access device that you want to contain the data set. Specify the location in either the Volume serial or Generic unit field. If blank, eligibility is determined by the "unit" information in your user entry in the TSO "user attribute dataset" (UADS) or SYSDA.

Important

  1. The data set will be cataloged with the volume serial used to allocate the data set (unless overridden by a DASD management product).
  2. You may be limited to eligible volumes even when you specify the volume serial. In other situations you may specify any mounted volume. This is an option of the installation.

Generic unit

Generic unit address for the direct access volume to contain the data set. Specify the location in either the Volume serial or Generic unit field.

Space units

Specify one ofthe following storage unit types depending on how the data set size is expressed:

BLKS - Number of blocks
TRKS - Tracks
CYLS - Cylinders
KB - Kilobytes
MB - Megabytes

Primary quantity

Specify the primary allocation quantity as specified in the space units field.

Secondary quantity

Specify the secondary allocation quantity as specified in the space units field.

Directory quantity

For a PDS, specify the number of directory blocks. For a Sequential data set, specify zero (0).

Important

Number of member entries in a directory block:

  • 6 block entries for data sets with PDS statistics.
  • 21 block entries for data sets without PDS statistics.
  • 5 to 7 block entries for Load Module data sets depending on attributes.

Record format

Specify a value with a combination of the following codes (F, V, or U is required. The record format is verified as being correct for the particular access method being allocated.):

F - Fixed length
V - Variable length
U - Undefined format
B - Blocked
A - ANSI printer control characters
M - Machine code printer control characters

S - For Sequential data sets only: Standard for F or spanned for V.
T - Track-overflow feature

Important

S and T may be specified in the record format field, but track overflow is not supported by File-AID.

Record length

Specify a logical record length, in bytes, of the records to be stored in the data set. File-AID validates this value with the record format and block size.

On the Record length line, (Use 32768 for LRECL=X) is displayed.

Block size

Specify the physical record length, in bytes, of the blocks to be stored in the data set. File-AID validates this value with the record format and record length.

Important

For DFSMS users, if you specify 0 or do not enter a block size, the system determines an optimum block size for the direct access device assigned to the data set.

Multi Volume

Specify whether you want to allocate the data set on multiple volumes.

You may specify N (No) to use your SMS default, or a number from 2 to 59 for the number of generic volumes to allocate. Specify Y only if you want to designate specific volumes which you will type in. If you specify Y, File-AID/MVS displays the Specify Volume Serial Numbers pop-up, where you may enter up to 40 specific volume serial numbers.

Expiration date

(Optional) Specify a date value in the format: YYYY/MM/DD. This value specifies the date when the data set may be deleted. If this field is left blank, the data set can be deleted immediately.

Dataset Name Type

Specify the type of Sequential or Partitioned dataset to allocate. Valid entries are:

Library

Partitioned Dataset Extended (PDSE). This type of partitioned data set has unlimited directory blocks and reuses its own space. PDSE libraries do not need to be compressed.

PDS

Standard partitioned data set.

LArge

Large sequential data set. The initial allocation of the data set does not have to exceed 65,535 tracks; the combined space allocated by primary and secondary allocations is allowed to exceed 65,535 tracks when the data set is allocated as LARGE. There is still a limit of 16 extents for data set allocation.

Datasets defined with DSNTYPE=LARGE can be either SMS or non-SMS managed.

Basic

Type of Sequential data set which must allocate less than 65K tracks.

EXTReq

A sequential data set that is required to be extended format.

EXTPref

A sequential data set that is preferred to be extended format.

blank

Data set is not partitioned.

Dataset Version

Specify the PDSE version number (valid for a PDSE only). (Blank or 0 = the system default, 1 = Version 1, 2 = Version 2)

Maximum Generations

Specify the maximum number of generations that should be kept available for this PDSE. (Valid for Version 2 PDSE only). It must not exceed the system maximum set by your z/OS Administrator. (0 = System Maximum)

When the maximum number of generations is exceeded, the generations are rolled, dropping the lowest relative generation. For example, if maximum is 10, relative generation -10 would be dropped.

Keylabel

Identifies the name, up to 64 bytes, of the keylabel to be used to encrypt the new data set. (Only valid for extended format sequential or Version 2 PDSE).

Press Enter to allocate the data set, or use the END command (PF3) to cancel the allocation. When allocation is complete, File-AID displays the message: DATASET ALLOCATED in the upper-right corner of the Dataset Utility screen. If an error occurs (such as duplicate dataset name), File-AID displays the appropriate error message. Use the HELP command (PF1) to obtain information on the error.

Related topics

Dataset-Utility-panel

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*