Next: , Previous: , Up: Defining Instruction Meta-classes   [Contents][Index]


4.2.2.4 Instruction Class Identifiers

An instruction class has the following identifiers unique in various scopes:

The following tuples containing identifiers of an instruction class are unique in the scope of a multinode model:

The function qsmm_reg_instr_class_v2 registers an instruction class as belonging to an instruction class set. Use the function described below to get the name of this instruction class set when processing an event by the event handler of an instruction meta-class. You can also use that function to get the name of an instruction class set when processing an event by the event handler of this instruction class set.

Function: int qsmm_get_eh_instr_class_set_name (qsmm_t model, const char **instr_class_set_name_pp)

This function retrieves the name of instruction class set of an event processed by an event handler of a multinode model. If instr_class_set_name_pp is not NULL, the function sets *instr_class_set_name_pp to the name of that instruction class set.

If the event handler of an instruction meta-class calls this function while processing an event QSMM_EVT_INSTR_CLASS_INIT, QSMM_EVT_INSTR_CLASS_DONE, or QSMM_EVT_ACTIVATE, the function retrieves the name of an instruction class set containing an instruction class associated with the event. If the event handler of an instruction class set calls this function, it retrieves the name of this instruction class set.

On success, the function returns a non-negative value. If the context of calling the function is not the event handler of an instruction meta-class on processing an event QSMM_EVT_INSTR_CLASS_INIT, QSMM_EVT_INSTR_CLASS_DONE, or QSMM_EVT_ACTIVATE and not the event handler of an instruction class set, the function returns negative error code QSMM_ERR_UNTIMELY.


Next: , Previous: , Up: Defining Instruction Meta-classes   [Contents][Index]