Howto best create new forums from within action

I found a thread that addresses the issue:

http://drupal.org/node/64520

The code presented in that other post does not establish a forum but creates a forum topic. Forums are established via Taxonomy and only topic are nodes.

Here is some code that establishes a new forum. Hope it helps somebody down the line.

	$arr_forum_term = array('name' => $ftitle,
	                          'description' => $ftitle,
				  'vid'  => VID_FORUMS,
				  'weight' => 0,
				  'parent' => TID_FORUM_PARENT,);
  	$arr_terms = taxonomy_get_term_by_name($ftitle_bull);
  	$boo_create_forum = TRUE;
  	if (empty($arr_terms)) {
	  foreach ($arr_terms as $term) {
   	    // check if the forum already exists not just the name
  	    if ($term -> name == $ftitle_bull && $term -> vid == VID_FORUMS) {
  	      $boo_create_forum = FALSE;
  	      $tid = $term -> tid;
  	      break;
	    }  
  	  }
  	}
  	if ($boo_create_forum = TRUE) {
  	  // forum doesn't exist therefore create  
  	  $result = taxonomy_save_term($arr_forum_term);
 	    // tid is updated in the save process
  	  $tid = $arr_forum_term [tid];
  }