SERIAL Verb - Create SERIAL File
Syntax
SERIAL fileid{,records,recsize}{,MODE=str}{,ERR=lineref}
Description
The SERIAL verb creates a SERIAL file to the given specifications.
|
Parameter |
Description |
|
fileid |
Name of the new file; must be unique. Because a SERIAL file can add space as needed, an initial file size is unnecessary. |
|
records |
Numeric expression existing only for syntax compatibility with older releases of Business BASIC. Specifying the number of records and their size affects the size of the file the SERIAL Verb creates. |
|
recsize |
Numeric expression existing only for syntax compatibility with older releases of Business BASIC. Specifying the number of records and their size affects the size of the file the SERIAL Verb creates. |
|
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.
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. |
Mode |
Value |
Description |
|
CRYPTALG= |
AES-128 AES-256 |
Uses AES-128 bit encryption, which is also the default. In BBj 6.0 and higher, uses AES-256 bit encryption. |
To utilize AES-256 in BBj, the Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files must be installed. These files are available for download at Oracle's Java SE Downloads page under "Additional Resources" near the bottom of the page.
Note:
PRO/5 supports the creation of encrypted MKEYED files, but does not support encryption of other file types.
Examples
1000 SERIAL "PNAME",ERR=9500