Siemens SIMATIC S7-1200

Extended instructions
9.2 String and character
S7-1200 Programmable controller
System Manual, V4.2, 09/2016, A5E02486680-AK
373
9.2.5.2
GetSymbolPath (Query composite global name of the input parameter assignment)
Table 9- 71 GetSymbolPath instruction
LAD / FBD
SCL
Description
OUT := GetSymbolPath(
variable:=_parameter_in_,
size:=_dint_in_);
The GetSymbolPath instruction reads the
composite global name of an input parameter
at the local interface of a block (FB or FC). The
name consists of the storage path and the tag
name.
Your program can call the instruction multiple
times with different tags. The process value of
the tag is irrelevant.
The instruction returns the name read at the
OUT parameter.
Parameter
The following table shows the parameters of the GetSymbolPath instruction:
Parameter
Declaration
Data type
Memory area
Description
VARIABLE Input PARAMETER Parameter sections
Input, Output, InOut
Selection of the local interface to which you
want to read the global name of the input
parameter supply.
SIZE Input DINT I, Q, M, D, L or con-
stant
Limits the number of characters output at the
OUT parameter.
• SIZE > 0: GetSymbolPath returns the first
SIZE characters of the name.
• SIZE = 0: GetSymbolPath returns the
entire name.
• SIZE < 0: GetSymbolPath returns the last
SIZE characters of the name.
OUT Output WSTRING I, Q, M, D, L Output of the tag name of the input parame-
ters supply.
You can find additional information on valid data types under "Data types (Page 125)".