xvContents
Chapter 8 Error Handling and Diagnostics 8 – 1. . . . . . . . . . . . . . . . . . . . . . . . . .
The Need for Error Handling 8 – 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Error Handling Alternatives 8 – 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SQLCODE and SQLSTATE 8 – 3. . . . . . . . . . . . . . . . . . . . . . . . . . .
SQLCA 8 – 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ORACA 8 – 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using Status Variables when MODE={ANSI|ANSI14} 8 – 4. . . . . . .
Some Historical Information 8 – 4. . . . . . . . . . . . . . . . . . . . . . . . . .
Declaring Status Variables 8 – 5. . . . . . . . . . . . . . . . . . . . . . . . . . . .
Status Variable Combinations 8 – 6. . . . . . . . . . . . . . . . . . . . . . . . .
Status Variable Values 8 – 11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using the SQL Communications Area 8 – 19. . . . . . . . . . . . . . . . . . . . . .
Declaring the SQLCA 8 – 20. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
What’s in the SQLCA? 8 – 20. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Key Components of Error Reporting 8 – 21. . . . . . . . . . . . . . . . . . .
SQLCA Structure 8 – 23. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PL/SQL Considerations 8 – 26. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Getting the Full Text of Error Messages 8 – 26. . . . . . . . . . . . . . . . .
Using the WHENEVER Statement 8 – 27. . . . . . . . . . . . . . . . . . . . .
Getting the Text of SQL Statements 8 – 33. . . . . . . . . . . . . . . . . . . .
Using the Oracle Communications Area 8 – 36. . . . . . . . . . . . . . . . . . . .
Declaring the ORACA 8 – 36. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Enabling the ORACA 8 – 36. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
What’s in the ORACA? 8 – 37. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Choosing Runtime Options 8 – 37. . . . . . . . . . . . . . . . . . . . . . . . . . .
ORACA Structure 8 – 38. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
An Example 8 – 41. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 9 Using Host Arrays 9 – 1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
What Is a Host Array? 9 – 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Why Use Arrays? 9 – 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Declaring Host Arrays 9 – 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Dimensioning Arrays 9 – 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Restrictions 9 – 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using Arrays in SQL Statements 9 – 3. . . . . . . . . . . . . . . . . . . . . . . . . .
Selecting into Arrays 9 – 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Batch Fetches 9 – 4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Number of Rows Fetched 9 – 5. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Restrictions 9 – 5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Fetching Nulls 9 – 6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Fetching Truncated Values 9 – 6. . . . . . . . . . . . . . . . . . . . . . . . . . . .