7.16.3 LoadByName Method
The signature of this Method is specified below.
Signature
LoadByName (
[in] 0:String Name
[out] 0:Int32 Status
);
The table below specifies the Arguments.
| Argument | Description |
| Name | Name to identify a task control program or module |
| Status | 0 – OK – Everything is OK 1 – E_SystemState – The system is not in correct state for this operation 2 – E_UnexpectedError – Unexpected Error during the method call 3 – E_ActiveAlarm – An Active Alarm prevents the system start 4 – E_AcknowledgeRequired – Condition needs to be acknowledged <0 – shall be used for vendor-specific errors. >0 – are reserved for errors defined by this and future standards |
The LoadByName Method is called by a Client to load a program or module to a task control. The controller uses the Name input argument to identify the program or module to load into the task control. The behaviour of this method is identical to the LoadByNodeId (see 7.16.2).
The possible Method result codes are formally defined in the table below. Some of these StatusCodes correspond to the Name input argument.
Clients may inspect the Status output argument to determine if the program was successfully loaded or if it failed.
| Result Code | Description |
| Good | The task control operation succeeded |
| Bad_InternalError | The task control operation failed because of an internal error |
| Bad_ResourceUnavailable | The Method is locked by another Client/Clientgroup |
| Bad_UserAccessDenied | The caller is not allowed to call this Method. |
The LoadByName Method representation in the AddressSpace is formally defined in the table below.
| Attribute | Value | ||||
| BrowseName | LoadByName | ||||
| References | NodeClass | BrowseName | DataType | TypeDefinition | ModellingRule |
|---|---|---|---|---|---|
| 0:HasProperty | Variable | 0:InputArguments | 0:Argument[] | 0:PropertyType | 0:Mandatory |
| 0:HasProperty | Variable | 0:OutputArguments | 0:Argument[] | 0:PropertyType | 0:Mandatory |
| ConformanceUnits | |||||
|---|---|---|---|---|---|
| Rob Task Control Operation |