Pemetaan Kode Kesalahan

Layanan DRDA mengonversi kode kesalahan dan pesan SQL Server ke instans pesan balasan DRDA atau DB2 SQLCA (Communications Area) berdasarkan serangkaian pemetaan yang ditentukan yang disimpan dalam file MsDrdaErrorMappings.xml di direktori %DRDAROOT%\system. Kode kesalahan SQL Server yang masuk dipetakan ke kode kesalahan DB2 yang keluaran. Dokumen XML berisi format standar yang ditetapkan, seperti yang didokumenkan dalam file skema HostIntegrationDrdaSqlErrorMappings.xsd terkait.

<SqlErrorMappings>  
<sqlErrorMapping  
msSqlMessageId="201"   
msSqlMessageSeverityLevel="16"  
msSqlMessageText="Procedure or function '{0}' expects parameter '{1}', which was not supplied."  
drdaSqlCode="-313"  
drdaSqlState="07001"  
drdaReasonCode=""  
drdaMessageText="THE NUMBER OF HOST VARIABLES SPECIFIED IS NOT EQUAL TO THE NUMBER OF PARAMETER MARKERS."  
drdaExplanationText="The server cannot execute a SQL statement that contains an incorrect parameter list."  
drdaActionText="Verify the number and type of parameters."  
/>

Contoh. Pesan kesalahan SQL Server dipetakan ke pesan kesalahan DB2.

Tabel berikut ini memperlihatkan pesan kesalahan Microsoft SQL Server.

Barang Tipe Deskripsi
sqlErrorMappings elemen Elemen sqlErrorMappings mengandung elemen-elemen definisi sqlErrorMapping.
sqlErrorMapping elemen Elemen sqlErrorMapping berisi definisi pesan kesalahan SQL Server yang dipetakan ke pesan balasan DRDA.

Tabel berikut ini memperlihatkan pesan kesalahan Microsoft SQL Server.

Barang Tipe Deskripsi
msSqlMessageId bilangan bulat Atribut msSqlMessageId mewakili pengidentifikasi (ID) pesan dan merupakan nilai unik di seluruh server. Atribut yang diperlukan ini menerima nilai bilangan bulat.
msSqlMessageSeverityLevel bilangan bulat Atribut msSqlMessageSeverityLevel mewakili tingkat keparahan pesan, antara 1 dan 25. Atribut yang diperlukan ini menerima nilai bilangan bulat.
msSqlMessageText string(1024) Atribut msSqlMessageText mewakili teks pesan. Atribut yang diperlukan ini menerima nilai string.

Tabel berikut ini memperlihatkan pesan kesalahan IBM DB2.

Barang Tipe Deskripsi
drdaSqlCode bilangan bulat Atribut drdaSqlCode menunjukkan IBM DB2 SQLCODE. Atribut yang diperlukan ini menerima nilai bilangan bulat.
drdaSqlState bilangan bulat Atribut drdaSqlState menunjukkan IBM DB2 SQLSTATE. Atribut yang diperlukan ini menerima nilai bilangan bulat.
drdaReasonCode biner heksadesimal Atribut drdaReasonCode menunjukkan kode alasan IBM DB2. Atribut opsional ini menerima nilai biner hex. Nilai defaultnya adalah 0.
drdaMessageText benang Atribut drdaMessageText menunjukkan teks pesan IBM DB2. Atribut yang diperlukan ini menerima nilai string.
drdaExplanationText benang Atribut drdaExplanationText menunjukkan teks penjelasan IBM DB2. Atribut opsional ini menerima nilai string.
drdaActionText benang Atribut drdaActionText menunjukkan teks tindakan IBM DB2. Atribut opsional ini menerima nilai string.
  • Last updated on