FILE Verb

Syntax

FILE string1{,string2}{,ERR=lineref}

Description

The FILE verb defines any disk file type except a disk directory.

See also XFILE Verb.

Parameter

Description

string1

File identification information, in the same format as used by the FID() function.

string2

Key definition data for multikeyed MKEYED files, as derived from FIN(86). Information ignored for all files other than multikeyed MKEYED and C-ISAM files.

ERR=lineref

Branch to be taken if an error occurs during execution.

The FILE statement is used in an erase-redefine procedure, as shown in the examples below. The examples remove all data from the file. For additional information see the INITFILE verb.

MODE Options

Mode

Description

CRYPTPASS=

In PRO/5 5.0 and higher, and 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, and PRO/5 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.

Examples

1000 OPEN (1)"afile"
1010 LET F$=FID(1)
1020 CLOSE (1)
1030 ERASE "afile"
1040 FILE F$

For MKEYED and C-ISAM files only

1000 OPEN (1)"afile"
1010 LET F$=FID(1),G$=FIN(1)
1020 CLOSE (1)
1030 ERASE "afile"
1040 FILE F$,G$(86)

See Also

Data Server Syntax

Modifying Programs to Access the Data Server

Verbs - Alphabetical Listing