Allocate BDAM Dataset panel

Specify the letter B in the OPTION field and a valid dataset name in the Dataset name field of the Dataset Utility screen to display the Allocate New Direct Dataset screen, shown in the following figure. The Allocate New Direct Dataset screen allocates a BDAM data set.

Allocate New Direct Dataset screen

File-AID --------------- Allocate New Direct Dataset -------------------------
COMMAND ===>

Dataset name: USERID9.FASAMP.NEW

                                       Specify one of the following two fields
    Volume serial      ===> PRD906     (Blank for authorized default volume)
    Generic unit       ===>            (Generic group name or unit)

    Space units        ===> TRKS       (TRKS; CYLS; BLKS)
    Primary quantity   ===> 1          (In above units)
    Secondary quantity ===> 1          (In above units)
    Record format      ===> FB
    Option codes       ===>            (A = actual blk;
                                        R = relative search;
                                        E = extended search;
                                        F = feedback;
                                        W = write check option)
    Record length      ===> 80
    Block size         ===> 80
    Key length         ===> 0          (0 - 255)
    Expiration date    ===>            (YYYY/MM/DD or blank)

Field Descriptions

The displayed values can be accepted or changed by overtyping them.

Dataset name

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

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.

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

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.

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.

Option codes

Specify one of the following values:

A - Requires actual device addresses to be used when performing read or write macros (MBBCCHHR).

R - Requires relative block addresses to be used when performing read or write macros.

E - Processes extended search of more than one track for a block of available space if LIMCT is coded as one or greater.

F - Enables feedback requests when using read and write macros.

W - Requests a validity check on DASD or tape when performing a write macro.

Important

The record length and block size are verified to be consistent with the record format as defined in the IBM MVS data management documentation for non-VSAM data sets.

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.

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.

Key length

If a key is present, specify a value that is greater than zero.

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.

Press Enter to allocate the data set, or use the END command (PF3) 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.