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>,X21,X22,X84,...

[Where:
<KEY> is the key; X21.... are up to 100 registers to be filled.

Examples:

E1. UD IC,300,X51,X52,X60,X65 (key is explicit number)

E2. UD IC,X90,X40,X35,X34,X10 (key is contained in register)

E3. UD IC,I,X30,X31 (key is the 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 X51,X52,X60, and X65 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,X51,X52,X60,X65

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