CONTROL
- Introduction to CTRL
  An introduction to the product's own programming language Control(CTRL).
- CONTROL Classes
- Types of Control Functions
  An overview of the types of functions distinguished within Control.
- Control graphics
- CONTROL Functions
  - Functions A
  - Functions B
  - Functions C
  - Functions 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
    - rad2deg()
      Converts an angle from a radian measure into degrees.
    - rand()
      Calculates a sequence of integer pseudo random numbers.
    - readDictionary()
      Appends the entries form a file to the internal dictionary.
    - readSMS()
      The readSMS() function reads a SMS message with the phone number of the sender and the time when the message has been sent. Possible errors will be read as well. If you want to use the control function, the runtime script sms.ctl has to run in the console.
    - recode()
      The function converts a string and returns the string in the desired encoding.
    - reduActive()
      In a redundant system, returns the active computer.
    - reduSetActive()
      Activates the emergency switch on the left or on the right.
    - reduSetInactive()
      Deactivates the emergency switch on the left or on the right in a redundant system.
    - reduSetPreferred()
      Sets the Preferred to left or right in a redundant system.
    - reduSetSplitOff()
      Sets the split mode to off in a redundant project.
    - reduSetSplitOn()
      Sets the split mode in a redundant system.
    - reduSwitchDist()
      Switches over in the split mode.
    - reduSwitchDriver()
      Switches the drivers in the split mode.
    - regexpIndex()
      The function "regexpIndex()" provides pattern matching via regular expressions. The function searches for a match of the specified character starting from the given position.
    - regexpLastIndex()
      The function "regexpLastIndex()" provides pattern matching via regular expressions. The function searches for a match of the specified character(s) starting at the end of the string.
    - regexpSplit()
      The function "regexpSplit()" provides pattern matching via regular expressions.
    - registerDbgFlag()
      Registers a debug flag and returns a debug flag number.
    - releaseComObject()
      Releases the COM object.
    - remove()
      The function remove() deletes a file.
    - removeDoneCB()
      The function prevents the calculation of unwanted data in data point functions and statistical functions.
    - removeGlobal()
      Deletes the manager-wide global CTRL variable name.
    - removeGroup()
      The function removes a group connection from the panel.
    - removeGroupPVSS()
      Removes a WinCC OA group.
    - removeShape()
      The function removes a shape from the panel.
    - removeSymbol()
      The function is used to delete panel references.
    - removeUserFromGroupPVSS()
      Removes a WinCC OA group from a user.
    - removeUserPVSS()
      The function permanently disables a user.
    - rename()
      The function renames a file.
    - renameGroupPVSS()
      Renames a WinCC OA user group.
    - renameUserPVSS()
      Renames a WinCC OA user.
    - requestFileList()
      The function requestFileList() requests a file list from the manager with the specified manager Id.
    - requestFileTransfer()
      The function requestFileTransfer() requests a list of files to be transferred from the active to passive partner in a redundant project.
    - restorePanel()
      Opens an already loaded child panel that had been minimized.
    - rewind()
      Places the pointer at the beginning of the file FileDesc.
    - rmdir()
      The function deletes a specified directory.
    - rootPanel()
      Returns the name of a particular root panel.
    - RootPanelOn()
      Opens a new panel in the current module.
    - RootPanelOnModule()
      Opens a panel in a particular module.
    - RSAGenerateKeyPair()
      The function RSAGenerateKeyPair() generates a public and a private key for the functions RSASealEnvelope() and RSAOpenEnvelope().
    - RSAOpenEnvelope()
      The function RSAOpenEnvelope() decrypts data.
    - RSASealEnvelope()
      The function RSASealEnvelope() encrypts data.
    - runRealSQL()
      The function runRealSQL executes an SQL command that does not return a value such as INSERT or DELETE.
    - runRealSQLQuery()
      The function runRealSQLQuery executes an SQL query of the RDB database.
  - 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.
- CtrlExtension
  The CtrlExtension allows the addition of custom C++ code.

reduSetPreferred()

Sets the Preferred to left or right in a redundant system.

Synopsis

int reduSetPreferred(string sSystem, int peerNr, bool bAsk=true)

Parameter


Parameter	Description
sSystem	System name
peerNr	Number of the peer. 1 = Reduhost1, 2 = Reduhost2
bAsk	TRUE = Window is open FALSE..For internal use, no windows

Return value

The function returns 1 when it was succesfully executed and in case of errors -1.

Error

Description

Sets the Preferred to left or right in a redundant system

Example

The following example sets the preferred to left.

main()
{
  string sSys = "System1";
  int peerNo = 1;
  bAsk = TRUE;
  reduSetPreferred(sSys, peerNo, bAsk);
}

Assignment

Redu/Dist functions

Availability

CTRL