STORELABEL

9.5B

The STORELABEL instruction stores a Program Execution label address into a LABEL pointer that is selected from a list of execution LABEL pointers. The instruction the following format:

Where:

label

Optional. A Program Execution Label.

source

Required. A Program Execution label, previously defined execution LABEL pointer, or previously defined EXTERNAL variable.

sep

Required. A comma or one of the following prepositions: BY, TO, OF, FROM, USING, WITH, IN, INTO.

index

Required. A previously defined Numeric Variable or Expression used in selecting an execution LABEL pointer from the list of LABEL pointer variables.

exeptrlist

Required. A list of previously defined execution LABEL pointers.

Flags Affected: none

Note the following:

1. If the {index} value is less than one or greater than the total number of items in the {prog-exe-list}, the STORELABEL instruction is ignored without any changes.

2. Additional lines may be used by ending each continued line with a colon (:).

3. If {index} is not a decimal integer, only the integer portion of the variable is used. For example, if it has a value of 3.6, 3 is used.

4. Null entries in the list are allowed and are signified by two commas with no label name between them. When the index value is associated with a null entry, the STORELABEL instruction is ignored without any changes. This feature allows a program to define a default LABEL pointer action that can be pre-defined before the STORELABEL instruction is executed.

5. If the {source} operand is associated with an EXTERNAL label reference, the STORELABEL instruction automatically loads and resolves all external routines in the load module if the load modules is not previously loaded.

See Also: System Interface Instructions