A script-enabled browser is required for this page to function properly.

Creating and Passing Parameter Lists

Parameters are passed to called forms by means of a parameter List. A parameter List is a named programmatic construct that is simply a List of parameter names (called keys) and their values.

You can pass parameter values to forms invoked by the Built-in subprograms CALL_FORM, OPEN_FORM, and NEW_FORM. In addition, you can pass parameter values to Graphics with the RUN_PRODUCT procedure.

A parameter you include in a parameter List can be either a text parameter or a data parameter. The parameter type determines how its value is interpreted.

Text Parameter values 

The value of a text parameter being passed to a called product is a CHAR string that can represent the following:

Data Parameter Values 

The value of a data parameter being passed to a called product is always the name of a record group defined in the current form. (A record group is a data structure that stores records derived from a query or through programmatic assignment.) Data parameters are used to pass data to Graphics invoked with the RUN_PRODUCT Built-in subprogram.

You cannot pass data parameters to forms.

The following table shows the structure of a parameter List that contains four parameters:

Key

Paramtype

Value

CITY

Text_Parameter

'BOGOTA'

CATEGORY

Text_Parameter

'EXPORTS'

MULTIPLIER

Text_Parameter

'.0275'

NEW_DATA

Data_Parameter

'RECORD_GROUP8'