LOADPARM

9.5A

LOADPARM instruction retrieves non-positional and keyword parameters from the execution parameter list for a user-defined VERB. The instruction uses the following format:

Where:

label

Optional. A Program Execution Label.

index

Required. A Numeric Variable or numeric expression whose value is used as an index into a user-defined verb execution list.

keyvar

Required. A Character String Variable or a typeless VAR variable pointer that receives the keyword name of the next parameter in the user-defined verb execution list.

var1 - var 5

Optional. A typeless VAR variable pointer that receives the address of any operands that have been assigned to the next parameter in the user-defined verb execution list.

Flags Affected: OVER

Note the following:

1. The LOADPARM instruction performs a GETPARM instruction on the parameter in the user-defined verb execution list using an index into the parameter list.

2. If the {index} value is less than one (1) or greater than the number of parameters in the user-defined execution list, the OVER flat is set to TRUE.

3. When a user-defined verb is executed, the parameter execution list can contain the same keyword reference in list of parameters more than once.

4. The user-defined execution list instance exists only for the current call stack level that was established when the user-defined verb was executed using an implicit CALL instruction. If the user-defined routine calls to another routine, the previous call stack level preserves the user-defined execution list pointers. This allows user-defined verbs to be executed, nested, and returned to any call stack level while keeping the execution list parameter pointers valid for that stack level

5. The LOADPARM only retrieves the non-positional and keyword parameters from the user-defined execution list which are optionally included by the execution of the user-defined verb.

See Also: VERB, GETPARM, RESETPARM, System Interface Instructions