Parameters
| Parameter | Data Type | Description |
|---|---|---|
| InstanceName | String | Name of the component instance. If omitted, the current instance is used. |
Return Values
Name of the component from which the specified instance was created, in uppercase. An empty string ("") is returned if an error occurred.
| Value | Error constant | Meaning |
|---|---|---|
-57
|
<UACTERR_NO_INSTANCE>
|
The named instance cannot be found in the component pool. |
-1101
|
<UPROCERR_FIELD>
|
An incorrect field name was provided; either the field name is not valid syntactically or the field is not available in the component. |
-1105
|
<UPROCERR_INSTANCE>
|
The instance name provided is not valid; for example, the argument contains incorrect characters. |
-1304
|
<UPROCERR_UNKNOWN_CONTEXT>
|
Function not allowed, unknown context. The InstName argument was omitted and no instance is current, for example, in the apStart trigger. |
Use
Allowed in all component types.
Tracing Application Execution
You can use the value in $instancename and $componentname to help trace an application's execution. For example:
operation exec putmess "Started instance %%$instancename of %%$componentname at %%$clock" edit putmess "Terminated instance %%$instancename at of %%$componentname %%$clock" end ; end exec
