Synopsis: 

       msg_flush()

Arguments: 

       none                        

Description:  This function flushes all pending messages from the message queue for the calling task.

Returns:   Nothing