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.)

	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);