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.

CRYPTALG=
Value Description
AES-128 Uses AES-128 bit encryption, which is also the default.
AES-256

In BBj 6.00 and higher, uses AES-256 bit encryption.

JDK version 8 and lower

To utilize AES-256 in BBj, install the "Java Cryptography Extension (JCE)". Current JDKs do not need these additional files.

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

See Also

Data Server Syntax

Verbs - Alphabetical Listing

STRING Files