STRING Verb - Create String File
Syntax
STRING fileid{,MODE=str}{,ERR=lineref}
Description
The STRING verb creates a STRING file. STRING files grow dynamically as they are written. PRO/5 takes the ERR= branch if an error occurs while defining the file.
|
Parameter |
Description |
|
fileid |
Name of the STRING file to be created. |
|
ERR=lineref |
Branch to be taken if an error occurs during execution. |
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.
Example
1000 STRING "TEST",ERR=9500