op_ima_obj_attr_set_int32()
Abstract
Assigns the value of an integer attribute in the specified object.
Syntax
op_ima_obj_attr_set_int32 (objid, attr_name, value)
| Argument | Type | Description |
|---|---|---|
objid |
Objid |
object ID of the object-of-interest [An object ID can be obtained from several KPs in the Topo and Id packages: op_id_self(), op_topo_parent(), op_topo_child(), op_id_from_userid(), and op_id_from_name().] |
attr_name |
const char* |
name of the attribute-of-interest [This value must be a defined attribute of the specified object.] |
value |
int |
new value for the specified attribute |
Return Type
Compcode
OPC_COMPCODE_SUCCESS if the attribute value was successfully set; OPC_COMPCODE_FAILURE otherwise.
Example
if(pool_ptr->index == ToraC_Max_Domain_Node_Num)
{
/* There are more than allowed number of nodes in this domain. */
op_sim_end("Too many nodes with the same domain ID detected. Ending simulation.",
OPC_NIL, OPC_NIL, OPC_NIL);
}
else
{
/* We found an empty id to give out. */
pool_ptr->id_pool[pool_ptr->index] = node_objid;
op_ima_obj_attr_get_int32 (module_objid, "manet_mgr.Ad-Hoc Routing Parameters",
&tmp_objid);
tmp_objid = op_topo_child (tmp_objid, OPC_OBJTYPE_GENERIC, 0);
op_ima_obj_attr_get_int32 (tmp_objid, "TORA/IMEP Parameters", &tmp_objid);
tmp_objid = op_topo_child (tmp_objid, OPC_OBJTYPE_GENERIC, 0);
op_ima_obj_attr_set_int32 (tmp_objid, "Router ID", pool_ptr->index);
}
Details
This KP will not report an error if the attribute is not found; you must check the return value to discover this. By not reporting errors, this KP eliminates the need to use op_ima_obj_attr_exists() beforehand to prevent warnings from being generated.
Purpose
Provides a mechanism to dynamically assign object attributes during the course of a simulation. This KP works identically to op_ima_obj_attr_set(), but applies only to object attributes of data type integer. Refer to op_ima_obj_attr_set() for full purpose and details.
Errors
- Same as op_ima_obj_attr_set().
Reference
- Use the KP op_ima_obj_attr_set_dbl() to set the value of an object attribute of type double
- Use the KP op_ima_obj_attr_set_objid() to set the value of an object attribute of type objid
- Use the KP op_ima_obj_attr_set_str() to set the value of an object attribute of type string
- Use the KP op_ima_obj_attr_set_toggle() to set the value of an object attribute of type toggle
- Use the KPs op_ima_obj_attr_get(), op_ima_obj_attr_get_dbl(), op_ima_obj_attr_get_int32(), op_ima_obj_attr_get_objid(), op_ima_obj_attr_get_str(), and op_ima_obj_attr_get_toggle() to obtain the value of an object attribute
- Use the KPs op_ima_sim_attr_get(), op_ima_sim_attr_get_dbl(), op_ima_sim_attr_get_int32(), and op_ima_sim_attr_get_str() to obtain the value of a simulation attribute
- Use the KP op_ima_obj_svar_get() to obtain the value of a process state variable
- Use the KP op_ima_obj_command() to issue a command to an object
- Use the KP op_id_self() to obtain the object ID of the surrounding processor or queue
- Use the KP op_id_from_name() to obtain the object ID of an arbitrary object