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

Ctrl Command set_text_table_pointer
Function stores the absolute start address of a command list in the internal management table for
indexed text strings.
Call
set_text_table_pointer( Index, Pos )
Parameters
Index
Pos
Comments • Indexed text strings can be used for marking time, date or serial numbers (see
Indexed Text Strings", page
• If Index > 41 and/or Pos > (2
(get_last_error
• The set_text_table_pointer command can be used for referencing a nonindexed
subroutine, which thereby becomes an indexed text string that is protectable via
save_disk/load_disk
• set_text_table_pointer can also be used to reference anew an indexed subroutine,
character or text string so that it can also be called via a second index. Here, it is pref-
erable to use the
• The start addresses of command lists that are to be referenced with
set_text_table_pointer can be queried via
command lists.
• set_text_table_pointer only stores starting addresses in the internal management
table. An indexed text string only gains protection via a subsequent
save_disk/load_disk
• Pos should not be an arbitrary address within a list. Instead, it should be the starting
address of an actually existing subroutine that was finalized via
not contain set_end_of_list.
• The command is synonymous with set_char_table, which was introduced for the
®
RTC
® ®
RTC 4 RTC 5 new command
References load_text_table, mark_date, mark_serial,
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
Index of the indexed text string whose starting address Pos should be entered
in the management table (as an unsigned 32-bit value, allowed range:
[0 ... 41]). The same ordering applies as for the
= 0...9: digits for marking the time and date [0 ... 9]
= 10...21: months [January ... December]
= 22...28: days-of-the-week [Sunday ... Saturday]
= 29: blank character for marking serial numbers
= 30...39: digits for marking serial numbers [0 ... 9]
= 40: text for "a.m."
= 41: text for "p.m."
Absolute start address as an unsigned 32-bit value;
20
allowed range: [0 ... (2
81).
20
–1), then the command will not be executed
return code RTC5_PARAM_ERROR).
and/or callable via the index.
copy_dst_src command for index management.
command.
SCANalone Board (standalone version of the RTC
load_text_table
–1)]
get_input_pointer
®
4 board).
mark_time
command:
"Calling
before loading the
list_return and does
492