DIRECT Verb - Create DIRECT File
Syntax
DIRECT fileid,keysize,records,recsize{,ERR=lineref}
Description
The DIRECT verb creates a direct file with the given specifications.
|
Parameter |
Description |
|---|---|
|
fileid |
Name of the new file; must be unique. |
|
keysize |
Maximum length of a key in the file; must be an integer in the range of 1 to 64. |
|
records |
Number of records to be allocated; must be an integer greater than 0. |
|
recsize |
Size of each record in bytes; must be an integer in the range of 1 to 32767. The total size of the file cannot exceed (2^31)-1 bytes. The number of bytes required for any given direct file can vary from system to system. |
|
ERR=lineref |
Branch to be taken if an error occurs during execution. |
PRO/5 takes the optional ERR= branch if a problem occurs while creating the file.
DIRECT files have been largely superseded by MKEYED files but are maintained for compatibility with earlier releases of BASIS products.
MODE Options (BBj Only)
|
Mode |
Description |
||||||
|---|---|---|---|---|---|---|---|
| CRYPTPASS= |
In BBj 4.0 and higher, creates an encrypted file with the specified password. BASIS recommends a password of at least 20 characters when using AES-128 and at least 40 characters when using AES-256. Note: Encrypted files tend to perform slower than non-encrypted files due to the overhead of encrypting and decrypting each time the file is accessed. |
||||||
| CRYPTALG= |
|
Note: PRO/5 supports the creation of encrypted MKEYED files, but does not support encryption of other file types.
Example
>DIRECT "ACCOUNTS",10,100,512,ERR=9500