SORT Verb - Create Sort File

Syntax

SORT fileid,keysize,records{,MODE=str}{,ERR=lineref}

Description

The SORT verb creates a sort file with the given specifications.

Parameter

Description

fileid

Name of the new file; must be unique.

keysize

Maximum length of a key in the file; it must be an integer in the range of 1 to 64.

records

Total number of keys in the file; it must be an integer. The total size of the file cannot exceed (2^31)-1 bytes. File allocation may vary from system to system because of operating system constraints.

ERR=lineref

Branch to be taken if an error occurs during execution.

PRO/5 automatically sorts keys as they are added to a sort file and takes the optional ERR= branch if there is a problem while creating the file. When accessing a sort file, the I/O verbs used must not specify any data fields.

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

2020 SORT "TEST.BBX",10,100,ERR=9500

See Also

Data Server Syntax

Verbs - Alphabetical Listing

SORT/DIRECT Files