MOVEPLEN

NCHAR

The MOVEPLEN instruction retrieves a character string variable's Physical Length. The instruction uses the following format:

Where:

label

Optional. A Program Execution Label.

source

Required. A previously defined Character String Variable or National Character String Variable whose Physical Length is moved to the {dest} variable.

sep

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

dest

Required. A previously defined Numeric Variable that receives the value of the Physical Length from the {source} operand.

Flags Affected: OVER

Note the following:

1. The contents of {source} remain unchanged.

2. If the Physical Length is too large for {dest}, the OVER Condition Flag is set.

3. Enhanced ARRAY processing is supported.

See Also: Example Code, MOVEFPTR, MOVELPTR, Character String Instructions