status.i4.v = str_is_numeric_c(string.i1a.r [,length.i4.v])

	This routine determines whether or not the passed string is composed
	of numeric characters.  The numeric characters can be preceded and
	followed by white space.

	string		string to check
	[length]	length of string (If a value of zero is passed
			or this argument is defaulted, the length of the
			string will be calculated.)
			(default is 0)

	This function returns status values as follows:

	TRUE			string is numeric
	FALSE			string is not numeric

	This function requires the following include files:

	cnsparam_h, cbslib_h

	Related functions:

	str_is_float_string_c, str_is_hex_c, str_is_alphabetic_c,
	str_is_alphanumeric_c, str_is_lower_case_c, str_is_upper_case_c,
	str_is_printable_c, str_is_blank_c, str_is_white_space_c,
	str_num_nonblank_c, str_compare_nocase, str_compare_n_nocase_c,
	strncmp, strcmp, strncmx, str_find_first_c, str_get_first_c

	C/C++ usage:

	static const char	string[] = " 1234 ";
	int	status;
	int	length = 0;

	status = str_is_numeric_c(string,length);