GetCellName
Returns the cell location of a specified symbolic tag name, or the symbolic tag name of a specified cell.
GetCellName Inputs
Syntax: EV GetCellName("Name")
Parameter | Description |
---|---|
"Name" | The name of the symbolic tag (such as Distance_1.Distance, for example) or the cell location (A4, for example). The name must be enclosed in quotation marks. |
GetCellName Outputs
Returns a status code, followed by the number of characters, and the name or cell reference of the cell. The status codes are:
Status Codes | Description |
---|---|
1 |
The command was executed successfully. |
0 |
Unrecognized command. |
-1 |
The cell ID is invalid. |
-2 |
The command could not be executed. |
-6 |
User does not have Full Access to execute the command. For more information, see User Access Settings Dialog. |
Example: Symbolic Tag Name
To get the symbolic tag name of cell B116, issue the following command: EV GetCellName("B116")
Issuing this command produces the following result:
The In-Sight sensor returns 1 to indicate that the command was executed successfully; the number of characters (in bytes) is followed by the Symbolic Tag name.
Example: Symbolic Tag Name Cell Location
To get the cell location of a symbolically tagged Distance Measurement Tool result, issue the following command: EV GetCellName("Distance_1.Distance")
Issuing this command produces the following result:
The In-Sight sensor returns 1 to indicate that the command was executed successfully. The number of characters (in bytes) is followed by the cell location.