Type 0: Definition of Changing Parameters (SAP Library

Type 0: Definition of Changing Parameters

Use

You define changing parameters in dynamic function calls. To the changing parameter, you assign the variable whose value you want to transfer from the PI sheet or the process manufacturing cockpit to the function module. After the function has been executed, the parameter value is returned to this variable and transferred to the PI sheet or cockpit.

You can display the variable in the PI sheet or cockpit. You can use the variable to transfer the value to succeeding process instructions of the same PI sheet or the same cockpit. However, note the following:

The function can be carried out more than once in the PI sheet.
The function may change the parameter value.

Prerequisites

If you want to pass on the value of a variable to the function module or transfer it from the function module to the PI sheet or cockpit, the variable must be defined in the same PI sheet or cockpit. With PI sheets, the variable may also have been defined or for the entire process order.

For more information on how to use system variables and variables in general, see:

Using Variables in Browser-Based PI Sheets and Cockpits

Using System Variables in Browser-Based PI Sheets

Activities

When defining changing parameters, you specify the following information in the process instruction:

All required changing parameters of the function module;
Changing parameters are required if the Optional indicator has not been set. They must be specified in the process instruction.

Optional changing parameters of the function module for which you do not want to use the default value defined in the function module;
Changing parameters are optional if the Optional indicator has been set.

If required, the characteristic optional parameter transfer for optional parameters whose value you do not want to pass on when the function call is executed;
See also Type 0: Optional Parameter Transfer.

The parameter name for each parameter to be passed on

The variable for each parameter value to be passed on;
You can only pass on the value of a variable to a parameter if it has the same data type as the parameter in the function module.

To enter this information, you assign the following characteristics to the process instruction in the order specified below:

Characteristic	Meaning	Allowed Values
PPPI_CHANGING_PARAMETER	Changing parameters	Changing parameters of the function module
< PPPI_STRING_VARIABLE or < PPPI_FLOAT_VARIABLE or < PPPI_DATE_VARIABLE or < PPPI_TIME_VARIABLE	Value transfer in variable: < Alphanumerical value < Floating point number < Date < Time	Variable of data type: < Alphanumerical value < Floating point number < Date < Time
PPPI_OPTIONAL_PARAMETER	Optional parameter transfer	< Parameter transfer not optional < Parameter transfer optional

If you want to display the variable value in the PI sheet or cockpit, you must define an output field. For more information, see Type 0: Definition of Output Fields for Variable Values .