GETLABEL

9.5B

The GETLABEL instruction retrieves the code address of an EXTERNAL variable and stores it into an execution LABEL pointer. The instruction the following format:

[label]

GETLABEL

{extname}{sep}extptr}

Where:

label

Optional. A Program Execution Label.

extname: Required. A previously declared Character String Variable or Literal that contains the label name reference for an EXTERNAL declaration.
sep: Required. A comma or one of the following prepositions: BY, TO, OF, FROM, USING, WITH, IN, or INTO.

extptr

Required. A previous declared LABEL pointer.

Flags Affected: OVER

Note the following:

The string label name specified in the {extname} parameter is the actual label name reference of the EXTERNAL statement. If the program was compiled with case sensitive labels and the program is being executed by a runtime for case sensitive labels, the {extname} is processed with case sensitivity.
The OVER flag is set if label string does not match an EXTERNAL label name in the current program being executed. In addition, the OVER flag is set if the {extname} is NULL or the string length is longer than thirty-two (32) characters.
The OVER flag is also set if the {extname} is found but the load module for the EXTERNAL is not loaded.

See Also: System Interface Instructions