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

Ctrl Command load_sub
Function assigns a desired index to a subroutine defined by subsequent list commands and loads
the subroutine into the protected buffer area ("List 3")
Call
load_sub( Index )
Parameter
Index
Comments • Up to 1024 indexed subroutines can be stored. If Index > 1023 then the load_sub
command will be ignored
• The address in the protected buffer area where the subroutine should be stored is auto-
matically determined and internally managed.
• Indexed subroutines must be terminated with a
uisite for actual storage of the commands, entry of the start address and other infor-
mation (e.g., the number of commands) into the internal management table, and
initiating a flush of the list input buffer (see
be altered without a preceding
will not be available.
• An indexed subroutine 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
will be deleted from the internal management table.
• Indexed subroutines can be called via the
sponding index (see
• Observe all notes in the section
® ®
RTC 4 RTC 5 new command
References list_return, sub_call, load_char,
Ctrl Command load_text_table
Function assigns a desired index to a text string defined by subsequent list commands and loads the
text string into the protected buffer area ("List 3")
Call
load_text_table( Index )
Parameter
Index
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
Index of the indexed subroutine as an unsigned 32-bit value,
permissible range [0 ... 1023]
(get_last_error
list_return
is the next command after load_sub, then the corresponding subroutine
"Calling Subroutines", page
"Indexed Subroutines", page
load_text_table
Index of the indexed text string as an unsigned 32-bit value,
permissible range [0 ... 41]
return code RTC5_PARAM_ERROR).
list_return command. This is a prereq-
page 71). Otherwise (the input pointer will
command) the subroutine with this index
sub_call command along with the corre-
77).
76.
344