Scanlab RTC 5 PC Interface Board Installation And Operation Manual page 332

Ctrl Command load_disk
Comments • For Name = 0, only the internal management tables will be initialized as with Mode = 0
(no loading will occur, no "empty" binary file must be provided). Otherwise, the
load_disk command can only be used for reading files that were stored with save_disk.
• For all indexed characters, text strings and subroutines in the specified file, load_disk
executes a corresponding load_char,
corresponding list commands are thereby written to the protected memory area and
appropriate entries are made in the internal management tables in accordance with the
index assignment stored in the file. If there is no character, text string or subroutine for
a particular index in the specified file, then no list commands will be loaded for this
index, and if Mode > 0 then any already existing entries in the internal management
table will remain unaltered. Thus, supplementary loading of indexed characters, text
strings and subroutines from various files is possible.
• Together with the
ment the protected memory area and to subsequently protect subroutines (see
and page
then defragmentation can be achieved if the first file is loaded in Mode = 0 and subse-
quent files are loaded with Mode > 0, provided that no indices are used simultaneously
in different files. Memory gaps in the protected area caused by dereferencing of
indexed characters, text strings or subroutines will be thereby closed.
• If, during loading, the end of the protected memory area is reached before the end of
the file (EOF), then all further list commands in the file will be ignored. Likewise, incom-
plete characters, text strings and subroutines (as with individual load_char,
load_text_table
command, be sure that the memory configuration provides a sufficiently large
protected area above the list areas ("List 1" and "List 2"). The
returns the number of list commands stored in the file. If a board changes ownership,
it is the user's responsibility to ensure that the memory configuration data is consistent
(Mem1 and Mem2 are queried from the DLL, not from the board – also see
and page
• If the specified file is corrupt and can't be read to the end, then only the characters, text
strings and subroutines fully readable to that point will be stored.
• The command will be ignored
"List 3" hasn't been assigned a memory area (Mem1 + Mem2 = 2
likewise be ignored
is currently set (list is being processed or has been halted via pause_list) or the board's
INTERNAL-BUSY status is currently set. In contrast, if a list has only been paused via
set_wait
sible for ensuring that no still-needed commands will be overwritten, e.g. if
was called from an indexed subroutine.
• While the load_disk command is running, no other commands can execute. During
execution of the command, external starts will be suppressed.
® ®
RTC 4 RTC 5 new command
References save_disk
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
save_disk command, load_disk can be used, for example, to defrag-
79). If the characters, text strings and subroutines come from various files,
or load_sub commands) will not be stored. Before each load_disk
86).
(get_last_error
(get_last_error return code: RTC5_BUSY) if the board's BUSY status
(PAUSED status set), then load_disk can be executed. But the user is respon-
load_text_table or load_sub
save_disk
return code: RTC5_PARAM_ERROR) if
20
command. The
page 78
command
get_config_list
). The command will
set_wait
332