Level 2 Help for GETLAB
INP
This parameter specifies the name of the file containing the label items
to be retrieved. If the directory is not the default, the file name must
include the directory specification.
LAB_ITEM
This parameter specifies the name of the label item to be retrieved. The
label will be searched for label items that match this parameter.
ITM_NAME
This parameter specifies the name of the local variable that will contain
the value(s) of the searched label item LAB_ITEM. The type of the local variable
must be equivalent to the type of the label item. The local variable must
also have a count that is either equal to the count of the returned label
item value, or have a count range that will include the count of the label
item value.
LAB_TYPE
This parameter specifies the type of the value to be retrieved. The valid
values are STRING, REAL, or INT.
ITM_TYPE
This parameter specifies the type of the label item value to be retrieved. This
type much match the type of the label item value and the type of the local
variable in which the label item value will be stored.
ITM_TASK
This parameter specifies the name of the task that is to be searched for
a label item. This parameter is only used in INSTANCE mode. See examples.
ITM_INST
This parameter specifies the instance number of the task to be searched
for a label item. This parameter is only used in INSTANCE mode. See examples.
MODE
This parameter specifies the mode of label item access. If the first version
of a label item is desired, then MODE is EARLIEST. If the last version of a
label item is desired (i.e. its most recent value), then MODE is LATEST. If a
specific version of a label item is desired, then MODE is INSTANCE. If the
INSTANCE mode is selected, then parameters ITM_TASK and ITM_INST must be
specified.
ELEMENT
Specifies which element of a multi-valued label item to pick. GETLAB
supports retrieving only one value at a time, but that value can be any
element of the keyword. ELEMENT starts counting at 1.