> ## Documentation Index
> Fetch the complete documentation index at: https://notevil.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# CAPLfunctionIso11783ILPDDValueCommand

[Open topic with navigation](../../../../../../CANoeDEFamily.htm#Topics/CAPLFunctions/ISO11783/ISOInteractionLayer/Functions/CAPLfunctionIso11783ILPDDValueCommand.md)

**CAPL Functions** » **ISO11783** » **ISO11783 Interaction Layer** » Iso11783IL\_PDDValueCommand, Iso11783IL\_PDDValueCommandRaw, Iso11783IL\_PDDValueCommandPhysical

# Iso11783IL\_PDDValueCommand, Iso11783IL\_PDDValueCommandRaw, Iso11783IL\_PDDValueCommandPhysical

[Valid for](../../../../Shared/FeatureAvailability.md): CANoe DE • CANoe4SW DE

## Function Syntax

* `long Iso11783IL_PDD ValueCommand (dword ddi, dword elementNumber); //form 1`
* `long Iso11783IL_PDD ValueCommand(dbNode implement, dword ddi, dword elementNumber); //form 2`
* `long Iso11783IL_PDD ValueCommandRaw(dword ddi, dword elementNumber, long value); //form 3`
* `long Iso11783IL_PDD ValueCommandRaw(dbNode implement, dword ddi, dword elementNumber, long value); //form 4`
* `long Iso11783IL_PDD ValueCommandPhysical(dword ddi, dword elementNumber, double value); //form 5`
* `long Iso11783IL_PDD ValueCommandPhysical(dbNode implement, dword ddi, dword elementNumber, double value); //form 6`

## Description

Form (1) and (2) send the current value of the specified data entity to the Task Controller with Value command. It can be used to send to the Task Controller the previously set Compressed State DDIs (using [Iso11783IL\_PDDSetValueRaw](CAPLfunctionIso11783ILPDDSetValueRaw.md) or [Iso11783IL\_PDDSetValuePhysical](CAPLfunctionIso11783ILPDDSetValueRaw.md)).

Form (3)-(6) set the value to the specified data entity (if exists) and sends the value to the Task Controller with Value command.

## Parameters

* **ddi**: Data Dictionary Identifier, 0x0000.0xFFFF
* **elementNumber**: Element number, 0x000.0xFFF
* **value**: New value of the data entity (process variable)
* **implement**: Task Controller simulation node to apply the function.

## Return Values

* **0**: function has been executed successfully
* **\< 0**: an error has occurred, see [error codes](../../../CAPLfunctionsISOj1939ErrorCodes.md)

## Example

Example form 2

```c theme={null}
void ReportActualStateOfSomeSections()
{
  long result;

  // Sections 1, 3, 20 and 21 are enabled
  // All sections belong to the elementNumber=7
  // the first two sections belong to the DDI=161
  // the last two sections belong to the DDI=162
  Iso11783IL_PDDSetSectionState(Sprayer, 161, 7, 1, 1);
  Iso11783IL_PDDSetSectionState(Sprayer, 161, 7, 3, 1);
  Iso11783IL_PDDSetSectionState(Sprayer, 162, 7, 20, 1);
  Iso11783IL_PDDSetSectionState(Sprayer, 162, 7, 21, 1);

  // each DDI has to be sent with a single command
  // the first two sections belong to the DDI=161
  Iso11783IL_PDDValueCommand(Sprayer, 161, 7);
  // the last two sections belong to the DDI=162
  Iso11783IL_PDDValueCommand(Sprayer, 162, 7);
}
```