CONTROL
- Introduction to CTRL
- Control Classes
- Types of Control Functions
- Control graphics
- CONTROL Functions
  - Funtions A
  - 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
    - textEditor()
      Opens the text editor as a main window (not modally).
    - The Extension timedFuncConflicts()
      The timed function extension "timedFuncConflicts()" is designed to discover call conflicts between two or more timed functions. It compares the given parameters to analyze all conflicts and returns the result times.
    - trackZoomMode()
      Complies with the function "Rubber band zoom". After calling this function a cursor "cross" is displayed, which allows to create a window by left-clicking. The panel is scaled in accordance with the specified window size.
    - tanh()
      Calculates the hyperbolic tangent.
    - triggerAction()
      The function can be used to trigger an action from a GEDI or Script Editor extension script.
    - tan()
      Calculates the tangent.
    - tcpRead()
      Reads the data of a defined socket, which was opened with tcpOpen().
    - timedFuncEvents()
      The function timedFuncEvents() returns up to a given max_count all planned start_times (occurrences) when WinCC OA timedFunc would trigger a (start-)event. This function also handles the time periods (broadcast periods) (see Timed function extension) within the range defined by ’r;valid from’ and ’r;valid until’.
    - tr()
      The function translates the given combination (text, comment) into the requested language or the UI language if the lang argument is not given.
    - tcpShutdownOutput()
      Closes the write direction of a TCP socket.
    - timeFromGMT()
      Returns the difference between local time and GMT.
    - Timed function extension
      The timed function was extended and now provides several new functions:
    - throw()
      Signals an erroneous condition by using an error class variable.
    - tcpOpen()
      Opens the connection to a TCP/IP server socket.
    - triggerGlobalEvent()
      The function triggers a UI global event.
    - tcpWrite()
      Writes data to the defined socket.
    - timedFunc()
      Starts timed CTRL functions.
    - titleBar()
      Shows or hides the title bar in the specified module or in a child panel.
    - triggerEvent()
      The function triggers a specific event.
    - tcpClose()
      Closes a TCP/IP socket connection.
    - triggerEventWait()
      The function triggers a specific event and waits for the execution of the event.
    - throwError()
      Passes a WinCC OA error to the internal error handler.
    - tmpnam()
      Creates temporary file names.
  - Functions U
  - Functions V
  - Functions W
  - Functions X
  - Functions Y
  - Functions Z
- CtrlExtension, basics
- CTRL Debugger
  You can use the CTRL debugger to debug the Control programming language. The debugger can be used via its own panel, which also enables the monitoring and setting of variable values during the execution of a script.

tcpShutdownOutput()

Closes the write direction of a TCP socket.

Synopsis

int tcpShutdownOutput(int socket);

Parameters


Parameter	Description
socket	Number of the socket

Return value

0 if the function was executed successfully, otherwise -1.

Error

Missing or wrong arguments.

Description

A connection to a HTTP server is established via the tcpOpen() function. Data is written on the socket via the tcpWrite() function. The write direction is closed using the tcpShutdownOutput() function. When the direction is closed, the tcpWrite() function cannot be used anymore.

When the tcpShutdownOutput() is executed, tcpRead can still read the socket once!

Example

main()
{
string computerNam= "eitst013xp", data;
unsigned Portnumb= 125;
int socket, modWrite, modClose, modRead;
time t = 10;

//Open-> Write-> Close
socket = tcpOpen(computerNam, Portnumb);
DebugN("Open: " + socket + computerNam+ Portnumb);
DebugN("Delay");
delay(5);

//Write
modWrite= tcpWrite(socket, "TEST");
DebugN("Write: " + modWrite);
DebugN("Delay");
delay(5);

//Close
modClose= tcpShutdownOutput(socket);
DebugN("ShutdownOutput: " + modClose);
DebugN("Delay");
delay(5);

//try to write again. Writing does not work anymore
modWrite= tcpWrite(socket, "WRITING DOES NOT WORK ANYMORE");
DebugN("Write does not work anymore: " + modWrite);
DebugN("Delay");
delay(5);

modRead = tcpRead(socket, data, t);
DebugN("Read: " + modRead);
DebugN("Read data: " + data);
DebugN("Finish");
}

Assignment

Communication functions

Availability

CTRL