Scanlab RTC 5 PC Interface Board - Page 345

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
345
innovators for industry
Comments • Up to 42 indexed text strings can be stored (for marking times, dates and serial numbers
via other commands). The following ordering applies:
–
Index = 0… 9: digits for marking the time and date [0 … 9]
–
Index = 10…21: months [January … December]
–
Index = 22…28: days-of-the-week [Sunday … Saturday]
–
Index = 29: blank character for marking serial numbers
–
Index = 30…39: digits for marking serial numbers [0 … 9]
–
Index = 40: text for “a.m.”
–
Index = 41: text for “p.m.”
If
Index > 41 then the load_text_table command will be ignored (get_last_error
return code
RTC5_PARAM_ERROR ).
• Even if digits are defined via mark_text instead of as individual characters with
mark_char, the character set can still be subsequently switched for this purpose (see
select_char_set).
• The addresses in the protected buffer area where the text string definitions will be
stored are automatically determined and internally managed. Management is indepen-
dent of that for indexed subroutines (see load_sub) and character definitions (see
load_char).
• Indexed text string definitions must be terminated with a list_return command. This is
a prerequisite for actual storage of the commands, entry of the start address and other
information (e.g., the number of commands) into the internal management table, and
initiating a flush of the list input buffer (see page 71). Otherwise (the input pointer will
be altered without a preceding list_return command) the text string with this index will
not be available.
• An indexed text string definition will not be stored if the protected buffer area (“List 3”)
was not previously configured for a sufficient size beyond “List 1” and “List 2”.
•If list_return is the next command after load_text_table, then the corresponding text
string definition will be deleted from the internal management table.
• Also observe all notes in the section "Character Sets and Text Strings", page 80.
RTC
®
4  RTC
®
5new command
References list_return, load_sub, load_char
Ctrl Command load_text_table