DROP

Drop Filename from File Table

This directive removes a file-name from the File Control Table that was placed there with an ADD or ADDR directive, and releases the memory allocated by a public program that was ADDRed.

Syntax

DROP file-name [,ERR=line-ref|,ERC=error-code]
DROP trigger-definition-list [,ERR=line-ref|,ERC=error-code][OPT="IOT"]

file-name

is a string of 8 characters or fewer used to name the file or public program that has been added to the File Control Table.

trigger-definition-list

is a string of 8 characters or fewer used to name the trigger definition to deactivate. For more information see the 3GL Trigger section of the Basic Developer Guide

line-ref

is the program line number or label to branch to if this directive produces an error.

error-code

is a programmer-defined error code. Valid values are positive or negative whole numbers.

OPT="IOT"

is the keyword that indicates to Basic that this is a Trigger List.

Remarks

If an attempt is made to DROP a file-name that is not in the File Control Table, an ERR=13 results.

Examples

DROP "INDEX"

removes the entry for the file “INDEX” from the File Control Table.

See also

ADD, ADDR, and DROP ALL directives

From the Thoroughbred Basic Language Reference, Volume I: A–E, version 8.9.1. Open this page in the PDF