INSERT (AFILE)

ANSI

The INSERT instruction adds AAM record keys into an alternate key file. It must immediately follow a successful READ, WRITE, or DELETEK instruction.

[label]

INSERT

{afile}

Where:

label

afile

Required. A previously defined and opened AFILE variable into which key information is inserted.

Flags Affected: NONE

Note the following:

The INSERT instruction automatically extracts the key data from the last written record.
An INSERT must be performed against each alternate (secondary) AAM file. If not, the alternate AAM key file may be unusable.
Since an AAM WRITE automatically inserts the key into the primary AAM file, this instruction must not be used for files with only one AAM file.
If an I/O instruction is done to the primary file between the WRITE and the INSERT, the INSERT does not work properly.