Atlas Copco PowerMACS 4000, User Manual

Page: 560 / 668

Peripheral Devices
560 9836 3521 01
8.14.4.20 GetPLCString
Description: This method is replaced with the GetPLCStringEx method and should not be used in new
applications. It is here only for backward compatibility reasons.
This method reads 40 consecutive bytes from the PLC output data area for ExtCom_API
(see Access to PLC data). The read data is returned as an ASCII string.
See note in the description of GetPLCStringEx for limitations and an example on how to
call.
Return type : A RetCodeEnum value.
Syntax: object . GetPLCString ( Address, Value )
Obj./Arg. Type Dir Description
object Api The Api object to operate on.
Address Integer In Specifies the offset in the PLC area of the first byte to read.
Range 0
– 999.
Value String Out The read data interpreted as a string.
8.14.4.21 SetPLCString
Description: This method is replaced with the SetPLCStringEx method and should not be used in new
applications. It is here only for backward compatibility reasons.
This method writes the specified string to the PLC input data area for ExtCom_API (see
Access to PLC data) as 40 consecutive bytes. Each byte will be set to the ASCII value of
the respective character. See also the note for SetPLCString.
Return type : A RetCodeEnum value.
Syntax: object . SetPLCString ( Address, Value )
Obj./Arg. Type Dir Description
object Api The Api object to operate on.
Address Integer In Specifies the offset in the PLC area of the first byte to write to.
Range 0
– 999.
Value String In The data to write.