UD IC - Unsave Document - In Core

PURPOSE

To unsave a document file and store its contents in-core for further fast accesses within this session. Ten document files with unlimited keys each can be stored in concurrently in-core. 'UD ICE' terminates access to current in-core image of the document file specified, and allows access to a different document file after another 'UD IC' operation.

SEE ALSO

UD ICE	[Unsave Document - In Core, End]
UD	[Unsave Document]
UD S	[Unsave Document - Sequential search]
SD IC NEW	[Save Document - In Core, create New storage array]

USAGE

.OPERATION: UD IC <KEY>,[r1],[r2],[r3]

[WHERE:
<KEY> is the key; [r1]... are up to 100 register variables to be filled.

Examples:

E1. SD IC 300,[r1],[r2],[r3] (KEY is an explicit number)

E2. SD IC [k],[r1],[r2],[r3] (KEY is contained in register variable:[k])

E3. SD IC I,[r1],[r2],[r3] (KEY is a DO-LOOP index)]

.DOCUMENT FILE: ADC998
[Enter the name of the document file previously created by a 'SD' command or by operations such as 'PK']

[In example E1, let's say the document file has the first 490 keys filled. The command listed above will cause all 490 x 4 numbers of the document file to be stored for future access within this session, and will fill registers [r1]=30, [r2]=1.5 and [r3]=270 with the values stored under key 300. Subsequent access to any other key present in the file (namely 1 ... 490), e.g.
UD IC 410,[r1],[r2],[r3]

will quickly look up the values stored under key 410 in the in-core image, without the need to access the file.

IMPORTANT: only a imited number of document files may be accessed concurrently with 'UD IC'. Once the limit is reached one of the current files must be cleared by a 'UD ICE' command. An attempt to apply 'UD IC' to a additional document file before execution of a 'UD ICE' command to free the area reserved for data from an existing file will result in an error message.]

NOTES

1. 'UD IC' should always be used when more than one access to a large document file takes place.

2. Even though it is not advisable, because of its slow speed, it should be mentioned that a command 'UD' without the in-core option may be applied to a file currently existing as in-core image, without causing interference.

3. Use 'UD' if you want to retrieve comment keys.

SUBROUTINES

UDOCIC, OPENDOC, LUNDOC

CALLER

DRIV3