Explanation of Error Values

All of the procedures in the CENTRALSUPPORT library return integer results to indicate the success or failure of the procedure.

The range 1 through 999 indicates that the procedure call completed successfully.

The range 1000 through 1999 consists of error messages caused by a system software error.

Values from 2000 through 2999 contain error messages in which the caller passed invalid data to a procedure, but the CENTRALSUPPORT library was able to return some valid data.

Values from 3000 through 3999 contain error messages in which the caller passed invalid data to a CENTRALSUPPORT procedure, and the CENTRALSUPPORT library was unable to return any valid data.

Values from 4000 through 4999 contain error messages in which the caller passed data for which the CENTRALSUPPORT library could find no return information. The CENTRALSUPPORT library completed the request, but no data was returned.

Table 10–2 lists the possible error results, their values, and the specific description part of the message. For a list of the complete error messages and for information about corrective action to be taken if an error occurs, see the MultiLingual System Administration, Operations, and Programming Guide.

Table 16. Error Results for Internationalization

Result

Value

Specific Description

CS_ARRAY_TOO_SMALLV

3001

The output array size is smaller than the length of the data it is supposed to contain.

CS_BAD_ALT_FRAC_DIGITSV

3017

The international-fractional-digits value is either missing or out of range.

CS_BAD_AMTV

3009

The amount parameter is not an integer or its value is greater than the maximum double-precision integer.

CS_BAD_ARRAY_DESCRIPTIONV

3000

A parameter was incorrectly specified as less than or equal to 0 (zero).

CS_BAD_CPLV

3028

The characters-per-line value is either missing or it is out of range.

CS_BAD_DATA_LENV

3002

At least one array length is invalid or the offset + length is greater than the size of the array.

CS_BAD_DATEINPUTV

3012

The input date contains illegal characters.

CS_BAD_DATESEPARATORV

3044

The date components are separated by an invalid character.

CS_BAD_DAYV

3048

The day value is outside of the valid range. Acceptable values for months January through December are: 1..31, 1..28 (1..29 in a leap year), 1..31, 1..30, 1..31, 1..30, 1.31, 1..31, 1..30, 1..31, 1..30, and 1..31, respectively.

CS_BAD_DAYOFYEARV

3058

The day of year value is outside the valid range. Acceptable values are in the range 1 through 365 (1 through 366 for a leap year).

CS_BAD_FLAGV

3007

The flag specified is out of acceptable range.

CS_BAD_FRACDIGITSV

3016

The fractional digits value is either missing or out of range.

CS_BAD_HEXCODEV

3042

An invalid character was encountered in a hex value representing a symbol in a monetary or numeric template.

CS_BAD_HOURV

3051

The hour value is outside of the valid range for the 24-hour clock. Acceptable values are in the range 0 through 23.

CS_BAD_INPUTVALV

3035

The input value did not contain digits or an expected symbol was missing.

CS_BAD_LDATETEMPV

3018

The long date template is either missing or contains invalid information.

CS_BAD_LPPV

3027

The lines-per-page value is either missing or it is out of range.

CS_BAD_LTIMETEMPV

3021

The long time template is either missing or it contains invalid information.

CS_BAD_MAXDIGITSV

3015

The maximum digits value is either missing or out of range.

CS_BAD_MINDIGITSV

3032

The mindigits field in a "t" control character in a monetary or numeric template is out of range.

CS_BAD_MINUTEV

3053

The minute value is outside the valid range. Acceptable values are in the range 0 through 59.

CS_BAD_MONTEMPV

3023

The monetary template is either missing or it contains invalid information.

CS_BAD_MONTHV

3047

The month value is outside of the valid range. Acceptable values are in the range 1 through 12.

CS_BAD_NDATETEMPV

3020

The numeric date template is either missing or contains invalid information.

CS_BAD_NTIMETEMPV

3022

The numeric time template is either missing or contains invalid information.

CS_BAD_NUMTEMPV

3024

The numeric template is either missing or it contains invalid information.

CS_BAD_PRECISIONV

3038

The "PRECISION" parameter value is not in the range of 0 through 9.

CS_BAD_PSECONDV

3055

The partial second value contains invalid characters.

CS_BAD_SDATETEMPV

3019

