Save_Disk - Scanlab RTC6 PCIe Board Installation And Operation Manual

Ctrl Command save_disk
Function Stores all indexed characters, text strings and/or subroutines to a binary file on a
PC data medium, ordered by index, and returns the number of thereby stored
list commands.
NoOfSavedCommands = save_disk( Name, Mode )
Call
Name
Parameters
Mode
Result The number of list commands saved by save_disk.
As an unsigned 32-bit value.
Comments • save_disk can be used together with load_disk, for example, to perform
defragmentation or to apply subsequent protection to subroutines, see
"Subsequent Protection and Conversion of Non-Indexed Subroutines", page 116
Section "Index Management and Defragmentation", page
• By save_disk, always the complete sets (no individual characters, text strings or
subroutines!) are stored in the specified file. Indexed characters, text strings or
subroutines
that are referenced multiple times with
duplicated by save_disk, that is, also stored multiple times. The save_disk command
ignores unreferenced non-indexed (not subsequently referenced by
set_char_pointer,...) characters, text strings and subroutines.
• The number of list commands stored by save_disk can differ
from the number of the list commands stored in the protected
"List 3" (= 2
– Indexed characters/text strings/subroutines are referenced several times
– Indexed characters/text strings/subroutines reside in the unprotected
Memory
Prior a subsequent load_disk, be sure to compare the returned number with the size
of the protected
(= 2
• No-longer-needed characters (or text strings or subroutines) should be
dereferenced by
followed by
Defragmentation", page
RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
File name.
As a pointer to a \0-terminated ANSI string.
Specifies what is to be stored:
Bit #0 = 1: All indexed characters and text strings are stored.
Bit #1 = 1: All indexed subroutines are stored.
Bit #2 Not evaluated.
...
Bit #31: Not evaluated.
As an unsigned 32-bit value.
23
Mem1 Mem2
– – – get_list_space), due to the following:
area "List 1" or "List 2"
RTC6 List Memory
23
Mem1 – Mem2).
–
load_char (or
list_return previously to save_disk (see
115).
copy_dst_src are also correspondingly
area "List 3"
load_text_table or load_sub) directly
Section "Index Management and
Section
and
115.
RTC6 List Memory area
RTC6 List
600