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.

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

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

See Also

Data Server Syntax

Verbs - Alphabetical Listing

SORT/DIRECT Files