|
|
| (9 intermediate revisions by 4 users not shown) |
| Line 1: |
Line 1: |
| | | #REDIRECT [[AddToRecordError class#Reason property|Reason property]] |
| <span class="pageSubtitle"><section begin=dpl_desc/>AddToREcordErrorReason enumeration value indicating the type of error causing the exception<section end=dpl_desc/></span>
| |
| [[Category:AddToRecordError methods|Reason property]] | | [[Category:AddToRecordError methods|Reason property]] |
| <p>
| |
| <var>Reason</var> is a member of the <var>[[AddToRecordError class|AddToRecordError]]</var> class.
| |
| </p>
| |
|
| |
| ==Syntax==
| |
| <p class="syntax">%reason = %a2RecErr:Reason
| |
| </p>
| |
| ===Syntax terms===
| |
| <table class="syntaxTable">
| |
| <tr><th>%reason</th>
| |
| <td>This <var>AddToRecordErrorReason</var> enumeration value describes the reason for the translation failure.
| |
| </td></tr>
| |
| <tr><th>%a2RecErr</th>
| |
| <td>An <var>AddToRecordError</var> object.
| |
|
| |
| </td></tr></table>
| |
| ==Usage Notes==
| |
| <ul>
| |
| <li>An <var>AddToRecordErrorReason</var> enumeration may have one of the following values:
| |
| <dl>
| |
| <dt>InvalidNode
| |
| <dd>A node in <var>[[AddToRecord (XmlDoc subroutine)|AddToRecord]]</var>'s method object <var>[[XmlDoc class|XmlDoc]]</var> does not conform to the structure as
| |
| created by the LoadFromRecord subroutine.
| |
| <dt>UntranslatableFieldName
| |
| <dd>A field name in <var>AddToRecord</var>'s method object <var>XmlDoc</var> is not translatable to EBCDIC.
| |
| <dt>UntranslatableFieldgroupName
| |
| <dd>A fieldgroup name in <var>AddToRecord</var>'s method object <var>XmlDoc</var> is not translatable to EBCDIC.
| |
| <dt>UntranslatableValue
| |
| <dd>A field value in <var>AddToRecord</var>'s method object <var>XmlDoc</var> is not translatable to EBCDIC.
| |
| <dt>InvalidBase64
| |
| <dd>A string used for the base64 encoding of a field in <var>AddToRecord</var>'s method object
| |
| <var>XmlDoc</var> is not a valid base64 string.
| |
| <dt>FieldNameTooLong
| |
| <dd>A field name in <var>AddToRecord</var>'s method object <var>XmlDoc</var> is longer than 255 characters.
| |
| <dt>FieldgroupNameTooLong
| |
| <dd>A fieldgroup name in <var>AddToRecord</var>'s method object <var>XmlDoc</var> is longer than 255 characters.
| |
| <dt>ValueTooLong
| |
| <dd>The value of a field in <var>AddToRecord</var>'s method object <var>XmlDoc</var> that is not defined as a
| |
| <var>BLOB</var> or <var>CLOB</var> field in the current file is longer than 255 characters or is
| |
| longer than the defined <var>LEN</var> attribute, if the field is a fixed
| |
| <var>OCCURS</var> field.
| |
| <dt>UnknownFieldName
| |
| <dd>A field name in <var>AddToRecord</var>'s method object <var>XmlDoc</var> is not defined in the current file.
| |
| <dt>UnknownFieldgroupName
| |
| <dd>A fieldgroup name in <var>AddToRecord</var>'s method object <var>XmlDoc</var> is not defined in the current file.
| |
| <dt>ExpectedField
| |
| <dd>A field name in <var>AddToRecord</var>'s method object <var>XmlDoc</var> is defined as a fieldgroup
| |
| in the current file.
| |
| <dt>ExpectedFieldgroup
| |
| <dd>A fieldgroup name in <var>AddToRecord</var>'s method object <var>XmlDoc</var> is defined as a field
| |
| in the current file.
| |
| <dt>ErrorAddingField
| |
| <dd>An error occurred adding a field, such as a violation of a
| |
| field constraint.
| |
| <dt>ErrorAddingFieldgroup
| |
| <dd>An error occurred adding a fieldgroup, such as a file full
| |
| condition.
| |
| <dt>ErrorObtainingRecord
| |
| <dd><var>AddToRecord</var> was unable to lock the record in exclusive mode.
| |
| <dt>InvalidFieldgroupID
| |
| <dd>A fieldgroup ID in <var>AddToRecord</var>'s method object <var>XmlDoc</var> is not numeric.
| |
| <dt>InvalidCodepage
| |
| <dd>The codepage name specified on the <code>codepage</code> attribute of the
| |
| <code>Record</code> element
| |
| in <var>AddToRecord</var>'s method object <var>XmlDoc</var>
| |
| is not a known codepage name.
| |
| <dt>ErrorAddingMaxFieldgroupID
| |
| <dd>The attempt to set the fieldgroup ID counter in the record
| |
| failed; this is a very unusual condition.
| |
| <dt>InsufficientStorageForLOB
| |
| <dd>STBL, VTBL, or User Buffer storage was unavailable.
| |
| The <var>[[Description (AddToRecordError property)|Description]]</var> property indicates which of these is applicable.
| |
| <dt>InvalidVersion
| |
| <dd>Invalid value of the <code>version</code> attribute of the <code>Record</code> element
| |
| in <var>AddToRecord</var>'s method object <var>XmlDoc</var>;
| |
| the only allowed value is 1.
| |
| <dt>InvalidInputRecordNumber
| |
| <dd>Invalid value of the <code>number</code> attribute of the <code>Record</code> element
| |
| in <var>AddToRecord</var>'s method object <var>XmlDoc</var>;
| |
| it must either be -1 or a non-negative integer.
| |
| </dl>
| |
| <li>As with all enumerations, you use
| |
| the <code>ToString</code> method to convert an enumeration value to a
| |
| character string whose value is the name of the enumeration value.
| |
| </ul>
| |