Write

The subfolder Write contains low-level blocks that are necessary for writing via ADS.

Init Writer

The Init Writer block initializes the ADS writer. When a call is successful the block returns a handle to the ADS writer.

Write 1:

Input/output

Meaning

[0] [4] Handle

Handle to the ADS client

[5] [6] SymbolName

Describes an ADS symbol consisting of AMS address and symbol designation:

  • AMS address: A compilation of AMS NetId and AMS port.
  • Symbol designation: Symbol name or index group/offset

Examples of the symbol name:

  • AMS address and symbol name:
    127.0.0.0.1.1:851::MAIN.Var
  • AMS address and index group/offset: 127.0.0.0.1.1:851::0x1234/0x12345

[7] [8] WriterMode

Writing mode (Sync/Async)

[10] WriteHandle

Handle to the ADS Writer

Send Writer Request

The Send Writer-Request block sends a write request to the ADS server. The block waits for a response from the server if the writer has been initialized with the "Synchronous" operation mode. Otherwise the block does not wait for the response and passes the WriteHandle.

Write 2:

Input/output

Meaning

[0] [4] Handle

Handle to the ADS client

[5] [6] SymbolName

Describes an ADS symbol consisting of AMS address and symbol designation:

  • AMS address: A compilation of AMS NetId and AMS port.
  • Symbol designation: Symbol name or index group/offset

Examples of the symbol name:

  • AMS address and symbol name: 127.0.0.0.1.1:851::MAIN.Var
  • AMS address and index group/offset: 127.0.0.0.1.1:851::0x1234/0x12345

[7] WriterMode

Writing mode (Sync/Async)

[8] [9] WriteHandle

Handle to the ADS Writer

[12] ADS-Write Data

TypeResolved ADS data packet

[10] Write status?

Write status

CheckWriteStatus

The CheckWriteStatus block checks for successful write access to the ADS server in connection with the "Asynchronous" operation mode.

Write 3:

Input/output

Meaning

[0] [4] Handle

Handle to the ADS client

[5] SymbolName

Describes an ADS symbol consisting of AMS address and symbol designation:

  • AMS address: A compilation of AMS NetId and AMS port.
  • Symbol designation: Symbol name or index group/offset

Examples of the symbol name:

  • AMS address and symbol name: 127.0.0.0.1.1:851::MAIN.Var
  • AMS address and index group/offset: 127.0.0.0.1.1:851::0x1234/0x12345

[6] [9] WriteHandle

Handle to the ADS Writer

[8] Write status?

Write status

Release Writer

The Release Writer releases the handle to the writer from memory.

Write 4:

Input/output

Meaning

[0] [4] Handle

Handle to the ADS client

[5] WriteHandle

Handle to the ADS Writer