Reason (AddToRecordError property)

<section begin=dpl_desc/>AddToREcordErrorReason enumeration value indicating the type of error causing the exception<section end=dpl_desc/>

Reason is a member of the AddToRecordError class.

Syntax

%reason = %a2RecErr:Reason

Syntax terms

%reason	This AddToRecordErrorReason enumeration value describes the reason for the translation failure.
%a2RecErr	An AddToRecordError object.

Usage Notes

• An AddToRecordErrorReason enumeration may have one of the following values:

  InvalidNode

  A node in AddToRecord's method object XmlDoc does not conform to the structure as created by the LoadFromRecord subroutine.

  UntranslatableFieldName

  A field name in AddToRecord's method object XmlDoc is not translatable to EBCDIC.

  UntranslatableFieldgroupName

  A fieldgroup name in AddToRecord's method object XmlDoc is not translatable to EBCDIC.

  UntranslatableValue

  A field value in AddToRecord's method object XmlDoc is not translatable to EBCDIC.

  InvalidBase64

  A string used for the base64 encoding of a field in AddToRecord's method object XmlDoc is not a valid base64 string.

  FieldNameTooLong

  A field name in AddToRecord's method object XmlDoc is longer than 255 characters.

  FieldgroupNameTooLong

  A fieldgroup name in AddToRecord's method object XmlDoc is longer than 255 characters.

  ValueTooLong

  The value of a field in AddToRecord's method object XmlDoc that is not defined as a BLOB or CLOB field in the current file is longer than 255 characters or is longer than the defined LEN attribute, if the field is a fixed OCCURS field.

  UnknownFieldName

  A field name in AddToRecord's method object XmlDoc is not defined in the current file.

  UnknownFieldgroupName

  A fieldgroup name in AddToRecord's method object XmlDoc is not defined in the current file.

  ExpectedField

  A field name in AddToRecord's method object XmlDoc is defined as a fieldgroup in the current file.

  ExpectedFieldgroup

  A fieldgroup name in AddToRecord's method object XmlDoc is defined as a field in the current file.

  ErrorAddingField

  An error occurred adding a field, such as a violation of a field constraint.

  ErrorAddingFieldgroup

  An error occurred adding a fieldgroup, such as a file full condition.

  ErrorObtainingRecord

  AddToRecord was unable to lock the record in exclusive mode.

  InvalidFieldgroupID

  A fieldgroup ID in AddToRecord's method object XmlDoc is not numeric.

  InvalidCodepage

  The codepage name specified on the codepage attribute of the Record element in AddToRecord's method object XmlDoc is not a known codepage name.

  ErrorAddingMaxFieldgroupID

  The attempt to set the fieldgroup ID counter in the record failed; this is a very unusual condition.

  InsufficientStorageForLOB

  STBL, VTBL, or User Buffer storage was unavailable. The Description property indicates which of these is applicable.

  InvalidVersion

  Invalid value of the version attribute of the Record element in AddToRecord's method object XmlDoc; the only allowed value is 1.

  InvalidInputRecordNumber

  Invalid value of the number attribute of the Record element in AddToRecord's method object XmlDoc; it must either be -1 or a non-negative integer.

• As with all enumerations, you use the ToString method to convert an enumeration value to a character string whose value is the name of the enumeration value.