FDRCRYFM FORMAT Statement

FORMAT statement

FORMAT pre-formats the FDRCRYPT Encryption Keyfile, pointed to by the ENCRYPT DD statement. You must execute a FORMAT operation on a Encryption Keyfile before it can be used by FDRCRYPT.

FORMAT statement syntax

FORMAT
	,B=2|n
	,ENABLE=([DYNALLOC][ERASE][RESERVE])
	,RECS=nnnnnnn

FORMAT statement operands

B=

n

Specifies the number of blocks to be placed on each track, from 2 through 5. FDRCRYFM automatically calculates the best blocksize for this device type.

Default: 2 (half track blocking) unless overridden in the FDR Global Options.

ENABLE=

The options specified are enabled for this FORMAT operation. Multiple options are enclosed in parentheses and separated by commas. The options and their meaning if enabled are:

DYNALLOC

Dynamically allocates the Encryption Keyfile specified in the FDR Global Options, if the ENCRYPT DD statement is omitted.

ERASE

Allows an existing, formatted Encryption Keyfile to be reformatted that lose all encryption keys previously recorded in that file. This is usually appropriate only when erasing a Encryption Keyfile when leaving a disaster site. By default, a format can only be done to a newly allocated control file.

RESERVE

Protects the formatting with a RESERVE against the volume on which the Encryption Keyfile resides.

RECS=

nnnnnnn

Specifies the minimum number of backup entries that are formatted on the Encryption Keyfile. The highest value that can be specified varies with the DASD device type, blocking factor, and size of the file. With the default blocking factor B=2, the file can contain a maximum of 131070 blocks, which requires 65535 tracks. If the file is on a 3390 DASD, this translates to a maximum value for RECS= of 22806180. Sufficient space must be allocated to the file to contain the required number of entries, otherwise FORMAT fails.

If SPACE= does not include the RLSE operand (or SPACE= is omitted for an existing file), then FDRCRYFM formats all tracks of the initial allocation. If this is insufficient to hold the required number of records and a secondary allocation quantity was specified in SPACE=, FDRCRYFM takes secondary allocations until the space is sufficient, and formats all of the secondary tracks.

Therefore, FORMAT formats all tracks allocated to the Encryption Keyfile, with a guaranteed minimum capacity specified by RECS=.