XFILE Verb
Syntax
XFILE string1{,string2}{,MODE=options}{,ERR=lineref}
Description
The XFILE verb defines any disk file type except a disk directory.
| Parameter | Description |
|---|---|
| string1 | File identification information, in the format returned by the XFID() Function. |
| string2 | Key definition data for multikeyed MKEYED, XKEYED, or VKEYED files, as derived from the XFIN() Function, XFIN$(86). Information ignored for all files other than MKEYED, XKEYED, and VKEYED files. |
| MODE=options | A String containing comma-separated mode options from the table below. |
| ERR=lineref | Branch to be taken if an error occurs during execution. |
MODE Options
| Mode | Description | ||||||
|---|---|---|---|---|---|---|---|
| CRYPTPASS= | In PRO/5 5.00 and higher, and BBj 4.00 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= |
|
To utilize AES-256 in BBj, the Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files must be installed.
The XFILE verb is used in an erase-redefine procedure, as shown in the examples below. The examples remove all data from the file.
Example 1
|
Example 2 (For MKEYED/XKEYED/VKEYED files only)
|