The signature of this Method is specified below.
Signature
LoadByName (
[in]0:StringName
[out]0:Int32Status
);
The table below specifies the Arguments.
Table 74 – LoadByName Method 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.
Table 75 – Method Result Codes (defined in Call Service)
|
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.
Table 76 – LoadByName Method AddressSpace definition
|
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 |
|||||