CONTROL
- Introduction to CTRL
- CONTROL Classes
- Types of Control Functions
- CONTROL graphics
- CONTROL Functions
  - Funtions A
    - abortFileTransfer()
      The function abortFileTransfer() aborts all file transfers of the stated manager.
    - abs()
      Returns the absolute value of a value.
    - access()
      Queries the access mode of the file or directory with the specified path name.
    - acGetRefACType()
      Returns a AC type name, if the leaf dpeName is referenced to an AC type, otherwise an empty string.
    - acos()
      Returns the arc cosine in the radian measure.
    - activateMode()
      Switches the module to normal operating mode.
    - addGlobal()
      Creates a variable and makes it into a control-wide variable.
    - addGroup()
      Adds a group of shapes or a layout to a panel.
    - addGroupPVSS()
      Adds a user group of an external authentication system to the WinCC OA user administration.
    - addShape()
      Adds a new shape into a panel.
    - addSymbol()
      Adds a panel reference in a panel or layout at a later time during run time. To suppress the Initialize scripts of the reference the function createSymbol() can be used instead.
    - addUserPVSS()
      Adds a user of an external authentication system to the WinCC OA user administration.
    - addUserToGroupPVSS()
      Adds a WinCC OA user to a user group in the WinCC OA user administration.
    - aes256Decrypt()
      The function allows to decrypt an encrypted information with the AES-256 algorithm.
    - aes256Encrypt()
      The function allows to encrypt the passed information with the AES-256 algorithm.
    - afterLogin()
      After successful login displays the required panel.
    - alertConnect()
      Registers the function work() for call with resulting alerts.
    - alertDisconnect()
      Unregisters the function work() from call when changes are made to the values.
    - alertGet()
      Queries only the last alert attributes of a data point.
    - alertGetPeriod()
      Reads the values of the specified alert attributes of the data point elements for which alerts were triggered.
    - alertSet()
      Allows data point attributes to be set in a similar way to dpSet().
    - alertSetTimed()
      Allows data point attributes to be set in a similar way to dpSet(). Additionally the timestamp can be set manually.
    - alertSetTimedWait()
      Allows data point attributes to be set in a similar way to dpSet(). Additionally the timestamp can be set manually.
    - alertSetWait()
      Allows data point attributes to be set in a similar way to alertSet()/dpSetWait().
    - animate()
      With the function animate() you can create animations.
    - animateWait()
      With the function animateWait() you can create animations and wait for them to finish.
    - asin()
      Returns the arc sine in the radian measure.
    - assignPtr()
      The function allows to assign a shared_ptr to a different shared_ptr..
    - atan()
      Returns the arc tangent in the radian measure.
    - atan2()
      Returns the arc tangent of the Cartesian coordinates y and x.
  - Funtions B
  - Funtions C
  - Funtions D
  - Functions E
  - Functions F
  - Functions G
  - Functions H
  - Functions I
  - Functions J
  - Functions K
  - Functions L
  - Functions M
  - Functions N
  - Functions O
  - Functions P
  - Functions Q
  - Functions R
  - Functions S
  - Functions T
  - Functions U
  - Functions V
  - Functions W
  - Functions X
  - Functions Y
  - Functions Z
- CTRL Debugger
  With the CTRL Debugger you can debug the programming language Control.

addGlobal()

Creates a variable and makes it into a control-wide variable.

Synopsis

int addGlobal(string name, unsigned type);

Parameter


Parameter	Description
type	Type
name	Designation

Return Value

If successful 0, in the event of an error -1.

Errors

Incorrect argument or invalid variable type.

Description

Creates a variable of the type "type" with the designation "name" and makes it into a control-wide variable (only restricted to the current manager).

Table: List of possible data types


ANYTYPE_VAR	DYN_ANYTYPE_VAR	DYN_DYN_ANYTYPE_VAR
TIME_VAR	DYN_TIME_VAR	DYN_DYN_TIME_VAR
FILE_VAR
BOOL_VAR	DYN_BOOL_VAR	DYN_DYN_BOOL_VAR
INT_VAR	DYN_INT_VAR	DYN_DYN_INT_VAR
UINT_VAR	DYN_UINT_VAR	DYN_DYN_UINT_VAR
FLOAT_VAR	DYN_FLOAT_VAR	DYN_DYN_FLOAT_VAR
STRING_VAR	DYN_STRING_VAR	DYN_DYN_STRING_VAR
LANGSTRING_VAR	DYN_LANGSTRING_VAR	DYN_DYN_LANGSTRING_VAR
BIT32_VAR	DYN_BIT32_VAR	DYN_DYN_BIT32_VAR
CHAR_VAR	DYN_CHAR_VAR	DYN_DYN_CHAR_VAR
DPIDENTIFIER_VAR	DYN_DPIDENTIFIER_VAR	MAPPING_VAR
BLOB_VAR	DYN_BLOB_VAR
ATIME_VAR	DYN_DYN_ERRCLASS_VAR
ERRCLASS_VAR	DYN_ERRCLASS_VAR

Example

A global integer variable named "counter" is created.

main()
{
  addGlobal("zaehler",INT_VAR);
// creation of the variable
  zaehler = 15;

//counter can now be assigned a value
}

Assignment

Various functions

Availability

CTRL