Synopsis: 

       free_count=msg_freecount()                                

Arguments: 

       none

Description:  This function returns the number of free slots in the message queue.     If messages are sent to a task faster than they can be picked up (or if the receiving task is not picking up messages at all), then the number of free message slots will gradually reduce until the message queue is full.    If this is the case then this function will return 0.

Sometimes during load testing and diagnostic stages of development it might be useful to print the result of this call to the screen to check that message queues are being serviced quickly enough and that the number of free slots does not drop to zero or a low level due to some kind of bottleneck is the program.

Returns:   Returns the number of free message slots in the message queue.