Appendix U - Miscellaneous Modeling Functions

• GET_CSIM_VERSION() - Returns the version of CSIM being used as a floating-point number.
  Formal definition:     float GET_CSIM_VERSION();
  Example:
          {
            float vers;
           
            vers = GET_CSIM_VERSION();
            printf("Version = %3.2f\n", vers );
          }

• CSIM_SET_EVENT_PRIORITY( int priority ) - Sets the priority level of subsequently scheduled events. Events are always scheduled in time order, according to the time they are scheduled to occur. However, events of the same priority that are scheduled to occur at the same time (ties) will be served in the order they were scheduled. The default priority level is 10. Events having higher priority will be served before lower priority events. It is effectively a tie-breaker. This function enables you to force certain events to occur sequentially before or after other events scheduled for the same time.

  The intended usage is to raise or lower the priority level with CSIM_SET_EVENT_PRIORITY just prior to scheduling a future event(s), and then to reset the priority level with CSIM_SET_EVENT_PRIORITY to the default value after scheduling. Future events are scheduled by the TRIGGER_THREAD, CALL_THREAD, and SCHEDULE_RESUME_WITH_PARAM functions.

  Example usages would be to cause a certain event(s) to occur before or after any or all other events that occur at a given time.
  Example:

  	CSIM_SET_EVENT_PRIORITY( 20 );
  	TRIGGER_THREAD( collect_stats, dT, 0 );
  	TRIGGER_THREAD( collect_stats, dT + 1.0, 0 );
  	CSIM_SET_EVENT_PRIORITY( 10 );