LINC Programming Reference Manual - Public Support Login - Unisys

EXTRACT (EX)
These files do not exist before the Report begins, and are deleted after the Report
ends. To specify a TEMPORARY file, use one of the following logic command
constructs (and do not include a SET.TITLE; command):
v EXTRACT; (without the RETAIN.AS; command option)
v DETERMINE; ACTUAL (without the RETAINED.AS; command option)
Extract File Processing
The way an EXTRACT; command handles an Extract file at runtime is influenced by:
$ The category of the Extract file (TEMPORARY, PERMANENT, or EXISTING)
$ Whether it is the first or a subsequent access of the Extract file
A first access is defined as the first execution of any DETERMINE; ACTUAL, SORT ,
EXTRACT, or MATCH; commands for a specific Extract file, either in the logic of the
Report, or following a SET.TITLE; or RESTART; command.
The EXTRACT; command attempts to write a record to the specified Extract File.
$ If this is not the first access of the Extract file, the extracted data will be appended to
the existing file.
$ If this is the first access of the Extract file, the action performed on the file when the
EXTRACT; command is executed depends on the category of the file, as shown in the
following table.
File Status Temporary Extract
File
Permanent Extract
File
File exists Cleared Cleared Cleared
File does not exist Created Created Created
Existing Extract File
At the end of Report execution, the action performed on the file when an EXTRACT;
command has specified that file depends on the category of the file and whether it was
actually accessed, as shown in the following table.
File Status Temporary Extract
File
Permanent Extract
File
Not accessed Deleted Cleared No action
Accessed Deleted Closed Closed
Existing Extract File
v 1-125