The short date template is either missing or it contains invalid information.

CS_BAD_SECONDV

3054

The second value is outside of the valid range. Acceptable values are in the range 0 through 59.

CS_BAD_TEMPCHARV

3011

An invalid control character was detected in the template.

CS_BAD_TEMPLENV

3030

An invalid template length value was encountered.

CS_BAD_TEXT_PARAMV

3008

The space for OSVs or total storage allocated in OUTPUT is not big enough for OSVs and/or PSVs.

CS_BADTIMEINPUTV

3013

The input time contains illegal characters.

CS_BAD_TIMESEPARATORV

3050

Time components are separated by an invalid character.

CS_BAD_12HOURV

3052

The hour value is outside of the valid range for the 12-hour clock. Acceptable values are in the range 1 through 12.

CS_BAD_TYPE_CODEV

3006

The type code specified is out of the acceptable range.

CS_BAD_YEARV

3046

A nonzero value is required for the year component.

CS_BAD_YEAR_YYV

3045

The year component exceeds 2 digits.

CS_CNV_EXISTS_ERRV

3014

An attempt was made to add a new convention with the name of an existing convention.

CS_CNVFILE_NOTPRESENTV

3037

A standard convention definition cannot be added, modified, or deleted.

CS_CNV_NOTAVAILV

3036

Specified convention does not exist and cannot be retrieved, modified or deleted.

CS_COMPLEX_TRAN_REQV

4004

Translate tables cannot be used to map from one multibyte CCS to another.

CS_CONVENTION_NOT_FOUNDV

2002

The data is not in the requested convention; it is in MYSELF.CONVENTION or the SYSTEM CONVENTION.

CS_DATA_NOT_FOUNDV

4002

The requested data was not found.

CS_DATAOKV

1

Your request has been processed.

CS_DEL_PERMANENT_CNV_ERRV

3040

The named convention is a standard convention and cannot be modified or deleted.

CS_FALSEV

0

Your request has been processed.

CS_FAULTV

1001

An unexpected fault occurred in CENTRALSUPPORT. Your request cannot be processed at this time.

CS_FIELD_TRUNCATEDV

2003

The date or time component was too long and was truncated.

CS_FILE_ACCESS_ERRORV

1000

An error occurred while accessing the SYSTEM/CCSFILE or the SYSTEM/CONVENTIONS file.

CS_INCOMPLETE_CHARV

2005

The source data ends with an incomplete multibyte character.

CS_INCOMPLETE_DATAV

2004

Only partial data is being returned. There was insufficient space in the output array.

CS_LANGUAGE_NOT_FOUNDV

2001

The data is not in the requested language. It is in MYSELF.LANGUAGE or the SYSTEM LANGUAGE or the first available LANGUAGE.

CS_MISSING_DATE_COMPONENTV

3059

The day of year value cannot be calculated because a date component (year, month, or day) is missing.

CS_MISSING_MONTH_COMPONENTV

3057

The month value is required but missing.

CS_MISSING_RBRACKETV

3033

A right bracket "]" is required to terminate a "t" control character symbol definition list.

CS_MISSING_TCCOLONV

3034

An expected colon ":" is missing from the "t" control character in a monetary or numeric template.

CS_MUTUAL_EXCLUSIVEV

3031

A mutually exclusive combination of control characters has been encountered in a monetary or numeric template.

CS_NO_ALTCURR_DELIMV

3043

The international currency notation is missing a required terminating delimiter.

CS_NO_CNVNAMEV

3039

A required convention name was not provided.

CS_NO_DATEINPUTV

3049

An input date is required but missing.

CS_NO_HEXCODE_DELIMV

3041

A hexadecimal value representing a symbol in a monetary or numeric template is missing a required delimiter.

CS_NO_MSGNUM_FOUNDV

3005

The requested number was not found.

CS_NO_NAME_FOUNDV

3004

The requested name was not found.

CS_NO_NUM_FOUNDV

3003

The requested number was not found.

CS_NO_TIMEINPUTV

3056

An input time is required but missing.

CS_REQSYMBOLV

3029

A required symbol in either the monetary or the numeric template is missing.

CS_SOFTERRV

1002

A CENTRALSUPPORT software error was detected. Your request cannot be processed at this time.